Object Storage Service：擷取儲存空間的地區（Python SDK V2）

注意事項

• 本文範例程式碼以華東1（杭州）的地區IDcn-hangzhou為例，預設使用外網Endpoint，如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS，請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係，請參見OSS地區和訪問網域名稱。

• 本文以從環境變數讀取存取憑證為例。如何配置訪問憑證，請參見配置訪問憑證。

• 要擷取儲存空間的地區，您必須具有oss:GetBucketLocation許可權。具體操作，請參見為RAM使用者授予自訂的權限原則。

方法定義

get_bucket_location(request: GetBucketLocationRequest, **kwargs) → GetBucketLocationResult

請求參數列表

傳回值列表

關於擷取儲存空間的地區方法的完整定義，請參見get_bucket_location。

範例程式碼

您可以使用以下代碼擷取儲存空間所在的地區。

import argparse
import alibabacloud_oss_v2 as oss

# 建立命令列參數解析器，描述此指令碼用於擷取指定Bucket的位置資訊。
parser = argparse.ArgumentParser(description="Get the location of a specified OSS bucket.")

# 添加命令列參數 --region，表示儲存空間所在的地區，必需參數
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)

# 添加命令列參數 --bucket，表示儲存空間的名稱，必需參數
parser.add_argument('--bucket', help='The name of the bucket to get the location for.', required=True)

# 添加命令列參數 --endpoint，表示其他服務可用來訪問OSS的網域名稱，非必需參數
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS.')

def main():
    """
    主函數，用於解析命令列參數並擷取指定Bucket的位置資訊。
    """

    args = parser.parse_args()  # 解析命令列參數

    # 從環境變數中載入憑證資訊，用於身分識別驗證
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # 使用SDK的預設配置，並設定憑證提供者和地區資訊
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider
    cfg.region = args.region

    # 如果提供了endpoint參數，則設定配置中的endpoint
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # 使用配置好的資訊建立OSS用戶端
    client = oss.Client(cfg)

    # 構造請求以擷取指定Bucket的位置資訊
    request = oss.GetBucketLocationRequest(bucket=args.bucket)

    # 執行請求並擷取響應結果
    result = client.get_bucket_location(request)

    # 列印響應結果的狀態代碼、請求ID和位置資訊
    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
          f' location: {result.location}'
    )

if __name__ == "__main__":
    main()  # 指令碼入口，當檔案被直接運行時調用main函數

相關文檔

• 關於擷取儲存空間地區的完整範例程式碼，請參見get_bucket_location.py。