創建桶

功能說明

您可以通過使用create_bucket創建存儲桶。

代碼示例

def create_bucket(self):
    resp = self.s3_client.create_bucket(
        Bucket='<new-bucket-name>'
    )
    print(resp)

請求參數

返回結果

根據返回碼判斷是否創建成功，200表示成功。

獲取桶列表

功能說明

您可以通過使用list_buckets獲取桶列表。

代碼示例

def list_buckets(self):
    print('list_buckets')
    response = self.s3_client.list_buckets()
    for bucket in response['Buckets']:
        print(bucket["Name"])

請求參數

無

返回結果

判斷桶是否存在

功能說明

您可以使用head_bucket接口判斷桶是否存在。

代碼示例

def head_bucket(self):
    resp = self.s3_client.head_bucket(
        Bucket='<your-bucket-name>'
    )
    print(resp)

請求參數

返回結果

根據返回碼判斷桶是否存在，200表示存在，404表示不存在

刪除桶

功能說明

您可以使用delete_bucket刪除存儲桶。

代碼示例

def delete_bucket(self):
    resp = self.s3_client.delete_bucket(
        Bucket='<your-bucket-name>'
    )
    print(resp)

請求參數

返回結果

根據返回碼判斷是否刪除成功，204表示刪除成功

設置桶訪問權限

功能說明

媒體存儲支持一組預先定義的授權，稱為Canned ACL。每個Canned ACL都有一組預定義的被授權者和權限，下表列出了相關的預定義授權含義。

您可以通過put_bucket_acl接口設置一個存儲桶的訪問權限。用戶在設置存儲桶的ACL之前需要具備WRITE_ACP 權限。

代碼示例

def put_bucket_acl(self):
    resp = self.s3_client.put_bucket_acl(
        Bucket='<your-bucket-name>',
        ACL='private' # private | public-read | public-read-write | authenticated-read
    )
    print(resp)

請求參數

返回結果

根據返回碼判斷是否設置成功，200表示成功。

獲取桶訪問權限

功能說明

您可以通過get_bucket_acl接口獲取存儲桶的access control list（ACL）信息。存儲桶的ACL可以在創建的時候設置并且通過API查看，用戶需要具有READ_ACP（讀取存儲桶 ACL信息）權限才可以查詢存儲桶的ACL信息。

代碼示例

def get_bucket_acl(self):
    resp = self.s3_client.get_bucket_acl(
        Bucket='<your-bucket-name>',
    )
    print(resp)

請求參數

返回結果

設置桶策略

功能說明

存儲桶授權策略（bukcet policy）可以靈活地配置用戶各種操作和訪問資源的權限。訪問控制列表（access control lists，ACL）只能對單一對象設置權限，而存儲桶授權策略可以基于各種條件對一個桶內的全部或者一組對象配置權限。桶的擁有者擁有PutBucketPolicy操作的權限，如果桶已經被設置了policy，則新的policy會覆蓋原有的policy。您可以通過put_bucket_policy接口設置桶策略，描述桶策略的信息以JSON格式的字符串形式通過Policy參數傳入。policy的示例如下：

{ 
    "Id": "<your-policy-id>",
    "Version": "2012-10-17",
    "Statement" : [{
        "Sid": "<your-statement-id>",
        "Principal": {
            "AWS":["arn:aws:iam:::user/<your-user-name>"]
        },
        "Effect": "Allow",   
        "Action": [
            "s3:ListBucket",
            "s3:CreateBucket"
        ],
        "Resource": [
            "arn:aws:iam:::<your-bucket-name>/*"
        ],
        "Condition": "<some-conditions>"
    }]
}

Statement的內容說明如下：

代碼示例

def put_bucket_policy(self):
    resp = self.s3_client.put_bucket_policy(
        Bucket='<your-bucket-name>',
        Policy='{"Version":"2012-10-17","Statement":[{"Sid":"123","Effect":"Allow",' +
        '"Principal":{"AWS":"*"},"Action":["s3:PutObject","s3:GetObject"], ' +
        '"Resource":["arn:aws:s3:::' + '<your-bucket-name>' + '/*"]}]}'
    )
    print(resp)

