本页面介绍如何使用通过 Deployment Manager 创建的类型提供程序。本页面不涉及如何创建类型提供程序。如需了解如何创建类型提供程序,请阅读创建类型提供程序。
准备工作
- 如果要使用本指南中的命令行示例,请安装 “gcloud” 命令行工具。
- 如果希望使用本指南中的 API 示例,请设置 API 访问权限。
访问类型提供程序
类型提供程序是属于项目范围的资源,可以根据访问权限控制文档中描述的权限进行访问。具体来说:
- 项目编辑者和查看者可以创建和使用该项目可用的类型。
- 类型查看者可以获取该项目可用的列表和使用类型。
您还可以将另一个项目添加为 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
...