ibm.storage_virtualize.ibm_sv_manage_awss3_cloudaccount 模块 – 此模块在 IBM Storage Virtualize 系列系统上配置和管理 Amazon Simple Storage Service (Amazon S3) 云账户

注意

此模块是 ibm.storage_virtualize 集合（版本 2.5.0）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install ibm.storage_virtualize。

要在剧本中使用它，请指定：ibm.storage_virtualize.ibm_sv_manage_awss3_cloudaccount。

ibm.storage_virtualize 1.11.0 中的新增功能

概要 

用于管理 mkcloudaccountawss3、chcloudaccountawss3 和 rmcloudaccount 命令的 Ansible 接口。

参数 

参数	注释
accesskeyid 字符串	指定 AWS 用户的 Amazon S3 访问密钥凭证的公共部分，系统使用该凭证访问云存储。
bucketprefix 字符串	指定存储桶对象的前缀。当 state=present 时，适用于创建 Amazon S3 账户。
clustername 字符串 / 必需	Storage Virtualize 系统的主机名或管理 IP。
domain 字符串	Storage Virtualize 系统的域。当主机名用于参数 clustername 时有效。
downbandwidthmbits 字符串	指定下载带宽限制，单位为兆比特每秒 (Mbps)。该值必须是 1-10240 之间的数字。
encrypt 字符串	指定是否加密云账户中的数据。默认情况下，如果集群上启用了加密，除非指定 encrypt=no，否则会启用加密。当 state=present 时有效，用于创建 Amazon S3 账户。选项 `"yes"` `"no"`
ignorefailures 布尔值	指定是否更改访问密钥，无论新访问密钥是否有效。当 state=present 时有效，用于更新现有 Amazon S3 账户。仅当输入了 accesskeyid 和 secretaccesskey 时才允许此参数。选项 `false` `true`
importsystem 字符串	指定要导入系统的数据。当 state=present 时有效，用于更新现有 Amazon S3 账户。
log_path 字符串	调试日志文件的路径。
mode 字符串	指定新的或修改的云账户模式。当 state=present 时有效，用于更新现有 Amazon S3 账户。选项 `"import"` `"normal"`
name 字符串 / 必需	指定 Amazon S3 账户的名称。
old_name 字符串	指定 Amazon S3 账户的旧名称。当 state=present 时有效，用于重命名现有的 Amazon S3 账户。
password 字符串	Storage Virtualize 系统的 REST API 密码。如果未使用 token 来验证用户，则需要参数 username 和 password。
refresh 布尔值	指定刷新系统导入候选项。如果账户处于导入模式，则此参数指定刷新可用于导入的数据。选项 `false` `true`
region 字符串	指定用于访问云账户和存储数据的 AWS 区域。
resetusagehistory 布尔值	重置使用历史（为 0）。反映云账户上消耗的空间的存储消耗是累积的，这意味着它保留在当前日期行（第 0 行）中。当 state=present 时有效，用于更新现有 Amazon S3 账户。选项 `false` `true`
secretaccesskey 字符串	指定 Amazon S3 云账户的秘密访问密钥。
state 字符串 / 必需	创建、更新 (`present`) 或删除 (`absent`) Amazon S3 账户。选项 `"present"` `"absent"`
token 字符串	用于验证 Storage Virtualize 系统上的用户的身份验证令牌。要生成令牌，请使用 ibm.storage_virtualize.ibm_svc_auth 模块。
upbandwidthmbits 字符串	指定上传带宽限制，单位为兆比特每秒 (Mbps)。该值必须是 1-10240 之间的数字。
username 字符串	Storage Virtualize 系统的 REST API 用户名。如果未使用 token 来验证用户，则需要参数 username 和 password。
validate_certs 布尔值	验证证书。选项 `false` ← (默认) `true`

备注 

注意

此模块支持 check_mode。

示例 

- name: Configure Amazon S3 account
  ibm.storage_virtualize.ibm_sv_manage_awss3_cloudaccount:
    clustername: "{{cluster}}"
    username: "{{username}}"
    password: "{{password}}"
    name: awss3
    bucketprefix: "{{bucketprefix}}"
    accesskeyid: "{{accesskeyid}}"
    secretaccesskey: "{{secretaccesskey}}"
    state: present
- name: Update Amazon S3 account configuration
  ibm.storage_virtualize.ibm_sv_manage_awss3_cloudaccount:
    clustername: "{{cluster}}"
    username: "{{username}}"
    password: "{{password}}"
    name: awss3
    upbandwidthmbits: "{{upbandwidthmbits}}"
    downbandwidthmbits: "{{downbandwidthmbits}}"
    state: present
- name: Update Amazon S3 account mode to import
  ibm.storage_virtualize.ibm_sv_manage_awss3_cloudaccount:
    clustername: "{{cluster}}"
    username: "{{username}}"
    password: "{{password}}"
    name: awss3
    mode: import
    importsystem: 123456789
    state: present
- name: Delete Amazon S3 account configuration
  ibm.storage_virtualize.ibm_sv_manage_awss3_cloudaccount:
    clustername: "{{cluster}}"
    username: "{{username}}"
    password: "{{password}}"
    name: awss3
    state: absent

作者

Sanjaikumaar M (@sanjaikumaar)