Compartir a través de


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.

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

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

includeDeleted
query

boolean

Cuando es true, los resultados incluirán todas las cuentas de facturación en un estado eliminado.

includePendingAgreement
query

boolean

Incluye cuentas de facturación con contrato pendiente de firma a la que el usuario tiene acceso.

includeResellee
query

boolean

Incluye la cuenta de facturación del cliente del Contrato de partner de Microsoft a la que el usuario tiene acceso.

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

legalOwnerTID
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

BillingAccountListResult

Lista de cuentas de facturación.

Other Status Codes

ErrorResponse

Respuesta de error que describe por qué se produjo un error en la operación.

Ejemplos

BillingAccountForLegacyAccountDetails
BillingAccountsList
BillingAccountsListWithExpandForPONumber

BillingAccountForLegacyAccountDetails

Solicitud de ejemplo

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

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

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

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

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

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
AccountStatus

Estado actual de la cuenta de facturación.

AccountSubType

Nivel de la cuenta.

AccountType

Tipo de cliente.

AgreementType

Tipo de contrato.

BillingAccount

Una cuenta de facturación.

BillingAccountListResult

Un contenedor para obtener una lista de recursos

BillingAccountProperties

Una cuenta de facturación.

BillingAccountStatusReasonCode

Motivo del estado de la cuenta de facturación especificado.

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.

createdByType

Tipo de identidad que creó el recurso.

EnrollmentDetails

Propiedades de una inscripción.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

ExtendedTermOption

La extensión de la cuenta de facturación optó por la empresa.

IndirectRelationshipInfo

Identifica el perfil de facturación que está vinculado a otro perfil de facturación en movimiento de compra indirecto.

MarkupStatus

Estado de marcado de la inscripción, aplicable solo a las inscripciones indirectas.

ProvisioningState

Estado de aprovisionamiento del recurso durante una operación de ejecución prolongada.

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.

SupportLevel

Oferta de nivel de soporte técnico asociada a una inscripción.

systemData

Metadatos relativos a la creación y última modificación del recurso.

TaxIdentifier

Identificador fiscal de la cuenta de facturación.

TaxIdentifierStatus

Estado del identificador fiscal.

TaxIdentifierType

Tipo del identificador fiscal.

AccountStatus

Estado actual de la cuenta de facturación.

Valor Description
Active
Deleted
Disabled
Expired
Extended
New
Other
Pending
Terminated
Transferred
UnderReview

AccountSubType

Nivel de la cuenta.

Valor Description
Enterprise
Individual
None
Other
Professional

AccountType

Tipo de cliente.

Valor Description
Business
ClassicPartner
Enterprise
Individual
Internal
Other
Partner
Reseller
Tenant

AgreementType

Tipo de contrato.

Valor Description
EnterpriseAgreement
MicrosoftCustomerAgreement
MicrosoftOnlineServicesProgram
MicrosoftPartnerAgreement
Other

BillingAccount

Una cuenta de facturación.

Nombre Tipo Description
id

string (arm-id)

Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nombre del recurso

properties

BillingAccountProperties

Una cuenta de facturación.

systemData

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

BillingAccount[]

Lista de recursos.

BillingAccountProperties

Una cuenta de facturación.

Nombre Tipo Description
accountStatus

AccountStatus

Estado actual de la cuenta de facturación.

accountStatusReasonCode

BillingAccountStatusReasonCode

Motivo del estado de la cuenta de facturación especificado.

accountSubType

AccountSubType

Nivel de la cuenta.

accountType

AccountType

Tipo de cliente.

agreementType

AgreementType

Tipo de contrato.

billingRelationshipTypes

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.

displayName

string

Nombre de la cuenta de facturación.

enrollmentDetails

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

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

RegistrationNumber

Describe el número de registro de la organización vinculada a la cuenta de facturación.

soldTo

SoldTo

Dirección de la persona u organización responsable de la cuenta de facturación.

taxIds

TaxIdentifier[]

Lista de identificadores fiscales para la cuenta de facturación.

BillingAccountStatusReasonCode

Motivo del estado de la cuenta de facturación especificado.

Valor Description
Expired
ManuallyTerminated
Other
TerminateProcessing
Transferred
UnusualActivity

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.

Valor Description
CSPCustomer
CSPPartner
Direct
IndirectCustomer
IndirectPartner
Other

createdByType

Tipo de identidad que creó el recurso.

Valor Description
Application
Key
ManagedIdentity
User

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 (date-time)

Fecha de finalización de la inscripción.

extendedTermOption

ExtendedTermOption

La extensión de la cuenta de facturación optó por la empresa.

indirectRelationshipInfo

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

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 (date-time)

Fecha de inicio de la inscripción.

supportCoverage

string

Período de cobertura de soporte técnico para la inscripción.

supportLevel

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

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

Mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

ExtendedTermOption

La extensión de la cuenta de facturación optó por la empresa.

Valor Description
Opted-In
Opted-Out
Other

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.

Valor Description
Disabled
Locked
Other
Preview
Published

ProvisioningState

Estado de aprovisionamiento del recurso durante una operación de ejecución prolongada.

Valor Description
Canceled
Failed
New
Pending
Provisioning
Succeeded

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

minLength: 1

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

minLength: 1

El código de país usa el formato ISO 3166-1 Alpha-2.

district

string

Distrito de direcciones.

email

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.

Valor Description
Developer
Other
Pro-Direct
Standard

systemData

Metadatos relativos a la creación y última modificación del recurso.

Nombre Tipo Description
createdAt

string (date-time)

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string (date-time)

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

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

TaxIdentifierStatus

Estado del identificador fiscal.

type

TaxIdentifierType

Tipo del identificador fiscal.

TaxIdentifierStatus

Estado del identificador fiscal.

Valor Description
Invalid
Other
Valid

TaxIdentifierType

Tipo del identificador fiscal.

Valor Description
BrazilCcmId
BrazilCnpjId
BrazilCpfId
CanadianFederalExempt
CanadianProvinceExempt
ExternalTaxation
IndiaFederalServiceTaxId
IndiaFederalTanId
IndiaPanId
IndiaStateCstId
IndiaStateGstINId
IndiaStateVatId
IntlExempt
LoveCode
MobileBarCode
NationalIdentificationNumber
Other
PublicSectorId
USExempt
VatId