- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Permisos de IAM
- Uso
Agrega el uso por instancia para una configuración.
Solicitud HTTP
GET https://licensemanager.googleapis.com/v1/{name=projects/*/locations/*/configurations/*}:aggregateUsage
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
name |
Obligatorio. Valor principal de AggregateUsageRequest |
Parámetros de consulta
Parámetros | |
---|---|
pageSize |
Opcional. Indica el tamaño de la página solicitada. Es posible que el servidor devuelva menos elementos de los solicitados. Si no se especifica, el servidor elegirá un valor predeterminado adecuado. |
pageToken |
Opcional. Es un token que identifica una página de resultados que debe devolver el servidor. |
filter |
Opcional. Filtra resultados |
orderBy |
Opcional. Sugerencia para ordenar los resultados |
startTime |
Obligatorio. Las licencias se compran por mes, por lo que el seguimiento del uso necesita la fecha de inicio de un mes. Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "Z". Ejemplos: |
endTime |
Obligatorio. El seguimiento del uso siempre es mensual. Este parámetro indica la hora de finalización del mes. Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "Z". Ejemplos: |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Mensaje de respuesta para agregar el recuento de uso
Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:
Representación JSON |
---|
{
"usages": [
{
object ( |
Campos | |
---|---|
usages[] |
Registros agregados del uso por configuración |
nextPageToken |
Es un token que identifica una página de resultados que debe devolver el servidor. |
unreachable[] |
Ubicaciones en las que no se pudo acceder. |
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/cloud-platform
Para obtener más información, consulta Authentication Overview.
Permisos de IAM
Se requiere el siguiente permiso de IAM en el recurso name
:
licensemanager.configurations.aggregateUsage
Para obtener más información, consulta la documentación de IAM.
Uso
Es un mensaje que describe los recuentos totales de usuarios que accedieron a una VM.
Representación JSON |
---|
{ "limaInstance": string, "users": integer } |
Campos | |
---|---|
limaInstance |
Nombre del recurso de la instancia de LiMa, es decir, projects/{project}/locations/{location}/instances/{instance} |
users |
Cantidad de usuarios únicos que acceden a la VM. |