Compartilhar via

Criar assinaturas do Azure de maneira programática com APIs legadas

  • Artigo

Este artigo ajuda você a criar assinaturas do Azure de maneira programática usando nossa API da versão prévia legada. Neste artigo, você aprenderá a criar assinaturas programaticamente usando o Azure Resource Manager.

Temos novos artigos para a versão mais recente da API para uso com diferentes tipos de assinatura do contrato do Azure:

No entanto, você ainda pode usar as informações deste artigo se não quiser usar a versão mais recente da API.

Os clientes do Azure com uma conta de cobrança dos seguintes tipos de contrato poderão criar assinaturas de modo programático:

  • Contrato Enterprise
  • MCA (Contrato de Cliente da Microsoft)
  • MPA (Contrato de Parceiro da Microsoft)

Quando você cria uma assinatura do Azure de maneira programática, essa assinatura é regida pelo contrato sob o qual você obteve os serviços Azure da Microsoft ou de um revendedor autorizado. Para obter mais informações, confira Informações Legais do Microsoft Azure.

Observação

Recomendamos que você use o módulo Az PowerShell do Azure para interagir com o Azure. Para começar, consulte Instalar o Azure PowerShell. Para saber como migrar para o módulo Az PowerShell, confira Migrar o Azure PowerShell do AzureRM para o Az.

Você não pode criar planos de suporte programaticamente. Você pode comprar um novo ou atualizar um plano de suporte no portal do Azure. Navegue até Ajuda + suporte e, na parte superior da página, selecione Escolher o plano de suporte correto.

Criar assinaturas para uma conta de cobrança do EA

Use as informações nas seções a seguir para criar assinaturas de EA.

Pré-requisitos

Você deve ter uma função de Proprietário em uma Conta de Registro ou ser um Administrador Corporativo para criar uma assinatura. Há duas maneiras de obter a função:

Localize as contas às quais você tem acesso

Depois que você for adicionado a uma Conta de Registro associada a um Proprietário da Conta, o Azure usa a relação de conta para registro para determinar quando cobrar os encargos de assinatura. Todas as assinaturas criadas na conta serão cobradas no registro de EA do qual a conta faz parte. Para criar assinaturas, você deve passar valores sobre a conta de registro e as entidades de usuário a fim de ser dono da assinatura.

Para executar os comandos a seguir, você precisa estar conectado ao diretório base do Proprietário da Conta, que é o diretório em que as assinaturas são criadas por padrão.

Solicitação para listar todas as contas de registro às quais você tem acesso:

GET https://management.azure.com/providers/Microsoft.Billing/enrollmentAccounts?api-version=2018-03-01-preview

A resposta da API lista todas as contas de registro às quais você tem acesso:

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/enrollmentAccounts/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "name": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "type": "Microsoft.Billing/enrollmentAccounts",
      "properties": {
        "principalName": "SignUpEngineering@contoso.com"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/enrollmentAccounts/4cd2fcf6-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "name": "4cd2fcf6-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "type": "Microsoft.Billing/enrollmentAccounts",
      "properties": {
        "principalName": "BillingPlatformTeam@contoso.com"
      }
    }
  ]
}

Use a principalName propriedade para identificar a conta na qual você deseja que as assinaturas sejam cobradas. Copie o name dessa conta. Por exemplo, para criar assinaturas na conta de registro SignUpEngineering@contoso.com, copie aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e. O identificador é a ID de objeto da conta de registro. Cole esse valor em algum lugar para usá-lo na próxima etapa como enrollmentAccountObjectId.

Crie assinaturas em uma conta de registro específico

O exemplo a seguir cria uma assinatura denominada Assinatura da Equipe de Desenvolvimento na conta de registro selecionada na etapa anterior. A oferta de assinatura é MS-AZR-0017P (Contrato Enterprise da Microsoft regular). Ela também adiciona dois usuários como Proprietários do Azure RBAC à assinatura.

Faça a solicitação a seguir, substituindo <enrollmentAccountObjectId> pela name copiada na primeira etapa (aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb). Para especificar os proprietários, veja como obter as IDs de objeto do usuário.

POST https://management.azure.com/providers/Microsoft.Billing/enrollmentAccounts/<enrollmentAccountObjectId>/providers/Microsoft.Subscription/createSubscription?api-version=2018-03-01-preview

