Sdílet prostřednictvím


Customers - Get By Billing Account

Získá zákazníka podle ID na úrovni fakturačního účtu. Operace se podporuje jenom u fakturačních účtů s typem Smlouvy s partnerem Microsoftu.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
billingAccountName
path True

string

ID, které jednoznačně identifikuje fakturační účet.

Vzor regulárního výrazu: ^([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

ID, které jednoznačně identifikuje zákazníka.

Vzor regulárního výrazu: ^[a-zA-Z\d-_]{1,128}$

api-version
query True

string

Verze rozhraní API, která se má použít s požadavkem klienta. Aktuální verze je 2024-04-01.

Odpovědi

Name Typ Description
200 OK

Customer

Zákazník partnera.

Other Status Codes

ErrorResponse

Chybová odpověď popisující, proč operace selhala.

Příklady

CustomersGetByBillingAccount

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
AzurePlan

Podrobnosti o plánu Azure

createdByType

Typ identity, která prostředek vytvořila.

Customer

Zákazník partnera.

CustomerProperties

Zákazník partnera.

CustomerStatus

Identifikuje stav zákazníka. Toto je nadcházející vlastnost, která se naplní v budoucnu.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě.

ErrorResponse

Chybová odpověď

Reseller

Podrobnosti o prodejci

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

AzurePlan

Podrobnosti o plánu Azure

Name Typ Description
productId

string

ID, které jednoznačně identifikuje produkt.

skuDescription

string

Popis skladové položky.

skuId

string

ID, které jedinečně identifikuje skladovou položku.

createdByType

Typ identity, která prostředek vytvořila.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

Customer

Zákazník partnera.

Name Typ Description
id

string

Plně kvalifikované ID prostředku pro prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Název prostředku

properties

CustomerProperties

Zákazník partnera.

systemData

systemData

Metadata Azure Resource Manageru obsahující informace createdBy a modifiedBy

tags

object

Slovník metadat přidružených k prostředku Nemusí být vyplněna pro všechny typy prostředků. Maximální podporovaná délka klíče a hodnoty 256 znaků. Klíče nebo hodnota by neměly být prázdné ani null. Klíče nemohou obsahovat <> % & \ ? /

type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

CustomerProperties

Zákazník partnera.

Name Typ Description
billingProfileDisplayName

string

Název fakturačního profilu.

billingProfileId

string

Plně kvalifikované ID, které jednoznačně identifikuje fakturační profil.

displayName

string

Jméno zákazníka.

enabledAzurePlans

AzurePlan[]

Plány Azure povolené pro zákazníka

resellers

Reseller[]

Seznam prodejců, pro které je pro zákazníka povolený plán Azure.

status

CustomerStatus

Identifikuje stav zákazníka. Toto je nadcházející vlastnost, která se naplní v budoucnu.

systemId

string

Systém vygeneroval jedinečný identifikátor zákazníka.

tags

object

Slovník metadat přidružených k prostředku Maximální podporovaná délka klíče a hodnoty 256 znaků. Klíče nebo hodnota by neměly být prázdné ani null. Klíče nemohou obsahovat <> % & \ ? /

CustomerStatus

Identifikuje stav zákazníka. Toto je nadcházející vlastnost, která se naplní v budoucnu.

Name Typ Description
Active

string

Deleted

string

Disabled

string

Other

string

Pending

string

UnderReview

string

Warned

string

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby.

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva.

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

Reseller

Podrobnosti o prodejci

Name Typ Description
description

string

Název prodejce.

resellerId

string

ID MPN prodejce.

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Name Typ Description
createdAt

string

Časové razítko vytvoření prostředku (UTC).

createdBy

string

Identita, která prostředek vytvořila.

createdByType

createdByType

Typ identity, která prostředek vytvořila.

lastModifiedAt

string

Časové razítko poslední změny zdroje (UTC)

lastModifiedBy

string

Identita, která naposledy změnila prostředek.

lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.