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.

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

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.

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

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

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.

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.

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.

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

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

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.

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