Billing Subscriptions - Get By Customer

Service:

Billing

API Version:

2019-10-01-preview

Obtiene una suscripción por su identificador. La operación solo se admite para las cuentas de facturación con el tipo de contrato Microsoft Partner Agreement.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/billingSubscriptions/{billingSubscriptionName}?api-version=2019-10-01-preview

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.
billingSubscriptionName	path	True	string	Identificador que identifica de forma única una suscripción.
customerName	path	True	string	Identificador que identifica de forma única a un cliente.
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 2019-10-01-preview.

Respuestas

Nombre	Tipo	Description
200 OK	BillingSubscription	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

BillingSubscriptionByCustomer

Sample Request

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/billingSubscriptions/{billingSubscriptionName}?api-version=2019-10-01-preview

Sample Response

Status code:

200

{
  "id": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/customers/{customerName}/billingSubscriptions/{billingSubscriptionName}",
  "name": "{billingSubscriptionName}",
  "type": "Microsoft.Billing/billingSubscriptions",
  "properties": {
    "displayName": "My Subscription",
    "subscriptionId": "6b96d3f2-9008-4a9d-912f-f87744185aa3",
    "subscriptionBillingStatus": "Active",
    "lastMonthCharges": {
      "currency": "USD",
      "value": 5000
    },
    "monthToDateCharges": {
      "currency": "USD",
      "value": 600
    },
    "customerId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}",
    "customerDisplayName": "Customer1",
    "reseller": {
      "resellerId": "3b65b5a8-bd4f-4084-90e9-e1bd667a2b19",
      "description": "Reseller2"
    },
    "skuId": "0002",
    "skuDescription": "Microsoft Azure Standard"
  }
}

Definiciones

Nombre	Description
Amount	Cantidad.
BillingSubscription	Una suscripción de facturación.
BillingSubscriptionStatusType	Estado de facturación actual de la suscripció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
Reseller	Detalles del revendedor.

Amount

Cantidad.

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

BillingSubscription

Una suscripción de facturación.

Nombre	Tipo	Description
id	string	Identificador de recurso.
name	string	Nombre del recurso.
properties.billingProfileDisplayName	string	Nombre del perfil de facturación al que se factura la suscripción.
properties.billingProfileId	string	Identificador del perfil de facturación al que se factura la suscripción.
properties.customerDisplayName	string	Nombre del cliente para el que se creó la suscripción. El campo solo es aplicable a la cuenta 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 la cuenta de facturación del Contrato de asociado de Microsoft.
properties.displayName	string	Nombre de la suscripción.
properties.invoiceSectionDisplayName	string	Nombre de la sección de factura a la que se factura la suscripción.
properties.invoiceSectionId	string	Identificador de la sección de factura a la que se factura la suscripción.
properties.lastMonthCharges	Amount	El último mes cobra.
properties.monthToDateCharges	Amount	Se cobra el mes actual hasta la fecha.
properties.reseller	Reseller	Revendedor de esta suscripción.
properties.skuDescription	string	Descripción de la SKU del plan de Azure para la suscripción.
properties.skuId	string	Identificador de SKU del plan de Azure para la suscripción.
properties.subscriptionBillingStatus	BillingSubscriptionStatusType	Estado de facturación actual de la suscripción.
properties.subscriptionId	string	Identificador de la suscripción.
type	string	Tipo de recurso.

BillingSubscriptionStatusType

Estado de facturación actual de la suscripción.

Nombre	Tipo	Description
Abandoned	string
Active	string
Deleted	string
Inactive	string
Warning	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

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.

Reseller

Detalles del revendedor.

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