Condividi tramite


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
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})?)$

billingProfileName
path True

string

ID che identifica in modo univoco un profilo di fatturazione.

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.

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.

orderBy
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

CustomerListResult

Elenco di clienti.

Other Status Codes

ErrorResponse

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

Esempio

CustomersListByBillingProfile

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/billingProfiles/xxxx-xxxx-xxx-xxx/customers?api-version=2024-04-01

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
AzurePlan

Dettagli del piano di Azure.

createdByType

Tipo di identità che ha creato la risorsa.

Customer

Cliente di un partner.

CustomerListResult

Contenitore per un elenco di risorse

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"

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

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.