put-resource-pool-bucket-group-qos-info - Object Storage Service

put-resource-pool-bucket-group-qos-info命令用於配置或修改資源集區中BucketGroup的流控資訊。

注意事項

重要

當前資源集區QoS為邀測功能，尚未對所有使用者開放使用。如果您在某個地區的OSS效能達到了500Gbps及以上，您可以聯絡支援人員申請使用。

阿里雲帳號預設擁有配置資源集區中BucketGroup的流控資訊的許可權。如果您需要通過RAM使用者或者STS的方式進行配置，您必須擁有oss:PutResourcePoolBucketGroupQoSInfo許可權。具體操作，請參見為RAM使用者授權自訂的權限原則。

命令格式

ossutil api invoke-operation --op-name put-resource-pool-bucket-group-qos-info --method PUT --parameters resourcePool=<resource-pool> --parameters resourcePoolBucketGroup=<GroupName> --parameters resourcePoolBucketGroupQosInfo --body=file://<path-to-xml>

參數	類型	說明
--parameters	stringArray	請求的查詢參數，採用 k[=v] 格式，如 versionId=123、delete。
--body	string	請求體，file:// 表示從檔案讀取，- 表示從標準輸入讀取。

--body

--body配置選項支援XML文法，當選項值包含file://首碼時，表示從檔案中讀取配置。

<QoSConfiguration>
  <TotalUploadBandwidth>integer</TotalUploadBandwidth>
  <IntranetUploadBandwidth>integer</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>integer</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>integer</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>integer</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>integer</ExtranetDownloadBandwidth>
</QoSConfiguration>

說明

以下頻寬配置項中，取值為-1（預設值）表示不限制頻寬。取值為0，表示禁止該類型的頻寬，例如ExtranetUploadBandwidth取值為0，表示禁止通過外網上傳資料到指定Bucket。
BucketGroup頻寬配置總和不能超過資源集區總的頻寬配置。BucketGroup單項頻寬配置不能超過總的頻寬配置。例如，總下載頻寬配置為10Gbps，則外網下載頻寬不能超過10Gbps。
BucketGroup單項頻寬配置不能低於5Gbps。

參數	類型	是否必填	樣本值	單位	說明
TotalUploadBandwidth	Integer	是	10	Gbps	總上傳頻寬配置父節點：QoSConfiguration
IntranetUploadBandwidth	Integer	是	-1	Gbps	內網上傳頻寬配置，包括傳統網路內網上傳和VPC網路內網上傳等等來自於內網的請求父節點：QoSConfiguration
ExtranetUploadBandwidth	Integer	是	-1	Gbps	外網上傳頻寬配置，包括公網上傳以及CDN上傳等等來自於外網的請求父節點：QoSConfiguration
TotalDownloadBandwidth	Integer	是	10	Gbps	總下載頻寬配置父節點：QoSConfiguration
IntranetDownloadBandwidth	Integer	是	-1	Gbps	內網下載頻寬配置，包括傳統網路內網下載和VPC網路內網下載等來自於內網的請求，單位Gbps 父節點：QoSConfiguration
ExtranetDownloadBandwidth	Integer	是	-1	Gbps	外網下載頻寬配置，包括公網下載以及CDN下載等等來自於外網的請求父節點：QoSConfiguration

說明

關於支援的全域命令列選項，請參見支援的全域命令列選項。

使用樣本

將指定的 QoS 資訊應用到資源集區 examplePool 中名為 exampleGroup 的BucketGroup，使用XML設定檔，qos.xml 的內容如下：

<QoSConfiguration>
  <TotalUploadBandwidth>10</TotalUploadBandwidth>
  <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
</QoSConfiguration>

配置參數說明如下：

TotalUploadBandwidth設定為 10，表示上傳的總頻寬節流設定為10 Gbps。無論是內網還是外網，所有上傳操作的頻寬總和不能超過這個值。
IntranetUploadBandwidth設定為 -1，表示對內網的上傳頻寬不配置任何單獨限制，然而，內網上傳頻寬仍需遵循 TotalUploadBandwidth 設定的總體限制。
ExtranetUploadBandwidth設定為 -1，表示對外網的上傳頻寬不配置任何單獨限制，然而，外網上傳頻寬仍需遵循 TotalUploadBandwidth 設定的總體限制。
TotalDownloadBandwidth設定為 10，表示下載的總頻寬節流設定為10 Gbps。所有下載操作，不論是內網還是外網，共用這10 Gbps的頻寬節流設定。
IntranetDownloadBandwidth設定為 -1，表示對內網下載頻寬不配置任何單獨限制，然而，內網下載頻寬仍需遵循 TotalDownloadBandwidth設定的總體限制。
ExtranetDownloadBandwidth設定為 -1，表示對外網下載頻寬不配置任何單獨限制，然而，外網下載頻寬仍需遵循 TotalDownloadBandwidth設定的總體限制。

命令樣本如下：

ossutil api invoke-operation --op-name put-resource-pool-bucket-group-qos-info --method PUT --parameters resourcePool=examplePool --parameters resourcePoolBucketGroup=exampleGroup --parameters resourcePoolBucketGroupQosInfo --body=file://qos.xml