- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de autorización
- Pruébalo
Filtra los recursos de una organización y los agrupa según sus propiedades especificadas.
Solicitud HTTP
Las URL usan la sintaxis de transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
parent |
Obligatorio. Es el nombre de la organización para agrupar. Su formato es "organizations/[organization_id], folders/[folder_id] o projects/[projectId]". |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "filter": string, "groupBy": string, "compareDuration": string, "readTime": string, "pageToken": string, "pageSize": integer } |
Campos | |
---|---|
filter |
Es una expresión que define el filtro que se aplicará a todos los recursos. La expresión es una lista de cero o más restricciones combinadas a través de los operadores lógicos Las restricciones tienen el formato
Los operadores admitidos son los siguientes:
Los tipos de valores admitidos son los siguientes:
Se admiten las siguientes combinaciones de campos y operadores:
Uso: Debe ser una cadena RFC3339 o milisegundos desde la época. Ejemplos:
Uso: Debe ser una cadena RFC3339 o milisegundos desde la época. Ejemplos:
Por ejemplo, Usa una coincidencia parcial en la cadena vacía para filtrar según una propiedad existente: Usa una concordancia parcial negada en la cadena vacía para filtrar según una propiedad que no existe: |
groupBy |
Obligatorio. Es una expresión que define qué campos de recursos se deben usar para el agrupamiento. El valor de cadena debe seguir la sintaxis de SQL: lista de campos separados por comas. Por ejemplo: "securityCenterProperties.resource_project,securityCenterProperties.project". Los siguientes campos son compatibles cuando no se establece compareDuration:
Los siguientes campos son compatibles cuando se establece compareDuration:
|
compareDuration |
Cuando se establece compareDuration, se actualiza la propiedad "stateChange" de GroupResult para indicar si el recurso se agregó, quitó o permaneció presente durante el período de compareDuration que precede a readTime. Es el tiempo entre (readTime - compareDuration) y readTime. El valor del cambio de estado se obtiene en función de la presencia del recurso en los dos momentos. Los cambios de estado intermedios entre los dos momentos no afectan el resultado. Por ejemplo, los resultados no se ven afectados si se quita el recurso y se vuelve a crear. Valores posibles de "stateChange" cuando se especifica compareDuration:
Si no se especifica compareDuration, el único stateChange posible es "UNUSED", que será el stateChange establecido para todos los recursos presentes en readTime. Si se establece este campo, Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
readTime |
Es la hora que se usa como punto de referencia cuando se filtran los recursos. El filtro se limita a los activos que existen en el momento proporcionado y sus valores son los de ese momento específico. Si no se incluye este campo, se usará la versión de NOW de la API de forma predeterminada. Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
pageToken |
El valor que muestra el último |
pageSize |
Es la cantidad máxima de resultados que se mostrarán en una sola respuesta. El valor predeterminado es 10, el mínimo es 1 y el máximo es 1, 000. |
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de GroupAssetsResponse
.
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.