Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Crée ou met à jour une entité de messagerie.
Requête
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| PUT | https://{serviceNamespace}.servicebus.windows.net/{Entity Path} | HTTP/1.1 |
Le chemin d’accès de l’entité peut être un nom à plusieurs segments, avec des segments séparés par « / ». L’intégralité du chemin d’accès constitue le nom des entités. Plusieurs entités peuvent partager les mêmes segments de préfixe.
En-têtes de requête
Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.
| En-tête de requête | Description |
|---|---|
| Autorisation | Spécifie un jeton de signature d’accès partagé (SAS) avec des droits « Gérer ». Pour plus d’informations, consultez Authentification Service Bus avec signatures d’accès partagé . |
| Content-Type | Défini sur application/atom+xml;type=entry;charset=utf-8. |
| If-Match | Attribuez la valeur « * » à cet en-tête pour mettre à jour l'entité. Vous devez attribuer toutes les valeurs de propriétés souhaitées à l'entité mise à jour. En l'absence de valeurs, celles-ci seront définies sur les valeurs par défaut du service. Si cet en-tête est manquant, l'appel de mise à jour renvoie une erreur indiquant que cette entité existe déjà. |
Corps de la demande
Le corps de la demande doit contenir une entrée Atom XML valide qui incorpore la description de l’entité qui doit être créée
<?xml version="1.0" encoding="utf-8" ?>
<entry xmlns='http://www.w3.org/2005/Atom'>
<content type='application/xml'>
{description}
</content>
</entry>
La {description} décrit une file d’attente ou une rubrique pour les entités de niveau supérieur, ou un abonnement ou une règle par rapport à leurs entités parentes.
Une file d’attente, pour instance, est décrite avec un QueueDescription élément. La charge utile XML pour la création ou la mise à jour d’une file d’attente peut donc prendre la forme suivante, dans laquelle toutes les propriétés omises supposent leurs valeurs par défaut :
<?xml version="1.0" encoding="utf-8" ?>
<entry xmlns="http://www.w3.org/2005/Atom">
<content type="application/xml">
<QueueDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">
<LockDuration>T1M</LockDuration>
</QueueDescription>
</content>
</entry>
Pour plus d’informations sur les entités et leur relation avec les chemins d’accès, consultez Vue d’ensemble .
response
La réponse inclut un code d'état HTTP et un ensemble d'en-têtes de réponse.
Codes de réponse
Notes
Si vous mettez à jour une entité avec un nom contenant des caractères spéciaux ou encodés (par exemple, « test ? » Name=value& »), qui est encodé en « test%3FName%3Dvalue%26 »), une exception non autorisée (401) est générée.
| Code | Description |
|---|---|
| 201 | Entité mise à jour. |
| 400 | Corps de la demande non valide. |
| 401 | Échec de l'autorisation. |
| 403 | Quota dépassé ; entité non mise à jour. |
| 500 | Erreur interne. |
Pour plus d’informations sur les codes status, consultez Codes d’état et d’erreur.
En-têtes de réponse
Aucun.
Corps de la réponse
La description de l'entité est renvoyée. Certaines propriétés de description peuvent contenir des valeurs par défaut si celles-ci ne figuraient pas dans la demande PUT.