- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Faça um teste
Filtra os recursos de uma organização e os agrupa por propriedades especificadas.
Solicitação HTTP
Os URLs usam a sintaxe de Transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
parent |
Obrigatório. O nome do elemento pai para agrupar os recursos. O formato é |
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
Representação JSON |
---|
{ "filter": string, "groupBy": string, "compareDuration": string, "readTime": string, "pageToken": string, "pageSize": integer } |
Campos | |
---|---|
filter |
Expressão que define o filtro a ser aplicado aos recursos. A expressão é uma lista de zero ou mais restrições combinadas pelos operadores lógicos As restrições têm a forma
Os operadores compatíveis são:
Os tipos de valor aceitos são:
As seguintes combinações de campos e operadores são compatíveis:
Uso: milissegundos desde a época ou uma string RFC3339. Exemplos:
Uso: milissegundos desde a época ou uma string RFC3339. Exemplos:
Por exemplo, Use uma correspondência parcial na string vazia para filtrar com base em uma propriedade existente: Use uma correspondência parcial negada na string vazia para filtrar com base em uma propriedade que não existe: |
groupBy |
Obrigatório. Expressão que define quais campos de recursos usar para agrupamento. O valor da string precisa seguir a sintaxe SQL: lista de campos separada por vírgulas. Por exemplo: "securityCenterProperties.resource_project,securityCenterProperties.project". Os seguintes campos são aceitos quando compareDuration não está definido:
Os seguintes campos são aceitos quando compareDuration é definido:
|
compareDuration |
Quando compareDuration é definido, a propriedade "stateChange" do GroupResult é atualizada para indicar se o recurso foi adicionado, removido ou permaneceu presente durante o período de compareDuration que precede o readTime. Esse é o tempo entre (readTime - compareDuration) e readTime. O valor da mudança de estado é derivado com base na presença do recurso nos dois pontos no tempo. As mudanças de estado intermediárias entre os dois momentos não afetam o resultado. Por exemplo, os resultados não são afetados se o recurso for removido e recriado novamente. Valores possíveis de "stateChange" quando compareDuration é especificado:
Se compareDuration não for especificado, o único stateChange possível será "UNUSED", que será o stateChange definido para todos os recursos presentes em readTime. Se esse campo for definido, Duração em segundos com até nove dígitos fracionários, terminando em " |
readTime |
Tempo usado como ponto de referência ao filtrar recursos. O filtro é limitado aos recursos existentes no momento fornecido, e os valores são aqueles no momento específico. A ausência desse campo vai usar a versão da API do NOW. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
pageToken |
O valor retornado pelo último |
pageSize |
O número máximo de resultados a serem retornados em uma única resposta. O padrão é 10, o mínimo é 1 e o máximo é 1.000. |
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de GroupAssetsResponse
.
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/cloud-platform
Para mais informações, consulte Authentication Overview.