本主题介绍如何将组织、文件夹或项目的资产元数据导出到 BigQuery 表，然后对目录运行数据分析。BigQuery 提供类似于 SQL 的体验，让用户可以分析数据，并生成有意义的分析洞见，而无需使用自定义脚本。
准备工作
在开始之前，请完成以下步骤。
对要运行 API 命令的项目启用 Cloud Asset Inventory API。
配置使用 gcloud CLI 或 API 调用 Cloud Asset Inventory API 所需的权限。
完成以下步骤以设置您的环境。
gcloud CLI
如需设置环境以使用 gcloud CLI 调用 Cloud Asset Inventory API，请在本地客户端上安装 Google Cloud CLI。
REST
如需设置环境以使用
curl命令调用 Cloud Asset Inventory API，请完成以下步骤。确认您可以使用
curl命令。请务必向您的帐号授予项目、文件夹或组织的以下角色之一。
Cloud Asset Viewer 角色 (
roles/cloudasset.viewer)Owner 基本角色 (
roles/owner)
如果要将元数据从一个项目导出到另一个项目，请确保导出项目的默认 Cloud Asset Inventory 服务帐号已存在且具有正确的权限。
限制
导出资产快照时，请注意以下几点：
使用自定义 Cloud Key Management Service (Cloud KMS) 密钥加密的 BigQuery 表不受支持。
不支持将导出输出附加到现有表，除非您要导出到分区表。目标表必须为空，或者您必须覆盖该表。如需覆盖它，请将
--output-bigquery-force标志与 gcloud CLI 搭配使用，或将force与 REST API 搭配使用。导出到每种资源类型的不同表时，不支持 Google Kubernetes Engine (GKE) 资源类型（
container.googleapis.com/Cluster和container.googleapis.com/NodePool除外）。如果要导出到的表已存在，并且正在导出到，系统会返回
400错误。
为导出设置 BigQuery 架构
每个 BigQuery 表由描述列名、数据类型和其他信息的架构进行定义。在导出期间设置内容类型可确定表的架构。
资源或未指定：如果您将内容类型设置为
RESOURCE或未指定内容类型，并将per-asset-type标志设置为false或不使用该属性，则会创建具有以下架构的 BigQuery 表。资源架构
[ { "name": "name", "type": "STRING", "mode": "NULLABLE" }, { "name": "asset_type", "type": "STRING", "mode": "NULLABLE" }, { "name": "resource", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "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": "ancestors", "type": "STRING", "mode": "REPEATED" }, { "name": "update_time", "type": "TIMESTAMP", "mode": "NULLABLE" } ]resource.data列是以 JSON 字符串表示的资源元数据。如果您将内容类型设置为
RESOURCE或未设置内容类型，并将per-asset-type标志设置为true，则系统会为每个资产类型创建单独的表。每个表的架构都包含 RECORD 类型列，这些列会映射到该素材资源类型的Resource.data字段中的嵌套字段（BigQuery 支持的最多 15 个嵌套层级）。如需查看按类型的 BigQuery 示例表，请参阅 projects/export-assets-examples/datasets/structured_export。IAM 政策：在 REST API 中将内容类型设置为
IAM_POLICY或在 gcloud CLI 中将内容类型设置为iam-policy，即会创建具有以下架构的 BigQuery 表。IAM 政策架构
[ { "name": "name", "mode": "NULLABLE", "type": "STRING" }, { "name": "asset_type", "mode": "NULLABLE", "type": "STRING" }, { "fields": [ { "name": "version", "mode": "NULLABLE", "type": "INTEGER" }, { "fields": [ { "name": "role", "mode": "NULLABLE", "type": "STRING" }, { "name": "members", "mode": "REPEATED", "type": "STRING" }, { "fields": [ { "name": "expression", "mode": "NULLABLE", "type": "STRING" }, { "name": "title", "mode": "NULLABLE", "type": "STRING" }, { "name": "description", "mode": "NULLABLE", "type": "STRING" }, { "name": "location", "mode": "NULLABLE", "type": "STRING" } ], "name": "condition", "mode": "NULLABLE", "type": "RECORD" } ], "name": "bindings", "mode": "REPEATED", "type": "RECORD" }, { "fields": [ { "name": "service", "mode": "NULLABLE", "type": "STRING" }, { "fields": [ { "name": "log_type", "mode": "NULLABLE", "type": "INTEGER" }, { "name": "exempted_members", "mode": "REPEATED", "type": "STRING" } ], "name": "audit_log_configs", "mode": "REPEATED", "type": "RECORD" } ], "name": "audit_configs", "mode": "REPEATED", "type": "RECORD" }, { "name": "etag", "mode": "NULLABLE", "type": "STRING" } ], "name": "iam_policy", "mode": "NULLABLE", "type": "RECORD" }, { "name": "ancestors", "mode": "REPEATED", "type": "STRING" }, { "name": "update_time", "mode": "NULLABLE", "type": "TIMESTAMP" } ]组织政策：在 REST API 中将内容类型设置为
ORG_POLICY或在 gcloud CLI 中将内容类型设置为org-policy，即会创建具有以下架构的 BigQuery 表。组织政策架构
[ { "name": "name", "mode": "NULLABLE", "type": "STRING" }, { "name": "asset_type", "mode": "NULLABLE", "type": "STRING" }, { "fields": [ { "name": "version", "mode": "NULLABLE", "type": "INTEGER" }, { "name": "constraint", "mode": "NULLABLE", "type": "STRING" }, { "name": "etag", "mode": "NULLABLE", "type": "STRING" }, { "name": "update_time", "mode": "NULLABLE", "type": "TIMESTAMP" }, { "fields": [ { "name": "allowed_values", "mode": "REPEATED", "type": "STRING" }, { "name": "denied_values", "mode": "REPEATED", "type": "STRING" }, { "name": "all_values", "mode": "NULLABLE", "type": "INTEGER" }, { "name": "suggested_value", "mode": "NULLABLE", "type": "STRING" }, { "name": "inherit_from_parent", "mode": "NULLABLE", "type": "BOOLEAN" } ], "name": "list_policy", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "enforced", "mode": "NULLABLE", "type": "BOOLEAN" } ], "name": "boolean_policy", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "_present", "mode": "NULLABLE", "type": "BOOLEAN" } ], "name": "restore_default", "mode": "NULLABLE", "type": "RECORD" } ], "name": "org_policy", "mode": "REPEATED", "type": "RECORD" }, { "name": "ancestors", "mode": "REPEATED", "type": "STRING" }, { "name": "update_time", "mode": "NULLABLE", "type": "TIMESTAMP" } ]VPCSC 政策：在 REST API 中将内容类型设置为
ACCESS_POLICY或在 gcloud CLI 中将内容类型设置为access-policy，即会创建具有以下架构的 BigQuery 表。VPCSC 政策架构
[ { "name": "name", "mode": "NULLABLE", "type": "STRING" }, { "name": "asset_type", "mode": "NULLABLE", "type": "STRING" }, { "fields": [ { "name": "name", "mode": "NULLABLE", "type": "STRING" }, { "name": "parent", "mode": "NULLABLE", "type": "STRING" }, { "name": "title", "mode": "NULLABLE", "type": "STRING" }, { "name": "scopes", "mode": "REPEATED", "type": "STRING" }, { "name": "etag", "mode": "NULLABLE", "type": "STRING" } ], "name": "access_policy", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "name", "mode": "NULLABLE", "type": "STRING" }, { "name": "title", "mode": "NULLABLE", "type": "STRING" }, { "name": "description", "mode": "NULLABLE", "type": "STRING" }, { "fields": [ { "fields": [ { "name": "ip_subnetworks", "mode": "REPEATED", "type": "STRING" }, { "fields": [ { "name": "require_screenlock", "mode": "NULLABLE", "type": "BOOLEAN" }, { "name": "allowed_encryption_statuses", "mode": "REPEATED", "type": "INTEGER" }, { "fields": [ { "name": "os_type", "mode": "NULLABLE", "type": "INTEGER" }, { "name": "minimum_version", "mode": "NULLABLE", "type": "STRING" }, { "name": "require_verified_chrome_os", "mode": "NULLABLE", "type": "BOOLEAN" } ], "name": "os_constraints", "mode": "REPEATED", "type": "RECORD" }, { "name": "allowed_device_management_levels", "mode": "REPEATED", "type": "INTEGER" }, { "name": "require_admin_approval", "mode": "NULLABLE", "type": "BOOLEAN" }, { "name": "require_corp_owned", "mode": "NULLABLE", "type": "BOOLEAN" } ], "name": "device_policy", "mode": "NULLABLE", "type": "RECORD" }, { "name": "required_access_levels", "mode": "REPEATED", "type": "STRING" }, { "name": "negate", "mode": "NULLABLE", "type": "BOOLEAN" }, { "name": "members", "mode": "REPEATED", "type": "STRING" }, { "name": "regions", "mode": "REPEATED", "type": "STRING" } ], "name": "conditions", "mode": "REPEATED", "type": "RECORD" }, { "name": "combining_function", "mode": "NULLABLE", "type": "INTEGER" } ], "name": "basic", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "fields": [ { "name": "expression", "mode": "NULLABLE", "type": "STRING" }, { "name": "title", "mode": "NULLABLE", "type": "STRING" }, { "name": "description", "mode": "NULLABLE", "type": "STRING" }, { "name": "location", "mode": "NULLABLE", "type": "STRING" } ], "name": "expr", "mode": "NULLABLE", "type": "RECORD" } ], "name": "custom", "mode": "NULLABLE", "type": "RECORD" } ], "name": "access_level", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "name", "mode": "NULLABLE", "type": "STRING" }, { "name": "title", "mode": "NULLABLE", "type": "STRING" }, { "name": "description", "mode": "NULLABLE", "type": "STRING" }, { "name": "perimeter_type", "mode": "NULLABLE", "type": "INTEGER" }, { "fields": [ { "name": "resources", "mode": "REPEATED", "type": "STRING" }, { "name": "access_levels", "mode": "REPEATED", "type": "STRING" }, { "name": "restricted_services", "mode": "REPEATED", "type": "STRING" }, { "fields": [ { "name": "enable_restriction", "mode": "NULLABLE", "type": "BOOLEAN" }, { "name": "allowed_services", "mode": "REPEATED", "type": "STRING" } ], "name": "vpc_accessible_services", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "fields": [ { "fields": [ { "name": "access_level", "mode": "NULLABLE", "type": "STRING" }, { "name": "resource", "mode": "NULLABLE", "type": "STRING" } ], "name": "sources", "mode": "REPEATED", "type": "RECORD" }, { "name": "identities", "mode": "REPEATED", "type": "STRING" }, { "name": "identity_type", "mode": "NULLABLE", "type": "INTEGER" } ], "name": "ingress_from", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "fields": [ { "name": "service_name", "mode": "NULLABLE", "type": "STRING" }, { "fields": [ { "name": "method", "mode": "NULLABLE", "type": "STRING" }, { "name": "permission", "mode": "NULLABLE", "type": "STRING" } ], "name": "method_selectors", "mode": "REPEATED", "type": "RECORD" } ], "name": "operations", "mode": "REPEATED", "type": "RECORD" }, { "name": "resources", "mode": "REPEATED", "type": "STRING" } ], "name": "ingress_to", "mode": "NULLABLE", "type": "RECORD" } ], "name": "ingress_policies", "mode": "REPEATED", "type": "RECORD" }, { "fields": [ { "fields": [ { "name": "identities", "mode": "REPEATED", "type": "STRING" }, { "name": "identity_type", "mode": "NULLABLE", "type": "INTEGER" } ], "name": "egress_from", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "resources", "mode": "REPEATED", "type": "STRING" }, { "fields": [ { "name": "service_name", "mode": "NULLABLE", "type": "STRING" }, { "fields": [ { "name": "method", "mode": "NULLABLE", "type": "STRING" }, { "name": "permission", "mode": "NULLABLE", "type": "STRING" } ], "name": "method_selectors", "mode": "REPEATED", "type": "RECORD" } ], "name": "operations", "mode": "REPEATED", "type": "RECORD" }, { "name": "external_resources", "mode": "REPEATED", "type": "STRING" } ], "name": "egress_to", "mode": "NULLABLE", "type": "RECORD" } ], "name": "egress_policies", "mode": "REPEATED", "type": "RECORD" } ], "name": "status", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "resources", "mode": "REPEATED", "type": "STRING" }, { "name": "access_levels", "mode": "REPEATED", "type": "STRING" }, { "name": "restricted_services", "mode": "REPEATED", "type": "STRING" }, { "fields": [ { "name": "enable_restriction", "mode": "NULLABLE", "type": "BOOLEAN" }, { "name": "allowed_services", "mode": "REPEATED", "type": "STRING" } ], "name": "vpc_accessible_services", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "fields": [ { "fields": [ { "name": "access_level", "mode": "NULLABLE", "type": "STRING" }, { "name": "resource", "mode": "NULLABLE", "type": "STRING" } ], "name": "sources", "mode": "REPEATED", "type": "RECORD" }, { "name": "identities", "mode": "REPEATED", "type": "STRING" }, { "name": "identity_type", "mode": "NULLABLE", "type": "INTEGER" } ], "name": "ingress_from", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "fields": [ { "name": "service_name", "mode": "NULLABLE", "type": "STRING" }, { "fields": [ { "name": "method", "mode": "NULLABLE", "type": "STRING" }, { "name": "permission", "mode": "NULLABLE", "type": "STRING" } ], "name": "method_selectors", "mode": "REPEATED", "type": "RECORD" } ], "name": "operations", "mode": "REPEATED", "type": "RECORD" }, { "name": "resources", "mode": "REPEATED", "type": "STRING" } ], "name": "ingress_to", "mode": "NULLABLE", "type": "RECORD" } ], "name": "ingress_policies", "mode": "REPEATED", "type": "RECORD" }, { "fields": [ { "fields": [ { "name": "identities", "mode": "REPEATED", "type": "STRING" }, { "name": "identity_type", "mode": "NULLABLE", "type": "INTEGER" } ], "name": "egress_from", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "resources", "mode": "REPEATED", "type": "STRING" }, { "fields": [ { "name": "service_name", "mode": "NULLABLE", "type": "STRING" }, { "fields": [ { "name": "method", "mode": "NULLABLE", "type": "STRING" }, { "name": "permission", "mode": "NULLABLE", "type": "STRING" } ], "name": "method_selectors", "mode": "REPEATED", "type": "RECORD" } ], "name": "operations", "mode": "REPEATED", "type": "RECORD" }, { "name": "external_resources", "mode": "REPEATED", "type": "STRING" } ], "name": "egress_to", "mode": "NULLABLE", "type": "RECORD" } ], "name": "egress_policies", "mode": "REPEATED", "type": "RECORD" } ], "name": "spec", "mode": "NULLABLE", "type": "RECORD" }, { "name": "use_explicit_dry_run_spec", "mode": "NULLABLE", "type": "BOOLEAN" } ], "name": "service_perimeter", "mode": "NULLABLE", "type": "RECORD" }, { "name": "ancestors", "mode": "REPEATED", "type": "STRING" }, { "name": "update_time", "mode": "NULLABLE", "type": "TIMESTAMP" } ]OSConfig 实例目录：在 REST API 中将内容类型设置为
OS_INVENTORY或在 gcloud CLI 中将内容类型设置为os-inventory，您将创建具有以下架构的 BigQuery 表。操作系统清点架构
[ { "name": "name", "mode": "NULLABLE", "type": "STRING" }, { "name": "asset_type", "mode": "NULLABLE", "type": "STRING" }, { "fields": [ { "name": "name", "mode": "NULLABLE", "type": "STRING" }, { "fields": [ { "name": "hostname", "mode": "NULLABLE", "type": "STRING" }, { "name": "long_name", "mode": "NULLABLE", "type": "STRING" }, { "name": "short_name", "mode": "NULLABLE", "type": "STRING" }, { "name": "version", "mode": "NULLABLE", "type": "STRING" }, { "name": "architecture", "mode": "NULLABLE", "type": "STRING" }, { "name": "kernel_version", "mode": "NULLABLE", "type": "STRING" }, { "name": "kernel_release", "mode": "NULLABLE", "type": "STRING" }, { "name": "osconfig_agent_version", "mode": "NULLABLE", "type": "STRING" } ], "name": "os_info", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "key", "mode": "NULLABLE", "type": "STRING" }, { "fields": [ { "name": "id", "mode": "NULLABLE", "type": "STRING" }, { "name": "origin_type", "mode": "NULLABLE", "type": "INTEGER" }, { "name": "create_time", "mode": "NULLABLE", "type": "TIMESTAMP" }, { "name": "update_time", "mode": "NULLABLE", "type": "TIMESTAMP" }, { "name": "type", "mode": "NULLABLE", "type": "INTEGER" }, { "fields": [ { "fields": [ { "name": "package_name", "mode": "NULLABLE", "type": "STRING" }, { "name": "architecture", "mode": "NULLABLE", "type": "STRING" }, { "name": "version", "mode": "NULLABLE", "type": "STRING" } ], "name": "yum_package", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "package_name", "mode": "NULLABLE", "type": "STRING" }, { "name": "architecture", "mode": "NULLABLE", "type": "STRING" }, { "name": "version", "mode": "NULLABLE", "type": "STRING" } ], "name": "apt_package", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "package_name", "mode": "NULLABLE", "type": "STRING" }, { "name": "architecture", "mode": "NULLABLE", "type": "STRING" }, { "name": "version", "mode": "NULLABLE", "type": "STRING" } ], "name": "zypper_package", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "package_name", "mode": "NULLABLE", "type": "STRING" }, { "name": "architecture", "mode": "NULLABLE", "type": "STRING" }, { "name": "version", "mode": "NULLABLE", "type": "STRING" } ], "name": "googet_package", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "patch_name", "mode": "NULLABLE", "type": "STRING" }, { "name": "category", "mode": "NULLABLE", "type": "STRING" }, { "name": "severity", "mode": "NULLABLE", "type": "STRING" }, { "name": "summary", "mode": "NULLABLE", "type": "STRING" } ], "name": "zypper_patch", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "title", "mode": "NULLABLE", "type": "STRING" }, { "name": "description", "mode": "NULLABLE", "type": "STRING" }, { "fields": [ { "name": "id", "mode": "NULLABLE", "type": "STRING" }, { "name": "name", "mode": "NULLABLE", "type": "STRING" } ], "name": "categories", "mode": "REPEATED", "type": "RECORD" }, { "name": "kb_article_ids", "mode": "REPEATED", "type": "STRING" }, { "name": "support_url", "mode": "NULLABLE", "type": "STRING" }, { "name": "more_info_urls", "mode": "REPEATED", "type": "STRING" }, { "name": "update_id", "mode": "NULLABLE", "type": "STRING" }, { "name": "revision_number", "mode": "NULLABLE", "type": "INTEGER" }, { "name": "last_deployment_change_time", "mode": "NULLABLE", "type": "TIMESTAMP" } ], "name": "wua_package", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "caption", "mode": "NULLABLE", "type": "STRING" }, { "name": "description", "mode": "NULLABLE", "type": "STRING" }, { "name": "hot_fix_id", "mode": "NULLABLE", "type": "STRING" }, { "name": "install_time", "mode": "NULLABLE", "type": "TIMESTAMP" } ], "name": "qfe_package", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "package_name", "mode": "NULLABLE", "type": "STRING" }, { "name": "architecture", "mode": "NULLABLE", "type": "STRING" }, { "name": "version", "mode": "NULLABLE", "type": "STRING" } ], "name": "cos_package", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "display_name", "mode": "NULLABLE", "type": "STRING" }, { "name": "display_version", "mode": "NULLABLE", "type": "STRING" }, { "name": "publisher", "mode": "NULLABLE", "type": "STRING" }, { "fields": [ { "name": "year", "mode": "NULLABLE", "type": "INTEGER" }, { "name": "month", "mode": "NULLABLE", "type": "INTEGER" }, { "name": "day", "mode": "NULLABLE", "type": "INTEGER" } ], "name": "install_date", "mode": "NULLABLE", "type": "RECORD" }, { "name": "help_link", "mode": "NULLABLE", "type": "STRING" } ], "name": "windows_application", "mode": "NULLABLE", "type": "RECORD" } ], "name": "installed_package", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "fields": [ { "name": "package_name", "mode": "NULLABLE", "type": "STRING" }, { "name": "architecture", "mode": "NULLABLE", "type": "STRING" }, { "name": "version", "mode": "NULLABLE", "type": "STRING" } ], "name": "yum_package", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "package_name", "mode": "NULLABLE", "type": "STRING" }, { "name": "architecture", "mode": "NULLABLE", "type": "STRING" }, { "name": "version", "mode": "NULLABLE", "type": "STRING" } ], "name": "apt_package", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "package_name", "mode": "NULLABLE", "type": "STRING" }, { "name": "architecture", "mode": "NULLABLE", "type": "STRING" }, { "name": "version", "mode": "NULLABLE", "type": "STRING" } ], "name": "zypper_package", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "package_name", "mode": "NULLABLE", "type": "STRING" }, { "name": "architecture", "mode": "NULLABLE", "type": "STRING" }, { "name": "version", "mode": "NULLABLE", "type": "STRING" } ], "name": "googet_package", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "patch_name", "mode": "NULLABLE", "type": "STRING" }, { "name": "category", "mode": "NULLABLE", "type": "STRING" }, { "name": "severity", "mode": "NULLABLE", "type": "STRING" }, { "name": "summary", "mode": "NULLABLE", "type": "STRING" } ], "name": "zypper_patch", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "title", "mode": "NULLABLE", "type": "STRING" }, { "name": "description", "mode": "NULLABLE", "type": "STRING" }, { "fields": [ { "name": "id", "mode": "NULLABLE", "type": "STRING" }, { "name": "name", "mode": "NULLABLE", "type": "STRING" } ], "name": "categories", "mode": "REPEATED", "type": "RECORD" }, { "name": "kb_article_ids", "mode": "REPEATED", "type": "STRING" }, { "name": "support_url", "mode": "NULLABLE", "type": "STRING" }, { "name": "more_info_urls", "mode": "REPEATED", "type": "STRING" }, { "name": "update_id", "mode": "NULLABLE", "type": "STRING" }, { "name": "revision_number", "mode": "NULLABLE", "type": "INTEGER" }, { "name": "last_deployment_change_time", "mode": "NULLABLE", "type": "TIMESTAMP" } ], "name": "wua_package", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "caption", "mode": "NULLABLE", "type": "STRING" }, { "name": "description", "mode": "NULLABLE", "type": "STRING" }, { "name": "hot_fix_id", "mode": "NULLABLE", "type": "STRING" }, { "name": "install_time", "mode": "NULLABLE", "type": "TIMESTAMP" } ], "name": "qfe_package", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "package_name", "mode": "NULLABLE", "type": "STRING" }, { "name": "architecture", "mode": "NULLABLE", "type": "STRING" }, { "name": "version", "mode": "NULLABLE", "type": "STRING" } ], "name": "cos_package", "mode": "NULLABLE", "type": "RECORD" }, { "fields": [ { "name": "display_name", "mode": "NULLABLE", "type": "STRING" }, { "name": "display_version", "mode": "NULLABLE", "type": "STRING" }, { "name": "publisher", "mode": "NULLABLE", "type": "STRING" }, { "fields": [ { "name": "year", "mode": "NULLABLE", "type": "INTEGER" }, { "name": "month", "mode": "NULLABLE", "type": "INTEGER" }, { "name": "day", "mode": "NULLABLE", "type": "INTEGER" } ], "name": "install_date", "mode": "NULLABLE", "type": "RECORD" }, { "name": "help_link", "mode": "NULLABLE", "type": "STRING" } ], "name": "windows_application", "mode": "NULLABLE", "type": "RECORD" } ], "name": "available_package", "mode": "NULLABLE", "type": "RECORD" } ], "name": "value", "mode": "NULLABLE", "type": "RECORD" } ], "name": "items", "mode": "REPEATED", "type": "RECORD" }, { "name": "update_time", "mode": "NULLABLE", "type": "TIMESTAMP" } ], "name": "os_inventory", "mode": "NULLABLE", "type": "RECORD" }, { "name": "ancestors", "mode": "REPEATED", "type": "STRING" }, { "name": "update_time", "mode": "NULLABLE", "type": "TIMESTAMP" } ]关系：在 REST API 中将内容类型设置为
RELATIONSHIP或在 gcloud CLI 中将内容类型设置为relationship，您将创建具有以下架构的 BigQuery 表。关系架构
[ { "name": "name", "mode": "NULLABLE", "type": "STRING" }, { "name": "asset_type", "mode": "NULLABLE", "type": "STRING" }, { "fields": [ { "name": "asset", "mode": "NULLABLE", "type": "STRING" }, { "name": "asset_type", "mode": "NULLABLE", "type": "STRING" }, { "name": "ancestors", "mode": "REPEATED", "type": "STRING" }, { "name": "relationship_type", "mode": "NULLABLE", "type": "STRING" } ], "name": "related_asset", "mode": "NULLABLE", "type": "RECORD" }, { "name": "ancestors", "mode": "REPEATED", "type": "STRING" }, { "name": "update_time", "mode": "NULLABLE", "type": "TIMESTAMP" } ]
将资产快照导出到 BigQuery
导出给定时间戳的资产
如需将给定时间戳的资产快照导出到名为 TABLE_NAME 的 BigQuery 表，请发出以下请求。
gcloud
项目
gcloud asset export \
--project=PROJECT_ID \
--billing-project=BILLING_PROJECT_ID \
--content-type=CONTENT_TYPE \
--snapshot-time="SNAPSHOT_TIME" \
--bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
--output-bigquery-force
请提供以下值：
PROJECT_ID：您要导出其元数据的项目的 ID。BILLING_PROJECT_ID：可选。默认 Cloud Asset Inventory 服务代理所属的项目 ID，该代理有权管理您的 BigQuery 数据集和表。如果您已切换到具有gcloud config set project的结算项目，则无需指定此项。详细了解结算项目。CONTENT_TYPE：资产内容类型。只能为组织导出access-policy内容类型。如果要为项目或文件夹导出该数据，系统会创建一个空表。SNAPSHOT_TIME：可选。您希望截取资产快照的时间。值必须是当前时间或不超过过去 35 天的时间。如果未提供，系统会在当前时间截取快照。如需了解时间格式，请参阅 gcloud topic DateTimes。DATASET_ID：BigQuery 数据集的 ID。TABLE_NAME：要向其中导出元数据的表。如果不存在，系统会创建一个。
其他标志：
--output-bigquery-force：覆盖目标表（如果存在）。
文件夹
gcloud asset export \
--folder=FOLDER_ID \
--billing-project=BILLING_PROJECT_ID \
--content-type=CONTENT_TYPE \
--snapshot-time="SNAPSHOT_TIME" \
--bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
--output-bigquery-force
请提供以下值：
FOLDER_ID：您要导出其元数据的文件夹的 ID。如何查找 Google Cloud 文件夹 ID
控制台
如需查找 Google Cloud 文件夹 ID，请完成以下步骤：
-
转到 Google Cloud 控制台。
- 点击菜单栏中的切换器框。
- 点击请选择：复选框，然后选择您的组织。
- 搜索您的文件夹名称。文件夹 ID 会显示在文件夹名称旁边。
gcloud CLI
您可以使用以下命令检索位于组织级别的 Google Cloud 文件夹 ID：
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)"其中，TOP_LEVEL_FOLDER_NAME 可以是完整的字符串匹配，也可以是部分字符串匹配。移除
--format选项可查看有关找到的文件夹的更多信息。如需获取另一个文件夹中某个文件夹的 ID，请列出各个子文件夹：
gcloud resource-manager folders list --folder=FOLDER_ID
-
BILLING_PROJECT_ID：可选。默认 Cloud Asset Inventory 服务代理所属的项目 ID，该代理有权管理您的 BigQuery 数据集和表。如果您已切换到具有gcloud config set project的结算项目，则无需指定此项。详细了解结算项目。CONTENT_TYPE：资产内容类型。只能为组织导出access-policy内容类型。如果要为项目或文件夹导出该数据，系统会创建一个空表。SNAPSHOT_TIME：可选。您希望截取资产快照的时间。值必须是当前时间或不超过过去 35 天的时间。如果未提供，系统会在当前时间截取快照。如需了解时间格式，请参阅 gcloud topic DateTimes。PROJECT_ID：BigQuery 表所属项目的 ID。DATASET_ID：BigQuery 数据集的 ID。TABLE_NAME：要向其中导出元数据的表。如果不存在，系统会创建一个。
其他标志：
--output-bigquery-force：覆盖目标表（如果存在）。
组织
gcloud asset export \
--organization=ORGANIZATION_ID \
--billing-project=BILLING_PROJECT_ID \
--content-type=CONTENT_TYPE \
--snapshot-time="SNAPSHOT_TIME" \
--bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
--output-bigquery-force
请提供以下值：
ORGANIZATION_ID：您要导出其元数据的组织的 ID。如何查找 Google Cloud 组织 ID
控制台
如需查找 Google Cloud 组织 ID，请完成以下步骤：
-
转到 Google Cloud 控制台。
- 点击菜单栏中的切换器框。
- 点击请选择：复选框，然后选择您的组织。
- 点击全部标签页。组织 ID 显示在组织名称旁边。
gcloud CLI
您可以使用以下命令检索 Google Cloud 组织 ID：
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
BILLING_PROJECT_ID：可选。默认 Cloud Asset Inventory 服务代理所属的项目 ID，该代理有权管理您的 BigQuery 数据集和表。如果您已切换到具有gcloud config set project的结算项目，则无需指定此项。详细了解结算项目。CONTENT_TYPE：资产内容类型。SNAPSHOT_TIME：可选。您希望截取资产快照的时间。值必须是当前时间或不超过过去 35 天的时间。如果未提供，系统会在当前时间截取快照。如需了解时间格式，请参阅 gcloud topic DateTimes。PROJECT_ID：BigQuery 表所属项目的 ID。DATASET_ID：BigQuery 数据集的 ID。TABLE_NAME：要向其中导出元数据的表。如果不存在，系统会创建一个。
其他标志：
--output-bigquery-force：覆盖目标表（如果存在）。
REST
curl -X POST \
-H "X-Goog-User-Project: BILLING_PROJECT_ID" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
"contentType": "CONTENT_TYPE",
"readTime": "SNAPSHOT_TIME",
"outputConfig": {
"bigqueryDestination": {
"dataset": "projects/PROJECT_ID/datasets/DATASET_ID",
"table": "TABLE_NAME",
"force": true
}
}
}' \
https://cloudasset.googleapis.com/v1/SCOPE:exportAssets
请提供以下值：
BILLING_PROJECT_ID：默认 Cloud Asset Inventory 服务代理所属的项目 ID，该代理有权管理您的 BigQuery 数据集和表。详细了解结算项目。CONTENT_TYPE：资产内容类型。只能为组织导出ACCESS_POLICY内容类型。如果您针对项目或文件夹导出这些数据，则系统会创建一个空表。SNAPSHOT_TIME：可选。获取资产快照的时间，采用 RFC 3339 格式。值必须是当前时间或不超过过去 35 天的时间。如果未提供，则截取当前时间的快照。PROJECT_ID：BigQuery 表所属项目的 ID。DATASET_ID：BigQuery 数据集的 ID。TABLE_NAME：要向其中导出元数据的表。如果不存在，系统会创建一个。SCOPE：范围可以是项目、文件夹或组织。允许使用的值包括：
projects/PROJECT_IDprojects/PROJECT_NUMBER如何查找 Google Cloud 项目编号
控制台
如需查找 Google Cloud 项目编号，请完成以下步骤：
-
转到 Google Cloud 控制台中的信息中心页面。
- 点击菜单栏中的切换器框。
- 从请选择：框中选择您的组织，然后搜索项目名称。
- 点击项目名称以切换到该项目。项目信息卡片中会显示项目编号。
gcloud CLI
您可以使用以下命令检索 Google Cloud 项目编号：
gcloud projects describe PROJECT_ID --format="value(projectNumber)"
-
folders/FOLDER_ID如何查找 Google Cloud 文件夹 ID
控制台
如需查找 Google Cloud 文件夹 ID，请完成以下步骤：
-
转到 Google Cloud 控制台。
- 点击菜单栏中的切换器框。
- 点击请选择：复选框，然后选择您的组织。
- 搜索您的文件夹名称。文件夹 ID 会显示在文件夹名称旁边。
gcloud CLI
您可以使用以下命令检索位于组织级别的 Google Cloud 文件夹 ID：
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)"其中，TOP_LEVEL_FOLDER_NAME 可以是完整的字符串匹配，也可以是部分字符串匹配。移除
--format选项可查看有关找到的文件夹的更多信息。如需获取另一个文件夹中某个文件夹的 ID，请列出各个子文件夹：
gcloud resource-manager folders list --folder=FOLDER_ID
-
organizations/ORGANIZATION_ID如何查找 Google Cloud 组织 ID
控制台
如需查找 Google Cloud 组织 ID，请完成以下步骤：
-
转到 Google Cloud 控制台。
- 点击菜单栏中的切换器框。
- 点击请选择：复选框，然后选择您的组织。
- 点击全部标签页。组织 ID 显示在组织名称旁边。
gcloud CLI
您可以使用以下命令检索 Google Cloud 组织 ID：
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
其他参数：
"force": true：覆盖目标表（如果存在）。
为每种资源类型导出单独的表
如需将资源导出到针对每种资源类型的单独 BigQuery 表，请使用 --per-asset-type 标志。每个表的名称都是将 TABLE_NAME 与 _（下划线）和资源类型名称串联起来。非字母数字字符会被替换为 _。
请注意，此类导出不支持除 container.googleapis.com/Cluster 和 container.googleapis.com/NodePool 之外的 GKE 资源类型。
gcloud
项目
gcloud asset export \
--project=PROJECT_ID \
--billing-project=BILLING_PROJECT_ID \
--content-type=CONTENT_TYPE \
--snapshot-time="SNAPSHOT_TIME" \
--bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
--output-bigquery-force \
--per-asset-type
请提供以下值：
PROJECT_ID：您要导出其元数据的项目的 ID。BILLING_PROJECT_ID：可选。默认 Cloud Asset Inventory 服务代理所属的项目 ID，该代理有权管理您的 BigQuery 数据集和表。如果您已切换到具有gcloud config set project的结算项目，则无需指定此项。详细了解结算项目。CONTENT_TYPE：资产内容类型。只能为组织导出access-policy内容类型。如果要为项目或文件夹导出该数据，系统会创建一个空表。SNAPSHOT_TIME：可选。您希望截取资产快照的时间。值必须是当前时间或不超过过去 35 天的时间。如果未提供，系统会在当前时间截取快照。如需了解时间格式，请参阅 gcloud topic DateTimes。DATASET_ID：BigQuery 数据集的 ID。TABLE_NAME：要向其中导出元数据的表。如果不存在，系统会创建一个。
其他标志：
--output-bigquery-force：覆盖目标表（如果存在）。--per-asset-type：导出到每种资源类型的多个 BigQuery 表。
文件夹
gcloud asset export \
--folder=FOLDER_ID \
--billing-project=BILLING_PROJECT_ID \
--content-type=CONTENT_TYPE \
--snapshot-time="SNAPSHOT_TIME" \
--bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
--output-bigquery-force \
--per-asset-type
请提供以下值：
FOLDER_ID：您要导出其元数据的文件夹的 ID。如何查找 Google Cloud 文件夹 ID
控制台
如需查找 Google Cloud 文件夹 ID，请完成以下步骤：
-
转到 Google Cloud 控制台。
- 点击菜单栏中的切换器框。
- 点击请选择：复选框，然后选择您的组织。
- 搜索您的文件夹名称。文件夹 ID 会显示在文件夹名称旁边。
gcloud CLI
您可以使用以下命令检索位于组织级别的 Google Cloud 文件夹 ID：
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)"其中，TOP_LEVEL_FOLDER_NAME 可以是完整的字符串匹配，也可以是部分字符串匹配。移除
--format选项可查看有关找到的文件夹的更多信息。如需获取另一个文件夹中某个文件夹的 ID，请列出各个子文件夹：
gcloud resource-manager folders list --folder=FOLDER_ID
-
BILLING_PROJECT_ID：可选。默认 Cloud Asset Inventory 服务代理所属的项目 ID，该代理有权管理您的 BigQuery 数据集和表。如果您已切换到具有gcloud config set project的结算项目，则无需指定此项。详细了解结算项目。CONTENT_TYPE：资产内容类型。只能为组织导出access-policy内容类型。如果要为项目或文件夹导出该数据，系统会创建一个空表。SNAPSHOT_TIME：可选。您希望截取资产快照的时间。值必须是当前时间或不超过过去 35 天的时间。如果未提供，系统会在当前时间截取快照。如需了解时间格式，请参阅 gcloud topic DateTimes。PROJECT_ID：BigQuery 表所属项目的 ID。DATASET_ID：BigQuery 数据集的 ID。TABLE_NAME：要向其中导出元数据的表。如果不存在，系统会创建一个。
其他标志：
--output-bigquery-force：覆盖目标表（如果存在）。--per-asset-type：导出到每种资源类型的多个 BigQuery 表。
组织
gcloud asset export \
--organization=ORGANIZATION_ID \
--billing-project=BILLING_PROJECT_ID \
--content-type=CONTENT_TYPE \
--snapshot-time="SNAPSHOT_TIME" \
--bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
--output-bigquery-force \
--per-asset-type
请提供以下值：
ORGANIZATION_ID：您要获取数据分析的组织的 ID。如何查找 Google Cloud 组织 ID
控制台
如需查找 Google Cloud 组织 ID，请完成以下步骤：
-
转到 Google Cloud 控制台。
- 点击菜单栏中的切换器框。
- 点击请选择：复选框，然后选择您的组织。
- 点击全部标签页。组织 ID 显示在组织名称旁边。
gcloud CLI
您可以使用以下命令检索 Google Cloud 组织 ID：
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
BILLING_PROJECT_ID：可选。默认 Cloud Asset Inventory 服务代理所属的项目 ID，该代理有权管理您的 BigQuery 数据集和表。如果您已切换到具有gcloud config set project的结算项目，则无需指定此项。详细了解结算项目。CONTENT_TYPE：资产内容类型。SNAPSHOT_TIME：可选。您希望截取资产快照的时间。值必须是当前时间或不超过过去 35 天的时间。如果未提供，系统会在当前时间截取快照。如需了解时间格式，请参阅 gcloud topic DateTimes。PROJECT_ID：BigQuery 表所属项目的 ID。DATASET_ID：BigQuery 数据集的 ID。TABLE_NAME：要向其中导出元数据的表。如果不存在，系统会创建一个。
其他标志：
--output-bigquery-force：覆盖目标表（如果存在）。--per-asset-type：导出到每种资源类型的多个 BigQuery 表。
REST
curl -X POST \
-H "X-Goog-User-Project: BILLING_PROJECT_ID" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
"contentType": "CONTENT_TYPE",
"readTime": "SNAPSHOT_TIME",
"outputConfig": {
"bigqueryDestination": {
"dataset": "projects/PROJECT_ID/datasets/DATASET_ID",
"table": "TABLE_NAME",
"force": true,
"separateTablesPerAssetType": true
}
}
}' \
https://cloudasset.googleapis.com/v1/SCOPE:exportAssets
请提供以下值：
BILLING_PROJECT_ID：默认 Cloud Asset Inventory 服务代理所属的项目 ID，该代理有权管理您的 BigQuery 数据集和表。详细了解结算项目。CONTENT_TYPE：资产内容类型。只能为组织导出ACCESS_POLICY内容类型。如果您针对项目或文件夹导出这些数据，则系统会创建一个空表。SNAPSHOT_TIME：可选。您希望截取资源快照的时间，采用 RFC 3339 格式。值必须是当前时间或不超过过去 35 天的时间。如果未提供，则截取当前时间的快照。PROJECT_ID：BigQuery 表所属项目的 ID。DATASET_ID：BigQuery 数据集的 ID。TABLE_NAME：要向其中导出元数据的表。如果不存在，系统会创建一个。SCOPE：范围可以是项目、文件夹或组织。允许使用的值包括：
projects/PROJECT_IDprojects/PROJECT_NUMBER如何查找 Google Cloud 项目编号
控制台
如需查找 Google Cloud 项目编号，请完成以下步骤：
-
转到 Google Cloud 控制台中的信息中心页面。
- 点击菜单栏中的切换器框。
- 从请选择：框中选择您的组织，然后搜索项目名称。
- 点击项目名称以切换到该项目。项目信息卡片中会显示项目编号。
gcloud CLI
您可以使用以下命令检索 Google Cloud 项目编号：
gcloud projects describe PROJECT_ID --format="value(projectNumber)"
-
folders/FOLDER_ID如何查找 Google Cloud 文件夹 ID
控制台
如需查找 Google Cloud 文件夹 ID，请完成以下步骤：
-
转到 Google Cloud 控制台。
- 点击菜单栏中的切换器框。
- 点击请选择：复选框，然后选择您的组织。
- 搜索您的文件夹名称。文件夹 ID 会显示在文件夹名称旁边。
gcloud CLI
您可以使用以下命令检索位于组织级别的 Google Cloud 文件夹 ID：
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)"其中，TOP_LEVEL_FOLDER_NAME 可以是完整的字符串匹配，也可以是部分字符串匹配。移除
--format选项可查看有关找到的文件夹的更多信息。如需获取另一个文件夹中某个文件夹的 ID，请列出各个子文件夹：
gcloud resource-manager folders list --folder=FOLDER_ID
-
organizations/ORGANIZATION_ID如何查找 Google Cloud 组织 ID
控制台
如需查找 Google Cloud 组织 ID，请完成以下步骤：
-
转到 Google Cloud 控制台。
- 点击菜单栏中的切换器框。
- 点击请选择：复选框，然后选择您的组织。
- 点击全部标签页。组织 ID 显示在组织名称旁边。
gcloud CLI
您可以使用以下命令检索 Google Cloud 组织 ID：
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
其他参数：
"force": true：覆盖目标表（如果存在）。
如果导出到任何表失败，则整个导出操作将失败并返回第一个错误。先前成功导出的结果仍然存在。
为了克服 JSON3 和 BigQuery 类型之间的兼容性问题，以下类型打包到 JSON 字符串中。
google.protobuf.Timestampgoogle.protobuf.Durationgoogle.protobuf.FieldMaskgoogle.protobuf.ListValuegoogle.protobuf.Valuegoogle.protobuf.Structgoogle.api.*
导出到分区表
如需将项目中的资产导出到分区表，请在导出请求中定义分区键。导出的快照存储在名为 TABLE_NAME 的 BigQuery 表中，该表具有每日粒度和两个额外的时间戳列（readTime 和 requestTime，其中一个由 PARTITION_KEY 值指定）。
如需将项目中的资产导出到分区表，请发出以下请求之一。
gcloud
项目
gcloud asset export \
--project=PROJECT_ID \
--billing-project=BILLING_PROJECT_ID \
--content-type=CONTENT_TYPE \
--snapshot-time="SNAPSHOT_TIME" \
--bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
--partition-key=PARTITION_KEY \
--output-bigquery-force
请提供以下值：
PROJECT_ID：您要导出其元数据的项目的 ID。BILLING_PROJECT_ID：可选。默认 Cloud Asset Inventory 服务代理所属的项目 ID，该代理有权管理您的 BigQuery 数据集和表。如果您已切换到具有gcloud config set project的结算项目，则无需指定此项。详细了解结算项目。CONTENT_TYPE：资产内容类型。只能为组织导出access-policy内容类型。如果要为项目或文件夹导出该数据，系统会创建一个空表。SNAPSHOT_TIME：可选。您希望截取资产快照的时间。值必须是当前时间或不超过过去 35 天的时间。如果未提供，系统会在当前时间截取快照。如需了解时间格式，请参阅 gcloud topic DateTimes。DATASET_ID：BigQuery 数据集的 ID。TABLE_NAME：要向其中导出元数据的表。如果不存在，系统会创建一个。PARTITION_KEY：导出到 BigQuery 分区表时的分区键列。有效值为read-time和request-time。
其他标志：
--output-bigquery-force：覆盖目标表（如果存在）。
文件夹
gcloud asset export \
--folder=FOLDER_ID \
--billing-project=BILLING_PROJECT_ID \
--content-type=CONTENT_TYPE \
--snapshot-time="SNAPSHOT_TIME" \
--bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
--partition-key=PARTITION_KEY \
--output-bigquery-force
请提供以下值：
FOLDER_ID：您要导出其元数据的文件夹的 ID。如何查找 Google Cloud 文件夹 ID
控制台
如需查找 Google Cloud 文件夹 ID，请完成以下步骤：
-
转到 Google Cloud 控制台。
- 点击菜单栏中的切换器框。
- 点击请选择：复选框，然后选择您的组织。
- 搜索您的文件夹名称。文件夹 ID 会显示在文件夹名称旁边。
gcloud CLI
您可以使用以下命令检索位于组织级别的 Google Cloud 文件夹 ID：
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)"其中，TOP_LEVEL_FOLDER_NAME 可以是完整的字符串匹配，也可以是部分字符串匹配。移除
--format选项可查看有关找到的文件夹的更多信息。如需获取另一个文件夹中某个文件夹的 ID，请列出各个子文件夹：
gcloud resource-manager folders list --folder=FOLDER_ID
-
BILLING_PROJECT_ID：可选。默认 Cloud Asset Inventory 服务代理所属的项目 ID，该代理有权管理您的 BigQuery 数据集和表。如果您已切换到具有gcloud config set project的结算项目，则无需指定此项。详细了解结算项目。CONTENT_TYPE：资产内容类型。只能为组织导出access-policy内容类型。如果要为项目或文件夹导出该数据，系统会创建一个空表。SNAPSHOT_TIME：可选。您希望截取资产快照的时间。值必须是当前时间或不超过过去 35 天的时间。如果未提供，系统会在当前时间截取快照。如需了解时间格式，请参阅 gcloud topic DateTimes。PROJECT_ID：BigQuery 表所属项目的 ID。DATASET_ID：BigQuery 数据集的 ID。TABLE_NAME：要向其中导出元数据的表。如果不存在，系统会创建一个。PARTITION_KEY：导出到 BigQuery 分区表时的分区键列。有效值为read-time和request-time。
其他标志：
--output-bigquery-force：覆盖目标表（如果存在）。
组织
gcloud asset export \
--organization=ORGANIZATION_ID \
--billing-project=BILLING_PROJECT_ID \
--content-type=CONTENT_TYPE \
--snapshot-time="SNAPSHOT_TIME" \
--bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
--partition-key=PARTITION_KEY \
--output-bigquery-force
请提供以下值：
ORGANIZATION_ID：您要获取数据分析的组织的 ID。如何查找 Google Cloud 组织 ID
控制台
如需查找 Google Cloud 组织 ID，请完成以下步骤：
-
转到 Google Cloud 控制台。
- 点击菜单栏中的切换器框。
- 点击请选择：复选框，然后选择您的组织。
- 点击全部标签页。组织 ID 显示在组织名称旁边。
gcloud CLI
您可以使用以下命令检索 Google Cloud 组织 ID：
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
BILLING_PROJECT_ID：可选。默认 Cloud Asset Inventory 服务代理所属的项目 ID，该代理有权管理您的 BigQuery 数据集和表。如果您已切换到具有gcloud config set project的结算项目，则无需指定此项。详细了解结算项目。CONTENT_TYPE：资产内容类型。SNAPSHOT_TIME：可选。您希望截取资产快照的时间。值必须是当前时间或不超过过去 35 天的时间。如果未提供，系统会在当前时间截取快照。如需了解时间格式，请参阅 gcloud topic DateTimes。PROJECT_ID：BigQuery 表所属项目的 ID。DATASET_ID：BigQuery 数据集的 ID。TABLE_NAME：要向其中导出元数据的表。如果不存在，系统会创建一个。PARTITION_KEY：导出到 BigQuery 分区表时的分区键列。有效值为read-time和request-time。
其他标志：
--output-bigquery-force：覆盖目标表（如果存在）。
如果 output-bigquery-force 标志设置为 true，则相应的分区会被快照结果覆盖，但一个或多个不同分区中的数据保持不变。如果 output-bigquery-force 未设置或 false，它会将数据附加到相应的分区。
如果架构更新或尝试附加数据失败，导出操作会失败。 这包括目标表已存在且没有导出所需的架构的情况。
REST
curl -X POST \
-H "X-Goog-User-Project: BILLING_PROJECT_ID" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
"contentType": "CONTENT_TYPE",
"readTime": "SNAPSHOT_TIME",
"outputConfig": {
"bigqueryDestination": {
"dataset": "projects/PROJECT_ID/datasets/DATASET_ID",
"table": "TABLE_NAME",
"force": true,
"partitionSpec": {
"partitionKey": "PARTITION_KEY"
}
}
}
}' \
https://cloudasset.googleapis.com/v1/SCOPE:exportAssets
请提供以下值：
BILLING_PROJECT_ID：默认 Cloud Asset Inventory 服务代理所属的项目 ID，该代理有权管理您的 BigQuery 数据集和表。详细了解结算项目。PROJECT_ID：BigQuery 表所属项目的 ID。CONTENT_TYPE：资产内容类型。只能为组织导出ACCESS_POLICY内容类型。如果您针对项目或文件夹导出这些数据，则系统会创建一个空表。SNAPSHOT_TIME：可选。获取资产快照的时间，采用 RFC 3339 格式。值必须是当前时间或不超过过去 35 天的时间。如果未提供，则截取当前时间的快照。DATASET_ID：BigQuery 数据集的 ID。TABLE_NAME：是要向其中导出元数据的表。如果不存在，系统会创建一个。PARTITION_KEY：是导出到 BigQuery 分区表时的分区键列。有效值为read-time和request-time。SCOPE：范围可以是项目、文件夹或组织。允许使用的值包括：
projects/PROJECT_IDprojects/PROJECT_NUMBER如何查找 Google Cloud 项目编号
控制台
如需查找 Google Cloud 项目编号，请完成以下步骤：
-
转到 Google Cloud 控制台中的信息中心页面。
- 点击菜单栏中的切换器框。
- 从请选择：框中选择您的组织，然后搜索项目名称。
- 点击项目名称以切换到该项目。项目信息卡片中会显示项目编号。
gcloud CLI
您可以使用以下命令检索 Google Cloud 项目编号：
gcloud projects describe PROJECT_ID --format="value(projectNumber)"
-
folders/FOLDER_ID如何查找 Google Cloud 文件夹 ID
控制台
如需查找 Google Cloud 文件夹 ID，请完成以下步骤：
-
转到 Google Cloud 控制台。
- 点击菜单栏中的切换器框。
- 点击请选择：复选框，然后选择您的组织。
- 搜索您的文件夹名称。文件夹 ID 会显示在文件夹名称旁边。
gcloud CLI
您可以使用以下命令检索位于组织级别的 Google Cloud 文件夹 ID：
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)"其中，TOP_LEVEL_FOLDER_NAME 可以是完整的字符串匹配，也可以是部分字符串匹配。移除
--format选项可查看有关找到的文件夹的更多信息。如需获取另一个文件夹中某个文件夹的 ID，请列出各个子文件夹：
gcloud resource-manager folders list --folder=FOLDER_ID
-
organizations/ORGANIZATION_ID如何查找 Google Cloud 组织 ID
控制台
如需查找 Google Cloud 组织 ID，请完成以下步骤：
-
转到 Google Cloud 控制台。
- 点击菜单栏中的切换器框。
- 点击请选择：复选框，然后选择您的组织。
- 点击全部标签页。组织 ID 显示在组织名称旁边。
gcloud CLI
您可以使用以下命令检索 Google Cloud 组织 ID：
gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
-
其他参数：
"force": true：覆盖目标表（如果存在）。仅当表具有导出所需的分区结构时，这种方法才有效。如果将
force设置为true，则相应分区会被快照结果覆盖，而不同分区中的数据保持不变。如果force未设置或设为false，数据将附加到相应的分区。
如果架构更新或尝试附加数据失败，导出操作将失败。这包括目标表已存在且没有导出所需的架构的情况。
检查导出状态
操作与操作 ID（即 UUID）相关联。此值可能比较敏感，因为 gcloud asset operations describe 命令无需额外的权限即可成功运行。请确保仅与可信用户共享操作 ID。
如果之前对同一目的地的请求开始不到 15 分钟且仍在运行，服务器会拒绝相应请求。如果导出时间超过 15 分钟，且在第一个请求成功之前对同一目的地连续执行请求，则可能会出现未定义的结果。
如需检查导出状态，请运行以下命令。
gcloud CLI
如需检查导出状态，您可以运行以下命令。运行导出命令后，响应中会显示 OPERATION_PATH。
gcloud asset operations describe OPERATION_PATH
REST
要查看导出的状态，请使用导出响应中返回的操作 ID 运行以下命令。
您可以在导出响应的
name字段中找到OPERATION_PATH，其格式如下所示："name": "projects/PROJECT_NUMBER/operations/ExportAssets/CONTENT_TYPE/OPERATION_ID"要检查导出状态，请使用
OPERATION_PATH运行以下命令：curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ https://cloudasset.googleapis.com/v1/OPERATION_PATH
查看资产快照
如需查看包含资源快照元数据的表，请完成以下步骤。
控制台
前往 Google Cloud 控制台中的 BigQuery Studio 页面。
如需显示数据集中的表和视图，请打开导航面板。在资源部分中，选择您的项目将其展开，然后选择一个数据集。
从列表中选择您的表。
选择详情并记下行数中的值。使用 gcloud CLI 或 REST API 时，您可能需要此值来控制结果的起点。
要查看一组数据示例，请选择预览。
REST
如需浏览表的数据，请调用 tabledata.list。在 tableId 参数中，指定表的名称。
您可以配置以下可选参数来控制输出。
maxResults是要返回的结果数上限。selectedFields是要返回的列的逗号分隔列表；如果未指定此参数，则会返回所有列。startIndex是要读取的起始行的索引（从零开始）。
返回的值会封装在一个 JSON 对象中，您必须对此对象进行解析，具体请参阅 tabledata.list 参考文档。
导出结果列出了资产及其资源名称。
查询资源快照
将快照导出到 BigQuery 后，您便可以对资产元数据运行查询。 如需详细了解几个典型的使用场景，请参阅导出到 BigQuery 示例查询。
默认情况下，BigQuery 运行交互式（也称为按需）查询作业，也就是说，查询会尽快执行。交互式查询会计入并发速率限制和每日上限。
查询结果会保存到临时表或永久表中。 您可以选择在现有表中附加或覆盖数据，或者创建新表（如果不存在同名的表）。
如需运行将输出写入临时表的交互式查询，请完成以下步骤。
控制台
前往 Google Cloud 控制台中的 BigQuery Studio 页面。
选择编写新查询。
在查询编辑器文本区域中，输入有效的 BigQuery SQL 查询。
可选：如需更改数据处理位置，请完成以下步骤。
选择更多，然后选择查询设置。
在处理位置下，选择自动选择，然后选择数据的位置。
要更新查询设置，请选择保存。
选择运行。
REST
如需启动新作业，请调用
jobs.insert方法。在作业资源中，设置以下参数。在
configuration字段中，将query字段设置为描述 BigQuery 查询作业的 JobConfigurationQuery。在
jobReference字段中，为您的作业适当设置location字段。
如需轮询结果，请调用
getQueryResults。直到jobComplete等于true。您可以在errors列表中检查错误和警告。