請求參數

返回結果

根據返回碼判斷是否設置成功，200表示成功。

獲取桶策略

功能說明

您可以通過get_bucket_policy接口獲取指定存儲桶的授權策略。如果您使用的身份不是該存儲桶的擁有者，則調用身份必須對指定存儲桶具有GetBucketPolicy權限，且屬于該存儲桶所有者的賬戶。如果您沒有GetBucketPolicy權限，方法將返回403 Access Denied錯誤。如果您具有正確的權限，但您沒有使用屬于存儲桶所有者賬戶的身份，則返回405 Method Not Allowed錯誤。

代碼示例

def get_bucket_policy(self):
    resp = self.s3_client.get_bucket_policy(
        Bucket='<your-bucket-name>',
    )
    print(resp)

請求參數

返回結果

刪除桶策略

功能說明

您可以通過delete_bucket_policy接口刪除指定存儲桶的授權策略。如果您使用的身份不是該存儲桶的擁有者，則調用身份必須對指定存儲桶具有DeleteBucketPolicy權限，且屬于該存儲桶所有者的帳戶。如果您沒有DeleteBucketPolicy權限，方法將返回403 Access Denied錯誤。如果您具有正確的權限，但您沒有使用屬于存儲桶所有者賬戶的身份，則返回405 Method Not Allowed錯誤。

代碼示例

def delete_bucket_policy(self):
    resp = self.s3_client.delete_bucket_policy(
        Bucket='<your-bucket-name>',
    )
    print(resp)

請求參數

返回結果

根據返回碼判斷是否刪除成功，200表示刪除成功

設置桶生命周期配置

功能說明

生命周期管理可以通過設置規則實現自動清理過期的對象，優化存儲空間。您可以使用put_bucket_lifecycle_configuration接口設置桶的生命周期配置，配置規則可以通過匹配對象key前綴、標簽的方法設置當前版本或者歷史版本對象的過期時間，對象過期后會被自動刪除。

def put_bucket_lifecycle_configuration(self):
    resp = self.s3_client.put_bucket_lifecycle_configuration(
        Bucket='<your-bucket-name>',
        LifecycleConfiguration={
            'Rules': [
                {
                    'ID': 'TestOnly',
                    'Expiration': {
                        'Days': 3650,
                    },
                    'Status': 'Enabled',
                    'Filter': {
                        'Prefix': 'documents/',                      
                    },
                    'Transitions': [
                        {
                            'Days': 365,
                            'StorageClass': 'GLACIER',
                        },
                    ],
                    'AbortIncompleteMultipartUpload': {
                        'DaysAfterInitiation': 123
                    }
                },
            ],
        },
    )
    print(resp)

請求參數

關于生命周期規則Rule一些說明

關于Expiration的說明：

關于AbortIncompleteMultipartUpload的說明：

關于Transition的說明：

關于Filter的說明：

返回結果

根據返回碼判斷是否設置成功，200表示成功。

獲取桶生命周期配置

功能說明

您可以使用get_bucket_lifecycle_configuration接口獲取桶的生命周期配置。

代碼示例

def get_bucket_lifecycle_configuration(self):
    resp = self.s3_client.get_bucket_lifecycle_configuration(
        Bucket='<your-bucket-name>'
    )
    print(resp)

請求參數

返回結果

關于生命周期規則Rule一些說明

關于Expiration的說明：

關于AbortIncompleteMultipartUpload的說明：

關于Transition的說明：

關于Filter的說明：

刪除桶生命周期配置

功能說明

您可以使用delete_bucket_lifecycle接口刪除桶的生命周期配置。

代碼示例

def delete_bucket_lifecycle(self):
    resp = self.s3_client.delete_bucket_lifecycle(
        Bucket='<your-bucket-name>'
    )
    print(resp)

