Crear una suscripción para una notificación
Se aplica a: Windows Azure Pack
Lo usa service Management API para notificar al proveedor de recursos que se está creando una suscripción a un plan. El objeto Subscription proporcionado proporciona información que el proveedor de recursos puede usar para procesar internamente la nueva suscripción.
Solicitud
Reemplace <NotificationEndpoint> por la dirección del punto de conexión del Windows API rest de notificación del proveedor de recursos personalizado de Azure Pack.
Método |
URI de solicitud |
Versión de HTTP |
|---|---|---|
POST |
<http:// NotificationEndpoint>/subscriptions |
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ásica |
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 de la entidad de seguridad. |
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 crear. 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
Devuelve el código de estado 201 (creado) si la creación de la suscripción interna del proveedor de recursos es correcta. El código de estado 202 (aceptado) se puede devolver si la operación se ejecuta de forma asincrónica.
Para obtener información sobre los códigos de estado, consulte Códigos de estado y error (Windows Azure Pack Service Management).
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 |
Nueva suscripción. Para obtener más información, vea Suscripción (objeto de punto de conexión de notificación) . |
Ejemplo
En el ejemplo de código siguiente se muestra una solicitud Crear suscripción .
POST https://<NotificationEndpoint>/subscriptions HTTP/1.1
Referer: https://<Computer>:30004/subscriptions
Accept-Language: en-US
x-ms-client-request-id: 4abcdb02-cf03-4b07-a1e1-d43c4fe06a8b-2013-07-25 06:09:39Z
x-ms-client-session-id: be02e255-38de-4e86-9690-b3a3e3037e4c
x-ms-principal-id: <COMPUTER>\Administrator
x-ms-principal-liveid: <COMPUTER>\Administrator
x-ms-request-id: 60668356a6204f269a455cc3f3901a84.2013-07-25T06:09:42.8465532Z
Authorization: Basic <encoded username and password>
Content-Type: application/json; charset=utf-8
Host: <Computer>:30010
Content-Length: 438
Expect: 100-continue
{
"SubscriptionId": "685a05ed-3a6f-4c3a-b70c-924a1307834f",
"SubscriptionName": "Hosting Plan One",
"State": 0,
"LifecycleState": 0,
"LastErrorMessage": null,
"QuotaSettings": [
{
"Key": "Editions",
"Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"1024\",\"offerEditionId\":\"070913050037\",\"groupType\":null}]"
}
],
"AdminId": "egghead@contoso.com",
"CoAdminIds": [
]
}
En el ejemplo de código siguiente se muestra una respuesta JSON Crear suscripción .
{
"SubscriptionId": "685a05ed-3a6f-4c3a-b70c-924a1307834f",
"SubscriptionName": "Hosting Plan One",
"State": 0,
"LifecycleState": 0,
"LastErrorMessage": null,
"QuotaSettings": [
{
"Key": "Editions",
"Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"1024\",\"offerEditionId\":\"070913050037\",\"groupType\":null}]"
}
],
"AdminId": "egghead@contoso.com",
"CoAdminIds": [
]
}
Comentarios
Al llamar a TBD, service Management API espera un minuto para obtener una respuesta. Si no se recibe ninguna respuesta, la suscripción se marca como fuera de sincronización.
Se admiten operaciones asincrónicas. Si la operación de creación tardará más de un minuto en completarse, el proveedor de recursos puede devolver 202 (aceptado) y establecer su representación interna de suscripción (objeto de punto de conexión de notificación) . LifecycleState al aprovisionamiento. Una vez que el proveedor de recursos haya completado la operación de creación, debe establecer su representación de suscripción (objeto de punto de conexión de notificación) . LifecycleState en aprovisionado. Service Management API comprobará la suscripción (objeto de punto de conexión de notificación). LifecycleState para la finalización de la operación cada 10 segundos mediante TBD.