put-bucket-qos-info命令用於配置某個儲存空間(Bucket)的QoS資訊。
注意事項
當前資源集區QoS為邀測功能,尚未對所有使用者開放使用。如果您在某個地區的OSS效能達到了500Gbps及以上,您可以聯絡支援人員申請使用。
阿里雲帳號預設擁有配置儲存空間的QoS資訊的許可權。如果您需要通過RAM使用者或者STS的方式進行配置,您必須擁有
oss:PutBucketQoSInfo許可權。具體操作,請參見為RAM使用者授權自訂的權限原則。只有加入資源集區中的Bucket,才允許配置其流控資訊,且每一項的配置都不能超過資源集區對應的配置。
-1表示不限制,如果某個欄位沒有設定,預設為-1;如果設定成0,意味著完全禁止指定類型的訪問。
細分項的配置不能超過總項的配置,比如總上傳流控配置為10Gbps,那麼內網上傳流控就不能超過10Gbps。
命令格式
ossutil api invoke-operation --op-name put-bucket-qos-info --method PUT --bucket <bucket-name> --parameters qosInfo --body=file://<path-to-xml-file>參數 | 類型 | 說明 |
--bucket | string | Bucket的名稱。 |
--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>關於設定檔中所需配置的參數值說明如下:
參數 | 類型 | 是否必填 | 樣本值 | 單位 | 說明 |
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 資訊配置應用到名為 examplebucket 的儲存空間。使用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-bucket-qos-info --method PUT --bucket examplebucket --parameters qosInfo --body=file://qos.xml