使用 CLI 修改云设置

可使用工具箱 CLI 来编辑云设置。

关于此任务

某些云设置可以在 Cloud Manager UI 中进行修改，但是所有设置都可以使用工具箱 CLI 进行修改。您可以修改云设置配置文件并上载更改内容，也可以发出命令来直接修改个别设置。如果有多个人修改了云设置，那么无论用于更新设置的方法如何，任何较新的设置都会覆盖较旧的设置。

有关使用工具箱 CLI 的更多信息，请参阅工具箱 CLI 参考文档。

过程

运行以下命令来以云管理组织成员的身份登录到管理服务器：
```
apic login --server mgmt_endpoint_url --username user_id --password password --realm admin/identity_provider
```
云设置都存储在管理服务器上，您必须先登录到该服务器，然后才能使用 CLI 来访问这些设置。
通过输入以下命令查看所有可用身份提供者的列表（无需登录即可使用此命令），可以确定要在 --realm 参数中使用的身份提供者：
```
apic identity-providers:list --scope admin --server mgmt_endpoint_url --fields title,realm
```
例如：
```
apic identity-providers:list --scope admin --server myserver.com --fields title,realm
total_results: 2
results:
  - title: Cloud Manager User Registry
    realm: admin/default-idp-1
  - title: Corporate LDAP user registry
    realm: admin/corporate-ldap
```
您可通过 title 值确定要使用的身份提供者；然后，可以直接从显示的 realm 值复制对应的 --realm 参数。对于管理员在安装 API Connect 之后创建的任何身份提供者，将在创建时确定名称。用于以云管理组织成员身份登录的缺省 Cloud Manager 本地用户注册表为 default-idp-1。
有关登录的更多信息，请参阅登录到管理服务器。
（可选）使用以下命令来检索云设置的当前列表：
```
apic cloud-settings:get --server mgmt_endpoint_url --output -
```
其中，mgmt_endpoint_url 是用于存储云设置的服务器的 URL。
使用以下某种方法来添加或修改设置：
- 从命令行发出每个设置。
  对于简单更改，可以发出命令来修改设置，而无需编辑配置文件。
  1. 发出以下命令来启动更新过程：
```
apic cloud-settings:update --server mgmt_endpoint_url -
```
    其中，mgmt_endpoint_url 是用于存储云设置的服务器的 URL。在命令末尾包含连字符可指示输入在下一个命令行上继续。
  2. 在一行上输入单个设置的信息，然后按 Enter 键以进行提交。
    在一行上指定每个设置，并使用以下格式来指定该设置的名称和值：
```
setting_name: setting_value
```
    例如，以下命令将更新单个设置：
```
apic cloud-settings:update --server mgmt_endpoint_url -
refresh_expires_in: expiration time
Ctrl+D
```
  3. 输入 Ctrl+D 可指示数据输入已完成，如此示例中所示。
- 上载包含设置的文件。
  如果要添加或修改多个设置或过长的值，那么您可能希望通过创建或修改配置文件并上载该文件来一次性进行所有更改。
  1. 创建包含您的设置的 .yaml 文件。
    您可以选择文件名，但必须使用 YAML 格式。该文件可以仅包含所需的设置。
    设置将使用以下格式；请注意，设置的名称必须用引号括起，如此示例中所示。该文件中的最后一个设置不要以逗号结尾。
```
"setting_name": setting_value,
```
  2. 使用以下命令来上载该文件：
```
apic cloud-settings:update --server mgmt_endpoint_url my_cloud_settings.yaml
```
  有关将输入文件与工具箱 CLI 配合使用的信息，请参阅 ../com.ibm.apic.toolkit.doc/rapic_cli_command_line_input.html。
准备好注销管理服务器时，请使用以下命令：
```
apic logout --server mgmt_endpoint_url
```

结果

这些设置最长缓存 5 分钟，因此在更改生效之前，您可能会遇到延迟。