Partager via


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.

includeAll
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.

includeAllWithoutBillingProfiles
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.

includeDeleted
query

boolean

Lorsque la valeur est true, les résultats incluent tous les comptes de facturation dans un état supprimé.

includePendingAgreement
query

boolean

Inclut les comptes de facturation avec un contrat en attente de signature auquel l’utilisateur a accès.

includeResellee
query

boolean

Inclut le compte de facturation du client du Contrat Partenaire Microsoft auquel l’utilisateur a accès.

legalOwnerOID
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.

legalOwnerTID
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

BillingAccountListResult

Liste des comptes de facturation.

Other Status Codes

ErrorResponse

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

Exemples

BillingAccountForLegacyAccountDetails
BillingAccountsList
BillingAccountsListWithExpandForPONumber

BillingAccountForLegacyAccountDetails

Exemple de requête

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

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

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

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

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2024-04-01&expand=soldTo,enrollmentDetails/poNumber

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
AccountStatus

État actuel du compte de facturation.

AccountSubType

Niveau du compte.

AccountType

Type de client.

AgreementType

Type d’accord.

BillingAccount

Un compte de facturation.

BillingAccountListResult

Conteneur pour une liste de ressources

BillingAccountProperties

Un compte de facturation.

BillingAccountStatusReasonCode

Motif de l’état du compte de facturation spécifié.

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.

createdByType

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

EnrollmentDetails

Propriétés d’une inscription.

ErrorAdditionalInfo

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

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

ExtendedTermOption

Extension de compte de facturation choisie par l’entreprise.

IndirectRelationshipInfo

Identifie le profil de facturation lié à un autre profil de facturation dans le mouvement d’achat indirect.

MarkupStatus

État du balisage de l’inscription, applicable uniquement aux inscriptions indirectes.

ProvisioningState

État d’approvisionnement de la ressource pendant une opération de longue durée.

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.

SupportLevel

Offre de niveau de support associée à une inscription.

systemData

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

TaxIdentifier

Identificateur fiscal du compte de facturation.

TaxIdentifierStatus

État de l’identificateur fiscal.

TaxIdentifierType

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

BillingAccountProperties

Un compte de facturation.

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 »

BillingAccountListResult

Conteneur pour une liste de ressources

Nom Type Description
nextLink

string

Lien (URL) vers la page suivante des résultats.

value

BillingAccount[]

Liste des ressources.

BillingAccountProperties

Un compte de facturation.

Nom Type Description
accountStatus

AccountStatus

État actuel du compte de facturation.

accountStatusReasonCode

BillingAccountStatusReasonCode

Motif de l’état du compte de facturation spécifié.

accountSubType

AccountSubType

Niveau du compte.

accountType

AccountType

Type de client.

agreementType

AgreementType

Type d’accord.

billingRelationshipTypes

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.

displayName

string

Nom du compte de facturation.

enrollmentDetails

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

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

RegistrationNumber

Décrit le numéro d’inscription de l’organisation liée au compte de facturation.

soldTo

SoldTo

Adresse de la personne ou de l’organisation responsable du compte de facturation.

taxIds

TaxIdentifier[]

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

ExtendedTermOption

Extension de compte de facturation choisie par l’entreprise.

indirectRelationshipInfo

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

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

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

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.

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.

email

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

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.

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

TaxIdentifierStatus

État de l’identificateur fiscal.

type

TaxIdentifierType

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