Manage billing - Get a customer's utilization records for Azure
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/azureGET 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 propietario de 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 diaria o cada hora. El desfalto 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 idempotencia 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. |
La solicitud fue correcta. 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. |
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 de 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 de 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
Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]
| Nombre | Tipo | Description |
|---|---|---|
| attributes | ||
| items | ||
| links | ||
| totalCount |
integer |
Link
| Nombre | Tipo | Description |
|---|---|---|
| headers |
System. |
|
| method |
string |
|
| uri |
string |
ResourceAttributes
| Nombre | Tipo | Description |
|---|---|---|
| etag |
string |
|
| objectType |
string |
ResourceLinks
| Nombre | Tipo | Description |
|---|---|---|
| next | ||
| previous | ||
| self |
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 | ||
| infoFields |
object |
|
| instanceData | ||
| quantity |
number |
|
| resource | ||
| unit |
string |
|
| usageEndTime |
string |
|
| usageStartTime |
string |