Customers - List By Billing Profile
Elenca i clienti fatturati a un profilo 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}/billingProfiles/{billingProfileName}/customers?api-version=2024-04-01
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers?api-version=2024-04-01&expand={expand}&filter={filter}&orderBy={orderBy}&top={top}&skip={skip}&count={count}&search={search}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
billing
|
path | True |
string |
ID che identifica in modo univoco un account di fatturazione. Criterio di espressione regolare: |
billing
|
path | True |
string |
ID che identifica in modo univoco un profilo di fatturazione. Criterio di espressione regolare: |
api-version
|
query | True |
string |
Versione dell'API da usare con la richiesta client. La versione corrente è 2024-04-01. |
count
|
query |
boolean |
L'opzione di query count consente ai client di richiedere un conteggio delle risorse corrispondenti incluse nelle risorse nella risposta. |
|
expand
|
query |
string |
Può essere usato per espandere enabledAzurePlans e rivenditori |
|
filter
|
query |
string |
L'opzione di query di filtro consente ai client di filtrare una raccolta di risorse indirizzate da un URL di richiesta. |
|
order
|
query |
string |
L'opzione di query orderby consente ai client di richiedere risorse in un ordine specifico. |
|
search
|
query |
string |
L'opzione di query di ricerca consente ai client di richiedere elementi all'interno di una raccolta corrispondente a un'espressione di ricerca senza testo. la ricerca è supportata solo per i campi stringa. |
|
skip
|
query |
integer int64 |
L'opzione ignora query richiede il numero di elementi nella raccolta di query che devono essere ignorati e non inclusi nel risultato. |
|
top
|
query |
integer int64 |
L'opzione query principale richiede che il numero di elementi nella raccolta di query venga incluso nel risultato. Il valore massimo supportato per top è 50. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Elenco di clienti. |
|
Other Status Codes |
Risposta di errore che descrive il motivo per cui l'operazione non è riuscita. |
Esempio
CustomersListByBillingProfile
Esempio di richiesta
Risposta di esempio
{
"value": [
{
"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",
"tags": {
"pcCode": "A123456",
"costCategory": "Support"
}
},
"type": "Microsoft.Billing/billingAccounts/billingProfiles/customers"
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/customers/22222222-2222-2222-2222-222222222222",
"name": "22222222-2222-2222-2222-222222222222",
"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": "customer2",
"systemId": "zzzz-zzzz-zzz-zzz",
"status": "Active"
},
"type": "Microsoft.Billing/billingAccounts/billingProfiles/customers"
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Azure |
Dettagli del piano di Azure. |
created |
Tipo di identità che ha creato la risorsa. |
Customer |
Cliente di un partner. |
Customer |
Contenitore per un elenco di risorse |
Customer |
Cliente di un partner. |
Customer |
Identifica lo stato di un cliente. Si tratta di una proprietà futura che verrà popolata in futuro. |
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
Reseller |
Dettagli del rivenditore. |
system |
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 |
Cliente di un partner. |
|
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" |
CustomerListResult
Contenitore per un elenco di risorse
Nome | Tipo | Descrizione |
---|---|---|
nextLink |
string |
Collegamento (URL) alla pagina successiva dei risultati. |
value |
Customer[] |
Elenco di risorse. |
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 |
Piani di Azure abilitati per il cliente. |
|
resellers |
Reseller[] |
Elenco di rivenditori per cui è abilitato un piano di Azure per il cliente. |
status |
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 |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
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 |
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 |
Tipo di identità che ha modificato l'ultima volta la risorsa. |