Actualizar una suscripción para una notificación
Se aplica a: Windows Azure Pack
Novedades el estado de la suscripción para una notificación.
Solicitud
Reemplace <NotificationEndpoint> por la dirección del punto de conexión de la API rest de notificación del proveedor de recursos personalizado de Azure Pack Windows. Reemplace <Id> por el identificador de la suscripción que se va a actualizar.
Método |
URI de solicitud |
Versión de HTTP |
|---|---|---|
PUT |
<http:// NotificationEndpoint>/subscriptions/<Id> |
HTTP/1.1 |
Parámetros de identificador URI
Ninguno.
Encabezados de solicitud
En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.
Encabezado de solicitud |
Descripción |
|---|---|
Autorización: Básico |
Obligatorio. Token de autorización básico. |
x-ms-principal-id |
Obligatorio. El identificador de la entidad de seguridad. |
x-ms-client-request-id |
Opcional. Identificador de solicitud de cliente. |
x-ms-client-session-id |
Opcional. Identificador de sesión de cliente. |
x-ms-principal-liveid |
Opcional. Identificador activo principal. |
Cuerpo de la solicitud
En la tabla siguiente se describen los elementos del cuerpo de la solicitud.
Nombre del elemento |
Descripción |
|---|---|
Suscripción |
La suscripción que se va a actualizar. Para obtener más información, vea Suscripción (objeto de punto de conexión de notificación) . |
Response
La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.
Código de estado
Una operación correcta devuelve el código de estado 200 Correcto.
Para obtener información sobre los códigos de estado, consulte Códigos de estado y error (Windows Administración de servicios de Azure Pack).
Encabezados de respuesta
La respuesta de esta operación incluye encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.
Cuerpo de la respuesta
La tabla siguiente describe los elementos clave del cuerpo de la respuesta:
Nombre del elemento |
Descripción |
|---|---|
Suscripción |
La suscripción actualizada. Para obtener más información, vea Suscripción (objeto de punto de conexión de notificación) . |
Ejemplo
En el ejemplo siguiente se muestra una actualización de una suscripción para una solicitud de notificación .
PUT https://<NotificationEndpoint>:30010/subscriptions/ec66ec96-8edd-4916-be45-607959155c2a HTTP/1.1
Referer: https://<Computer>:30004/subscriptions/ec66ec96-8edd-4916-be45-607959155c2a
Accept-Language: en-US
x-ms-client-request-id: ef2c5d93-a957-439b-9210-de52107322c1-2014-07-09 23:45:22Z
x-ms-client-session-id: a519f0aa-53e9-4522-94fd-3c55607a6b65
x-ms-principal-id: <Computer>%5cAdministrator
x-ms-request-id: 684b6822d29e4aac96fe45110881e525.2014-07-09T23:45:24.2267567Z
Authorization: Basic <encoded username and password>
Content-Type: application/json; charset=utf-8
Host: <Computer>:30010
Content-Length: 219
Expect: 100-continue
En el ejemplo de código siguiente se muestra la respuesta JSON para Actualizar una suscripción para una notificación.
{
"SubscriptionId": "ec66ec96-8edd-4916-be45-607959155c2a",
"SubscriptionName": "My very cool plan",
"State": 1,
"LifecycleState": 0,
"LastErrorMessage": null,
"QuotaSettings": null,
"AdminId": "notauser@contoso.com",
"CoAdminIds": [
]
}
Comentarios
Esta API solo se puede usar para actualizar los elementos State de una suscripción.
Al llamar a TBD, service Management API espera un minuto para una respuesta. Si no se recibe ninguna respuesta, la suscripción se marca como fuera de sincronización.