Billing Subscriptions - List By Billing Account

Referencia

Service:: Billing

API Version:: 2021-10-01

Enumera las suscripciones de una cuenta de facturación. Actualmente, la operación se admite para las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft, el Contrato de asociado de Microsoft y el Programa de Servicios en línea de Microsoft.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions?api-version=2021-10-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
billingAccountName	path	True	string	Identificador que identifica de forma única una cuenta de facturación.
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 2021-10-01.

Respuestas

Nombre	Tipo	Description
200 OK	BillingSubscriptionsListResult	Aceptar. La solicitud se ha realizado correctamente.
Other Status Codes	ErrorResponse	Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

BillingSubscriptionsListByBillingAccount

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions?api-version=2021-10-01

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Billing;

// Generated from example definition: specification/billing/resource-manager/Microsoft.Billing/stable/2021-10-01/examples/BillingSubscriptionsListByBillingAccount.json
// this example is just showing the usage of "BillingSubscriptions_ListByBillingAccount" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this TenantResource created on azure
// for more information of creating TenantResource, please refer to the document of TenantResource
var tenantResource = client.GetTenants().GetAllAsync().GetAsyncEnumerator().Current;

// get the collection of this BillingSubscriptionResource
string billingAccountName = "{billingAccountName}";
BillingSubscriptionCollection collection = tenantResource.GetBillingSubscriptions(billingAccountName);

// invoke the operation and iterate over the result
await foreach (BillingSubscriptionResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    BillingSubscriptionData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine($"Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "totalCount": 3,
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingSubscriptions/418b0e9c-5dc3-4260-918f-30b90619fe07",
      "name": "418b0e9c-5dc3-4260-918f-30b90619fe07",
      "type": "Microsoft.Billing/billingAccounts/billingSubscriptions",
      "properties": {
        "autoRenew": "Off",
        "billingFrequency": "P1M",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/2b72f936-0166-47d6-91a3-ef9f84f36664",
        "billingProfileDisplayName": "Contoso operations billing profile",
        "billingProfileName": "2b72f936-0166-47d6-91a3-ef9f84f36664",
        "displayName": "Subscription 1",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/2b72f936-0166-47d6-91a3-ef9f84f36664/invoiceSections/5c562559-e31b-4bfe-b608-f8b5b3fbd073",
        "invoiceSectionDisplayName": "Contoso operations invoice section",
        "invoiceSectionName": "5c562559-e31b-4bfe-b608-f8b5b3fbd073",
        "lastMonthCharges": {
          "currency": "USD",
          "value": 5000
        },
        "monthToDateCharges": {
          "currency": "USD",
          "value": 600
        },
        "productCategory": "UsageBased",
        "productType": "Usage based",
        "productTypeId": "DZH318Z0BPS6",
        "purchaseDate": "2021-10-01T00:00:00Z",
        "quantity": 1,
        "skuId": "0001",
        "skuDescription": "Microsoft Azure Plan",
        "status": "Active",
        "subscriptionId": "6b96d3f2-9008-4a9d-912f-f87744185aa3"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingSubscriptions/9e030ae5-51ed-4e02-8e17-d51b3aa55980",
      "name": "9e030ae5-51ed-4e02-8e17-d51b3aa55980",
      "type": "Microsoft.Billing/billingAccounts/billingSubscriptions",
      "properties": {
        "autoRenew": "Off",
        "billingFrequency": "P1M",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/2b72f936-0166-47d6-91a3-ef9f84f36664",
        "billingProfileDisplayName": "Contoso operations billing profile",
        "billingProfileName": "2b72f936-0166-47d6-91a3-ef9f84f36664",
        "displayName": "Subscription 2",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/2b72f936-0166-47d6-91a3-ef9f84f36664/invoiceSections/5c562559-e31b-4bfe-b608-f8b5b3fbd073",
        "invoiceSectionDisplayName": "Contoso operations invoice section",
        "invoiceSectionName": "5c562559-e31b-4bfe-b608-f8b5b3fbd073",
        "lastMonthCharges": {
          "currency": "USD",
          "value": 1000
        },
        "monthToDateCharges": {
          "currency": "USD",
          "value": 400
        },
        "productCategory": "UsageBased",
        "productType": "Usage based",
        "productTypeId": "DZH318Z0BPS6",
        "purchaseDate": "2021-10-01T00:00:00Z",
        "quantity": 1,
        "skuId": "0001",
        "skuDescription": "Microsoft Azure Plan",
        "status": "Active",
        "subscriptionId": "6b96d3f2-9008-4a9d-912f-6b96d3f2"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}billingSubscriptions/7f271b5e-a89e-45cc-8fa5-cd5c643f8b5e",
      "name": "7f271b5e-a89e-45cc-8fa5-cd5c643f8b5e",
      "type": "Microsoft.Billing/billingAccounts/billingSubscriptions",
      "properties": {
        "autoRenew": "Off",
        "billingFrequency": "P1M",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/2b72f936-0166-47d6-91a3-ef9f84f36664",
        "billingProfileDisplayName": "Contoso operations billing profile",
        "billingProfileName": "2b72f936-0166-47d6-91a3-ef9f84f36664",
        "displayName": "Subscription 3",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/2b72f936-0166-47d6-91a3-ef9f84f36664/invoiceSections/5c562559-e31b-4bfe-b608-f8b5b3fbd0730",
        "invoiceSectionDisplayName": "Contoso operations invoice section",
        "invoiceSectionName": "5c562559-e31b-4bfe-b608-f8b5b3fbd073",
        "lastMonthCharges": {
          "currency": "USD",
          "value": 6000
        },
        "monthToDateCharges": {
          "currency": "USD",
          "value": 900
        },
        "productCategory": "SeatBased",
        "productType": "Microsoft 365 Business Standard",
        "productTypeId": "CFQ7TTC0LDPB",
        "purchaseDate": "2021-08-01T00:12:49.7261677+00:00",
        "quantity": 4,
        "skuId": "0001",
        "skuDescription": "Microsoft 365 Business Standard",
        "status": "Active",
        "termDuration": "P1Y",
        "termStartDate": "2021-10-01T00:00:00Z",
        "termEndDate": "2022-09-30T00:00:00Z"
      }
    }
  ]
}

