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=truedans 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ètre Type Obligatoire Exemple Description DelaySeconds Integer Non. 0 Dé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.
MaximumMessageSize Integer Non. 1024 Taille maximale du corps du message pouvant être envoyé à la file d'attente. Valeurs valides : 1024 à 65536. Unité : octets.
Valeur par défaut : 65536.
MessageRetentionPeriod Integer Non. 120 Duré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.
VisibilityTimeout Integer Non. 60 Période d'invisibilité pendant laquelle le message reçu reste à l'état Inactif. Valeurs valides : 1 à 43200. Unité : secondes.
Valeur par défaut : 30.
PollingWaitSeconds Integer Non. 0 Duré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.
LoggingEnabled Boolean Non True Indique 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. |