Créer ou mettre à jour une entité

Article
07/19/2023

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.

Partager via