Definiciones

Nombre	Description
Amount	Cantidad.
AutoRenew	Indica si la renovación automática está activada o desactivada para una suscripción.
BillingSubscription	Una suscripción de facturación.
BillingSubscriptionsListResult	Lista de suscripciones de facturación.
BillingSubscriptionStatus	Estado de la suscripción. Este campo no está disponible para Enterprise Agreement cuentas de facturación.
ErrorDetails	Detalles del error.
ErrorResponse	La respuesta de error indica que el servicio no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error.
ErrorSubDetails	Los detalles secundarios del error.
NextBillingCycleDetails	Los detalles del siguiente ciclo de facturación de la suscripción.
RenewalTermDetails	Detalles del término de la suscripción en renovación.
Reseller	Detalles del revendedor.
SubscriptionEnrollmentAccountStatus	Estado de la cuenta de inscripción actual de la suscripción. Este campo solo está disponible para las cuentas de facturación de Enterprise Agreement.

Amount

Cantidad.

Nombre	Tipo	Description
currency	string	Moneda del valor de la cantidad.
value	number	Valor de cantidad.

AutoRenew

Indica si la renovación automática está activada o desactivada para una suscripción.

Nombre	Tipo	Description
Off	string
On	string

BillingSubscription

Una suscripción de facturación.

