Billing Accounts - List
Enumera las cuentas de facturación a las que un usuario tiene acceso.
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}
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
api-version
|
query | True |
string |
Versión de la API que se va a usar con la solicitud de cliente. La versión actual es 2024-04-01. |
expand
|
query |
string |
Se permite expandir para SoldTo e EnrollmentDetails/PONumber. |
|
filter
|
query |
string |
La opción de consulta de filtro permite a los clientes filtrar una colección de recursos que se abordan mediante una dirección URL de solicitud. |
|
include
|
query |
boolean |
Cuando es true, los resultados incluirán cuentas de facturación en las que el usuario no tiene una asignación de roles directa si el usuario tiene uno de los siguientes roles de AAD: Administrador global, Lector global, Administrador de facturación. |
|
include
|
query |
boolean |
Cuando es true, los resultados incluirán cuentas de facturación que no se crean completamente si el usuario tiene uno de los siguientes roles de AAD: Administrador global, Lector global, Administrador de facturación. |
|
include
|
query |
boolean |
Cuando es true, los resultados incluirán todas las cuentas de facturación en un estado eliminado. |
|
include
|
query |
boolean |
Incluye cuentas de facturación con contrato pendiente de firma a la que el usuario tiene acceso. |
|
include
|
query |
boolean |
Incluye la cuenta de facturación del cliente del Contrato de partner de Microsoft a la que el usuario tiene acceso. |
|
legal
|
query |
string |
Debe combinarse con legalOwnerTID, los resultados solo incluirán cuentas de facturación para las que sea legalmente responsable de las cuentas de facturación. Opcional. |
|
legal
|
query |
string |
Debe combinarse con legalOwnerOID, los resultados solo incluirán cuentas de facturación para las que sea legalmente responsable de las cuentas de facturación. Opcional. |
|
search
|
query |
string |
La opción de consulta de búsqueda permite a los clientes solicitar elementos dentro de una colección que coincida con una expresión de búsqueda de texto libre. la búsqueda solo se admite para campos de cadena. |
|
skip
|
query |
integer int64 |
La opción omitir consulta solicita el número de elementos de la colección consultada que se omitirán y no se incluirán en el resultado. |
|
top
|
query |
integer int64 |
La opción de consulta superior solicita el número de elementos de la colección consultada que se incluirán en el resultado. El valor máximo admitido para top es 50. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Lista de cuentas de facturación. |
|
Other Status Codes |
Respuesta de error que describe por qué se produjo un error en la operación. |
Ejemplos
Billing |
Billing |
Billing |
BillingAccountForLegacyAccountDetails
Solicitud de ejemplo
Respuesta de muestra
{
"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
Solicitud de ejemplo
Respuesta de muestra
{
"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
Solicitud de ejemplo
Respuesta de muestra
{
"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"
}
}
]
}
Definiciones
Nombre | Description |
---|---|
Account |
Estado actual de la cuenta de facturación. |
Account |
Nivel de la cuenta. |
Account |
Tipo de cliente. |
Agreement |
Tipo de contrato. |
Billing |
Una cuenta de facturación. |
Billing |
Un contenedor para obtener una lista de recursos |
Billing |
Una cuenta de facturación. |
Billing |
Motivo del estado de la cuenta de facturación especificado. |
Billing |
Identifica las relaciones de facturación representadas por una cuenta de facturación. La relación de facturación puede estar entre Microsoft, el cliente o un tercero. |
created |
Tipo de identidad que creó el recurso. |
Enrollment |
Propiedades de una inscripción. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Extended |
La extensión de la cuenta de facturación optó por la empresa. |
Indirect |
Identifica el perfil de facturación que está vinculado a otro perfil de facturación en movimiento de compra indirecto. |
Markup |
Estado de marcado de la inscripción, aplicable solo a las inscripciones indirectas. |
Provisioning |
Estado de aprovisionamiento del recurso durante una operación de ejecución prolongada. |
Registration |
Describe el número de registro de la organización vinculada a la cuenta de facturación. |
Sold |
Dirección de la persona u organización responsable de la cuenta de facturación. |
Support |
Oferta de nivel de soporte técnico asociada a una inscripción. |
system |
Metadatos relativos a la creación y última modificación del recurso. |
Tax |
Identificador fiscal de la cuenta de facturación. |
Tax |
Estado del identificador fiscal. |
Tax |
Tipo del identificador fiscal. |
AccountStatus
Estado actual de la cuenta de facturación.
Nombre | Tipo | Description |
---|---|---|
Active |
string |
|
Deleted |
string |
|
Disabled |
string |
|
Expired |
string |
|
Extended |
string |
|
New |
string |
|
Other |
string |
|
Pending |
string |
|
Terminated |
string |
|
Transferred |
string |
|
UnderReview |
string |
AccountSubType
Nivel de la cuenta.
Nombre | Tipo | Description |
---|---|---|
Enterprise |
string |
|
Individual |
string |
|
None |
string |
|
Other |
string |
|
Professional |
string |
AccountType
Tipo de cliente.
Nombre | Tipo | Description |
---|---|---|
Business |
string |
|
ClassicPartner |
string |
|
Enterprise |
string |
|
Individual |
string |
|
Internal |
string |
|
Other |
string |
|
Partner |
string |
|
Reseller |
string |
|
Tenant |
string |
AgreementType
Tipo de contrato.
Nombre | Tipo | Description |
---|---|---|
EnterpriseAgreement |
string |
|
MicrosoftCustomerAgreement |
string |
|
MicrosoftOnlineServicesProgram |
string |
|
MicrosoftPartnerAgreement |
string |
|
Other |
string |
BillingAccount
Una cuenta de facturación.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Nombre del recurso |
properties |
Una cuenta de facturación. |
|
systemData |
Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy. |
|
tags |
object |
Diccionario de metadatos asociados al recurso. Es posible que no se rellene para todos los tipos de recursos. Longitud máxima de clave/valor admitida de 256 caracteres. Las claves y el valor no deben estar vacíos ni null. Las claves no pueden contener <> % & \ ? / |
type |
string |
Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
BillingAccountListResult
Un contenedor para obtener una lista de recursos
Nombre | Tipo | Description |
---|---|---|
nextLink |
string |
Vínculo (url) a la página siguiente de resultados. |
value |
Lista de recursos. |
BillingAccountProperties
Una cuenta de facturación.
Nombre | Tipo | Description |
---|---|---|
accountStatus |
Estado actual de la cuenta de facturación. |
|
accountStatusReasonCode |
Motivo del estado de la cuenta de facturación especificado. |
|
accountSubType |
Nivel de la cuenta. |
|
accountType |
Tipo de cliente. |
|
agreementType |
Tipo de contrato. |
|
billingRelationshipTypes |
Identifica las relaciones de facturación representadas por una cuenta de facturación. La relación de facturación puede estar entre Microsoft, el cliente o un tercero. |
|
displayName |
string |
Nombre de la cuenta de facturación. |
enrollmentDetails |
Propiedades de una inscripción. |
|
hasNoBillingProfiles |
boolean |
Indica si la cuenta de facturación tiene o no perfiles de facturación. |
hasReadAccess |
boolean |
Indica si el usuario tiene acceso de lectura a la cuenta de facturación. |
notificationEmailAddress |
string |
Dirección de correo electrónico de notificación para la cuenta heredada. Disponible para el tipo de contrato Microsoft Online Services Program. |
primaryBillingTenantId |
string |
Inquilino que se usó para configurar la cuenta de facturación. De forma predeterminada, solo los usuarios de este inquilino pueden obtener asignaciones de roles en la cuenta de facturación y todas las compras se aprovisionan en este inquilino. |
provisioningState |
Estado de aprovisionamiento del recurso durante una operación de ejecución prolongada. |
|
qualifications |
string[] |
Calificaciones para los precios en una cuenta de facturación. Los valores pueden ser Comercial, Educación, Caridad o Gobierno. |
registrationNumber |
Describe el número de registro de la organización vinculada a la cuenta de facturación. |
|
soldTo |
Dirección de la persona u organización responsable de la cuenta de facturación. |
|
taxIds |
Lista de identificadores fiscales para la cuenta de facturación. |
BillingAccountStatusReasonCode
Motivo del estado de la cuenta de facturación especificado.
Nombre | Tipo | Description |
---|---|---|
Expired |
string |
|
ManuallyTerminated |
string |
|
Other |
string |
|
TerminateProcessing |
string |
|
Transferred |
string |
|
UnusualActivity |
string |
BillingRelationshipType
Identifica las relaciones de facturación representadas por una cuenta de facturación. La relación de facturación puede estar entre Microsoft, el cliente o un tercero.
Nombre | Tipo | Description |
---|---|---|
CSPCustomer |
string |
|
CSPPartner |
string |
|
Direct |
string |
|
IndirectCustomer |
string |
|
IndirectPartner |
string |
|
Other |
string |
createdByType
Tipo de identidad que creó el recurso.
Nombre | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
EnrollmentDetails
Propiedades de una inscripción.
Nombre | Tipo | Description |
---|---|---|
billingCycle |
string |
Ciclo de facturación de la inscripción. |
channel |
string |
Tipo de canal de la inscripción. |
cloud |
string |
La nube de la inscripción. |
countryCode |
string |
Código de país de la inscripción. |
currency |
string |
Moneda de facturación de la inscripción. |
endDate |
string |
Fecha de finalización de la inscripción. |
extendedTermOption |
La extensión de la cuenta de facturación optó por la empresa. |
|
indirectRelationshipInfo |
Las propiedades de una inscripción que solo son aplicables a las inscripciones indirectas. |
|
invoiceRecipient |
string |
Contacto que recibe facturas de la inscripción. |
language |
string |
Idioma de la inscripción. |
markupStatus |
Estado de marcado de la inscripción, aplicable solo a las inscripciones indirectas. |
|
poNumber |
string |
Número de pedido de compra de la inscripción. |
startDate |
string |
Fecha de inicio de la inscripción. |
supportCoverage |
string |
Período de cobertura de soporte técnico para la inscripción. |
supportLevel |
Oferta de nivel de soporte técnico asociada a una inscripción. |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Detalles del error. |
|
message |
string |
Mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
ExtendedTermOption
La extensión de la cuenta de facturación optó por la empresa.
Nombre | Tipo | Description |
---|---|---|
Opted-In |
string |
|
Opted-Out |
string |
|
Other |
string |
IndirectRelationshipInfo
Identifica el perfil de facturación que está vinculado a otro perfil de facturación en movimiento de compra indirecto.
Nombre | Tipo | Description |
---|---|---|
billingAccountName |
string |
Nombre de la cuenta de facturación del asociado o del cliente para un movimiento indirecto. |
billingProfileName |
string |
Nombre del perfil de facturación del asociado o del cliente para un movimiento indirecto. |
displayName |
string |
Nombre para mostrar del asociado o cliente para un movimiento indirecto. |
MarkupStatus
Estado de marcado de la inscripción, aplicable solo a las inscripciones indirectas.
Nombre | Tipo | Description |
---|---|---|
Disabled |
string |
|
Locked |
string |
|
Other |
string |
|
Preview |
string |
|
Published |
string |
ProvisioningState
Estado de aprovisionamiento del recurso durante una operación de ejecución prolongada.
Nombre | Tipo | Description |
---|---|---|
Canceled |
string |
|
Failed |
string |
|
New |
string |
|
Pending |
string |
|
Provisioning |
string |
|
Succeeded |
string |
RegistrationNumber
Describe el número de registro de la organización vinculada a la cuenta de facturación.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Número de identificación único de la organización vinculada a la cuenta de facturación. |
required |
boolean |
Identifica si el número de registro es necesario para la cuenta de facturación. |
type |
string[] |
Los tipos de número de registro permitidos en función del país de la cuenta de facturación. |
SoldTo
Dirección de la persona u organización responsable de la cuenta de facturación.
Nombre | Tipo | Description |
---|---|---|
addressLine1 |
string |
Línea de dirección 1. |
addressLine2 |
string |
Línea de dirección 2. |
addressLine3 |
string |
Línea de dirección 3. |
city |
string |
Ciudad de dirección. |
companyName |
string |
Nombre de la compañía. Opcional para MCA Individual (pago por uso). |
country |
string |
El código de país usa el formato ISO 3166-1 Alpha-2. |
district |
string |
Distrito de direcciones. |
string |
Dirección de correo electrónico. |
|
firstName |
string |
Nombre. Opcional para MCA Enterprise. |
isValidAddress |
boolean |
Indica si la dirección está incompleta. |
lastName |
string |
Apellido. Opcional para MCA Enterprise. |
middleName |
string |
Segundo nombre. |
phoneNumber |
string |
Número de teléfono. |
postalCode |
string |
Código postal. |
region |
string |
Región de direcciones. |
SupportLevel
Oferta de nivel de soporte técnico asociada a una inscripción.
Nombre | Tipo | Description |
---|---|---|
Developer |
string |
|
Other |
string |
|
Pro-Direct |
string |
|
Standard |
string |
systemData
Metadatos relativos a la creación y última modificación del recurso.
Nombre | Tipo | Description |
---|---|---|
createdAt |
string |
Marca de tiempo de creación de recursos (UTC). |
createdBy |
string |
Identidad que creó el recurso. |
createdByType |
Tipo de identidad que creó el recurso. |
|
lastModifiedAt |
string |
Marca de tiempo de la última modificación del recurso (UTC) |
lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |
TaxIdentifier
Identificador fiscal de la cuenta de facturación.
Nombre | Tipo | Description |
---|---|---|
country |
string |
País del identificador fiscal. |
id |
string |
Identificador del identificador fiscal. |
scope |
string |
Ámbito del identificador fiscal. |
status |
Estado del identificador fiscal. |
|
type |
Tipo del identificador fiscal. |
TaxIdentifierStatus
Estado del identificador fiscal.
Nombre | Tipo | Description |
---|---|---|
Invalid |
string |
|
Other |
string |
|
Valid |
string |
TaxIdentifierType
Tipo del identificador fiscal.
Nombre | Tipo | 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 |