Customers - Get

Gets a customer by its ID. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.

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

URI Parameters

Name In Required Type Description
billingAccountName
path True
  • string

The ID that uniquely identifies a billing account.

customerName
path True
  • string

The ID that uniquely identifies a customer.

api-version
query True
  • string

The version of the API to be used with the client request. The current version is 2019-10-01-preview.

$expand
query
  • string

May be used to expand enabledAzurePlans and resellers

Responses

Name Type Description
200 OK

OK. The request has succeeded.

Other Status Codes

Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name Description
user_impersonation impersonate your user account

Examples

Customer
CustomerWithExpand

Customer

Sample Request

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

Sample Response

{
  "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}",
  "name": "{customerName}",
  "type": "Microsoft.Billing/customers",
  "properties": {
    "displayName": "customer1"
  }
}

CustomerWithExpand

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}?api-version=2019-10-01-preview&$expand=enabledAzurePlans,resellers

Sample Response

{
  "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}",
  "name": "{customerName}",
  "type": "Microsoft.Billing/customers",
  "properties": {
    "displayName": "customerName1",
    "enabledAzurePlans": [
      {
        "skuId": "0002",
        "skuDescription": "Microsoft Azure Standard"
      }
    ],
    "resellers": [
      {
        "resellerId": "89e87bdf-a2a2-4687-925f-4c18b27bccfd",
        "description": "Reseller1"
      },
      {
        "resellerId": "3b65b5a8-bd4f-4084-90e9-e1bd667a2b19",
        "description": "Reseller2"
      }
    ]
  }
}

Definitions

AzurePlan

Details of the Azure plan.

Customer

A partner's customer.

ErrorDetails

The details of the error.

ErrorResponse

Error response indicates that the service is not able to process the incoming request. The reason is provided in the error message.

ErrorSubDetails
Reseller

Details of the reseller.

AzurePlan

Details of the Azure plan.

Name Type Description
skuDescription
  • string

The sku description.

skuId
  • string

The sku id.

Customer

A partner's customer.

Name Type Description
id
  • string

Resource Id.

name
  • string

Resource name.

properties.displayName
  • string

The name of the customer.

properties.enabledAzurePlans

Azure plans enabled for the customer.

properties.resellers

The list of resellers for which an Azure plan is enabled for the customer.

type
  • string

Resource type.

ErrorDetails

The details of the error.

Name Type Description
code
  • string

Error code.

details

The sub details of the error.

message
  • string

Error message indicating why the operation failed.

target
  • string

The target of the particular error.

ErrorResponse

Error response indicates that the service is not able to process the incoming request. The reason is provided in the error message.

Name Type Description
error

The details of the error.

ErrorSubDetails

Name Type Description
code
  • string

Error code.

message
  • string

Error message indicating why the operation failed.

target
  • string

The target of the particular error.

Reseller

Details of the reseller.

Name Type Description
description
  • string

The name of the reseller.

resellerId
  • string

The MPN ID of the reseller.