/** * Creates a new default blob ACL entry on this bucket. * * <p>Default ACLs are applied to a new blob within the bucket when no ACL was provided for that * blob. * * <p>Example of creating a new default ACL entry. * * <pre>{@code * Acl acl = bucket.createDefaultAcl(Acl.of(User.ofAllAuthenticatedUsers(), Acl.Role.READER)); * }</pre> * * @throws StorageException upon failure */ public Acl createDefaultAcl(Acl acl) { return storage.createDefaultAcl(getName(), acl); }
/** Example of creating a new default ACL entry on a bucket. */ // [TARGET createDefaultAcl(String, Acl)] // [VARIABLE "my_unique_bucket"] public Acl createDefaultBucketAcl(String bucketName) { // [START createDefaultBucketAcl] Acl acl = storage.createDefaultAcl(bucketName, Acl.of(User.ofAllAuthenticatedUsers(), Role.READER)); // [END createDefaultBucketAcl] return acl; }
@Test public void testCreateDefaultAcl() throws Exception { initializeExpectedBucket(4); expect(storage.getOptions()).andReturn(mockOptions); Acl returnedAcl = ACL.toBuilder().setEtag("ETAG").setId("ID").build(); expect(storage.createDefaultAcl(BUCKET_INFO.getName(), ACL)).andReturn(returnedAcl); replay(storage); initializeBucket(); assertEquals(returnedAcl, bucket.createDefaultAcl(ACL)); }
@Test public void testCreateDefaultBucketAcl() { Acl returnedAcl = ACL.toBuilder().setEtag("ETAG").setId("ID").build(); EasyMock.expect(storageRpcMock.createDefaultAcl(ACL.toObjectPb().setBucket(BUCKET_NAME1))) .andReturn(returnedAcl.toObjectPb()); EasyMock.replay(storageRpcMock); initializeService(); Acl acl = storage.createDefaultAcl(BUCKET_NAME1, ACL); assertEquals(returnedAcl, acl); }
@Test public void testBucketDefaultAcl() { assertNull(storage.getDefaultAcl(BUCKET, User.ofAllAuthenticatedUsers())); assertFalse(storage.deleteDefaultAcl(BUCKET, User.ofAllAuthenticatedUsers())); Acl acl = Acl.of(User.ofAllAuthenticatedUsers(), Role.READER); assertNotNull(storage.createDefaultAcl(BUCKET, acl)); Acl updatedAcl = storage.updateDefaultAcl(BUCKET, acl.toBuilder().setRole(Role.OWNER).build()); assertEquals(Role.OWNER, updatedAcl.getRole()); Set<Acl> acls = new HashSet<>(); acls.addAll(storage.listDefaultAcls(BUCKET)); assertTrue(acls.contains(updatedAcl)); assertTrue(storage.deleteDefaultAcl(BUCKET, User.ofAllAuthenticatedUsers())); assertNull(storage.getDefaultAcl(BUCKET, User.ofAllAuthenticatedUsers())); }
/** * Creates a new default blob ACL entry on this bucket. * * <p>Default ACLs are applied to a new blob within the bucket when no ACL was provided for that * blob. * * <p>Example of creating a new default ACL entry. * * <pre>{@code * Acl acl = bucket.createDefaultAcl(Acl.of(User.ofAllAuthenticatedUsers(), Acl.Role.READER)); * }</pre> * * @throws StorageException upon failure */ public Acl createDefaultAcl(Acl acl) { return storage.createDefaultAcl(getName(), acl); }