创建和修改环境键值对映射

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息

本主题介绍了如何在界面中创建和修改键值映射 (KVM)。您在界面中创建的 KVM 是环境级的。如需详细了解 KVM 和作用域，请参阅使用键值映射。

使用 Edge for Private Cloud 在 Edge 界面中启用加密 KVM

Edge for Private Cloud 4.17.01 及更高版本支持加密 KVM。不过，Edge 界面中对加密 KVM 的支持默认处于停用状态。如需让 Edge 界面支持加密的 KVM，请执行以下操作：

  1. 在 Edge 界面服务器上，通过编辑器打开 ui.properties 文件。如果该文件不存在，请创建该文件：
    > vi /opt/apigee/customer/application/ui.properties
  2. 将 conf_apigee_apigee.feature.kvmencryption 令牌设置为 true：
    conf_apigee_apigee.feature.kvmencryption=true
  3. 保存更改。
  4. 将 ui.properties 的所有者更改为“apigee”：
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  5. 重启 Edge 界面：
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui restart

管理环境键值对映射

管理您的 KVM，如下所述。KVM 在环境级别定义。例如，如果您在“测试”环境中创建 KVM，则在“生产”环境中运行的 API 代理将无法访问该 KVM。

Edge

如需使用 Edge 界面管理 KVM，请执行以下操作：

  1. 登录 apigee.com/edge。
  2. 在左侧导航栏中，依次选择管理 > 环境 > 键值对映射。
  3. 如需创建 KVM，请执行以下操作：
    1. 点击 + 键值对映射。
    2. 输入新 KVM 的属性值。下表介绍了这些设置。
      属性名称 说明
      名称 KVM 的名称。该名称在环境中必须是唯一的。系统将从与 KVM 交互的政策引用此名称。
      已加密用于指定 KVM 是否已加密的标志。在界面中，加密值将显示为星号 (*****)。加密设置会应用于整个地图。您无法逐项设置加密条目。
      注意：您只能在创建 KVM 时对其进行加密。键值映射创建后，您无法对其进行加密或解密。
    3. 点击添加。
  4. 如需向 KVM 添加条目，请执行以下操作：
    1. 点击列表中的 KMV 名称，以显示当前条目。
    2. 点击 +。
    3. 输入新 KVM 条目的属性值，如下所述。
      属性名称 说明
      键

      您将用于访问 API 代理中数据值的键名称。

      对于适用于公有云的 Apigee Edge，键名不能大于 2 KB。

      在 Edge 界面中，名称不得包含“/”。
      值

      键的值。输入数字、字母或特殊字符的任意组合。

      注意：KVM 的总大小不得超过 15 MB。
    4. 点击添加。
  5. 如需管理 KVM 中的键条目，请执行以下操作：
    1. 点击列表中的 KVM 名称以显示当前条目。
    2. 将光标置于 KVM 条目上，以显示操作菜单，然后执行以下任务之一：
      • 如需复制条目的值，请点击 。
      • 如需修改条目，请点击 。然后，修改相应条目，然后点击更新。
      • 如需删除条目，请点击 。然后，点击删除以确认操作。

传统边缘（私有云）

如需使用 Classic Edge 界面创建和修改 KVM，请执行以下操作：

  1. 登录 http://ms-ip:9000，其中 ms-ip 是管理服务器节点的 IP 地址或 DNS 名称。
  2. 依次选择 APIs > Environment Configuration > Key Value Maps。
  3. 选择要为其配置缓存的环境，例如 test 或 prod。
  4. 如需创建 KVM，请执行以下操作：
    1. 点击 + 键值对映射。
    2. 输入新 KVM 的属性值，如下所述。
      属性名称 说明
      名称 KVM 的名称。该名称在环境中必须是唯一的。系统将从与 KVM 交互的政策引用此名称。
      已加密用于指定 KVM 是否已加密的标志。在界面中，加密值将显示为星号 (*****)。加密设置会应用于整个地图。您无法逐项设置加密条目。
      注意：您只能在创建 KVM 时对其进行加密。键值映射创建后，您无法对其进行加密或解密。
    3. 点击添加。
  5. 如需向 KVM 添加条目，请执行以下操作：
    1. 点击列表中的 KVM 名称，展开其条目列表。
    2. 点击 + 条目
    3. 输入新 KVM 条目的属性值，如下所述。
      属性名称 说明
      键

      您将用来访问 API 代理中数据值的键名称。在 Edge 界面中，名称不得包含“/”。

      注意：对于 Edge for Public Cloud，键名称不得超过 2 KB。
      值

      键的值。输入数字、字母或特殊字符的任意组合。

      注意：KVM 的总大小不得超过 15 MB。
    4. 点击保存。
  6. 如需修改或删除 KVM 中的键条目，请执行以下操作：
    1. 点击列表中的 KVM 名称，展开其密钥条目列表。
    2. 执行以下操作之一：
      • 如需修改条目，请点击修改，修改条目，然后点击保存。
      • 如要删除条目，请点击删除。