Billing Subscriptions - Get By Customer

Service:

Billing

API Version:

2019-10-01-preview

Obtém uma assinatura por sua ID. A operação tem suporte apenas para contas de cobrança com o tipo de contrato Contrato de Parceiro da Microsoft.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/billingSubscriptions/{billingSubscriptionName}?api-version=2019-10-01-preview

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
billingAccountName	path	True	string	A ID que identifica exclusivamente uma conta de cobrança.
billingSubscriptionName	path	True	string	A ID que identifica exclusivamente uma assinatura.
customerName	path	True	string	A ID que identifica exclusivamente um cliente.
api-version	query	True	string	A versão da API a ser usada com a solicitação do cliente. A versão atual é 2019-10-01-preview.

Respostas

Nome	Tipo	Description
200 OK	BillingSubscription	OK. A solicitação foi bem-sucedida.
Other Status Codes	ErrorResponse	Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

BillingSubscriptionByCustomer

Sample Request

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/billingSubscriptions/{billingSubscriptionName}?api-version=2019-10-01-preview

Sample Response

Status code:

200

{
  "id": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/customers/{customerName}/billingSubscriptions/{billingSubscriptionName}",
  "name": "{billingSubscriptionName}",
  "type": "Microsoft.Billing/billingSubscriptions",
  "properties": {
    "displayName": "My Subscription",
    "subscriptionId": "6b96d3f2-9008-4a9d-912f-f87744185aa3",
    "subscriptionBillingStatus": "Active",
    "lastMonthCharges": {
      "currency": "USD",
      "value": 5000
    },
    "monthToDateCharges": {
      "currency": "USD",
      "value": 600
    },
    "customerId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}",
    "customerDisplayName": "Customer1",
    "reseller": {
      "resellerId": "3b65b5a8-bd4f-4084-90e9-e1bd667a2b19",
      "description": "Reseller2"
    },
    "skuId": "0002",
    "skuDescription": "Microsoft Azure Standard"
  }
}

Definições

Nome	Description
Amount	O valor.
BillingSubscription	Uma assinatura de cobrança.
BillingSubscriptionStatusType	O status de cobrança atual da assinatura.
ErrorDetails	Os detalhes do erro.
ErrorResponse	A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.
ErrorSubDetails
Reseller	Detalhes do revendedor.

Amount

O valor.

Nome	Tipo	Description
currency	string	A moeda do valor do valor.
value	number	Valor da quantidade.

BillingSubscription

Uma assinatura de cobrança.

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.billingProfileDisplayName	string	O nome do perfil de cobrança ao qual a assinatura é cobrada.
properties.billingProfileId	string	A ID do perfil de cobrança ao qual a assinatura é cobrada.
properties.customerDisplayName	string	O nome do cliente para o qual a assinatura foi criada. O campo é aplicável somente para Contrato de Parceiro da Microsoft conta de cobrança.
properties.customerId	string	A ID do cliente para o qual a assinatura foi criada. O campo é aplicável somente para Contrato de Parceiro da Microsoft conta de cobrança.
properties.displayName	string	O nome da assinatura.
properties.invoiceSectionDisplayName	string	O nome da seção da fatura à qual a assinatura é cobrada.
properties.invoiceSectionId	string	A ID da seção da fatura à qual a assinatura é cobrada.
properties.lastMonthCharges	Amount	O último mês cobra.
properties.monthToDateCharges	Amount	Os encargos atuais do mês até o momento.
properties.reseller	Reseller	Revendedor para esta assinatura.
properties.skuDescription	string	A descrição do SKU do plano do Azure para a assinatura.
properties.skuId	string	A ID de SKU do plano do Azure para a assinatura.
properties.subscriptionBillingStatus	BillingSubscriptionStatusType	O status de cobrança atual da assinatura.
properties.subscriptionId	string	A ID da assinatura.
type	string	Tipo de recurso.

BillingSubscriptionStatusType

O status de cobrança atual da assinatura.

Nome	Tipo	Description
Abandoned	string
Active	string
Deleted	string
Inactive	string
Warning	string

ErrorDetails

Os detalhes do erro.

Nome	Tipo	Description
code	string	Código do erro.
details	ErrorSubDetails[]	Os sub-detalhes do erro.
message	string	Mensagem de erro indicando por que a operação falhou.
target	string	O destino do erro específico.

ErrorResponse

A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.

Nome	Tipo	Description
error	ErrorDetails	Os detalhes do erro.

ErrorSubDetails

Nome	Tipo	Description
code	string	Código do erro.
message	string	Mensagem de erro indicando por que a operação falhou.
target	string	O destino do erro específico.

Reseller

Detalhes do revendedor.

Nome	Tipo	Description
description	string	O nome do revendedor.
resellerId	string	A ID do MPN do revendedor.