{
  "displayName": "Dev Team Subscription",
  "offerType": "MS-AZR-0017P",
  "owners": [
    {
      "objectId": "<userObjectId>"
    },
    {
      "objectId": "<servicePrincipalObjectId>"
    }
  ]
}
Nome do elemento Obrigatório Type Descrição
displayName Não String O nome de exibição da assinatura. Se não for especificado, será definido como o nome da oferta, como "Microsoft Azure Enterprise".
offerType Sim String A oferta da assinatura. As duas opções para EA são MS-AZR-0017P (uso de produção) e MS-AZR-0148P (desenvolvimento/teste, precisa ser ativado no portal do Azure).
owners Não String A ID do Objeto de qualquer usuário a ser adicionado como Proprietário do Azure RBAC na assinatura quando ela é criada.

Na resposta, como parte do cabeçalho Location, você recebe uma URL que pode consultar para obter o status na operação de criação da assinatura. Quando terminar a criação de assinatura, um GET na URL de Location retornará um objeto subscriptionLink, que tem a ID da assinatura. Para obter mais detalhes, veja a Documentação da API de assinatura

Limitações da API de criação de assinatura do Azure Enterprise

  • Somente assinaturas do Azure Enterprise podem ser criadas usando a API.
  • Há um limite de 5000 assinaturas por conta de registro. Depois disso, mais assinaturas da conta podem ser criadas apenas no portal do Azure. Se você quiser criar mais assinaturas por meio da API, crie outra conta de registro. Assinaturas canceladas, excluídas e transferidas são consideradas para o limite de 5000.
  • Os usuários que não são Proprietários da Conta, mas foram adicionados a uma conta de registro com o Azure RBAC, não podem criar assinaturas no portal do Azure.
  • Você não pode selecionar o locatário para a assinatura a ser criada. A assinatura é sempre criada no locatário inicial do Proprietário da Conta. Para mover a assinatura para um locatário diferente, consulte alterar o locatário da assinatura.

Criar assinaturas para uma conta do MCA

Use as informações nas seções a seguir para criar assinaturas para uma conta do MCA.

Pré-requisitos

Para criar assinaturas, você precisa ter uma função de proprietário, de colaborador ou de criador de assinatura do Azure em uma seção de fatura; ou uma função de proprietário ou de colaborador em um perfil de cobrança ou uma conta de cobrança. Para obter mais informações, confira Funções e tarefas da cobrança de assinatura.

Os exemplos a seguir usam APIs REST. Atualmente, não há suporte para o PowerShell nem para a CLI do Azure.

Localizar as contas de cobrança às quais você tem acesso

Faça a solicitação a seguir para listar todas as contas de cobrança.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview

A resposta da API lista as contas de cobrança às quais você tem acesso.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "accountStatus": "Active",
        "accountType": "Enterprise",
        "agreementType": "MicrosoftCustomerAgreement",
        "displayName": "Contoso",
        "hasReadAccess": true,
        "organizationId": "41b29574-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
      },
      "type": "Microsoft.Billing/billingAccounts"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "accountStatus": "Active",
        "accountType": "Enterprise",
        "agreementType": "MicrosoftCustomerAgreement",
        "displayName": "Fabrikam",
        "hasReadAccess": true,
        "organizationId": "41b29574-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
      },
      "type": "Microsoft.Billing/billingAccounts"
    }
  ]
}

Use a propriedade displayName para identificar a conta de cobrança para a qual você deseja criar assinaturas. Verifique se o agreementType da conta é MicrosoftCustomerAgreement. Copie o name da conta. Por exemplo, para criar uma assinatura para a conta de cobrança Contoso, copie bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. Cole esse valor em algum lugar para usá-lo na próxima etapa.

Localizar as seções da fatura para criar assinaturas

Os preços da sua assinatura serão exibidos em uma seção da fatura do perfil de cobrança. Use a API a seguir para obter a lista de seções da fatura e perfis de cobrança nos quais você tem permissão para criar assinaturas do Azure.

Faça a solicitação a seguir, substituindo <billingAccountName> pela name copiada na primeira etapa (bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx).

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<billingAccountName>/listInvoiceSectionsWithCreateSubscriptionPermission?api-version=2019-10-01-preview

A resposta da API lista todas as seções de fatura e os respectivos perfis de cobrança aos quais você tem acesso para criar assinaturas:

