Tous les produits
Search
Centre de documentation

:SetQueueAttributes

Dernière mise à jour :Aug 10, 2026

Modifiez les attributs d'une file d'attente.

Autorisation

Par défaut, seuls les comptes Alibaba Cloud peuvent appeler cette opération. Les utilisateurs RAM ne peuvent l'appeler qu'après avoir reçu les autorisations appropriées. Le tableau suivant décrit les informations d'autorisation associées à cette opération. Pour plus de détails, consultez la rubrique Politiques et exemples d'autorisation.

Nom Valeur
API SetQueueAttributes
Action mns:SetQueueAttributes
Élément acs:mns:$region:$accountid:/queues/$queueName

Requête

Une requête se compose des éléments suivants :

  • Ligne de requête

    PUT /queues/$queueName?metaoverride=true HTTP/1.1

  • Paramètres URI

    Pour modifier les paramètres d'une file d'attente, spécifiez metaoverride=true dans l'URI.

  • En-têtes de requête spécifiques à l'opération

    Aucun.

  • Corps de la requête

    Le corps de la requête est au format XML. Il peut inclure les paramètres de la file d'attente. Tous les paramètres sont facultatifs.

    ParamètreTypeObligatoireExempleDescription
    DelaySecondsIntegerNon.0Délai après lequel tous les messages envoyés à la file d'attente peuvent être consommés.

    Valeurs valides : 0 à 604800. Unité : secondes.

    Valeur par défaut : 0.

    MaximumMessageSizeIntegerNon.1024Taille maximale du corps du message pouvant être envoyé à la file d'attente.

    Valeurs valides : 1024 à 65536. Unité : octets.

    Valeur par défaut : 65536.

    MessageRetentionPeriodIntegerNon.120Durée maximale de conservation d'un message dans la file d'attente. Une fois ce délai écoulé, le message est supprimé, qu'il ait été consommé ou non.

    Valeurs valides : 60 à 604800. Unité : secondes.

    Valeur par défaut : 345600.

    VisibilityTimeoutIntegerNon.60Période d'invisibilité pendant laquelle le message reçu reste à l'état Inactif.

    Valeurs valides : 1 à 43200. Unité : secondes.

    Valeur par défaut : 30.

    PollingWaitSecondsIntegerNon.0Durée maximale d'attente d'une requête ReceiveMessage lorsqu'aucun message n'est disponible dans la file d'attente.

    Valeurs valides : 0 à 30. Unité : secondes.

    Valeur par défaut : 0.

    LoggingEnabledBooleanNonTrueIndique si la fonctionnalité de gestion des journaux est activée. Valeurs valides :
    Valeurs valides :
    • True : active la fonctionnalité de gestion des journaux.
    • False : désactive la fonctionnalité de gestion des journaux.

    Valeur par défaut : False.

    Si vous souhaitez utiliser Terraform pour gérer alicloud_message_service_queue, remplacez le paramètre LoggingEnabled par le paramètre EnableLogging.

Message d'erreur

Une réponse se compose des éléments suivants :

  • Code d'état HTTP

    HTTP/1.1 204 No Content

  • En-têtes de réponse spécifiques à l'opération

    Aucun.

  • Corps de la réponse

    Aucun.

Exemples

Exemple de requête

    PUT /queues/$queueName?Metaoverride=true HTTP/1.1
    Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
    Date: Wed, 08 Mar 2012 12:00:00 GMT
    x-mns-version: 2015-06-06
    Authorization: MNS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAM****

    <?xml version="1.0" encoding="UTF-8"?>
    <Queue xmlns="http://mns.aliyuncs.com/doc/v1/">
        <VisibilityTimeout >60</VisibilityTimeout>
        <MaximumMessageSize>1024</MaximumMessageSize>
        <MessageRetentionPeriod>120</MessageRetentionPeriod>
        <DelaySeconds>30</DelaySeconds>
        <LoggingEnabled>True</LoggingEnabled>
    </Queue>          

Exemple de réponse

    HTTP/1.1 204 No Content
    x-mns-request-id:512B2A634403E52B1956****
    x-mns-version: 2015-06-06            

Codes d'erreur

Code d'erreur Message d'erreur Code d'état HTTP Description
InvalidArgument The value of Element should between Low and High seconds/bytes. 400 Le message d'erreur indique que la valeur du paramètre n'est pas valide. Assurez-vous que la valeur se situe dans la plage autorisée.
QueueNotExist The queue name you provided is not exist. 404 Le message d'erreur indique que la file d'attente spécifiée n'existe pas. Vous devez créer une file d'attente.