Partager via


Customers - Get By Billing Account

Obtient un client par son ID au niveau du compte de facturation. L’opération est prise en charge uniquement pour les comptes de facturation avec le type contrat Partenaire Microsoft.

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

Paramètres URI

Nom Dans Obligatoire Type Description
billingAccountName
path True

string

ID qui identifie de façon unique un compte de facturation.

Modèle d’expression régulière: ^([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 qui identifie de façon unique un client.

Modèle d’expression régulière: ^[a-zA-Z\d-_]{1,128}$

api-version
query True

string

Version de l’API à utiliser avec la demande cliente. La version actuelle est 2024-04-01.

Réponses

Nom Type Description
200 OK

Customer

Client d’un partenaire.

Other Status Codes

ErrorResponse

Réponse d’erreur décrivant pourquoi l’opération a échoué.

Exemples

CustomersGetByBillingAccount

Exemple de requête

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

Exemple de réponse

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

Définitions

Nom Description
AzurePlan

Détails du plan Azure.

createdByType

Type d’identité qui a créé la ressource.

Customer

Client d’un partenaire.

CustomerProperties

Client d’un partenaire.

CustomerStatus

Identifie l’état d’un client. Il s’agit d’une propriété à venir qui sera remplie à l’avenir.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

Reseller

Détails du revendeur.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

AzurePlan

Détails du plan Azure.

Nom Type Description
productId

string

ID qui identifie de façon unique un produit.

skuDescription

string

Description de la référence SKU.

skuId

string

ID qui identifie de façon unique une référence SKU.

createdByType

Type d’identité qui a créé la ressource.

Nom Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

Customer

Client d’un partenaire.

Nom Type Description
id

string

ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »

name

string

Nom de la ressource

properties

CustomerProperties

Client d’un partenaire.

systemData

systemData

Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.

tags

object

Dictionnaire de métadonnées associées à la ressource. Il peut ne pas être rempli pour tous les types de ressources. Longueur maximale de clé/valeur prise en charge de 256 caractères. Les clés/valeur ne doivent pas être vides ni null. Les clés ne peuvent pas contenir <> % & \ ? /

type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

CustomerProperties

Client d’un partenaire.

Nom Type Description
billingProfileDisplayName

string

Nom du profil de facturation.

billingProfileId

string

ID complet qui identifie de façon unique un profil de facturation.

displayName

string

Nom du client.

enabledAzurePlans

AzurePlan[]

Plans Azure activés pour le client.

resellers

Reseller[]

Liste des revendeurs pour lesquels un plan Azure est activé pour le client.

status

CustomerStatus

Identifie l’état d’un client. Il s’agit d’une propriété à venir qui sera remplie à l’avenir.

systemId

string

Identificateur unique généré par le système pour un client.

tags

object

Dictionnaire de métadonnées associées à la ressource. Longueur maximale de clé/valeur prise en charge de 256 caractères. Les clés/valeur ne doivent pas être vides ni null. Les clés ne peuvent pas contenir <> % & \ ? /

CustomerStatus

Identifie l’état d’un client. Il s’agit d’une propriété à venir qui sera remplie à l’avenir.

Nom Type Description
Active

string

Deleted

string

Disabled

string

Other

string

Pending

string

UnderReview

string

Warned

string

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.

type

string

Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

Reseller

Détails du revendeur.

Nom Type Description
description

string

Nom du revendeur.

resellerId

string

ID MPN du revendeur.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string

Horodatage de la dernière modification de ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.

lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.