Struct BucketAccessControlClient

pub struct BucketAccessControlClient<'a>(/* private fields */);

Operations on BucketAccessControls.

Implementations

impl<'a> BucketAccessControlClient<'a>

pub fn create( &self, bucket: &str, new_bucket_access_control: &NewBucketAccessControl, ) -> Result<BucketAccessControl>

Create a new BucketAccessControl using the provided NewBucketAccessControl, related to the Bucket provided by the bucket_name argument.

Important

Important: This method fails with a 400 Bad Request response for buckets with uniform bucket-level access enabled. Use Bucket::get_iam_policy and Bucket::set_iam_policy to control access instead.

Example

use cloud_storage::sync::Client;
use cloud_storage::bucket_access_control::{BucketAccessControl, NewBucketAccessControl};
use cloud_storage::bucket_access_control::{Role, Entity};

let client = Client::new()?;
let new_bucket_access_control = NewBucketAccessControl {
    entity: Entity::AllUsers,
    role: Role::Reader,
};
client.bucket_access_control().create("mybucket", &new_bucket_access_control)?;

pub fn list(&self, bucket: &str) -> Result<Vec<BucketAccessControl>>

Returns all BucketAccessControls related to this bucket.

Important

Important: This method fails with a 400 Bad Request response for buckets with uniform bucket-level access enabled. Use Bucket::get_iam_policy and Bucket::set_iam_policy to control access instead.

Example

use cloud_storage::sync::Client;
use cloud_storage::bucket_access_control::BucketAccessControl;

let client = Client::new()?;
let acls = client.bucket_access_control().list("mybucket")?;

pub fn read(&self, bucket: &str, entity: &Entity) -> Result<BucketAccessControl>

Returns the ACL entry for the specified entity on the specified bucket.

Important

Important: This method fails with a 400 Bad Request response for buckets with uniform bucket-level access enabled. Use Bucket::get_iam_policy and Bucket::set_iam_policy to control access instead.

Example

use cloud_storage::sync::Client;
use cloud_storage::bucket_access_control::{BucketAccessControl, Entity};

let client = Client::new()?;
let controls = client.bucket_access_control().read("mybucket", &Entity::AllUsers)?;

pub fn update( &self, bucket_access_control: &BucketAccessControl, ) -> Result<BucketAccessControl>

Update this BucketAccessControl.

Important

Important: This method fails with a 400 Bad Request response for buckets with uniform bucket-level access enabled. Use Bucket::get_iam_policy and Bucket::set_iam_policy to control access instead.

Example

use cloud_storage::sync::Client;
use cloud_storage::bucket_access_control::{BucketAccessControl, Entity};

let client = Client::new()?;
let mut acl = client.bucket_access_control().read("mybucket", &Entity::AllUsers)?;
acl.entity = Entity::AllAuthenticatedUsers;
client.bucket_access_control().update(&acl)?;

pub fn delete(&self, bucket_access_control: BucketAccessControl) -> Result<()>

Permanently deletes the ACL entry for the specified entity on the specified bucket.

Important

Important: This method fails with a 400 Bad Request response for buckets with uniform bucket-level access enabled. Use Bucket::get_iam_policy and Bucket::set_iam_policy to control access instead.

Example

use cloud_storage::sync::Client;
use cloud_storage::bucket_access_control::{BucketAccessControl, Entity};

let client = Client::new()?;
let controls = client.bucket_access_control().read("mybucket", &Entity::AllUsers)?;
client.bucket_access_control().delete(controls)?;

Trait Implementations

impl<'a> Debug for BucketAccessControlClient<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.