VALIDATE CLOUD（验证云凭证）

在线编辑

在定义云容器存储池之前，请使用此命令确保该存储池的凭证有效，并确保已将必要的许可权授予用户。

特权类

任何管理员都可以发出此命令。

语法

读取语法图跳过可视语法图 VALidate CLOud CONNection=连接名称1STGpool=Pool_Name2CLOUDType=S3CLOUDType= AZureGOOGleS3 CLOUDUrl = 云 URL IDentity = 云身份3 PAssword = 密码 KEYLocation=关键位置4BUCKETName=bucket_name5
注：
  • 1 如果指定 CONNECTION 参数，那么不需要其他参数。 如果使用其他参数，那么这些参数值将覆盖 CONNECTION 参数中的相应值。
  • 2 如果指定 STGPOOL 参数，那么不需要其他参数。 如果使用其他参数，那么这些参数值将覆盖 STGPOOL 参数中的相应值。
  • 3 如果指定 CLOUDTYPE=AZURE 或 CLOUDTYPE=GOOGLE ，或者指定类型为 AZURE 或 GOOGLE 的连接或存储池，请不要指定 IDENTITY 参数。
  • 4 仅当指定 CLOUDTYPE=GOOGLE 或类型为 GOOGLE的连接或存储池时， KEYLOCATION 参数才有效。
  • 5 仅当指定 CLOUDTYPE=S3 或 CLOUDTYPE=GOOGLE 或者类型为 S3 或 GOOGLE的连接或存储池时， BUCKETNAME 参数才有效。

参数

CONNection
指定将用于将 IBM Storage Protect 数据库备份到云提供者的连接的名称。 请输入您使用 DEFINE CONNECTION 命令指定的名称。 此参数是可选的。 名称的最大长度为 30 个字符。

如果指定此参数，那么不需要其他参数。 请勿将 CONNECTION 参数与 CLOUDTYPE 或 STGPOOL 参数配合使用。 如果指定 CLOUDURL、IDENTITY、PASSWORD、KEYLOCATION 或 BUCKETNAME 参数，那么这些参数值将覆盖 CONNECTION 参数中的相应值。

例如，如果您发出以下命令，那么身份、密码和存储区名称值派生自存储池 (s3conn)。 但是，因为还指定了 CLOUDURL 值 (newcloud.url.com)，所以该值将覆盖定义存储池时指定的云 URL。
VALIDATE CLOUD CONNECTION=s3conn CLOUDURL=newcloud.url.com
STGpool
指定将用于将 IBM Storage Protect 数据库备份到云提供者的云容器存储池的名称。 此名称是在 DEFINE STGPOOL中定义的。 此参数是可选的。 名称的最大长度为 30 个字符。

如果指定 STGPOOL 参数，那么不需要其他参数。请勿使用具有 CLOUDTYPE 或 CONNECTION 参数的 STGPOOL 参数。 如果指定 CLOUDURL、IDENTITY、PASSWORD、KEYLOCATION 或 BUCKETNAME 参数，那么这些参数值将覆盖 STGPOOL 参数中的相应值。

