модуль netapp.storagegrid.na_sg_org_bucket — управление бакетами в StorageGRID.

Примечание

Этот модуль входит в коллекцию netapp.storagegrid (версия 21.16.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install netapp.storagegrid.

Чтобы использовать её в плейбуке, укажите: netapp.storagegrid.na_sg_org_bucket.

Добавлено в netapp.storagegrid 21.15.0

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Создание бакетов S3 в NetApp StorageGRID.

Параметры

Параметр	Комментарии
api_url string / обязательный	URL REST API узла администрирования StorageGRID.
auth_token string / обязательный	Токен авторизации для запроса API
bucket_versioning_enabled boolean	Включить управление версиями для бакета. Для этого API требуется StorageGRID версии 11.6 или выше. Варианты: `false` `true`
capacity_limit float добавлено в netapp.storagegrid 21.16.0	Максимальное количество ГБ, доступное для объектов этого бакета. Указывает логический объём (размер объекта), а не физический (размер на диске). Требуется StorageGRID версии 11.9 или выше.
compliance dictionary	Настройка параметров соответствия требованиям для бакета S3. Нельзя указывать одновременно с s3_object_lock_enabled.
auto_delete boolean	Если параметр включён, объекты будут автоматически удалены по истечении срока хранения, если только на бакет не наложен юридический запрет на удаление. Варианты: `false` `true`
legal_hold boolean	Если параметр включён, объекты в этом бакете нельзя удалить, даже если срок их хранения истёк. Варианты: `false` `true`
retention_period_minutes integer	Указывает продолжительность срока хранения объектов, добавленных в этот бакет, в минутах.
name string / обязательный	Имя бакета.
region string	Задать регион для бакета.
s3_object_lock_enabled boolean	Включить блокировку объектов S3 для бакета. Для блокировки объектов S3 требуется StorageGRID версии 11.5 или выше. Варианты: `false` `true`
state string	Должен ли указанный бакет существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`
validate_certs boolean	Следует ли проверять сертификаты HTTPS? Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Модули с префиксом na_sg предназначены для управления NetApp StorageGRID.

Примеры

- name: create a s3 bucket
  netapp.storagegrid.na_sg_org_bucket:
    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_bucket:
    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_bucket:
    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_bucket:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    state: present
    name: ansiblebucket1
    bucket_versioning_enabled: true

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

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
resp dictionary	Возвращает сведения о бакете StorageGRID. Возвращается: всегда Пример: `{"compliance": {"autoDelete": false, "legalHold": false, "retentionPeriodMinutes": 2629800}, "creationTime": "2021-01-01T00:00:00.000Z", "name": "example-bucket", "quotaObjectBytes": 1000000000, "region": "us-east-1", "s3ObjectLock": {"enabled": false}}`

Авторы

Команда NetApp Ansible (@joshedmonds)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/netapp/storagegrid/na_sg_org_bucket_module.html