この操作では、バケットの転送アクセラレーション設定を照会します。
使用上の注意
- oss:PutBucketTransferAcceleration権限が付与されたバケットまたはRAMユーザーの所有者のみが、バケットの転送アクセラレーション設定を照会するリクエストを開始できます。
- If transfer acceleration is not configured for the bucket to which you send the GetBucketTransferAcceleration request, no configurations are returned.
For more information about transfer acceleration, see 転送アクセラレーション in the Developer Guide.
リクエスト構造
GET /?transferAcceleration HTTP/1.1
日付: GMT日付
Content-Length: ContentLength
Content-Type: application/xml
ホスト: BucketName.oss.aliyuncs.com
権限付与: SignatureValue
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
---|---|---|---|
TransferAccelerationConfiguration | コンテナー | N/A | 転送アクセラレーション設定の格納に使用されるコンテナー。 |
有効 | String | true | 転送アクセラレーションのステータス有効な値:
|
GetBucketTransferAccelerationリクエストへのレスポンスに含まれるx-oss-request-idやDateなど、その他の一般的なレスポンスヘッダーの詳細については、「共通レスポンスヘッダー」をご参照ください。
例
- リクエストの例
次のサンプルリクエストは、examplebucketという名前のバケットの転送アクセラレーションのステータスを照会するために使用されます。
GET /?transferAcceleration HTTP/1.1 日付: 4月30日金曜日2021 13:08:38 GMT コンテンツ-長さ: 443 Content-Type: application/xml ホスト: examplebucket.oss.aliyuncs.com 承認: OSS qn6qrrqxo2oawuk53otf ****:PYbzsdWAIWAlMW8luk ****
- レスポンスの例
次のレスポンスは、examplebucketで転送アクセラレーションが有効になっていることを示します。
HTTP/1.1 200 OK x-oss-request-id: 534B371674E88A4D8906 **** 日付: 4月30日金曜日2021 13:08:38 GMT <TransferAccelerationConfiguration> <有効> true</有効> </TransferAccelerationConfiguration>
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
---|---|---|
NoSuchTransferAccelerationConfiguration | 404 | The error message returned because transfer acceleration is not configured for the bucket. |