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.
Important
Cette API est obsolète et mise hors service à partir du 1/11/2021 et ne doit plus être utilisée.
Met à jour une rubrique. Le descripteur mis à jour est envoyé dans le corps de la requête. L'API met à jour les entrées de cette rubrique dans les entrées FE/BE.
Requête
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| PUT | https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{Espace de noms}/Topics/{Chemin de la rubrique} | HTTP/1.1 |
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 |
|---|---|
| x-ms-version | 2012-03-01 |
| If-Match | * |
La demande nécessite également un certificat client. Ce certificat doit correspondre à celui que vous avez téléchargé pour cet abonnement.
Corps de la demande
Le tableau suivant décrit les principaux éléments du corps de la requête. Ce sont les seules propriétés que vous pouvez mettre à jour. Le corps doit inclure la description complète de la rubrique, même si vous ne modifiez qu’une seule propriété. Il est recommandé d'utiliser le flux suivant :
Obtenir la description de la rubrique.
Mettre à jour les éléments requis.
Transmettre la description mise à jour.
| Nom de la propriété | Type | Description |
|---|---|---|
| DefaultMessageTimeToLive | Date/heure XML | Selon que la lettre morte est activée, si un message a été stocké dans la rubrique pendant plus que la durée spécifiée, il est automatiquement déplacé vers la file d’attente de lettres mortes ou supprimé. Cette valeur est remplacée par une durée de vie spécifiée sur le message si la durée de vie du message est inférieure à la durée de vie définie sur la rubrique. Cette valeur est immuable après la création de la rubrique : - Plage : 1 seconde à 14 jours. - Valeur par défaut : 14 jours. |
| DuplicateDetectionHistoryTimeWindow | Time Span | Propriété qui spécifie l’intervalle de temps pendant lequel Service Bus détecte la duplication des messages. - Plage : 1 seconde à 7 jours. - Valeur par défaut : 10 minutes. |
| EnableFilteringMessagesBeforePublishing | Boolean | Propriété spécifiant l'application éventuelle de filtres avant la publication du message. Pour plus d’informations, consultez EnableFilteringMessagesBeforePublishing. |
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 créez une rubrique portant un nom contenant des caractères particuliers ou codés (par exemple, « test?Name=value& », qui est codée en « test%3FName%3Dvalue%26 »), une exception non autorisée (401) est générée.
| Code | Description |
|---|---|
| 200 | La description de la rubrique a été correctement mise à jour. |
| 401 | Échec de l'autorisation. |
| 404 | L’entité n’existe pas sous cet espace de noms. |
| 500 | Erreur interne. |
Pour plus d’informations sur les codes status, consultez Codes d’état et d’erreur.
En-têtes de réponse
| En-tête de réponse | Description |
|---|---|
| Content-Type | application/xml;type=entry;charset=utf-8 |
Corps de la réponse
Si l'opération réussit, un descripteur de rubrique mis à jour est renvoyé dans le corps de la réponse.