Provisão de uma Nova Assinatura (Assinatura de Inquilino)

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

Prevê uma nova subscrição com as informações especificadas.

Pedir

Substitua <o ServiceMgmt> pelo seu endereço de ponto final API de Gestão de Serviços.

Método	URI do pedido	Versão HTTP
POST	<https:// ServiceMgmt>:30005/subscrições	HTTP/1.1

Parâmetros do URI

Nenhum.

Pedido cabeçalhos

A tabela seguinte descreve os cabeçalhos de pedido necessários e opcionais.

Cabeçalho do pedido	Description
x-ms-principal-id:	Obrigatório. O identificador principal.
Autorização: Portador	Obrigatório. Ficha do portador da autorização.
x-ms-cliente-pedido-id:	Opcional. O identificador de pedido do cliente.
x-ms-cliente-sessão-id:	Opcional. O identificador da sessão do cliente.
x-ms-principal-liveid:	Opcional. O principal identificador ao vivo.

Corpo do Pedido

A tabela seguinte descreve os elementos do corpo de pedido.

Nome do Elemento	Description
AccountAdminLiveEmailId	O identificador de conta microsoft do administrador de conta. Não é necessário para o provisionamento por subscrição. Use nulo.
ContaAdminLivePuid	O identificador da conta Passport do administrador da conta. Esta deve ser uma conta de utilizador existente. Pode utilizar Recuperar um Utilizador para determinar se a conta existe.
AccountId	O identificador de contas. Use Guid.Empty.
FriendlyName	O nome amigável para a assinatura.
OfertaCategoria	A categoria de oferta. Use nulo.
OfertaInfo	A informação da oferta. Use nulo.
OfferType	O tipo de oferta. Use 0.
ReasonCode	O código da razão. Use nulo.
ServiçoAdminLiveEmailId	O identificador de conta microsoft do administrador de serviço. Este valor não é utilizado pelo Windows Azure Pack e é exigido apenas para fins de consistência. Use nulo.
ServiçoAdminLivePuid	O identificador da conta Passport do administrador de serviço. Não é necessário para o provisionamento por subscrição. Use nulo.
SubscriptionId	O identificador de assinatura. Use Guid.NewGuid(). ToString() para criar um GUID.
Estado	O estado da subscrição. Use nulo.
PlanId	O identificador do plano que está a ser subscrito.
CoAdminNames	Uma lista de coadministradores. Use nulo se não existirem coadministradores. Os coadministradores não precisam de ser conhecidos do sistema. Quando a conta coadministradora é criada posteriormente, a subscrição é automaticamente aplicada ao coadministrador.

Resposta

A resposta inclui um código de estado HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Código de Estado

Uma operação bem sucedida devolve o código de estado 200 (OK). MaxSubscriptionsPerPlanReached é devolvido se o número máximo de subscrições admissíveis para o plano for atingido.

Para obter informações sobre códigos de estado, consulte Códigos de Estado e de Erro (Windows Gestão de Serviços de Pacote Azure).

Cabeçalhos de Resposta

A resposta para esta operação inclui cabeçalhos HTTP padrão. Todos os cabeçalhos standard estão de acordo com a especificação do protocolo HTTP/1.1.

Corpo de Resposta

A tabela a seguir descreve os elementos-chave do organismo de resposta:

Nome do elemento	Descrição
Subscrição	As assinaturas a provisionadas. Para mais informações, consulte Subscrição (objeto comum).

Exemplo

O seguinte exemplo de código mostra um pedido de subscrição de provisão .

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
}

O seguinte exemplo de código mostra um organismo de resposta à subscrição de provisão .

{
  "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"
}

Observações

O portal de gestão para inquilinos faz as seguintes chamadas REST ao providenciar uma subscrição.

Recupere os Planos Disponíveis. Isto é usado para exibir os planos que um utilizador pode subscrever. Os objetos do Plano (objeto administrador) devolvidos cada um têm uma propriedade de identificação . Uma vez escolhido um plano, o valor de id é usado para identificar o plano escolhido na chamada de Provision a New Subscription.
Recuperar um Utilizador. Uma vez que não pode ser criada uma subscrição para um utilizador que não existe, esta chamada confirma que um utilizador existe de facto.
Provisão de uma nova subscrição. Disposi a subscrição utilizando as informações fornecidas.

Consulte também

Interfaces de subscrição de inquilinos

Partilhar via