Object Storage Service:Put-bucket-qos-info

Notes d'utilisation

• Par défaut, un compte Alibaba Cloud dispose des autorisations nécessaires pour configurer les informations QoS d'un bucket. Pour configurer les informations QoS d'un bucket à l'aide d'un utilisateur Resource Access Management (RAM) ou du Security Token Service (STS), vous devez disposer de l'autorisation oss:PutBucketQoSInfo. Pour plus d'informations, consultez la rubrique Accorder une stratégie personnalisée.

• Vous ne pouvez configurer la limitation de bande passante que pour les buckets ajoutés à un pool de ressources. Le seuil de bande passante de chaque élément de configuration d'un bucket ne peut pas dépasser le seuil de bande passante du pool de ressources auquel le bucket appartient.

• Une valeur de -1 indique qu'aucune limite n'est imposée pour le champ concerné. Si un champ n'est pas spécifié, la valeur par défaut est -1. Une valeur de 0 interdit un type spécifique de requête d'accès.

• La bande passante d'un sous-élément ne peut pas dépasser la bande passante totale de l'élément. Par exemple, si vous définissez la bande passante totale d'upload sur 10 Gbit/s, la bande passante d'upload via les réseaux internes ne peut pas dépasser 10 Gbit/s.

Syntaxe

ossutil api invoke-operation --op-name put-bucket-qos-info --method PUT --bucket <bucket-name> --parameters qosInfo --body=file://<path-to-xml-file>

--body

Le paramètre --body prend en charge le format XML. Si la valeur du paramètre commence par file://, les configurations sont chargées à partir d'un fichier spécifique.

<QoSConfiguration>
  <TotalUploadBandwidth>integer</TotalUploadBandwidth>
  <IntranetUploadBandwidth>integer</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>integer</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>integer</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>integer</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>integer</ExtranetDownloadBandwidth>
  <TotalQps>integer</TotalQps>
  <IntranetQps>integer</IntranetQps>
  <ExtranetQps>integer</ExtranetQps>
</QoSConfiguration>

Le tableau suivant décrit les paramètres requis dans le fichier de configuration.

Exemple

Ajoutez des configurations QoS à un bucket nommé examplebucket en créant un fichier de configuration XML nommé qos.xml et en y ajoutant l'exemple de code suivant :

<QoSConfiguration>
  <TotalUploadBandwidth>10</TotalUploadBandwidth>
  <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
  <TotalQps>10000</TotalQps>
  <IntranetQps>-1</IntranetQps>
  <ExtranetQps>-1</ExtranetQps>
</QoSConfiguration>

Les éléments suivants décrivent les paramètres :

• Le paramètre TotalUploadBandwidth est défini sur 10, ce qui spécifie que la bande passante totale d'upload est de 10 Gbit/s. La bande passante totale d'upload via les réseaux internes et publics ne peut pas dépasser 10 Gbit/s.

• Le paramètre IntranetUploadBandwidth est défini sur -1, ce qui indique qu'aucune limite n'est imposée à la bande passante d'upload via les réseaux internes. Toutefois, la bande passante d'upload via les réseaux internes doit être inférieure ou égale à la bande passante totale d'upload, soit 10 Gbit/s.

• Le paramètre ExtranetUploadBandwidth est défini sur -1, ce qui indique qu'aucune limite n'est imposée à la bande passante d'upload via les réseaux publics. Toutefois, la bande passante d'upload via les réseaux publics doit être inférieure ou égale à la bande passante totale d'upload, soit 10 Gbit/s.

• Le paramètre TotalDownloadBandwidth est défini sur 10, ce qui spécifie que la bande passante totale de download est de 10 Gbit/s. La bande passante totale de download via les réseaux internes et publics ne peut pas dépasser 10 Gbit/s.

• Le paramètre IntranetDownloadBandwidth est défini sur -1, ce qui indique qu'aucune limite n'est imposée à la bande passante de download via les réseaux internes. Toutefois, la bande passante de download via les réseaux internes doit être inférieure ou égale à la bande passante totale de download, soit 10 Gbit/s.

• Le paramètre ExtranetDownloadBandwidth est défini sur -1, ce qui indique qu'aucune limite n'est imposée à la bande passante de download via les réseaux publics. Toutefois, la bande passante de download via les réseaux publics doit être inférieure ou égale à la bande passante totale de download, soit 10 Gbit/s.

• Le paramètre TotalQps est défini sur 10000, ce qui spécifie que la limite QPS totale est de 10 000 requêtes par seconde. Le nombre total de QPS via les réseaux internes et publics ne peut pas dépasser cette valeur.

• Le paramètre IntranetQps est défini sur -1, ce qui indique qu'aucune limite n'est imposée au QPS via les réseaux internes. Toutefois, le QPS via les réseaux internes doit être inférieur ou égal au QPS total, soit 10 000 requêtes par seconde.

• Le paramètre ExtranetQps est défini sur -1, ce qui indique qu'aucune limite n'est imposée au QPS via les réseaux externes. Toutefois, le QPS via les réseaux externes doit être inférieur ou égal au QPS total, soit 10 000 requêtes par seconde.

Exemple de commande :

ossutil api invoke-operation --op-name put-bucket-qos-info --method PUT --bucket examplebucket --parameters qosInfo --body=file://qos.xml