Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
El término proveedor se aplica al administrador de servicios y a cualquier proveedor delegado. Los operadores de Azure Stack Hub y los proveedores delegados pueden usar la API de uso del proveedor para ver el uso de sus inquilinos directos. Por ejemplo, como se muestra en el diagrama siguiente, P0 puede llamar a la API de proveedor para obtener información del uso directo de P1 y P2, y P1 puede llamar para obtener información de uso sobre P3 y P4.
Referencia de llamadas API
Solicitud
La solicitud obtiene detalles de consumo para las suscripciones y el período de tiempo solicitados. No hay ningún cuerpo de solicitud.
Esta API de uso es una API de proveedor, por lo que al autor de la llamada se le debe asignar un rol Propietario, Colaborador o Lector en la suscripción del proveedor.
| Método | Solicitud de URI |
|---|---|
| OBTENER | https://{armendpoint}/subscriptions/{subId}/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={reportedStartTime}&reportedEndTime={reportedEndTime}&aggregationGranularity={granularity}&subscriberId={sub1.1}&api-version=2015-06-01-preview&continuationToken={token-value} |
Argumentos
| Argumento | Descripción |
|---|---|
armendpoint |
Punto de conexión de Azure Resource Manager del entorno de Azure Stack Hub. La norma en Azure Stack Hub es que el nombre del punto de conexión de Azure Resource Manager esté en el formato https://adminmanagement.{domain-name}. Por ejemplo, para el Kit de desarrollo de Azure Stack (ASDK), si el nombre de dominio es local.azurestack.external, el punto de conexión de Resource Manager es https://adminmanagement.local.azurestack.external. |
subId |
Identificador de suscripción del usuario que realiza la llamada. |
reportedStartTime |
Hora de inicio de la consulta. El valor de DateTime debe estar en formato Hora universal coordinada (UTC) y al principio de la hora, por ejemplo, 13:00. Para la agregación diaria, establezca este valor en la medianoche de la hora UTC. El formato es de escape ISO 8601; por ejemplo, 2015-06-16T18%3a53%3a11%2b00%3a00Z, donde los dos puntos se escapan a %3a y el signo más se escapa para %2b que sea fácil de usar el URI. |
reportedEndTime |
Hora de finalización de la consulta. Las restricciones que se aplican a reportedStartTime también se aplican a este argumento. El valor de reportedEndTime no puede ser una fecha futura ni la actual. Si es así, el resultado se establece en "el procesamiento no está completo". |
aggregationGranularity |
Parámetro opcional que tiene dos valores discretos posibles: a diario y cada hora. Como sugieren los valores, uno devuelve los datos con una especificidad diaria y el otro es una resolución por horas. La opción diaria es el valor predeterminado. |
subscriberId |
Id. de suscripción. Para obtener los datos filtrados, es necesario el identificador de suscripción de un inquilino directo del proveedor. Si no se especifica ningún parámetro de identificador de suscripción, la llamada devuelve los datos de uso para todos los inquilinos directos del proveedor. |
api-version |
Versión del protocolo que se usa para realizar esta solicitud. Este valor se establece en 2015-06-01-preview. |
continuationToken |
Token recuperado en la última llamada al proveedor de la API de uso. Este token es necesario cuando una respuesta supera las 1000 líneas. Actúa como un marcador para el progreso. Si el token no está presente, los datos se recuperan desde el principio del día o de la hora, según la especificidad pasada. |
Respuesta
GET
/subscriptions/sub1/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime=reportedStartTime=2014-05-01T00%3a00%3a00%2b00%3a00&reportedEndTime=2015-06-01T00%3a00%3a00%2b00%3a00&aggregationGranularity=Daily&subscriberId=sub1.1&api-version=1.0
{
"value": [
{
"id":
"/subscriptions/sub1.1/providers/Microsoft.Commerce.Admin/UsageAggregate/sub1.1-
meterID1",
"name": "sub1.1-meterID1",
"type": "Microsoft.Commerce.Admin/UsageAggregate",
"properties": {
"subscriptionId":"sub1.1",
"usageStartTime": "2015-03-03T00:00:00+00:00",
"usageEndTime": "2015-03-04T00:00:00+00:00",
"instanceData":"{\"Microsoft.Resources\":{\"resourceUri\":\"resourceUri1\",\"location\":\"Alaska\",\"tags\":null,\"additionalInfo\":null}}",
"quantity":2.4000000000,
"meterId":"meterID1"
}
},
. . .
Detalles de la respuesta
| Argumento | Descripción |
|---|---|
id |
Identificador único del agregado de uso. |
name |
Nombre del agregado de uso. |
type |
Definición de recursos. |
subscriptionId |
Identificador de la suscripción del usuario de Azure Stack Hub. |
usageStartTime |
Hora de inicio UTC del depósito de uso al que pertenece este agregado de uso. |
usageEndTime |
Hora de finalización UTC del depósito de uso al que pertenece este agregado de uso. |
instanceData |
Pares de clave y valor de los detalles de la instancia (con un formato nuevo):resourceUri: identificador de recurso completo, que incluye los grupos de recursos y el nombre de la instancia. location: región en la que se ejecutó este servicio. tags: etiquetas del recurso especificadas por el usuario. additionalInfo: más detalles sobre el recurso que se consumió; por ejemplo, el tipo de imagen o versión de sistema operativo. |
quantity |
Cantidad de consumo de recursos que se produjo en este período de tiempo. |
meterId |
Identificador único del recurso que se consumió (también denominado ResourceID). |
Recuperar información de utilización
PowerShell
Para generar los datos de uso, debe tener recursos que se ejecutan y usan activamente el sistema; por ejemplo, una máquina virtual activa o una cuenta de almacenamiento que contiene algunos datos. Si no está seguro de si tiene recursos que se ejecutan en Marketplace de Azure Stack Hub, implemente una máquina virtual y compruebe la hoja de supervisión de la máquina virtual para asegurarse de que se está ejecutando. Use los siguientes cmdlets de PowerShell para ver los datos de utilización:
Configure el usuario de Azure Stack Hub o el entorno de PowerShell del operador de Azure Stack Hub .
Para recuperar los datos de uso, llame al cmdlet Get-AzsSubscriberUsage de PowerShell:
Get-AzsSubscriberUsage -ReportedStartTime "2017-09-06T00:00:00Z" -ReportedEndTime "2017-09-07T00:00:00Z"
REST API
Puede recopilar información de uso de las suscripciones eliminadas llamando al servicio Microsoft.Commerce.Admin .
Devolver todo el uso del inquilino para los usuarios activos eliminados
| Método | Solicitud de URI |
|---|---|
| OBTENER | https://{armendpoint}/subscriptions/{subId}/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&api-version=2015-06-01-preview |
Devolución del uso para inquilinos eliminados o activos
| Método | Solicitud de URI |
|---|---|
| OBTENER | https://{armendpoint}/subscriptions/{subId}/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&subscriberId={subscriber-id}&api-version=2015-06-01-preview |
Pasos siguientes
- Referencia de api de uso de recursos de inquilino
- Usage-related FAQ (P+F relacionadas con la utilización)