Nombre	Tipo	Description
id	string	Identificador de recurso.
name	string	Nombre del recurso.
properties.autoRenew	AutoRenew	Indica si la renovación automática está activada o desactivada para una suscripción.
properties.beneficiaryTenantId	string	Inquilino de aprovisionamiento de la suscripción.
properties.billingFrequency	string	Frecuencia de facturación de la suscripción en formato ISO8601. Ejemplo: P1M, P3M, P1Y
properties.billingPolicies	object	Diccionario de directivas de facturación asociadas a la suscripción.
properties.billingProfileDisplayName	string	Nombre para mostrar del perfil de facturación al que se factura la suscripción. Este campo solo es aplicable a Contrato de cliente de Microsoft cuentas de facturación.
properties.billingProfileId	string	Identificador del perfil de facturación al que se factura la suscripción. Este campo solo es aplicable a Contrato de cliente de Microsoft cuentas de facturación.
properties.billingProfileName	string	Nombre del perfil de facturación al que se factura la suscripción. Este campo solo es aplicable a Contrato de cliente de Microsoft cuentas de facturación.
properties.consumptionCostCenter	string	Centro de costos aplicado a la suscripción. Este campo solo está disponible para suscripciones de consumo de cuentas de facturación de tipo Contrato de cliente de Microsoft.
properties.customerDisplayName	string	Nombre del cliente para el que se creó la suscripción. El campo solo es aplicable a las cuentas de facturación del Contrato de asociado de Microsoft.
properties.customerId	string	Identificador del cliente para el que se creó la suscripción. El campo solo es aplicable a las cuentas de facturación del Contrato de asociado de Microsoft.
properties.customerName	string	Nombre del cliente para el que se creó la suscripción. El campo solo es aplicable a las cuentas de facturación del Contrato de asociado de Microsoft.
properties.displayName	string	Nombre de la suscripción.
properties.enrollmentAccountDisplayName	string	El nombre de la cuenta de inscripción asociado a la suscripción. Este campo solo está disponible para las cuentas de facturación de Enterprise Agreement.
properties.enrollmentAccountId	string	Identificador de cuenta de inscripción asociado a la suscripción. Este campo solo está disponible para las cuentas de facturación de Enterprise Agreement.
properties.enrollmentAccountSubscriptionDetails.enrollmentAccountStartDate	string	La cuenta de inscripción y la fecha de inicio de la asociación de suscripción. Este campo solo está disponible para las cuentas de facturación de Enterprise Agreement.
properties.enrollmentAccountSubscriptionDetails.subscriptionEnrollmentAccountStatus	SubscriptionEnrollmentAccountStatus	Estado de la cuenta de inscripción actual de la suscripción. Este campo solo está disponible para las cuentas de facturación de Enterprise Agreement.
properties.invoiceSectionDisplayName	string	Nombre para mostrar de la sección de factura a la que se factura la suscripción. El campo solo es aplicable a las cuentas de facturación del Contrato de asociado de Microsoft.
properties.invoiceSectionId	string	Identificador de la sección de factura a la que se factura la suscripción. El campo solo es aplicable a las cuentas de facturación del Contrato de asociado de Microsoft.
properties.invoiceSectionName	string	Nombre de la sección de factura a la que se factura la suscripción. El campo solo es aplicable a las cuentas de facturación del Contrato de asociado de Microsoft.
properties.lastMonthCharges	Amount	Los cargos del último mes. Este campo solo está disponible para las suscripciones basadas en el uso de Contrato de cliente de Microsoft cuentas de facturación.
properties.monthToDateCharges	Amount	Se cobra el mes actual hasta la fecha. Este campo solo está disponible para las suscripciones basadas en el uso de Contrato de cliente de Microsoft cuentas de facturación.
properties.nextBillingCycleDetails	NextBillingCycleDetails	Detalles del siguiente ciclo de facturación de la suscripción.
properties.offerId	string	Identificador de la oferta de la suscripción. Este campo solo está disponible para las cuentas de facturación del Programa Microsoft Online Services.
properties.productCategory	string	Categoría del producto para el que se compra la suscripción. Entre los valores posibles se incluyen: AzureSupport, Hardware, ReservationOrder, SaaS, SavingsPlanOrder, Software, UsageBased, Other
properties.productType	string	Tipo del producto para el que se adquiere la suscripción.
properties.productTypeId	string	Identificador del producto para el que se compra la suscripción.
properties.purchaseDate	string	Fecha de compra de la suscripción en hora UTC.
properties.quantity	integer	Número de licencias adquiridas para la suscripción
properties.renewalTermDetails	RenewalTermDetails	Detalles del término de la suscripción en la siguiente renovación.
properties.reseller	Reseller	Revendedor para el que se crea la suscripción. El campo está disponible para las cuentas de facturación del Contrato de asociado de Microsoft.
properties.skuDescription	string	Descripción de la SKU del producto para el que se adquiere la suscripción. Este campo solo está disponible para Contrato de cliente de Microsoft cuentas de facturación.
properties.skuId	string	Identificador de SKU del producto para el que se adquiere la suscripción. Este campo solo está disponible para Contrato de cliente de Microsoft cuentas de facturación.
properties.status	BillingSubscriptionStatus	Estado de la suscripción. Este campo no está disponible para Enterprise Agreement cuentas de facturación.
properties.subscriptionId	string	Identificador de la suscripción basada en el uso. Este campo solo está disponible para las suscripciones basadas en el uso de Contrato de cliente de Microsoft cuentas de facturación.
properties.suspensionReasons	string[]	Motivo de suspensión de la suscripción. Este campo no está disponible para Enterprise Agreement cuentas de facturación.
properties.termDuration	string	Duración durante la que puede usar la suscripción. Ejemplo P1Y y P1M
properties.termEndDate	string	Fecha de finalización del término en hora UTC.
properties.termStartDate	string	Fecha de inicio del término en hora UTC.
type	string	Tipo de recurso.

