Crear o actualizar entidad
Crea o actualiza una entidad de mensajería.
Solicitud
| Método | URI de solicitud | Versión HTTP |
|---|---|---|
| PUT | https://{serviceNamespace}.servicebus.windows.net/{Entity Path} | HTTP/1.1 |
La ruta de acceso de la entidad puede ser un nombre de varios segmentos, con segmentos separados por "/". La totalidad de la ruta de acceso constituye el nombre de las entidades. Varias entidades pueden compartir los mismos segmentos de prefijo.
Encabezados de solicitud
En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.
| Encabezado de solicitud | Descripción |
|---|---|
| Authorization | Especifica un token de firma de acceso compartido (SAS) con derechos "Administrar". Consulte Autenticación de Service Bus con firmas de acceso compartido para más información. |
| Content-Type | Se establece en application/atom+xml;type=entry;charset=utf-8. |
| If-Match | Establezca este encabezado en "*" para actualizar la entidad. Debe proporcionar todos los valores de propiedad que se desean en la entidad actualizada. Los valores que no se proporcionen se establecen en los valores predeterminados del servicio. Si falta este encabezado, la llamada de actualización devuelve un error que indica que esta entidad ya existe. |
Cuerpo de la solicitud
El cuerpo de la solicitud debe contener una entrada XML Atom válida que inserte la descripción de la entidad que se creará.
<?xml version="1.0" encoding="utf-8" ?>
<entry xmlns='http://www.w3.org/2005/Atom'>
<content type='application/xml'>
{description}
</content>
</entry>
En el que la {description} describe una cola o un tema para entidades de nivel superior, o una suscripción o regla relativas a sus entidades primarias.
Una cola, por ejemplo, se describe con un QueueDescription elemento . Por lo tanto, la carga XML para crear o actualizar una cola podría adoptar el siguiente formato, por lo que todas las propiedades omitidas asumen sus valores predeterminados:
<?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>
Consulte la información general para obtener más información sobre las entidades y cómo se relacionan con las rutas de acceso.
Response
La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.
Códigos de respuesta
Nota
Si actualiza una entidad con un nombre que contiene caracteres especiales o codificados (por ejemplo, "prueba? Name=value&"), que se codifica en "test%3FName%3Dvalue%26"), se generará una excepción no autorizada (401).
| Código | Descripción |
|---|---|
| 201 | Entidad actualizada. |
| 400 | Cuerpo de solicitud no válido. |
| 401 | Error de autorización. |
| 403 | Cuota superada; entidad no actualizada. |
| 500 | Error interno. |
Para obtener información sobre los códigos de estado, vea Códigos de estado y error.
Encabezados de respuesta
Ninguno.
Cuerpo de la respuesta
Se devuelve la descripción de la entidad. Algunas propiedades de descripción pueden contener valores predeterminados si faltan de la solicitud PUT.