GetBucketQoSInfo - Object Storage Service - Alibaba Cloud ドキュメントセンター

GetBucketQoSInfo を呼び出して、バケットにアクセスする特定のリクエスタの速度制限構成をクエリできます。

注意事項

リソースプール QoS は招待プレビュー中です。リージョン内の OSS バケットのスループットが 500 Gbit/s に達した場合、または 500 Gbit/s を超えた場合は、テクニカルサポートに連絡して、この機能を申請できます。
デフォルトでは、Alibaba Cloud アカウントには、リソースプール内のバケットに対するすべてのリクエスタの速度制限構成をクエリする権限があります。 RAM ユーザーとして、または Security Token Service ( STS ) を使用してクエリリクエストを行うには、oss:GetBucketQoSInfo 権限が必要です。詳細については、「RAM ポリシーの一般的な例」をご参照ください。

構文

GET /?qosInfo HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

リクエストヘッダー

GetBucketQoSInfo リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。詳細については、「共通の HTTP ヘッダー」をご参照ください。

レスポンスヘッダー

GetBucketQoSInfo リクエストへのレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。詳細については、「共通レスポンスヘッダー」をご参照ください。

レスポンス要素

名前	タイプ	例	説明
QoSConfiguration	コンテナ	該当なし	リクエストの結果を格納するコンテナ。親ノード: なし
TotalUploadBandwidth	整数	10	バケットの合計アップロード帯域幅。単位: Gbit/s。親ノード: QoSConfiguration
IntranetUploadBandwidth	整数	-1	バケットの内部ネットワーク経由のアップロード帯域幅。内部ネットワークには、クラシックネットワークと VPC が含まれます。単位: Gbit/s。親ノード: QoSConfiguration
ExtranetUploadBandwidth	整数	-1	バケットのパブリックネットワーク経由のアップロード帯域幅。パブリックネットワークには、インターネットとアクセラレーションエンドポイントが含まれます。単位: Gbit/s。親ノード: QoSConfiguration
TotalDownloadBandwidth	整数	10	バケットの合計ダウンロード帯域幅。単位: Gbit/s。親ノード: QoSConfiguration
IntranetDownloadBandwidth	整数	-1	バケットの内部ネットワーク経由のダウンロード帯域幅。内部ネットワークには、クラシックネットワークと VPC が含まれます。単位: Gbit/s。親ノード: QoSConfiguration
ExtranetDownloadBandwidth	整数	-1	バケットのパブリックネットワーク経由のダウンロード帯域幅。パブリックネットワークには、インターネットとアクセラレーションエンドポイントが含まれます。単位: Gbit/s。親ノード: QoSConfiguration

例

リクエストの例

Get /?qosInfo HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com   
Date: Fri, 27 Dec 2024 03:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

レスポンスの例

HTTP/1.1 200 OK
Date: Fri, 27 Dec 2024 03:21:12 GMT
Content-Type: application/xml
Content-Length: 556
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 534****

<?xml version="1.0" encoding="UTF-8"?>
<QoSConfiguration>
  <TotalUploadBandwidth>10</TotalUploadBandwidth>
  <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
</QoSConfiguration>

OSS SDK

以下のプログラミング言語の OSS SDK を使用して GetBucketQoSInfo を呼び出すことができます。

ossutil

GetBucketQoSInfo 操作に対応する ossutil コマンドについては、「get-bucket-qos-info」をご参照ください。