リソースプール内のすべてのリクエスタの速度制限構成を照会します。
使用上の注意
リソースプール QoS は招待プレビュー中です。リージョン内の OSS バケットのスループットが 500 Gbit/s に達した場合、または 500 Gbit/s を超えた場合は、テクニカルサポート に連絡して、この機能を申請できます。
デフォルトでは、Alibaba Cloud アカウントには、リソースプール内のすべてのリクエスタの速度制限構成を照会する権限があります。 RAM ユーザーまたは Security Token Service ( STS ) を使用してリソースプール内のすべてのリクエスタの速度制限構成を照会するには、
oss:ListResourcePoolRequesterQoSInfos権限が必要です。 詳細については、「RAM ポリシーの一般的な例」をご参照ください。
構文
GET /?requesterQosInfo&resourcePool=ResourcePoolName&max-keys=2&continuation-token=1105678
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueリクエストヘッダー
ListResourcePoolRequesterQoSInfos リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通のリクエストヘッダー」をご参照ください。
リクエスト要素
要素 | タイプ | 必須 | 例 | 説明 |
resourcePool | String | はい | resource-pool-for-ai | リソースプールの名前。 |
max-keys | Integer | いいえ | 2 | 速度制限構成を照会するリクエスタの最大数。 |
continuation-token | String | いいえ | 1105678 | 速度制限構成が返されるリクエスタ。 |
レスポンスヘッダー
ListResourcePoolRequesterQoSInfos リクエストへのレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。 詳細については、「共通のレスポンスヘッダー」をご参照ください。
レスポンス要素
要素 | タイプ | 例 | 説明 |
ListResourcePoolRequesterQoSInfosResult | コンテナー | N/A | リクエストの結果を格納するコンテナー。 親ノード: なし |
ResourcePool | String | resource-pool-for-ai | リソースプールの名前。 親ノード: ListResourcePoolRequesterQoSInfosResult |
ContinuationToken | String | 1105678 | この ListResourcePoolRequesterQoSInfos リクエストで使用される continuationToken。 親ノード: ListResourcePoolRequesterQoSInfosResult |
NextContinuationToken | String | 3105678 | この ListResourcePoolRequesterQoSInfos リクエストに後続の結果が含まれていることを示します。 NextContinuationToken の値は、後続の結果を照会するために ContinuationToken の値として使用されます。 親ノード: ListResourcePoolRequesterQoSInfosResult |
IsTruncated | ブール値 | true | 照会された結果が切り捨てられるかどうかを示します。
親ノード: ListResourcePoolBucketsResult |
RequesterQoSInfo | コンテナー | N/A | リクエスタの速度制限構成の品質を格納するコンテナー。 親ノード: ListResourcePoolRequesterQoSInfosResult |
Requester | String | 311xxxx | リクエスタのユーザー ID ( UID )。 親ノード: RequesterQoSInfo |
QoSConfiguration | コンテナー | N/A | リクエスタの速度制限構成の品質を格納するコンテナー。 親ノード: RequesterQoSInfo |
TotalUploadBandwidth | Integer | 10 | リクエスタがリソースプールに指定した合計アップロード帯域幅。 単位: Gbit/s。 親ノード: QoSConfiguration |
IntranetUploadBandwidth | Integer | -1 | リクエスタがリソースプールに指定した内部ネットワーク経由のアップロード帯域幅。 内部ネットワークには、クラシックネットワークと VPC が含まれます。 単位: Gbit/s。 親ノード: QoSConfiguration |
ExtranetUploadBandwidth | Integer | -1 | リクエスタがリソースプールに指定したパブリックネットワーク経由のアップロード帯域幅。 パブリックネットワークには、インターネットとアクセラレーションエンドポイントが含まれます。 単位: Gbit/s。 親ノード: QoSConfiguration |
TotalDownloadBandwidth | Integer | 10 | リクエスタがリソースプールに指定した合計ダウンロード帯域幅。 単位: Gbit/s。 親ノード: QoSConfiguration |
IntranetDownloadBandwidth | Integer | -1 | リクエスタがリソースプールに指定した内部ネットワーク経由のダウンロード帯域幅。 内部ネットワークには、クラシックネットワークと VPC が含まれます。 単位: Gbit/s。 親ノード: QoSConfiguration |
ExtranetDownloadBandwidth | Integer | -1 | リクエスタがリソースプールに指定したパブリックネットワーク経由のダウンロード帯域幅。 パブリックネットワークには、インターネットとアクセラレーションエンドポイントが含まれます。 単位: Gbit/s。 親ノード: QoSConfiguration |
例
リクエストの例
GET /?requesterQosInfo&resourcePool=resource-pool-for-ai&continuation-token=1105678&max-keys=2 Host: oss-cn-shanghai.aliyuncs.com Date: Sun, 11 Aug 2024 17:45:00 GMT Authorization: SignatureValue成功レスポンスの例
HTTP/1.1 200 OK Date: Sun, 11 Aug 2024 17:45:00 GMT Content-Length: conetent length x-oss-request-id: 1265 <?xml version="1.0" encoding="UTF-8"?> <ListResourcePoolRequesterQoSInfosResult> <ResourcePool>resource-pool-for-ai</ResourcePool> <ContinuationToken>1105678</ContinuationToken> <NextContinuationToken>3105678</NextContinuationToken> <IsTruncated>true</IsTruncated> <RequesterQoSInfo> <Requester>311xxxx</Requester> <QoSConfiguration> <TotalUploadBandwidth>10</TotalUploadBandwidth> <IntranetUploadBandwidth>-1</IntranetUploadBandwidth> <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth> <TotalDownloadBandwidth>10</TotalDownloadBandwidth> <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth> <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth> </QoSConfiguration> </RequesterQoSInfo> <RequesterQoSInfo> <Requester>312xxxx</Requester> <QoSConfiguration> <TotalUploadBandwidth>10</TotalUploadBandwidth> <IntranetUploadBandwidth>-1</IntranetUploadBandwidth> <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth> <TotalDownloadBandwidth>10</TotalDownloadBandwidth> <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth> <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth> </QoSConfiguration> </RequesterQoSInfo> </ListResourcePoolRequesterQoSInfosResult>
OSS SDK
次のプログラミング言語に対応した OSS SDK を使用して、ListResourcePoolRequesterQoSInfos を呼び出すことができます。
ossutil
ListResourcePoolRequesterQoSInfos 操作に対応する ossutil コマンドについては、「list-resource-pool-requester-qos-infos」をご参照ください。