创建和删除 RuntimeConfig 资源

本页介绍如何创建配置资源。配置资源是一种 API 对象，可将变量存储为键值对。您必须先拥有配置资源，然后才能设置和获取变量。创建配置资源后，您可以创建用于存储数据的任意变量。

如需详细了解配置、变量和 Runtime Configurator 服务，请参阅 Runtime Configurator 基础知识。

准备工作

创建配置

您可以使用 Deployment Manager、gcloud 命令行工具或直接使用 Runtime Configurator API 来创建配置资源。

Deployment Manager

要在 Deployment Manager 中创建配置，请指定 RuntimeConfig 类型：

runtimeconfig.v1beta1.config

在资源的 properties 中，根据需要提供 name 和其他可选属性：

resources:
- name: [CONFIG_NAME]
  type: runtimeconfig.v1beta1.config
  properties:
    config: [CONFIG_NAME]
    description: [DESCRIPTION]

其中：

  • [CONFIG_NAME] 是此配置的名称。
  • [DESCRIPTION] 是此配置的说明（可选）。

gcloud

在 Google Cloud CLI 中，使用 gcloud beta runtime-config configs create 命令：

gcloud beta runtime-config configs create [CONFIG_NAME] --description [DESCRIPTION]

其中：

  • [CONFIG_NAME] 是此配置的名称。
  • [DESCRIPTION] 是此配置的说明（可选）。

gcloud 会返回如下响应：

Created [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].

如需查看此 gcloud 命令的完整参考文档，请阅读 runtime-config configs create 参考文档。

API

在 REST API 中，向以下 URI 发出 POST 请求：

https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/

其中，[PROJECT_ID] 是此请求的项目 ID。此请求的载荷如下所示：

{
   "name": "projects/[PROJECT_ID]/configs/[CONFIG_NAME]",
   "description": "[DESCRIPTION]"

}

其中：

  • [PROJECT_ID] 是此请求的项目 ID。
  • [CONFIG_NAME] 是此 RuntimeConfig 的名称。

  • [DESCRIPTION] 是此配置的说明（可选）。

    要详细了解此方法，请阅读 configs().create 文档。

删除 RuntimeConfig 资源

删除 RuntimeConfig 资源会删除该资源包含的所有资源，包括所有变量和 waiter。

Deployment Manager

使用以下方法之一删除属于部署的 RuntimeConfig 资源：

gcloud

在 Google Cloud CLI 中，使用 gcloud beta runtime-config configs delete 命令：

gcloud beta runtime-config configs delete [CONFIG_NAME]

其中，[CONFIG_NAME] 是配置对象的名称。

gcloud CLI 会返回如下响应：

Deleted [https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]].

如需查看完整的 gcloud 参考文档，请阅读 runtime-config configs delete 参考文档。

API

在 REST API 中，向以下 URI 发出 DELETE 请求：

https://runtimeconfig.googleapis.com/v1beta1/projects/[PROJECT_ID]/configs/[CONFIG_NAME]

其中：

  • [PROJECT_ID] 是此请求的项目 ID。

  • [CONFIG_NAME] 是此配置的名称。

    要详细了解此方法，请阅读 configs().delete 文档。

后续步骤