ibm.spectrum_virtualize.ibm_sv_manage_awss3_cloudaccount 模块 – 此模块在 IBM Spectrum Virtualize 系列存储系统上配置和管理 Amazon Simple Storage Service (Amazon S3) 云帐户

注意

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

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

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

要在 playbook 中使用它，请指定：ibm.spectrum_virtualize.ibm_sv_manage_awss3_cloudaccount。

注意

ibm.spectrum_virtualize 集合已重命名为 ibm.storage_virtualize，并将从 Ansible 12 中删除。如果您使用 ibm.spectrum_virtualize 中的内容，请更新 playbook 和角色中的 FQCN！创建新的 playbook 或角色时，请直接使用 ibm.storage_virtualize 中的内容。

ibm.spectrum_virtualize 1.11.0 中的新增功能

概要

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

参数

参数

注释

accesskeyid

字符串

指定 AWS 用户的 Amazon S3 访问密钥凭据的公共部分，系统使用该凭据访问云存储。

bucketprefix

字符串

指定存储桶对象的前缀。

当 state=present 时，用于创建 Amazon S3 帐户。

clustername

字符串 / 必选

Spectrum Virtualize 存储系统的主机名或管理 IP。

domain

字符串

Spectrum 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

字符串

Spectrum 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

字符串

用于验证 Spectrum Virtualize 存储系统上的用户的身份验证令牌。

要生成令牌，请使用 ibm.spectrum_virtualize.ibm_svc_auth 模块。

upbandwidthmbits

字符串

指定上传带宽限制，单位为兆比特每秒 (Mbps)。

该值必须是 1-10240 的数字。

username

字符串

Spectrum Virtualize 存储系统的 REST API 用户名。

如果未使用 token 来验证用户身份，则需要参数 username 和 password。

validate_certs

布尔值

验证证书。

选择

  • false ← (默认)

  • true

备注

注意

  • 此模块支持 check_mode。

示例

- name: Configure Amazon S3 account
  ibm.spectrum_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.spectrum_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.spectrum_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.spectrum_virtualize.ibm_sv_manage_awss3_cloudaccount:
    clustername: "{{cluster}}"
    username: "{{username}}"
    password: "{{password}}"
    name: awss3
    state: absent

作者

  • Sanjaikumaar M (@sanjaikumaar)