Tous les produits
Search

Ce produit

    Object Storage Service:PutResourcePoolPriorityQosConfiguration

    Centre de documentation

    Object Storage Service:PutResourcePoolPriorityQosConfiguration

    Dernière mise à jour :Aug 18, 2026

    Modifie les configurations de priorité et de qualité de service (QoS) des buckets et des groupes de buckets dans un pool de ressources.

    Précautions

    • Le nombre de niveaux de priorité doit être compris entre 3 et 10.

    • Les niveaux de priorité commencent à 1. Plus le chiffre est élevé, plus la priorité est haute.

    • Si vous ne configurez pas d'engagement minimal de bande passante par défaut (DefaultGuaranteedQosConfiguration), vous devez en définir un pour chaque niveau de priorité. Si une valeur par défaut est configurée, tout niveau de priorité sans engagement spécifique utilisera cette valeur.

    • La somme d'un élément d'engagement minimal de bande passante (tel que TotalUploadBandwidth) sur tous les niveaux de priorité ne peut pas dépasser la valeur de l'élément correspondant dans le pool de ressources.

    • Un engagement minimal de bande passante pour un niveau de priorité ne peut être défini sur -1 que si la valeur de l'élément correspondant dans le pool de ressources est -1.

    • Si un bucket et son groupe de buckets ont des configurations de priorité différentes, la priorité du groupe de buckets prévaut.

    Syntaxe de la requête

    PUT /?priorityQos&resourcePool=ResourcePoolName
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Type: application/xml
Content-Length: content length

    Éléments de la requête

    Nom

    Type

    Position du paramètre

    Description

    resourcePool

    string

    Query

    Nom du pool de ressources cible.

    PriorityQosConfiguration

    container

    Body

    Conteneur de la configuration de limitation de priorité du pool de ressources. Nœud parent : Aucun

    PriorityCount

    Integer

    -

    Nombre de niveaux de priorité. Valeurs valides : 3 à 10. Nœud parent : PriorityQosConfiguration

    DefaultPriorityLevel

    Integer

    -

    Niveau de priorité par défaut. Valeurs valides : 1 à PriorityCount. Nœud parent : PriorityQosConfiguration

    DefaultGuaranteedQosConfiguration

    container

    -

    Engagement minimal de bande passante par défaut. S'il n'est pas configuré, vous devez spécifier un engagement minimal de bande passante pour chaque niveau de priorité. S'il est configuré, les niveaux de priorité sans engagement spécifique utilisent cette valeur par défaut. Nœud parent : PriorityQosConfiguration

    QosPriorityLevelConfiguration

    container

    -

    Conteneur de la configuration de limitation d'un niveau de priorité spécifique. Nœud parent : PriorityQosConfiguration

    PriorityLevel

    Integer

    -

    Niveau de priorité. Valeurs valides : 1 à PriorityCount. Nœud parent : QosPriorityLevelConfiguration

    GuaranteedQosConfiguration

    container

    -

    Conteneur de l'engagement minimal de bande passante d'un niveau de priorité spécifique. Nœud parent : QosPriorityLevelConfiguration

    TotalUploadBandwidth

    Integer

    -

    Engagement minimal total de bande passante en upload. Unité : Gbps. Nœud parent : DefaultGuaranteedQosConfiguration ou GuaranteedQosConfiguration

    IntranetUploadBandwidth

    Integer

    -

    Engagement minimal de bande passante en upload pour le réseau interne. Unité : Gbps. Cela inclut les requêtes provenant des réseaux internes tels que le réseau classique et le VPC. Nœud parent : DefaultGuaranteedQosConfiguration ou GuaranteedQosConfiguration

    ExtranetUploadBandwidth

    Integer

    -

    Engagement minimal de bande passante en upload pour le réseau public. Unité : Gbps. Cela inclut les requêtes provenant des réseaux publics tels qu'Internet et le CDN. Nœud parent : DefaultGuaranteedQosConfiguration ou GuaranteedQosConfiguration

    TotalDownloadBandwidth

    Integer

    -

    Engagement minimal total de bande passante en download. Unité : Gbps. Nœud parent : DefaultGuaranteedQosConfiguration ou GuaranteedQosConfiguration

    IntranetDownloadBandwidth

    Integer

    -

    Engagement minimal de bande passante en download pour le réseau interne. Unité : Gbps. Cela inclut les requêtes provenant des réseaux internes tels que le réseau classique et le VPC. Nœud parent : DefaultGuaranteedQosConfiguration ou GuaranteedQosConfiguration

    ExtranetDownloadBandwidth

    Integer

    -

    Engagement minimal de bande passante en download pour le réseau public. Unité : Gbps. Cela inclut les requêtes provenant des réseaux publics tels qu'Internet et le CDN. Nœud parent : DefaultGuaranteedQosConfiguration ou GuaranteedQosConfiguration

    Subjects

    container

    -

    Conteneur des objets de limitation, y compris les buckets et les groupes de buckets. Nœud parent : QosPriorityLevelConfiguration

    Bucket

    string

    -

    Nom du bucket. Nœud parent : Subjects

    BucketGroup

    string

    -

    Nom du groupe de buckets. Nœud parent : Subjects

    Exemples

    • Exemple de requête

      PUT /?priorityQos&resourcePool=ResoucePoolName
