Criar assinaturas do Azure de maneira programática com APIs legadas
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:
- Criar assinaturas do EA de modo programático com a API mais recente
- Criar assinaturas do MCA de modo programático com a API mais recente
- Criar assinaturas do MPA de modo programático com a API mais recente
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. Confira Instalar o Azure PowerShell para começar. 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:
- O Administrador Corporativo do seu registro pode fazer de você um Proprietário da Conta (é necessário entrar), o que faz de você um Proprietário da Conta de Registro.
- Um proprietário existente da conta de inscrição pode conceder acesso a você. Do mesmo modo, para usar uma entidade de serviço com o objetivo de criar uma assinatura de EA, você deverá conceder a essa entidade de serviço a capacidade de criar assinaturas.
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/747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"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 747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx. 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 (747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx). 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/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"name": "5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"properties": {
"accountId": "5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"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 5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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 (5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX, /providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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
Você precisa ter uma função de Administrador Global ou 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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"name": "99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"properties": {
"accountId": "5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"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 99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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 (5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"properties": {
"billingProfileDisplayName": "Contoso USD",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx. 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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx) 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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx). 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
- Para ver um exemplo de como criar uma assinatura do EA (Contrato Enterprise) usando .NET, confira código de exemplo no GitHub.
- Agora que você criou uma assinatura, conceda essa capacidade a outros usuários e entidades de serviço. Para saber mais, veja Conceder acesso para criar assinaturas do Azure Enterprise (versão prévia).
- Para obter mais informações sobre como gerenciar um grande número de assinaturas usando grupos de gerenciamento, confira como Organizar seus recursos com os grupos de gerenciamento do Azure.
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de