netapp.storagegrid.na_sg_org_container 模块 – 管理 StorageGRID 上的存储桶。

注意

此模块是 netapp.storagegrid 集合 (版本 21.13.0) 的一部分。

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

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

要在剧本中使用它，请指定：netapp.storagegrid.na_sg_org_container。

netapp.storagegrid 20.6.0 中新增

概要 

在 NetApp StorageGRID 上创建 S3 存储桶。

参数 

参数	注释
api_url 字符串 / 必需	StorageGRID 管理节点 REST API 的 URL。
auth_token 字符串 / 必需	API 请求的授权令牌
bucket_versioning_enabled 布尔值 netapp.storagegrid 21.11.0 中新增	启用存储桶的版本控制。此 API 需要 StorageGRID 11.6 或更高版本。选项 `false` `true`
compliance 字典	配置 S3 存储桶的合规性设置。不能与 s3_object_lock_enabled 一起指定。
auto_delete 布尔值	如果启用，则对象在其保留期到期后将自动删除，除非存储桶处于法律保留状态。选项 `false` `true`
legal_hold 布尔值	如果启用，则即使对象的保留期已过期，也无法删除此存储桶中的对象。选项 `false` `true`
retention_period_minutes 整数	以分钟为单位指定添加到此存储桶的对象的保留期长度。
name 字符串 / 必需	存储桶的名称。
region 字符串	为存储桶设置区域。
s3_object_lock_enabled 布尔值 netapp.storagegrid 21.9.0 中新增	在存储桶上启用 S3 对象锁定。 S3 对象锁定需要 StorageGRID 11.5 或更高版本。选项 `false` `true`
state 字符串	指定存储桶是否存在。选项 `"present"` ← (默认) `"absent"`
validate_certs 布尔值	是否应该验证 https 证书？选项 `false` `true` ← (默认)

备注 

注意

以 na_sg 为前缀的模块用于管理 NetApp StorageGRID。

示例 

- name: create a s3 bucket
  netapp.storagegrid.na_sg_org_container:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    state: present
    name: ansiblebucket1

- name: delete a s3 bucket
  netapp.storagegrid.na_sg_org_container:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    state: absent
    name: ansiblebucket1

- name: create a s3 bucket with Object Lock
  netapp.storagegrid.na_sg_org_container:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    state: present
    name: objectlock-bucket1
    s3_object_lock_enabled: true

- name: create a s3 bucket with versioning enabled
  netapp.storagegrid.na_sg_org_container:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    state: present
    name: ansiblebucket1
    bucket_versioning_enabled: true

返回值 

常见的返回值已在此处记录，以下是此模块独有的字段

键	描述
resp 字典	返回有关 StorageGRID 存储桶的信息。返回：始终示例： `{"compliance": {"autoDelete": false, "legalHold": false, "retentionPeriodMinutes": 2629800}, "creationTime": "2021-01-01T00:00:00.000Z", "name": "example-bucket", "region": "us-east-1", "s3ObjectLock": {"enabled": false}}`

作者

NetApp Ansible 团队 (@joshedmonds)