Host: oss-cn-shanghai.aliyuncs.com
Date: Fri, 10 Oct 2025 07:38:42 GMT
Content-Type: application/xml
Content-Length: content length

<PriorityQosConfiguration>
  <PriorityCount>4</PriorityCount>
  <DefaultPriorityLevel>3</DefaultPriorityLevel>
  <DefaultGuaranteedQosConfiguration>
    <TotalUploadBandwidth>10</TotalUploadBandwidth>
    <IntranetUploadBandwidth>20</IntranetUploadBandwidth>
    <ExtranetUploadBandwidth>30</ExtranetUploadBandwidth>
    <TotalDownloadBandwidth>40</TotalDownloadBandwidth>
    <IntranetDownloadBandwidth>50</IntranetDownloadBandwidth>
    <ExtranetDownloadBandwidth>60</ExtranetDownloadBandwidth>
  </DefaultGuaranteedQosConfiguration>
  <QosPriorityLevelConfiguration>
    <PriorityLevel>1</PriorityLevel>
    <GuaranteedQosConfiguration>
      <TotalUploadBandwidth>20</TotalUploadBandwidth>
      <ToTalDownloadBandwidth>20</ToTalDownloadBandwidth>
      <ExtranetUploadBandwidth>10</ExtranetUploadBandwidth>
      <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
      <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth>
      <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth>
    </GuaranteedQosConfiguration>
  </QosPriorityLevelConfiguration>
  <QosPriorityLevelConfiguration>
    <PriorityLevel>2</PriorityLevel>
    <GuaranteedQosConfiguration>
      <TotalUploadBandwidth>20</TotalUploadBandwidth>
      <ToTalDownloadBandwidth>20</ToTalDownloadBandwidth>
      <ExtranetUploadBandwidth>10</ExtranetUploadBandwidth>
      <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
      <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth>
      <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth>
    </GuaranteedQosConfiguration>
    <Subjects>
      <BucketGroup>bucketGroup-02</BucketGroup>
      <Bucket>bucket-02</Bucket>
    </Subjects>
  </QosPriorityLevelConfiguration>
</PriorityQosConfiguration>

    • Exemple de réponse

      HTTP/1.1 200 OK
Date: Fri, 10 Oct 2025 07:38:42 GMT
Content-Length: 0

    SDK

    Les SDK suivants prennent en charge cette opération :

    Outil de ligne de commande ossutil

    Pour la commande ossutil correspondante, consultez put-resource-pool-priority-qos-configuration.