Поделиться через


Customers - Get By Billing Account

Получает клиента по идентификатору на уровне учетной записи выставления счетов. Эта операция поддерживается только для учетных записей выставления счетов с типом соглашения Microsoft Partner Agreement.

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

Параметры URI

Имя В Обязательно Тип Описание
billingAccountName
path True

string

Идентификатор, который однозначно идентифицирует учетную запись выставления счетов.

Шаблон регулярного выражения: ^([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

Идентификатор, который однозначно идентифицирует клиента.

Шаблон регулярного выражения: ^[a-zA-Z\d-_]{1,128}$

api-version
query True

string

Версия API, используемая с клиентским запросом. Текущая версия — 2024-04-01.

Ответы

Имя Тип Описание
200 OK

Customer

Клиент партнера.

Other Status Codes

ErrorResponse

Ответ на ошибку, описывающий причину сбоя операции.

Примеры

CustomersGetByBillingAccount

Образец запроса

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

Пример ответа

{
  "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"
}

Определения

Имя Описание
AzurePlan

Сведения о плане Azure.

createdByType

Тип удостоверения, создавшего ресурс.

Customer

Клиент партнера.

CustomerProperties

Клиент партнера.

CustomerStatus

Определяет состояние клиента. Это предстоящее свойство, которое будет заполнено в будущем.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Сведения об ошибке.

ErrorResponse

Ответ на ошибку

Reseller

Сведения о торговом посреднике.

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

AzurePlan

Сведения о плане Azure.

Имя Тип Описание
productId

string

Идентификатор, который однозначно идентифицирует продукт.

skuDescription

string

Описание SKU.

skuId

string

Идентификатор, который однозначно идентифицирует номер SKU.

createdByType

Тип удостоверения, создавшего ресурс.

Имя Тип Описание
Application

string

Key

string

ManagedIdentity

string

User

string

Customer

Клиент партнера.

Имя Тип Описание
id

string

Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Имя ресурса

properties

CustomerProperties

Клиент партнера.

systemData

systemData

Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.

tags

object

Словарь метаданных, связанных с ресурсом. Он не может быть заполнен для всех типов ресурсов. Максимальная длина ключа и значения, поддерживаемая 256 символами. Ключи или значение не должны пустыми значениями и значениями NULL. Ключи не могут содержать <> % & \ ? /

type

string

Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

CustomerProperties

Клиент партнера.

Имя Тип Описание
billingProfileDisplayName

string

Имя профиля выставления счетов.

billingProfileId

string

Полный идентификатор, который однозначно идентифицирует профиль выставления счетов.

displayName

string

Имя клиента.

enabledAzurePlans

AzurePlan[]

Планы Azure, включенные для клиента.

resellers

Reseller[]

Список торговых посредников, для которых включен план Azure для клиента.

status

CustomerStatus

Определяет состояние клиента. Это предстоящее свойство, которое будет заполнено в будущем.

systemId

string

Система создала уникальный идентификатор для клиента.

tags

object

Словарь метаданных, связанных с ресурсом. Максимальная длина ключа и значения, поддерживаемая 256 символами. Ключи или значение не должны пустыми значениями и значениями NULL. Ключи не могут содержать <> % & \ ? /

CustomerStatus

Определяет состояние клиента. Это предстоящее свойство, которое будет заполнено в будущем.

Имя Тип Описание
Active

string

Deleted

string

Disabled

string

Other

string

Pending

string

UnderReview

string

Warned

string

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Дополнительный тип сведений.

ErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorResponse

Ответ на ошибку

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

Reseller

Сведения о торговом посреднике.

Имя Тип Описание
description

string

Имя торгового посредника.

resellerId

string

Идентификатор MPN торгового посредника.

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя Тип Описание
createdAt

string

Метка времени создания ресурса (UTC).

createdBy

string

Удостоверение, создающее ресурс.

createdByType

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.

lastModifiedByType

createdByType

Тип удостоверения, который последний раз изменил ресурс.