Actualizar tema
Importante
Esta API está obsoleta y retirada a partir del 11/1/2021 y ya no debe usarse.
Actualiza un tema. El descriptor actualizado se envía en el cuerpo de la solicitud. La API actualiza las entradas de tema en las entradas FE/BE.
Solicitud
| Método | URI de solicitud | Versión de HTTP |
|---|---|---|
| PUT | https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{Namespace}/Topics/{Topic Path} | HTTP/1.1 |
Encabezados de solicitud
En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.
| Encabezado de solicitud | Descripción |
|---|---|
| x-ms-version | 2012-03-01 |
| If-Match | * |
La solicitud también requiere un certificado de cliente. Este certificado debe coincidir con el certificado que cargó para la suscripción concreta.
Cuerpo de la solicitud
En la tabla siguiente se describen los elementos clave del cuerpo de la solicitud: Estas son las únicas propiedades que se pueden actualizar. El cuerpo debe incluir la descripción completa del tema, aunque solo cambie una propiedad. El flujo recomendado es el siguiente:
Obtener la descripción del tema.
Actualizar los elementos necesarios.
Especificar la descripción actualizada.
| Nombre de propiedad | Tipo | Descripción |
|---|---|---|
| DefaultMessageTimeToLive | Fecha y hora XML | En función de si la entrega de mensajes fallidos está habilitada, si un mensaje se ha almacenado en el tema durante más del tiempo especificado, se mueve automáticamente a la cola de mensajes fallidos o se elimina. Este valor lo sobrescribe un TTL especificado en el mensaje si el TTL del mensaje es menor que el TTL establecido en el tema. Este valor es inmutable tras la creación del tema: - Intervalo: 1 segundo – 14 días. - Valor predeterminado: 14 días. |
| DuplicateDetectionHistoryTimeWindow | Intervalo de tiempo | Propiedad que especifica el intervalo de tiempo durante el que Service Bus detecta la duplicación de mensajes. - Intervalo: 1 segundo – 7 días. - Valor predeterminado: 10 minutos. |
| EnableFilteringMessagesBeforePublishing | Boolean | Propiedad que especifica si se debe o no aplicar un filtrado antes de publicar el mensaje. Para obtener más información, vea EnableFilteringMessagesBeforePublishing. |
Response
La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.
Códigos de respuesta
Nota
Si crea un tema con un nombre que contiene caracteres especiales o codificados (por ejemplo, "test?Name=value&", que se codifica como "test%3FName%3Dvalue%26"), se genera una excepción (401) No autorizado.
| Código | Descripción |
|---|---|
| 200 | Descripción del tema actualizada correctamente. |
| 401 | Error de autorización. |
| 404 | La entidad no existe en este espacio de nombres. |
| 500 | Error interno. |
Para obtener información sobre los códigos de estado, vea Códigos de estado y error.
Encabezados de respuesta
| Encabezado de respuesta | Descripción |
|---|---|
| Content-Type | application/xml;type=entry;charset=utf-8 |
Cuerpo de la respuesta
Si esta operación se realiza correctamente, se devuelve un descriptor de tema actualizado en el cuerpo de la respuesta.