全部產品
Search
文件中心

Object Storage Service:put-bucket-qos-info

更新時間:Jan 07, 2025

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