#### 6.4.4.15 插件特定的密钥环密钥管理功能

[](<>)

对于每个 keyring 插件特定的函数，本节描述了它的用途、调用顺序和返回值。有关通用密钥环功能的信息，请参阅[第 6.4.4.14 节，“通用密钥环密钥管理功能”](keyring-functions-general-purpose.html).

-   [](<>) [`keyring_aws_rotate_cmk()`](keyring-functions-plugin-specific.html#function_keyring-aws-rotate-cmk)

    [](<>)[](<>)

    相关的密钥环插件：`密钥环_aws`

    [`keyring_aws_rotate_cmk()`](keyring-functions-plugin-specific.html#function_keyring-aws-rotate-cmk)轮换 AWS KMS 密钥。轮换仅更改 AWS KMS 用于后续数据密钥加密操作的密钥。AWS KMS 维护以前的 CMK 版本，因此使用以前的 CMK 生成的密钥在轮换后仍可解密。

    轮换会更改 AWS KMS 内部使用的 CMK 值，但不会更改用于引用它的 ID，因此无需更改[`keyring_aws_cmk_id`](keyring-system-variables.html#sysvar_keyring_aws_cmk_id)调用后的系统变量[`keyring_aws_rotate_cmk()`](keyring-functions-plugin-specific.html#function_keyring-aws-rotate-cmk).

    此功能需要[`极好的`](privileges-provided.html#priv_super)特权。

    论据：

    没有。

    返回值：

    返回 1 表示成功，或者`空值`和失败的错误。

-   [](<>) [`keyring_aws_rotate_keys()`](keyring-functions-plugin-specific.html#function_keyring-aws-rotate-keys)

    [](<>)[](<>)

    相关的密钥环插件：`密钥环_aws`

    [`keyring_aws_rotate_keys()`](keyring-functions-plugin-specific.html#function_keyring-aws-rotate-keys)旋转存储在`密钥环_aws`命名的存储文件[`keyring_aws_data_file`](keyring-system-variables.html#sysvar_keyring_aws_data_file)系统变量。轮换将文件中存储的每个密钥发送到 AWS KMS 以使用[`keyring_aws_cmk_id`](keyring-system-variables.html#sysvar_keyring_aws_cmk_id)系统变量作为 CMK 值，并将新的加密密钥存储在文件中。

    [`keyring_aws_rotate_keys()`](keyring-functions-plugin-specific.html#function_keyring-aws-rotate-keys)在这些情况下对密钥重新加密很有用：

    -   旋转 CMK 后；也就是说，在调用[`keyring_aws_rotate_cmk()`](keyring-functions-plugin-specific.html#function_keyring-aws-rotate-cmk)功能。

    -   更改后[`keyring_aws_cmk_id`](keyring-system-variables.html#sysvar_keyring_aws_cmk_id)系统变量到不同的键值。

        此功能需要[`极好的`](privileges-provided.html#priv_super)特权。

        论据：

        没有。

        返回值：

        返回 1 表示成功，或者`空值`和失败的错误。

-   [](<>) [`keyring_hashicorp_update_config()`](keyring-functions-plugin-specific.html#function_keyring-hashicorp-update-config)

    [](<>)[](<>)

    相关的密钥环插件：`keyring_hashicorp`

    调用时，[`keyring_hashicorp_update_config()`](keyring-functions-plugin-specific.html#function_keyring-hashicorp-update-config)功能原因`keyring_hashicorp`执行运行时重新配置，如中所述[钥匙圈\_hashcorp 配置](keyring-hashicorp-plugin.html#keyring-hashicorp-plugin-configuration).

    此功能需要[`SYSTEM_VARIABLES_ADMIN`](privileges-provided.html#priv_system-variables-admin)特权，因为它修改全局系统变量。

    论据：

    没有。

    返回值：

    返回字符串`'配置更新成功。'`为了成功，或`“配置更新失败。”`为失败。
