Partilhar via


Customers - Get By Billing Account

Obtém um cliente pelo seu ID ao nível da conta de faturação. A operação é suportada apenas para contas de cobrança com contrato do tipo Microsoft Partner Agreement.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}?api-version=2024-04-01

Parâmetros do URI

Name Em Necessário Tipo Description
billingAccountName
path True

string

O ID que identifica exclusivamente uma conta de cobrança.

Padrão Regex: ^([0-9]+|([Pp][Cc][Nn]\.[A-Za-z0-9]+)|[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}(:[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}_[0-9]{4}(-[0-9]{2}){2})?)$

customerName
path True

string

O ID que identifica exclusivamente um cliente.

Padrão Regex: ^[a-zA-Z\d-_]{1,128}$

api-version
query True

string

A versão da API a ser usada com a solicitação do cliente. A versão atual é 2024-04-01.

Respostas

Name Tipo Description
200 OK

Customer

Cliente de um parceiro.

Other Status Codes

ErrorResponse

Resposta de erro descrevendo por que a operação falhou.

Exemplos

CustomersGetByBillingAccount

Pedido de amostra

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/customers/11111111-1111-1111-1111-111111111111?api-version=2024-04-01

Resposta da amostra

{
  "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/customers/11111111-1111-1111-1111-111111111111",
  "name": "11111111-1111-1111-1111-111111111111",
  "properties": {
    "billingProfileDisplayName": "Contoso Operations Billing",
    "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx",
    "displayName": "customer1",
    "systemId": "yyyy-yyyy-yyy-yyy",
    "status": "Active",
    "enabledAzurePlans": [
      {
        "skuId": "0002",
        "skuDescription": "Microsoft Azure Plan for DevTest"
      }
    ],
    "resellers": [
      {
        "resellerId": "89e87bdf-a2a2-4687-925f-4c18b27bccfd",
        "description": "Reseller1"
      },
      {
        "resellerId": "3b65b5a8-bd4f-4084-90e9-e1bd667a2b19",
        "description": "Reseller2"
      }
    ],
    "tags": {
      "pcCode": "A123456",
      "costCategory": "Support"
    }
  },
  "type": "Microsoft.Billing/billingAccounts/billingProfiles/customers"
}

Definições

Name Description
AzurePlan

Detalhes do plano do Azure.

createdByType

O tipo de identidade que criou o recurso.

Customer

Cliente de um parceiro.

CustomerProperties

Cliente de um parceiro.

CustomerStatus

Identifica o status de um cliente. Esta é uma propriedade futura que será povoada no futuro.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

Reseller

Detalhes do revendedor.

systemData

Metadados referentes à criação e última modificação do recurso.

AzurePlan

Detalhes do plano do Azure.

Name Tipo Description
productId

string

O ID que identifica exclusivamente um produto.

skuDescription

string

A descrição do sku.

skuId

string

O ID que identifica exclusivamente uma sku.

createdByType

O tipo de identidade que criou o recurso.

Name Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

Customer

Cliente de um parceiro.

Name Tipo Description
id

string

ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

O nome do recurso

properties

CustomerProperties

Cliente de um parceiro.

systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

tags

object

Dicionário de metadados associados ao recurso. Ele pode não ser preenchido para todos os tipos de recursos. Comprimento máximo de chave/valor suportado de 256 caracteres. Chaves/valor não devem esvaziar valor nem nulo. As chaves não podem conter <> % & \ ? /

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

CustomerProperties

Cliente de um parceiro.

Name Tipo Description
billingProfileDisplayName

string

O nome do perfil de cobrança.

billingProfileId

string

O ID totalmente qualificado que identifica exclusivamente um perfil de faturamento.

displayName

string

O nome do cliente.

enabledAzurePlans

AzurePlan[]

Planos do Azure habilitados para o cliente.

resellers

Reseller[]

A lista de revendedores para os quais um plano do Azure está habilitado para o cliente.

status

CustomerStatus

Identifica o status de um cliente. Esta é uma propriedade futura que será povoada no futuro.

systemId

string

O sistema gerou um identificador único para um cliente.

tags

object

Dicionário de metadados associados ao recurso. Comprimento máximo de chave/valor suportado de 256 caracteres. Chaves/valor não devem esvaziar valor nem nulo. As chaves não podem conter <> % & \ ? /

CustomerStatus

Identifica o status de um cliente. Esta é uma propriedade futura que será povoada no futuro.

Name Tipo Description
Active

string

Deleted

string

Disabled

string

Other

string

Pending

string

UnderReview

string

Warned

string

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Name Tipo Description
error

ErrorDetail

O objeto de erro.

Reseller

Detalhes do revendedor.

Name Tipo Description
description

string

O nome do revendedor.

resellerId

string

O ID MPN do revendedor.

systemData

Metadados referentes à criação e última modificação do recurso.

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.