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

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

本主题将介绍如何在界面中创建和修改键值映射 (KVM)。您在界面中创建的 KVM 的范围限定为环境。如需详细了解 KVM 和范围，请参阅使用键值映射。

在 Edge 界面中通过 Edge Private Cloud 启用加密的 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 for Public Cloud，键名的大小不能超过 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. 执行以下操作之一：
      • 如需修改条目，请点击修改，修改条目，然后点击保存。
      • 如需删除条目，请点击删除。