17370845950

本文详解如何在 python 中正确调用 gcp asset inventory api 查询 compute engine 实例，解决常见的 `400 no supported asset type matches` 错误，重点说明 `asset_types` 参数的合法格式与最佳实践。

Google Cloud Asset Inventory 的 search_all_resources 方法支持按资源类型（asset_types）进行过滤，但不支持通配符语法（如 "compute.*"）*——这正是你遇到 400 No supported asset type matches 错误的根本原因。虽然 REST API 文档或 Insomnia 等工具中 `"compute."可能看似生效（实为服务端宽松解析或客户端自动展开），但在 Python 客户端库（google-cloud-asset==v1）中，asset_types` 字段要求传入精确、完整、标准化的资源类型 URI**，且必须是 官方支持的可搜索资产类型 中明确列出的值。

✅ 正确做法是：使用完整的 Google API 资源类型字符串，例如：

• compute.googleapis.com/Instance（对应虚拟机实例）
• compute.googleapis.com/Disk（对应持久化磁盘）
• compute.googleapis.com/Network（对应 VPC 网络）

以下为修复后的完整示例代码：

from google.cloud import asset_v1

def search_compute_instances(project_id: str):
    client = asset_v1.AssetServiceClient()

    request = asset_v1.SearchAllResourcesRequest(
        scope=f"projects/{project_id}",
        read_mask="displayName,assetType,name,location,resource.data",  # 可按需扩展字段
        asset_types=["compute.googleapis.com/Instance"],  # ✅ 必须是字符串列表，且为完整类型名
        # 注意：asset_types 是 list[str] 类型，不是单个字符串
    )

    page_result = client.search_all_resources(request=request)

    for resource in page_result:
        print(f"Instance: {resource.display_name}")
        print(f"  Type: {resource.asset_type}")
        print(f"  Name: {resource.name}")
        print(f"  Location: {resource.location}")
        print("---")

# 使用示例（替换为你的实际项目 ID）
search_compute_instances("my-gcp-project-123456")

⚠️ 关键注意事项：

• asset_types 参数类型为 List[str]（Python 列表），不可传入字符串 "compute.googleapis.com/Instance"，否则会触发类型错误；必须写成 ["compute.googleapis.com/Instance"]。
• 若需查询多个类型（如实例 + 磁盘），可传入 ["compute.googleapis.com/Instance", "compute.googleapis.com/Disk"]。
• read_mask 控制返回字段，建议显式指定所需字段以提升性能和可读性；若留空，则默认返回全部可读字段（可能含大量冗余数据）。
• 确保服务账号已授予 cloudasset.assets.searchAllResources 权限（通常由 roles/cloudasset.viewer 或更细粒度角色提供）。
• 首次启用 Asset API 后，需等待数分钟至数小时，系统才会完成历史资源快照的初始导出；若立即查询无结果，请确认资源是否已在资产库存中可用。

? 小技巧：可通过 gcloud asset search-all-resources --asset-types=compute.googleapis.com/Instance --scope=projects/my-project 命令行快速验证类型是否有效，避免反复调试代码。

总结：GCP Asset API 的 asset_types 不支持通配符，务必使用官方文档中列出的完整资源类型 URI，并以字符串列表形式传入。掌握这一规范，即可稳定、高效地实现跨资源类型的批量发现与合规审计。