A API Cloud Asset permite usar uma linguagem de consulta personalizada para consultar metadados de recursos em um projeto, pasta ou organização.
Antes de começar
- Ative a API Cloud Asset no projeto.
- Conceda a permissão
cloudasset.assets.searchAllResources
à conta de usuário ou de serviço que faz a solicitação. Essa permissão está incluída em papéis básicos e predefinidos listados emRoles
.
Pesquisar recursos
Console
Para pesquisar todos os recursos, conclua as etapas a seguir.
Acesse a página Inventário de recursos no console.
Acessar a página Inventário de recursosPara definir o escopo da pesquisa, abra a caixa de lista Projetos na barra de menus e selecione a organização, a pasta ou o projeto a ser consultado.
Selecione a guia Recurso.
Para pesquisar recursos, insira o texto da consulta na barra Filtro. Selecione a caixa de texto, e uma lista de campos pesquisáveis será exibida. A pesquisa de recursos aceita vários campos. Saiba mais sobre Sintaxe de consulta.
Os resultados da pesquisa também podem ser filtrados com os filtros predefinidos Tipo de recurso, Projeto e Local no painel Resultados do filtro..
Os recursos correspondentes à consulta são listados na tabela Resultado.
Para ver a consulta como um comando da CLI do Google Cloud, selecione Ver consulta.
Para exportar os resultados, selecione Fazer o download do CSV.
gcloud
É possível chamar SearchAllResources
usando o
comando
gcloud asset search-all-resources
. É preciso executar a CLI do Google Cloud versão 302.0.0 ou mais recente. Para verificar
sua versão, use o comando gcloud version
.
gcloud asset search-all-resources \ --scope=SCOPE \ --query=QUERY \ --asset-types=ASSET_TYPES,… \ --order-by=ORDER_BY \ --page-size=PAGE_SIZE \ --read-mask=READ_MASK
Em que todas as sinalizações a seguir são opcionais:
(Opcional) SCOPE: um escopo pode ser um projeto, uma pasta ou uma organização. A pesquisa é limitada aos recursos do Google Cloud nesse escopo. O autor da chamada precisa receber a permissão
cloudasset.assets.searchAllResources
no escopo pretendido. Se não for especificada, a propriedade do projeto configurada será usada. Para encontrar o projeto configurado, execute:gcloud config get-value project
. Para alterar a configuração, execute:gcloud config set project PROJECT_ID
.Os valores permitidos são:
projects/PROJECT_ID
(ex., "projects/foo-bar
")projects/PROJECT_NUMBER
(ex., "projects/12345678
")folders/FOLDER_NUMBER
(ex., "folders/1234567
")organizations/ORGANIZATION_NUMBER
(ex., "organizations/123456
")
(Opcional) QUERY: a instrução de consulta. Veja como criar uma consulta para mais informações. Se não for especificado ou estiver vazio, ele pesquisará todos os recursos na
scope
especificada.Exemplos:
name:Important
para encontrar recursos do Google Cloud cujo nome contenha a palavra "Importante".name=Important
para encontrar o recurso do Google Cloud cujo nome é exatamente "Importante".displayName:Impor*
para encontrar recursos do Google Cloud com um nome de exibição que contenha "Impor" como prefixo de qualquer palavra.location:us-west*
para encontrar recursos do Google Cloud em que o local tenha duas palavras com "us" e "west" como prefixos.labels:prod
para encontrar recursos do Google Cloud que tenham um rótulo em que a chave ou o valor contém a palavra "prod".labels.env:prod
para encontrar recursos do Google Cloud que tenham um rótulo em que a chave é "env" e o valor contém a palavra "prod".labels.env:*
para encontrar recursos do Google Cloud que tenham um rótulo em que a chave é "env".tagKeys:env
para encontrar recursos do Google Cloud anexados diretamente às tags em que oTagKey
é usado.namespacedName
contém "env".tagValues:prod*
para encontrar recursos do Google Cloud anexados diretamente às tags em que oTagValue
é usado.namespacedName
contém uma palavra prefixada por "prod".tagValueIds=tagValues/123
para encontrar recursos do Google Cloud que são anexados diretamente a tags em que oTagValue
.name
é exatamente "tagValues/123".kmsKey:key
para encontrar recursos do Google Cloud criptografados com uma chave de criptografia gerenciada pelo cliente com um nome que contenha "key" como palavra.relationships:instance-group-1
para encontrar recursos do Google Cloud que têm relações com "instance-group-1" no nome de recurso relacionado.relationships:INSTANCE_TO_INSTANCEGROUP
para encontrar instâncias do Compute Engine que tenham relações do tipo "quoquo;INSTANCE_TO_INSTANCEGROUP"relationships.INSTANCE_TO_INSTANCEGROUP:instance-group-1
para encontrar instâncias do Compute Engine que têm relações com "instance-group-1" no nome de recurso do grupo de instâncias do Compute Engine, para o tipo de relação "INSTANCE_TO_INSTANCEGROUP".state:ACTIVE
para encontrar recursos do Google Cloud em que o estado contenha "ACTIVE" como palavra.NOT state:ACTIVE
para encontrar recursos do Google Cloud em que o estado não contenha "ACTIVE" como palavra.createTime<1609459200
,createTime<2021-01-01
oucreateTime<"2021-01-01T00:00:00"
para encontrar recursos do Google Cloud criados antes de "2021-01-01 00:00:00 UTC". 1609459200 é o carimbo de data/hora da época em segundos de "2021-01-01 00:00:00 UTC".updateTime>1609459200
ouupdateTime>2021-01-01
ouupdateTime>"2021-01-01T00:00:00"
para encontrar recursos do Google Cloud atualizados após "2021-01-01 00:00:00 UTC". 1609459200 é o carimbo de data/hora da época em segundos de "2021-01-01 00:00:00 UTC".project:12345
para encontrar recursos do Google Cloud que pertencem a um projeto com o número 12345.folders:(123 or 456)
para encontrar recursos do Google Cloud que pertencem a uma pasta do Google Cloud com os números 123 ou 456.organization:123
para encontrar recursos do Google Cloud que pertencem a uma organização do Google Cloud com o número 123.parentFullResourceName:ImportantName
para encontrar recursos do Google Cloud com um nome pai que contémImportantName
.parentAssetType:Project
para encontrar recursos do Google Cloud com um tipo de recurso pai que contémProject
.Important
para encontrar recursos do Google Cloud que contenham a palavra "Importante" em qualquer um dos campos pesquisáveis.Impor*
para encontrar recursos do Google Cloud que contêm "Impor" como prefixo de qualquer palavra em qualquer um dos campos pesquisáveis.Important location:(us-west1 OR global)
para encontrar recursos do Google Cloud que contêm a palavra "Important" em qualquer campo pesquisável e também estão localizados na região "us-west1" ou no local "global".
(Opcional) ASSET_TYPES: uma lista de tipos de recursos que essa solicitação está pesquisando. Se estiver vazia, ela vai pesquisar todos os tipos de recursos pesquisáveis. Expressões regulares também são aceitas. Exemplo:
"compute.googleapis.com.*"
tira snapshots de recursos em que o tipo de recurso começa com"compute.googleapis.com"
.".*Instance"
tira snapshots de recursos em que o tipo de recurso termina com"Instance"
.".*Instance.*"
tira snapshots de recursos em que o tipo de recurso contém"Instance"
.
Consulte RE2 para ver todas as sintaxes de expressão regular aceitas. Se a expressão regular não corresponder a nenhum tipo de recurso aceito, um erro
INVALID_ARGUMENT
vai ser retornado.(Opcional) ORDER_BY: uma lista de campos separada por vírgulas que especifica a ordem de classificação dos resultados. A ordem padrão é crescente. Adicione
" DESC"
depois do nome do campo para indicar a ordem decrescente. Caracteres de espaço redundantes são ignorados. Exemplo:"location DESC, name"
. Somente os campos primitivos singulares na resposta são classificáveis:name
assetType
project
displayName
description
location
kmsKey
createTime
updateTime
state
parentFullResourceName
parentAssetType
Os demais campos, como os repetidos (por exemplo,
networkTags
), de mapa (por exemplo,labels
) e de estrutura (por exemplo,additionalAttributes
), não são aceitos.(Opcional) PAGE_SIZE: o tamanho da página para a paginação de resultados da pesquisa. O valor máximo é 500. Se o valor for
0
, um padrão apropriado será escolhido;(Opcional) READ_MASK: uma lista separada por vírgulas de campos especificando quais campos devem ser retornados nos resultados. Se não for especificado, todos os campos, exceto
versionedResources
, vão ser retornados. Se apenas"*"
for especificado, todos os campos vão ser retornados. Exemplos:"name,location"
,"name,versionedResources"
,"*"
.
Veja a seguir exemplos de comandos do gcloud
:
Encontre todos os recursos em "
organizations/123456
" em quename
contenha a palavramycompany
:gcloud asset search-all-resources \ --scope='organizations/123456' \ --query='name:mycompany'
Encontre todos os recursos em "
organizations/123456
" em quename
contenha a palavramycompany
, com metadados completos incluídos:gcloud asset search-all-resources \ --scope='organizations/123456' \ --query='name:mycompany' \ --read-mask='*'
api
Você pode chamar SearchAllResources
usando um token OAuth válido para um projeto.
Para chamar o método SearchAllResources
do Cloud Shell ou qualquer
console em que o comando gcloud
esteja disponível:
Se você ainda não configurou a tela de consentimento do OAuth do seu projeto, precisará fazê-lo. É necessário informar um endereço de e-mail e o nome do produto para a tela de consentimento do OAuth.
- Acesse a tela de consentimento OAuth
do seu projeto.
Configurar tela de consentimento - Digite o Nome do aplicativo que você quer exibir.
- Em E-mail de suporte, selecione o endereço de e-mail que você quer exibir como um contato público. Precisa ser o seu endereço de e-mail ou um grupo do Google que pertença a você.
- Adicione os detalhes opcionais que você quiser.
- Clique em Salvar.
- Acesse a tela de consentimento OAuth
do seu projeto.
Crie um token OAuth para seu projeto. Para ver mais informações, consulte Como configurar o OAuth 2.0.
- Acesse a página Criar ID do cliente OAuth.
Criar cliente OAuth - Selecione App para computador como o Tipo de aplicativo.
- Clique em Criar.
- Acesse a página Criar ID do cliente OAuth.
Faça o download do arquivo
client_secret.json
.- Acesse a página Credenciais.
- À direita de seu novo ID do cliente, clique em Fazer o download do JSON.
- Armazene com segurança o arquivo em um local que somente o app possa acessar.
Faça login usando o arquivo JSON com o seguinte comando:
gcloud auth application-default login --client-id-file=YOUR_JSON_FILE
Esse comando solicitará que você abra um link. Verifique se o Nome do aplicativo definido na tela de consentimento do OAuth é exibido.
Gere um token de autenticação para sua conta com o seguinte comando:
TOKEN=$(gcloud auth application-default print-access-token)
Agora é possível consultar recursos usando os comandos do
curl
.PAGE_SIZE=PAGE_SIZE PAGE_TOKEN="PAGE_TOKEN" SCOPE="SCOPE" QUERY="QUERY" ASSET_TYPES="ASSET_TYPES,…" ORDER_BY="ORDER_BY" READ_MASK="READ_MASK" curl -s -G \ -H "Authorization: Bearer $TOKEN" \ -d "page_size=$PAGE_SIZE" \ -d "page_token=$PAGE_TOKEN" \ -d "scope=$SCOPE" \ -d "asset_types=$ASSET_TYPES" \ -d "order_by=$ORDER_BY" \ -d "read_mask=$READ_MASK" \ --data-urlencode "query=$QUERY" \ "https://cloudasset.googleapis.com/v1/$SCOPE:searchAllResources"
Em que todas as sinalizações a seguir são opcionais:
SCOPE: é obrigatório. Um escopo pode ser um projeto, uma pasta ou uma organização. A pesquisa é limitada aos recursos do Google Cloud nesse escopo. O autor da chamada precisa receber a permissão
cloudasset.assets.searchAllResources
no escopo pretendido.Os valores permitidos são:
projects/PROJECT_ID
(ex., "projects/foo-bar
")projects/PROJECT_NUMBER
(ex., "projects/12345678
")folders/FOLDER_NUMBER
(ex., "folders/1234567
")organizations/ORGANIZATION_NUMBER
(ex., "organizations/123456
")
(Opcional) QUERY: a instrução de consulta. Veja como criar uma consulta para mais informações. Se não for especificado ou estiver vazio, ele pesquisará todos os recursos na
scope
especificada.Exemplos:
name:Important
para encontrar recursos do Google Cloud cujo nome contenha a palavra "Importante".name=Important
para encontrar o recurso do Google Cloud cujo nome é exatamente "Importante".displayName:Impor*
para encontrar recursos do Google Cloud com um nome de exibição que contenha "Impor" como prefixo de qualquer palavra.location:us-west*
para encontrar recursos do Google Cloud em que o local contenha "us" e "west" como prefixos.labels:prod
para encontrar recursos do Google Cloud que tenham um rótulo em que a chave ou o valor contém a palavra "prod".labels.env:prod
para encontrar recursos do Google Cloud que tenham um rótulo em que a chave é "env" e o valor contém a palavra "prod".labels.env:*
para encontrar recursos do Google Cloud que tenham um rótulo em que a chave é "env".tagKeys:env
para encontrar recursos do Google Cloud anexados diretamente às tags em que oTagKey
é usado.namespacedName
contém "env".tagValues:prod*
para encontrar recursos do Google Cloud anexados diretamente às tags em que oTagValue
é usado.namespacedName
contém uma palavra prefixada por "prod".tagValueIds=tagValues/123
para encontrar recursos do Google Cloud que são anexados diretamente a tags em que oTagValue
.name
é exatamente "tagValues/123".kmsKey:key
para encontrar recursos do Google Cloud criptografados com uma chave de criptografia gerenciada pelo cliente com um nome que contenha "key" como palavra.relationships:instance-group-1
para encontrar recursos do Google Cloud que têm relações com "instance-group-1" no nome de recurso relacionado.relationships:INSTANCE_TO_INSTANCEGROUP
para encontrar instâncias do Compute Engine que têm relações do tipo "INSTANCE_TO_INSTANCEGROUP"relationships.INSTANCE_TO_INSTANCEGROUP:instance-group-1
para encontrar instâncias do Compute Engine que têm relações com "instance-group-1" no nome de recurso do grupo de instâncias do Compute Engine, para o tipo de relação "INSTANCE_TO_INSTANCEGROUP".state:ACTIVE
para encontrar recursos do Google Cloud em que o estado contenha "ACTIVE" como palavra.NOT state:ACTIVE
para encontrar recursos do Google Cloud em que o estado não contenha "ACTIVE" como palavra.createTime<1609459200
,createTime<2021-01-01
oucreateTime<"2021-01-01T00:00:00"
para encontrar recursos do Google Cloud criados antes de "2021-01-01 00:00:00 UTC". 1609459200 é o carimbo de data/hora da época em segundos de "2021-01-01 00:00:00 UTC".updateTime>1609459200
ouupdateTime>2021-01-01
ouupdateTime>"2021-01-01T00:00:00"
para encontrar recursos do Google Cloud atualizados após "2021-01-01 00:00:00 UTC". 1609459200 é o carimbo de data/hora da época em segundos de "2021-01-01 00:00:00 UTC".project:12345
para encontrar recursos do Google Cloud que pertencem a um projeto com o número 12345.folders:(123 or 456)
para encontrar recursos do Google Cloud que pertencem a uma pasta do Google Cloud com os números 123 ou 456.organization:123
para encontrar recursos do Google Cloud que pertencem a uma organização do Google Cloud com o número 123.parentFullResourceName:ImportantName
para encontrar recursos do Google Cloud com um nome pai que contémImportantName
.parentAssetType:Project
para encontrar recursos do Google Cloud com um tipo de recurso pai que contémProject
.Important
para encontrar recursos do Google Cloud que contenham a palavra "Importante" em qualquer um dos campos pesquisáveis.Impor*
para encontrar recursos do Google Cloud que contêm "Impor" como prefixo de qualquer palavra em qualquer um dos campos pesquisáveis.Important location:(us-west1 OR global)
para encontrar recursos do Google Cloud que contêm a palavra "Important" em qualquer campo pesquisável e também estão localizados na região "us-west1" ou no local "global".
(Opcional) ASSET_TYPES: uma lista de tipos de recursos que essa solicitação está pesquisando. Se estiver vazia, ela vai pesquisar todos os tipos de recursos pesquisáveis. Expressões regulares também são aceitas. Exemplo:
"compute.googleapis.com.*"
tira snapshots de recursos em que o tipo de recurso começa com"compute.googleapis.com"
.".*Instance"
tira snapshots de recursos em que o tipo de recurso termina com"Instance"
.".*Instance.*"
tira snapshots de recursos em que o tipo de recurso contém"Instance"
.
Consulte RE2 para ver todas as sintaxes de expressão regular aceitas. Se a expressão regular não corresponder a nenhum tipo de recurso aceito, um erro
INVALID_ARGUMENT
vai ser retornado.(Opcional) ORDER_BY: uma lista de campos separada por vírgulas que especifica a ordem de classificação dos resultados. A ordem padrão é crescente. Adicione
" DESC"
depois do nome do campo para indicar a ordem decrescente. Caracteres de espaço redundantes são ignorados. Exemplo:"location DESC, name"
. Somente os campos primitivos singulares na resposta são classificáveis:name
assetType
project
displayName
description
location
kmsKey
createTime
updateTime
state
parentFullResourceName
parentAssetType
Os demais campos, como os repetidos (por exemplo,
networkTags
), de mapa (por exemplo,labels
) e de estrutura (por exemplo,additionalAttributes
), não são aceitos.(Opcional) PAGE_SIZE: o tamanho da página para a paginação de resultados da pesquisa. O valor máximo é 500. Se o valor for
0
, um padrão apropriado será escolhido;(Opcional) PAGE_TOKEN: o token que representa o próximo lote de resultados da chamada anterior para esse método. O
page_token
precisa ser igual ao valor denext_page_token
da resposta da chamada anterior.(Opcional) READ_MASK: uma lista separada por vírgulas de campos especificando quais campos devem ser retornados nos resultados. Se não for especificado, todos os campos, exceto
versionedResources
, vão ser retornados. Se apenas"*"
for especificado, todos os campos vão ser retornados. Exemplos:"name,location"
,"name,versionedResources"
,"*"
.
Biblioteca de cliente e referência de API
- SearchAllResources
Como criar uma consulta
Veja a sintaxe de consulta para saber mais sobre a linguagem de consulta.
Consulte como pesquisar amostras de recursos para saber mais sobre as consultas de amostra para vários casos de uso reais.
Consultar recursos do Cloud por campos de metadados do recurso
Para pesquisar metadados de recursos, uma expressão de consulta tem os seguintes formatos:
- Correspondência exata de texto:
FIELD=QUERY
- Correspondência parcial de texto:
FIELD:QUERY
- Correspondência numérica: operadores de comparação (
=
,>
,>=
,<
,<=
)FIELDcomparison operatorQUERY
Os metadados de recursos pesquisáveis FIELD podem ser:
- name: o nome completo do recurso. Observação: nem todos os tipos de recurso são pesquisáveis. Consulte a lista de tipos pesquisáveis.
- displayName: o nome de exibição na IU
- description: a descrição de texto do recurso em um ou mais parágrafos
- location: o local do recurso. O local pode ser "global", regional (por exemplo, "us-east1") ou zonal (por exemplo, "us-west1-b").
labels: rótulos associados a este recurso. Os rótulos podem corresponder a chaves de chave, valores de rótulo ou ambos. Consulte Como rotular e agrupar recursos do GCP.
labels.[key]: valor do rótulo identificado pela chave do rótulo associado a esse recurso. Por exemplo: "
labels.env:prod
". Somente hifens (-
), sublinhados (_
), caracteres minúsculos e números são permitidos nas chaves de rótulos. As chaves precisam começar com uma letra minúscula. Caracteres internacionais são permitidos. Consulte Requisitos de rótulos.tagKeys:
TagKey
.namespacedName
das tags anexadas diretamente a este recurso.tagValues:
TagValue
.namespacedName
das tags anexadas diretamente a este recurso.tagValueIds:
TagValue
.name
das tags anexadas diretamente a este recurso.networkTags: tags de rede associadas a esse recurso. Consulte Como rotular e agrupar recursos do GCP.
kmsKey: a chave de criptografia gerenciada pelo cliente usada para criptografar esse recurso. Consulte CryptoKey e CryptoKeyVersion.
relationships: os relacionamentos associados a este recurso. As relações podem corresponder ao tipo de relacionamento, ao nome de recurso relacionado ou a ambas. Consulte os tipos de relacionamento compatíveis.
relationships.[relationship_type]: o nome do recurso relacionado de um tipo de recurso específico associado a ele. Por exemplo: "
relationships.INSTANCE_TO_INSTANCEGROUP:instance-group-1
". Consulte Tipos de relacionamento compatíveis.state: o valor de texto do estado desse recurso. Os diversos tipos de recursos têm diferentes definições de estado mapeadas de vários campos de tipos de recursos distintos. Exemplo: se o recurso for uma instância fornecida pelo Compute Engine, o estado incluirá PROVISIONING, STAGING, RUNNING, STOPPING, SUSPENDING, SUSPENDED, REPAIRING e TERMINATED. Veja a definição de
status
na Referência da API. Se o recurso for um projeto fornecido pelo Cloud Resource Manager, o estado dele vai incluir LIFECYCLE_STATE_UNSPECIFIED, ACTIVE, DELETE_REQUESTED e DELETE_IN_PROGRESS. Veja a definição delifecycleState
na Referência da API.createTime: o carimbo de data/hora da criação desse recurso, em que o recurso foi criado. A granularidade está em segundos.
updateTime: o carimbo de data/hora da última atualização desse recurso, a vez mais recente em que o recurso foi alterado ou excluído. A granularidade está em segundos.
project: o número do projeto ao que esse recurso pertence.
folders: os números das pastas às quais esse recurso pertence.
organization: o número da organização a que esse recurso pertence.
parentFullResourceName: o nome do pai desse recurso.
parentAssetType: o tipo de pai desse recurso.
Exemplos: consulta por campo específico
Localize todos os recursos no
scope
em quename
contém a palavraImportant
:name:Important
Encontre todos os recursos no
scope
em quedisplayName
contém uma palavra com o prefixoprod
:displayName:prod*
Localize todos os recursos no
scope
em quelocation
contém a palavraus
:location:us
Encontre todos os recursos em
scope
em quelocation
seja exatamente igual aus
:location=us
Encontre todos os recursos no
scope
que tenham tags anexadas diretamente comTagKey
namespacedName
contendo a palavraenv
:tagKeys:env
Encontre todos os recursos no
scope
que anexaram tags diretamente comTagValue
.namespacedName
contendo uma palavra prefixada porprod
:tagValues:prod*
Encontre todos os recursos no
scope
que tenham tags anexadas diretamente comTagValue
.name
é exatamente igual atagValues/123
:tagValueIds=tagValues/123
Encontre todos os recursos na
scope
que tenham tags anexadas diretamente comTagValue
.namespacedName
, ou seja, todos os recursos que tenham tags anexadas diretamente:tagValues:*
Encontre todos os recursos no
scope
que tenham umlabel
em que a chave ou o valor contenha a palavraprod
:labels:prod
Encontre todos os recursos no
scope
que tenham umlabel
em que a chave sejaenv
e o valor contenha a palavraprod
:labels.env:prod
Encontre todos os recursos no
scope
que tenham umlabel
em que a chave éenv
e o valor seja exatamente igual aprod
:labels.env=prod
Encontre todos os recursos no
scope
que tenham umlabel
em que a chave éenv
:labels.env:*
Encontre todos os recursos no
scope
que aqueles comnetworkTags
contêm a palavrainternal
:networkTags:internal
Localize todos os recursos na
scope
que têm umnetworkTags
igual exatamenteinternal
:networkTags=internal
Encontre todos os recursos no
scope
que tenham relações cominstance-group-1
no nome do recurso relacionado:relationships:instance-group-1
Encontre instâncias de computação no
scope
que tenham relações do tipoINSTANCE_TO_INSTANCEGROUP
:relationships:INSTANCE_TO_INSTANCEGROUP
Encontre instâncias de computação no seu
scope
que tenham relações cominstance-group-1
no nome do recurso do grupo de instâncias de computação, para o tipo de relaçãoINSTANCE_TO_INSTANCEGROUP
:relationships.INSTANCE_TO_INSTANCEGROUP:instance-group-1
Encontre todos os recursos no
scope
criptografados com uma chave de criptografia gerenciada pelo cliente em que o nome contém a palavrakey
:kmsKey:key
Encontre todos os recursos no
scope
em questate
contém a palavraACTIVE
:state:ACTIVE
Encontre todos os recursos no
scope
em questate
não contém a palavraACTIVE
:NOT state:ACTIVE
Encontre todos os recursos no
scope
que foram criados antes de "2021-01-01 00:00:00 UTC" (1609459200 é o carimbo de data/hora da época em segundos de "2021-01-01 00:00:00 UTC"):createTime<1609459200 createTime<2021-01-01 createTime<"2021-01-01T00:00:00"
Encontre todos os recursos no
scope
que foram atualizados depois de "2021-01-01 00:00:00 UTC" (1609459200 é o carimbo de data/hora da época em segundos de "2021-01-01 00:00:00 UTC"):updateTime>1609459200 updateTime>2021-01-01 updateTime>"2021-01-01T00:00:00"
Encontre todos os recursos no
scope
em queproject
tem o número123
:project:123
Encontre todos os recursos no
scope
contidos emfolder
com o número123
:folders:123
Encontre todos os recursos no
scope
em queorganization
tem o número123
:organization:123
Encontre todos os recursos no
scope
em queparentFullResourceName
contémImportantName
:parentFullResourceName:ImportantName
Encontre todos os recursos no
scope
em queparentAssetType
contémProject
:parentAssetType:Project
Encontre todos os recursos no
scope
em quename
contém a palavraImportant
edescription
contenha uma palavra com o prefixoimport
:name:Important description:import*
Encontre todos os recursos no
scope
em quename
contém a palavraImportant
oudescription
contenha uma palavra com o prefixoimport
:name:Important OR description:import*
Consultar recursos do Cloud por texto livre
Você também pode simplesmente usar uma consulta de texto livre sem especificar um campo. Em seguida, ele retornará recursos, desde que haja um campo nos metadados do recurso que correspondam à consulta.
Exemplos: consulta por texto livre
Encontre todos os recursos no
scope
que tenha campos de metadados (por exemplo,name
,displayName
,description
) contêm a palavraImportant
:Important
Encontre todos os recursos no
scope
que tenha campos de metadados (por exemplo,name
,displayName
,description
) contêm uma palavra com o prefixoimport
:import*
Encontre todos os recursos no
scope
que tenha campos de metadados (por exemplo,name
,displayName
,description
) contêm a palavraImportant
e também contêm uma palavra com o prefixoprod
:Important prod*