Condividi tramite


Customers - Get By Billing Account

Ottiene un cliente in base al relativo ID a livello di account di fatturazione. L'operazione è supportata solo per gli account di fatturazione con tipo di contratto Contratto Microsoft Partner.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
billingAccountName
path True

string

ID che identifica in modo univoco un account di fatturazione.

Criterio di espressione regolare: ^([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 che identifica in modo univoco un cliente.

Criterio di espressione regolare: ^[a-zA-Z\d-_]{1,128}$

api-version
query True

string

Versione dell'API da usare con la richiesta client. La versione corrente è 2024-04-01.

Risposte

Nome Tipo Descrizione
200 OK

Customer

Cliente di un partner.

Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Esempio

CustomersGetByBillingAccount

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
AzurePlan

Dettagli del piano di Azure.

createdByType

Tipo di identità che ha creato la risorsa.

Customer

Cliente di un partner.

CustomerProperties

Cliente di un partner.

CustomerStatus

Identifica lo stato di un cliente. Si tratta di una proprietà futura che verrà popolata in futuro.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

Reseller

Dettagli del rivenditore.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

AzurePlan

Dettagli del piano di Azure.

Nome Tipo Descrizione
productId

string

ID che identifica in modo univoco un prodotto.

skuDescription

string

Descrizione dello SKU.

skuId

string

ID che identifica in modo univoco uno SKU.

createdByType

Tipo di identità che ha creato la risorsa.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

Customer

Cliente di un partner.

Nome Tipo Descrizione
id

string

ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nome della risorsa

properties

CustomerProperties

Cliente di un partner.

systemData

systemData

Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.

tags

object

Dizionario dei metadati associati alla risorsa. Potrebbe non essere popolato per tutti i tipi di risorse. Lunghezza massima chiave/valore supportata di 256 caratteri. Chiavi/valore non deve essere vuoto né null. Le chiavi non possono contenere <> % & \ ? /

type

string

Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

CustomerProperties

Cliente di un partner.

Nome Tipo Descrizione
billingProfileDisplayName

string

Nome del profilo di fatturazione.

billingProfileId

string

ID completo che identifica in modo univoco un profilo di fatturazione.

displayName

string

Nome del cliente.

enabledAzurePlans

AzurePlan[]

Piani di Azure abilitati per il cliente.

resellers

Reseller[]

Elenco di rivenditori per cui è abilitato un piano di Azure per il cliente.

status

CustomerStatus

Identifica lo stato di un cliente. Si tratta di una proprietà futura che verrà popolata in futuro.

systemId

string

Identificatore univoco generato dal sistema per un cliente.

tags

object

Dizionario dei metadati associati alla risorsa. Lunghezza massima chiave/valore supportata di 256 caratteri. Chiavi/valore non deve essere vuoto né null. Le chiavi non possono contenere <> % & \ ? /

CustomerStatus

Identifica lo stato di un cliente. Si tratta di una proprietà futura che verrà popolata in futuro.

Nome Tipo Descrizione
Active

string

Deleted

string

Disabled

string

Other

string

Pending

string

UnderReview

string

Warned

string

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

Reseller

Dettagli del rivenditore.

Nome Tipo Descrizione
description

string

Nome del rivenditore.

resellerId

string

ID MPN del rivenditore.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione della risorsa (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt

string

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy

string

Identità che ha modificato l'ultima volta la risorsa.

lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima volta la risorsa.