Method: projects.locations.configurations.aggregateUsage

Agrega el uso por instancia de una configuración.

Solicitud HTTP

GET https://licensemanager.googleapis.com/v1/{name=projects/*/locations/*/configurations/*}:aggregateUsage

La URL utiliza la sintaxis de transcodificación a gRPC.

Parámetros de ruta

Parámetros
name

string

Obligatorio. Valor principal de AggregateUsageRequest

Los parámetros de consulta

Parámetros
pageSize

integer

Opcional. Tamaño de la página solicitado. El servidor puede devolver menos elementos de los solicitados. Si no se especifica, el servidor elegirá un valor predeterminado adecuado.
pageToken

string

Opcional. Un token con el que se identifica la página de resultados que el servidor debería devolver.
filter

string

Opcional. Filtrar resultados
orderBy

string

Opcional. Pista sobre cómo ordenar los resultados.
startTime

string (Timestamp format)

Obligatorio. Las licencias se compran por mes, por lo que el seguimiento del uso necesita la hora de inicio de un mes.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Obligatorio. El seguimiento del uso siempre es mensual. Este parámetro corresponde a la hora de finalización del mes.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

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 la solicitud se realiza correctamente, el cuerpo de la respuesta proporciona datos con la siguiente estructura:

Representación JSON 
{
  "usages": [
    {
      object (Usage)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
usages[]

object (Usage)

Registros agregados del uso por configuración
nextPageToken

string

Un token con el que se identifica la página de resultados que el servidor debería devolver.
unreachable[]

string

Ubicaciones a las que no se ha podido acceder.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta el Authentication Overview.

Permisos de IAM

Requiere el siguiente permiso de gestión de identidades y accesos en el recurso name:

  • licensemanager.configurations.aggregateUsage

Para obtener más información, consulta la documentación de gestión de identidades y accesos.

Uso

Mensaje que describe el número total de usuarios que han accedido a una máquina virtual.

Representación JSON 
{
  "limaInstance": string,
  "users": integer
}
Campos
limaInstance

string

Nombre de recurso de la instancia de LiMa, es decir, projects/{project}/locations/{location}/instances/{instance}
users

integer

Número de usuarios únicos que acceden a la máquina virtual.