Billing Accounts - List
Répertorie les comptes de facturation auxquels un utilisateur a accès.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2024-04-01
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?includeAll={includeAll}&includeAllWithoutBillingProfiles={includeAllWithoutBillingProfiles}&includeDeleted={includeDeleted}&includePendingAgreement={includePendingAgreement}&includeResellee={includeResellee}&legalOwnerTID={legalOwnerTID}&legalOwnerOID={legalOwnerOID}&api-version=2024-04-01&filter={filter}&expand={expand}&top={top}&skip={skip}&search={search}
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
api-version
|
query | True |
string |
Version de l’API à utiliser avec la demande cliente. La version actuelle est 2024-04-01. |
expand
|
query |
string |
Expand est autorisé pour SoldTo et EnrollmentDetails/PONumber. |
|
filter
|
query |
string |
L’option de requête de filtre permet aux clients de filtrer une collection de ressources qui sont traitées par une URL de requête. |
|
include
|
query |
boolean |
Lorsque la valeur est true, les résultats incluent les comptes de facturation sur utilisant lequel l’utilisateur n’a pas d’attribution de rôle direct si l’utilisateur a l’un des rôles AAD suivants : Administrateur général, Lecteur général, Administrateur de facturation. |
|
include
|
query |
boolean |
Lorsque la valeur est true, les résultats incluent les comptes de facturation qui ne sont pas entièrement créés si l’utilisateur a l’un des rôles AAD suivants : Administrateur général, Lecteur général, Administrateur de facturation. |
|
include
|
query |
boolean |
Lorsque la valeur est true, les résultats incluent tous les comptes de facturation dans un état supprimé. |
|
include
|
query |
boolean |
Inclut les comptes de facturation avec un contrat en attente de signature auquel l’utilisateur a accès. |
|
include
|
query |
boolean |
Inclut le compte de facturation du client du Contrat Partenaire Microsoft auquel l’utilisateur a accès. |
|
legal
|
query |
string |
Doit être combiné avec legalOwnerTID, les résultats incluent uniquement les comptes de facturation pour lesquels les comptes de facturation sont légalement responsables des comptes de facturation. Optionnel. |
|
legal
|
query |
string |
Doit être combiné avec legalOwnerOID, les résultats incluent uniquement les comptes de facturation pour lesquels les comptes de facturation sont légalement responsables des comptes de facturation. Optionnel. |
|
search
|
query |
string |
L’option de requête de recherche permet aux clients de demander des éléments dans une collection correspondant à une expression de recherche en texte libre. la recherche n’est prise en charge que pour les champs de chaîne. |
|
skip
|
query |
integer int64 |
L’option ignorer la requête demande le nombre d’éléments de la collection interrogée à ignorer et non inclus dans le résultat. |
|
top
|
query |
integer int64 |
L’option de requête supérieure demande le nombre d’éléments de la collection interrogée à inclure dans le résultat. La valeur maximale prise en charge pour le haut est 50. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Liste des comptes de facturation. |
|
Other Status Codes |
Réponse d’erreur décrivant pourquoi l’opération a échoué. |
Exemples
Billing |
Billing |
Billing |
BillingAccountForLegacyAccountDetails
Exemple de requête
Exemple de réponse
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/20000000-0000-0000-0000-000000000001",
"name": "20000000-0000-0000-0000-000000000001",
"properties": {
"accountStatus": "Active",
"accountType": "Individual",
"agreementType": "MicrosoftOnlineServicesProgram",
"displayName": "Individual Account 2",
"hasReadAccess": true,
"notificationEmailAddress": "individual@domain.com"
},
"type": "Microsoft.Billing/billingAccounts"
}
]
}
BillingAccountsList
Exemple de requête
Exemple de réponse
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
"name": "10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
"properties": {
"accountStatus": "Active",
"accountType": "Business",
"accountSubType": "Enterprise",
"agreementType": "MicrosoftCustomerAgreement",
"displayName": "Premier Business Account",
"hasReadAccess": true,
"primaryBillingTenantId": "20000000-0000-0000-0000-000000000001"
},
"type": "Microsoft.Billing/billingAccounts",
"systemData": {
"createdAt": "2023-01-04T22:39:34.2606750Z",
"lastModifiedAt": "2023-01-05T22:39:34.2606750Z"
}
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/20000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
"name": "20000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
"properties": {
"accountStatus": "Active",
"accountType": "Business",
"accountSubType": "Professional",
"agreementType": "MicrosoftCustomerAgreement",
"displayName": "Standard Business Account",
"hasReadAccess": true,
"primaryBillingTenantId": "20000000-0000-0000-0000-000000000001"
},
"type": "Microsoft.Billing/billingAccounts",
"systemData": {
"createdAt": "2023-01-04T22:39:34.2606750Z",
"lastModifiedAt": "2023-01-05T22:39:34.2606750Z"
}
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/30000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
"name": "30000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
"properties": {
"accountStatus": "Active",
"accountType": "Individual",
"accountSubType": "Individual",
"agreementType": "MicrosoftCustomerAgreement",
"displayName": "Individual Account",
"hasReadAccess": true,
"primaryBillingTenantId": "20000000-0000-0000-0000-000000000001"
},
"type": "Microsoft.Billing/billingAccounts",
"systemData": {
"createdAt": "2023-01-04T22:39:34.2606750Z",
"lastModifiedAt": "2023-01-05T22:39:34.2606750Z"
}
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/40000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
"name": "40000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
"properties": {
"accountStatus": "Active",
"accountType": "Business",
"accountSubType": "Enterprise",
"agreementType": "MicrosoftPartnerAgreement",
"displayName": "Premier Business Account",
"hasReadAccess": true,
"primaryBillingTenantId": "20000000-0000-0000-0000-000000000001"
},
"type": "Microsoft.Billing/billingAccounts",
"systemData": {
"createdAt": "2023-01-04T22:39:34.2606750Z",
"lastModifiedAt": "2023-01-05T22:39:34.2606750Z"
}
}
]
}
BillingAccountsListWithExpandForPONumber
Exemple de requête
Exemple de réponse
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/6564892",
"name": "6564892",
"properties": {
"accountStatus": "Active",
"accountType": "Enterprise",
"accountSubType": "None",
"agreementType": "EnterpriseAgreement",
"displayName": "Enterprise Account",
"enrollmentDetails": {
"startDate": "2018-05-01T17:32:28Z",
"endDate": "2019-05-31T17:32:28Z",
"currency": "USD",
"channel": "EaDirect",
"language": "en",
"countryCode": "US",
"billingCycle": "Monthly",
"extendedTermOption": "Opted-Out",
"supportLevel": "Standard",
"supportCoverage": "1/26/2021 - 6/30/2021",
"cloud": "Azure Commercial",
"poNumber": "poNumber123"
},
"hasReadAccess": true,
"soldTo": {
"addressLine1": "Test Address",
"city": "City",
"companyName": "Enterprise Company",
"country": "US",
"postalCode": "00000-1111",
"region": "WA"
}
},
"type": "Microsoft.Billing/billingAccounts",
"systemData": {
"createdAt": "2023-01-04T22:39:34.2606750Z",
"lastModifiedAt": "2023-01-05T22:39:34.2606750Z"
}
}
]
}
Définitions
Nom | Description |
---|---|
Account |
État actuel du compte de facturation. |
Account |
Niveau du compte. |
Account |
Type de client. |
Agreement |
Type d’accord. |
Billing |
Un compte de facturation. |
Billing |
Conteneur pour une liste de ressources |
Billing |
Un compte de facturation. |
Billing |
Motif de l’état du compte de facturation spécifié. |
Billing |
Identifie les relations de facturation représentées par un compte de facturation. La relation de facturation peut être entre Microsoft, le client et/ou un tiers. |
created |
Type d’identité qui a créé la ressource. |
Enrollment |
Propriétés d’une inscription. |
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
Error |
Détail de l’erreur. |
Error |
Réponse d’erreur |
Extended |
Extension de compte de facturation choisie par l’entreprise. |
Indirect |
Identifie le profil de facturation lié à un autre profil de facturation dans le mouvement d’achat indirect. |
Markup |
État du balisage de l’inscription, applicable uniquement aux inscriptions indirectes. |
Provisioning |
État d’approvisionnement de la ressource pendant une opération de longue durée. |
Registration |
Décrit le numéro d’inscription de l’organisation liée au compte de facturation. |
Sold |
Adresse de la personne ou de l’organisation responsable du compte de facturation. |
Support |
Offre de niveau de support associée à une inscription. |
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
Tax |
Identificateur fiscal du compte de facturation. |
Tax |
État de l’identificateur fiscal. |
Tax |
Type de l’identificateur fiscal. |
AccountStatus
État actuel du compte de facturation.
Nom | Type | Description |
---|---|---|
Active |
string |
|
Deleted |
string |
|
Disabled |
string |
|
Expired |
string |
|
Extended |
string |
|
New |
string |
|
Other |
string |
|
Pending |
string |
|
Terminated |
string |
|
Transferred |
string |
|
UnderReview |
string |
AccountSubType
Niveau du compte.
Nom | Type | Description |
---|---|---|
Enterprise |
string |
|
Individual |
string |
|
None |
string |
|
Other |
string |
|
Professional |
string |
AccountType
Type de client.
Nom | Type | Description |
---|---|---|
Business |
string |
|
ClassicPartner |
string |
|
Enterprise |
string |
|
Individual |
string |
|
Internal |
string |
|
Other |
string |
|
Partner |
string |
|
Reseller |
string |
|
Tenant |
string |
AgreementType
Type d’accord.
Nom | Type | Description |
---|---|---|
EnterpriseAgreement |
string |
|
MicrosoftCustomerAgreement |
string |
|
MicrosoftOnlineServicesProgram |
string |
|
MicrosoftPartnerAgreement |
string |
|
Other |
string |
BillingAccount
Un compte de facturation.
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 |
Un compte de facturation. |
|
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 » |
BillingAccountListResult
Conteneur pour une liste de ressources
Nom | Type | Description |
---|---|---|
nextLink |
string |
Lien (URL) vers la page suivante des résultats. |
value |
Liste des ressources. |
BillingAccountProperties
Un compte de facturation.
Nom | Type | Description |
---|---|---|
accountStatus |
État actuel du compte de facturation. |
|
accountStatusReasonCode |
Motif de l’état du compte de facturation spécifié. |
|
accountSubType |
Niveau du compte. |
|
accountType |
Type de client. |
|
agreementType |
Type d’accord. |
|
billingRelationshipTypes |
Identifie les relations de facturation représentées par un compte de facturation. La relation de facturation peut être entre Microsoft, le client et/ou un tiers. |
|
displayName |
string |
Nom du compte de facturation. |
enrollmentDetails |
Propriétés d’une inscription. |
|
hasNoBillingProfiles |
boolean |
Indique si le compte de facturation comporte ou non des profils de facturation. |
hasReadAccess |
boolean |
Indique si l’utilisateur a un accès en lecture au compte de facturation. |
notificationEmailAddress |
string |
Adresse e-mail de notification pour le compte hérité. Disponible pour le type de contrat Programme Microsoft Online Services. |
primaryBillingTenantId |
string |
Locataire utilisé pour configurer le compte de facturation. Par défaut, seuls les utilisateurs de ce locataire peuvent obtenir des attributions de rôles sur le compte de facturation et tous les achats sont provisionnés dans ce locataire. |
provisioningState |
État d’approvisionnement de la ressource pendant une opération de longue durée. |
|
qualifications |
string[] |
Qualifications pour la tarification sur un compte de facturation. Les valeurs peuvent être commerciales, éducatives, caritatives ou gouvernementales. |
registrationNumber |
Décrit le numéro d’inscription de l’organisation liée au compte de facturation. |
|
soldTo |
Adresse de la personne ou de l’organisation responsable du compte de facturation. |
|
taxIds |
Liste des identificateurs fiscaux pour le compte de facturation. |
BillingAccountStatusReasonCode
Motif de l’état du compte de facturation spécifié.
Nom | Type | Description |
---|---|---|
Expired |
string |
|
ManuallyTerminated |
string |
|
Other |
string |
|
TerminateProcessing |
string |
|
Transferred |
string |
|
UnusualActivity |
string |
BillingRelationshipType
Identifie les relations de facturation représentées par un compte de facturation. La relation de facturation peut être entre Microsoft, le client et/ou un tiers.
Nom | Type | Description |
---|---|---|
CSPCustomer |
string |
|
CSPPartner |
string |
|
Direct |
string |
|
IndirectCustomer |
string |
|
IndirectPartner |
string |
|
Other |
string |
createdByType
Type d’identité qui a créé la ressource.
Nom | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
EnrollmentDetails
Propriétés d’une inscription.
Nom | Type | Description |
---|---|---|
billingCycle |
string |
Cycle de facturation de l’inscription. |
channel |
string |
Type de canal de l’inscription. |
cloud |
string |
Cloud de l’inscription. |
countryCode |
string |
Code de pays de l’inscription. |
currency |
string |
Devise de facturation de l’inscription. |
endDate |
string |
Date de fin de l’inscription. |
extendedTermOption |
Extension de compte de facturation choisie par l’entreprise. |
|
indirectRelationshipInfo |
Propriétés d’une inscription qui s’appliquent uniquement aux inscriptions indirectes. |
|
invoiceRecipient |
string |
Contact qui reçoit les factures de l’inscription. |
language |
string |
Langue de l’inscription. |
markupStatus |
État du balisage de l’inscription, applicable uniquement aux inscriptions indirectes. |
|
poNumber |
string |
Numéro de bon de commande de l’inscription. |
startDate |
string |
Date de début de l’inscription. |
supportCoverage |
string |
Période de couverture du support pour l’inscription. |
supportLevel |
Offre de niveau de support associée à une inscription. |
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 |
Informations supplémentaires sur l’erreur. |
|
code |
string |
Code d’erreur. |
details |
Détails de l’erreur. |
|
message |
string |
Message d’erreur. |
target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
Nom | Type | Description |
---|---|---|
error |
Objet d’erreur. |
ExtendedTermOption
Extension de compte de facturation choisie par l’entreprise.
Nom | Type | Description |
---|---|---|
Opted-In |
string |
|
Opted-Out |
string |
|
Other |
string |
IndirectRelationshipInfo
Identifie le profil de facturation lié à un autre profil de facturation dans le mouvement d’achat indirect.
Nom | Type | Description |
---|---|---|
billingAccountName |
string |
Nom du compte de facturation du partenaire ou du client pour un mouvement indirect. |
billingProfileName |
string |
Nom du profil de facturation du partenaire ou du client pour un mouvement indirect. |
displayName |
string |
Nom complet du partenaire ou du client pour un mouvement indirect. |
MarkupStatus
État du balisage de l’inscription, applicable uniquement aux inscriptions indirectes.
Nom | Type | Description |
---|---|---|
Disabled |
string |
|
Locked |
string |
|
Other |
string |
|
Preview |
string |
|
Published |
string |
ProvisioningState
État d’approvisionnement de la ressource pendant une opération de longue durée.
Nom | Type | Description |
---|---|---|
Canceled |
string |
|
Failed |
string |
|
New |
string |
|
Pending |
string |
|
Provisioning |
string |
|
Succeeded |
string |
RegistrationNumber
Décrit le numéro d’inscription de l’organisation liée au compte de facturation.
Nom | Type | Description |
---|---|---|
id |
string |
Numéro d’identification unique de l’organisation lié au compte de facturation. |
required |
boolean |
Identifie si le numéro d’inscription est requis pour le compte de facturation. |
type |
string[] |
Types de numéro d’inscription autorisés en fonction du pays du compte de facturation. |
SoldTo
Adresse de la personne ou de l’organisation responsable du compte de facturation.
Nom | Type | Description |
---|---|---|
addressLine1 |
string |
Ligne d’adresse 1. |
addressLine2 |
string |
Ligne d’adresse 2. |
addressLine3 |
string |
Ligne d’adresse 3. |
city |
string |
Ville d’adresse. |
companyName |
string |
Nom de la société. Facultatif pour MCA Individuel (paiement à l’utilisation). |
country |
string |
Le code pays utilise le format ISO 3166-1 Alpha-2. |
district |
string |
District d’adresse. |
string |
Adresse courriel. |
|
firstName |
string |
Prénom. Facultatif pour MCA Enterprise. |
isValidAddress |
boolean |
Indique si l’adresse est incomplète. |
lastName |
string |
Nom. Facultatif pour MCA Enterprise. |
middleName |
string |
Prénom. |
phoneNumber |
string |
Numéro de téléphone. |
postalCode |
string |
Code postal. |
region |
string |
Région d’adresse. |
SupportLevel
Offre de niveau de support associée à une inscription.
Nom | Type | Description |
---|---|---|
Developer |
string |
|
Other |
string |
|
Pro-Direct |
string |
|
Standard |
string |
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 |
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 |
Type d’identité qui a modifié la ressource pour la dernière fois. |
TaxIdentifier
Identificateur fiscal du compte de facturation.
Nom | Type | Description |
---|---|---|
country |
string |
Pays de l’identificateur fiscal. |
id |
string |
ID de l’identificateur fiscal. |
scope |
string |
Étendue de l’identificateur fiscal. |
status |
État de l’identificateur fiscal. |
|
type |
Type de l’identificateur fiscal. |
TaxIdentifierStatus
État de l’identificateur fiscal.
Nom | Type | Description |
---|---|---|
Invalid |
string |
|
Other |
string |
|
Valid |
string |
TaxIdentifierType
Type de l’identificateur fiscal.
Nom | Type | Description |
---|---|---|
BrazilCcmId |
string |
|
BrazilCnpjId |
string |
|
BrazilCpfId |
string |
|
CanadianFederalExempt |
string |
|
CanadianProvinceExempt |
string |
|
ExternalTaxation |
string |
|
IndiaFederalServiceTaxId |
string |
|
IndiaFederalTanId |
string |
|
IndiaPanId |
string |
|
IndiaStateCstId |
string |
|
IndiaStateGstINId |
string |
|
IndiaStateVatId |
string |
|
IntlExempt |
string |
|
LoveCode |
string |
|
MobileBarCode |
string |
|
NationalIdentificationNumber |
string |
|
Other |
string |
|
PublicSectorId |
string |
|
USExempt |
string |
|
VatId |
string |