Recuperar una suscripción para una notificación
Se aplica a: Windows Azure Pack
Usado por service Management API para recuperar información de suscripció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 recuperar.
Método |
URI de solicitud |
Versión de HTTP |
|---|---|---|
GET |
<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
Ninguno.
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
Devuelve el código de estado 200 (CORRECTO) si la operación se realiza correctamente.
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 recuperada. 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 un elemento Recuperar una suscripción para una solicitud de notificación .
GET 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: 0
Expect: 100-continue
En el ejemplo de código siguiente se muestra la respuesta JSON para Recuperar una suscripción para una notificación.
{
"SubscriptionId": "ec66ec96-8edd-4916-be45-607959155c2a",
"SubscriptionName": null,
"State": 1,
"LifecycleState": 0,
"LastErrorMessage": null,
"QuotaSettings": [
{
"Key": "Editions",
"Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"0\",\"offerEditionId\":\"32814080310\",\"groupType\":\"Shared\"}]"
}
],
"AdminId": "notauser@contoso.com",
"CoAdminIds": [
]
}
Comentarios
La propiedad QuotaSettings debe rellenarse en la respuesta.
Si un proveedor de recursos usa una operación de suscripción asincrónica, el proveedor de recursos devuelve 202 de la operación asincrónica, la API de Administración de servicios llama a TBD cada 10 segundos para determinar si la operación se ha completado.
TBD se usa durante una actualización del sistema desde Windows Azure Pack versión 1.