Provisionar uma nova assinatura

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

Provisiona uma nova assinatura.

Solicitação

Substitua <ServiceMgmt> pelo endereço do ponto de extremidade da API de Gerenciamento de Serviços.

Método	URI da solicitação	Versão HTTP
POST	<https:// ServiceMgmt>:30004/subscriptions	HTTP/1.1

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho da solicitação	Descrição
Autorização: Portador	Obrigatórios. O token de portador de autorização.
x-ms-principal-id	Obrigatórios. O identificador principal.
x-ms-client-request-id	Opcional. O identificador de solicitação do cliente.
x-ms-client-session-id	Opcional. O identificador de sessão do cliente.
x-ms-principal-liveid	Opcional. O principal identificador ao vivo.

Corpo da solicitação

A tabela a seguir descreve os elementos do corpo da solicitação.

Nome do elemento	Descrição
AccountAdminLiveId	O identificador de conta da Microsoft do administrador da conta. Não é necessário para provisionamento de assinatura. Use nulo.
AccountAdminLivePuid	O identificador de conta do Passport do administrador da conta. Essa deve ser uma conta de usuário existente. Você pode usar Recuperar um Usuário para determinar se a conta existe.
AccountId	O identificador da conta. Use Guid.Empty.
FriendlyName	O nome amigável da assinatura.
OfferCategory	A categoria de oferta. Use nulo.
OfferInfo	As informações da oferta. Use nulo.
OfferType	O tipo de oferta. Use 0.
ReasonCode	O código do motivo. Use nulo.
ServiceAdminLiveEmailId	O identificador de conta da Microsoft do administrador do serviço. Esse valor não é usado por Windows Azure Pack e é necessário apenas para fins de consistência. Use nulo.
ServiceAdminLivePuid	O identificador de conta do Passport do administrador do serviço. Não é necessário para provisionamento de assinatura. Use nulo.
SubscriptionId	O Identificador de assinatura. Ele é expresso como uma cadeia de caracteres GUID. Use Guid.NewGuid(). ToString() para criar um valor de cadeia de caracteres GUID adequado.
Status	O status da assinatura. Use nulo.
PlanId	O identificador de plano ao qual o plano está sendo assinado. Essa é a propriedade de IDPlan (objeto Administrator).
CoAdminNames	Uma lista de coadministradores. Use nulo se não houver coadministradores. Os coadministradores não precisam ser conhecidos pelo sistema. Quando a conta de coadministrador for criada posteriormente, a assinatura será aplicada automaticamente ao coadministrador.

Resposta

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

Código de status

Uma operação bem-sucedida retorna o código de status 200 (OK).

Para obter informações sobre códigos de status, consulte Status e Códigos de Erro (Windows Gerenciamento de Serviços do Azure Pack).

Cabeçalhos de resposta

A resposta para essa operação inclui cabeçalhos HTTP padrão. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.

Corpo da resposta

A tabela a seguir descreve os principais elementos do corpo da resposta.

Nome do elemento	Descrição
AdminSubscription	A assinatura provisionada. Para obter mais informações, consulte AdminSubscription (objeto Administrator).

Exemplo

O exemplo de código a seguir mostra uma solicitação de Assinatura de Provisionamento .

POST https://<Computer>:30004/subscriptions HTTP/1.1
Authorization: Bearer 
x-ms-client-request-id: cf5bca16-e945-42ab-a934-af462fd70aca-2014-04-15 20:37:33Z
x-ms-client-session-id: b5488aa5-137e-443e-be88-407ab0db068d
x-ms-principal-id: <COMPUTER>Administrator
Accept-Language: en-US
Content-Type: application/json; charset=utf-8
Host: <COMPUTER>:30004
Content-Length: 428
Expect: 100-continue
{
  "AccountAdminLiveEmailId": "User@Contoso.com",
  "AccountAdminLivePuid": "user@contoso.com",
  "AccountId": "00000000-0000-0000-0000-000000000000",
  "FriendlyName": "c23",
  "OfferCategory": null,
  "OfferInfo": null,
  "OfferType": 0,
  "ReasonCode": null,
  "ServiceAdminLiveEmailId": "User@Contoso.com",
  "ServiceAdminLivePuid": "user@contoso.com",
  "SubscriptionId": "2ad337ed-c99f-40d1-9645-670b4bdb5016",
  "Status": null,
  "PlanId": "chtm4uwen",
  "CoAdminNames": null
}

O exemplo a seguir mostra um corpo de resposta da Assinatura de Provisionamento.

{
  "SubscriptionID": "2ad337ed-c99f-40d1-9645-670b4bdb5016",
  "SubscriptionName": "c23",
  "AccountAdminLiveEmailId": "user@contoso.com",
  "ServiceAdminLiveEmailId": null,
  "CoAdminNames": [

  ],
  "AddOnReferences": [

  ],
  "AddOns": [

  ],
  "State": 1,
  "QuotaSyncState": 0,
  "ActivationSyncState": 1,
  "PlanId": "chtm4uwen",
  "Services": [
    {
      "Type": "sqlservers",
      "State": "registered",
      "QuotaSyncState": 0,
      "ActivationSyncState": 1,
      "BaseQuotaSettings": [
        {
          "Key": "Editions",
          "Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"1024\",\"offerEditionId\":\"032814080310\",\"groupType\":null}]"
        }
      ]
    }
  ],
  "LastErrorMessage": null,
  "Features": null,
  "OfferFriendlyName": "c23",
  "OfferCategory": null,
  "Created": "2014-04-15T20:37:39.223"
}

Comentários

Quando um usuário é criado no Windows portal de gerenciamento de administrador do Azure Pack for Windows Server, uma assinatura de um plano é provisionada. O procedimento é o seguinte.

Colete as informações do usuário e o plano desejado. Para o usuário, será necessário um endereço de email e uma senha. Inicialmente, o usuário está inscrito em um plano. Uma lista de planos disponíveis é obtida chamando Recuperar os Planos Disponíveis. A propriedade ID do Plano desejado (objeto Administrador) será necessária para chamar Provisionar uma Nova Assinatura.
Chame Recuperar um Usuário para determinar se o usuário solicitado já existe.
Provisione a assinatura usando Provisionar uma Nova Assinatura.

Consulte Também

Interfaces de assinatura do administrador

Compartilhar via