{
    "value": [{
        "billingProfileDisplayName": "Contoso finance",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx",
        "enabledAzurePlans": [{
            "productId": "DZH318Z0BPS6",
            "skuId": "0001",
            "skuDescription": "Microsoft Azure Plan"
        }, {
            "productId": "DZH318Z0BPS6",
            "skuId": "0002",
            "skuDescription": "Microsoft Azure Plan for DevTest"
        }],
        "invoiceSectionDisplayName": "Development",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx/invoiceSections/GJ77-xxxx-xxx-xxx"
    }, {
        "billingProfileDisplayName": "Contoso finance",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx",
        "enabledAzurePlans": [{
            "productId": "DZH318Z0BPS6",
            "skuId": "0001",
            "skuDescription": "Microsoft Azure Plan"
        }, {
            "productId": "DZH318Z0BPS6",
            "skuId": "0002",
            "skuDescription": "Microsoft Azure Plan for DevTest"
        }],
        "invoiceSectionDisplayName": "Testing",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX"
  }]
}

Use a propriedade invoiceSectionDisplayName para identificar a seção da fatura para a qual você deseja criar assinaturas. Copie invoiceSectionId, billingProfileId e um dos skuId da seção da fatura. Por exemplo, para criar uma assinatura do tipo Microsoft Azure plan para a seção da fatura Development, copie /providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX, /providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-xxxx-xxx-xxx e 0001. Cole os valorem em algum lugar para usá-los na próxima etapa.

Criar uma assinatura de uma seção da fatura

O exemplo a seguir cria uma assinatura denominada assinatura da Equipe de Desenvolvimento do tipo Plano do Microsoft Azure para a seção da fatura Desenvolvimento. A assinatura é cobrada no perfil de cobrança Finanças da Contoso e aparece na seção Desenvolvimento da fatura.

Faça a solicitação a seguir, substituindo <invoiceSectionId> pela invoiceSectionId copiada na segunda etapa (/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX). Passe o billingProfileId e o skuId copiados da segunda etapa nos parâmetros de solicitação da API. Para especificar os proprietários, veja como obter as IDs de objeto do usuário.

POST https://management.azure.com<invoiceSectionId>/providers/Microsoft.Subscription/createSubscription?api-version=2018-11-01-preview

'{"displayName": "Dev Team subscription",
  "billingProfileId": "<billingProfileId>",
  "skuId": "<skuId>",
  "owners": [
      {
        "objectId": "<userObjectId>"
      },
      {
        "objectId": "<servicePrincipalObjectId>"
      }
    ],
  "costCenter": "35683",
  "managementGroupId": "/providers/Microsoft.Management/managementGroups/xxxxxxx",",
}'
Nome do elemento Obrigatório Type Descrição
displayName Sim String O nome de exibição da assinatura.
billingProfileId Sim String A ID do perfil de cobrança que é cobrado pelos preços da assinatura.
skuId Sim String A ID do SKU que determina o tipo de plano do Azure.
owners Não String A ID de Objeto de qualquer entidade de serviço ou usuário a ser adicionado como um Proprietário do Azure RBAC na assinatura quando ela é criada.
costCenter Não String O centro de custo associado à assinatura. Ele aparece no arquivo CSV de uso.
managementGroupId Não String A ID do grupo de gerenciamento ao qual a assinatura será adicionada. Para obter a lista de grupos de gerenciamento, confira Grupos de Gerenciamento – Listar API. Use a ID de um grupo de gerenciamento da API.

Em resposta, você obtém um objeto subscriptionCreationResult para monitoramento. Quando a criação da assinatura é concluída, o objeto subscriptionCreationResult retorna um objeto subscriptionLink, que tem a ID da assinatura.

Criar assinaturas para uma conta de cobrança do MPA

Use as informações nas seções a seguir para criar assinaturas para uma conta de cobrança do MPA.

Pré-requisitos

É necessário ter uma função de Agente Administrador na conta do provedor de soluções de nuvem de sua organização para criar uma assinatura para sua conta de cobrança. Para obter mais informações, confira Partner Center – Atribuir funções e permissões de usuários.

Os exemplos a seguir usam APIs REST. Atualmente, não há suporte para o PowerShell nem para a CLI do Azure.

Localizar as contas de cobrança às quais você tem acesso

Faça a solicitação abaixo para listar todas as contas de cobrança às quais você tem acesso.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview

A resposta da API lista as contas de cobrança.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "accountStatus": "Active",
        "accountType": "Enterprise",
        "agreementType": "MicrosoftPartnerAgreement",
        "displayName": "Contoso",
        "hasReadAccess": true,
        "organizationId": "1d100e69-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
      },
      "type": "Microsoft.Billing/billingAccounts"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "accountStatus": "Active",
        "accountType": "Enterprise",
        "agreementType": "MicrosoftCustomerAgreement",
        "displayName": "Fabrikam",
        "hasReadAccess": true,
        "organizationId": "1d100e69-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
      },
      "type": "Microsoft.Billing/billingAccounts"
    }
  ]
}

