Esta página foi traduzida pela API Cloud Translation.

Consultar recursos

Este tópico mostra como consultar os metadados do recurso de um projeto, uma pasta ou organização sem precisar exportar os dados para um BigQuery a tabela primeiro.

Limitações

A consulta fornecida na solicitação precisa ser uma consulta SELECT.
Resultados de consulta maiores que 10 GB não são suportados.
Os resultados da consulta com mais de 10 MB ou 1.000 linhas são sempre paginados.
As consultas não podem levar mais de seis horas para serem processadas.
O SQL legado do BigQuery não é suporte.
Os resultados da consulta só podem ser salvos em um conjunto de dados do BigQuery na multirregião US.
Para recursos do Google Kubernetes Engine listados na página de tipos de recursos compatíveis, container.googleapis.com/Cluster e container.googleapis.com/NodePool são suportados.
Para novas assinaturas do nível Premium do Security Command Center, pode levar até seis horas para ter acesso à API e até 48 horas para que os dados históricos fiquem prontos.

Antes de começar

Antes de começar, conclua as etapas a seguir.

Ative a API Cloud Asset Inventory no projeto em que você executará os comandos da API.

Ativar a API Cloud Asset Inventory
Configure as permissões necessárias para chame a API Cloud Asset Inventory usando a CLI gcloud ou a API.
Conclua as etapas a seguir para configurar seu ambiente.
CLI da gcloud
Configure seu ambiente para usar a CLI gcloud e chamar o a API Cloud Asset Inventory, instale a Google Cloud CLI no seu cliente local.
REST
Para configurar o ambiente para chamar a API Cloud Asset Inventory com o curl, conclua as etapas a seguir.
1. Verifique se você tem acesso ao comando curl.
2. Não se esqueça de conceder à sua conta um dos seguintes papéis em seu projeto, pasta ou organização.
  - Papel Leitor de recursos do Cloud (roles/cloudasset.viewer)
  - Papel básico do proprietário (roles/owner)
Se você estiver exportando metadados de um projeto para outro, verifique se o exportando os dados a conta de serviço padrão do Inventário de recursos do Cloud existe e tem as permissões corretas.

Permissões

A lista a seguir mostra as permissões necessárias para cada ContentType em uma solicitação.

Tipo de conteúdo		Permissão
Nome da gcloud	Nome do REST
`access-policy`	`ACCESS_POLICY`	`cloudasset.assets.queryAccessPolicy`
`iam-policy`	`IAM_POLICY`	`cloudasset.assets.queryIamPolicy`
`os-inventory`	`OS_INVENTORY`	`cloudasset.assets.queryOSInventories`
`relationship`	`RELATIONSHIP`	`cloudasset.assets.queryResource`
`resource`	`RESOURCE`	`cloudasset.assets.queryResource`

O papel que você concede ao configurar permissões (cloudasset.viewer ou cloudasset.owner) contém essas permissões.

Formatar uma consulta

A API Query Assets exige que as consultas usem uma Compatível com o SQL padrão do BigQuery dialeto.

Ao consultar um recurso, o nome deve seguir um formato específico. Por exemplo: uma consulta que procura VMs consultaria compute_googleapis_com_Instance. Saiba mais sobre os tipos de recursos compatíveis.

Os nomes usados em uma consulta são transformados: / e . são substituídos por _ (para Por exemplo, compute.googleapis.com/Instance se torna compute_googleapis_com_Instance).

Os nomes das tabelas no conjunto de dados correspondem ao nome do tipo de recurso. Para conteúdo cujo content_type não é RESOURCE, o nome da tabela é o tipo de conteúdo em maiúsculas caso (por exemplo, IAM_POLICY, OS_INVENTORY, ACCESS_POLICY).

Para consultar metadados padrão de recursos em tipos de recursos, o nome da tabela é STANDARD_METADATA: Os metadados de recursos compatíveis incluem todos os campos, exceto resource.DATA, que é específico para um tipo de recurso.

Você pode consultar os esquemas usados por vários recursos no Página "Inventário de recursos" no console do Google Cloud.

Formato de resposta dos valores do campo

Em uma resposta, os campos schema e rows são semelhantes aos da BigQuery Metadados de campo é relegado a um struct separado chamado schema. Esse formato ajuda a compactar uma resposta potencialmente muito grande, evitando a duplicação de nome e tipo de campo. O os valores f e v são usados em vez de fields e value pelo mesmo motivo.

Este exemplo mostra a resposta a uma consulta para todos os recursos de um determinado tipo com page-size de 2:

{
  "jobReference": "CiBqb2JfTHhIQ2xCeXlJejc1bHdQSTRNZ3NEVndXU2o5QxIBARjLq-_g5fO5t1I",
  "done": true,
  "queryResult": {
    "rows": [
      {
        "f": [
          {
            "v": "//compute.googleapis.com/projects/PROJECT1/zones/us-central1-a/instances/INSTANCE1"
          },
          {
            "v": "compute.googleapis.com/Instance"
          }
        ]
      },
      {
        "f": [
          {
            "v": "//compute.googleapis.com/projects/PROJECT2/zones/us-central1-a/instances/INSTANCE2"
          },
          {
            "v": "compute.googleapis.com/Instance"
          }
        ]
      }
    ],
    "schema": {
      "fields": [
        {
          "field": "name",
          "type": "STRING",
          "mode": "NULLABLE",
          "fields": []
        },
        {
          "field": "assetType",
          "type": "STRING",
          "mode": "NULLABLE",
          "fields": []
        }
      ]
    },
    "nextPageToken": "BHKVJIOAPUAQAAASA4EAAEEAQCAAKGQIBABBB7X7777QOIFQVYKQ====",
    "totalRows": "11"
  }
}

Consultar no console do Google Cloud

Console

Para consultar os metadados do recurso de um projeto, uma pasta ou uma organização, faça o seguinte: siga estas etapas:

Acesse a página Inventário de recursos no console do Google Cloud.

Acessar o inventário de recursos
Para definir o escopo da sua pesquisa, selecione um projeto, uma pasta ou organização.
Clique na guia Consulta de recursos.
Para consultar metadados do recurso, use uma consulta de exemplo ou crie a sua:
- Para usar um exemplo, clique em uma entrada na guia Biblioteca de consultas para visualizar a consulta. Clique em Aplicar para copiar essa amostra Editar consulta, depois edite-a ou clique em Executar para executá-la.
- Para criar sua própria consulta, digite o texto da consulta diretamente no Editar consulta e, em seguida, clique em Executar para executá-la. Para ajudar na criando sua própria consulta, clique em uma tabela em Selecionar tabela para visualizar o esquema e o conteúdo dele. Saiba mais sobre a sintaxe de consulta.
Os metadados do recurso que correspondem à consulta são mostrados no Resultado da consulta. .
Opcional: para fazer o download dos conjuntos de resultados da consulta no formato CSV, clique em Exportar.

O tamanho máximo do arquivo CSV é 2 MB. Se a solicitação de download falhar como o tamanho do arquivo excede esse limite, uma mensagem instruções para exportar os resultados completos.

Salvar os resultados da consulta

Os resultados da consulta são retornados como respostas da API Query Assets. Para exportar os resultados à sua própria tabela do BigQuery, especifique um destino do BigQuery no da solicitação. Se você ainda não tiver uma, criar um conjunto de dados do BigQuery antes de fazer essas solicitações.

gcloud

Projetos

gcloud asset query \
    --project=PROJECT_ID \
    --billing-project=BILLING_PROJECT_ID \
    --statement="
      SELECT
        name, assetType
      FROM
        compute_googleapis_com_Instance
      LIMIT 2" \
    --bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
    --write-disposition="write-truncate"

Forneça os valores a seguir:

PROJECT_ID: o ID do projeto cujo metadados que você quer consultar.
BILLING_PROJECT_ID: opcional. O ID do projeto que o agente de serviço padrão do Inventário de recursos do Cloud está com permissões gravar no BigQuery. Não é necessário se você já trocou ao projeto de faturamento com gcloud config set project. Leia mais sobre projetos de faturamento.
DATASET_ID: o ID do conjunto de dados do BigQuery.
TABLE_NAME: a tabela que você está exportando aos metadados. Se não existir, será criado.

Outras sinalizações:

--write-disposition: especifica a ação que ocorrerá se o A tabela ou partição de destino do BigQuery já existe definindo a disposição de gravação. Os valores a seguir são compatíveis:
- write-truncate: se a tabela ou partição já existir, O BigQuery substitui a tabela inteira ou todas as partições dados.
- write-append: se a tabela ou partição já existir, O BigQuery anexa os dados à tabela ou à partição.
- write-empty: se a tabela já existir e contiver dados, uma duplicate será retornado no resultado do job.
O valor padrão é write-empty.

Pastas

gcloud asset query \
    --folder=FOLDER_ID \
    --billing-project=BILLING_PROJECT_ID \
    --statement="
      SELECT
        name, assetType
      FROM
        compute_googleapis_com_Instance
      LIMIT 2" \
    --bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
    --write-disposition="write-truncate"

Forneça os valores a seguir:

FOLDER_ID: o ID da pasta cuja metadados que você quer consultar.
Como encontrar um ID de pasta do Google Cloud
Console

Para encontrar um ID de pasta do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
CLI da gcloud

Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.

Para receber o ID de uma pasta dentro de outra, liste as subpastas:

gcloud resource-manager folders list --folder=FOLDER_ID
BILLING_PROJECT_ID: opcional. O ID do projeto que o agente de serviço padrão do Inventário de recursos do Cloud está com permissões gravar no BigQuery. Não é necessário se você já trocou ao projeto de faturamento com gcloud config set project. Leia mais sobre projetos de faturamento.
PROJECT_ID: o ID do projeto que o A tabela do BigQuery está.
DATASET_ID: o ID do conjunto de dados do BigQuery.
TABLE_NAME: a tabela que você está exportando aos metadados. Se não existir, será criado.

Outras sinalizações:

--write-disposition: especifica a ação que ocorrerá se o A tabela ou partição de destino do BigQuery já existe definindo a disposição de gravação. Os valores a seguir são compatíveis:
- write-truncate: se a tabela ou partição já existir, O BigQuery substitui a tabela inteira ou todos os dados das partições.
- write-append: se a tabela ou partição já existir, O BigQuery anexa os dados à tabela ou à partição.
- write-empty: se a tabela já existir e contiver dados, uma duplicate será retornado no resultado do job.
O valor padrão é write-empty.

Organizações

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --billing-project=BILLING_PROJECT_ID \
    --statement="
      SELECT
        name, assetType
      FROM
        compute_googleapis_com_Instance
      LIMIT 2" \
    --bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
    --write-disposition="write-truncate"

Forneça os valores a seguir:

ORGANIZATION_ID: o ID da organização cujos metadados você deseja consultar.
Como encontrar um ID de organização do Google Cloud
Console

Para encontrar um ID de organização do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
CLI da gcloud

Recupere um ID da organização do Google Cloud com o seguinte comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
BILLING_PROJECT_ID: opcional. O ID do projeto que o agente de serviço padrão do Inventário de recursos do Cloud está com permissões gravar no BigQuery. Não é necessário se você já trocou ao projeto de faturamento com gcloud config set project. Leia mais sobre projetos de faturamento.
PROJECT_ID: o ID do projeto que o A tabela do BigQuery está.
DATASET_ID: o ID do conjunto de dados do BigQuery.
TABLE_NAME: a tabela que você está exportando aos metadados. Se não existir, será criado.

Outras sinalizações:

--write-disposition: especifica a ação que ocorrerá se o A tabela ou partição de destino do BigQuery já existe definindo a disposição de gravação. Os valores a seguir são compatíveis:
- write-truncate: se a tabela ou partição já existir, O BigQuery substitui a tabela inteira ou todos os dados das partições.
- write-append: se a tabela ou partição já existir, O BigQuery anexa os dados à tabela ou à partição.
- write-empty: se a tabela já existir e contiver dados, uma duplicate será retornado no resultado do job.
O valor padrão é write-empty.

Veja um exemplo de resposta para uma solicitação bem-sucedida que salva a consulta para uma tabela de destino especificada do BigQuery:

done: true
jobReference: CiBqb2JfMkpzOERxN2l5RnRKeWJQRksxWUlmYkxWNTUzbhIBARixoYOcs9T_qcgB
outputConfig:
  bigqueryDestination:
    dataset: projects/test-project/datasets/my_dataset
    table: my-table
    writeDisposition: write-truncate

Veja um exemplo de resposta para um job que falhou ao salvar os resultados da consulta:

done: true
error:
  code: 9
  message: '1 errors encountered during query: notFound'
jobReference: CiBqb2JfZWlmOUNsVFQ3b05hVzhpYkdVZ291dkZXc1VFXxIBARj73sbsmLmE1BggAQ

REST

curl -X POST \
     -H "X-Goog-User-Project: BILLING_PROJECT_ID" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              name, assetType
            FROM
              compute_googleapis_com_Instance
            LIMIT 2",
          "outputConfig": {
            "bigqueryDestination": {
              "dataset": "projects/PROJECT_ID/datasets/DATASET_ID",
              "table": "TABLE_NAME",
              "writeDisposition": "WRITE_TRUNCATE"
            }
          }
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Forneça os valores a seguir:

BILLING_PROJECT_ID: o ID do projeto que o o agente de serviço padrão do Inventário de recursos do Cloud tem permissões para gerenciar conjuntos de dados e tabelas do BigQuery. Leia mais sobre projetos de faturamento.
PROJECT_ID: o ID do projeto que o A tabela do BigQuery está.
DATASET_ID: o ID do conjunto de dados do BigQuery.
TABLE_NAME: a tabela que você está exportando aos metadados. Se não existir, será criado.
SCOPE: um escopo pode ser um projeto, uma pasta ou organização.

Os valores permitidos são:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Como encontrar um número de projeto do Google Cloud
  Console
  
  Para encontrar um número de projeto do Google Cloud, siga estas etapas:
  
  Acesse a página Painel no console do Google Cloud.
  
  Ir para o painel
  
  Clique na caixa do seletor na barra de menus.
  
  Escolha sua organização na caixa Selecionar de e pesquise as nome do projeto.
  
  Clique no nome do projeto para alternar para ele. O número do projeto é mostrado Card Informações do projeto.
  
  CLI da gcloud
  
  Recupere um número de projeto do Google Cloud com o seguinte comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Como encontrar um ID de pasta do Google Cloud
  Console
  
  Para encontrar um ID de pasta do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
  
  CLI da gcloud
  
  Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.
  
  Para receber o ID de uma pasta dentro de outra, liste as subpastas:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Como encontrar um ID de organização do Google Cloud
  Console
  
  Para encontrar um ID de organização do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
  
  CLI da gcloud
  
  Recupere um ID da organização do Google Cloud com o seguinte comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Outros parâmetros:

writeDisposition: especifica a ação que ocorrerá se o A tabela ou partição de destino do BigQuery já existe ao definir a disposição de gravação. Os valores a seguir são compatíveis:
- WRITE_TRUNCATE: se a tabela ou partição já existir, O BigQuery substitui a tabela inteira ou todos os dados das partições.
- WRITE_APPEND: se a tabela ou partição já existir, O BigQuery anexa os dados à tabela ou à partição mais recente.
- WRITE_EMPTY: se a tabela já existir e contiver dados, uma duplicate será retornado no resultado do job.
O valor padrão é WRITE_EMPTY.

Veja um exemplo de resposta para uma solicitação bem-sucedida que salva a consulta para uma tabela de destino especificada do BigQuery:

{
  "jobReference": "CiBqb2JfZmNlbTZ5SjVZcHFKajVIYjMycFNSd2xSRlZXdBIBARiAnb6R1I63wdkB",
  "done": true,
  "outputConfig": {
    "bigqueryDestination": {
      "dataset": "projects/test-project/datasets/my_dataset",
      "table": "my-table",
      "writeDisposition": "WRITE_TRUNCATE"
    }
  }
}

Veja um exemplo de resposta para um job que falhou ao salvar os resultados da consulta:

{
  "jobReference": "CiBqb2JfZWlmOUNsVFQ3b05hVzhpYkdVZ291dkZXc1VFXxIBARj73sbsmLmE1BggAQ",
  "done": true,
  "error": {
    "code": 9,
    "message": "1 errors encountered during query: notFound"
  }
}

O esquema e as linhas não são retornados diretamente na resposta da consulta. Você pode exibi-los na tabela de destino especificada do BigQuery.

Amostras de consultas

Recursos de consulta

Os exemplos a seguir consultam recursos em um projeto, pasta ou organização.

gcloud

Projetos

gcloud asset query \
    --project=PROJECT_ID \
    --statement="
      SELECT
        name, assetType
      FROM
        compute_googleapis_com_Instance
      LIMIT 2"

Forneça os valores a seguir:

PROJECT_ID: o ID do projeto cujo metadados que você quer consultar.

Pastas

gcloud asset query \
    --folder=FOLDER_ID \
    --statement="
      SELECT
        name, assetType
      FROM
        compute_googleapis_com_Instance
      LIMIT 2"

Forneça os valores a seguir:

FOLDER_ID: o ID da pasta cuja metadados que você quer consultar.
Como encontrar um ID de pasta do Google Cloud
Console

Para encontrar um ID de pasta do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
CLI da gcloud

Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.

Para receber o ID de uma pasta dentro de outra, liste as subpastas:

gcloud resource-manager folders list --folder=FOLDER_ID

Organizações

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --statement="
      SELECT
        name, assetType
      FROM
        compute_googleapis_com_Instance
      LIMIT 2"

Forneça os valores a seguir:

ORGANIZATION_ID: o ID da organização cujos metadados você deseja consultar.
Como encontrar um ID de organização do Google Cloud
Console

Para encontrar um ID de organização do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
CLI da gcloud

Recupere um ID da organização do Google Cloud com o seguinte comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Veja um exemplo de resposta para uma solicitação bem-sucedida que retorna todas as linhas:

done: true
jobReference: CiBqb2JfMkpzOERxN2l5RnRKeWJQRksxWUlmYkxWNTUzbhIBARixoYOcs9T_qcgB
queryResult:
  nextPageToken: ''
  totalRows: '2'

name: //compute.googleapis.com/projects/PROJECT_ID/zones/ZONE/instances/VM_INSTANCE_NAME
assetType: compute.googleapis.com/Instance

name: //compute.googleapis.com/projects/PROJECT_ID/zones/ZONE/instances/VM_INSTANCE_NAME
assetType; compute.googleapis.com/Instance

REST

curl -X POST \
     -H "X-Goog-User-Project: BILLING_PROJECT_ID" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
      "statement": "
        SELECT
          name, assetType
        FROM
          compute_googleapis_com_Instance
        LIMIT 2" }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Forneça os valores a seguir:

SCOPE: um escopo pode ser um projeto, uma pasta ou organização.

Os valores permitidos são:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Como encontrar um número de projeto do Google Cloud
  Console
  
  Para encontrar um número de projeto do Google Cloud, siga estas etapas:
  
  Acesse a página Painel no console do Google Cloud.
  
  Ir para o painel
  
  Clique na caixa do seletor na barra de menus.
  
  Escolha sua organização na caixa Selecionar de e pesquise as nome do projeto.
  
  Clique no nome do projeto para alternar para ele. O número do projeto é mostrado Card Informações do projeto.
  
  CLI da gcloud
  
  Recupere um número de projeto do Google Cloud com o seguinte comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Como encontrar um ID de pasta do Google Cloud
  Console
  
  Para encontrar um ID de pasta do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
  
  CLI da gcloud
  
  Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.
  
  Para receber o ID de uma pasta dentro de outra, liste as subpastas:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Como encontrar um ID de organização do Google Cloud
  Console
  
  Para encontrar um ID de organização do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
  
  CLI da gcloud
  
  Recupere um ID da organização do Google Cloud com o seguinte comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Veja um exemplo de resposta para uma solicitação bem-sucedida que retorna todas as linhas:

{
  "jobReference": "CiBqb2JfZmNlbTZ5SjVZcHFKajVIYjMycFNSd2xSRlZXdBIBARiAnb6R1I63wdkB",
  "done": true,
  "queryResult": {
    "rows": [...],
    "schema": {...},
    "nextPageToken": "",
    "totalRows": "2"
  }
}

O esquema e as linhas foram removidos para facilitar a leitura. Você pode visualizá-las em Formato da resposta do valor do campo.

Consultar metadados padrão de recursos em tipos de recursos

O exemplo a seguir consulta o recurso campos de metadados padrão name e assetType em todos os tipos de recursos em uma em uma região específica.

gcloud

Projetos

gcloud asset query \
    --project=PROJECT_ID \
    --statement="
      SELECT
        name,
        assetType
      FROM
        STANDARD_METADATA
      WHERE
        resource.location LIKE '%asia%'"

Forneça os valores a seguir:

PROJECT_ID: o ID do projeto cujo metadados que você quer consultar.

Pastas

gcloud asset query \
    --folder=FOLDER_ID \
    --statement="
      SELECT
        name,
        assetType
      FROM
        STANDARD_METADATA
      WHERE
        resource.location LIKE '%asia%'"

Forneça os valores a seguir:

FOLDER_ID: o ID da pasta cuja metadados que você quer consultar.
Como encontrar um ID de pasta do Google Cloud
Console

Para encontrar um ID de pasta do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
CLI da gcloud

Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.

Para receber o ID de uma pasta dentro de outra, liste as subpastas:

gcloud resource-manager folders list --folder=FOLDER_ID

Organizações

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --statement="
      SELECT
        name,
        assetType
      FROM
        STANDARD_METADATA
      WHERE
        resource.location LIKE '%asia%'"

Forneça os valores a seguir:

ORGANIZATION_ID: o ID da organização cujos metadados você deseja consultar.
Como encontrar um ID de organização do Google Cloud
Console

Para encontrar um ID de organização do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
CLI da gcloud

Recupere um ID da organização do Google Cloud com o seguinte comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              name,
              assetType
            FROM
              STANDARD_METADATA
            WHERE
              resource.location LIKE \"%asia%\""
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Forneça os valores a seguir:

SCOPE: um escopo pode ser um projeto, uma pasta ou organização.

Os valores permitidos são:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Como encontrar um número de projeto do Google Cloud
  Console
  
  Para encontrar um número de projeto do Google Cloud, siga estas etapas:
  
  Acesse a página Painel no console do Google Cloud.
  
  Ir para o painel
  
  Clique na caixa do seletor na barra de menus.
  
  Escolha sua organização na caixa Selecionar de e pesquise as nome do projeto.
  
  Clique no nome do projeto para alternar para ele. O número do projeto é mostrado Card Informações do projeto.
  
  CLI da gcloud
  
  Recupere um número de projeto do Google Cloud com o seguinte comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Como encontrar um ID de pasta do Google Cloud
  Console
  
  Para encontrar um ID de pasta do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
  
  CLI da gcloud
  
  Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.
  
  Para receber o ID de uma pasta dentro de outra, liste as subpastas:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Como encontrar um ID de organização do Google Cloud
  Console
  
  Para encontrar um ID de organização do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
  
  CLI da gcloud
  
  Recupere um ID da organização do Google Cloud com o seguinte comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Como buscar uma resposta de forma assíncrona por referência de trabalho

Execute o comando a seguir, que expira.

gcloud

Projetos

gcloud asset query \
    --project=PROJECT_ID \
    --timeout="1s" \
    --statement="
    SELECT
      name, assetType
    FROM
      compute_googleapis_com_Instance";

Forneça os valores a seguir:

PROJECT_ID: o ID do projeto cujo metadados que você quer consultar.

Quando uma solicitação não é concluída a tempo, o campo done é definido como false, o que significa que a solicitação não foi concluída a tempo, mas está sendo processados. O exemplo a seguir mostra uma resposta que indica que o o processamento da solicitação não foi concluído.

done: false
job_reference: "JOB_REFERENCE_ID"

Use esse ID de referência do job para receber o resultado de forma assíncrona. depois com outra chamada de API:

gcloud asset query \
    --project=PROJECT_ID \
    --job-reference=JOB_REFERENCE_ID

Pastas

gcloud asset query \
    --folder=FOLDER_ID \
    --timeout="1s" \
    --statement="
    SELECT
      name, assetType
    FROM
      compute_googleapis_com_Instance";

Forneça os valores a seguir:

FOLDER_ID: o ID da pasta cuja metadados que você quer consultar.
Como encontrar um ID de pasta do Google Cloud
Console

Para encontrar um ID de pasta do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
CLI da gcloud

Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.

Para receber o ID de uma pasta dentro de outra, liste as subpastas:

gcloud resource-manager folders list --folder=FOLDER_ID

done: false
job_reference: "JOB_REFERENCE_ID"

Use esse ID de referência do job para receber o resultado de forma assíncrona. depois com outra chamada de API:

gcloud asset query \
    --folder=FOLDER_ID \
    --job-reference=JOB_REFERENCE_ID

Organizações

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --timeout="1s" \
    --statement="
    SELECT
      name, assetType
    FROM
      compute_googleapis_com_Instance";

Forneça os valores a seguir:

ORGANIZATION_ID: o ID da organização cujos metadados você deseja consultar.
Como encontrar um ID de organização do Google Cloud
Console

Para encontrar um ID de organização do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
CLI da gcloud

Recupere um ID da organização do Google Cloud com o seguinte comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Quando uma solicitação não é concluída a tempo, o campo done é definido como false, que significa que a solicitação não foi concluída a tempo, mas está sendo processados. O exemplo a seguir mostra uma resposta que indica que o o processamento da solicitação não foi concluído.

done: false
job_reference: "JOB_REFERENCE_ID"

Use esse ID de referência do job para receber o resultado de forma assíncrona. depois com outra chamada de API:

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --job-reference=JOB_REFERENCE_ID

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "timeout": "1s",
          "statement": "
            SELECT
              name, assetType
            FROM
              compute_googleapis_com_Instance"
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Forneça os valores a seguir:

SCOPE: um escopo pode ser um projeto, uma pasta ou organização.

Os valores permitidos são:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Como encontrar um número de projeto do Google Cloud
  Console
  
  Para encontrar um número de projeto do Google Cloud, siga estas etapas:
  
  Acesse a página Painel no console do Google Cloud.
  
  Ir para o painel
  
  Clique na caixa do seletor na barra de menus.
  
  Escolha sua organização na caixa Selecionar de e pesquise as nome do projeto.
  
  Clique no nome do projeto para alternar para ele. O número do projeto é mostrado Card Informações do projeto.
  
  CLI da gcloud
  
  Recupere um número de projeto do Google Cloud com o seguinte comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Como encontrar um ID de pasta do Google Cloud
  Console
  
  Para encontrar um ID de pasta do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
  
  CLI da gcloud
  
  Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.
  
  Para receber o ID de uma pasta dentro de outra, liste as subpastas:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Como encontrar um ID de organização do Google Cloud
  Console
  
  Para encontrar um ID de organização do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
  
  CLI da gcloud
  
  Recupere um ID da organização do Google Cloud com o seguinte comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Quando uma solicitação não é concluída a tempo, o campo done é definido como false, o que significa que a solicitação não terminou a tempo, mas está sendo processada. O o exemplo a seguir mostra uma resposta que indica que a solicitação não foi concluída processamento.

{
  "jobReference": "JOB_REFERENCE_ID",
  "done": false,
  "queryResult": {
    "rows": [],
    "schema": {
      "fields": []
    },
    "nextPageToken": "",
    "totalRows": "0"
  }
}

É possível usar esse ID de referência do job para receber o resultado de forma assíncrona mais tarde com outra chamada de API:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "jobReference": "JOB_REFERENCE_ID"
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Como buscar a próxima página de resultados de solicitações paginadas com a API REST

Faça a seguinte consulta, que define um pageSize de 1:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "pageSize": "1",
          "statement": "
            SELECT
              name, assetType
            FROM
              compute_googleapis_com_Instance"
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Forneça os valores a seguir:

SCOPE: um escopo pode ser um projeto, uma pasta ou organização.

Os valores permitidos são:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Como encontrar um número de projeto do Google Cloud
  Console
  
  Para encontrar um número de projeto do Google Cloud, siga estas etapas:
  
  Acesse a página Painel no console do Google Cloud.
  
  Ir para o painel
  
  Clique na caixa do seletor na barra de menus.
  
  Escolha sua organização na caixa Selecionar de e pesquise as nome do projeto.
  
  Clique no nome do projeto para alternar para ele. O número do projeto é mostrado Card Informações do projeto.
  
  CLI da gcloud
  
  Recupere um número de projeto do Google Cloud com o seguinte comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Como encontrar um ID de pasta do Google Cloud
  Console
  
  Para encontrar um ID de pasta do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
  
  CLI da gcloud
  
  Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.
  
  Para receber o ID de uma pasta dentro de outra, liste as subpastas:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Como encontrar um ID de organização do Google Cloud
  Console
  
  Para encontrar um ID de organização do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
  
  CLI da gcloud
  
  Recupere um ID da organização do Google Cloud com o seguinte comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Outros parâmetros:

pageSize: o número máximo de recursos a serem mostrados por página.

A resposta tem um nextPageToken que pode ser definido em uma solicitação com jobReference para acessar a próxima página de respostas.

{
  "jobReference": "JOB_REFERENCE_ID",
  "done": true,
  "queryResult": {
    "rows": [ ... ],
    "schema": { ... },
    "nextPageToken": "NEXT_PAGE_TOKEN",
    "totalRows": "11"
  }
}

O esquema e as linhas foram removidos para facilitar a leitura. Você pode visualizá-las em Formato da resposta do valor do campo.

É possível consultar o token da página para ver a próxima página de resultados:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "jobReference": "JOB_REFERENCE_ID",
          "pageToken": "NEXT_PAGE_TOKEN"
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Consultar quantas VMs existem em cada região

gcloud

Projetos

gcloud asset query \
    --project=PROJECT_ID \
    --statement="
      SELECT
        resource.location,
        COUNT(*)
      FROM
        compute_googleapis_com_Instance
      GROUP BY
        resource.location"

Forneça os valores a seguir:

PROJECT_ID: o ID do projeto cujo metadados que você quer consultar.

Pastas

gcloud asset query \
    --folder=FOLDER_ID \
    --statement="
      SELECT
        resource.location,
        COUNT(*)
      FROM
        compute_googleapis_com_Instance
      GROUP BY
        resource.location"

Forneça os valores a seguir:

FOLDER_ID: o ID da pasta cuja metadados que você quer consultar.
Como encontrar um ID de pasta do Google Cloud
Console

Para encontrar um ID de pasta do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
CLI da gcloud

Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.

Para receber o ID de uma pasta dentro de outra, liste as subpastas:

gcloud resource-manager folders list --folder=FOLDER_ID

Organizações

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --statement="
      SELECT
        resource.location,
        COUNT(*)
      FROM
        compute_googleapis_com_Instance
      GROUP BY
        resource.location"

Forneça os valores a seguir:

ORGANIZATION_ID: o ID da organização cujos metadados você deseja consultar.
Como encontrar um ID de organização do Google Cloud
Console

Para encontrar um ID de organização do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
CLI da gcloud

Recupere um ID da organização do Google Cloud com o seguinte comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              resource.location,
              COUNT(*)
            FROM
              compute_googleapis_com_Instance
            GROUP BY
              resource.location"
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Forneça os valores a seguir:

SCOPE: um escopo pode ser um projeto, uma pasta ou organização.

Os valores permitidos são:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Como encontrar um número de projeto do Google Cloud
  Console
  
  Para encontrar um número de projeto do Google Cloud, siga estas etapas:
  
  Acesse a página Painel no console do Google Cloud.
  
  Ir para o painel
  
  Clique na caixa do seletor na barra de menus.
  
  Escolha sua organização na caixa Selecionar de e pesquise as nome do projeto.
  
  Clique no nome do projeto para alternar para ele. O número do projeto é mostrado Card Informações do projeto.
  
  CLI da gcloud
  
  Recupere um número de projeto do Google Cloud com o seguinte comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Como encontrar um ID de pasta do Google Cloud
  Console
  
  Para encontrar um ID de pasta do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
  
  CLI da gcloud
  
  Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.
  
  Para receber o ID de uma pasta dentro de outra, liste as subpastas:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Como encontrar um ID de organização do Google Cloud
  Console
  
  Para encontrar um ID de organização do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
  
  CLI da gcloud
  
  Recupere um ID da organização do Google Cloud com o seguinte comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Consultar para identificar as VMs em uma região específica

gcloud

Projetos

gcloud asset query \
    --project=PROJECT_ID \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance
      WHERE
        resource.location LIKE '%asia%'"

Forneça os valores a seguir:

PROJECT_ID: o ID do projeto cujo metadados que você quer consultar.

Pastas

gcloud asset query \
    --folder=FOLDER_ID \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance
      WHERE
        resource.location LIKE '%asia%'"

Forneça os valores a seguir:

FOLDER_ID: o ID da pasta cuja metadados que você quer consultar.
Como encontrar um ID de pasta do Google Cloud
Console

Para encontrar um ID de pasta do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
CLI da gcloud

Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.

Para receber o ID de uma pasta dentro de outra, liste as subpastas:

gcloud resource-manager folders list --folder=FOLDER_ID

Organizações

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance
      WHERE
        resource.location LIKE '%asia%'"

Forneça os valores a seguir:

ORGANIZATION_ID: o ID da organização cujos metadados você deseja consultar.
Como encontrar um ID de organização do Google Cloud
Console

Para encontrar um ID de organização do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
CLI da gcloud

Recupere um ID da organização do Google Cloud com o seguinte comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              name,
              resource.DATA.creationTimestamp
            FROM
              compute_googleapis_com_Instance
            WHERE
              resource.location LIKE \"%asia%\""
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Forneça os valores a seguir:

SCOPE: um escopo pode ser um projeto, uma pasta ou organização.

Os valores permitidos são:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Como encontrar um número de projeto do Google Cloud
  Console
  
  Para encontrar um número de projeto do Google Cloud, siga estas etapas:
  
  Acesse a página Painel no console do Google Cloud.
  
  Ir para o painel
  
  Clique na caixa do seletor na barra de menus.
  
  Escolha sua organização na caixa Selecionar de e pesquise as nome do projeto.
  
  Clique no nome do projeto para alternar para ele. O número do projeto é mostrado Card Informações do projeto.
  
  CLI da gcloud
  
  Recupere um número de projeto do Google Cloud com o seguinte comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Como encontrar um ID de pasta do Google Cloud
  Console
  
  Para encontrar um ID de pasta do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
  
  CLI da gcloud
  
  Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.
  
  Para receber o ID de uma pasta dentro de outra, liste as subpastas:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Como encontrar um ID de organização do Google Cloud
  Console
  
  Para encontrar um ID de organização do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
  
  CLI da gcloud
  
  Recupere um ID da organização do Google Cloud com o seguinte comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Consultar para identificar todos os bucket do Cloud Storage acessíveis publicamente

gcloud

Projetos

gcloud asset query \
    --project=PROJECT_ID \
    --statement="
      SELECT
        name
      FROM
        IAM_POLICY
      CROSS JOIN
        UNNEST(iamPolicy.bindings) AS binding
      WHERE
        ('allUsers' IN UNNEST(binding.members)
        OR 'allAuthenticatedUsers' IN UNNEST(binding.members))
        AND assetType = 'storage.googleapis.com/Bucket'"

Forneça os valores a seguir:

PROJECT_ID: o ID do projeto cujo metadados que você quer consultar.

Pastas

gcloud asset query \
    --folder=FOLDER_ID \
    --statement="
      SELECT
        name
      FROM
        IAM_POLICY
      CROSS JOIN
        UNNEST(iamPolicy.bindings) AS binding
      WHERE
        ('allUsers' IN UNNEST(binding.members)
        OR 'allAuthenticatedUsers' IN UNNEST(binding.members))
        AND assetType = 'storage.googleapis.com/Bucket'"

Forneça os valores a seguir:

FOLDER_ID: o ID da pasta cuja metadados que você quer consultar.
Como encontrar um ID de pasta do Google Cloud
Console

Para encontrar um ID de pasta do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
CLI da gcloud

Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.

Para receber o ID de uma pasta dentro de outra, liste as subpastas:

gcloud resource-manager folders list --folder=FOLDER_ID

Organizações

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --statement="
      SELECT
        name
      FROM
        IAM_POLICY
      CROSS JOIN
        UNNEST(iamPolicy.bindings) AS binding
      WHERE
        ('allUsers' IN UNNEST(binding.members)
        OR 'allAuthenticatedUsers' IN UNNEST(binding.members))
        AND assetType = 'storage.googleapis.com/Bucket'"

Forneça os valores a seguir:

ORGANIZATION_ID: o ID da organização cujos metadados você deseja consultar.
Como encontrar um ID de organização do Google Cloud
Console

Para encontrar um ID de organização do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
CLI da gcloud

Recupere um ID da organização do Google Cloud com o seguinte comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              name
            FROM
              IAM_POLICY
            CROSS JOIN
              UNNEST(iamPolicy.bindings) AS binding
            WHERE
              (\"allUsers\" IN UNNEST(binding.members)
              OR \"allAuthenticatedUsers\" IN UNNEST(binding.members))
              AND assetType = \"storage.googleapis.com/Bucket\""
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Forneça os valores a seguir:

SCOPE: um escopo pode ser um projeto, uma pasta ou organização.

Os valores permitidos são:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Como encontrar um número de projeto do Google Cloud
  Console
  
  Para encontrar um número de projeto do Google Cloud, siga estas etapas:
  
  Acesse a página Painel no console do Google Cloud.
  
  Ir para o painel
  
  Clique na caixa do seletor na barra de menus.
  
  Escolha sua organização na caixa Selecionar de e pesquise as nome do projeto.
  
  Clique no nome do projeto para alternar para ele. O número do projeto é mostrado Card Informações do projeto.
  
  CLI da gcloud
  
  Recupere um número de projeto do Google Cloud com o seguinte comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Como encontrar um ID de pasta do Google Cloud
  Console
  
  Para encontrar um ID de pasta do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
  
  CLI da gcloud
  
  Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.
  
  Para receber o ID de uma pasta dentro de outra, liste as subpastas:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Como encontrar um ID de organização do Google Cloud
  Console
  
  Para encontrar um ID de organização do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
  
  CLI da gcloud
  
  Recupere um ID da organização do Google Cloud com o seguinte comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Consultar para encontrar sub-redes que não tenham VMs anexadas

gcloud

Projetos

gcloud asset query \
    --project=PROJECT_ID \
    --statement="
      SELECT
        subnetwork_table.name
      FROM
        compute_googleapis_com_Subnetwork AS subnetwork_table
      LEFT JOIN (
        SELECT
          interface.subnetwork AS subnetwork
        FROM
          compute_googleapis_com_Instance
        CROSS JOIN
          UNNEST(resource.DATA.networkInterfaces) AS interface) AS instance_table
      ON
        SUBSTR(subnetwork_table.name, 25) = SUBSTR(instance_table.subnetwork,38)
      WHERE
        instance_table.subnetwork IS NULL
        AND NOT subnetwork_table.name LIKE '%default%'"

Forneça os valores a seguir:

PROJECT_ID: o ID do projeto cujo metadados que você quer consultar.

Pastas

gcloud asset query \
    --folder=FOLDER_ID \
    --statement="
      SELECT
        subnetwork_table.name
      FROM
        compute_googleapis_com_Subnetwork AS subnetwork_table
      LEFT JOIN (
        SELECT
          interface.subnetwork AS subnetwork
        FROM
          compute_googleapis_com_Instance
        CROSS JOIN
          UNNEST(resource.DATA.networkInterfaces) AS interface) AS instance_table
      ON
        SUBSTR(subnetwork_table.name, 25) = SUBSTR(instance_table.subnetwork,38)
      WHERE
        instance_table.subnetwork IS NULL
        AND NOT subnetwork_table.name LIKE '%default%'"

Forneça os valores a seguir:

FOLDER_ID: o ID da pasta cuja metadados que você quer consultar.
Como encontrar um ID de pasta do Google Cloud
Console

Para encontrar um ID de pasta do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
CLI da gcloud

Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.

Para receber o ID de uma pasta dentro de outra, liste as subpastas:

gcloud resource-manager folders list --folder=FOLDER_ID

Organizações

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --statement="
      SELECT
        subnetwork_table.name
      FROM
        compute_googleapis_com_Subnetwork AS subnetwork_table
      LEFT JOIN (
        SELECT
          interface.subnetwork AS subnetwork
        FROM
          compute_googleapis_com_Instance
        CROSS JOIN
          UNNEST(resource.DATA.networkInterfaces) AS interface) AS instance_table
      ON
        SUBSTR(subnetwork_table.name, 25) = SUBSTR(instance_table.subnetwork,38)
      WHERE
        instance_table.subnetwork IS NULL
        AND NOT subnetwork_table.name LIKE '%default%'"

Forneça os valores a seguir:

ORGANIZATION_ID: o ID da organização cujos metadados você deseja consultar.
Como encontrar um ID de organização do Google Cloud
Console

Para encontrar um ID de organização do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
CLI da gcloud

Recupere um ID da organização do Google Cloud com o seguinte comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              subnetwork_table.name
            FROM
              compute_googleapis_com_Subnetwork AS subnetwork_table
            LEFT JOIN (
              SELECT
                interface.subnetwork AS subnetwork
              FROM
                compute_googleapis_com_Instance
              CROSS JOIN
                UNNEST(resource.DATA.networkInterfaces) AS interface) AS instance_table
            ON
              SUBSTR(subnetwork_table.name, 25) = SUBSTR(instance_table.subnetwork,38)
            WHERE
              instance_table.subnetwork IS NULL
              AND NOT subnetwork_table.name LIKE \"%default%\""
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Forneça os valores a seguir:

SCOPE: um escopo pode ser um projeto, uma pasta ou organização.

Os valores permitidos são:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Como encontrar um número de projeto do Google Cloud
  Console
  
  Para encontrar um número de projeto do Google Cloud, siga estas etapas:
  
  Acesse a página Painel no console do Google Cloud.
  
  Ir para o painel
  
  Clique na caixa do seletor na barra de menus.
  
  Escolha sua organização na caixa Selecionar de e pesquise as nome do projeto.
  
  Clique no nome do projeto para alternar para ele. O número do projeto é mostrado Card Informações do projeto.
  
  CLI da gcloud
  
  Recupere um número de projeto do Google Cloud com o seguinte comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Como encontrar um ID de pasta do Google Cloud
  Console
  
  Para encontrar um ID de pasta do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
  
  CLI da gcloud
  
  Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.
  
  Para receber o ID de uma pasta dentro de outra, liste as subpastas:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Como encontrar um ID de organização do Google Cloud
  Console
  
  Para encontrar um ID de organização do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
  
  CLI da gcloud
  
  Recupere um ID da organização do Google Cloud com o seguinte comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Consultar para encontrar o número de conjuntos de dados do BigQuery em cada projeto

gcloud

Projetos

gcloud asset query \
    --project=PROJECT_ID \
    --statement="
      SELECT
        ancestor AS project,
        COUNT(*)
      FROM
        bigquery_googleapis_com_Dataset
      CROSS JOIN
        UNNEST (ancestors) AS ancestor
      WHERE
        ancestor LIKE '%project%'
      GROUP BY
        ancestor
      ORDER BY
        2 DESC"

Forneça os valores a seguir:

PROJECT_ID: o ID do projeto cujo metadados que você quer consultar.

Pastas

gcloud asset query \
    --folder=FOLDER_ID \
    --statement="
      SELECT
        ancestor AS project,
        COUNT(*)
      FROM
        bigquery_googleapis_com_Dataset
      CROSS JOIN
        UNNEST (ancestors) AS ancestor
      WHERE
        ancestor LIKE '%project%'
      GROUP BY
        ancestor
      ORDER BY
        2 DESC"

Forneça os valores a seguir:

FOLDER_ID: o ID da pasta cuja metadados que você quer consultar.
Como encontrar um ID de pasta do Google Cloud
Console

Para encontrar um ID de pasta do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
CLI da gcloud

Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.

Para receber o ID de uma pasta dentro de outra, liste as subpastas:

gcloud resource-manager folders list --folder=FOLDER_ID

Organizações

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --statement="
      SELECT
        ancestor AS project,
        COUNT(*)
      FROM
        bigquery_googleapis_com_Dataset
      CROSS JOIN
        UNNEST (ancestors) AS ancestor
      WHERE
        ancestor LIKE '%project%'
      GROUP BY
        ancestor
      ORDER BY
        2 DESC"

Forneça os valores a seguir:

ORGANIZATION_ID: o ID da organização cujos metadados você deseja consultar.
Como encontrar um ID de organização do Google Cloud
Console

Para encontrar um ID de organização do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
CLI da gcloud

Recupere um ID da organização do Google Cloud com o seguinte comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              ancestor AS project,
              COUNT(*)
            FROM
              bigquery_googleapis_com_Dataset
            CROSS JOIN
              UNNEST (ancestors) AS ancestor
            WHERE
              ancestor LIKE \"%project%\"
            GROUP BY
              ancestor
            ORDER BY
              2 DESC"
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Forneça os valores a seguir:

SCOPE: um escopo pode ser um projeto, uma pasta ou organização.

Os valores permitidos são:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Como encontrar um número de projeto do Google Cloud
  Console
  
  Para encontrar um número de projeto do Google Cloud, siga estas etapas:
  
  Acesse a página Painel no console do Google Cloud.
  
  Ir para o painel
  
  Clique na caixa do seletor na barra de menus.
  
  Escolha sua organização na caixa Selecionar de e pesquise as nome do projeto.
  
  Clique no nome do projeto para alternar para ele. O número do projeto é mostrado Card Informações do projeto.
  
  CLI da gcloud
  
  Recupere um número de projeto do Google Cloud com o seguinte comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Como encontrar um ID de pasta do Google Cloud
  Console
  
  Para encontrar um ID de pasta do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
  
  CLI da gcloud
  
  Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.
  
  Para receber o ID de uma pasta dentro de outra, liste as subpastas:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Como encontrar um ID de organização do Google Cloud
  Console
  
  Para encontrar um ID de organização do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
  
  CLI da gcloud
  
  Recupere um ID da organização do Google Cloud com o seguinte comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Consultar para identificar as VMs em uma região específica em um carimbo de data/hora específico

gcloud

Projetos

gcloud asset query \
    --project=PROJECT_ID \
    --snapshot-time="SNAPSHOT_TIME" \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance
      WHERE
        resource.location LIKE '%asia%'"

Forneça os valores a seguir:

PROJECT_ID: o ID do projeto cujo metadados que você quer consultar.
SNAPSHOT_TIME: opcional. A hora em que você quer capturar um snapshot dos seus recursos. O valor deve ser o hora atual ou uma hora não superior a 35 dias no passado. Quando não fornecido, um snapshot é capturado no momento atual. Para informações sobre formatos de hora, consulte gcloud topic datetimes.

Pastas

gcloud asset query \
    --folder=FOLDER_ID \
    --snapshot-time="SNAPSHOT_TIME" \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance
      WHERE
        resource.location LIKE '%asia%'"

Forneça os valores a seguir:

FOLDER_ID: o ID da pasta cuja metadados que você quer consultar.
Como encontrar um ID de pasta do Google Cloud
Console

Para encontrar um ID de pasta do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
CLI da gcloud

Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.

Para receber o ID de uma pasta dentro de outra, liste as subpastas:

gcloud resource-manager folders list --folder=FOLDER_ID
SNAPSHOT_TIME: opcional. A hora em que você quer capturar um snapshot dos seus recursos. O valor deve ser o hora atual ou uma hora não superior a 35 dias no passado. Quando não fornecido, um snapshot é capturado no momento atual. Para informações sobre formatos de hora, consulte gcloud topic datetimes.

Organizações

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --snapshot-time="SNAPSHOT_TIME" \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance
      WHERE
        resource.location LIKE '%asia%'"

Forneça os valores a seguir:

ORGANIZATION_ID: o ID da organização cujos metadados você deseja consultar.
Como encontrar um ID de organização do Google Cloud
Console

Para encontrar um ID de organização do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
CLI da gcloud

Recupere um ID da organização do Google Cloud com o seguinte comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
SNAPSHOT_TIME: opcional. A hora em que você quer capturar um snapshot dos seus recursos. O valor deve ser o hora atual ou uma hora não superior a 35 dias no passado. Quando não fornecido, um snapshot é capturado no momento atual. Para informações sobre formatos de hora, consulte gcloud topic datetimes.

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              name,
              resource.DATA.creationTimestamp
            FROM
              compute_googleapis_com_Instance
            WHERE
              resource.location LIKE \"%asia%\"",
          "readTime": "SNAPSHOT_TIME"
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Forneça os valores a seguir:

SNAPSHOT_TIME: opcional. O horário em que você Quer tirar um snapshot dos seus recursos no formato RFC 3339. O valor precisa ser a hora atual ou um horário de até 35 dias no passado Quando não é fornecido, um snapshot é capturado no momento atual.
SCOPE: um escopo pode ser um projeto, uma pasta ou organização.

Os valores permitidos são:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Como encontrar um número de projeto do Google Cloud
  Console
  
  Para encontrar um número de projeto do Google Cloud, siga estas etapas:
  
  Acesse a página Painel no console do Google Cloud.
  
  Ir para o painel
  
  Clique na caixa do seletor na barra de menus.
  
  Escolha sua organização na caixa Selecionar de e pesquise as nome do projeto.
  
  Clique no nome do projeto para alternar para ele. O número do projeto é mostrado Card Informações do projeto.
  
  CLI da gcloud
  
  Recupere um número de projeto do Google Cloud com o seguinte comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Como encontrar um ID de pasta do Google Cloud
  Console
  
  Para encontrar um ID de pasta do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
  
  CLI da gcloud
  
  Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.
  
  Para receber o ID de uma pasta dentro de outra, liste as subpastas:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Como encontrar um ID de organização do Google Cloud
  Console
  
  Para encontrar um ID de organização do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
  
  CLI da gcloud
  
  Recupere um ID da organização do Google Cloud com o seguinte comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Consultar para identificar o histórico de alterações das VMs em um intervalo de tempo específico

gcloud

Projetos

gcloud asset query \
    --project=PROJECT_ID \
    --start-time="START_TIME" \
    --end-time="END_TIME" \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance"

Forneça os valores a seguir:

PROJECT_ID: o ID do projeto cujo que você quer listar.
START_TIME: opcional. O início da período. O período máximo é de sete dias. O valor deve ser o hora atual ou uma hora não superior a 35 dias no passado. Para Para saber mais sobre formatos de hora, consulte gcloud topic datetimes.
END_TIME: opcional. O ponto final do o período. O período máximo é de sete dias. O valor deve ser a hora atual ou uma hora não superior a 35 dias no passado. Quando não fornecido, a hora de término será a hora atual. Para Para saber mais sobre formatos de hora, consulte gcloud topic datetimes.

Pastas

gcloud asset query \
    --folder=FOLDER_ID \
    --start-time="START_TIME" \
    --end-time="END_TIME" \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance"

Forneça os valores a seguir:

FOLDER_ID: o ID da pasta cuja que você quer listar.
Como encontrar um ID de pasta do Google Cloud
Console

Para encontrar um ID de pasta do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
CLI da gcloud

Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.

Para receber o ID de uma pasta dentro de outra, liste as subpastas:

gcloud resource-manager folders list --folder=FOLDER_ID
START_TIME: opcional. O início da período. O período máximo é de sete dias. O valor deve ser o hora atual ou uma hora não superior a 35 dias no passado. Para Para saber mais sobre formatos de hora, consulte gcloud topic datetimes.
END_TIME: opcional. O ponto final do o período. O período máximo é de sete dias. O valor deve ser a hora atual ou uma hora não superior a 35 dias no passado. Quando não fornecido, a hora de término será a hora atual. Para Para saber mais sobre formatos de hora, consulte gcloud topic datetimes.

Organizações

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --start-time="START_TIME" \
    --end-time="END_TIME" \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance"

Forneça os valores a seguir:

ORGANIZATION_ID: o ID da organização cujos recursos você deseja listar.
Como encontrar um ID de organização do Google Cloud
Console

Para encontrar um ID de organização do Google Cloud, siga estas etapas:

Acesse o console do Google Cloud.

Acessar o console do Google Cloud

Clique na caixa do seletor na barra de menus.

Clique na caixa Selecionar de e escolha a organização.

Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
CLI da gcloud

Recupere um ID da organização do Google Cloud com o seguinte comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
START_TIME: opcional. O início da período. O período máximo é de sete dias. O valor deve ser o hora atual ou uma hora não superior a 35 dias no passado. Para Para saber mais sobre formatos de hora, consulte gcloud topic datetimes.
END_TIME: opcional. O ponto final do o período. O período máximo é de sete dias. O valor deve ser a hora atual ou uma hora não superior a 35 dias no passado. Quando não fornecido, a hora de término será a hora atual. Para Para saber mais sobre formatos de hora, consulte gcloud topic datetimes.

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              name,
              resource.DATA.creationTimestamp
            FROM
              compute_googleapis_com_Instance",
          "readTimeWindow": {
            "startTime": "START_TIME",
            "endTime": "END_TIME"
          }
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Forneça os valores a seguir:

START_TIME: opcional. Desde o começo do intervalo 10.240.0.0/16. O período máximo é de sete dias. O valor precisa ser o uma vez ou em um período de no máximo 35 dias no passado. Para informações sobre horário formatos, consulte gcloud topic datetimes.
END_TIME: opcional. O ponto final do período. O período máximo é de sete dias. O valor deve ser o hora atual ou uma hora não superior a 35 dias no passado. Quando não fornecido, a hora de término será a hora atual. Para informações sobre formatos de horário, consulte gcloud topic datetimes.
SCOPE: um escopo pode ser um projeto, uma pasta ou organização.

Os valores permitidos são:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Como encontrar um número de projeto do Google Cloud
  Console
  
  Para encontrar um número de projeto do Google Cloud, siga estas etapas:
  
  Acesse a página Painel no console do Google Cloud.
  
  Ir para o painel
  
  Clique na caixa do seletor na barra de menus.
  
  Escolha sua organização na caixa Selecionar de e pesquise as nome do projeto.
  
  Clique no nome do projeto para alternar para ele. O número do projeto é mostrado Card Informações do projeto.
  
  CLI da gcloud
  
  Recupere um número de projeto do Google Cloud com o seguinte comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Como encontrar um ID de pasta do Google Cloud
  Console
  
  Para encontrar um ID de pasta do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Pesquise o nome da sua pasta. O ID da pasta é mostrado ao lado do nome dela.
  
  CLI da gcloud
  
  Para recuperar um ID de pasta do Google Cloud localizado no nível da organização, use o seguinte comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Em que TOP_LEVEL_FOLDER_NAME pode ser uma correspondência de string completa ou parcial. Remova o A opção --format para mais informações sobre as pastas encontradas.
  
  Para receber o ID de uma pasta dentro de outra, liste as subpastas:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Como encontrar um ID de organização do Google Cloud
  Console
  
  Para encontrar um ID de organização do Google Cloud, siga estas etapas:
  
  Acesse o console do Google Cloud.
  
  Acessar o console do Google Cloud
  
  Clique na caixa do seletor na barra de menus.
  
  Clique na caixa Selecionar de e escolha a organização.
  
  Selecione a guia Todos. O ID é mostrado ao lado do nome da organização.
  
  CLI da gcloud
  
  Recupere um ID da organização do Google Cloud com o seguinte comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Consultar recursos

Limitações

Antes de começar

CLI da gcloud

REST

Permissões

Formatar uma consulta

Formato de resposta dos valores do campo

Consultar no console do Google Cloud

Console

Salvar os resultados da consulta

gcloud

Projetos

Pastas

Console

CLI da gcloud

Organizações

Console

CLI da gcloud

REST

Console

CLI da gcloud

Console

CLI da gcloud

Console

CLI da gcloud

Amostras de consultas

Recursos de consulta

gcloud

Projetos

Pastas

Console

CLI da gcloud

Organizações

Console

CLI da gcloud

REST

Console

CLI da gcloud

Console

CLI da gcloud

Console

CLI da gcloud

Consultar metadados padrão de recursos em tipos de recursos

gcloud

Projetos

Pastas

Console

CLI da gcloud

Organizações

Console

CLI da gcloud

REST

Console

CLI da gcloud

Console

CLI da gcloud

Console

CLI da gcloud

Como buscar uma resposta de forma assíncrona por referência de trabalho

gcloud

Projetos

Pastas

Console

CLI da gcloud

Organizações

Console

CLI da gcloud

REST

Console

CLI da gcloud

Console

CLI da gcloud

Console

CLI da gcloud

Como buscar a próxima página de resultados de solicitações paginadas com a API REST

Console

CLI da gcloud

Console

CLI da gcloud