在配置中调用类型提供程序

本页面介绍如何使用通过 Deployment Manager 创建的类型提供程序。本页面不涉及如何创建类型提供程序。如需了解如何创建类型提供程序,请阅读创建类型提供程序

准备工作

访问类型提供程序

类型提供程序是属于项目范围的资源,可以根据访问权限控制文档中描述的权限进行访问。具体来说:

  • 项目编辑者和查看者可以创建和使用该项目可用的类型。
  • 类型查看者可以获取该项目可用的列表和使用类型。

您还可以将另一个项目添加为 Type Viewer,以便该项目访问您的类型。请阅读跨项目共享类型

使用类型提供程序

要在配置中使用由类型提供程序公开的类型,请使用以下语法:

type: [PROJECT_ID]/[TYPE_NAME]:[COLLECTION]
  • 如果此 API 由 OpenAPI 规范提供支持,则 [COLLECTION] 将是资源路径的 REST 标识符。例如:

    type: my-project/emailAddressesTypeProvider:emailAddresses/v1beta/people
    
  • 如果 API 由 Google Discovery 文档提供支持,则 [COLLECTION] 是指向 API 中所需资源的资源路径。例如,要创建服务账号密钥,该集合将是:

    type: my-project/example-type-provider:projects.serviceAccounts.keys
    

现在,您可以根据底层 API 的要求继续配置类型:

resources:
- name: Jane
  type: my-project/emailAddressesTypeProvider:emailAddresses/v1beta/people
  properties:
  - displayName: Jane
    email: jane@example.com
    ...

后续步骤