Udostępnij za pośrednictwem


Customers - Get By Billing Account

Pobiera klienta według jego identyfikatora na poziomie konta rozliczeniowego. Ta operacja jest obsługiwana tylko w przypadku kont rozliczeniowych z typem umowy Microsoft Partner Agreement.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
billingAccountName
path True

string

Identyfikator, który jednoznacznie identyfikuje konto rozliczeniowe.

Wzorzec wyrażenia regularnego: ^([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

Identyfikator, który jednoznacznie identyfikuje klienta.

Wzorzec wyrażenia regularnego: ^[a-zA-Z\d-_]{1,128}$

api-version
query True

string

Wersja interfejsu API, która ma być używana z żądaniem klienta. Bieżąca wersja to 2024-04-01.

Odpowiedzi

Nazwa Typ Opis
200 OK

Customer

Klient partnera.

Other Status Codes

ErrorResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Przykłady

CustomersGetByBillingAccount

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
AzurePlan

Szczegóły planu platformy Azure.

createdByType

Typ tożsamości, która utworzyła zasób.

Customer

Klient partnera.

CustomerProperties

Klient partnera.

CustomerStatus

Określa stan klienta. Jest to nadchodząca właściwość, która zostanie wypełniona w przyszłości.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

Reseller

Szczegóły odsprzedawcy.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

AzurePlan

Szczegóły planu platformy Azure.

Nazwa Typ Opis
productId

string

Identyfikator, który jednoznacznie identyfikuje produkt.

skuDescription

string

Opis jednostki SKU.

skuId

string

Identyfikator, który jednoznacznie identyfikuje jednostkę SKU.

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa Typ Opis
Application

string

Key

string

ManagedIdentity

string

User

string

Customer

Klient partnera.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nazwa zasobu

properties

CustomerProperties

Klient partnera.

systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.

tags

object

Słownik metadanych skojarzonych z zasobem. Nie można go wypełnić dla wszystkich typów zasobów. Maksymalna długość klucza/wartości obsługiwana przez 256 znaków. Klucze/wartość nie powinny być puste ani mieć wartości null. Klucze nie mogą zawierać <> % & \ ? /

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

CustomerProperties

Klient partnera.

Nazwa Typ Opis
billingProfileDisplayName

string

Nazwa profilu rozliczeniowego.

billingProfileId

string

W pełni kwalifikowany identyfikator, który jednoznacznie identyfikuje profil rozliczeniowy.

displayName

string

Nazwa klienta.

enabledAzurePlans

AzurePlan[]

Plany platformy Azure włączone dla klienta.

resellers

Reseller[]

Lista odsprzedawców, dla których jest włączony plan platformy Azure dla klienta.

status

CustomerStatus

Określa stan klienta. Jest to nadchodząca właściwość, która zostanie wypełniona w przyszłości.

systemId

string

System wygenerował unikatowy identyfikator klienta.

tags

object

Słownik metadanych skojarzonych z zasobem. Maksymalna długość klucza/wartości obsługiwana przez 256 znaków. Klucze/wartość nie powinny być puste ani mieć wartości null. Klucze nie mogą zawierać <> % & \ ? /

CustomerStatus

Określa stan klienta. Jest to nadchodząca właściwość, która zostanie wypełniona w przyszłości.

Nazwa Typ Opis
Active

string

Deleted

string

Disabled

string

Other

string

Pending

string

UnderReview

string

Warned

string

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt błędu.

Reseller

Szczegóły odsprzedawcy.

Nazwa Typ Opis
description

string

Nazwa odsprzedawcy.

resellerId

string

Identyfikator MPN odsprzedawcy.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string

Sygnatura czasowa tworzenia zasobu (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string

Znacznik czasu ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.