Method: projects.locations.configurations.aggregateUsage

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

string

Obligatorio. Valor principal de AggregateUsageRequest

Parámetros de consulta

Parámetros
pageSize

integer

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

string

Opcional. Es un token que identifica una página de resultados que debe devolver el servidor.

filter

string

Opcional. Filtra resultados

orderBy

string

Opcional. Sugerencia para ordenar los resultados

startTime

string (Timestamp format)

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: "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 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: "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 se ejecuta correctamente, el cuerpo de la respuesta contiene 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

Es un token que identifica una página de resultados que debe devolver el servidor.

unreachable[]

string

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

string

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

users

integer

Cantidad de usuarios únicos que acceden a la VM.