CreateQueue - - Centre de documentation Alibaba Cloud

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	CreateQueue	L'opération à effectuer. Définissez la valeur sur CreateQueue.
InstanceId	String	Oui	amqp-cn-v0h1kb9nu***	ID de l'instance.
QueueName	String	Oui	DemoQueue	Nom de la file d'attente à créer. Le nom doit comporter entre 1 et 255 caractères. Il ne peut contenir que des lettres, des chiffres et les caractères spéciaux suivants : -_.#/@ Le nom d'une file d'attente est immuable après sa création. Pour le modifier, supprimez la file existante et créez-en une nouvelle.
RegionId	String	Oui	cn-hangzhou	ID de la région.
VirtualHost	String	Oui	test	Nom de l'hôte virtuel (vhost). Le nom doit comporter entre 1 et 255 caractères. Il ne peut contenir que des lettres, des chiffres et les caractères spéciaux suivants : -_.#/@
AutoDeleteState	Boolean	Non	false	Indique si la file d'attente doit être supprimée automatiquement. Valeurs possibles : true : La file d'attente est supprimée automatiquement dès que le dernier consommateur se désabonne. false : La file d'attente n'est pas supprimée automatiquement.
ExclusiveState	Boolean	Non	false	Indique si la file d'attente est exclusive. Valeurs possibles : true : La file d'attente est exclusive. Seule la connexion qui l'a déclarée peut l'utiliser. La file est supprimée automatiquement à la fermeture de la connexion. false : La file d'attente n'est pas exclusive.
MessageTTL	Long	Non	1000	Durée de vie (TTL) des messages dans la file d'attente. Un message expire si sa durée de rétention dans la file dépasse la TTL configurée. La valeur doit être un entier positif ou nul. La durée maximale est d'un jour. L'unité est la milliseconde. Par exemple, avec une TTL de 1 000 ms, les messages survivent au maximum 1 seconde dans la file.
AutoExpireState	Long	Non	10000	Délai d'inactivité au terme duquel la file d'attente est supprimée automatiquement. Si aucune opération n'est effectuée sur la file pendant cette période, elle est effacée. Unité : millisecondes. Remarque Cette fonctionnalité doit être activée avant utilisation. Pour l'activer, soumettez un ticket.
MaxLength	Long	Non	1000	Ce paramètre n'est pas pris en charge par la version actuelle. Nombre maximal de messages stockables dans la file d'attente. En cas de dépassement de ce seuil, les messages les plus anciens sont supprimés.
DeadLetterExchange	String	Non	DLExchange	Échange de lettres mortes (dead-letter exchange). Il reçoit les messages rejetés. Si un consommateur rejette définitivement un message, celui-ci est acheminé vers l'échange de lettres mortes spécifié, puis routé vers la file d'attente liée à cet échange.
DeadLetterRoutingKey	String	Non	test.dl	Clé de routage des lettres mortes. Le nom doit comporter entre 1 et 255 caractères. Il ne peut contenir que des lettres, des chiffres et les caractères spéciaux suivants : -_.#/@
MaximumPriority	Integer	Non	10	Les priorités de file d'attente ne sont pas prises en charge. Ce paramètre n'affecte pas les résultats de l'appel.

Paramètres de réponse

Paramètre

Type

Exemple

Description

| RequestId | String | 59B52E2C-0B8E-44EC-A314-D0314A50*** |

ID de la requête.

|

Exemples

Exemple de requête

http(s)://amqp-open.cn-hangzhou.aliyuncs.com/?Action=CreateQueue
&InstanceId=amqp-cn-v0h1kb9nu***
&MaxLength=1000
&QueueName=DemoQueue
&RegionId=cn-hangzhou
&VirtualHost=test
&<Common request parameters>

Exemple de réponse réussie

XML format

<CreateQueueResponse>
        <RequestId>59B52E2C-0B8E-44EC-A314-D0314A50***</RequestId>
</CreateQueueResponse>

JSON format

{
    "RequestId":"59B52E2C-0B8E-44EC-A314-D0314A50***"
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.