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

Примечание

Этот модуль входит в коллекцию netapp.storagegrid (версия 21.16.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

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

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

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

Параметры

Параметр	Комментарии
api_url string / обязательный	URL REST API узла администрирования StorageGRID.
auth_token string / обязательный	Токен авторизации для запроса API
bucket_versioning_enabled boolean добавлено в netapp.storagegrid 21.11.0	Включить управление версиями для бакета. Для этого 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	Указывает продолжительность срока хранения объектов, добавленных в этот бакет, в минутах.
consistency string добавлено в netapp.storagegrid 21.15.0	Уровень согласованности влияет на доступность объектов для клиентских запросов. Варианты: `"all"` `"strong-global"` `"strong-site"` `"read-after-new-write"` `"available"`
name string / обязательный	Имя бакета.
policy dictionary добавлено в netapp.storagegrid 21.16.0	Настройка политики бакета.
region string	Задать регион для бакета.
s3_object_lock_enabled boolean добавлено в netapp.storagegrid 21.9.0	Включить блокировку объектов 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_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

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

- name: create a s3 bucket with policy
  netapp.storagegrid.na_sg_org_container:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    state: present
    name: ansiblebucket1
    policy:
      Statement:
        - Sid: "string"
          Effect: "Allow"
          Action": "s3:GetObject"
          Resource:
            - "arn:aws:s3:::mybucket/myobject"
            - "arn:aws:s3:::mybucket/myobject"
          Principal: "*"

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

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

Ключ	Описание
resp dictionary	Возвращает информацию о бакете StorageGRID. Возвращается: всегда Пример: `{"compliance": {"autoDelete": false, "legalHold": false, "retentionPeriodMinutes": 2629800}, "creationTime": "2021-01-01T00:00:00.000Z", "name": "example-bucket", "policy": {"Statement": [{"Action": "s3:GetObject", "Effect": "Allow", "Principal": "*", "Resource": ["arn:aws:s3:::mybucket/myobject", "arn:aws:s3:::mybucket/myobject"], "Sid": "string"}]}, "quotaObjectBytes": 1000000000, "region": "us-east-1", "s3ObjectLock": {"enabled": false}}`

Ключ

Описание

resp

dictionary

Возвращает информацию о бакете StorageGRID.

Возвращается: всегда

Пример: {"compliance": {"autoDelete": false, "legalHold": false, "retentionPeriodMinutes": 2629800}, "creationTime": "2021-01-01T00:00:00.000Z", "name": "example-bucket", "policy": {"Statement": [{"Action": "s3:GetObject", "Effect": "Allow", "Principal": "*", "Resource": ["arn:aws:s3:::mybucket/myobject", "arn:aws:s3:::mybucket/myobject"], "Sid": "string"}]}, "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_container_module.html