請求參數

返回結果

根據返回碼判斷是否設置成功，204表示成功。

設置桶跨域訪問配置

功能說明

跨域資源共享 (CORS) 定義了在一個域中加載的客戶端 Web 應用程序與另一個域中的資源交互的方式。利用 CORS 支持，您可以構建豐富的客戶端 Web 應用程序，同時可以選擇性地允許跨源訪問您的資源。您可以通過put_bucket_cors接口設置桶的跨域訪問配置。

代碼示例

def put_bucket_cors(self):
    resp = self.s3_client.put_bucket_cors(
        Bucket='<your-bucket-name>',
        CORSConfiguration={
            'CORSRules': [{
                'AllowedHeaders': ["*"],
                'AllowedMethods': ["POST", "GET", "PUT", "DELETE", "HEAD"],
                'AllowedOrigins': ["*"], # 可以使用//domain:port
                'ExposeHeaders': ["ETag"],
                'MaxAgeSeconds': 3600,
            }],
        },
    )
    print(resp)

請求參數

關于跨域訪問配置CORSRule的一些說明

返回結果

根據返回碼判斷是否設置成功，200表示成功。

獲取桶跨域訪問配置

功能說明

跨域資源共享 (CORS) 定義了在一個域中加載的客戶端 Web 應用程序與另一個域中的資源交互的方式。利用 CORS 支持，您可以構建豐富的客戶端 Web 應用程序，同時可以選擇性地允許跨源訪問您的資源。您可以通過get_bucket_cors接口獲取桶跨域訪問配置。

代碼示例

def get_bucket_cors(self):
    resp = self.s3_client.get_bucket_cors(
        Bucket='<your-bucket-name>',
    )
    print(resp)

請求參數

返回結果

關于跨域訪問配置CORSRules的一些說明

刪除桶跨域訪問配置

功能說明

跨域資源共享 (CORS) 定義了在一個域中加載的客戶端 Web 應用程序與另一個域中的資源交互的方式。利用 CORS 支持，您可以構建豐富的客戶端 Web 應用程序，同時可以選擇性地允許跨源訪問您的資源。您可以通過delete_bucket_cors接口刪除桶跨域訪問配置。

代碼示例

def delete_bucket_cors(self):
    resp = self.s3_client.delete_bucket_cors(
        Bucket='<your-bucket-name>',
    )
    print(resp)

請求參數

返回結果

根據返回碼判斷是否設置成功，204表示成功。

設置桶版本控制狀態

功能說明

您可以通過put_bucket_versioning設置存儲桶版本控制狀態。存儲桶的版本控制狀態可以設置為以下的值：

• Enabled：對存儲桶中的所有對象啟用版本控制，之后每個添加到存儲桶中的對象都會被設置一個唯一的version ID。

• Suspended：暫停存儲桶的版本控制，之后每個添加到bucket中的對象的version ID會被設置為null。

代碼示例

def put_bucket_versioning(self):
    resp = self.s3_client.put_bucket_versioning(
        Bucket='<your-bucket-name>',
        VersioningConfiguration={
            'Status': 'Enabled'      #'Enabled'|'Suspended'
        }, )
    print(resp)

請求參數

VersioningConfiguration說明

返回結果

根據返回碼判斷是否設置成功，200表示成功。

獲取桶版本控制狀態

功能說明

您可以通過get_bucket_versioning獲取存儲桶的版本控制狀態信息。只有存儲桶的擁有者才能獲取到版本控制信息。如果存儲桶從來沒有被設置過版本控制狀態，那么該存儲桶不含有任何版本控制的狀態信息，執行get_bucket_versioning操作不能獲取版本控制信息的有效值。

代碼示例

def get_bucket_versioning(self):
    resp = self.s3_client.get_bucket_versioning(
        Bucket='<your-bucket-name>',
    )
    print(resp)

請求參數

返回結果