Dela via


Customers - Get By Billing Account

Hämtar en kund efter sitt ID på faktureringskontonivå. Åtgärden stöds endast för faktureringskonton med avtalstypen Microsoft-partneravtal.

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

URI-parametrar

Name I Obligatorisk Typ Description
billingAccountName
path True

string

Det ID som unikt identifierar ett faktureringskonto.

Reguljärt uttrycksmönster: ^([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

Det ID som unikt identifierar en kund.

Reguljärt uttrycksmönster: ^[a-zA-Z\d-_]{1,128}$

api-version
query True

string

Den version av API:et som ska användas med klientbegäran. Den aktuella versionen är 2024-04-01.

Svar

Name Typ Description
200 OK

Customer

En partners kund.

Other Status Codes

ErrorResponse

Felsvar som beskriver varför åtgärden misslyckades.

Exempel

CustomersGetByBillingAccount

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
AzurePlan

Information om Azure-planen.

createdByType

Den typ av identitet som skapade resursen.

Customer

En partners kund.

CustomerProperties

En partners kund.

CustomerStatus

Identifierar status för en kund. Det här är en kommande egenskap som kommer att fyllas i i framtiden.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorDetail

Felinformationen.

ErrorResponse

Felsvar

Reseller

Information om återförsäljaren.

systemData

Metadata som rör skapande och senaste ändring av resursen.

AzurePlan

Information om Azure-planen.

Name Typ Description
productId

string

Det ID som unikt identifierar en produkt.

skuDescription

string

SKU-beskrivningen.

skuId

string

Det ID som unikt identifierar en sku.

createdByType

Den typ av identitet som skapade resursen.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

Customer

En partners kund.

Name Typ Description
id

string

Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Namnet på resursen

properties

CustomerProperties

En partners kund.

systemData

systemData

Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.

tags

object

Ordlista med metadata som är associerade med resursen. Den kanske inte fylls i för alla resurstyper. Maximal nyckel/värdelängd som stöds på 256 tecken. Nycklar/värde får inte vara tomt eller null. Nycklar kan inte innehålla <> % & \ ? /

type

string

Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

CustomerProperties

En partners kund.

Name Typ Description
billingProfileDisplayName

string

Namnet på faktureringsprofilen.

billingProfileId

string

Det fullständigt kvalificerade ID som unikt identifierar en faktureringsprofil.

displayName

string

Kundens namn.

enabledAzurePlans

AzurePlan[]

Azure-planer aktiverade för kunden.

resellers

Reseller[]

Listan över återförsäljare som en Azure-plan är aktiverad för för kunden.

status

CustomerStatus

Identifierar status för en kund. Det här är en kommande egenskap som kommer att fyllas i i framtiden.

systemId

string

Systemet genererade unik identifierare för en kund.

tags

object

Ordlista med metadata som är associerade med resursen. Maximal nyckel/värdelängd som stöds på 256 tecken. Nycklar/värde får inte vara tomt eller null. Nycklar kan inte innehålla <> % & \ ? /

CustomerStatus

Identifierar status för en kund. Det här är en kommande egenskap som kommer att fyllas i i framtiden.

Name Typ Description
Active

string

Deleted

string

Disabled

string

Other

string

Pending

string

UnderReview

string

Warned

string

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.

type

string

Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

Reseller

Information om återförsäljaren.

Name Typ Description
description

string

Namnet på återförsäljaren.

resellerId

string

MPN-ID:t för återförsäljaren.

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string

Tidsstämpeln för resursskapande (UTC).

createdBy

string

Identiteten som skapade resursen.

createdByType

createdByType

Den typ av identitet som skapade resursen.

lastModifiedAt

string

Tidsstämpeln för resursens senaste ändring (UTC)

lastModifiedBy

string

Identiteten som senast ändrade resursen.

lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.