Use a propriedade displayName para identificar a conta de cobrança para a qual você deseja criar assinaturas. Verifique se o agreementType da conta é o MicrosoftPartnerAgreement. Copie o name para a conta. Por exemplo, para criar uma assinatura para a conta de cobrança Contoso, copie cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. Cole esse valor em algum lugar para usá-lo na próxima etapa.

Localizar clientes que têm planos do Azure

Faça a solicitação a seguir, substituindo <billingAccountName> pelo name copiado na primeira etapa (bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx) para listar todos os clientes na conta de cobrança para os quais você pode criar assinaturas do Azure.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<billingAccountName>/customers?api-version=2019-10-01-preview

A resposta da API lista os clientes na conta de cobrança com os planos do Azure. Você pode criar assinaturas para os clientes.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b",
      "name": "dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b",
      "properties": {
        "billingProfileDisplayName": "Contoso USD",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/JUT6-xxxx-xxxx-xxxx",
        "displayName": "Fabrikam toys"
      },
      "type": "Microsoft.Billing/billingAccounts/customers"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/97c3fac4-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "name": "97c3fac4-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "properties": {
        "billingProfileDisplayName": "Fabrikam sports",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/JUT6-xxxx-xxxx-xxxx",
        "displayName": "Fabrikam bakery"
      },
      "type": "Microsoft.Billing/billingAccounts/customers"
    }]
}

Use a propriedade displayName para identificar o cliente para o qual você deseja criar assinaturas. Copie o id do cliente. Por exemplo, para criar uma assinatura para Fabrikam toys, copie /providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b. Cole esse valor em algum lugar para usá-lo em etapas posteriores.

Opcional para Provedores indiretos: Obter os revendedores de um cliente

Se você for um Provedor indireto no modelo de dois níveis do CSP, poderá especificar um revendedor ao criar assinaturas para clientes.

Faça a solicitação a seguir, substituindo <customerId> pelo id copiado da segunda etapa (/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b) para listar todos os revendedores disponíveis para um cliente.

GET https://management.azure.com<customerId>?$expand=resellers&api-version=2019-10-01-preview

A resposta da API lista os revendedores do cliente:

{
  "value": [{
  "id": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2ed2c490-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "name": "2ed2c490-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "type": "Microsoft.Billing/billingAccounts/customers",
  "properties": {
    "displayName": "Fabrikam toys",
    "resellers": [
      {
        "resellerId": "3xxxxx",
        "description": "Wingtip"
      }
    ]
  }
},
{
  "id": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/4ed2c793-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "name": "4ed2c793-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "type": "Microsoft.Billing/billingAccounts/customers",
  "properties": {
    "displayName": "Fabrikam toys",
    "resellers": [
      {
        "resellerId": "5xxxxx",
        "description": "Tailspin"
      }
    ]
  }
}]
}

Use a propriedade description para identificar o revendedor associado à assinatura. Copie o resellerId do revendedor. Por exemplo, para associar Wingtip, copie 3xxxxx. Cole esse valor em algum lugar para usá-lo na próxima etapa.

Criar uma assinatura para um cliente

O exemplo a seguir cria uma assinatura denominada assinatura da Equipe de Desenvolvimento para Fabrikam Toys e associa o revendedor Wingtip à assinatura.

Faça a solicitação a seguir, substituindo <customerId> pela id copiada na segunda etapa (/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b). Passe o resellerId opcional copiado da segunda etapa nos parâmetros de solicitação da API.

POST https://management.azure.com<customerId>/providers/Microsoft.Subscription/createSubscription?api-version=2018-11-01-preview

'{"displayName": "Dev Team subscription",
  "skuId": "0001",
  "resellerId": "<resellerId>",
}'
Nome do elemento Obrigatório Type Descrição
displayName Sim String O nome de exibição da assinatura.
skuId Sim String A ID de SKU do plano do Azure. Usar 0001 para assinaturas do tipo Plano do Microsoft Azure
resellerId Não String A ID do revendedor que será associada à assinatura.

Em resposta, você obtém um objeto subscriptionCreationResult para monitoramento. Quando a criação da assinatura é concluída, o objeto subscriptionCreationResult retorna um objeto subscriptionLink. Ele tem a ID da assinatura.

Próximas etapas