例如，如果您发出以下命令，那么身份、密码和存储区名称值派生自存储池 (s3pool)。 但是，因为还指定了 CLOUDURL 值 (newtwocloud.url.com)，所以该值将覆盖定义存储池时指定的云 URL。
VALIDATE CLOUD STGPOOL=s3pool CLOUDURL=newtwocloud.url.com
CLOUDType
指定其中配置了存储池的云环境的类型。
您可指定下列其中一个值：
AZure
指定存储池使用 Microsoft Azure 云计算系统。
GOOGle
指定连接或存储池使用 Google Cloud Storage 云计算系统。
S3
指定存储池使用具有简单存储服务 (S3) 协议的云计算系统，例如 IBM Cloud Object Storage 或 Amazon Web Services (AWS) S3。
此参数是可选的。 如果您未指定该参数，那么将使用缺省值 S3。 请不要将 STGPOOL 或 CONNECTION 参数与 CLOUDTYPE 参数一起使用。
CLOUDUrl
指定要在其中配置存储池的云环境的 URL。 如果既未指定 CONNECTION 参数也未指定 STGPOOL 参数，那么 CLOUDURL 参数对于所有受支持的云计算系统（Google 除外）都为必需。 如果指定 CLOUDTYPE=GOOGLE，请勿指定 CLOUDURL 参数。 根据云提供商的不同，您可以为该参数使用 blob 服务端点、区域端点 URL、 Accesser IP 地址、公共验证端点或类似值。 确保在 URL 开头包含协议，如 https:// 或 http://。 Web 地址的最大长度为 870 个字符。 在第一个备份操作开始时将验证 CLOUDURL 参数。
提示: 如果 CLOUDURL 参数与 CONNECTION 或 STGPOOL 参数一起指定，那么将使用 CLOUDURL 参数中的值。
IDentity
指定云的用户标识。 如果既未指定 CONNECTION 参数也未指定 STGPOOL 参数，那么 IDENTITY 参数对于所有受支持的云计算系统（Azure 和 Google 除外）都为必需。 如果指定 CLOUDTYPE=AZURE 或 CLOUDTYPE=GOOGLE，请勿指定 IDENTITY 参数。 基于您的云提供者，您可以针对此参数使用访问密钥标识、用户名、租户名和用户名或类似值。 用户标识的最大长度为 255 个字符。
提示: 如果 IDENTITY 参数与 CONNECTION 或 STGPOOL 参数一起指定，那么将使用 IDENTITY 参数中的值。
PAssword
指定云的密码。 如果既未指定 CONNECTION 参数也未指定 STGPOOL 参数，那么 PASSWORD 参数对于所有受支持的云计算系统（Google 除外）都为必需。 如果指定 CLOUDTYPE=GOOGLE，请勿指定 PASSWORD 参数。 根据您的云提供者不同，您可将共享访问签名 (SAS) 令牌、访问密钥、API 键、密码或类似的值用于此参数。 密码的最大长度为 256 个字符。
提示: 如果 PASSWORD 参数与 CONNECTION 或 STGPOOL 参数一起指定，那么将使用 PASSWORD 参数中的值。
KEYLocation
以 JavaScript 对象表示法 (JSON) 格式指定包含 Google Cloud Storage 服务帐户密钥的文件的名称。 如果既未指定 CONNECTION 参数也未指定 STGPOOL 参数，并且 CLOUDTYPE=GOOGLE，那么 KEYLOCATION 参数为必需。
提示: 如果 KEYLOCATION 参数与 CONNECTION 或 STGPOOL 参数一起指定，那么将使用 KEYLOCATION 参数中的值。
BUCKETName
指定要与存储池配合使用的 AWS S3 或 Google Cloud Storage 存储桶或存储 IBM Cloud Object Storage 库的名称，而不是使用默认的存储桶名称或存储库名称。 仅当指定 CLOUDTYPE=S3 或 CLOUDTYPE=GOOGLE 时，此参数才有效。 当指定 CLOUDTYPE=GOOGLE 时，此参数为必需。
提示: 如果 BUCKETNAME 参数与 CONNECTION 或 STGPOOL 参数一起指定，那么将使用 BUCKETNAME 参数中的值。
如果存储区或保险库文件存在且具有您指定的名称，那么测试该存储区或保险库文件以确保设置正确许可权。
如果存储区或保险库文件不存在，那么该参数只验证具有该名称的存储区或保险库文件不存在。 如果命令输出指示存储区或保险库文件不存在，请与云服务提供商协作创建具有相应名称和设置的存储区或保险库文件。 需要用于读取、写入、列出和删除对象的许可权。 创建存储区或保险库文件后，再次运行 VALIDATE CLOUD 命令以验证许可权。
提示: 如果指定 CLOUDTYPE=S3但未指定 BUCKETNAME 参数，那么将使用 "复制全局唯一标识" 作为缺省存储区名称。 缺省存储区名称为：
ibmsp.guid
其中 guid 是 QUERY REPLSERVER 命令输出中的 REPLICATION GLOBALLY UNIQUE ID 值减去句点。 例如，如果“复制全局唯一标识”是 52.82.39.20.64.d0.11.e6.9d.77.0a.00.27.00.00.00，那么缺省存储区名称是 ibmsp.5282392064d011e69d770a0027000000。

示例：验证 S3 云容器存储池的凭证

验证云容器存储池的凭证。
validate cloud 
cloudtype=s3 cloudurl=http://123.234.123.234:5000/v2.0
password=protect8991 bucketname=ibmsp.5282392064d011e69d770a0027000000

示例：使用云连接验证凭证

验证名为 CONN1 的云连接。
validate cloud connection=conn1

示例：使用具有更新的密钥位置的云存储池来验证 Google 凭证

验证名为 GOOGLEPOOL 的云容器存储池。
Validate cloud stgpool=googlepool keylocation=googlekeylocation

相关命令

表 1. 与 VALIDATE CLOUD 相关的命令
命令 描述
DEFINE STGPOOL (云容器) 定义云容器存储池。
查询 REPLSERVER 显示有关复制服务器的信息。
UPDATE STGPOOL (云容器) 更新云容器存储池。