BillingSubscriptionsListResult

Lista de suscripciones de facturación.

Nombre	Tipo	Description
nextLink	string	Vínculo (url) a la página siguiente de resultados.
totalCount	number	Número total de registros.
value	BillingSubscription[]	Lista de suscripciones de facturación.

BillingSubscriptionStatus

Estado de la suscripción. Este campo no está disponible para Enterprise Agreement cuentas de facturación.

Nombre	Tipo	Description
Active	string
AutoRenew	string
Cancelled	string
Deleted	string
Disabled	string
Expired	string
Expiring	string
Suspended	string
Unknown	string
Warned	string

ErrorDetails

Detalles del error.

Nombre	Tipo	Description
code	string	Código de error.
details	ErrorSubDetails[]	Los detalles secundarios del error.
message	string	Mensaje de error que indica por qué se produjo un error en la operación.
target	string	Destino del error determinado.

ErrorResponse

La respuesta de error indica que el servicio no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error.

Nombre	Tipo	Description
error	ErrorDetails	Detalles del error.

ErrorSubDetails

Los detalles secundarios del error.

Nombre	Tipo	Description
code	string	Código de error.
message	string	Mensaje de error que indica por qué se produjo un error en la operación.
target	string	Destino del error determinado.

NextBillingCycleDetails

Los detalles del siguiente ciclo de facturación de la suscripción.

Nombre	Tipo	Description
billingFrequency	string	Frecuencia de facturación de la suscripción en el siguiente ciclo de facturación.

RenewalTermDetails

Detalles del término de la suscripción en renovación.

Nombre	Tipo	Description
billingFrequency	string	Frecuencia de facturación de la suscripción.
productTypeId	string	Identificador del producto.
quantity	integer	El número de licencias
skuId	string	Identificador de SKU del producto
termDuration	string	Duración del período de la suscripción. Ejemplo P1M y P1Y

Reseller

Detalles del revendedor.

Nombre	Tipo	Description
description	string	Nombre del revendedor.
resellerId	string	Identificador de MPN del revendedor.

SubscriptionEnrollmentAccountStatus

Estado de la cuenta de inscripción actual de la suscripción. Este campo solo está disponible para las cuentas de facturación de Enterprise Agreement.

Nombre	Tipo	Description
Active	string
Cancelled	string
Deleted	string
Expired	string
TransferredOut	string
Transferring	string