com.qcloud.cos.model.SetBucketAclRequest Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of cos_api Show documentation
java sdk for qcloud cos
There is a newer version: 5.6.238.2
package com.qcloud.cos.model;

import java.io.Serializable;

import com.qcloud.cos.internal.CosServiceRequest;

public class SetBucketAclRequest extends CosServiceRequest implements Serializable {
   /** The name of the bucket whose ACL is being set. */
   private String bucketName;

   /** The custom ACL to apply to the specified bucket. */
   private AccessControlList acl;

   /** The canned ACL to apply to the specified bucket. */
   private CannedAccessControlList cannedAcl;

   /**
    * Constructs a new SetBucketAclRequest object, ready to set the specified
    * ACL on the specified bucket when this request is executed.
    *
    * @param bucketName
    *            The name of the bucket whose ACL will be set by this request.
    * @param acl
    *            The custom Access Control List containing the access rules to
    *            apply to the specified bucket when this request is executed.
    */
   public SetBucketAclRequest(String bucketName, AccessControlList acl) {
       this.bucketName = bucketName;
       this.acl = acl;
       this.cannedAcl = null;
   }

   /**
    * Constructs a new SetBucketAclRequest object, ready to set the specified
    * canned ACL on the specified bucket when this request is executed.
    *
    * @param bucketName
    *            The name of the bucket whose ACL will be set by this request.
    * @param acl
    *            The Canned Access Control List to apply to the specified
    *            bucket when this request is executed.
    */
   public SetBucketAclRequest(String bucketName, CannedAccessControlList acl) {
       this.bucketName = bucketName;
       this.acl = null;
       this.cannedAcl = acl;
   }

   /**
    * Returns the name of the bucket whose ACL will be modified by this request
    * when executed.
    *
    * @return The name of the bucket whose ACL will be modified by this request
    *         when executed.
    */
   public String getBucketName() {
       return bucketName;
   }

   /**
    * Returns the custom ACL to be applied to the specified bucket when this
    * request is executed. A request can use either a custom ACL or a canned
    * ACL, but not both.
    *
    * @return The custom ACL to be applied to the specified bucket when this
    *         request is executed.
    */
   public AccessControlList getAcl() {
       return acl;
   }

   /**
    * Returns the canned ACL to be applied to the specified bucket when this
    * request is executed. A request can use either a custom ACL or a canned
    * ACL, but not both.
    *
    * @return The canned ACL to be applied to the specified bucket when this
    *         request is executed.
    */
   public CannedAccessControlList getCannedAcl() {
       return cannedAcl;
   }
}