Aprovisionamiento de una nueva suscripción (suscripción de inquilino)
Se aplica a: Windows Azure Pack
Aprovisiona una nueva suscripción con la información especificada.
Solicitud
Reemplace <ServiceMgmt> por la dirección del punto de conexión de la API de Service Management.
Método |
URI de solicitud |
Versión de HTTP |
|---|---|---|
POST |
<https:// ServiceMgmt>:30005/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 |
|---|---|
x-ms-principal-id: |
Obligatorio. El identificador de la entidad de seguridad. |
Autorización: Portador |
Obligatorio. Token de portador de autorización. |
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 |
|---|---|
AccountAdminLiveEmailId |
Identificador de la cuenta Microsoft del administrador de la cuenta. No es necesario para el aprovisionamiento de suscripciones. Use null. |
AccountAdminLivePuid |
Identificador de cuenta de Passport del administrador de la cuenta. Debe ser una cuenta de usuario existente. Puede usar Recuperar un usuario para determinar si la cuenta existe. |
AccountId |
Identificador de cuenta. Use Guid.Empty. |
FriendlyName |
Nombre descriptivo de la suscripción. |
OfferCategory |
Categoría de la oferta. Use null. |
OfferInfo |
La información de la oferta. Use null. |
OfferType |
Tipo de oferta. Use 0. |
ReasonCode |
Código de motivo. Use null. |
ServiceAdminLiveEmailId |
Identificador de la cuenta Microsoft del administrador del servicio. Este valor no lo usa Windows Azure Pack y solo se requiere con fines de coherencia. Use null. |
ServiceAdminLivePuid |
Identificador de cuenta de Passport del administrador del servicio. No es necesario para el aprovisionamiento de suscripciones. Use null. |
SubscriptionId |
Identificador de suscripción. Use Guid.NewGuid(). ToString() para crear un GUID. |
Status |
Estado de la suscripción. Use null. |
PlanId |
Identificador del plan al que se va a suscribir. |
CoAdminNames |
Lista de coadministradores. Use null si no existen coadministradores. Los coadministradores no necesitan conocerse en el sistema. Cuando se crea posteriormente la cuenta de coadministrador, la suscripción se aplica automáticamente al coadministrador. |
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. Se devuelve MaxSubscriptionsPerPlanReached si se alcanza el número máximo de suscripciones permitidas para el plan.
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 |
Suscripciones aprovisionadas. Para obtener más información, vea Suscripción (objeto común). |
Ejemplo
En el ejemplo de código siguiente se muestra una solicitud de suscripción de aprovisionamiento .
POST https://<Computer>:30005/subscriptions HTTP/1.1
Authorization: Bearer <Token>
x-ms-client-request-id: 02130fee-13b7-4b93-b618-3a8830dbe611-2014-04-15 20:00:55Z
x-ms-client-session-id: eec98428-7dd5-4033-8a2c-77946f61a2f6
x-ms-principal-id: NewUser%40contoso.com
Accept-Language: en-US
Content-Type: application/json; charset=utf-8
Host: <computer>:30005
Content-Length: 458
Expect: 100-continue
{
"AccountAdminLiveEmailId": null,
"AccountAdminLivePuid": "newuser@contoso.com",
"AccountId": "00000000-0000-0000-0000-000000000000",
"FriendlyName": "MyServicePlanX",
"OfferCategory": null,
"OfferInfo": null,
"OfferType": 0,
"ReasonCode": null,
"ServiceAdminLiveEmailId": null,
"ServiceAdminLivePuid": "newuser@contoso.com",
"SubscriptionId": "da506abb-1658-4abf-971c-e0e5a9c47b83",
"Status": null,
"PlanId": "MyServicePlanX18aa6bac",
"CoAdminNames": null
}
En el ejemplo de código siguiente se muestra un cuerpo de respuesta Aprovisionar suscripción .
{
"SubscriptionID": "da506abb-1658-4abf-971c-e0e5a9c47b83",
"SubscriptionName": "MyServicePlanX",
"AccountAdminLiveEmailId": "newuser@contoso.com",
"ServiceAdminLiveEmailId": null,
"CoAdminNames": [
],
"AddOnReferences": [
],
"AddOns": [
],
"State": 1,
"QuotaSyncState": 0,
"ActivationSyncState": 1,
"PlanId": "MyServicePlanX18aa6bac",
"Services": [
{
"Type": "mysqlservers",
"State": "registered",
"QuotaSyncState": 0,
"ActivationSyncState": 1,
"BaseQuotaSettings": [
{
"Key": "Editions",
"Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"offerEditionId\":\"040814101717\",\"groupType\":null}]"
}
]
}
],
"LastErrorMessage": null,
"Features": null,
"OfferFriendlyName": "MyServicePlanX",
"OfferCategory": null,
"Created": "2014-04-15T20:00:59.187"
}
Comentarios
El portal de administración de inquilinos realiza las siguientes llamadas REST al aprovisionar una suscripción.
Recupere los planes disponibles. Se usa para mostrar los planes a los que un usuario puede suscribirse. Los objetos Plan (objeto Administrator) devueltos tienen una propiedad Id . Una vez elegido un plan, el valor id se usa para identificar el plan elegido en la llamada a Aprovisionar una nueva suscripción.
Recuperar un usuario. Puesto que no se puede crear una suscripción para un usuario que no existe, esta llamada confirma que realmente existe un usuario.
Aprovisione una nueva suscripción. Aprovisiona la suscripción con la información proporcionada.