Criar subscrições do Azure através de programação com APIs legadas
Este artigo ajuda você a criar programaticamente assinaturas do Azure usando nossa API de visualização herdada. Neste artigo, aprenderá a criar subscrições através de programação com o Azure Resource Manager.
Temos artigos novos para a última versão da API para utilização com diferentes tipos de subscrições de contrato do Azure:
- Criar subscrições do EA através de programação com a API mais recente
- Criar subscrições do MCA através de programação com a API mais recente
- Criar subscrições do MPA através de programação com a API mais recente
Contudo, caso não queira utilizar a versão mais recente, pode continuar a utilizar as informações neste artigo.
Os clientes do Azure com uma conta de faturação para os seguintes tipos de contrato podem criar subscrições através de programação:
- Contrato Enterprise
- Contrato de Cliente da Microsoft (MCA)
- Contrato de Parceiro da Microsoft (MPA)
Quando cria uma subscrição do Azure através de programação, a subscrição rege-se pelo contrato ao abrigo do qual adquiriu serviços do Azure junto da Microsoft ou de um revendedor autorizado. Para obter mais informações, veja Informações Legais do Microsoft Azure.
Nota
Recomendamos que utilize o módulo do Azure Az PowerShell para interagir com o Azure. Veja Instalar o Azure PowerShell para começar. Para saber como migrar para o módulo do Az PowerShell, veja Migrar o Azure PowerShell do AzureRM para o Az.
Não é possível criar planos de suporte programaticamente. Você pode comprar um novo plano de suporte ou atualizar um no portal do Azure. Navegue até Ajuda + suporte e, na parte superior da página, selecione Escolher o plano de suporte correto.
Criar subscrições para uma conta de faturação de EA
Use as informações nas secções seguintes para criar subscrições de EA.
Pré-requisitos
Você deve ter uma função de Proprietário em uma Conta de Inscrição ou ser um Administrador Corporativo para criar uma assinatura. Existem duas formas de obter a função:
- O Administrador Enterprise da sua inscrição pode torná-lo um Proprietário de Conta (início de sessão obrigatório), o que o torna um Proprietário da Conta de Inscrição.
- Um Proprietário existente da Conta de Inscrição pode conceder-lhe acesso. Da mesma forma, para utilizar um principal de serviço para criar uma subscrição de EA, tem de conceder a esse principal de serviço a capacidade de criar subscrições.
Localizar contas às quais tem acesso
Depois de ser adicionado a uma Conta de Inscrição associada a um Proprietário de Conta, o Azure usa a relação de conta para inscrição para determinar onde faturar os custos da subscrição. Todas as subscrições criadas no âmbito da conta são faturadas na inscrição de EA em que a conta está. Para criar subscrições, deve transmitir valores sobre a conta de inscrição e as entidades principais de utilizador para ser proprietário da subscrição.
Para executar os comandos seguintes, tem de ter sessão iniciada no diretório raiz do Proprietário da Conta, que é o diretório no qual as subscrições são criadas por predefinição.
Pedido para listar todas as contas de inscrição às quais 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 inscrição às quais 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 propriedade principalName para identificar a conta na qual pretende que as subscrições sejam faturadas. Copie o name dessa conta. Por exemplo, para criar subscrições na SignUpEngineering@contoso.com conta de inscrição, copie 747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx. O identificador é o ID de objeto da conta de inscrição. Cole o valor algures para que possa utilizá-lo no passo seguinte como enrollmentAccountObjectId.
Criar subscrições numa conta de registo específica
O exemplo a seguir cria uma subscrição denominada Subscrição da Equipa de Desenvolvimento na conta de inscrição selecionada no passo anterior. A oferta da subscrição é MS-AZR-0017P (Microsoft Enterprise Agreement regular). Também adiciona, opcionalmente, dois utilizadores como Proprietários RBAC do Azure à subscrição.
Faça o pedido a seguir ao substituir <enrollmentAccountObjectId> por name, copiado do primeiro passo (747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx). Para especificar proprietários, veja como obter IDs de objeto de utilizador.
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 | Necessário | Type | Description |
|---|---|---|---|
displayName |
Não | String | O nome a apresentar da subscrição. Se não for especificado, será definido como o nome da oferta, como “Microsoft Azure Enterprise”. |
offerType |
Sim | String | A oferta da subscrição. As duas opções para EA são MS-AZR-0017P (uso de produção) e MS-AZR-0148P (desenvolvimento/teste, precisa ser habilitado no portal do Azure). |
owners |
Não | String | A ID do Objeto de qualquer usuário a ser adicionado como Proprietário do RBAC do Azure na assinatura quando ela for criada. |
Na resposta, como parte da Location do cabeçalho, obtém um url que pode consultar para saber o estado na operação de criação da subscrição. Quando a criação da subscrição estiver concluída, um GET no url Location devolverá um objeto subscriptionLink, que tem o ID da subscrição. Para obter mais detalhes, veja a Documentação da API da subscrição
Limitações da API de criação de subscrições do Azure Enterprise
- Apenas as subscrições do Azure Enterprise podem ser criadas com esta API.
- Há um limite de 5000 assinaturas por conta de inscrição. Depois disso, só podem ser criadas mais subscrições para a conta no portal do Azure. Se quiser criar mais subscrições através da API, crie outra conta de inscrição. As subscrições canceladas, eliminadas e transferidas contam para o limite de 5000.
- Os utilizadores que não sejam Proprietários de Conta, mas que tenham sido adicionados a uma conta de inscrição com o RBAC do Azure, não podem criar subscrições no portal do Azure.
- Não pode selecionar o inquilino onde a subscrição vai ser criada. A subscrição é sempre criada no inquilino principal do Proprietário da Conta. Para mover a assinatura para um inquilino diferente, veja alterar inquilino de subscrição.
Criar subscrições para uma conta MCA
Utilize as informações nas secções seguintes para criar subscrições para uma conta MCA.
Pré-requisitos
Tem de ter uma função de proprietário, contribuidor ou criador de subscrição do Azure numa secção da fatura ou uma função de proprietário ou contribuidor num perfil de faturação ou numa conta de faturação para criar subscrições. Para obter mais informações, veja Tarefas e funções da faturação da subscrição.
Os exemplos que se seguem utilizam APIs REST. Atualmente, o PowerShell e a CLI do Azure não são suportados.
Localizar contas de faturação a que tem acesso
Faça o pedido seguinte para listar todas as contas de faturação.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview
A resposta da API lista as contas de faturação às quais 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 faturação para a qual pretende criar subscrições. Certifique-se de que o agreementType da conta é MicrosoftCustomerAgreement. Copie o name da conta. Por exemplo, para criar uma subscrição para a conta de faturação Contoso, copie 5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. Cole o valor algures para que possa utilizá-lo no passo seguinte.
Localizar secções da fatura para criar subscrições
Os custos da subscrição aparecem numa secção da fatura de um perfil de faturação. Use a API seguinte para obter a lista de secções da fatura e perfis de faturação nos quais tem permissão para criar subscrições do Azure.
Faça o pedido a seguir ao substituir <billingAccountName> por name, copiado do primeiro passo (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 secções das faturas e respetivos perfis de faturação nos quais tem acesso para criar subscrições:
{
"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 secção da fatura para a qual pretende criar subscrições. Copie invoiceSectionId, billingProfileId e um dos skuId para a secção da fatura. Por exemplo, para criar uma subscrição do tipo Microsoft Azure plan para a secção Development da fatura, 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 valores algures para que possa utilizá-los no passo seguinte.
Criar uma subscrição para uma secção da fatura
O exemplo seguinte cria uma subscrição denominada Subscrição da Equipa de Desenvolvimento do tipo Plano do Microsoft Azure para a secção Desenvolvimento da fatura. A subscrição é faturada no perfil de faturação do departamento financeiro da Contoso e apresentada na secção Desenvolvimento desta fatura.
Faça o pedido seguinte ao substituir <invoiceSectionId> pelo invoiceSectionId copiado do segundo passo (/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). Transmita o billingProfileId e o skuId copiados do segundo passo nos parâmetros de pedido da API. Para especificar proprietários, veja como obter IDs de objeto de utilizador.
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 | Necessário | Type | Description |
|---|---|---|---|
displayName |
Sim | String | O nome a apresentar da subscrição. |
billingProfileId |
Sim | String | O ID do perfil de faturação ao qual são cobrados os custos da subscrição. |
skuId |
Sim | String | O ID da SKU que determina o tipo de plano do Azure. |
owners |
Não | String | O ID de Objeto de qualquer utilizador ou principal de serviço a adicionar como Proprietário de RBAC do Azure na subscrição quando esta é criada. |
costCenter |
Não | String | O centro de custos associado à subscrição. Este aparece no ficheiro CSV de utilização. |
managementGroupId |
Não | String | O ID do grupo de gestão ao qual a subscrição será adicionada. Para obter a lista de grupos de gestão, veja Grupos de Gestão – API de Lista. Use o ID de um grupo de gestão a partir da API. |
Na resposta, recebe um objeto subscriptionCreationResult para monitorização. Quando a criação da subscrição estiver concluída, o objeto subscriptionCreationResult devolve um objeto subscriptionLink, o qual tem o ID da subscrição.
Criar subscrições para uma conta de faturação MPA
Utilize as informações nas secções seguintes para criar subscrições para uma conta de faturação MPA.
Pré-requisitos
Tem de ter uma função de Administrador Global ou Agente de Administração na conta do Fornecedor de Soluções Cloud da sua organização para criar subscrições para a sua conta de faturação. Para obter mais informações, veja Partner Center - Assign users roles and permissions (Centro de Parceiros – Atribuir funções e permissões de utilizadores).
Os exemplos que se seguem utilizam APIs REST. Atualmente, o PowerShell e a CLI do Azure não são suportados.
Localizar as contas de faturação às quais tem acesso
Faça o pedido abaixo para listar todas as contas de faturação às quais 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 faturação.
{
"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 faturação para a qual pretende criar subscrições. Certifique-se de que o agreementType da conta é MicrosoftPartnerAgreement. Copie o name para a conta. Por exemplo, para criar uma subscrição para a conta de faturação Contoso, copie 99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. Cole o valor algures para que possa utilizá-lo no passo seguinte.
Localizar clientes que têm planos do Azure
Faça o pedido seguinte, substituindo <billingAccountName> pelo name copiado no primeiro passo (5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx) para listar todos os clientes na conta de faturação para quem pode criar subscrições 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 faturação com planos do Azure. Pode criar subscrições 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 pretende criar subscrições. Copie o id para o cliente. Por exemplo, para criar uma subscrição 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 o valor algures para utilizá-lo em passos posteriores.
Opcional para fornecedores indiretos: Obtenha os revendedores para um cliente
Se for um Fornecedor indireto no modelo de duas camadas do CSP, pode especificar um revendedor quando criar subscrições para os clientes.
Faça o pedido seguinte, substituindo <customerId> pelo id copiado no segundo passo (/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"
}
]
}
}]
}
Utilize a propriedade description para identificar o revendedor a associar à subscrição. Copie o resellerId para o revendedor. Por exemplo, para associar Wingtip, copie 3xxxxx. Cole o valor algures para que possa utilizá-lo no passo seguinte.
Criar uma subscrição para um cliente
O exemplo seguinte cria uma subscrição denominada Subscrição da Equipa de Desenvolvimento para a Fabrikam Toys e associa o revendedor Wingtip à subscrição.
Faça o pedido seguinte ao substituir <customerId> pelo id copiado do segundo passo (/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx). Transmita o resellerId opcional copiado do segundo passo nos parâmetros de pedido 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 | Necessário | Type | Description |
|---|---|---|---|
displayName |
Sim | String | O nome a apresentar da subscrição. |
skuId |
Sim | String | O ID da SKU do plano do Azure. Utilizar 0001 para subscrições do tipo Plano do Microsoft Azure |
resellerId |
Não | String | O ID do revendedor que será associado à assinatura. |
Na resposta, recebe um objeto subscriptionCreationResult para monitorização. Quando a criação da subscrição estiver concluída, o objeto subscriptionCreationResult devolve um objeto subscriptionLink. Este tem o ID da subscrição.
Próximos passos
- Para ver um exemplo de como criar uma subscrição de Contrato Enterprise (EA) com o .NET, veja código de exemplo no GitHub.
- Agora que criou uma subscrição, pode conceder essa capacidade a outros entidades principais de utilizador e de serviço. Para obter mais informações, veja Conceder acesso para criar subscrições Enterprise do Azure (pré-visualização).
- Para obter mais informações sobre como gerir grandes números de subscrições com grupos de gestão, veja Organizar recursos com os grupos de gestão do Azure.
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários