Questa pagina è stata tradotta dall'API Cloud Translation.

Esportare i metadati delle risorse in BigQuery

Questo documento mostra come esportare uno snapshot delle risorse dalla tua organizzazione, cartella o progetto in una tabella BigQuery e poi eseguire l'analisi dei dati sul tuo inventario. BigQuery offre agli utenti un'esperienza simile a SQL per analizzare i dati e produrre informazioni significative senza l'utilizzo di script personalizzati.

Prima di iniziare

Abilita l'API Cloud Asset Inventory nel progetto da cui esegui i comandi Cloud Asset Inventory.

Abilita l'API Cloud Asset Inventory
Assicurati che il tuo account disponga del ruolo corretto per chiamare l'API Cloud Asset Inventory. Per le singole autorizzazioni per ogni tipo di chiamata, vedi Autorizzazioni.
Crea un set di dati BigQuery in cui esportare i dati, se non ne hai già uno.

Limitazioni

Quando esporti i dati delle tabelle BigQuery, non tutti i campi sono supportati da Cloud Asset Inventory.
I campi delle risorse che cambiano di frequente, come numBytes, numLongTermBytes, numPhysicalBytes e numRows, potrebbero essere esportati con un valore null.
L'esportazione nelle tabelle BigQuery in cluster non è supportata.
Le tabelle BigQuery criptate con chiavi Cloud Key Management Service (Cloud KMS) personalizzate non sono supportate.
L'aggiunta dell'output dell'esportazione a una tabella esistente non è supportata, a meno che tu non esporti in una tabella partizionata. La tabella di destinazione deve essere vuota o devi sovrascriverla. Per sovrascriverlo, utilizza il flag --output-bigquery-force con gcloud CLI oppure utilizza "force": true con l'API REST.
I tipi di risorse Google Kubernetes Engine (GKE), ad eccezione di container.googleapis.com/Cluster e container.googleapis.com/NodePool, non sono supportati durante l'esportazione in tabelle separate per ogni tipo di risorsa.
Cloud Asset Inventory rifiuta le richieste di esportazione se una richiesta precedente alla stessa destinazione è stata avviata meno di 15 minuti fa ed è ancora in esecuzione. Tuttavia, se un'esportazione ha richiesto più di 15 minuti per essere completata, viene contrassegnata come completata e sono consentite nuove richieste di esportazione nella stessa destinazione.
Il tipo di contenuti ACCESS_POLICY può essere esportato solo a livello di organizzazione.
Se la tabella in cui stai esportando esiste già ed è in fase di esportazione, viene restituito un errore 400.

Schemi BigQuery utilizzati per l'esportazione

Ogni tabella BigQuery è definita da uno schema che descrive i nomi delle colonne, i tipi di dati e altre informazioni. L'impostazione del tipo di contenuti per un'esportazione determina lo schema della tabella:

Risorsa o non specificato:quando imposti il tipo di contenuti su RESOURCE o non lo specifichi e imposti il flag per-asset-type su false o non lo utilizzi, crei una tabella BigQuery con lo schema seguente.

Schema delle risorse

[
  {
    "mode": "NULLABLE",
    "name": "name",
    "type": "STRING"
  },
  {
    "mode": "NULLABLE",
    "name": "asset_type",
    "type": "STRING"
  },
  {
    "fields": [
      {
        "mode": "NULLABLE",
        "name": "version",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "discovery_document_uri",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "discovery_name",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "resource_url",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "parent",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "data",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "location",
        "type": "STRING"
      }
    ],
    "mode": "NULLABLE",
    "name": "resource",
    "type": "RECORD"
  },
  {
    "mode": "REPEATED",
    "name": "ancestors",
    "type": "STRING"
  },
  {
    "mode": "NULLABLE",
    "name": "update_time",
    "type": "TIMESTAMP"
  }
]

La colonna resource.data contiene i metadati della risorsa rappresentati come stringa JSON.

Quando imposti il tipo di contenuti su RESOURCE o non lo imposti e imposti il flag per-asset-type su true, crei tabelle separate per ogni tipo di asset. Lo schema di ogni tabella include colonne di tipo RECORD mappate ai campi nidificati nel campo Resource.data di quel tipo di asset (fino a 15 livelli nidificati supportati da BigQuery). Per tabelle di esempio, vedi export-assets-examples nella console Google Cloud .

Policy IAM:quando imposti il tipo di contenuti su IAM_POLICY nell'API REST o su iam-policy in gcloud CLI, crei una tabella BigQuery con lo schema seguente.

Schema della policy IAM

[
  {
    "mode": "NULLABLE",
    "name": "name",
    "type": "STRING"
  },
  {
    "mode": "NULLABLE",
    "name": "asset_type",
    "type": "STRING"
  },
  {
    "fields": [
      {
        "mode": "NULLABLE",
        "name": "version",
        "type": "INTEGER"
      },
      {
        "fields": [
          {
            "mode": "NULLABLE",
            "name": "role",
            "type": "STRING"
          },
          {
            "mode": "REPEATED",
            "name": "members",
            "type": "STRING"
          },
          {
            "fields": [
              {
                "mode": "NULLABLE",
                "name": "expression",
                "type": "STRING"
              },
              {
                "mode": "NULLABLE",
                "name": "title",
                "type": "STRING"
              },
              {
                "mode": "NULLABLE",
                "name": "description",
                "type": "STRING"
              },
              {
                "mode": "NULLABLE",
                "name": "location",
                "type": "STRING"
              }
            ],
            "mode": "NULLABLE",
            "name": "condition",
            "type": "RECORD"
          }
        ],
        "mode": "REPEATED",
        "name": "bindings",
        "type": "RECORD"
      },
      {
        "fields": [
          {
            "mode": "NULLABLE",
            "name": "service",
            "type": "STRING"
          },
          {
            "fields": [
              {
                "mode": "NULLABLE",
                "name": "log_type",
                "type": "INTEGER"
              },
              {
                "mode": "REPEATED",
                "name": "exempted_members",
                "type": "STRING"
              }
            ],
            "mode": "REPEATED",
            "name": "audit_log_configs",
            "type": "RECORD"
          }
        ],
        "mode": "REPEATED",
        "name": "audit_configs",
        "type": "RECORD"
      },
      {
        "mode": "NULLABLE",
        "name": "etag",
        "type": "STRING"
      }
    ],
    "mode": "NULLABLE",
    "name": "iam_policy",
    "type": "RECORD"
  },
  {
    "mode": "REPEATED",
    "name": "ancestors",
    "type": "STRING"
  },
  {
    "mode": "NULLABLE",
    "name": "update_time",
    "type": "TIMESTAMP"
  }
]

Policy dell'organizzazione:quando imposti il tipo di contenuti su ORG_POLICY nell'API REST o su org-policy in gcloud CLI, crei una tabella BigQuery con lo schema seguente.

Schema dei criteri dell'organizzazione

[
  {
    "mode": "NULLABLE",
    "name": "name",
    "type": "STRING"
  },
  {
    "mode": "NULLABLE",
    "name": "asset_type",
    "type": "STRING"
  },
  {
    "fields": [
      {
        "mode": "NULLABLE",
        "name": "version",
        "type": "INTEGER"
      },
      {
        "mode": "NULLABLE",
        "name": "constraint",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "etag",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "update_time",
        "type": "TIMESTAMP"
      },
      {
        "fields": [
          {
            "mode": "REPEATED",
            "name": "allowed_values",
            "type": "STRING"
          },
          {
            "mode": "REPEATED",
            "name": "denied_values",
            "type": "STRING"
          },
          {
            "mode": "NULLABLE",
            "name": "all_values",
            "type": "INTEGER"
          },
          {
            "mode": "NULLABLE",
            "name": "suggested_value",
            "type": "STRING"
          },
          {
            "mode": "NULLABLE",
            "name": "inherit_from_parent",
            "type": "BOOLEAN"
          }
        ],
        "mode": "NULLABLE",
        "name": "list_policy",
        "type": "RECORD"
      },
      {
        "fields": [
          {
            "mode": "NULLABLE",
            "name": "enforced",
            "type": "BOOLEAN"
          }
        ],
        "mode": "NULLABLE",
        "name": "boolean_policy",
        "type": "RECORD"
      },
      {
        "fields": [
          {
            "mode": "NULLABLE",
            "name": "_present",
            "type": "BOOLEAN"
          }
        ],
        "mode": "NULLABLE",
        "name": "restore_default",
        "type": "RECORD"
      }
    ],
    "mode": "REPEATED",
    "name": "org_policy",
    "type": "RECORD"
  },
  {
    "mode": "REPEATED",
    "name": "ancestors",
    "type": "STRING"
  },
  {
    "mode": "NULLABLE",
    "name": "update_time",
    "type": "TIMESTAMP"
  }
]

Policy VPC SC: quando imposti il tipo di contenuti su ACCESS_POLICY nell'API REST o su access-policy in gcloud CLI, crei una tabella BigQuery con lo schema seguente.

Schema delle norme VPCSC

[
  {
    "mode": "NULLABLE",
    "name": "name",
    "type": "STRING"
  },
  {
    "mode": "NULLABLE",
    "name": "asset_type",
    "type": "STRING"
  },
  {
    "fields": [
      {
        "mode": "NULLABLE",
        "name": "name",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "parent",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "title",
        "type": "STRING"
      },
      {
        "mode": "REPEATED",
        "name": "scopes",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "etag",
        "type": "STRING"
      }
    ],
    "mode": "NULLABLE",
    "name": "access_policy",
    "type": "RECORD"
  },
  {
    "fields": [
      {
        "mode": "NULLABLE",
        "name": "name",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "title",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "description",
        "type": "STRING"
      },
      {
        "fields": [
          {
            "fields": [
              {
                "mode": "REPEATED",
                "name": "ip_subnetworks",
                "type": "STRING"
              },
              {
                "fields": [
                  {
                    "mode": "NULLABLE",
                    "name": "require_screenlock",
                    "type": "BOOLEAN"
                  },
                  {
                    "mode": "REPEATED",
                    "name": "allowed_encryption_statuses",
                    "type": "INTEGER"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "os_type",
                        "type": "INTEGER"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "minimum_version",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "require_verified_chrome_os",
                        "type": "BOOLEAN"
                      }
                    ],
                    "mode": "REPEATED",
                    "name": "os_constraints",
                    "type": "RECORD"
                  },
                  {
                    "mode": "REPEATED",
                    "name": "allowed_device_management_levels",
                    "type": "INTEGER"
                  },
                  {
                    "mode": "NULLABLE",
                    "name": "require_admin_approval",
                    "type": "BOOLEAN"
                  },
                  {
                    "mode": "NULLABLE",
                    "name": "require_corp_owned",
                    "type": "BOOLEAN"
                  }
                ],
                "mode": "NULLABLE",
                "name": "device_policy",
                "type": "RECORD"
              },
              {
                "mode": "REPEATED",
                "name": "required_access_levels",
                "type": "STRING"
              },
              {
                "mode": "NULLABLE",
                "name": "negate",
                "type": "BOOLEAN"
              },
              {
                "mode": "REPEATED",
                "name": "members",
                "type": "STRING"
              },
              {
                "mode": "REPEATED",
                "name": "regions",
                "type": "STRING"
              },
              {
                "fields": [
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "network",
                        "type": "STRING"
                      },
                      {
                        "mode": "REPEATED",
                        "name": "vpc_ip_subnetworks",
                        "type": "STRING"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "vpc_subnetwork",
                    "type": "RECORD"
                  }
                ],
                "mode": "REPEATED",
                "name": "vpc_network_sources",
                "type": "RECORD"
              }
            ],
            "mode": "REPEATED",
            "name": "conditions",
            "type": "RECORD"
          },
          {
            "mode": "NULLABLE",
            "name": "combining_function",
            "type": "INTEGER"
          }
        ],
        "mode": "NULLABLE",
        "name": "basic",
        "type": "RECORD"
      },
      {
        "fields": [
          {
            "fields": [
              {
                "mode": "NULLABLE",
                "name": "expression",
                "type": "STRING"
              },
              {
                "mode": "NULLABLE",
                "name": "title",
                "type": "STRING"
              },
              {
                "mode": "NULLABLE",
                "name": "description",
                "type": "STRING"
              },
              {
                "mode": "NULLABLE",
                "name": "location",
                "type": "STRING"
              }
            ],
            "mode": "NULLABLE",
            "name": "expr",
            "type": "RECORD"
          }
        ],
        "mode": "NULLABLE",
        "name": "custom",
        "type": "RECORD"
      }
    ],
    "mode": "NULLABLE",
    "name": "access_level",
    "type": "RECORD"
  },
  {
    "fields": [
      {
        "mode": "NULLABLE",
        "name": "name",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "title",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "description",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "perimeter_type",
        "type": "INTEGER"
      },
      {
        "fields": [
          {
            "mode": "REPEATED",
            "name": "resources",
            "type": "STRING"
          },
          {
            "mode": "REPEATED",
            "name": "access_levels",
            "type": "STRING"
          },
          {
            "mode": "REPEATED",
            "name": "restricted_services",
            "type": "STRING"
          },
          {
            "fields": [
              {
                "mode": "NULLABLE",
                "name": "enable_restriction",
                "type": "BOOLEAN"
              },
              {
                "mode": "REPEATED",
                "name": "allowed_services",
                "type": "STRING"
              }
            ],
            "mode": "NULLABLE",
            "name": "vpc_accessible_services",
            "type": "RECORD"
          },
          {
            "fields": [
              {
                "fields": [
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "access_level",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "resource",
                        "type": "STRING"
                      }
                    ],
                    "mode": "REPEATED",
                    "name": "sources",
                    "type": "RECORD"
                  },
                  {
                    "mode": "REPEATED",
                    "name": "identities",
                    "type": "STRING"
                  },
                  {
                    "mode": "NULLABLE",
                    "name": "identity_type",
                    "type": "INTEGER"
                  }
                ],
                "mode": "NULLABLE",
                "name": "ingress_from",
                "type": "RECORD"
              },
              {
                "fields": [
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "service_name",
                        "type": "STRING"
                      },
                      {
                        "fields": [
                          {
                            "mode": "NULLABLE",
                            "name": "method",
                            "type": "STRING"
                          },
                          {
                            "mode": "NULLABLE",
                            "name": "permission",
                            "type": "STRING"
                          }
                        ],
                        "mode": "REPEATED",
                        "name": "method_selectors",
                        "type": "RECORD"
                      }
                    ],
                    "mode": "REPEATED",
                    "name": "operations",
                    "type": "RECORD"
                  },
                  {
                    "mode": "REPEATED",
                    "name": "resources",
                    "type": "STRING"
                  }
                ],
                "mode": "NULLABLE",
                "name": "ingress_to",
                "type": "RECORD"
              },
              {
                "mode": "NULLABLE",
                "name": "title",
                "type": "STRING"
              }
            ],
            "mode": "REPEATED",
            "name": "ingress_policies",
            "type": "RECORD"
          },
          {
            "fields": [
              {
                "fields": [
                  {
                    "mode": "REPEATED",
                    "name": "identities",
                    "type": "STRING"
                  },
                  {
                    "mode": "NULLABLE",
                    "name": "identity_type",
                    "type": "INTEGER"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "access_level",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "resource",
                        "type": "STRING"
                      }
                    ],
                    "mode": "REPEATED",
                    "name": "sources",
                    "type": "RECORD"
                  },
                  {
                    "mode": "NULLABLE",
                    "name": "source_restriction",
                    "type": "INTEGER"
                  }
                ],
                "mode": "NULLABLE",
                "name": "egress_from",
                "type": "RECORD"
              },
              {
                "fields": [
                  {
                    "mode": "REPEATED",
                    "name": "resources",
                    "type": "STRING"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "service_name",
                        "type": "STRING"
                      },
                      {
                        "fields": [
                          {
                            "mode": "NULLABLE",
                            "name": "method",
                            "type": "STRING"
                          },
                          {
                            "mode": "NULLABLE",
                            "name": "permission",
                            "type": "STRING"
                          }
                        ],
                        "mode": "REPEATED",
                        "name": "method_selectors",
                        "type": "RECORD"
                      }
                    ],
                    "mode": "REPEATED",
                    "name": "operations",
                    "type": "RECORD"
                  },
                  {
                    "mode": "REPEATED",
                    "name": "external_resources",
                    "type": "STRING"
                  }
                ],
                "mode": "NULLABLE",
                "name": "egress_to",
                "type": "RECORD"
              },
              {
                "mode": "NULLABLE",
                "name": "title",
                "type": "STRING"
              }
            ],
            "mode": "REPEATED",
            "name": "egress_policies",
            "type": "RECORD"
          }
        ],
        "mode": "NULLABLE",
        "name": "status",
        "type": "RECORD"
      },
      {
        "fields": [
          {
            "mode": "REPEATED",
            "name": "resources",
            "type": "STRING"
          },
          {
            "mode": "REPEATED",
            "name": "access_levels",
            "type": "STRING"
          },
          {
            "mode": "REPEATED",
            "name": "restricted_services",
            "type": "STRING"
          },
          {
            "fields": [
              {
                "mode": "NULLABLE",
                "name": "enable_restriction",
                "type": "BOOLEAN"
              },
              {
                "mode": "REPEATED",
                "name": "allowed_services",
                "type": "STRING"
              }
            ],
            "mode": "NULLABLE",
            "name": "vpc_accessible_services",
            "type": "RECORD"
          },
          {
            "fields": [
              {
                "fields": [
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "access_level",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "resource",
                        "type": "STRING"
                      }
                    ],
                    "mode": "REPEATED",
                    "name": "sources",
                    "type": "RECORD"
                  },
                  {
                    "mode": "REPEATED",
                    "name": "identities",
                    "type": "STRING"
                  },
                  {
                    "mode": "NULLABLE",
                    "name": "identity_type",
                    "type": "INTEGER"
                  }
                ],
                "mode": "NULLABLE",
                "name": "ingress_from",
                "type": "RECORD"
              },
              {
                "fields": [
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "service_name",
                        "type": "STRING"
                      },
                      {
                        "fields": [
                          {
                            "mode": "NULLABLE",
                            "name": "method",
                            "type": "STRING"
                          },
                          {
                            "mode": "NULLABLE",
                            "name": "permission",
                            "type": "STRING"
                          }
                        ],
                        "mode": "REPEATED",
                        "name": "method_selectors",
                        "type": "RECORD"
                      }
                    ],
                    "mode": "REPEATED",
                    "name": "operations",
                    "type": "RECORD"
                  },
                  {
                    "mode": "REPEATED",
                    "name": "resources",
                    "type": "STRING"
                  }
                ],
                "mode": "NULLABLE",
                "name": "ingress_to",
                "type": "RECORD"
              },
              {
                "mode": "NULLABLE",
                "name": "title",
                "type": "STRING"
              }
            ],
            "mode": "REPEATED",
            "name": "ingress_policies",
            "type": "RECORD"
          },
          {
            "fields": [
              {
                "fields": [
                  {
                    "mode": "REPEATED",
                    "name": "identities",
                    "type": "STRING"
                  },
                  {
                    "mode": "NULLABLE",
                    "name": "identity_type",
                    "type": "INTEGER"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "access_level",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "resource",
                        "type": "STRING"
                      }
                    ],
                    "mode": "REPEATED",
                    "name": "sources",
                    "type": "RECORD"
                  },
                  {
                    "mode": "NULLABLE",
                    "name": "source_restriction",
                    "type": "INTEGER"
                  }
                ],
                "mode": "NULLABLE",
                "name": "egress_from",
                "type": "RECORD"
              },
              {
                "fields": [
                  {
                    "mode": "REPEATED",
                    "name": "resources",
                    "type": "STRING"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "service_name",
                        "type": "STRING"
                      },
                      {
                        "fields": [
                          {
                            "mode": "NULLABLE",
                            "name": "method",
                            "type": "STRING"
                          },
                          {
                            "mode": "NULLABLE",
                            "name": "permission",
                            "type": "STRING"
                          }
                        ],
                        "mode": "REPEATED",
                        "name": "method_selectors",
                        "type": "RECORD"
                      }
                    ],
                    "mode": "REPEATED",
                    "name": "operations",
                    "type": "RECORD"
                  },
                  {
                    "mode": "REPEATED",
                    "name": "external_resources",
                    "type": "STRING"
                  }
                ],
                "mode": "NULLABLE",
                "name": "egress_to",
                "type": "RECORD"
              },
              {
                "mode": "NULLABLE",
                "name": "title",
                "type": "STRING"
              }
            ],
            "mode": "REPEATED",
            "name": "egress_policies",
            "type": "RECORD"
          }
        ],
        "mode": "NULLABLE",
        "name": "spec",
        "type": "RECORD"
      },
      {
        "mode": "NULLABLE",
        "name": "use_explicit_dry_run_spec",
        "type": "BOOLEAN"
      },
      {
        "mode": "NULLABLE",
        "name": "etag",
        "type": "STRING"
      }
    ],
    "mode": "NULLABLE",
    "name": "service_perimeter",
    "type": "RECORD"
  },
  {
    "fields": [
      {
        "mode": "NULLABLE",
        "name": "name",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "authorization_type",
        "type": "INTEGER"
      },
      {
        "mode": "NULLABLE",
        "name": "asset_type",
        "type": "INTEGER"
      },
      {
        "mode": "NULLABLE",
        "name": "authorization_direction",
        "type": "INTEGER"
      },
      {
        "mode": "REPEATED",
        "name": "orgs",
        "type": "STRING"
      }
    ],
    "mode": "NULLABLE",
    "name": "authorized_orgs_desc",
    "type": "RECORD"
  },
  {
    "mode": "REPEATED",
    "name": "ancestors",
    "type": "STRING"
  },
  {
    "mode": "NULLABLE",
    "name": "update_time",
    "type": "TIMESTAMP"
  }
]

Inventario delle istanze OSConfig:quando imposti il tipo di contenuti su OS_INVENTORY nell'API REST o su os-inventory in gcloud CLI, crei una tabella BigQuery con lo schema seguente.

Schema dell'inventario del sistema operativo

[
  {
    "mode": "NULLABLE",
    "name": "name",
    "type": "STRING"
  },
  {
    "mode": "NULLABLE",
    "name": "asset_type",
    "type": "STRING"
  },
  {
    "fields": [
      {
        "mode": "NULLABLE",
        "name": "name",
        "type": "STRING"
      },
      {
        "fields": [
          {
            "mode": "NULLABLE",
            "name": "hostname",
            "type": "STRING"
          },
          {
            "mode": "NULLABLE",
            "name": "long_name",
            "type": "STRING"
          },
          {
            "mode": "NULLABLE",
            "name": "short_name",
            "type": "STRING"
          },
          {
            "mode": "NULLABLE",
            "name": "version",
            "type": "STRING"
          },
          {
            "mode": "NULLABLE",
            "name": "architecture",
            "type": "STRING"
          },
          {
            "mode": "NULLABLE",
            "name": "kernel_version",
            "type": "STRING"
          },
          {
            "mode": "NULLABLE",
            "name": "kernel_release",
            "type": "STRING"
          },
          {
            "mode": "NULLABLE",
            "name": "osconfig_agent_version",
            "type": "STRING"
          }
        ],
        "mode": "NULLABLE",
        "name": "os_info",
        "type": "RECORD"
      },
      {
        "fields": [
          {
            "mode": "NULLABLE",
            "name": "key",
            "type": "STRING"
          },
          {
            "fields": [
              {
                "mode": "NULLABLE",
                "name": "id",
                "type": "STRING"
              },
              {
                "mode": "NULLABLE",
                "name": "origin_type",
                "type": "INTEGER"
              },
              {
                "mode": "NULLABLE",
                "name": "create_time",
                "type": "TIMESTAMP"
              },
              {
                "mode": "NULLABLE",
                "name": "update_time",
                "type": "TIMESTAMP"
              },
              {
                "mode": "NULLABLE",
                "name": "type",
                "type": "INTEGER"
              },
              {
                "fields": [
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "package_name",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "architecture",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "version",
                        "type": "STRING"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "yum_package",
                    "type": "RECORD"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "package_name",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "architecture",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "version",
                        "type": "STRING"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "apt_package",
                    "type": "RECORD"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "package_name",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "architecture",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "version",
                        "type": "STRING"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "zypper_package",
                    "type": "RECORD"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "package_name",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "architecture",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "version",
                        "type": "STRING"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "googet_package",
                    "type": "RECORD"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "patch_name",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "category",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "severity",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "summary",
                        "type": "STRING"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "zypper_patch",
                    "type": "RECORD"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "title",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "description",
                        "type": "STRING"
                      },
                      {
                        "fields": [
                          {
                            "mode": "NULLABLE",
                            "name": "id",
                            "type": "STRING"
                          },
                          {
                            "mode": "NULLABLE",
                            "name": "name",
                            "type": "STRING"
                          }
                        ],
                        "mode": "REPEATED",
                        "name": "categories",
                        "type": "RECORD"
                      },
                      {
                        "mode": "REPEATED",
                        "name": "kb_article_ids",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "support_url",
                        "type": "STRING"
                      },
                      {
                        "mode": "REPEATED",
                        "name": "more_info_urls",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "update_id",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "revision_number",
                        "type": "INTEGER"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "last_deployment_change_time",
                        "type": "TIMESTAMP"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "wua_package",
                    "type": "RECORD"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "caption",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "description",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "hot_fix_id",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "install_time",
                        "type": "TIMESTAMP"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "qfe_package",
                    "type": "RECORD"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "package_name",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "architecture",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "version",
                        "type": "STRING"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "cos_package",
                    "type": "RECORD"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "display_name",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "display_version",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "publisher",
                        "type": "STRING"
                      },
                      {
                        "fields": [
                          {
                            "mode": "NULLABLE",
                            "name": "year",
                            "type": "INTEGER"
                          },
                          {
                            "mode": "NULLABLE",
                            "name": "month",
                            "type": "INTEGER"
                          },
                          {
                            "mode": "NULLABLE",
                            "name": "day",
                            "type": "INTEGER"
                          }
                        ],
                        "mode": "NULLABLE",
                        "name": "install_date",
                        "type": "RECORD"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "help_link",
                        "type": "STRING"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "windows_application",
                    "type": "RECORD"
                  }
                ],
                "mode": "NULLABLE",
                "name": "installed_package",
                "type": "RECORD"
              },
              {
                "fields": [
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "package_name",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "architecture",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "version",
                        "type": "STRING"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "yum_package",
                    "type": "RECORD"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "package_name",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "architecture",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "version",
                        "type": "STRING"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "apt_package",
                    "type": "RECORD"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "package_name",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "architecture",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "version",
                        "type": "STRING"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "zypper_package",
                    "type": "RECORD"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "package_name",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "architecture",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "version",
                        "type": "STRING"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "googet_package",
                    "type": "RECORD"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "patch_name",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "category",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "severity",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "summary",
                        "type": "STRING"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "zypper_patch",
                    "type": "RECORD"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "title",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "description",
                        "type": "STRING"
                      },
                      {
                        "fields": [
                          {
                            "mode": "NULLABLE",
                            "name": "id",
                            "type": "STRING"
                          },
                          {
                            "mode": "NULLABLE",
                            "name": "name",
                            "type": "STRING"
                          }
                        ],
                        "mode": "REPEATED",
                        "name": "categories",
                        "type": "RECORD"
                      },
                      {
                        "mode": "REPEATED",
                        "name": "kb_article_ids",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "support_url",
                        "type": "STRING"
                      },
                      {
                        "mode": "REPEATED",
                        "name": "more_info_urls",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "update_id",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "revision_number",
                        "type": "INTEGER"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "last_deployment_change_time",
                        "type": "TIMESTAMP"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "wua_package",
                    "type": "RECORD"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "caption",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "description",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "hot_fix_id",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "install_time",
                        "type": "TIMESTAMP"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "qfe_package",
                    "type": "RECORD"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "package_name",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "architecture",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "version",
                        "type": "STRING"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "cos_package",
                    "type": "RECORD"
                  },
                  {
                    "fields": [
                      {
                        "mode": "NULLABLE",
                        "name": "display_name",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "display_version",
                        "type": "STRING"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "publisher",
                        "type": "STRING"
                      },
                      {
                        "fields": [
                          {
                            "mode": "NULLABLE",
                            "name": "year",
                            "type": "INTEGER"
                          },
                          {
                            "mode": "NULLABLE",
                            "name": "month",
                            "type": "INTEGER"
                          },
                          {
                            "mode": "NULLABLE",
                            "name": "day",
                            "type": "INTEGER"
                          }
                        ],
                        "mode": "NULLABLE",
                        "name": "install_date",
                        "type": "RECORD"
                      },
                      {
                        "mode": "NULLABLE",
                        "name": "help_link",
                        "type": "STRING"
                      }
                    ],
                    "mode": "NULLABLE",
                    "name": "windows_application",
                    "type": "RECORD"
                  }
                ],
                "mode": "NULLABLE",
                "name": "available_package",
                "type": "RECORD"
              }
            ],
            "mode": "NULLABLE",
            "name": "value",
            "type": "RECORD"
          }
        ],
        "mode": "REPEATED",
        "name": "items",
        "type": "RECORD"
      },
      {
        "mode": "NULLABLE",
        "name": "update_time",
        "type": "TIMESTAMP"
      }
    ],
    "mode": "NULLABLE",
    "name": "os_inventory",
    "type": "RECORD"
  },
  {
    "mode": "REPEATED",
    "name": "ancestors",
    "type": "STRING"
  },
  {
    "mode": "NULLABLE",
    "name": "update_time",
    "type": "TIMESTAMP"
  }
]

Relazione:quando imposti il tipo di contenuti su RELATIONSHIP nell'API REST o su relationship in gcloud CLI, crei una tabella BigQuery con lo schema seguente.

Schema Relationship

[
  {
    "mode": "NULLABLE",
    "name": "name",
    "type": "STRING"
  },
  {
    "mode": "NULLABLE",
    "name": "asset_type",
    "type": "STRING"
  },
  {
    "fields": [
      {
        "mode": "NULLABLE",
        "name": "asset",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "asset_type",
        "type": "STRING"
      },
      {
        "mode": "REPEATED",
        "name": "ancestors",
        "type": "STRING"
      },
      {
        "mode": "NULLABLE",
        "name": "relationship_type",
        "type": "STRING"
      }
    ],
    "mode": "NULLABLE",
    "name": "related_asset",
    "type": "RECORD"
  },
  {
    "mode": "REPEATED",
    "name": "ancestors",
    "type": "STRING"
  },
  {
    "mode": "NULLABLE",
    "name": "update_time",
    "type": "TIMESTAMP"
  }
]

Esportare uno snapshot di un asset

gcloud

gcloud asset export \
    --SCOPE \
    --billing-project=BILLING_PROJECT_ID \
    --asset-types=ASSET_TYPE_1,ASSET_TYPE_2,... \
    --content-type=CONTENT_TYPE \
    --relationship-types=RELATIONSHIP_TYPE_1,RELATIONSHIP_TYPE_2,... \
    --snapshot-time="SNAPSHOT_TIME" \
    --bigquery-table=projects/BIGQUERY_PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
    --output-bigquery-force

Fornisci i seguenti valori:

SCOPE: utilizza uno dei seguenti valori:
- project=PROJECT_ID, dove PROJECT_ID è l'ID del progetto che contiene i metadati delle risorse che vuoi esportare.
- folder=FOLDER_ID, dove FOLDER_ID è l'ID della cartella che contiene i metadati delle risorse che vuoi esportare.
  Come trovare l'ID di una Google Cloud cartella
  ConsoleGoogle Cloud
  
  Per trovare l'ID di una Google Cloud cartella:
  
  Vai alla Google Cloud console.
  
  Vai alla Google Cloud console
  
  Fai clic sulla casella di elenco selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella di elenco.
  
  Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente 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)"
  
  dove TOP_LEVEL_FOLDER_NAME è una corrispondenza parziale o completa della stringa per il nome della cartella. Rimuovi il flag --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Il comando precedente non restituisce gli ID delle sottocartelle all'interno delle cartelle. Per farlo, esegui il comando seguente utilizzando l'ID di una cartella di primo livello:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organization=ORGANIZATION_ID, dove ORGANIZATION_ID è l'ID dell'organizzazione che contiene i metadati della risorsa che vuoi esportare.
  Come trovare l'ID di un' Google Cloud organizzazione
  ConsoleGoogle Cloud
  
  Per trovare l'ID di un' Google Cloud organizzazione:
  
  Vai alla Google Cloud console.
  
  Vai alla Google Cloud console
  
  Fai clic sulla casella di elenco selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella di elenco.
  
  Fai clic sulla scheda Tutti. L'ID organizzazione viene visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di un'organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
BILLING_PROJECT_ID: (Facoltativo). L'ID progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire i set di dati e le tabelle BigQuery. Scopri di più sull'impostazione del progetto di fatturazione.
ASSET_TYPE_#: (Facoltativo). Un elenco separato da virgole di tipi di asset ricercabili. Sono supportate le espressioni regolari compatibili con RE2. Se l'espressione regolare non corrisponde a nessun tipo di asset supportato, viene restituito un errore INVALID_ARGUMENT. Quando --asset-types non è specificato, vengono restituiti tutti i tipi di asset.
CONTENT_TYPE: (Facoltativo). Il tipo di contenuti dei metadati che vuoi recuperare. Quando --content-type non è specificato, vengono restituite solo informazioni di base, come i nomi degli asset, l'ultima volta che gli asset sono stati aggiornati e i progetti, le cartelle e le organizzazioni a cui appartengono.
RELATIONSHIP_TYPE_#: (Facoltativo). Richiede l'accesso al livello Premium o Enterprise di Security Command Center o a Gemini Cloud Assist. Un elenco separato da virgole di tipi di relazione tra asset che vuoi recuperare. Affinché questa operazione funzioni, devi impostare CONTENT_TYPE su RELATIONSHIP.
SNAPSHOT_TIME: (Facoltativo). L'ora in cui vuoi acquisire uno snapshot dei tuoi asset, nel formato data e ora dell'argomento gcloud. Il valore non deve essere precedente a 35 giorni. Quando --snapshot-time non è specificato, viene creato uno snapshot all'ora corrente.
BIGQUERY_PROJECT_ID: l'ID del progetto in cui si trova la tabella BigQuery che vuoi esportare.
DATASET_ID: L'ID del set di dati BigQuery.
TABLE_NAME: La tabella BigQuery in cui esporti i metadati. Se non esiste, viene creato.

Il flag --output-bigquery-force sovrascrive la tabella di destinazione, se esiste.

Per tutte le opzioni, consulta il riferimento gcloud CLI.

Esempio

Esegui il seguente comando per esportare i metadati di resource così com'erano il 30 gennaio 2024 nel progetto my-project nella tabella BigQuery my-table.

gcloud asset export \
    --project=my-project \
    --content-type=resource \
    --snapshot-time="2024-01-30" \
    --bigquery-table=projects/my-project/datasets/my-dataset/tables/my-table \
    --output-bigquery-force

Esempio di risposta

Export in progress for root asset [projects/my-project].
Use [gcloud asset operations describe projects/000000000000/operations/ExportAssets/RESOURCE/00000000000000000000000000000000] to check the status of the operation.

REST

Metodo HTTP e URL:

POST https://cloudasset.googleapis.com/v1/SCOPE_PATH:exportAssets

Intestazioni:

X-Goog-User-Project: BILLING_PROJECT_ID

Corpo JSON della richiesta:

{
  "assetTypes": [
    "ASSET_TYPE_1",
    "ASSET_TYPE_2",
    "..."
  ],
  "contentType": "CONTENT_TYPE",
  "relationshipTypes": [
    "RELATIONSHIP_TYPE_1",
    "RELATIONSHIP_TYPE_2",
    "..."
  ],
  "readTime": "SNAPSHOT_TIME",
  "outputConfig": {
    "bigqueryDestination": {
      "dataset": "projects/BIGQUERY_PROJECT_ID/datasets/DATASET_ID",
      "table": "TABLE_NAME",
      "force": true
    }
  }
}

Fornisci i seguenti valori:

SCOPE_PATH: utilizza uno dei seguenti valori:

I valori consentiti sono:
- projects/PROJECT_ID, dove PROJECT_ID è l'ID del progetto che contiene i metadati delle risorse che vuoi esportare.
- projects/PROJECT_NUMBER, dove PROJECT_NUMBER è il numero del progetto che contiene i metadati dell'asset che vuoi esportare.
  Come trovare un Google Cloud numero di progetto
  ConsoleGoogle Cloud
  
  Per trovare un numero di progetto, completa i seguenti passaggi: Google Cloud
  
  Vai alla pagina Benvenuto nella console Google Cloud .
  
  Vai a Benvenuto
  
  Fai clic sulla casella di elenco selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella di elenco, quindi cerca il nome del tuo progetto. Il nome, il numero e l'ID progetto vengono visualizzati vicino all'intestazione Benvenuto.
  
  Vengono visualizzate fino a 4000 risorse. Se non vedi il progetto che stai cercando, vai alla pagina Gestisci risorse e filtra l'elenco utilizzando il nome del progetto.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare un Google Cloud numero di progetto con il seguente comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID, dove FOLDER_ID è l'ID della cartella che contiene i metadati delle risorse che vuoi esportare.
  Come trovare l'ID di una Google Cloud cartella
  ConsoleGoogle Cloud
  
  Per trovare l'ID di una Google Cloud cartella:
  
  Vai alla Google Cloud console.
  
  Vai alla Google Cloud console
  
  Fai clic sulla casella di elenco selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella di elenco.
  
  Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente 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)"
  
  dove TOP_LEVEL_FOLDER_NAME è una corrispondenza parziale o completa della stringa per il nome della cartella. Rimuovi il flag --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Il comando precedente non restituisce gli ID delle sottocartelle all'interno delle cartelle. Per farlo, esegui il comando seguente utilizzando l'ID di una cartella di primo livello:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID, dove ORGANIZATION_ID è l'ID dell'organizzazione che contiene i metadati della risorsa che vuoi esportare.
  Come trovare l'ID di un' Google Cloud organizzazione
  ConsoleGoogle Cloud
  
  Per trovare l'ID di un' Google Cloud organizzazione:
  
  Vai alla Google Cloud console.
  
  Vai alla Google Cloud console
  
  Fai clic sulla casella di elenco selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella di elenco.
  
  Fai clic sulla scheda Tutti. L'ID organizzazione viene visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di un'organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
BILLING_PROJECT_ID: l'ID progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire i tuoi set di dati e tabelle BigQuery. Scopri di più sull'impostazione del progetto di fatturazione.
ASSET_TYPE_#: (Facoltativo). Un array di tipi di asset ricercabili. Sono supportate le espressioni regolari compatibili con RE2. Se l'espressione regolare non corrisponde a nessun tipo di asset supportato, viene restituito un errore INVALID_ARGUMENT. Quando assetTypes non è specificato, vengono restituiti tutti i tipi di asset.
CONTENT_TYPE: (Facoltativo). Il tipo di contenuti dei metadati che vuoi recuperare. Quando contentType non è specificato, vengono restituite solo informazioni di base, come i nomi degli asset, l'ultima volta che sono stati aggiornati e i progetti, le cartelle e le organizzazioni a cui appartengono.
RELATIONSHIP_TYPE_#: (Facoltativo). Richiede l'accesso al livello Premium o Enterprise di Security Command Center o a Gemini Cloud Assist. Un elenco separato da virgole di tipi di relazione tra asset che vuoi recuperare. Affinché questa operazione funzioni, devi impostare CONTENT_TYPE su RELATIONSHIP.
SNAPSHOT_TIME: (Facoltativo). L'ora in cui vuoi acquisire uno snapshot dei tuoi asset, in formato RFC 3339. Il valore non deve essere precedente a 35 giorni. Se readTime non è specificato, viene creato uno snapshot all'ora corrente.
BIGQUERY_PROJECT_ID: l'ID del progetto in cui si trova la tabella BigQuery che vuoi esportare.
DATASET_ID: L'ID del set di dati BigQuery.
TABLE_NAME: La tabella BigQuery in cui esporti i metadati. Se non esiste, viene creato.

La coppia chiave-valore "force": true sovrascrive la tabella di destinazione, se esistente.

Consulta il riferimento REST per tutte le opzioni.

Esempi di comandi

Esegui uno dei seguenti comandi per esportare i metadati di resource così com'erano il 30 gennaio 2024 nel progetto my-project nella tabella BigQuery my-table.

curl (Linux, macOS o Cloud Shell)

curl -X POST \
     -H "X-Goog-User-Project: BILLING_PROJECT_ID" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d '{
            "contentType": "RESOURCE",
            "readTime": "2024-01-30T00:00:00Z",
            "outputConfig": {
              "bigqueryDestination": {
                "dataset": "projects/my-project/datasets/my-dataset",
                "table": "my-table",
                "force": true
              }
            }
          }' \
     https://cloudasset.googleapis.com/v1/projects/my-project:exportAssets

PowerShell (Windows)

$cred = gcloud auth print-access-token

$headers = @{ 
  "X-Goog-User-Project" = "BILLING_PROJECT_ID";
  "Authorization" = "Bearer $cred"
}


$body = @"
{
  "contentType": "RESOURCE",
  "readTime": "2024-01-30T00:00:00Z",
  "outputConfig": {
    "bigqueryDestination": {
      "dataset": "projects/my-project/datasets/my-dataset",
      "table": "my-table",
      "force": true
    }
  }
}
"@

Invoke-WebRequest `
  -Method POST `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -Body $body `
  -Uri "https://cloudasset.googleapis.com/v1/projects/my-project:exportAssets" | Select-Object -Expand Content

Esempio di risposta

{
  "name": "projects/000000000000/operations/ExportAssets/RESOURCE/00000000000000000000000000000000",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.asset.v1.ExportAssetsRequest",
    "parent": "projects/000000000000",
    "readTime": "2024-01-30T00:00:00Z",
    "contentType": "RESOURCE",
    "outputConfig": {
      "bigqueryDestination": {
        "dataset": "projects/my-project/datasets/my-dataset",
        "table": "my-table",
        "force": true
      }
    }
  }
}

Vai

Per scoprire come installare e utilizzare la libreria client per Cloud Asset Inventory, consulta Librerie client di Cloud Asset Inventory.

Per autenticarti in Cloud Asset Inventory, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.


// Sample asset-quickstart exports assets to given bigquery table.
package main

import (
	"context"
	"fmt"
	"log"
	"os"
	"strings"

	asset "cloud.google.com/go/asset/apiv1"
	"cloud.google.com/go/asset/apiv1/assetpb"
)

func main() {
	ctx := context.Background()
	projectID := os.Getenv("GOOGLE_CLOUD_PROJECT")
	client, err := asset.NewClient(ctx)
	if err != nil {
		log.Fatalf("asset.NewClient: %v", err)
	}
	defer client.Close()
	datasetID := strings.Replace(fmt.Sprintf("%s-for-assets", projectID), "-", "_", -1)
	dataset := fmt.Sprintf("projects/%s/datasets/%s", projectID, datasetID)
	req := &assetpb.ExportAssetsRequest{
		Parent: fmt.Sprintf("projects/%s", projectID),
		OutputConfig: &assetpb.OutputConfig{
			Destination: &assetpb.OutputConfig_BigqueryDestination{
				BigqueryDestination: &assetpb.BigQueryDestination{
					Dataset: dataset,
					Table:   "test",
					Force:   true,
				},
			},
		},
	}
	op, err := client.ExportAssets(ctx, req)
	if err != nil {
		log.Fatalf("ExportAssets: %v", err)
	}
	resp, err := op.Wait(ctx)
	if err != nil {
		log.Fatalf("Wait: %v", err)
	}
	fmt.Print(resp)
}

Java

Per scoprire come installare e utilizzare la libreria client per Cloud Asset Inventory, consulta Librerie client di Cloud Asset Inventory.

Per autenticarti in Cloud Asset Inventory, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.

// Imports the Google Cloud client library

import com.google.cloud.ServiceOptions;
import com.google.cloud.asset.v1.AssetServiceClient;
import com.google.cloud.asset.v1.BigQueryDestination;
import com.google.cloud.asset.v1.ContentType;
import com.google.cloud.asset.v1.ExportAssetsRequest;
import com.google.cloud.asset.v1.ExportAssetsRequest.Builder;
import com.google.cloud.asset.v1.ExportAssetsResponse;
import com.google.cloud.asset.v1.OutputConfig;
import com.google.cloud.asset.v1.PartitionSpec;
import com.google.cloud.asset.v1.ProjectName;
import java.io.IOException;
import java.util.Arrays;
import java.util.concurrent.ExecutionException;

public class ExportAssetsBigqueryExample {

  // Use the default project Id.
  private static final String projectId = ServiceOptions.getDefaultProjectId();

  /** 
   * Export assets to BigQuery for a project.

   * @param bigqueryDataset which dataset the results will be exported to
   * @param bigqueryTable which table the results will be exported to
   * @param contentType determines the schema for the table
   * @param assetTypes a list of asset types to export. if empty, export all.
   * @param isPerType separate BigQuery tables for each resource type
   */
  public static void exportBigQuery(String bigqueryDataset, String bigqueryTable,
      ContentType contentType, String[] assetTypes, boolean isPerType)
      throws IOException, IllegalArgumentException, InterruptedException, ExecutionException {
    try (AssetServiceClient client = AssetServiceClient.create()) {
      ProjectName parent = ProjectName.of(projectId);
      OutputConfig outputConfig;
      // Outputs to per-type BigQuery table.
      if (isPerType) {
        outputConfig =
            OutputConfig.newBuilder()
                .setBigqueryDestination(
                    BigQueryDestination.newBuilder()
                        .setDataset(bigqueryDataset)
                        .setTable(bigqueryTable)
                        .setForce(true)
                        .setSeparateTablesPerAssetType(true)
                        .setPartitionSpec(
                            PartitionSpec.newBuilder()
                                .setPartitionKey(PartitionSpec.PartitionKey.READ_TIME)
                                .build())
                        .build())
                .build();
      } else {
        outputConfig =
            OutputConfig.newBuilder()
                .setBigqueryDestination(
                    BigQueryDestination.newBuilder()
                        .setDataset(bigqueryDataset)
                        .setTable(bigqueryTable)
                        .setForce(true)
                        .build())
                .build();
      }
      Builder exportAssetsRequestBuilder = ExportAssetsRequest.newBuilder()
          .setParent(parent.toString()).setContentType(contentType).setOutputConfig(outputConfig);
      if (assetTypes.length > 0) {
        exportAssetsRequestBuilder.addAllAssetTypes(Arrays.asList(assetTypes));
      }
      ExportAssetsRequest request = exportAssetsRequestBuilder.build();
      ExportAssetsResponse response = client.exportAssetsAsync(request).get();
      System.out.println(response);
    }
  }
}

Node.js

Per scoprire come installare e utilizzare la libreria client per Cloud Asset Inventory, consulta Librerie client di Cloud Asset Inventory.

Per autenticarti in Cloud Asset Inventory, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.

/**
 * TODO(developer): Uncomment these variables before running the sample.
 */
// const dataSet = 'projects/project_id/datasets/dataset_id';
// const table = 'mytable';

const {AssetServiceClient} = require('@google-cloud/asset');
const client = new AssetServiceClient();

async function exportAssetsBigquery() {
  const projectId = await client.getProjectId();
  const projectResource = client.projectPath(projectId);
  const dataset = dataSet;

  const request = {
    parent: projectResource,
    outputConfig: {
      bigqueryDestination: {
        dataset: `projects/${projectId}/${dataset}`,
        table: table,
        force: true,
      },
    },
  };

  // Handle the operation using the promise pattern.
  const [operation] = await client.exportAssets(request);

  // Operation#promise starts polling for the completion of the operation.
  const [result] = await operation.promise();

  // Do things with with the response.
  console.log(result);
}

exportAssetsBigquery();

Python

Per scoprire come installare e utilizzare la libreria client per Cloud Asset Inventory, consulta Librerie client di Cloud Asset Inventory.

Per autenticarti in Cloud Asset Inventory, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.

from google.cloud import asset_v1

# TODO project_id = 'Your Google Cloud Project ID'
# TODO dataset = 'Your BigQuery dataset path'
# TODO table = 'Your BigQuery table name'
# TODO content_type ="Content type to export"

client = asset_v1.AssetServiceClient()
parent = f"projects/{project_id}"
output_config = asset_v1.OutputConfig()
output_config.bigquery_destination.dataset = dataset
output_config.bigquery_destination.table = table
output_config.bigquery_destination.force = True
response = client.export_assets(
    request={
        "parent": parent,
        "content_type": content_type,
        "output_config": output_config,
    }
)
print(response.result())

Esportare uno snapshot degli asset in tabelle separate per ogni tipo di asset

Puoi esportare gli asset in tabelle BigQuery separate per ogni tipo di asset con il flag --per-asset-type nella gcloud CLI e "separateTablesPerAssetType": true nelle richieste API REST. Il tipo di contenuti RELATIONSHIP non può essere esportato in questo modo.

In questa modalità, il nome di ogni tabella è TABLE_NAMEconcatenato con _ (trattino basso) e il nome del tipo di asset. I caratteri non alfanumerici vengono sostituiti con _.

Se l'esportazione in una tabella non va a buon fine, l'intera operazione di esportazione non riesce e viene restituito il primo errore. I risultati delle esportazioni precedenti riuscite vengono mantenuti.

I seguenti tipi sono inclusi in una stringa JSON per risolvere un problema di compatibilità tra Proto3 e i tipi BigQuery.

google.protobuf.Timestamp
google.protobuf.Duration
google.protobuf.FieldMask
google.protobuf.ListValue
google.protobuf.Value
google.protobuf.Struct
google.api.*

gcloud

gcloud asset export \
    --SCOPE \
    --billing-project=BILLING_PROJECT_ID \
    --asset-types=ASSET_TYPE_1,ASSET_TYPE_2,... \
    --content-type=CONTENT_TYPE \
    --snapshot-time="SNAPSHOT_TIME" \
    --bigquery-table=projects/BIGQUERY_PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
    --per-asset-type \
    --output-bigquery-force

Fornisci i seguenti valori:

SCOPE: utilizza uno dei seguenti valori:
- project=PROJECT_ID, dove PROJECT_ID è l'ID del progetto che contiene i metadati delle risorse che vuoi esportare.
- folder=FOLDER_ID, dove FOLDER_ID è l'ID della cartella che contiene i metadati delle risorse che vuoi esportare.
  Come trovare l'ID di una Google Cloud cartella
  ConsoleGoogle Cloud
  
  Per trovare l'ID di una Google Cloud cartella:
  
  Vai alla Google Cloud console.
  
  Vai alla Google Cloud console
  
  Fai clic sulla casella di elenco selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella di elenco.
  
  Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente 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)"
  
  dove TOP_LEVEL_FOLDER_NAME è una corrispondenza parziale o completa della stringa per il nome della cartella. Rimuovi il flag --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Il comando precedente non restituisce gli ID delle sottocartelle all'interno delle cartelle. Per farlo, esegui il comando seguente utilizzando l'ID di una cartella di primo livello:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organization=ORGANIZATION_ID, dove ORGANIZATION_ID è l'ID dell'organizzazione che contiene i metadati della risorsa che vuoi esportare.
  Come trovare l'ID di un' Google Cloud organizzazione
  ConsoleGoogle Cloud
  
  Per trovare l'ID di un' Google Cloud organizzazione:
  
  Vai alla Google Cloud console.
  
  Vai alla Google Cloud console
  
  Fai clic sulla casella di elenco selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella di elenco.
  
  Fai clic sulla scheda Tutti. L'ID organizzazione viene visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di un'organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
BILLING_PROJECT_ID: (Facoltativo). L'ID progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire i set di dati e le tabelle BigQuery. Scopri di più sull'impostazione del progetto di fatturazione.
ASSET_TYPE_#: (Facoltativo). Un elenco separato da virgole di tipi di asset ricercabili. Sono supportate le espressioni regolari compatibili con RE2. Se l'espressione regolare non corrisponde a nessun tipo di asset supportato, viene restituito un errore INVALID_ARGUMENT. Quando --asset-types non è specificato, vengono restituiti tutti i tipi di asset.
CONTENT_TYPE: (Facoltativo). Il tipo di contenuti dei metadati che vuoi recuperare. Il tipo di contenuti RELATIONSHIP non può essere utilizzato con --per-asset-type .

Quando --content-type non è specificato, vengono restituite solo informazioni di base, come i nomi degli asset, l'ultima volta che gli asset sono stati aggiornati e i progetti, le cartelle e le organizzazioni a cui appartengono.
SNAPSHOT_TIME: (Facoltativo). L'ora in cui vuoi acquisire uno snapshot dei tuoi asset, nel formato data e ora dell'argomento gcloud. Il valore non deve essere precedente a 35 giorni. Quando --snapshot-time non è specificato, viene creato uno snapshot all'ora corrente.
BIGQUERY_PROJECT_ID: l'ID del progetto in cui si trova la tabella BigQuery che vuoi esportare.
DATASET_ID: L'ID del set di dati BigQuery.
TABLE_NAME: il prefisso delle tabelle BigQuery in cui esporti i metadati. I nomi completi delle tabelle sono il prefisso concatenato con _ e il tipo di asset.

Il flag --output-bigquery-force sovrascrive la tabella di destinazione, se esiste.

Per tutte le opzioni, consulta il riferimento gcloud CLI.

Esempio

Esegui il comando seguente per esportare i metadati di resource così com'erano il 30 gennaio 2024 nel progetto my-project in più tabelle BigQuery che hanno my-table come prefisso.

gcloud asset export \
    --project=my-project \
    --content-type=resource \
    --snapshot-time="2024-01-30" \
    --bigquery-table=projects/my-project/datasets/my-dataset/tables/my-table \
    --per-asset-type \
    --output-bigquery-force

REST

Metodo HTTP e URL:

POST https://cloudasset.googleapis.com/v1/SCOPE_PATH:exportAssets

Intestazioni:

X-Goog-User-Project: BILLING_PROJECT_ID

Corpo JSON della richiesta:

{
  "assetTypes": [
    "ASSET_TYPE_1",
    "ASSET_TYPE_2",
    "..."
  ],
  "contentType": "CONTENT_TYPE",
  "readTime": "SNAPSHOT_TIME",
  "outputConfig": {
    "bigqueryDestination": {
      "dataset": "projects/BIGQUERY_PROJECT_ID/datasets/DATASET_ID",
      "table": "TABLE_NAME",
      "force": true,
      "separateTablesPerAssetType": true
    }
  }
}

Fornisci i seguenti valori:

SCOPE_PATH: utilizza uno dei seguenti valori:

I valori consentiti sono:
- projects/PROJECT_ID, dove PROJECT_ID è l'ID del progetto che contiene i metadati delle risorse che vuoi esportare.
- projects/PROJECT_NUMBER, dove PROJECT_NUMBER è il numero del progetto che contiene i metadati dell'asset che vuoi esportare.
  Come trovare un Google Cloud numero di progetto
  ConsoleGoogle Cloud
  
  Per trovare un numero di progetto, completa i seguenti passaggi: Google Cloud
  
  Vai alla pagina Benvenuto nella console Google Cloud .
  
  Vai a Benvenuto
  
  Fai clic sulla casella di elenco selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella di elenco, quindi cerca il nome del tuo progetto. Il nome, il numero e l'ID progetto vengono visualizzati vicino all'intestazione Benvenuto.
  
  Vengono visualizzate fino a 4000 risorse. Se non vedi il progetto che stai cercando, vai alla pagina Gestisci risorse e filtra l'elenco utilizzando il nome del progetto.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare un Google Cloud numero di progetto con il seguente comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID, dove FOLDER_ID è l'ID della cartella che contiene i metadati delle risorse che vuoi esportare.
  Come trovare l'ID di una Google Cloud cartella
  ConsoleGoogle Cloud
  
  Per trovare l'ID di una Google Cloud cartella:
  
  Vai alla Google Cloud console.
  
  Vai alla Google Cloud console
  
  Fai clic sulla casella di elenco selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella di elenco.
  
  Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente 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)"
  
  dove TOP_LEVEL_FOLDER_NAME è una corrispondenza parziale o completa della stringa per il nome della cartella. Rimuovi il flag --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Il comando precedente non restituisce gli ID delle sottocartelle all'interno delle cartelle. Per farlo, esegui il comando seguente utilizzando l'ID di una cartella di primo livello:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID, dove ORGANIZATION_ID è l'ID dell'organizzazione che contiene i metadati della risorsa che vuoi esportare.
  Come trovare l'ID di un' Google Cloud organizzazione
  ConsoleGoogle Cloud
  
  Per trovare l'ID di un' Google Cloud organizzazione:
  
  Vai alla Google Cloud console.
  
  Vai alla Google Cloud console
  
  Fai clic sulla casella di elenco selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella di elenco.
  
  Fai clic sulla scheda Tutti. L'ID organizzazione viene visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di un'organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
BILLING_PROJECT_ID: l'ID progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire i tuoi set di dati e tabelle BigQuery. Scopri di più sull'impostazione del progetto di fatturazione.
ASSET_TYPE_#: (Facoltativo). Un array di tipi di asset ricercabili. Sono supportate le espressioni regolari compatibili con RE2. Se l'espressione regolare non corrisponde a nessun tipo di asset supportato, viene restituito un errore INVALID_ARGUMENT. Quando assetTypes non è specificato, vengono restituiti tutti i tipi di asset.
CONTENT_TYPE: (Facoltativo). Il tipo di contenuti dei metadati che vuoi recuperare. Il tipo di contenuti RELATIONSHIP non può essere utilizzato con "separateTablesPerAssetType": true .

Quando contentType non è specificato, vengono restituite solo informazioni di base, come i nomi degli asset, l'ultima volta che sono stati aggiornati e i progetti, le cartelle e le organizzazioni a cui appartengono.
SNAPSHOT_TIME: (Facoltativo). L'ora in cui vuoi acquisire uno snapshot dei tuoi asset, in formato RFC 3339. Il valore non deve essere precedente a 35 giorni. Se readTime non è specificato, viene creato uno snapshot all'ora corrente.
BIGQUERY_PROJECT_ID: l'ID del progetto in cui si trova la tabella BigQuery che vuoi esportare.
DATASET_ID: L'ID del set di dati BigQuery.
TABLE_NAME: il prefisso delle tabelle BigQuery in cui esporti i metadati. I nomi completi delle tabelle sono il prefisso concatenato con _ e il tipo di asset.

La coppia chiave-valore "force": true sovrascrive la tabella di destinazione, se esistente.

Esempi di comandi

Esegui uno dei seguenti comandi per esportare i metadati di resource così com'erano il 30 gennaio 2024 nel progetto my-project in più tabelle BigQuery che hanno my-table come prefisso.

curl (Linux, macOS o Cloud Shell)

curl -X POST \
     -H "X-Goog-User-Project: BILLING_PROJECT_ID" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d '{
            "contentType": "RESOURCE",
            "readTime": "2024-01-30T00:00:00Z",
            "outputConfig": {
              "bigqueryDestination": {
                "dataset": "projects/my-project/datasets/my-dataset",
                "table": "my-table",
                "force": true,
                "separateTablesPerAssetType": true
              }
            }
          }' \
     https://cloudasset.googleapis.com/v1/projects/my-project:exportAssets

PowerShell (Windows)

$cred = gcloud auth print-access-token

$headers = @{ 
  "X-Goog-User-Project" = "BILLING_PROJECT_ID";
  "Authorization" = "Bearer $cred"
}


$body = @"
{
  "contentType": "RESOURCE",
  "readTime": "2024-01-30T00:00:00Z",
  "outputConfig": {
    "bigqueryDestination": {
      "dataset": "projects/my-project/datasets/my-dataset",
      "table": "my-table",
      "force": true,
      "separateTablesPerAssetType": true
    }
  }
}
"@

Invoke-WebRequest `
  -Method POST `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -Body $body `
  -Uri "https://cloudasset.googleapis.com/v1/projects/my-project:exportAssets" | Select-Object -Expand Content

Esportare uno snapshot di asset in una tabella partizionata per colonne di unità di tempo

Puoi esportare le risorse di un progetto in tabelle partizionate per unità di tempo. Lo snapshot esportato viene archiviato in una tabella BigQuery denominata TABLE_NAME con granularità giornaliera e due colonne timestamp aggiuntive, readTime e requestTime, una delle quali viene specificata come colonna di partizionamento con il valore PARTITION_KEY.

Per esportare gli asset di un progetto in tabelle partizionate, effettua una delle seguenti richieste.

gcloud

gcloud asset export \
    --SCOPE \
    --billing-project=BILLING_PROJECT_ID \
    --asset-types=ASSET_TYPE_1,ASSET_TYPE_2,... \
    --content-type=CONTENT_TYPE \
    --relationship-types=RELATIONSHIP_TYPE_1,RELATIONSHIP_TYPE_2,... \
    --snapshot-time="SNAPSHOT_TIME" \
    --bigquery-table=projects/BIGQUERY_PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
    --partition-key=PARTITION_KEY \
    --output-bigquery-force

Fornisci i seguenti valori:

SCOPE: utilizza uno dei seguenti valori:
- project=PROJECT_ID, dove PROJECT_ID è l'ID del progetto che contiene i metadati delle risorse che vuoi esportare.
- folder=FOLDER_ID, dove FOLDER_ID è l'ID della cartella che contiene i metadati delle risorse che vuoi esportare.
  Come trovare l'ID di una Google Cloud cartella
  ConsoleGoogle Cloud
  
  Per trovare l'ID di una Google Cloud cartella:
  
  Vai alla Google Cloud console.
  
  Vai alla Google Cloud console
  
  Fai clic sulla casella di elenco selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella di elenco.
  
  Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente 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)"
  
  dove TOP_LEVEL_FOLDER_NAME è una corrispondenza parziale o completa della stringa per il nome della cartella. Rimuovi il flag --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Il comando precedente non restituisce gli ID delle sottocartelle all'interno delle cartelle. Per farlo, esegui il comando seguente utilizzando l'ID di una cartella di primo livello:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organization=ORGANIZATION_ID, dove ORGANIZATION_ID è l'ID dell'organizzazione che contiene i metadati della risorsa che vuoi esportare.
  Come trovare l'ID di un' Google Cloud organizzazione
  ConsoleGoogle Cloud
  
  Per trovare l'ID di un' Google Cloud organizzazione:
  
  Vai alla Google Cloud console.
  
  Vai alla Google Cloud console
  
  Fai clic sulla casella di elenco selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella di elenco.
  
  Fai clic sulla scheda Tutti. L'ID organizzazione viene visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di un'organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
BILLING_PROJECT_ID: (Facoltativo). L'ID progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire i set di dati e le tabelle BigQuery. Scopri di più sull'impostazione del progetto di fatturazione.
ASSET_TYPE_#: (Facoltativo). Un elenco separato da virgole di tipi di asset ricercabili. Sono supportate le espressioni regolari compatibili con RE2. Se l'espressione regolare non corrisponde a nessun tipo di asset supportato, viene restituito un errore INVALID_ARGUMENT. Quando --asset-types non è specificato, vengono restituiti tutti i tipi di asset.
CONTENT_TYPE: (Facoltativo). Il tipo di contenuti dei metadati che vuoi recuperare. Quando --content-type non è specificato, vengono restituite solo informazioni di base, come i nomi degli asset, l'ultima volta che gli asset sono stati aggiornati e i progetti, le cartelle e le organizzazioni a cui appartengono.
RELATIONSHIP_TYPE_#: (Facoltativo). Richiede l'accesso al livello Premium o Enterprise di Security Command Center o a Gemini Cloud Assist. Un elenco separato da virgole di tipi di relazione tra asset che vuoi recuperare. Affinché questa operazione funzioni, devi impostare CONTENT_TYPE su RELATIONSHIP.
SNAPSHOT_TIME: (Facoltativo). L'ora in cui vuoi acquisire uno snapshot dei tuoi asset, nel formato data e ora dell'argomento gcloud. Il valore non deve essere precedente a 35 giorni. Quando --snapshot-time non è specificato, viene creato uno snapshot all'ora corrente.
BIGQUERY_PROJECT_ID: l'ID del progetto in cui si trova la tabella BigQuery che vuoi esportare.
DATASET_ID: L'ID del set di dati BigQuery.
TABLE_NAME: La tabella BigQuery in cui esporti i metadati. Se non esiste, viene creato.
PARTITION_KEY: la colonna della chiave di partizione quando esporti nelle tabelle partizionate di BigQuery. I valori validi sono read-time e request-time.

Il flag --output-bigquery-force sovrascrive i dati nella partizione corrispondente nella tabella di destinazione. I dati nelle diverse partizioni rimangono invariati.

Se --output-bigquery-force non è specificato, i dati esportati vengono aggiunti alla partizione corrispondente.

L'operazione di esportazione non riesce se un aggiornamento dello schema o un tentativo di accodamento dei dati non va a buon fine. Ciò include i casi in cui la tabella di destinazione esiste già e non ha lo schema previsto dall'esportazione.

Per tutte le opzioni, consulta il riferimento gcloud CLI.

Esempio

Esegui il seguente comando per esportare i metadati di resource così com'erano il 30 gennaio 2024 nel progetto my-project nella tabella BigQuery my-table.

gcloud asset export \
    --project=projects/my-project \
    --content-type=resource \
    --snapshot-time="2024-01-30" \
    --bigquery-table=projects/my-project/datasets/my-dataset/tables/my-table \
    --partition-key=my-partition-key \
    --output-bigquery-force

REST

Metodo HTTP e URL:

POST https://cloudasset.googleapis.com/v1/SCOPE_PATH:exportAssets

Intestazioni:

X-Goog-User-Project: BILLING_PROJECT_ID

Corpo JSON della richiesta:

{
  "assetTypes": [
    "ASSET_TYPE_1",
    "ASSET_TYPE_2",
    "..."
  ],
  "contentType": "CONTENT_TYPE",
  "relationshipTypes": [
    "RELATIONSHIP_TYPE_1",
    "RELATIONSHIP_TYPE_2",
    "..."
  ],
  "readTime": "SNAPSHOT_TIME",
  "outputConfig": {
    "bigqueryDestination": {
      "dataset": "projects/BIGQUERY_PROJECT_ID/datasets/DATASET_ID",
      "table": "TABLE_NAME",
      "partitionSpec": {
        "partitionKey": "PARTITION_KEY"
      },
      "force": true,
    }
  }
}

Fornisci i seguenti valori:

SCOPE_PATH: utilizza uno dei seguenti valori:

I valori consentiti sono:
- projects/PROJECT_ID, dove PROJECT_ID è l'ID del progetto che contiene i metadati delle risorse che vuoi esportare.
- projects/PROJECT_NUMBER, dove PROJECT_NUMBER è il numero del progetto che contiene i metadati dell'asset che vuoi esportare.
  Come trovare un Google Cloud numero di progetto
  ConsoleGoogle Cloud
  
  Per trovare un numero di progetto, completa i seguenti passaggi: Google Cloud
  
  Vai alla pagina Benvenuto nella console Google Cloud .
  
  Vai a Benvenuto
  
  Fai clic sulla casella di elenco selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella di elenco, quindi cerca il nome del tuo progetto. Il nome, il numero e l'ID progetto vengono visualizzati vicino all'intestazione Benvenuto.
  
  Vengono visualizzate fino a 4000 risorse. Se non vedi il progetto che stai cercando, vai alla pagina Gestisci risorse e filtra l'elenco utilizzando il nome del progetto.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare un Google Cloud numero di progetto con il seguente comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID, dove FOLDER_ID è l'ID della cartella che contiene i metadati delle risorse che vuoi esportare.
  Come trovare l'ID di una Google Cloud cartella
  ConsoleGoogle Cloud
  
  Per trovare l'ID di una Google Cloud cartella:
  
  Vai alla Google Cloud console.
  
  Vai alla Google Cloud console
  
  Fai clic sulla casella di elenco selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella di elenco.
  
  Cerca il nome della cartella. L'ID cartella viene visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente 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)"
  
  dove TOP_LEVEL_FOLDER_NAME è una corrispondenza parziale o completa della stringa per il nome della cartella. Rimuovi il flag --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Il comando precedente non restituisce gli ID delle sottocartelle all'interno delle cartelle. Per farlo, esegui il comando seguente utilizzando l'ID di una cartella di primo livello:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID, dove ORGANIZATION_ID è l'ID dell'organizzazione che contiene i metadati della risorsa che vuoi esportare.
  Come trovare l'ID di un' Google Cloud organizzazione
  ConsoleGoogle Cloud
  
  Per trovare l'ID di un' Google Cloud organizzazione:
  
  Vai alla Google Cloud console.
  
  Vai alla Google Cloud console
  
  Fai clic sulla casella di elenco selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella di elenco.
  
  Fai clic sulla scheda Tutti. L'ID organizzazione viene visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di un'organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
BILLING_PROJECT_ID: l'ID progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire i tuoi set di dati e tabelle BigQuery. Scopri di più sull'impostazione del progetto di fatturazione.
ASSET_TYPE_#: (Facoltativo). Un array di tipi di asset ricercabili. Sono supportate le espressioni regolari compatibili con RE2. Se l'espressione regolare non corrisponde a nessun tipo di asset supportato, viene restituito un errore INVALID_ARGUMENT. Quando assetTypes non è specificato, vengono restituiti tutti i tipi di asset.
CONTENT_TYPE: (Facoltativo). Il tipo di contenuti dei metadati che vuoi recuperare. Quando contentType non è specificato, vengono restituite solo informazioni di base, come i nomi degli asset, l'ultima volta che sono stati aggiornati e i progetti, le cartelle e le organizzazioni a cui appartengono.
RELATIONSHIP_TYPE_#: (Facoltativo). Richiede l'accesso al livello Premium o Enterprise di Security Command Center o a Gemini Cloud Assist. Un elenco separato da virgole di tipi di relazione tra asset che vuoi recuperare. Affinché questa operazione funzioni, devi impostare CONTENT_TYPE su RELATIONSHIP.
SNAPSHOT_TIME: (Facoltativo). L'ora in cui vuoi acquisire uno snapshot dei tuoi asset, in formato RFC 3339. Il valore non deve essere precedente a 35 giorni. Se readTime non è specificato, viene creato uno snapshot all'ora corrente.
BIGQUERY_PROJECT_ID: l'ID del progetto in cui si trova la tabella BigQuery che vuoi esportare.
DATASET_ID: L'ID del set di dati BigQuery.
TABLE_NAME: La tabella BigQuery in cui esporti i metadati. Se non esiste, viene creato.
PARTITION_KEY: la colonna della chiave di partizione quando esporti nelle tabelle partizionate di BigQuery. I valori validi sono READ_TIME e REQUEST_TIME.

La coppia chiave-valore "force": true sovrascrive i dati nella partizione corrispondente della tabella di destinazione. I dati nelle diverse partizioni rimangono invariati.

Se force non è impostato o è impostato su false, i dati esportati vengono aggiunti alla partizione corrispondente.

Esempi di comandi

Esegui uno dei seguenti comandi per esportare i metadati di resource così com'erano il 30 gennaio 2024 nel progetto my-project nella tabella BigQuery my-table.

curl (Linux, macOS o Cloud Shell)

curl -X POST \
     -H "X-Goog-User-Project: BILLING_PROJECT_ID" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d '{
            "contentType": "RESOURCE",
            "readTime": "2024-01-30T00:00:00Z",
            "outputConfig": {
              "bigqueryDestination": {
                "dataset": "projects/my-project/datasets/my-dataset",
                "table": "my-table",
                "partitionSpec": {
                  "partitionKey": "my-partition-key"
                },
                "force": true,
              }
            }
          }' \
     https://cloudasset.googleapis.com/v1/projects/my-project:exportAssets

PowerShell (Windows)

$cred = gcloud auth print-access-token

$headers = @{ 
  "X-Goog-User-Project" = "BILLING_PROJECT_ID";
  "Authorization" = "Bearer $cred"
}


$body = @"
{
  "contentType": "RESOURCE",
  "readTime": "2024-01-30T00:00:00Z",
  "outputConfig": {
    "bigqueryDestination": {
      "dataset": "projects/my-project/datasets/my-dataset",
      "table": "my-table",
      "partitionSpec": {
        "partitionKey": "my-partition-key"
      },
      "force": true,
    }
  }
}
"@

Invoke-WebRequest `
  -Method POST `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -Body $body `
  -Uri "https://cloudasset.googleapis.com/v1/projects/my-project:exportAssets" | Select-Object -Expand Content

Controllare lo stato di un'esportazione

Il completamento delle esportazioni richiede del tempo. Per verificare se un'esportazione è stata completata, puoi eseguire una query sull'operazione utilizzando il relativo ID operazione.

Tieni presente che, anche se l'esportazione è stata completata, qualcuno potrebbe aver effettuato un'altra richiesta di esportazione nella stessa destinazione come operazione diversa. Le nuove richieste di esportazione alla stessa destinazione possono essere effettuate dopo il completamento di una richiesta precedente o se sono trascorsi più di 15 minuti. Le richieste di esportazione effettuate al di fuori di queste condizioni vengono rifiutate da Cloud Asset Inventory.

gcloud

Per visualizzare lo stato dell'esportazione, completa le seguenti istruzioni:

Recupera OPERATION_PATH, che include l'ID operazione, dalla risposta alla richiesta di esportazione. OPERATION_PATH viene mostrato nella risposta all'esportazione, formattata nel seguente modo:
```
projects/PROJECT_NUMBER/operations/ExportAssets/CONTENT_TYPE/OPERATION_ID
```
Per controllare lo stato dell'esportazione, esegui il seguente comando con OPERATION_PATH:
```
gcloud asset operations describe OPERATION_PATH
```

REST

Per visualizzare lo stato dell'esportazione, completa le seguenti istruzioni:

Recupera OPERATION_PATH, che include l'ID operazione, dalla risposta alla richiesta di esportazione. Il OPERATION_PATH viene visualizzato come valore del campo name nella risposta all'esportazione, formattato nel seguente modo:
```
projects/PROJECT_NUMBER/operations/ExportAssets/CONTENT_TYPE/OPERATION_ID
```
Per controllare lo stato dell'esportazione, invia la seguente richiesta.
REST

Metodo HTTP e URL:
```
GET https://cloudasset.googleapis.com/v1/OPERATION_PATH
```
Esempi di comandi
curl (Linux, macOS o Cloud Shell)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso a gcloud CLI con il tuo account utente eseguendo gcloud init o gcloud auth login o utilizzando Cloud Shell, che esegue automaticamente l'accesso a gcloud CLI. Puoi controllare l'account attivo eseguendo gcloud auth list.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ https://cloudasset.googleapis.com/v1/OPERATION_PATH
PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia alla gcloud CLI con il tuo account utente eseguendo gcloud init o gcloud auth login. Puoi controllare l'account attivo eseguendo gcloud auth list.
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method GET ` -Headers $headers ` -Uri "https://cloudasset.googleapis.com/v1/OPERATION_PATH" | Select-Object -Expand Content

Visualizzare uno snapshot di asset in BigQuery

Console

Vai alla pagina BigQuery Studio nella console Google Cloud .

Vai a BigQuery Studio
Per visualizzare le tabelle e le viste nel set di dati, apri il pannello di navigazione. Nella sezione Risorse, seleziona il progetto per espanderlo, quindi seleziona un set di dati.
Seleziona la tabella dall'elenco.
Seleziona Dettagli e prendi nota del valore in Numero di righe. Potresti aver bisogno di questo valore per controllare il punto di partenza dei risultati utilizzando gcloud CLI o l'API REST.
Per visualizzare un set di dati di esempio, seleziona Anteprima.

REST

Per sfogliare i dati della tabella, chiama tabledata.list. Nel parametro tableId, specifica il nome della tabella.

Puoi configurare i seguenti parametri facoltativi per controllare l'output.

maxResults è il numero massimo di risultati da restituire.
selectedFields è un elenco di colonne da restituire separate da virgole. Se non specificato, vengono restituite tutte le colonne.
startIndex è l'indice in base zero della riga iniziale da leggere.

I valori vengono restituiti racchiusi in un oggetto JSON che devi analizzare, come descritto nella documentazione di riferimento tabledata.list.

Esegui una query su uno snapshot delle risorse in BigQuery

Dopo aver esportato lo snapshot in BigQuery, puoi eseguire query sui metadati degli asset.

Per impostazione predefinita, BigQuery esegue job di query interattivi o on demand, il che significa che la query viene eseguita il prima possibile. Le query interattive vengono conteggiate ai fini del limite di frequenza simultanea e del limite giornaliero.

I risultati della query vengono salvati in una tabella temporanea o permanente. Puoi scegliere di aggiungere o sovrascrivere i dati in una tabella esistente o di creare una nuova tabella, se non ne esiste una con lo stesso nome.

Per eseguire una query interattiva che scrive l'output in una tabella temporanea, completa i seguenti passaggi.

Console

Vai alla pagina BigQuery Studio nella console Google Cloud .

Vai a BigQuery Studio
Seleziona Crea nuova query.
Nell'area di testo Editor query, inserisci una query SQL BigQuery valida.
(Facoltativo) Per modificare la posizione del trattamento dei dati, completa i seguenti passaggi.
1. Seleziona Altro e poi Impostazioni query.
2. In Località di elaborazione, seleziona Selezione automatica, quindi scegli la località dei dati.
3. Per aggiornare le impostazioni della query, seleziona Salva.
Seleziona Esegui.

REST

Per avviare un nuovo job, chiama il metodo jobs.insert. Nella risorsa job, imposta i seguenti parametri.
- Nel campo configuration, imposta il campo query su un valore JobConfigurationQuery che descrive il job di query BigQuery.
- Nel campo jobReference, imposta il campo location in modo appropriato per il job.
Per conoscere i risultati, chiama getQueryResults. Sondaggio fino a jobComplete uguale a true. Puoi verificare la presenza di errori e avvisi nell'elenco errors.

Altri esempi di query SQL

Questa sezione fornisce query SQL di esempio per analizzare i metadati delle risorse dopo averli esportati in BigQuery. Per maggiori informazioni, consulta la sintassi delle query SQL standard.

Eseguire query direttamente sulle colonne disponibili

Per trovare la quantità di ciascun tipo di asset, esegui la seguente query:

SELECT asset_type, COUNT(*) AS asset_count
FROM `PROJECT_ID.DATASET_ID.TABLE_NAME`
GROUP BY asset_type
ORDER BY asset_count DESC

Utilizzare i campi ripetuti

Per trovare i criteri IAM (Identity and Access Management) che concedono l'accesso agli account Gmail, esegui la seguente query. BigQuery utilizza UNNEST per appiattire i campi ripetuti in una tabella su cui puoi eseguire query direttamente:

SELECT name, asset_type, bindings.role
FROM `PROJECT_ID.DATASET_ID.TABLE_NAME`
JOIN UNNEST(iam_policy.bindings) AS bindings
JOIN UNNEST(bindings.members) AS principals
WHERE principals like "%@gmail.com"

Per trovare un'organizzazione, una cartella o un progetto che consente la creazione utilizzando un indirizzo IP pubblico, esegui la seguente query. Questa query è utile perché consentire indirizzi IP pubblici con istanze Cloud SQL può introdurre vulnerabilità a meno che non sia configurato SSL o un proxy:

SELECT name
FROM `PROJECT_ID.DATASET_ID.TABLE_NAME`
JOIN UNNEST(org_policy) AS op
WHERE
  op.constraint = "constraints/sql.restrictPublicIp"
  AND (op.boolean_policy IS NULL OR op.boolean_policy.enforced = FALSE);

Per trovare un'organizzazione, una cartella o un progetto nello stesso perimetro di servizio dei Controlli di servizio VPC di un progetto, esegui la seguente query:

SELECT service_perimeter.title, service_perimeter.status.resources
FROM `PROJECT_ID.DATASET_ID.TABLE_NAME`
CROSS JOIN UNNEST(service_perimeter.status.resources) as resource
WHERE resource = "projects/PROJECT_ID";

Utilizzare le stringhe JSON

Per trovare le regole firewall aperte, esegui la seguente query. Scopri di più sulle funzioni JSON utilizzate in BigQuery.

CREATE TEMP FUNCTION json2array(json STRING)
RETURNS ARRAY<STRING>
LANGUAGE js AS """
  return JSON.parse(json).map(x=>JSON.stringify(x));
""";

SELECT firewall.name, firewall.resource.parent, JSON_EXTRACT(firewall.resource.data, '$.sourceRanges') AS sourceRanges
FROM `PROJECT_ID.DATASET_ID.TABLE_NAME` AS firewall
JOIN UNNEST(json2array(JSON_EXTRACT(firewall.resource.data, '$.sourceRanges'))) AS source_ranges
WHERE asset_type="compute.googleapis.com/Firewall" AND JSON_EXTRACT(firewall.resource.data, '$.sourceRanges') IS NOT NULL AND JSON_EXTRACT_SCALAR(source_ranges, '$') = "0.0.0.0/0"

Separando le tabelle per ogni tipo di risorsa, puoi trovare le regole firewall aperte con una query più semplice e veloce.

SELECT firewall.name, firewall.resource.parent, sourceRanges
FROM `PROJECT_ID.DATASET_ID.STRUCTURED_INSTANCE_TABLE_NAME` AS firewall
JOIN UNNEST(firewall.resource.data.sourceRanges) AS sourceRanges
WHERE sourceRanges = "0.0.0.0/0";

Unire tabelle di diversi tipi di risorse

Per unire tabelle di diversi tipi di risorse, esegui la seguente query. L'esempio seguente mostra come trovare tutte le subnet a cui non è collegata alcuna VM. Innanzitutto, la query trova tutte le subnet. Dopodiché, seleziona da questo elenco le sottoreti i cui valori selfLink non sono presenti.

CREATE TEMP FUNCTION json2array(json STRING)
RETURNS ARRAY<STRING>
LANGUAGE js AS """
  return JSON.parse(json).map(x=>JSON.stringify(x));
""";

SELECT name, JSON_EXTRACT(subnetwork.resource.data, '$.selfLink') AS selflink
FROM `PROJECT_ID.DATASET_ID.TABLE_NAME` AS subnetwork
WHERE asset_type = "compute.googleapis.com/Subnetwork" AND (JSON_EXTRACT(subnetwork.resource.data, '$.selfLink') NOT IN
(SELECT DISTINCT JSON_EXTRACT(network_interfaces, '$.subnetwork')
FROM `PROJECT_ID.DATASET_ID.TABLE_NAME` as instance
JOIN UNNEST(json2array(JSON_EXTRACT(instance.resource.data, '$.networkInterfaces'))) AS network_interfaces
WHERE asset_type ="compute.googleapis.com/Instance"
AND JSON_EXTRACT(instance.resource.data, '$.networkInterfaces') IS NOT NULL
)) IS NULL

Separando le tabelle per ogni tipo di risorsa, puoi trovare tutte le subnet a cui non è collegata alcuna VM con una query più semplice e veloce.

SELECT name, subnetwork.resource.data.selfLink
FROM `PROJECT_ID.DATASET_ID.STRUCTURED_SUBNETWORK_TABLE_NAME` AS subnetwork
WHERE
  (
    subnetwork.resource.data.selfLink
      NOT IN (
        SELECT DISTINCT networkInterface.subnetwork
        FROM `PROJECT_ID.DATASET_ID.STRUCTURED_INSTANCE_TABLE_NAME` as instance
        JOIN
          UNNEST(instance.resource.data.networkInterfaces) AS networkInterface
        WHERE
          networkInterface IS NOT NULL
      )
  ) IS NULL;

Trovare cluster Dataproc vulnerabili a causa di CVE-2021-44228

CREATE TEMP FUNCTION vulnerable_version(imageVersion STRING)
RETURNS BOOL
LANGUAGE js AS r"""
    const version_regexp = /(?<major>\d+)(?:\.)(?<minor>\d+)(?:\.)?(?<sub>\d+)?/g;
    let match = version_regexp.exec(imageVersion);
    if(match.groups.major < 1){
        return true;
    }
    if (match.groups.major == 1){
        if (match.groups.minor < 3){
            return true;
        }
        if(match.groups.minor == 3 &amp;&amp; match.groups.sub < 95){
            return true;
        }
        if(match.groups.minor == 4 &amp;&amp; match.groups.sub < 77){
            return true;
        }
        if(match.groups.minor == 5 &amp;&amp; match.groups.sub < 53){
            return true;
        }
    }
    if (match.groups.major == 2 &amp;&amp; match.groups.minor == 0 &amp;&amp; match.groups.sub < 27){
        return true;
    }
    return false;
""";

SELECT
  c.name,
  c.resource.data.projectId AS project_id,
  c.resource.data.clusterName AS cluster_name,
  c.resource.data.config.softwareConfig.imageVersion AS image_version,
  c.resource.data.status.state AS cluster_state,
  vulnerable_version(c.resource.data.config.softwareConfig.imageVersion) AS is_vulnerable
FROM
  `PROJECT_ID.DATASET_ID.TABLE_NAME_PREFIX_dataproc_googleapis_com_Cluster` c
  INNER JOIN `PROJECT_ID.DATASET_ID.TABLE_NAME_PREFIX_cloudresourcemanager_googleapis_com_Project` p
    ON p.resource.data.projectId = c.resource.data.projectId
WHERE
  c.resource.data.config.softwareConfig.imageVersion IS NOT NULL
  AND c.resource.data.status.state = "RUNNING"
  AND p.resource.data.lifecycleState = "ACTIVE";

Esportare i metadati delle risorse in BigQuery Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Limitazioni

Schemi BigQuery utilizzati per l'esportazione

Esportare uno snapshot di un asset

gcloud

ConsoleGoogle Cloud

Interfaccia a riga di comando gcloud

ConsoleGoogle Cloud

Interfaccia a riga di comando gcloud

Esempio

Esempio di risposta

REST

ConsoleGoogle Cloud

Interfaccia a riga di comando gcloud

ConsoleGoogle Cloud

Interfaccia a riga di comando gcloud

ConsoleGoogle Cloud

Interfaccia a riga di comando gcloud

Esempi di comandi

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Esempio di risposta

Vai

Java

Node.js

Python

Esportare uno snapshot degli asset in tabelle separate per ogni tipo di asset

gcloud

ConsoleGoogle Cloud

Interfaccia a riga di comando gcloud

ConsoleGoogle Cloud

Interfaccia a riga di comando gcloud

Esempio

REST

ConsoleGoogle Cloud

Interfaccia a riga di comando gcloud

ConsoleGoogle Cloud

Interfaccia a riga di comando gcloud

ConsoleGoogle Cloud

Interfaccia a riga di comando gcloud

Esempi di comandi

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Esportare uno snapshot di asset in una tabella partizionata per colonne di unità di tempo

gcloud

ConsoleGoogle Cloud

Interfaccia a riga di comando gcloud

ConsoleGoogle Cloud

Interfaccia a riga di comando gcloud

Esempio

REST

ConsoleGoogle Cloud

Interfaccia a riga di comando gcloud

ConsoleGoogle Cloud

Interfaccia a riga di comando gcloud

ConsoleGoogle Cloud

Interfaccia a riga di comando gcloud

Esempi di comandi

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Controllare lo stato di un'esportazione

gcloud

REST

REST

Esempi di comandi

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Visualizzare uno snapshot di asset in BigQuery

Console

REST

Esegui una query su uno snapshot delle risorse in BigQuery

Console

REST

Altri esempi di query SQL

Eseguire query direttamente sulle colonne disponibili

Utilizzare i campi ripetuti

Utilizzare le stringhe JSON

Unire tabelle di diversi tipi di risorse

Trovare cluster Dataproc vulnerabili a causa di CVE-2021-44228

Esportare i metadati delle risorse in BigQuery