Actualización de una instalación

Azure Notification Hubs admite actualizaciones parciales en una instalación mediante el estándar JSON-Patch en RFC6902.

Solicitud

Método	URI de solicitud	Versión de HTTP
PATCH	https://{namespace}.servicebus.windows.net/{NotificationHub}/installations/{id}?api-version=2015-01	HTTP/1.1

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

Encabezado de solicitud	Descripción
Content-Type	application/json-patch+json
Authorization	Token de SAS generado tal y como se especifica en Autenticación de firma de acceso compartido con Service Bus.
x-ms-version	2015-01

Cuerpo de la solicitud

Se permiten las siguientes operaciones de revisión:

JSON-Patch operación	Installation (propiedad)	Descripción y muestra
agregar	PushChannel	Actualice el canal de una instalación. [ { "op": "add", "path": "/pushChannel", "value": "aaaaaaa"} ] Coloque expiredPushChannel en true si se cambia pushChannel.
agregar	UserId	Actualice o agregue el valor de identificador de usuario. [ { "op": "add", "path": "/userId", "value": "Bob"} ]
agregar	Etiqueta	Si value es array, agregue todas las etiquetas de la matriz a las etiquetas existentes (incluso si no están presentes). Si value es una cadena, agregue una etiqueta a la matriz actual (o cree una nueva matriz con un valor único, si no hay etiquetas actualmente presentes). [ { "op": "add", "path": "/tags", "value": "tag"} ]
agregar	Plantilla (P2)	Actualice o agregue toda la plantilla. [ { "op": "add", "path": "/templates/myTemplate", "value": '{"body": "…", "tags": ["tag"]}'} ]
agregar	Cuerpo de la plantilla,encabezado/expiración/etiquetas	Actualice o agregue partes de plantilla (tenga en cuenta que "add" en los encabezados reemplaza al objeto de encabezados actual). Agregar etiquetas tiene la misma semántica que las etiquetas nativas. [ { "op": "add", "path": "/templates/myTemplate/body", "value": '{"aps": …}'} ] [ { "op": "add", "path": "/templates/myTemplate/headers", "value": '{"X-WNS-Type": "wns/toast"}'} ]
agregar	canal secondaryTile	Novedades el canal secondaryTile. [ { "op": "add", "path": "/secondaryTiles/myTile/pushChannel", "value": "aaaaaaa"} ]
agregar	etiqueta secondaryTile	Igual que la actualización de etiquetas, pero la ruta de acceso hace referencia al icono secundario. [ { "op": "add", "path": "/secondaryTiles/myTile/tags", "value": '["fooTag"]'} ]
agregar	plantilla secondaryTile	Igual que las plantillas normales, pero la ruta de acceso hace referencia a tileId.
agregar	secondaryTile template body/header/expiry/tags	Igual que las plantillas normales, pero la ruta de acceso hace referencia a tileId.
Quitar	Mismo caso anterior.	Elimina una propiedad, como userID, o un elemento de la matriz de etiquetas. Si se quita la última etiqueta de la propiedad tags, se quita toda la propiedad. [ { "op": "remove", "path": "/tags/myTag"} ]
Replace	Mismo caso anterior.	Semánticamente equivalente a remove+add.

Response

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Códigos de respuesta

Código	Descripción
204	La instalación se ha revisado correctamente.
400	No se pudo revisar la instalación porque la solicitud tenía un formato incorrecto.
401	Error de autorización. La clave de acceso era incorrecta.
403	Cuota superada; hay demasiados registros en este espacio de nombres. No se ha creado el registro.
403	Solicitud rechazada porque la tasa de llamadas API es demasiado alta.

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/json-patch+json
Content-Location	La ubicación de la instalación en el formato : https://{namespace}.servicebus.windows.net/{NotificationHub}/installations/<installationId>

Response body

Ninguno.

Consulte también

Crear o sobrescribir una instalación
Leer una instalación
Eliminación de una instalación