- 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
- UserCountUsage
Es la información de uso de la licencia para una configuración.
Solicitud HTTP
GET https://licensemanager.googleapis.com/v1/{name=projects/*/locations/*/configurations/*}:queryLicenseUsage
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
name |
Obligatorio. Es la ruta de acceso al recurso de la configuración. |
Parámetros de consulta
Parámetros | |
---|---|
startTime |
Obligatorio. Es la fecha y hora de inicio para recuperar el uso. Si no se especifica, usaremos el primer día del período de facturación actual. 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. Es la fecha y hora de finalización para recuperar el uso. Si no se especifica, usaremos el último día del período de facturación actual. 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 para la respuesta que obtiene el uso de la licencia por configuración.
Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión details . Según el tipo de configuración, se completará uno de los siguientes campos. details puede ser solo uno de los siguientes: |
|
userCountUsage |
Es la información de uso para los tipos de licencias que utilizan la facturación por cantidad de usuarios. |
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.queryLicenseUsage
Para obtener más información, consulta la documentación de IAM.
UserCountUsage
Es un mensaje que representa el uso de las configuraciones de licencias que utilizan la facturación por cantidad de usuarios.
Representación JSON |
---|
{ "uniqueUserCount": integer } |
Campos | |
---|---|
uniqueUserCount |
Obligatorio. Cantidad única de usuarios con licencia. |