Модуль netapp.ontap.na_ontap_s3_buckets – бакеты S3 NetApp ONTAP

aggregates

list / elements=string

Список имён агрегатов, используемых для бакета S3.

Этот параметр не поддерживается при type=nas.

audit_event_selector

dictionary

Селектор событий аудита позволяет указать типы доступа и разрешений, которые следует проверять.

Этот параметр не поддерживается при type=nas.

access

string

задаёт тип доступа к событию, который будет проверяться: только чтение, только запись или все типы (по умолчанию — все).

Варианты:

• "read"
• "write"
• "all"

permission

string

задаёт тип разрешения для события, который будет проверяться: только разрешение, только запрет или все типы (по умолчанию — все).

Варианты:

• "allow"
• "deny"
• "all"

cert_filepath

string

добавлено в netapp.ontap 20.6.0

путь к файлу сертификата клиента SSL (.pem).

не поддерживается в Python 2.6.

comment

string

Комментарий к бакету S3.

constituents_per_aggregate

integer

Количество компонентов в агрегате.

Этот параметр не поддерживается при type=nas.

feature_flags

dictionary

добавлено в netapp.ontap 20.5.0

Включение или отключение новой функции.

Этот параметр можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость.

Поддерживаемые ключи и значения могут изменяться без предупреждения. Неизвестные ключи игнорируются.

force_ontap_version

string

добавлено в netapp.ontap 21.23.0

Переопределяет версию ONTAP кластера при использовании REST.

Если версия не соответствует целевому кластеру, поведение не определено.

Этот параметр предназначен для обхода проблем, возникающих, когда из-за недостатка разрешений невозможно прочитать версию кластера. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues.

Значение должно иметь формат 9.10 или 9.10.1, где каждый элемент является целым числом.

hostname

string / обязательный

Имя хоста или IP-адрес экземпляра ONTAP.

http_port

integer

Заменяет порт по умолчанию (80 или 443) указанным портом

https

boolean

Включение и отключение HTTPS.

Игнорируется при использовании REST, так как поддерживается только HTTPS.

Игнорируется при использовании аутентификации с сертификатом SSL, поскольку для неё требуется SSL.

Варианты:

• false ← (по умолчанию)
• true

key_filepath

string

добавлено в netapp.ontap 20.6.0

путь к файлу ключа клиента SSL.

lambda_config

dictionary

добавлено в netapp.ontap 23.4.0

Параметры конфигурации функции прокси AWS Lambda.

Этот параметр и его вложенные параметры поддерживаются только при использовании REST.

aws_profile

string

Имя профиля AWS для аутентификации.

aws_region

string / обязательный

Название региона AWS.

function_name

string / обязательный

Имя вызываемой функции AWS Lambda.

name

string / обязательный

Имя бакета S3 или NAS.

nas_path

string

добавлено в netapp.ontap 22.7.0

Указывает путь NAS, которому соответствует бакет NAS.

password

псевдонимы: pass

string

Пароль указанного пользователя.

policy

dictionary

Политика доступа использует синтаксис языка политик Amazon Web Services (AWS), позволяя клиентам S3 создавать политики доступа к своим данным

statements

list / elements=dictionary

Операторы политики формируются с использованием этой структуры для задания разрешений

Предоставить <Effect>, чтобы разрешить или запретить <Principal> выполнять <Action> над <Resource>, если выполняется <Condition>

actions

list / elements=string

Можно указать *, чтобы обозначить все действия, либо перечислить одно или несколько следующих действий

GetObject

PutObject

DeleteObject

ListBucket

GetBucketAcl

GetObjectAcl

ListBucketMultipartUploads

ListMultipartUploadParts

conditions

list / elements=dictionary

Условия, при которых действует политика.

delimiters

list / elements=string

Разделитель для определения префикса в списке объектов.

max_keys

list / elements=string

Максимальное количество ключей, возвращаемых в ответ на запрос.

operator

string

Оператор, используемый для условия.

Варианты:

• "ip_address"
• "not_ip_address"
• "string_equals"
• "string_not_equals"
• "string_equals_ignore_case"
• "string_not_equals_ignore_case"
• "string_like"
• "string_not_like"
• "numeric_equals"
• "numeric_not_equals"
• "numeric_greater_than"
• "numeric_greater_than_equals"
• "numeric_less_than"
• "numeric_less_than_equals"

prefixes

list / elements=string

Префиксы объектов, которые требуется перечислить.

source_ips

list / elements=string

IP-адрес источника запроса.

usernames

list / elements=string

Имена пользователей, которым разрешён доступ к бакету.

effect

string

Оператор может разрешать или запрещать доступ

Варианты:

• "allow"
• "deny"

principals

list / elements=string

Список из одного или нескольких пользователей или групп S3.

resources

list / elements=string

Бакет и любые содержащиеся в нём объекты.

Для задания ресурса с помощью регулярного выражения можно использовать подстановочные символы * и ?.

sid

string

Идентификатор оператора

qos_policy

dictionary

Группа политик определяет измеримые целевые показатели уровня обслуживания (SLO), применяемые к объектам хранения, связанным с этой группой политик.

Если не назначить бакету группу политик, система не будет отслеживать и контролировать трафик к нему.

Этот параметр не поддерживается при type=nas.

max_throughput_iops

integer

Максимальная пропускная способность в IOPS.

max_throughput_mbps

integer

Максимальная пропускная способность в Мбит/с.

min_throughput_iops

integer

Минимальная пропускная способность в IOPS.

min_throughput_mbps

integer

Минимальная пропускная способность в Мбит/с.

name

string

Имя группы политик QoS. Этот параметр нельзя использовать одновременно с другими атрибутами QoS.

size

integer

Размер бакета S3 в байтах.

Этот параметр не поддерживается при type=nas.

snapshot_policy

string

добавлено в netapp.ontap 23.1.0

Задаёт политику создания снимков для бакета.

state

string

Определяет, должен ли указанный бакет S3 существовать.

Варианты:

• "present" ← (по умолчанию)
• "absent"

type

string

добавлено в netapp.ontap 22.6.0

Задаёт тип бакета. Допустимые значения: «s3» и «nas».

Варианты:

• "s3"
• "nas"

use_lambda

boolean

добавлено в netapp.ontap 23.4.0

Указывает, следует ли использовать функцию прокси AWS Lambda для подключения к системе ONTAP.

Поддерживается только при использовании REST.

Варианты:

• false ← (по умолчанию)
• true

use_rest

string

Этот модуль поддерживает только REST.

always — всегда использовать REST API. Если модуль не поддерживает REST, будет выдано предупреждение.

По умолчанию: "always"

username

псевдонимы: user

string

Это может быть учётная запись уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или уровня SVM.

Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html.

Поддерживаются два метода аутентификации

1. Базовая аутентификация с использованием имени пользователя и пароля.
2. Аутентификация с помощью сертификата SSL с использованием файла сертификата клиента SSL и, при необходимости, файла закрытого ключа.

Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация по сертификату должна быть включена.

validate_certs

boolean

Если задано значение no, сертификаты SSL не будут проверяться.

Задавайте это значение только для False на контролируемых вами узлах, использующих самоподписанные сертификаты.

Варианты:

• false
• true ← (по умолчанию)

versioning_state

string

добавлено в netapp.ontap 22.13.0

Задаёт состояние версионирования бакета.

Невозможно изменить состояние версионирования на «disabled» из любого другого состояния.

Требуется ONTAP 9.11.1 или новее.

Варианты:

• "disabled"
• "enabled"
• "suspended"

vserver

string / обязательный

Имя используемого vserver.