Compartir a través de

Manage billing - Get a customer's utilization records for Azure

  • Referencia
Servicio:
Partner Center Rest
Versión de la API:
v1

Obtiene el uso de los recursos que pertenecen a una suscripción de Azure que pertenece a un cliente del asociado.

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure
Con parámetros opcionales: 
GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure?start_time={start_time}&end_time={end_time}&size={size}&granularity={granularity}&show_details={show_details}&seek_operation={seek_operation}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
customer_id
 path True

string

Identificador del cliente que posee la suscripción.
subscription_id
 path True

string

Identificador de la suscripción de Azure para la que se va a recuperar el uso.
end_time
 query

string

date-time

Hora de finalización de la medición del uso en el sistema de facturación.
granularity
 query

string

Granularidad del tiempo de uso de recursos. Puede ser diario o cada hora. Desfalte es diario.
seek_operation
 query

string

Operación de búsqueda que se va a realizar. Solo se admite Next.
show_details
 query

boolean

Si se establece en true, los registros de uso se dividirán por los niveles de instancia de recursos. Si se establece en false, los registros de uso se agregarán en el nivel de recurso. El valor predeterminado es true.
size
 query

integer

int32

Número máximo opcional de registros que se van a devolver. El valor predeterminado es 1000. La colección de recursos devuelta especificará un vínculo siguiente en caso de que haya más registros de uso disponibles.
start_time
 query

string

date-time

Hora de inicio de la medición del uso en el sistema de facturación.

Encabezado de la solicitud

Nombre Requerido Tipo Description
Authorization True

string

Token de portador de autorización
ms-correlationid

string

Se usa para realizar el seguimiento de las solicitudes internamente. Si no se proporciona un ms-correlationid, el servidor generará uno nuevo para cada solicitud.
ms-cv

string

Se usa para realizar el seguimiento de las solicitudes internamente. Si no se proporciona un ms-cv, el servidor generará uno nuevo para cada solicitud.
ms-requestid

string

Se usa para la idempoencia de las solicitudes. Si no se proporciona un ms-requestid, el servidor generará uno nuevo para cada solicitud.

Respuestas

Nombre Tipo Description
200 OK

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

La solicitud se realizó correctamente. El cuerpo de la respuesta contiene la colección de recursos de registros de uso de Azure.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
204 No Content

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

Los datos no están disponibles para la hora de inicio y finalización especificadas. No se devuelve ningún contenido con un encabezado retry-after.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
400 Bad Request

Faltaba o faltaba una entrada no válida. El cuerpo de la respuesta proporcionará los detalles del error.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
401 Unauthorized

La solicitud no se autenticó. El cliente debe autenticarse primero con el servicio de API del asociado.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
403 Forbidden

La solicitud se autenticó pero se rechazó, ya que el autor de la llamada no tiene los derechos para invocarla.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
404 Not Found

El recurso no se encuentra o no está disponible con los parámetros de entrada especificados.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
500 Internal Server Error

El servicio de API del asociado o una de sus dependencias no pudieron cumplir la solicitud. Los autores de llamadas pueden volver a intentarlo.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definiciones

Nombre Description
Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]
Link
ResourceAttributes
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]
Utilizations.AzureInstanceData
Utilizations.AzureResource
Utilizations.AzureUtilizationRecord

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

Nombre Tipo Description
attributes

ResourceAttributes

items

Utilizations.AzureUtilizationRecord[]

links

ResourceLinks

totalCount

integer

Nombre Tipo Description
headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

method

string

uri

string

ResourceAttributes

Nombre Tipo Description
etag

string

objectType

string

Nombre Tipo Description
next

Link

previous

Link

self

Link

System.Collections.Generic.KeyValuePair[System.String,System.String]

Nombre Tipo Description
key

string

value

string

Utilizations.AzureInstanceData

Nombre Tipo Description
additionalInfo

object

location

string

orderNumber

string

partNumber

string

resourceUri

string

tags

object

Utilizations.AzureResource

Nombre Tipo Description
category

string

id

string

name

string

region

string

subcategory

string

Utilizations.AzureUtilizationRecord

Nombre Tipo Description
attributes

ResourceAttributes

infoFields

object

instanceData

Utilizations.AzureInstanceData

quantity

number

resource

Utilizations.AzureResource

unit

string

usageEndTime

string

usageStartTime

string