Spec-Zone.ru › AWS CLI v2

[ aws . fsx ]

create-snapshot

Описание

Создаёт моментальный снимок существующего тома Amazon FSx for OpenZFS. С помощью снимков вы можете легко отменить изменения файлов и сравнить версии файлов, восстановив том до предыдущей версии.

Если моментальный снимок со специфицированным маркером запроса клиента существует, а параметры совпадают, эта операция возвращает описание существующего моментального снимка. Если моментальный снимок со специфицированным маркером запроса клиента существует, а параметры не совпадают, эта операция возвращает IncompatibleParameterError . Если моментальный снимок со специфицированным маркером запроса клиента не существует, CreateSnapshot выполняет следующее:

  • Создаёт новый моментальный снимок OpenZFS с назначенным идентификатором и начальным состоянием жизненного цикла CREATING .
  • Возвращает описание моментального снимка.

Используя идемпотентную операцию, вы можете повторно выполнить операцию CreateSnapshot без риска создания дополнительного моментального снимка. Этот подход может быть полезен, когда первоначальный вызов завершается неудачно таким образом, что неясно, был ли создан моментальный снимок. Если вы используете тот же маркер запроса клиента, а первоначальный вызов создал моментальный снимок, операция возвращает успешный результат, поскольку все параметры одинаковы.

Операция CreateSnapshot возвращается, пока состояние жизненного цикла моментального снимка ещё CREATING . Вы можете проверить статус создания моментального снимка, вызвав операцию DescribeSnapshots, которая возвращает состояние моментального снимка вместе с другой информацией.

См. также: Документация API AWS

Синтаксис

  create-snapshot
[--client-request-token <value>]
--name <value>
--volume-id <value>
[--tags <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--client-request-token (строка)

(Необязательно) Маркер идемпотентности для создания ресурса, в строке до 63 ASCII символов. Этот маркер автоматически заполняется от вашего имени, когда вы используете командную строку (CLI) или SDK Amazon Web Services.

--name (строка)

Название моментального снимка.

--volume-id (строка)

Идентификатор тома, для которого создаётся моментальный снимок.

--tags (список)

Список значений Tag, с максимальным количеством элементов 50.

(структура)

Указывает пару ключ-значение для тега ресурса.

Ключ -> (строка)

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

Значение -> (строка)

Значение, которое указывает TagValue , значение, присвоенное соответствующему ключу тега. Значения тегов могут быть null и не обязательно должны быть уникальными в наборе тегов. Например, вы можете иметь пару ключ-значение в наборе тегов finances : April и также payroll : April .

Сокращённый синтаксис:

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения перепишут значения, предоставленные JSON. Невозможно передать произвольные двоичные значения, используя значение, предоставленное JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит каркас JSON в стандартный вывод без отправки запроса API. Если предоставлено без значения или значение input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, он выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, он проверяет входные данные команд и возвращает пример выходного JSON для этой команды. Сгенерированный каркас JSON не стабилен между версиями AWS CLI, и нет гарантии обратной совместимости в сгенерированном каркасе JSON.

Глобальные параметры

--debug (булево)

Включить отладку.

--endpoint-url (строка)

Переопределить URL по умолчанию команды указанным URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (булево)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команд.

  • json
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/окружения.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/отключить цветной вывод.

  • включить
  • выключить
  • автоматически

--no-sign-request (булево)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл сертификата CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/окружения.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображающего двоичный блок, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (булево)

Отключить кли-пейджер для вывода.

--cli-auto-prompt (булево)

Автоматически запрашивать параметры ввода командной строки.

--no-cli-auto-prompt (булево)

Отключить автоматическое запросы ввода параметров командной строки.

Вывод

Снимок -> (структура)

Описание снимка.

ResourceARN -> (строка)

Идентификатор ресурса Amazon (ARN) для данного ресурса. ARNs однозначно идентифицируют ресурсы Amazon Web Services. Нам необходим ARN, когда вам нужно однозначно указать ресурс в рамках всех сервисов Amazon Web Services. Для получения дополнительной информации, см. Имена ресурсов Amazon (ARN) в Общая справка Amazon Web Services .

SnapshotId -> (строка)

Идентификатор снимка.

Name -> (строка)

Название снимка.

VolumeId -> (строка)

Идентификатор тома, для которого создан снимок.

CreationTime -> (метка времени)

Время создания ресурса в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

Lifecycle -> (строка)

Статус жизненного цикла снимка.

  • PENDING - Amazon FSx еще не начал создание снимка.
  • CREATING - Amazon FSx создает снимок.
  • DELETING - Amazon FSx удаляет снимок.
  • AVAILABLE - Снимок полностью доступен.

LifecycleTransitionReason -> (структура)

Описание причины изменения состояния жизненного цикла ресурса.

Message -> (строка)

Подробное сообщение об ошибке.

Tags -> (список)

Список значений Tag, с максимальным количеством элементов 50.

(структура)

Указывает пару ключ-значение для тега ресурса.

Key -> (строка)

Значение, определяющее TagKey, имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (строка)

Значение, определяющее TagValue, значение, назначенное соответствующему ключу тега. Значения тегов могут быть null и не должны быть уникальными в наборе тегов. Например, вы можете иметь пару ключ-значение в наборе тегов finances : April и также payroll : April .

AdministrativeActions -> (список)

Список административных действий для файловой системы, которые находятся в процессе или ожидают обработки. Административные действия описывают изменения в системе Amazon FSx.

(структура)

Описывает конкретное административное действие Amazon FSx для текущей файловой системы или тома Windows, Lustre, OpenZFS или ONTAP.

AdministrativeActionType -> (строка)

Описывает тип административного действия следующим образом:

  • FILE_SYSTEM_UPDATE - Административное действие обновления файловой системы, инициированное из консоли Amazon FSx, API (UpdateFileSystem ) или CLI (update-file-system ).
  • THROUGHPUT_OPTIMIZATION - После успешного выполнения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача THROUGHPUT_OPTIMIZATION. Вы можете отслеживать прогресс оптимизации хранилища, используя свойство ProgressPercent. Когда THROUGHPUT_OPTIMIZATION выполнено успешно, статус родительского действия FILE_SYSTEM_UPDATE меняется на COMPLETED. Дополнительная информация приведена в руководстве пользователя Amazon FSx for Windows File Server — Управление пропускной способностью.
  • STORAGE_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению емкости хранилища файловой системы запускается задача STORAGE_OPTIMIZATION.
    • Для Windows и ONTAP оптимизация хранилища — это процесс миграции данных файловой системы на новые более крупные диски.
    • Для Lustre оптимизация хранилища состоит из перераспределения данных по существующим и вновь добавленным файловым серверам.

Вы можете отслеживать прогресс оптимизации хранилища, используя свойство ProgressPercent. Когда STORAGE_OPTIMIZATION завершено успешно, статус родительского действия FILE_SYSTEM_UPDATE меняется на COMPLETED. Дополнительная информация приведена в руководстве пользователя Amazon FSx for Windows File Server — Управление емкостью хранилища, руководстве пользователя Amazon FSx for Lustre — Управление емкостью хранилища, и руководстве пользователя Amazon FSx for NetApp ONTAP — Управление емкостью хранилища и выделенной производительностью IOPS.

  • FILE_SYSTEM_ALIAS_ASSOCIATION - Обновление файловой системы для сопоставления нового DNS-псевдонима с файловой системой. Дополнительная информация приведена в разделе AssociateFileSystemAliases.
  • FILE_SYSTEM_ALIAS_DISASSOCIATION - Обновление файловой системы для отсоединения DNS-псевдонима от файловой системы. Дополнительная информация приведена в разделе DisassociateFileSystemAliases.
  • IOPS_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача IOPS_OPTIMIZATION. Вы можете отслеживать прогресс оптимизации хранилища, используя свойство ProgressPercent. Когда IOPS_OPTIMIZATION завершено успешно, статус родительского действия FILE_SYSTEM_UPDATE меняется на COMPLETED. Дополнительная информация приведена в руководстве пользователя Amazon FSx for Windows File Server — Управление выделенной производительностью SSD IOPS.
  • STORAGE_TYPE_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача STORAGE_TYPE_OPTIMIZATION. Вы можете отслеживать прогресс оптимизации хранилища, используя свойство ProgressPercent. Когда STORAGE_TYPE_OPTIMIZATION завершено успешно, статус родительского действия FILE_SYSTEM_UPDATE меняется на COMPLETED.
  • VOLUME_UPDATE - Обновление тома Amazon FSx для OpenZFS, инициированное из консоли Amazon FSx, API (UpdateVolume ) или CLI (update-volume ).
  • VOLUME_RESTORE - Том Amazon FSx для OpenZFS возвращается в состояние, сохраненное указанным снимком, инициированное через API (RestoreVolumeFromSnapshot ) или CLI (restore-volume-from-snapshot ).
  • SNAPSHOT_UPDATE - Обновление снимка для тома Amazon FSx для OpenZFS, инициированное из консоли Amazon FSx, API (UpdateSnapshot ) или CLI (update-snapshot ).
  • RELEASE_NFS_V3_LOCKS - Отслеживает освобождение блокировок NFS V3 в файловой системе Amazon FSx для OpenZFS.
  • DOWNLOAD_DATA_FROM_BACKUP - Восстановление резервной копии FSx for ONTAP в новый том на файловой системе второго поколения. После загрузки всех данных метаданных в том, вы можете смонтировать том с чтением только для доступа.
  • VOLUME_INITIALIZE_WITH_SNAPSHOT - Том создается из снимка на другой файловой системе FSx для OpenZFS. Вы можете инициировать это действие из консоли Amazon FSx, API (CreateVolume ) или CLI (create-volume) при использовании стратегии FULL_COPY.
  • VOLUME_UPDATE_WITH_SNAPSHOT - Том обновляется из снимка на другой файловой системе FSx для OpenZFS. Вы можете инициировать это действие из консоли Amazon FSx, API (CopySnapshotAndUpdateVolume ) или CLI (copy-snapshot-and-update-volume ).

ProgressPercent -> (целое число)

Процент завершенности административного действия STORAGE_OPTIMIZATION или DOWNLOAD_DATA_FROM_BACKUP. Не относится к другим типам административных действий.

RequestTime -> (метка времени)

Время получения запроса на административное действие.

Status -> (строка)

Статус административного действия:

  • FAILED - Amazon FSx не смог успешно обработать административное действие.
  • IN_PROGRESS - Amazon FSx обрабатывает административное действие.
  • PENDING - Amazon FSx ожидает обработки административного действия.
  • COMPLETED - Amazon FSx завершил обработку административной задачи. Для восстановления резервной копии в файловой системе FSx for ONTAP второго поколения, указывает, что все данные были загружены в том, и клиенты теперь имеют доступ к тому для чтения и записи.
  • UPDATED_OPTIMIZING - Для обновления емкости хранилища, Amazon FSx обновил файловую систему с новой емкостью хранилища и сейчас выполняет процесс оптимизации хранилища.
  • PENDING - Для восстановления резервной копии в файловой системе FSx for ONTAP второго поколения, указывает, что данные метаданных загружаются в том. Состояние жизненного цикла тома — CREATING.
  • IN_PROGRESS - Для восстановления резервной копии в файловой системе FSx for ONTAP второго поколения, указывает, что все метаданные загружены в новый том, и клиенты могут получить доступ к данным только для чтения, пока Amazon FSx загружает данные файла в том. Отслеживать прогресс этого процесса можно с помощью элемента ProgressPercent.

TargetFileSystemValues -> (структура)

Целевое значение для администрационного действия, предоставленное в операции UpdateFileSystem. Возвращается для административных действий FILE_SYSTEM_UPDATE.

OwnerId -> (string)

Учетная запись Amazon Web Services, которая создала файловую систему. Если файловую систему создал пользователь в IAM Identity Center, учетной записью владельца является учетная запись Amazon Web Services, к которой принадлежит IAM-пользователь.

CreationTime -> (timestamp)

Время создания файловой системы в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

FileSystemId -> (string)

Сгенерированный системой уникальный 17-значный идентификатор файловой системы.

FileSystemType -> (string)

Тип файловой системы Amazon FSx, который может быть LUSTRE , WINDOWS , ONTAP или OPENZFS.

Lifecycle -> (string)

Статус жизненного цикла файловой системы. Следующие значения и их значения:

  • AVAILABLE - Файловая система находится в нормальном состоянии, доступна и может использоваться.
  • CREATING - Amazon FSx создаёт новую файловую систему.
  • DELETING - Amazon FSx удаляет существующую файловую систему.
  • FAILED - Существующая файловая система столкнулась с невосстановимым сбоем. При создании новой файловой системы Amazon FSx не смог её создать.
  • MISCONFIGURED - Файловая система находится в состоянии ошибки, но может быть восстановлена.
  • MISCONFIGURED_UNAVAILABLE - (Только для Amazon FSx for Windows File Server) Файловая система временно недоступна из-за изменения вашей конфигурации Active Directory.
  • UPDATING - Файловая система проходит обновление, инициированное клиентом.

FailureDetails -> (structure)

Структура, предоставляющая подробную информацию о любых произошедших ошибках.

Message -> (string)

Сообщение, описывающее любые произошедшие ошибки.

StorageCapacity -> (integer)

Ёмкость хранилища файловой системы в гигабайтах (GiB).

Amazon FSx возвращает HTTP-код состояния 400 (Bad Request), если значение StorageCapacity находится вне минимальных или максимальных значений.

StorageType -> (string)

Тип хранилища, используемого файловой системой. Если установлено значение SSD, файловая система использует хранилище твердотельных дисков. Если установлено значение HDD, файловая система использует хранилище жёстких дисков.

VpcId -> (string)

Идентификатор основного виртуального частного облака (VPC) для файловой системы.

SubnetIds -> (list)

Указывает идентификаторы подсетей, с которых доступна файловая система. Для развертывания файловой системы Amazon FSx Windows и ONTAP MULTI_AZ_1 есть два идентификатора подсетей: один для первичного файлового сервера и один для резервного. Первичная подсеть файлового сервера указана в свойстве PreferredSubnetID. Все остальные файловые системы имеют только один идентификатор подсети.

Для файловых систем FSx for Lustre и файловых систем Windows с одиночной зоной доступности (Single-AZ) это идентификатор подсети, содержащей конечную точку файловой системы. Для файловых систем MULTI_AZ_1 Windows и ONTAP конечная точка файловой системы доступна в PreferredSubnetID.

(string)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашем виртуальном частном облаке (VPC). Дополнительную информацию см. в руководстве пользователя Amazon VPC, раздел VPC и подсети.

NetworkInterfaceIds -> (list)

Идентификаторы интерфейсов эластичных сетей, с помощью которых доступна конкретная файловая система. Интерфейс эластичной сети автоматически создается в том же виртуальном частном облаке (VPC), в котором была создана файловая система Amazon FSx. Дополнительную информацию см. в руководстве пользователя Amazon EC2, раздел Интерфейсы эластичных сетей.

Для файловой системы Amazon FSx for Windows File Server можно иметь один идентификатор сетевого интерфейса. Для файловой системы Amazon FSx for Lustre можно иметь более одного.

(string)

Идентификатор эластичного сетевого интерфейса. Эластичный сетевой интерфейс — это логический сетевой компонент в виртуальном частном облаке (VPC), представляющий собой виртуальную сетевую карту. Дополнительную информацию см. в руководстве пользователя Amazon EC2 для Linux-инстансов, раздел Интерфейсы эластичных сетей.

DNSName -> (string)

Имя домена системы доменных имён (DNS) для файловой системы.

KmsKeyId -> (string)

Идентификатор ключа службы управления ключами (KMS), используемого для шифрования данных файловой системы Amazon FSx. Используется следующим образом с типами файловых систем Amazon FSx:

  • Только для Amazon FSx for Lustre PERSISTENT_1 и PERSISTENT_2 типов развертывания. SCRATCH_1 и SCRATCH_2 типы зашифрованы с помощью ключа KMS службы Amazon FSx для вашей учетной записи.
  • Amazon FSx for NetApp ONTAP
  • Amazon FSx for OpenZFS
  • Amazon FSx for Windows File Server

ResourceARN -> (string)

Amazon Resource Name (ARN) ресурса файловой системы.

Tags -> (list)

Теги, которые нужно добавить к файловой системе. Дополнительную информацию см. в руководстве пользователя Amazon FSx for Lustre, раздел Добавление тегов к ресурсам Amazon FSx.

(structure)

Указывает пару ключ-значение для тега ресурса.

Key -> (string)

Значение, определяющее TagKey, имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (string)

Значение, определяющее TagValue, значение, назначенное соответствующему ключу тега. Значения тегов могут быть null и не обязательно должны быть уникальными в наборе тегов. Например, у вас может быть пара ключ-значение в наборе тегов finances : April и также payroll : April.

WindowsConfiguration -> (structure)

Настройка файловой системы Amazon FSx для Windows File Server.

ActiveDirectoryId -> (строка)

Идентификатор существующей управляемой Amazon Web Services службы Microsoft Active Directory, к которой присоединена файловая система.

SelfManagedActiveDirectoryConfiguration -> (структура)

Настройка домена самообслуживания Microsoft Active Directory (AD), к которому подключён экземпляр Windows File Server или ONTAP хранилище виртуальной машины (SVM).

DomainName -> (строка)

Полное доменное имя домена самообслуживания AD.

OrganizationalUnitDistinguishedName -> (строка)

Полное различающее имя организационной единицы в домене самообслуживания AD, к которому подключён экземпляр Windows File Server или ONTAP хранилище виртуальной машины (SVM).

FileSystemAdministratorsGroup -> (строка)

Имя доменной группы, члены которой имеют административные привилегии для файловой системы FSx.

UserName -> (строка)

Имя пользователя для учетной записи службы в вашем домене самообслуживания AD, которую FSx использует для подключения к вашему домену AD.

DnsIps -> (список)

Список из не более чем трех IP-адресов DNS-серверов или контроллеров домена в домене самообслуживания AD.

(строка)

DeploymentType -> (строка)

Указывает тип развертывания файловой системы, допустимые значения:

  • MULTI_AZ_1 - Указывает высокодоступную файловую систему, настроенную на многозонную избыточность для предотвращения временной недоступности зоны доступности (AZ), поддерживает хранение SSD и HDD.
  • SINGLE_AZ_1 - (По умолчанию) Указывает файловую систему, настроенную на однозонную избыточность, поддерживает только SSD-хранение.
  • SINGLE_AZ_2 - Файловая система последнего поколения с однозонной избыточностью. Указывает файловую систему, настроенную на однозонную избыточность и поддерживающую хранение SSD и HDD.

Для получения дополнительной информации см. Однозонные и многозонные файловые системы.

RemoteAdministrationEndpoint -> (строка)

Для типов развертывания MULTI_AZ_1 используйте этот конечный пункт при выполнении административных задач на файловой системе с помощью Amazon FSx Remote PowerShell.

Для типов развертывания SINGLE_AZ_1 и SINGLE_AZ_2 это имя DNS файловой системы.

Этот конечный пункт временно недоступен во время технического обслуживания файловой системы.

PreferredSubnetId -> (строка)

Для типов развертывания MULTI_AZ_1 он указывает идентификатор подсети, где находится предпочтительный файловый сервер. Должен быть одним из двух идентификаторов подсети, указанных в свойстве SubnetIds. Amazon FSx обслуживает трафик из этой подсети, за исключением случаев переключения на резервный файловый сервер.

Для типов развертывания SINGLE_AZ_1 и SINGLE_AZ_2 это значение такое же, как и для SubnetIDs. Для получения дополнительной информации см. Доступность и долговечность: однозонные и многозонные файловые системы.

PreferredFileServerIp -> (строка)

Для типов развертывания MULTI_AZ_1 IP-адрес основного или предпочтительного файлового сервера.

Используйте этот IP-адрес при подключении файловой системы к клиентам Linux SMB или Windows SMB, которые не подключены к Microsoft Active Directory. Применимо для всех типов развертывания файловых систем Windows. Этот IP-адрес временно недоступен во время технического обслуживания файловой системы. Для клиентов Linux и Windows SMB, подключенных к Active Directory, используйте DNSName файловой системы. Для получения дополнительной информации о сопоставлении и подключении сетевых ресурсов см. Доступ к сетевым ресурсам.

ThroughputCapacity -> (целое число)

Пропускная способность файловой системы Amazon FSx, измеряемая в мегабайтах в секунду.

MaintenanceOperationsInProgress -> (список)

Список операций технического обслуживания, выполняемых для этой файловой системы.

(строка)

Перечисление, определяющее текущую операцию технического обслуживания.

WeeklyMaintenanceStartTime -> (строка)

Предпочтительное время для выполнения еженедельного технического обслуживания, отформатированное как d:HH:MM в часовом поясе UTC. d - это номер дня недели от 1 до 7, начиная с понедельника и заканчивая воскресеньем.

DailyAutomaticBackupStartTime -> (строка)

Предпочтительное время для выполнения ежедневных автоматических резервных копий в часовом поясе UTC.

AutomaticBackupRetentionDays -> (целое число)

Количество дней хранения автоматических резервных копий. Установка значения 0 отключает автоматические резервные копии. Вы можете хранить автоматические резервные копии не более 90 дней.

CopyTagsToBackups -> (логическое значение)

Логическое значение, указывающее, должны ли теги файловой системы копироваться в резервные копии. По умолчанию значение равно false. Если оно установлено в true, все теги файловой системы копируются во все автоматические резервные копии и все резервные копии, созданные пользователем, где пользователь не указывает теги. Если это значение true, и вы указываете один или несколько тегов, только указанные теги копируются в резервные копии. Если вы указываете один или несколько тегов при создании резервной копии, инициированной пользователем, теги из файловой системы не копируются, независимо от этого значения.

Aliases -> (список)

Массив из одного или нескольких DNS-псевдонимов, которые в настоящее время связаны с файловой системой Amazon FSx. Псевдонимы позволяют использовать существующие имена DNS для доступа к данным в вашей файловой системе Amazon FSx. Вы можете связать до 50 псевдонимов с файловой системой в любое время. Вы можете добавить дополнительные DNS-псевдонимы после создания файловой системы, используя операцию AssociateFileSystemAliases. Вы можете удалить DNS-псевдонимы из файловой системы после ее создания, используя операцию DisassociateFileSystemAliases. Вам нужно указать только имя псевдонима в теле запроса. Для получения дополнительной информации см. DNS-псевдонимы.

(структура)

DNS-псевдоним, связанный с файловой системой. Вы можете использовать DNS-псевдоним для доступа к файловой системе с использованием определённых вами имён DNS в дополнение к имени DNS по умолчанию, присваиваемому файловой системе Amazon FSx. Для получения дополнительной информации см. DNS-псевдонимы в Руководстве пользователя FSx для Windows File Server.

Name -> (строка)

Имя DNS-псевдонима. Имя псевдонима должно соответствовать следующим требованиям:

  • Отформатировано как полное доменное имя (FQDN), hostname.domain , например, accounting.example.com.
  • Может содержать буквенно-цифровые символы, символ подчёркивания (_) и дефис (-).
  • Не может начинаться или заканчиваться дефисом.
  • Может начинаться с цифры.

Для имён DNS Amazon FSx хранит буквенные символы в нижнем регистре (a-z), независимо от того, как вы их указываете: в верхнем регистре, нижнем регистре или соответствующих символах в кодах экранирования.

Lifecycle -> (строка)

Описание состояния DNS-псевдонима.

  • AVAILABLE - DNS-псевдоним связан с файловой системой Amazon FSx.
  • CREATING - Amazon FSx создаёт DNS-псевдоним и связывает его с файловой системой.
  • CREATE_FAILED - Amazon FSx не смог связать DNS-псевдоним с файловой системой.
  • DELETING - Amazon FSx отключает DNS-псевдоним от файловой системы и удаляет его.
  • DELETE_FAILED - Amazon FSx не смог отсоединить DNS-псевдоним от файловой системы.

AuditLogConfiguration -> (структура)

Настройка, которую Amazon FSx для Windows File Server использует для аудита и протоколирования доступа пользователей к файлам, папкам и сетевым ресурсам в файловой системе Amazon FSx для Windows File Server.

FileAccessAuditLogLevel -> (строка)

Устанавливает тип попытки, который регистрируется Amazon FSx для доступа к файлам и папкам.

  • SUCCESS_ONLY - регистрируются только успешные попытки доступа к файлам или папкам.
  • FAILURE_ONLY - регистрируются только неудачные попытки доступа к файлам или папкам.
  • SUCCESS_AND_FAILURE - регистрируются как успешные, так и неудачные попытки доступа к файлам или папкам.
  • DISABLED - аудит доступа к файлам и папкам отключён.

FileShareAccessAuditLogLevel -> (строка)

Устанавливает тип попытки, который регистрируется Amazon FSx для доступа к сетевым ресурсам.

  • SUCCESS_ONLY - регистрируются только успешные попытки доступа к сетевым ресурсам.
  • FAILURE_ONLY - регистрируются только неудачные попытки доступа к сетевым ресурсам.
  • SUCCESS_AND_FAILURE - регистрируются как успешные, так и неудачные попытки доступа к сетевым ресурсам.
  • DISABLED - аудит доступа к сетевым ресурсам отключён.

AuditLogDestination -> (строка)

Amazon Resource Name (ARN) для назначения журналов аудита. Назначение может быть любым ARN группы журналов Amazon CloudWatch Logs или потока доставки Amazon Kinesis Data Firehose.

Имя группы журналов Amazon CloudWatch Logs должно начинаться с префикса /aws/fsx. Имя потока доставки Amazon Kinesis Data Firehose должно начинаться с префикса aws-fsx.

ARN назначения (группа журналов CloudWatch Logs или поток доставки Kinesis Data Firehose) должен находиться в той же области Amazon Web Services, в том же регионе Amazon Web Services и в том же аккаунте Amazon Web Services, что и ваша файловая система Amazon FSx.

DiskIopsConfiguration -> (структура)

Настройка SSD IOPS (операций ввода/вывода в секунду) для файловой системы Amazon FSx для Windows. По умолчанию Amazon FSx автоматически выделяет 3 IOPS на каждый ГБ ёмкости хранилища. Вы можете выделить дополнительные IOPS на каждый ГБ ёмкости хранилища до максимального предела, связанного с выбранной пропускной способностью.

Mode -> (строка)

Указывает, использует ли файловая система значение AUTOMATIC для SSD IOPS (3 IOPS на ГБ ёмкости хранилища) или использует значение USER_PROVISIONED.

Iops -> (длинное целое число)

Общее количество SSD IOPS, выделенных для файловой системы.

Минимальные и максимальные значения для этого свойства зависят от значений HAPairs и StorageCapacity. Минимальное значение вычисляется как StorageCapacity * 3 * HAPairs (3 IOPS на ГБ ёмкости StorageCapacity). Максимальное значение вычисляется как 200 000 * HAPairs.

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса), если значение Iops находится за пределами минимальных или максимальных значений.

LustreConfiguration -> (структура)

Конфигурация файловой системы Amazon FSx для Lustre.

WeeklyMaintenanceStartTime -> (строка)

Предпочтительное время выполнения еженедельного обслуживания, отформатированное как d:HH:MM в часовом поясе UTC. Здесь d — номер дня недели от 1 до 7, начиная с понедельника и заканчивая воскресеньем.

DataRepositoryConfiguration -> (структура)

Объект конфигурации хранилища данных для файловых систем Lustre, возвращаемый в ответе операции CreateFileSystem.

Этот тип данных не поддерживается для файловых систем с подключенным хранилищем данных. Для файловых систем с подключенным хранилищем данных см. .

Lifecycle -> (строка)

Описывает состояние хранилища долговременных данных S3 файловой системы, если она настроена с хранилищем S3. Жизненный цикл может иметь следующие значения:

  • CREATING — конфигурация хранилища данных между файловой системой FSx и связанным хранилищем данных S3 создается. Хранилище данных недоступно.
  • AVAILABLE — хранилище данных доступно для использования.
  • MISCONFIGURED — Amazon FSx не может автоматически импортировать обновления из ведра S3, пока конфигурация хранилища данных не будет исправлена. Дополнительную информацию см. в разделе Устранение неполадок с неправильно настроенным связанным ведром S3.
  • UPDATING — хранилище данных проходит обновление, инициированное пользователем, и доступность может быть нарушена.
  • FAILED — хранилище данных находится в терминальном состоянии, из которого невозможно восстановиться.

ImportPath -> (строка)

Путь импорта в ведро Amazon S3 (и необязательный префикс), используемое в качестве хранилища данных для вашей файловой системы FSx для Lustre, например s3://import-bucket/optional-prefix. Если после имени ведра Amazon S3 указан префикс, в файловую систему загружаются только объекты с этим префиксом.

ExportPath -> (строка)

Путь экспорта в ведро Amazon S3 (и префикс), используемое для хранения новых и измененных файлов файловой системы Lustre в S3.

ImportedFileChunkSize -> (целое число)

Для файлов, импортированных из хранилища данных, это значение определяет количество полос и максимальный объем данных на файл (в МБ) на одном физическом диске. Максимальное количество дисков, на которые может быть распределен один файл, ограничено общим количеством дисков, составляющих файловую систему.

Размер фрагмента по умолчанию составляет 1024 МБ (1 ГБ) и может достигать 512 000 МБ (500 ГБ). Объекты Amazon S3 имеют максимальный размер 5 ТБ.

AutoImportPolicy -> (строка)

Описывает AutoImportPolicy связанного хранилища данных S3 файловой системы. AutoImportPolicy определяет, как Amazon FSx обновляет списки файлов и каталогов, когда вы добавляете или изменяете объекты в связанном ведре S3. AutoImportPolicy может иметь следующие значения:

  • NONE — (по умолчанию) AutoImport выключен. Amazon FSx обновляет списки файлов и каталогов из связанного ведра S3 только при создании файловой системы. FSx не обновляет списки файлов и каталогов для новых или измененных объектов после выбора этого параметра.
  • NEW — AutoImport включен. Amazon FSx автоматически импортирует списки каталогов любых новых объектов, добавленных в связанное ведро S3, которые еще не существуют в файловой системе FSx.
  • NEW_CHANGED — AutoImport включен. Amazon FSx автоматически импортирует списки файлов и каталогов любых новых объектов, добавленных в ведро S3, и любых существующих объектов, измененных в ведре S3, после выбора этого параметра.
  • NEW_CHANGED_DELETED — AutoImport включен. Amazon FSx автоматически импортирует списки файлов и каталогов любых новых объектов, добавленных в ведро S3, любых существующих объектов, измененных в ведре S3, и любых объектов, удаленных из ведра S3.

FailureDetails -> (структура)

Предоставляет подробную информацию о хранилище данных, если его Lifecycle установлено в значение MISCONFIGURED или FAILED.

Message -> (строка)

Подробное сообщение об ошибке.

DeploymentType -> (строка)

Тип развертывания файловой системы FSx для Lustre. Тип развертывания «Scratch» предназначен для временного хранения и краткосрочной обработки данных.

SCRATCH_1 и SCRATCH_2 типы развертывания лучше всего подходят, когда вам нужно временное хранилище и краткосрочная обработка данных. Тип развертывания SCRATCH_2 обеспечивает шифрование данных во время передачи и большую пропускную способность при всплесках, чем SCRATCH_1.

Тип развертывания PERSISTENT_1 и PERSISTENT_2 используется для долгосрочного хранения и рабочих нагрузок и шифрования данных во время передачи. PERSISTENT_2 обеспечивает большую PerUnitStorageThroughput (до 1000 МБ/с/ТБ) вместе с более низким минимальным требованием к объему хранения (600 ГБ). Чтобы узнать больше о типах развертывания FSx для Lustre, см. Варианты развертывания FSx для Lustre.

По умолчанию — SCRATCH_1.

PerUnitStorageThroughput -> (целое число)

Пропускная способность хранения на единицу измерения представляет собой мегабайты в секунду пропускной способности чтения или записи на каждый терабайт предоставленного хранения. Емкость пропускной способности файловой системы равна Объем хранения (ТБ) * Пропускная способность на единицу хранения (МБ/с/ТБ). Этот параметр действителен только для типов развертывания PERSISTENT_1 и PERSISTENT_2.

Допустимые значения:

  • Для хранилища SSD: 50, 100, 200.
  • Для хранилища HDD: 12, 40.
  • Для хранилища SSD: 125, 250, 500, 1000.

MountName -> (строка)

Вы используете значение MountName при подключении файловой системы.

Для типа развертывания SCRATCH_1 это значение всегда «fsx». Для типов развертывания SCRATCH_2, PERSISTENT_1 и PERSISTENT_2 это значение — строка, уникальная в рамках региона Amazon Web Services.

DailyAutomaticBackupStartTime -> (строка)

Повторяющееся ежедневное время в формате HH:MM. HH — нуль-заполненные часы в сутках (0–23), а MM — нуль-заполненные минуты в часе. Например, 05:00 указывает 5:00 каждый день.

AutomaticBackupRetentionDays -> (целое число)

Количество дней, в течение которых сохраняются автоматические резервные копии. Установка этого свойства в значение 0 отключает автоматические резервные копии. Вы можете сохранять автоматические резервные копии в течение максимум 90 дней. По умолчанию — 30.

CopyTagsToBackups -> (булево)

Флаг, указывающий, копируются ли теги файловой системы в резервные копии. Если он установлен в значение true, все теги файловой системы копируются во все автоматические резервные копии и в любые резервные копии, инициированные пользователем, в которых пользователь не указывает никаких тегов. Если это значение равно true, и вы указываете один или несколько тегов, копируются только указанные теги. Если вы указываете один или несколько тегов при создании резервной копии, инициированной пользователем, теги не копируются из файловой системы, независимо от этого значения. (По умолчанию = false)

DriveCacheType -> (строка)

Тип кэша диска, используемого файловыми системами PERSISTENT_1, которые настроены с устройствами хранения HDD. Этот параметр необходим, когда StorageType — HDD. При установке в значение READ файловая система имеет кэш SSD, размер которого составляет 20% от емкости хранения файловой системы. Это повышает производительность часто используемых файлов, кэшируя до 20% общего объема хранения.

Этот параметр необходим, когда StorageType установлено в значение HDD.

DataCompressionType -> (строка)

Настройка сжатия данных для файловой системы. DataCompressionType может иметь следующие значения:

  • NONE — Сжатие данных отключено для файловой системы.
  • LZ4 — Сжатие данных включено с алгоритмом LZ4.

Дополнительную информацию см. в разделе Сжатие данных Lustre.

LogConfiguration -> (структура)

Конфигурация ведения журнала Lustre. Ведение журнала Lustre записывает разрешенные события журнала для вашей файловой системы в Amazon CloudWatch Logs.

Level -> (строка)

События хранилища данных, которые регистрируются Amazon FSx.

  • WARN_ONLY — регистрируются только предупреждения.
  • ERROR_ONLY — регистрируются только ошибки.
  • WARN_ERROR — регистрируются как предупреждения, так и ошибки.
  • DISABLED — регистрация событий хранилища данных отключена.

Обратите внимание, что Amazon File Cache использует значение по умолчанию WARN_ERROR, которое изменить нельзя.

Destination -> (строка)

Идентификатор ресурса Amazon (ARN), указывающий место назначения журналов. Место назначения может быть любым ARN группы журналов Amazon CloudWatch Logs. ARN места назначения должен находиться в той же облачной среде Amazon Web Services, том же регионе Amazon Web Services и том же аккаунте Amazon Web Services, что и ваша файловая система Amazon FSx.

RootSquashConfiguration -> (структура)

Настройка сжатия root Lustre для файловой системы Amazon FSx для Lustre. При включении сжатия root ограничивается доступ корневого уровня от клиентов, которые пытаются получить доступ к файловой системе в качестве корневого пользователя.

RootSquash -> (строка)

Вы включаете сжатие root, задав идентификатор пользователя (UID) и идентификатор группы (GID) для файловой системы в формате UID:GID (например, 365534:65534). Значения UID и GID могут варьироваться от 0 до 4294967294:

  • Неравное нулю значение UID и GID включает сжатие root. Значения UID и GID могут быть разными, но каждое должно быть не равным нулю.
  • Значение 0 (ноль) для UID и GID указывает на root и, следовательно, отключает сжатие root.

Когда сжатие root включено, идентификатор пользователя и идентификатор группы корневого пользователя, пытающегося получить доступ к файловой системе, переназначаются на предоставленные вами UID и GID.

NoSquashNids -> (список)

Когда сжатие root включено, вы можете дополнительно указать массив NID клиентов, для которых сжатие root не применяется. Клиентский NID — это идентификатор сети Lustre, используемый для уникальной идентификации клиента. Вы можете указать NID как один адрес или диапазон адресов:

  • Один адрес описывается в стандартном формате NID Lustre, указав IP-адрес клиента и идентификатор сети Lustre (например, 10.0.1.6@tcp).
  • Диапазон адресов описывается с использованием дефиса для разделения диапазона (например, 10.0.[2-10].[1-255]@tcp).

(строка)

MetadataConfiguration -> (структура)

Настройка производительности метаданных Lustre для файловой системы Amazon FSx для Lustre с использованием типа развертывания PERSISTENT_2.

Iops -> (целое число)

Количество метаданных IOPS, предоставленных для файловой системы. Допустимые значения — 1500 , 3000 , 6000 , 12000 и кратные 12000 до максимального значения 192000.

Mode -> (строка)

Режим конфигурации метаданных для выделения метаданных IOPS для файловой системы.

  • В режиме AUTOMATIC, FSx для Lustre автоматически выделяет и масштабирует количество метаданных IOPS в вашей файловой системе, основываясь на объёме памяти вашей файловой системы.
  • В режиме USER_PROVISIONED вы можете указать количество метаданных IOPS для выделения в вашей файловой системе.

EfaEnabled -> (логическое значение)

Указывает, включена ли поддержка Elastic Fabric Adapter (EFA) и GPUDirect Storage (GDS) для файловой системы Amazon FSx для Lustre.

AdministrativeActions -> (список)

Список административных действий для файловой системы, которые выполняются или ожидают обработки. Административные действия описывают изменения в системе Amazon FSx, которые вы инициировали, используя операцию UpdateFileSystem.

(структура)

Описывает конкретное административное действие Amazon FSx для текущей файловой системы или тома Windows, Lustre, OpenZFS или ONTAP.

AdministrativeActionType -> (строка)

Описывает тип административного действия следующим образом:

  • FILE_SYSTEM_UPDATE — административное действие обновления файловой системы, инициированное из консоли Amazon FSx, API (UpdateFileSystem) или командной строки (update-file-system).
  • THROUGHPUT_OPTIMIZATION — после успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача THROUGHPUT_OPTIMIZATION. Вы можете отслеживать прогресс оптимизации хранилища с помощью свойства ProgressPercent. После успешного завершения THROUGHPUT_OPTIMIZATION статус родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED. Дополнительную информацию см. в руководстве пользователя Amazon FSx для Windows File Server — Управление пропускной способностью.
  • STORAGE_OPTIMIZATION — после успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению объёма памяти файловой системы запускается задача STORAGE_OPTIMIZATION.
    • Для Windows и ONTAP оптимизация хранилища — это процесс миграции данных файловой системы на новые более объёмные диски.
    • Для Lustre оптимизация хранилища состоит в перераспределении данных между существующими и вновь добавленными файловыми серверами.

Вы можете отслеживать прогресс оптимизации хранилища с помощью свойства ProgressPercent. После успешного завершения STORAGE_OPTIMIZATION статус родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED. Дополнительную информацию см. в руководстве пользователя Amazon FSx для Windows File Server — Управление объёмом памяти, руководстве пользователя Amazon FSx для Lustre — Управление объёмом памяти и выделенными IOPS, руководстве пользователя Amazon FSx для NetApp ONTAP — Управление объёмом памяти и выделенными IOPS.

  • FILE_SYSTEM_ALIAS_ASSOCIATION — обновление файловой системы для сопоставления нового псевдонима Domain Name System (DNS) с файловой системой. Дополнительную информацию см. в разделе AssociateFileSystemAliases.
  • FILE_SYSTEM_ALIAS_DISASSOCIATION — обновление файловой системы для отключения псевдонима DNS от файловой системы. Дополнительную информацию см. в разделе DisassociateFileSystemAliases.
  • IOPS_OPTIMIZATION — после успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача IOPS_OPTIMIZATION. Вы можете отслеживать прогресс оптимизации хранилища с помощью свойства ProgressPercent. После успешного завершения IOPS_OPTIMIZATION статус родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED. Дополнительную информацию см. в руководстве пользователя Amazon FSx для Windows File Server — Управление выделенными IOPS SSD.
  • STORAGE_TYPE_OPTIMIZATION — после успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача STORAGE_TYPE_OPTIMIZATION. Вы можете отслеживать прогресс оптимизации хранилища с помощью свойства ProgressPercent. После успешного завершения STORAGE_TYPE_OPTIMIZATION статус родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED.
  • VOLUME_UPDATE — обновление тома Amazon FSx для OpenZFS, инициированное из консоли Amazon FSx, API (UpdateVolume) или командной строки (update-volume).
  • VOLUME_RESTORE — том Amazon FSx для OpenZFS возвращается в состояние, сохранённое указанным снимком, инициированное из API (RestoreVolumeFromSnapshot) или командной строки (restore-volume-from-snapshot).
  • SNAPSHOT_UPDATE — обновление снимка для тома Amazon FSx для OpenZFS, инициированное из консоли Amazon FSx, API (UpdateSnapshot) или командной строки (update-snapshot).
  • RELEASE_NFS_V3_LOCKS — отслеживание освобождения блокировок Network File System (NFS) V3 в файловой системе Amazon FSx для OpenZFS.
  • DOWNLOAD_DATA_FROM_BACKUP — резервное копирование FSx для ONTAP восстанавливается в новый том на файловой системе второго поколения. После загрузки всех метаданных файлов в том, вы можете смонтировать том с чтением без записи.
  • VOLUME_INITIALIZE_WITH_SNAPSHOT — создание тома из снимка на другой файловой системе FSx для OpenZFS. Вы можете инициировать это из консоли Amazon FSx, API (CreateVolume) или командной строки (create-volume) при использовании стратегии FULL_COPY.
  • VOLUME_UPDATE_WITH_SNAPSHOT — обновление тома из снимка на другой файловой системе FSx для OpenZFS. Вы можете инициировать это из консоли Amazon FSx, API (CopySnapshotAndUpdateVolume) или командной строки (copy-snapshot-and-update-volume).

ProgressPercent -> (целое число)

Процент выполнения административного действия STORAGE_OPTIMIZATION или DOWNLOAD_DATA_FROM_BACKUP. Не применяется к другим типам административных действий.

RequestTime -> (временная метка)

Время получения запроса на административное действие.

Status -> (строка)

Статус административного действия:

  • FAILED — Amazon FSx не смог успешно обработать административное действие.
  • IN_PROGRESS — Amazon FSx обрабатывает административное действие.
  • PENDING — Amazon FSx ожидает обработки административного действия.
  • COMPLETED — Amazon FSx завершил обработку административной задачи. Для восстановления резервной копии на файловой системе FSx для ONTAP второго поколения указывает, что все данные были загружены в том, и клиенты теперь имеют доступ к тому со чтением и записью.
  • UPDATED_OPTIMIZING — при увеличении объёма памяти файловой системы Amazon FSx обновил файловую систему с новым объёмом памяти и в настоящее время выполняет процесс оптимизации хранилища.
  • PENDING — для восстановления резервной копии на файловой системе FSx для ONTAP второго поколения указывает, что метаданные файлов загружаются в том. Состояние жизненного цикла тома — CREATING.
  • IN_PROGRESS — для восстановления резервной копии на файловой системе FSx для ONTAP второго поколения указывает, что все метаданные были загружены в новый том, и клиенты могут получить доступ к данным только для чтения, пока Amazon FSx загружает данные файлов в том. Отслеживайте прогресс этого процесса с помощью элемента ProgressPercent.

TargetFileSystemValues -> (структура)

Целевое значение для административного действия, предоставленное в операции UpdateFileSystem. Возвращается для административных действий FILE_SYSTEM_UPDATE.

OwnerId -> (строка)

Учетная запись Amazon Web Services, создавшая файловую систему. Если файловая система была создана пользователем в IAM Identity Center, учетной записью владельца является учетная запись Amazon Web Services, к которой принадлежит IAM-пользователь.

CreationTime -> (отметка времени)

Время создания файловой системы в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

FileSystemId -> (строка)

Сгенерированный системой уникальный 17-значный идентификатор файловой системы.

FileSystemType -> (строка)

Тип файловой системы Amazon FSx, который может быть LUSTRE , WINDOWS , ONTAP или OPENZFS .

Lifecycle -> (строка)

Статус жизненного цикла файловой системы. Вот возможные значения и их значения:

  • AVAILABLE - Файловая система находится в работоспособном состоянии и доступна для использования.
  • CREATING - Amazon FSx создаёт новую файловую систему.
  • DELETING - Amazon FSx удаляет существующую файловую систему.
  • FAILED - Существующая файловая система столкнулась с непреодолимым сбоем. При создании новой файловой системы Amazon FSx не смог создать файловую систему.
  • MISCONFIGURED - Файловая система находится в состоянии сбоя, но её можно восстановить.
  • MISCONFIGURED_UNAVAILABLE - (Только для Amazon FSx для Windows File Server) Файловая система в настоящее время недоступна из-за изменения вашей конфигурации Active Directory.
  • UPDATING - Файловая система проходит обновление, инициированное клиентом.

FailureDetails -> (структура)

Структура, предоставляющая подробную информацию о любых произошедших сбоях.

Message -> (строка)

Сообщение, описывающее любые произошедшие сбои.

StorageCapacity -> (целое число)

Ёмкость хранилища файловой системы в гигабайтах (GiB).

Amazon FSx отвечает кодом состояния HTTP 400 (Bad Request), если значение StorageCapacity находится вне минимальных или максимальных значений.

StorageType -> (строка)

Тип хранилища, используемого файловой системой. Если установлено значение SSD , файловая система использует хранилище на твердотельных накопителях. Если установлено значение HDD , файловая система использует хранилище на жёстких дисках.

VpcId -> (строка)

Идентификатор основной виртуальной частной сети (VPC) для файловой системы.

SubnetIds -> (список)

Указывает идентификаторы подсетей, из которых доступна файловая система. Для развертывания файловой системы Amazon FSx для Windows и ONTAP MULTI_AZ_1 есть два идентификатора подсетей: один для предпочтительного сервера файлов и один для резервного сервера файлов. Предпочтительная подсеть сервера файлов указана в свойстве PreferredSubnetID. Все остальные файловые системы имеют только один идентификатор подсети.

Для файловых систем FSx для Lustre и файловых систем Windows с одной зоной доступности это идентификатор подсети, содержащей конечную точку файловой системы. Для файловых систем Windows и ONTAP MULTI_AZ_1 конечная точка файловой системы доступна в PreferredSubnetID.

(строка)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашей виртуальной частной сети (VPC). Дополнительные сведения см. в разделе VPC и подсети в руководстве пользователя Amazon VPC.

NetworkInterfaceIds -> (список)

Идентификаторы эластичных сетевых интерфейсов, с помощью которых можно получить доступ к определённой файловой системе. Эластичный сетевой интерфейс автоматически создаётся в той же виртуальной частной сети (VPC), в которой была создана файловая система Amazon FSx. Дополнительные сведения см. в разделе Эластичные сетевые интерфейсы в руководстве пользователя Amazon EC2.

Для файловой системы Amazon FSx для Windows File Server может быть один идентификатор сетевого интерфейса. Для файловой системы Amazon FSx для Lustre может быть несколько.

(строка)

Идентификатор эластичного сетевого интерфейса. Эластичный сетевой интерфейс — это логический сетевой компонент в виртуальной частной сети (VPC), представляющий виртуальную сетевую карту. Дополнительные сведения см. в разделе Эластичные сетевые интерфейсы в руководстве пользователя Amazon EC2 для Linux-инстансов.

DNSName -> (строка)

Имя домена DNS для файловой системы.

KmsKeyId -> (строка)

Идентификатор ключа службы управления ключами (KMS), используемого для шифрования данных файловой системы Amazon FSx. Используется следующим образом с типами файловых систем Amazon FSx:

  • Amazon FSx для Lustre PERSISTENT_1 и PERSISTENT_2 типы развертывания только. SCRATCH_1 и SCRATCH_2 типы зашифрованы с помощью ключа KMS службы Amazon FSx для вашей учетной записи.
  • Amazon FSx для NetApp ONTAP
  • Amazon FSx для OpenZFS
  • Amazon FSx для Windows File Server

ResourceARN -> (строка)

Amazon Resource Name (ARN) ресурса файловой системы.

Tags -> (список)

Теги, которые нужно прикрепить к файловой системе. Дополнительные сведения см. в разделе Добавление тегов к ресурсам Amazon FSx в руководстве пользователя Amazon FSx для Lustre.

(структура)

Указывает пару ключ-значение для тега ресурса.

Key -> (строка)

Значение, определяющее TagKey, имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (строка)

Значение, определяющее TagValue, значение, назначенное соответствующему ключу тега. Значения тегов могут быть null и не обязательно должны быть уникальными в наборе тегов. Например, в наборе тегов может быть пара ключ-значение finances : April и также payroll : April.

WindowsConfiguration -> (структура)

Настройка этого файлового сервера Amazon FSx для Windows.

ActiveDirectoryId -> (строка)

Идентификатор существующего управляемого Microsoft Active Directory экземпляра Amazon Web Services, к которому подключен файловый сервер.

SelfManagedActiveDirectoryConfiguration -> (структура)

Настройка домена Microsoft Active Directory (AD) собственной инфраструктуры, к которому подключён экземпляр Windows File Server или хранилища ONTAP.

DomainName -> (строка)

Полное доменное имя домена собственной инфраструктуры AD.

OrganizationalUnitDistinguishedName -> (строка)

Полное различающее имя организационной единицы в домене AD собственной инфраструктуры, к которому подключён экземпляр Windows File Server или хранилища ONTAP.

FileSystemAdministratorsGroup -> (строка)

Имя доменной группы, члены которой имеют административные права для файловой системы FSx.

UserName -> (строка)

Имя пользователя для учетной записи службы в вашем домене собственной инфраструктуры AD, которую FSx использует для подключения к вашему домену AD.

DnsIps -> (список)

Список до трёх IP-адресов DNS-серверов или контроллеров домена в домене AD собственной инфраструктуры.

(строка)

DeploymentType -> (строка)

Указывает тип развертывания файловой системы, допустимые значения:

  • MULTI_AZ_1 - Указывает высокодоступную файловую систему, настроенную для многозонной избыточности для предотвращения временного отказа доступности зоны (AZ) и поддерживает хранилища SSD и HDD.
  • SINGLE_AZ_1 - (По умолчанию) Указывает файловую систему, настроенную для однозонной избыточности, поддерживает только хранилища SSD.
  • SINGLE_AZ_2 - Файловая система нового поколения с однозонной избыточностью. Указывает файловую систему, настроенную для однозонной избыточности и поддерживающую хранилища SSD и HDD.

Для получения дополнительной информации см. Однозонные и многозонные файловые системы.

RemoteAdministrationEndpoint -> (строка)

Для типов развертывания MULTI_AZ_1 используйте этот конечный пункт при выполнении административных задач на файловой системе с помощью Amazon FSx Remote PowerShell.

Для типов развертывания SINGLE_AZ_1 и SINGLE_AZ_2 это имя DNS файловой системы.

Этот конечный пункт временно недоступен во время технического обслуживания файловой системы.

PreferredSubnetId -> (строка)

Для типов развертывания MULTI_AZ_1 указывает идентификатор подсети, в которой находится предпочтительный файловый сервер. Должен быть одним из двух идентификаторов подсетей, указанных в свойстве SubnetIds. Amazon FSx обрабатывает трафик из этой подсети, кроме случаев аварийного переключения на вторичный файловый сервер.

Для типов развертывания SINGLE_AZ_1 и SINGLE_AZ_2 это значение совпадает с SubnetIDs. Для получения дополнительной информации см. Доступность и долговечность: однозонные и многозонные файловые системы.

PreferredFileServerIp -> (строка)

Для типов развертывания MULTI_AZ_1 IP-адрес первичного или предпочтительного файлового сервера.

Используйте этот IP-адрес при подключении файловой системы к клиентам Linux SMB или Windows SMB, которые не подключены к Microsoft Active Directory. Применимо ко всем типам развертывания Windows файловой системы. Этот IP-адрес временно недоступен во время технического обслуживания файловой системы. Для клиентов Linux и Windows SMB, подключенных к Active Directory, используйте DNSName файловой системы. Для получения дополнительной информации о подключении и монтировании общих папок см. Доступ к общим папкам.

ThroughputCapacity -> (целое число)

Пропускная способность файловой системы Amazon FSx, измеряемая в мегабайтах в секунду.

MaintenanceOperationsInProgress -> (список)

Список операций технического обслуживания, выполняемых для этой файловой системы.

(строка)

Перечисление текущей операции технического обслуживания.

WeeklyMaintenanceStartTime -> (строка)

Предпочтительное время начала еженедельного технического обслуживания, отформатированное как d:HH:MM в часовом поясе UTC. d - номер дня недели от 1 до 7, начиная с понедельника и заканчивая воскресеньем.

DailyAutomaticBackupStartTime -> (строка)

Предпочтительное время для выполнения ежедневных автоматических резервных копий в часовом поясе UTC.

AutomaticBackupRetentionDays -> (целое число)

Количество дней хранения автоматических резервных копий. Установка значения 0 отключает автоматические резервные копии. Вы можете хранить автоматические резервные копии не более 90 дней.

CopyTagsToBackups -> (булево)

Флаг, указывающий, следует ли копировать метки файловой системы в резервные копии. По умолчанию это значение равно false. Если оно установлено в true, все метки файловой системы копируются во все автоматические резервные копии и любые резервные копии, инициированные пользователем, в которых пользователь не указывает никаких меток. Если это значение равно true и вы указываете одну или несколько меток, копируются только указанные метки. Если вы указываете одну или несколько меток при создании резервной копии, инициированной пользователем, метки не копируются из файловой системы независимо от этого значения.

Aliases -> (список)

Массив из одного или нескольких DNS-псевдонимов, которые в настоящее время связаны с файловой системой Amazon FSx. Псевдонимы позволяют использовать существующие имена DNS для доступа к данным в вашей файловой системе Amazon FSx. Вы можете связать до 50 псевдонимов с файловой системой в любое время. Вы можете добавить дополнительные DNS-псевдонимы после создания файловой системы с помощью операции AssociateFileSystemAliases. Вы можете удалить DNS-псевдонимы из файловой системы после её создания с помощью операции DisassociateFileSystemAliases. Вам нужно указать только имя псевдонима в теле запроса. Для получения дополнительной информации см. DNS-псевдонимы.

(структура)

DNS-псевдоним, связанный с файловой системой. Псевдоним DNS позволяет получить доступ к файловой системе с помощью определённых вами имен DNS в дополнение к стандартному имени DNS, назначенному файловой системе Amazon FSx. Для получения дополнительной информации см. DNS-псевдонимы в руководстве пользователя FSx для Windows File Server.

Name -> (строка)

Имя DNS-псевдонима. Имя псевдонима должно соответствовать следующим требованиям:

  • Отформатировано как полное доменное имя (FQDN), hostname.domain, например, accounting.example.com.
  • Может содержать буквенно-цифровые символы, символ подчеркивания (_) и дефис (-).
  • Не может начинаться или заканчиваться дефисом.
  • Может начинаться с цифры.

Для имён DNS Amazon FSx сохраняет буквенные символы в нижнем регистре (a-z), независимо от того, как вы их указываете: заглавные буквы, строчные буквы или соответствующие буквы в кодах экранирования.

Lifecycle -> (строка)

Описывает состояние DNS-псевдонима.

  • AVAILABLE - DNS-псевдоним связан с файловой системой Amazon FSx.
  • CREATING - Amazon FSx создаёт DNS-псевдоним и связывает его с файловой системой.
  • CREATE_FAILED - Amazon FSx не смог связать DNS-псевдоним с файловой системой.
  • DELETING - Amazon FSx отсоединяет DNS-псевдоним от файловой системы и удаляет его.
  • DELETE_FAILED - Amazon FSx не смог отсоединить DNS-псевдоним от файловой системы.

AuditLogConfiguration -> (структура)

Настройка, которую Amazon FSx для Windows File Server использует для аудита и протоколирования доступа пользователей к файлам, папкам и общим папкам на файловой системе Amazon FSx для Windows File Server.

FileAccessAuditLogLevel -> (строка)

Устанавливает, какие типы попыток доступа к файлам и папкам регистрируются Amazon FSx.

  • SUCCESS_ONLY - регистрируются только успешные попытки доступа к файлам или папкам.
  • FAILURE_ONLY - регистрируются только неудачные попытки доступа к файлам или папкам.
  • SUCCESS_AND_FAILURE - регистрируются как успешные, так и неудачные попытки доступа к файлам или папкам.
  • DISABLED - аудит доступа к файлам и папкам выключен.

FileShareAccessAuditLogLevel -> (строка)

Устанавливает, какие типы попыток доступа к общим папкам регистрируются Amazon FSx.

  • SUCCESS_ONLY - регистрируются только успешные попытки доступа к общим папкам.
  • FAILURE_ONLY - регистрируются только неудачные попытки доступа к общим папкам.
  • SUCCESS_AND_FAILURE - регистрируются как успешные, так и неудачные попытки доступа к общим папкам.
  • DISABLED - аудит доступа к общим папкам выключен.

AuditLogDestination -> (строка)

Amazon Resource Name (ARN) для назначения журналов аудита. Назначение может быть любой группой журналов Amazon CloudWatch Logs или потоком доставки Amazon Kinesis Data Firehose.

Имя группы журналов Amazon CloudWatch Logs должно начинаться с префикса /aws/fsx. Имя потока доставки Amazon Kinesis Data Firehose должно начинаться с префикса aws-fsx.

ARN назначения (группы журналов CloudWatch Logs или потока доставки Kinesis Data Firehose) должен находиться в той же области Amazon Web Services, регионе Amazon Web Services и аккаунте Amazon Web Services, что и ваша файловая система Amazon FSx.

DiskIopsConfiguration -> (структура)

Настройка IOPS (операций ввода/вывода в секунду) SSD для файловой системы Amazon FSx для Windows. По умолчанию Amazon FSx автоматически выделяет 3 IOPS на 1 ГБ объёма хранилища. Вы можете выделить дополнительные IOPS на 1 ГБ хранилища, до максимального предела, связанного с выбранной пропускной способностью.

Mode -> (строка)

Указывает, использует ли файловая система настройку AUTOMATIC IOPS SSD в 3 IOPS на ГБ объёма хранилища, или использует значение USER_PROVISIONED.

Iops -> (целое число большого размера)

Общее количество выделенных IOPS SSD для файловой системы.

Минимальные и максимальные значения для этого свойства зависят от значений HAPairs и StorageCapacity. Минимальное значение рассчитывается как StorageCapacity * 3 * HAPairs (3 IOPS на ГБ объёма StorageCapacity). Максимальное значение рассчитывается как 200 000 * HAPairs.

Amazon FSx возвращает HTTP-код состояния 400 (Неверный запрос), если значение Iops находится вне минимального или максимального значений.

LustreConfiguration -> (структура)

Конфигурация файловой системы Amazon FSx для Lustre.

WeeklyMaintenanceStartTime -> (строка)

Предпочтительное время выполнения еженедельного обслуживания, отформатированное как d:HH:MM в часовом поясе UTC. Здесь, d — номер дня недели от 1 до 7, начиная с понедельника и заканчивая воскресеньем.

DataRepositoryConfiguration -> (структура)

Объект конфигурации хранилища данных для файловых систем Lustre, возвращаемый в ответе операции CreateFileSystem.

Этот тип данных не поддерживается для файловых систем с ассоциацией хранилища данных. Для файловых систем с ассоциацией хранилища данных см. .

Lifecycle -> (строка)

Описывает состояние хранилища долговременных данных S3 файловой системы, если оно настроено с хранилищем S3. Жизненный цикл может иметь следующие значения:

  • CREATING — конфигурация хранилища данных между файловой системой FSx и связанным хранилищем данных S3 создается. Хранилище данных недоступно.
  • AVAILABLE — хранилище данных доступно для использования.
  • MISCONFIGURED — Amazon FSx не может автоматически импортировать обновления из ведра S3, пока не будет исправлена конфигурация хранилища данных. Дополнительную информацию см. в разделе Устранение неполадок с неправильно настроенным связанным ведром S3.
  • UPDATING — хранилище данных проходит обновление, инициированное пользователем, и доступность может быть затронута.
  • FAILED — хранилище данных находится в терминальном состоянии, из которого нельзя восстановиться.

ImportPath -> (строка)

Путь импорта к ведру Amazon S3 (и необязательному префиксу), используемому вами в качестве хранилища данных для файловой системы FSx для Lustre, например s3://import-bucket/optional-prefix . Если после имени ведра Amazon S3 указан префикс, в файловую систему загружаются только ключи объектов с этим префиксом.

ExportPath -> (строка)

Путь экспорта к ведру Amazon S3 (и префиксу), которое вы используете для хранения новых и измененных файлов файловой системы Lustre в S3.

ImportedFileChunkSize -> (целое число)

Для файлов, импортированных из хранилища данных, это значение определяет количество полос и максимальный объем данных на файл (в МБ) в хранилище на одном физическом диске. Максимальное количество дисков, на которые может быть распределен один файл, ограничено общим количеством дисков, составляющих файловую систему.

Размер фрагмента по умолчанию составляет 1024 МБ (1 ГБ) и может достигать 512 000 МБ (500 ГБ). Объекты Amazon S3 имеют максимальный размер 5 ТБ.

AutoImportPolicy -> (строка)

Описывает связанное хранилище данных S3 файловой системы AutoImportPolicy. Политика AutoImport определяет, как Amazon FSx поддерживает актуальность списков файлов и каталогов по мере добавления или изменения объектов в связанном ведре S3. AutoImportPolicy может иметь следующие значения:

  • NONE — (По умолчанию) Автоимпорт выключен. Amazon FSx обновляет списки файлов и каталогов из связанного ведра S3 только при создании файловой системы. После выбора этого параметра FSx не обновляет списки файлов и каталогов для новых или измененных объектов.
  • NEW — Автоимпорт включен. Amazon FSx автоматически импортирует списки каталогов любых новых объектов, добавленных в связанное ведро S3, которые в настоящее время отсутствуют в файловой системе FSx.
  • NEW_CHANGED — Автоимпорт включен. Amazon FSx автоматически импортирует списки файлов и каталогов любых новых объектов, добавленных в ведро S3, и любых существующих объектов, измененных в ведре S3, после выбора этого параметра.
  • NEW_CHANGED_DELETED — Автоимпорт включен. Amazon FSx автоматически импортирует списки файлов и каталогов любых новых объектов, добавленных в ведро S3, любых существующих объектов, измененных в ведре S3, и любых объектов, удаленных из ведра S3.

FailureDetails -> (структура)

Предоставляет подробную информацию о хранилище данных, если его Lifecycle установлено в MISCONFIGURED или FAILED.

Message -> (строка)

Подробное сообщение об ошибке.

DeploymentType -> (строка)

Тип развертывания файловой системы FSx для Lustre. Тип развертывания Scratch предназначен для временного хранения и краткосрочной обработки данных.

SCRATCH_1 и SCRATCH_2 типы развертывания лучше всего подходят, когда вам нужно временное хранилище и краткосрочная обработка данных. Тип развертывания SCRATCH_2 обеспечивает шифрование данных в процессе передачи и более высокую пропускную способность при пиковых нагрузках по сравнению с SCRATCH_1.

Тип развертывания PERSISTENT_1 и PERSISTENT_2 используется для долгосрочного хранения и рабочих нагрузок и шифрования данных в процессе передачи. PERSISTENT_2 обеспечивает более высокую PerUnitStorageThroughput (до 1000 МБ/с/ТБ) наряду с более низким минимальным объемом памяти (600 ГБ). Дополнительную информацию о типах развертывания FSx для Lustre см. в разделе Варианты развертывания FSx для Lustre.

По умолчанию — SCRATCH_1.

PerUnitStorageThroughput -> (целое число)

Пропускная способность хранения на единицу измерения представляет собой мегабайты в секунду пропускной способности чтения или записи на 1 тебибайт предоставленного хранилища. Пропускная способность файловой системы равна объему хранилища (ТБ) * PerUnitStorageThroughput (МБ/с/ТБ). Этот параметр действителен только для типов развертывания PERSISTENT_1 и PERSISTENT_2.

Допустимые значения:

  • Для SSD-хранилища PERSISTENT_1: 50, 100, 200.
  • Для HDD-хранилища PERSISTENT_1: 12, 40.
  • Для SSD-хранилища PERSISTENT_2: 125, 250, 500, 1000.

MountName -> (строка)

Вы используете значение MountName при подключении файловой системы.

Для типа развертывания SCRATCH_1 это значение всегда «fsx». Для типов развертывания SCRATCH_2, PERSISTENT_1 и PERSISTENT_2 это значение является строкой, уникальной в данном регионе Amazon Web Services.

DailyAutomaticBackupStartTime -> (строка)

Ежедневное повторяющееся время в формате HH:MM. HH — нулевое заполнение часа (0-23), а MM — нулевое заполнение минуты. Например, 05:00 указывает 5:00 ежедневно.

AutomaticBackupRetentionDays -> (целое число)

Количество дней для хранения автоматических резервных копий. Установка этого свойства в 0 отключает автоматические резервные копии. Вы можете хранить автоматические резервные копии не более 90 дней. По умолчанию — 30.

CopyTagsToBackups -> (булево)

Флаг булевого типа, указывающий, копируются ли метки файловой системы в резервные копии. Если он установлен в true, все метки файловой системы копируются во все автоматические резервные копии и в любые инициированные пользователем резервные копии, где пользователь не указывает метки. Если это значение равно true, и вы указываете одну или несколько меток, копируются только указанные метки. Если вы указываете одну или несколько меток при создании резервной копии, инициированной пользователем, метки не копируются из файловой системы независимо от этого значения. (По умолчанию = false)

DriveCacheType -> (строка)

Тип кэша диска, используемого файловыми системами PERSISTENT_1, которые провайзируются с устройствами хранения HDD. Этот параметр необходим, когда StorageType — HDD. При установке в READ файловая система имеет кэш SSD-хранилища, размер которого составляет 20% от емкости хранилища файловой системы. Это улучшает производительность для часто используемых файлов, кэшируя до 20% от общего объема хранилища.

Этот параметр необходим, когда StorageType установлено в HDD.

DataCompressionType -> (строка)

Конфигурация сжатия данных для файловой системы. DataCompressionType может иметь следующие значения:

  • NONE — Сжатие данных выключено для файловой системы.
  • LZ4 — Сжатие данных включено с алгоритмом LZ4.

Дополнительную информацию см. в разделе Сжатие данных Lustre.

LogConfiguration -> (структура)

Конфигурация ведения журнала Lustre. Ведение журнала Lustre записывает включенные события журнала для вашей файловой системы в Amazon CloudWatch Logs.

Level -> (строка)

События хранилища данных, которые регистрируются Amazon FSx.

  • WARN_ONLY — регистрируются только предупреждения.
  • ERROR_ONLY — регистрируются только ошибки.
  • WARN_ERROR — регистрируются как предупреждения, так и ошибки.
  • DISABLED — ведение журнала событий хранилища данных отключено.

Обратите внимание, что Amazon File Cache использует значение по умолчанию WARN_ERROR, которое изменить нельзя.

Destination -> (строка)

Идентификатор ресурса Amazon (ARN), который указывает место назначения журналов. Место назначения может быть любым ARN группы журналов Amazon CloudWatch Logs. ARN места назначения должен находиться в том же разделе Amazon Web Services, том же регионе Amazon Web Services и том же аккаунте Amazon Web Services, что и ваша файловая система Amazon FSx.

RootSquashConfiguration -> (структура)

Конфигурация сжатия корневого пользователя Lustre для файловой системы Amazon FSx для Lustre. При включении сжатия корневого пользователя ограничивается доступ на уровне root от клиентов, пытающихся получить доступ к файловой системе в качестве root-пользователя.

RootSquash -> (строка)

Вы включаете сжатие корневого пользователя, установив идентификатор пользователя (UID) и идентификатор группы (GID) для файловой системы в формате UID:GID (например, 365534:65534). Значения UID и GID могут изменяться от 0 до 4294967294:

  • Не нулевое значение для UID и GID включает сжатие корневого пользователя. Значения UID и GID могут быть разными, но каждое должно быть отличным от нуля.
  • Значение 0 (ноль) для UID и GID указывает на root и, следовательно, отключает сжатие корневого пользователя.

При включенном сжатии корневого пользователя идентификатор пользователя и идентификатор группы root-пользователя, получающего доступ к файловой системе, переназначаются на предоставленные вами UID и GID.

NoSquashNids -> (список)

При включенном сжатии корневого пользователя вы можете дополнительно указать массив NID клиентов, для которых сжатие корневого пользователя не применяется. NID клиента — это идентификатор сети Lustre, используемый для уникальной идентификации клиента. Вы можете указать NID как один адрес или диапазон адресов:

  • Один адрес описывается в стандартном формате NID Lustre, указанием IP-адреса клиента и идентификатора сети Lustre (например, 10.0.1.6@tcp).
  • Диапазон адресов описывается с использованием дефиса для разделения диапазона (например, 10.0.[2-10].[1-255]@tcp).

(строка)

MetadataConfiguration -> (структура)

Настройка производительности метаданных Lustre для файловой системы Amazon FSx для Lustre с типом развертывания PERSISTENT_2.

Iops -> (целое число)

Количество метаданных IOPS, выделенных для файловой системы. Допустимые значения — 1500 , 3000 , 6000 , 12000 и кратные 12000 значения до максимального значения 192000.

Mode -> (строка)

Режим конфигурации метаданных для выделения метаданных IOPS для файловой системы.

  • В режиме AUTOMATIC, FSx для Lustre автоматически выделяет и масштабирует количество метаданных IOPS для вашей файловой системы на основе емкости хранилища вашей файловой системы.
  • В режиме USER_PROVISIONED, вы можете указать количество метаданных IOPS для выделения вашей файловой системе.

EfaEnabled -> (булево)

Указывает, включена ли поддержка Elastic Fabric Adapter (EFA) и GPUDirect Storage (GDS) для файловой системы Amazon FSx для Lustre.

OntapConfiguration -> (структура)

Конфигурация для этой файловой системы Amazon FSx для NetApp ONTAP.

AutomaticBackupRetentionDays -> (целое число)

Количество дней, в течение которых сохраняются автоматические резервные копии. Установка этого свойства на значение 0 отключает автоматические резервные копии. Вы можете сохранять автоматические резервные копии в течение максимум 90 дней. По умолчанию — 30.

DailyAutomaticBackupStartTime -> (строка)

Ежедневное повторяющееся время в формате HH:MM. HH — отформатированное по нулям значение часа (0-23), MM — отформатированное по нулям значение минуты. Например, 05:00 — 5:00 ежедневно.

DeploymentType -> (строка)

Указывает тип развертывания файловой системы FSx для ONTAP, используемый в файловой системе.

  • MULTI_AZ_1 — файловая система с высокой доступностью, настроенная для избыточности Multi-AZ, чтобы выдерживать временную недоступность зоны доступности (AZ). Это файловая система первого поколения FSx для ONTAP.
  • MULTI_AZ_2 — файловая система с высокой доступностью, настроенная для избыточности Multi-AZ, чтобы выдерживать временную недоступность AZ. Это файловая система второго поколения FSx для ONTAP.
  • SINGLE_AZ_1 — файловая система, настроенная для избыточности Single-AZ. Это файловая система первого поколения FSx для ONTAP.
  • SINGLE_AZ_2 — файловая система, настроенная с несколькими парами высокой доступности (HA) для избыточности Single-AZ. Это файловая система второго поколения FSx для ONTAP.

Дополнительную информацию об использовании развертываний Multi-AZ и Single-AZ см. в разделе Выбор развертывания файловой системы Multi-AZ или Single-AZ.

EndpointIpAddressRange -> (строка)

(Только Multi-AZ) Указывает диапазон IP-адресов, в котором будут созданы конечные точки для доступа к вашей файловой системе. По умолчанию в Amazon FSx API Amazon FSx выбирает для вас неиспользуемый диапазон IP-адресов из диапазона 198.19.*. По умолчанию в консоли Amazon FSx Amazon FSx выбирает последние 64 IP-адреса из основного диапазона CIDR VPC для использования в качестве диапазона IP-адресов конечной точки файловой системы. Вы можете иметь перекрывающиеся IP-адреса конечных точек для файловых систем, развернутых в одной VPC/таблицах маршрутизации.

Endpoints -> (структура)

Конечные точки Management и Intercluster, используемые для доступа к данным или для управления файловой системой с помощью NetApp ONTAP CLI, REST API или NetApp SnapMirror.

Intercluster -> (структура)

Конечная точка для управления вашей файловой системой путем настройки NetApp SnapMirror с другими системами ONTAP.

DNSName -> (строка)

Имя DNS файловой системы. Вы можете подключиться к файловой системе, используя ее имя DNS.

IpAddresses -> (список)

IP-адреса конечной точки файловой системы.

(строка)

Management -> (структура)

Конечная точка для управления файловой системой с помощью NetApp ONTAP CLI и NetApp ONTAP API.

DNSName -> (строка)

Имя DNS файловой системы. Вы можете подключиться к файловой системе, используя ее имя DNS.

IpAddresses -> (список)

IP-адреса конечной точки файловой системы.

(строка)

DiskIopsConfiguration -> (структура)

Конфигурация SSD IOPS для файловой системы ONTAP, определяющая количество выделенных IOPS и режим выделения.

Mode -> (строка)

Указывает, использует ли файловая система значение AUTOMATIC SSD IOPS в 3 IOPS на ГБ емкости хранилища или использует значение USER_PROVISIONED.

Iops -> (длинное целое число)

Общее количество SSD IOPS, выделенных для файловой системы.

Минимальные и максимальные значения для этого свойства зависят от значений HAPairs и StorageCapacity. Минимальное значение вычисляется как StorageCapacity * 3 * HAPairs (3 IOPS на ГБ емкости StorageCapacity). Максимальное значение вычисляется как 200000 * HAPairs.

Amazon FSx возвращает код состояния HTTP 400 (Ошибка запроса), если значение Iops находится за пределами минимальных или максимальных значений.

PreferredSubnetId -> (строка)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашей виртуальной частной сети (VPC). Дополнительную информацию см. в разделе VPC и подсети в Руководстве пользователя Amazon VPC.

RouteTableIds -> (список)

(Только Multi-AZ) Таблицы маршрутизации VPC, в которых создаются конечные точки вашей файловой системы.

(строка)

ThroughputCapacity -> (целое число)

Непрерывный пропускная способность файловой системы Amazon FSx в мегабайтах в секунду (МБ/с).

WeeklyMaintenanceStartTime -> (строка)

Еженедельное повторяющееся время в формате D:HH:MM.

D — день недели, где 1 — понедельник, а 7 — воскресенье. Дополнительные сведения см. в спецификации ISO-8601, описанной в Википедии.

HH — отформатированное по нулям значение часа (0-23), MM — отформатированное по нулям значение минуты.

Например, 1:05:00 указывает обслуживание в 5:00 понедельника.

FsxAdminPassword -> (строка)

Вы можете использовать учетную запись пользователя fsxadmin для доступа к NetApp ONTAP CLI и REST API. Значение пароля всегда скрывается в ответе.

HAPairs -> (целое число)

Указывает количество пар серверов высокой доступности (HA), которые будет иметь файловая система. Значение по умолчанию — 1. Это свойство влияет на значения StorageCapacity , Iops и ThroughputCapacity. Дополнительную информацию см. в руководстве пользователя FSx для ONTAP в разделе «Пары высокой доступности (HA)».

Amazon FSx возвращает код состояния HTTP 400 (Ошибка запроса) в следующих случаях:

  • Значение HAPairs меньше 1 или больше 12.
  • Значение HAPairs больше 1, а значение DeploymentType — SINGLE_AZ_1 , MULTI_AZ_1 или MULTI_AZ_2.

ThroughputCapacityPerHAPair -> (целое число)

Используйте для выбора пропускной способности на пару высокой доступности. Когда значение HAPairs равно 1, значение ThroughputCapacityPerHAPair — это общая пропускная способность для файловой системы.

Это поле и ThroughputCapacity не могут быть определены в одном запросе API, но одно из них обязательно.

Это поле и ThroughputCapacity одинаковы для файловых систем с одной парой высокой доступности.

  • Для файловых систем SINGLE_AZ_1 и MULTI_AZ_1 допустимые значения — 128, 256, 512, 1024, 2048 или 4096 МБ/с.
  • Для SINGLE_AZ_2 допустимые значения — 1536, 3072 или 6144 МБ/с.
  • Для MULTI_AZ_2 допустимые значения — 384, 768, 1536, 3072 или 6144 МБ/с.

Amazon FSx возвращает код состояния HTTP 400 (Ошибка запроса) в следующих случаях:

  • Значения ThroughputCapacity и ThroughputCapacityPerHAPair не совпадают.
  • Значение типа развертывания — SINGLE_AZ_2, а ThroughputCapacity/ThroughputCapacityPerHAPair не является допустимой парой высокой доступности (значение от 1 до 12).
  • Значение ThroughputCapacityPerHAPair не является допустимым значением.

FileSystemTypeVersion -> (строка)

Версия Lustre файловой системы Amazon FSx для Lustre, которая может быть 2.10 , 2.12 или 2.15.

OpenZFSConfiguration -> (структура)

Конфигурация файловой системы Amazon FSx for OpenZFS.

AutomaticBackupRetentionDays -> (целое число)

Количество дней хранения автоматических резервных копий. Установка этого свойства в значение 0 отключает автоматические резервные копии. Вы можете хранить автоматические резервные копии не более 90 дней. По умолчанию значение равно 30 .

CopyTagsToBackups -> (булево)

Булево значение, указывающее, следует ли копировать теги файловой системы в резервные копии. Если оно установлено в значение true , все теги файловой системы копируются во все автоматические резервные копии и все резервные копии, инициированные пользователем, где пользователь не указывает теги. Если это значение равно true , и вы указываете один или несколько тегов, только указанные теги копируются в резервные копии. Если вы указываете один или несколько тегов при создании резервной копии, инициированной пользователем, теги не копируются из файловой системы, независимо от этого значения.

CopyTagsToVolumes -> (булево)

Булево значение, указывающее, следует ли копировать теги тома в снимки. По умолчанию это значение равно false . Если оно установлено в значение true , все теги тома копируются в снимки, где пользователь не указывает теги. Если это значение равно true , и вы указываете один или несколько тегов, только указанные теги копируются в снимки. Если вы указываете один или несколько тегов при создании снимка, теги не копируются из тома, независимо от этого значения.

DailyAutomaticBackupStartTime -> (строка)

Ежедневное время, в формате HH:MM . HH — это заполненное нулями значение часа (0-23), а MM — это заполненное нулями значение минуты. Например, 05:00 — это 5 часов утра ежедневно.

DeploymentType -> (строка)

Указывает тип развертывания файловой системы. Amazon FSx for OpenZFS поддерживает MULTI_AZ_1 , SINGLE_AZ_HA_2 , SINGLE_AZ_HA_1 , SINGLE_AZ_2 и SINGLE_AZ_1 .

ThroughputCapacity -> (целое число)

Пропускная способность файловой системы Amazon FSx, измеряемая в мегабайтах в секунду (МБ/с).

WeeklyMaintenanceStartTime -> (строка)

Еженедельное время, в формате D:HH:MM .

D — это день недели, где 1 — понедельник, а 7 — воскресенье. Для получения дополнительной информации см. спецификацию ISO-8601 на Википедии.

HH — это заполненное нулями значение часа (0-23), а MM — это заполненное нулями значение минуты.

Например, 1:05:00 указывает техническое обслуживание в 5 часов утра понедельника.

DiskIopsConfiguration -> (структура)

Конфигурация SSD IOPS (операций ввода/вывода в секунду) для файловой системы Amazon FSx for NetApp ONTAP, Amazon FSx for Windows File Server или FSx for OpenZFS. По умолчанию Amazon FSx автоматически выделяет 3 IOPS на каждый ГБ емкости хранилища. Вы можете выделить дополнительные IOPS на каждый ГБ емкости хранилища. Конфигурация состоит из общего количества выделенных SSD IOPS и способа их выделения, или режима (клиентом или Amazon FSx).

Mode -> (строка)

Указывает, использует ли файловая система значение AUTOMATIC SSD IOPS в 3 IOPS на каждый ГБ емкости хранилища или использует значение USER_PROVISIONED .

Iops -> (длинное целое число)

Общее количество выделенных SSD IOPS для файловой системы.

Минимальное и максимальное значения для этого свойства зависят от значений HAPairs и StorageCapacity . Минимальное значение вычисляется как StorageCapacity * 3 * HAPairs (3 IOPS на каждый ГБ StorageCapacity ). Максимальное значение вычисляется как 200 000 * HAPairs .

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса), если значение Iops выходит за пределы минимального или максимального значения.

RootVolumeId -> (строка)

Идентификатор корневого тома файловой системы OpenZFS.

PreferredSubnetId -> (строка)

Требуется, когда DeploymentType установлено в значение MULTI_AZ_1 . Это указывает подсеть, в которой вы хотите расположить предпочтительный файловый сервер.

EndpointIpAddressRange -> (строка)

(Только для Multi-AZ) Указывает диапазон IP-адресов, в котором будут созданы конечные точки для доступа к вашей файловой системе. По умолчанию в API Amazon FSx и консоли Amazon FSx Amazon FSx выбирает для вас доступный диапазон IP-адресов /28 из одного из диапазонов CIDR VPC. Вы можете иметь перекрывающиеся IP-адреса конечных точек для файловых систем, развернутых в одной VPC/таблицах маршрутизации.

RouteTableIds -> (список)

(Только для Multi-AZ) Таблицы маршрутизации VPC, в которых создаются конечные точки вашей файловой системы.

(строка)

EndpointIpAddress -> (строка)

IP-адрес конечной точки, используемой для доступа к данным или управления файловой системой.

ReadCacheConfiguration -> (структура)

Требуется, когда StorageType установлено в значение INTELLIGENT_TIERING . Указывает необязательный выделенный SSD кэш чтения.

SizingMode -> (строка)

Указывает, как определяется размер выделенного SSD кэша чтения следующим образом:

  • Установите значение NO_CACHE, если вы не хотите использовать SSD кэш чтения с файловой системой Intelligent-Tiering.
  • Установите значение USER_PROVISIONED, чтобы указать точный размер вашего SSD кэша чтения.
  • Установите значение PROPORTIONAL_TO_THROUGHPUT_CAPACITY, чтобы ваш SSD кэш чтения автоматически подстраивался под вашу пропускную способность.

SizeGiB -> (целое число)

Требуется, если SizingMode установлено в значение USER_PROVISIONED . Указывает размер SSD кэша чтения файловой системы в гигабайтах (GiB).

FailureDetails -> (структура)

Предоставляет информацию о неудачном административном действии.

Message -> (строка)

Сообщение об ошибке, предоставляющее подробности о неудачном административном действии.

TargetVolumeValues -> (структура)

Описание тома Amazon FSx.

CreationTime -> (отметка времени)

Время создания ресурса в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

FileSystemId -> (строка)

Глобально уникальный идентификатор файловой системы, назначенный Amazon FSx.

Lifecycle -> (строка)

Статус жизненного цикла тома.

  • AVAILABLE - Том полностью готов к использованию.
  • CREATED - Том был создан.
  • CREATING - Amazon FSx создает новый том.
  • DELETING - Amazon FSx удаляет существующий том.
  • FAILED - Amazon FSx не смог создать том.
  • MISCONFIGURED - Том находится в состоянии сбоя, но подлежит восстановлению.
  • PENDING - Amazon FSx еще не начал создание тома.

Name -> (строка)

Название тома.

OntapConfiguration -> (структура)

Конфигурация тома Amazon FSx для NetApp ONTAP.

FlexCacheEndpointType -> (строка)

Указывает тип конечной точки FlexCache для тома. Допустимые значения:

  • NONE указывает, что у тома нет конфигурации FlexCache. NONE — значение по умолчанию.
  • ORIGIN указывает, что том является исходным томом для тома FlexCache.
  • CACHE указывает, что том является томом FlexCache.

JunctionPath -> (строка)

Указывает каталог, который клиенты NAS используют для подключения к тому, наряду с именем домена системы доменных имен (DNS) или IP-адресом виртуальной машины хранения (SVM). Вы можете создать JunctionPath непосредственно ниже узла соединения родительского тома или в каталоге внутри тома. JunctionPath для тома с именем vol3 может быть /vol1/vol2/vol3 или /vol1/dir2/vol3, или даже /dir1/dir2/vol3.

SecurityStyle -> (строка)

Стиль безопасности для тома, который может быть UNIX, NTFS или MIXED.

SizeInMegabytes -> (целое число)

Настроенный размер тома в мегабайтах (МБ).

StorageEfficiencyEnabled -> (булево)

Настройка эффективности хранения тома.

StorageVirtualMachineId -> (строка)

Идентификатор виртуальной машины хранения тома.

StorageVirtualMachineRoot -> (булево)

Логический флаг, указывающий, является ли данный том корневым томом для его виртуальной машины хранения (SVM). Только один том на SVM может быть корневым. По умолчанию это значение равно false. Если это значение равно true, то это корневой том SVM.

Этот флаг полезен при удалении SVM, поскольку необходимо сначала удалить все некорневые тома. Этот флаг, установленный в значение false, помогает определить, какие тома необходимо удалить, прежде чем удалять SVM.

TieringPolicy -> (структура)

Настройка TieringPolicy тома.

CoolingPeriod -> (целое число)

Указывает количество дней, в течение которых данные пользователя в томе должны оставаться неактивными, прежде чем они считаются «холодными» и перемещаются в пул емкости. Используется с политиками тиеринга AUTO и SNAPSHOT_ONLY. Введите целое число от 2 до 183. Значения по умолчанию составляют 31 день для AUTO и 2 дня для SNAPSHOT_ONLY.

Name -> (строка)

Указывает политику тиеринга, используемую для перевода данных. Значение по умолчанию — SNAPSHOT_ONLY.

  • SNAPSHOT_ONLY - перемещает холодные снимки в хранилище пула емкости.
  • AUTO - перемещает холодные данные пользователей и снимки в хранилище пула емкости на основе ваших шаблонов доступа.
  • ALL - перемещает все блоки данных пользователей как в активной файловой системе, так и в копиях снимков в хранилище пула.
  • NONE - сохраняет данные тома в первичном хранилище, предотвращая их перемещение в хранилище пула емкости.

UUID -> (строка)

Универсальный уникальный идентификатор (UUID) тома.

OntapVolumeType -> (строка)

Указывает тип тома. Допустимые значения:

  • RW указывает том для чтения/записи. RW — значение по умолчанию.
  • DP указывает том для защиты данных. Вы можете защищать данные, дублируя их в зеркальных копиях для защиты данных. При возникновении аварий вы можете восстановить данные с помощью этих зеркальных копий для защиты данных.
  • LS указывает том для распределения нагрузки зеркал. Зеркало для распределения нагрузки уменьшает сетевой трафик для тома FlexVol, предоставляя клиентам дополнительный доступ для чтения только.

SnapshotPolicy -> (строка)

Указывает политику создания снимков для тома. Существует три встроенные политики создания снимков:

  • default : Это политика по умолчанию. Максимальное количество ежечасных снимков — шесть, сделанных через пять минут после часа. Максимальное количество ежедневных снимков — два, сделанных с понедельника по субботу в 10 минут после полуночи. Максимальное количество еженедельных снимков — два, сделанных каждую воскресенье в 15 минут после полуночи.
  • default-1weekly : Эта политика такая же, как и политика default, за исключением того, что она сохраняет только один снимок из еженедельного расписания.
  • none : Эта политика не создает никаких снимков. Эта политика может быть назначена томам, чтобы предотвратить автоматическое создание снимков.

Вы также можете указать имя настраиваемой политики, созданной с помощью ONTAP CLI или REST API.

Дополнительную информацию см. в руководстве пользователя Amazon FSx для NetApp ONTAP в разделе Политики создания снимков.

CopyTagsToBackups -> (булево)

Логический флаг, указывающий, следует ли копировать метки тома в резервные копии. По умолчанию это значение равно false. Если оно установлено в значение true, все метки тома копируются во все автоматические и инициированные пользователем резервные копии, где пользователь не указывает метки. Если это значение равно true, и вы укажете одну или несколько меток, копируются только указанные метки. Если вы укажете одну или несколько меток при создании резервной копии, инициированной пользователем, метки не копируются из тома независимо от этого значения.

SnaplockConfiguration -> (структура)

Объект конфигурации SnapLock для тома SnapLock FSx for ONTAP.

AuditLogVolume -> (boolean)

Включает или отключает том журнала аудита для тома SnapLock FSx for ONTAP. Значение по умолчанию — false. Если вы установите AuditLogVolume в значение true, том SnapLock создается как том журнала аудита. Минимальный срок хранения для тома журнала аудита составляет шесть месяцев.

Для получения дополнительной информации см. Тома журнала аудита SnapLock.

AutocommitPeriod -> (структура)

Объект конфигурации для установки периода автоматического подтверждения файлов в томе SnapLock FSx for ONTAP.

Type -> (строка)

Определяет тип времени для периода автоматического подтверждения файла в томе SnapLock FSx for ONTAP. Установка этого значения в NONE отключает автоматическое подтверждение. Значение по умолчанию — NONE.

Value -> (целое число)

Определяет количество времени для периода автоматического подтверждения файла в томе SnapLock FSx for ONTAP. Следующие диапазоны допустимы:

  • Minutes : 5 - 65 535
  • Hours : 1 - 65 535
  • Days : 1 - 3 650
  • Months : 1 - 120
  • Years : 1 - 10

PrivilegedDelete -> (строка)

Включает, отключает или постоянно отключает привилегированное удаление в корпоративном томе SnapLock FSx for ONTAP. Включение привилегированного удаления позволяет администраторам SnapLock удалять файлы с режимом «запись один раз, чтение многократно» (WORM), даже если у них активны периоды хранения. PERMANENTLY_DISABLED является конечным состоянием. Если привилегированное удаление постоянно отключено в томе SnapLock, его нельзя снова включить. Значение по умолчанию — DISABLED.

Для получения дополнительной информации см. Привилегированное удаление.

RetentionPeriod -> (структура)

Указывает период хранения тома SnapLock FSx for ONTAP.

DefaultRetention -> (структура)

Период хранения, назначаемый файлу с режимом «запись один раз, чтение многократно» (WORM) по умолчанию, если для тома SnapLock FSx for ONTAP не установлен явный период хранения. Период хранения по умолчанию должен быть больше или равен минимальному периоду хранения и меньше или равен максимальному периоду хранения.

Type -> (строка)

Определяет тип времени для периода хранения тома SnapLock FSx for ONTAP. Установите одно из допустимых значений. Если вы установите INFINITE, файлы хранятся вечно. Если вы установите UNSPECIFIED, файлы хранятся до тех пор, пока вы не установите явный период хранения.

Value -> (целое число)

Определяет количество времени для периода хранения тома SnapLock FSx for ONTAP. Вы не можете установить значение для INFINITE или UNSPECIFIED. Для всех остальных вариантов следующие диапазоны допустимы:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

MinimumRetention -> (структура)

Наименьший период хранения, который можно назначить файлу WORM в томе SnapLock FSx for ONTAP.

Type -> (строка)

Определяет тип времени для периода хранения тома SnapLock FSx for ONTAP. Установите одно из допустимых значений. Если вы установите INFINITE, файлы хранятся вечно. Если вы установите UNSPECIFIED, файлы хранятся до тех пор, пока вы не установите явный период хранения.

Value -> (целое число)

Определяет количество времени для периода хранения тома SnapLock FSx for ONTAP. Вы не можете установить значение для INFINITE или UNSPECIFIED. Для всех остальных вариантов следующие диапазоны допустимы:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

MaximumRetention -> (структура)

Наибольший период хранения, который можно назначить файлу WORM в томе SnapLock FSx for ONTAP.

Type -> (строка)

Определяет тип времени для периода хранения тома SnapLock FSx for ONTAP. Установите одно из допустимых значений. Если вы установите INFINITE, файлы хранятся вечно. Если вы установите UNSPECIFIED, файлы хранятся до тех пор, пока вы не установите явный период хранения.

Value -> (целое число)

Определяет количество времени для периода хранения тома SnapLock FSx for ONTAP. Вы не можете установить значение для INFINITE или UNSPECIFIED. Для всех остальных вариантов следующие диапазоны допустимы:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

SnaplockType -> (строка)

Указывает режим хранения тома SnapLock FSx for ONTAP. После установки его изменить нельзя. Вы можете выбрать один из следующих режимов хранения:

  • COMPLIANCE : Файлы, переведенные в режим «запись один раз, чтение многократно» (WORM) в томе «Соответствие», нельзя удалять до истечения срока их хранения. Этот режим хранения используется для соблюдения правительственных или отраслевых требований или защиты от атак программ-вымогателей. Для получения дополнительной информации см. SnapLock Соответствие.
  • ENTERPRISE : Файлы, переведенные в режим WORM в корпоративном томе, могут быть удалены авторизованными пользователями до истечения срока их хранения с помощью привилегированного удаления. Этот режим хранения используется для повышения целостности данных организации и соблюдения внутренних требований или для тестирования настроек хранения перед использованием SnapLock Соответствие. Для получения дополнительной информации см. SnapLock Корпоративный.

VolumeAppendModeEnabled -> (boolean)

Включает или отключает режим добавления тома в томе SnapLock FSx for ONTAP. Режим добавления тома позволяет создавать файлы, к которым можно добавлять данные по частям, и добавлять данные к ним постепенно. Значение по умолчанию — false.

Для получения дополнительной информации см. Режим добавления тома.

VolumeStyle -> (строка)

Используется для указания стиля тома ONTAP. Дополнительную информацию о FlexVols и FlexGroups см. в руководстве пользователя Amazon FSx for NetApp ONTAP в разделе Типы томов.

AggregateConfiguration -> (структура)

Эта структура задает параметры конфигурации для хранилища агрегатов или агрегатов тома.

Aggregates -> (список)

Список агрегатов, на которых находится этот том. Агрегаты — это хранилища, составляющие ваш основной уровень хранения. Каждая пара высокой доступности (HA) имеет один агрегат. Названия агрегатов соответствуют именам агрегатов в ONTAP CLI и REST API. Для FlexVols всегда будет одна запись.

Amazon FSx возвращает код состояния HTTP 400 (Неверный запрос) при следующих условиях:

  • Строки в значении Aggregates не отформатированы как aggrX, где X — число от 1 до 12.
  • Значение Aggregates содержит агрегаты, которых нет.
  • Один или несколько предоставленных агрегатов слишком близки к лимиту тома, чтобы поддерживать добавление дополнительных томов.

(строка)

TotalConstituents -> (целое число)

Общее количество составляющих этого тома FlexGroup. Неприменимо для FlexVols.

SizeInBytes -> (длинное целое)

Настроенный размер тома в байтах.

ResourceARN -> (строка)

Amazon Resource Name (ARN) для данного ресурса. ARN уникально идентифицируют ресурсы Amazon Web Services. Мы требуем ARN, когда вам необходимо однозначно указать ресурс во всех сервисах Amazon Web Services. Дополнительную информацию см. в разделе Amazon Resource Names (ARN) в Справочнике Amazon Web Services.

Tags -> (список)

Список значений Tag, максимальное количество элементов — 50.

(структура)

Указывает пару ключ-значение для метки ресурса.

Key -> (строка)

Значение, определяющее TagKey, имя метки. Ключи меток должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (строка)

Значение, определяющее TagValue, значение, присвоенное соответствующему ключу метки. Значения меток могут быть NULL и не обязательно должны быть уникальными в наборе меток. Например, в наборе меток вы можете иметь пару ключ-значение finances : April, а также пару payroll : April.

VolumeId -> (строка)

Сгенерированный системой уникальный идентификатор тома.

VolumeType -> (строка)

Тип тома.

LifecycleTransitionReason -> (структура)

Причина изменения статуса жизненного цикла тома.

Message -> (строка)

Подробное сообщение об ошибке.

OpenZFSConfiguration -> (структура)

Настройка тома Amazon FSx for OpenZFS.

ParentVolumeId -> (строка)

Идентификатор родительского тома.

VolumePath -> (строка)

Путь к тому от корневого тома. Например, fsx/parentVolume/volume1 .

StorageCapacityReservationGiB -> (целое число)

Объем резервируемого пространства в гибибайтах (GiB) из родительского тома. Вы не можете зарезервировать больше пространства, чем зарезервировано в родительском томе.

StorageCapacityQuotaGiB -> (целое число)

Максимальный объем пространства в гибибайтах (GiB), который может использовать том из родительского. Можно указать квоту, превышающую объем пространства на родительском томе.

RecordSizeKiB -> (целое число)

Размер записи тома OpenZFS в кибибайтах (KiB). Допустимые значения: 4, 8, 16, 32, 64, 128, 256, 512 или 1024 KiB. По умолчанию — 128 KiB. Большинству рабочих нагрузок подходит значение по умолчанию. Инструкции по настройке пользовательского размера записи см. в Руководстве пользователя Amazon FSx for OpenZFS.

DataCompressionType -> (строка)

Указывает метод сжатия данных в томе. Тип сжатия по умолчанию — NONE.

  • NONE - Данные в томе не сжимаются. NONE — значение по умолчанию.
  • ZSTD - Данные в томе сжимаются с использованием алгоритма сжатия Zstandard (ZSTD). По сравнению с LZ4, Z-Standard обеспечивает лучшее соотношение сжатия для минимизации использования дискового пространства.
  • LZ4 - Данные в томе сжимаются с использованием алгоритма сжатия LZ4. По сравнению с Z-Standard, LZ4 требует меньше вычислительных ресурсов и обеспечивает более высокую скорость записи.

CopyTagsToSnapshots -> (булево)

Булевое значение, указывающее, следует ли копировать метки тома в снимки. По умолчанию это значение равно false. Если оно установлено в true, все метки тома копируются в снимки, где пользователь не указывает метки. Если это значение true, и вы указываете одну или несколько меток, в снимки копируются только указанные метки. Если вы указываете одну или несколько меток при создании снимка, никакие метки не копируются из тома независимо от этого значения.

OriginSnapshot -> (структура)

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

SnapshotARN -> (строка)

Идентификатор ресурса Amazon (ARN) для заданного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. Мы требуем ARN, когда необходимо однозначно указать ресурс во всех службах Amazon Web Services. Дополнительную информацию см. в разделе Имена ресурсов Amazon (ARN) в Общей справке Amazon Web Services.

CopyStrategy -> (строка)

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

  • CLONE - Новый том ссылается на данные в исходном снимке. Клонирование снимка быстрее, чем копирование данных из снимка в новый том и не потребляет пропускную способность диска. Однако исходный снимок нельзя удалить, если его скопированные данные используются томом.
  • FULL_COPY - Копирует все данные из снимка в новый том.

Примечание

Вариант INCREMENTAL_COPY используется только для обновления существующего тома с помощью снимка из другой файловой системы FSx for OpenZFS. Дополнительную информацию см. в разделе CopySnapshotAndUpdateVolume.

ReadOnly -> (булево)

Булево значение, указывающее, является ли том только для чтения.

NfsExports -> (список)

Объект конфигурации для подключения файловой системы Network File System (NFS).

(структура)

Конфигурации Network File System (NFS) для подключения файловой системы Amazon FSx for OpenZFS.

ClientConfigurations -> (список)

Список объектов конфигурации, содержащих клиента и параметры для подключения файловой системы OpenZFS.

(структура)

Определяет, кто может подключиться к файловой системе OpenZFS и какие параметры доступны при подключении.

Clients -> (строка)

Значение, определяющее, кто может подключиться к файловой системе. Вы можете указать универсальный символ (*), IP-адрес (0.0.0.0) или адрес CIDR (192.0.2.0/24). По умолчанию Amazon FSx использует универсальный символ при указании клиента.

Options -> (список)

Параметры для использования при подключении к файловой системе. Список параметров, которые можно использовать с Network File System (NFS), см. в справке exports(5) - Linux man page . При выборе параметров следует учитывать следующее:

  • crossmnt используется по умолчанию. Если при изменении конфигурации клиента не указать crossmnt, вы не сможете увидеть или получить доступ к снимкам в каталоге снимков файловой системы.
  • sync используется по умолчанию. Если указать вместо этого async, система подтверждает записи перед записью на диск. Если система аварийно завершит работу, прежде чем записи будут завершены, несохраненные данные будут потеряны.

(строка)

UserAndGroupQuotas -> (список)

Объект, указывающий, сколько пространства могут использовать пользователи или группы в томе.

(структура)

Используется для настройки квот, определяющих, сколько дискового пространства может использовать пользователь или группа в томе FSx for OpenZFS. Дополнительную информацию см. в разделе Свойства томов в Руководстве пользователя FSx for OpenZFS.

Type -> (строка)

Указывает, относится ли квота к пользователю или группе.

Id -> (целое число)

Идентификатор пользователя или группы, на которую распространяется квота.

StorageCapacityQuotaGiB -> (целое число)

Квота на дисковое пространство пользователя или группы в гибибайтах (GiB).

RestoreToSnapshot -> (строка)

Указывает идентификатор снимка, на который был восстановлен том.

DeleteIntermediateSnaphots -> (булево)

Булево значение, указывающее, следует ли удалять снимки между текущим состоянием и указанным снимком при восстановлении тома из снимка.

DeleteClonedVolumes -> (булево)

Булево значение, указывающее, следует ли удалять зависимые клонированные тома, созданные из промежуточных снимков, при восстановлении тома из снимка.

DeleteIntermediateData -> (булево)

Булево значение, указывающее, следует ли перезаписывать данные снимка, отличающиеся между текущим состоянием и указанным снимком, при восстановлении тома из снимка.

SourceSnapshotARN -> (строка)

Идентификатор ресурса Amazon (ARN) для заданного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. Мы требуем ARN, когда необходимо однозначно указать ресурс во всех службах Amazon Web Services. Дополнительную информацию см. в разделе Имена ресурсов Amazon (ARN) в Общей справке Amazon Web Services.

DestinationSnapshot -> (строка)

Идентификатор снимка, который копируется или был в последний раз скопирован в целевой том.

CopyStrategy -> (строка)

Указывает стратегию, используемую при копировании данных из снимка в новый том.

  • CLONE - Новый том ссылается на данные в исходном снимке. Клонирование снимка быстрее, чем копирование данных из снимка в новый том, и не потребляет пропускную способность диска. Однако исходный снимок нельзя удалить, если его скопированные данные используются томом.
  • FULL_COPY - Копирует все данные из снимка в новый том. Укажите этот параметр, чтобы создать том из снимка на другой файловой системе FSx for OpenZFS.

Примечание

Вариант INCREMENTAL_COPY используется только для обновления существующего тома с помощью снимка из другой файловой системы FSx for OpenZFS. Дополнительную информацию см. в разделе CopySnapshotAndUpdateVolume.

TargetSnapshotValues -> (структура)

Снимок тома Amazon FSx for OpenZFS.

ResourceARN -> (строка)

Идентификатор ресурса Amazon (ARN) для заданного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. Мы требуем ARN, когда необходимо однозначно указать ресурс во всех службах Amazon Web Services. Дополнительную информацию см. в разделе Имена ресурсов Amazon (ARN) в Общей справке Amazon Web Services.

SnapshotId -> (строка)

Идентификатор снимка.

Name -> (строка)

Имя снимка.

VolumeId -> (строка)

Идентификатор тома, для которого создан снимок.

CreationTime -> (метка времени)

Время создания ресурса в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

Lifecycle -> (строка)

Статус жизненного цикла снимка.

  • PENDING - Amazon FSx еще не начал создание снимка.
  • CREATING - Amazon FSx создает снимок.
  • DELETING - Amazon FSx удаляет снимок.
  • AVAILABLE - Снимок полностью доступен.

LifecycleTransitionReason -> (структура)

Описание причины изменения состояния жизненного цикла ресурса.

Message -> (строка)

Подробное сообщение об ошибке.

Tags -> (список)

Список значений Tag, максимальное количество элементов — 50.

(структура)

Указывает пару ключ-значение для метки ресурса.

Key -> (строка)

Значение, указывающее TagKey, имя метки. Ключи меток должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (строка)

Значение, указывающее TagValue, значение, присвоенное соответствующему ключу метки. Значения меток могут быть null и не обязательно должны быть уникальными в наборе меток. Например, вы можете иметь пару ключ-значение в наборе меток finances : April и также payroll : April.

TotalTransferBytes -> (длинное целое число)

Количество байтов, переданных для снимка FSx for OpenZFS, который вы копируете.

RemainingTransferBytes -> (длинное целое число)

Остаток байтов для передачи для снимка FSx for OpenZFS, который вы копируете.

OntapConfiguration -> (структура)

Настройка файловой системы Amazon FSx для NetApp ONTAP.

AutomaticBackupRetentionDays -> (целое число)

Количество дней, в течение которых будут храниться автоматические резервные копии. Установка этого свойства в значение 0 отключает автоматические резервные копии. Вы можете хранить автоматические резервные копии не более 90 дней. По умолчанию установлено значение 30 .

DailyAutomaticBackupStartTime -> (строка)

Ежедневное время, повторяющееся ежедневно, в формате HH:MM . HH — это двузначный час дня (0-23), а MM — это двузначная минута часа. Например, 05:00 указывает на 5:00 ежедневно.

DeploymentType -> (строка)

Указывает тип развертывания файловой системы FSx для ONTAP, используемый в файловой системе.

  • MULTI_AZ_1 — высокодоступная файловая система, настроенная для многозонной избыточности, чтобы переносить временную недоступность зоны доступности (AZ). Это файловая система первого поколения FSx для ONTAP.
  • MULTI_AZ_2 — высокодоступная файловая система, настроенная для многозонной избыточности, чтобы переносить временную недоступность AZ. Это файловая система второго поколения FSx для ONTAP.
  • SINGLE_AZ_1 — файловая система, настроенная для однозонной избыточности. Это файловая система первого поколения FSx для ONTAP.
  • SINGLE_AZ_2 — файловая система, настроенная с несколькими парами высокодоступности (HA) для однозонной избыточности. Это файловая система второго поколения FSx для ONTAP.

Дополнительную информацию об использовании многозонных и однозонных развертываний см. в разделе Выбор многозонного или однозонного развертывания файловой системы.

EndpointIpAddressRange -> (строка)

(Только многозонная) Указывает диапазон IP-адресов, в котором будут созданы конечные точки для доступа к вашей файловой системе. По умолчанию в API Amazon FSx Amazon FSx выбирает для вас неиспользуемый диапазон IP-адресов из диапазона 198.19*. По умолчанию в консоли Amazon FSx Amazon FSx выбирает последние 64 IP-адреса из основного диапазона CIDR VPC для использования в качестве диапазона IP-адресов конечной точки для файловой системы. Вы можете иметь перекрывающиеся IP-адреса конечных точек для файловых систем, развернутых в одном VPC/таблицах маршрутизации.

Endpoints -> (структура)

Management и Intercluster конечные точки, которые используются для доступа к данным или для управления файловой системой с помощью NetApp ONTAP CLI, REST API или NetApp SnapMirror.

Intercluster -> (структура)

Конечная точка для управления файловой системой путем настройки NetApp SnapMirror с другими системами ONTAP.

DNSName -> (строка)

DNS-имя файловой системы. Вы можете смонтировать файловую систему, используя ее DNS-имя.

IpAddresses -> (список)

IP-адреса конечной точки файловой системы.

(строка)

Management -> (структура)

Конечная точка для управления вашей файловой системой с помощью NetApp ONTAP CLI и NetApp ONTAP API.

DNSName -> (строка)

DNS-имя файловой системы. Вы можете смонтировать файловую систему, используя ее DNS-имя.

IpAddresses -> (список)

IP-адреса конечной точки файловой системы.

(строка)

DiskIopsConfiguration -> (структура)

Настройка SSD IOPS для файловой системы ONTAP, определяющая количество предоставленных IOPS и режим предоставления.

Mode -> (строка)

Указывает, использует ли файловая система значение AUTOMATIC IOPS SSD в 3 IOPS на ГБ емкости хранилища или использует значение USER_PROVISIONED.

Iops -> (длинное целое число)

Общее количество IOPS SSD, предоставленных для файловой системы.

Минимальные и максимальные значения для этого свойства зависят от значения HAPairs и StorageCapacity . Минимальное значение вычисляется как StorageCapacity * 3 * HAPairs (3 IOPS на ГБ емкости StorageCapacity ). Максимальное значение вычисляется как 200 000 * HAPairs .

Amazon FSx отвечает кодом состояния HTTP 400 (Ошибка запроса), если значение Iops находится вне минимальных или максимальных значений.

PreferredSubnetId -> (строка)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашей виртуальной частной сети (VPC). Дополнительную информацию см. в руководстве пользователя Amazon VPC в разделе VPC и подсети.

RouteTableIds -> (список)

(Только многозонная) Таблицы маршрутизации VPC, в которых создаются конечные точки вашей файловой системы.

(строка)

ThroughputCapacity -> (целое число)

Поддерживаемая пропускная способность файловой системы Amazon FSx в мегабайтах в секунду (МБ/с).

WeeklyMaintenanceStartTime -> (строка)

Еженедельное время, повторяющееся еженедельно, в формате D:HH:MM .

D — это день недели, где 1 соответствует понедельнику, а 7 — воскресенью. Дополнительную информацию см. в спецификации ISO-8601, описанной в Википедии.

HH — это двузначный час дня (0-23), а MM — это двузначная минута часа.

Например, 1:05:00 указывает на техническое обслуживание в 5:00 понедельника.

FsxAdminPassword -> (строка)

Вы можете использовать учетную запись пользователя fsxadmin для доступа к NetApp ONTAP CLI и REST API. Значение пароля всегда замаскировано в ответе.

HAPairs -> (целое число)

Указывает, сколько пар высокодоступных (HA) серверов файлов будет у файловой системы. Значение по умолчанию равно 1. Значение этого свойства влияет на значения StorageCapacity , Iops и ThroughputCapacity . Дополнительную информацию см. в руководстве пользователя FSx для ONTAP в разделе Пара высокодоступности (HA).

Amazon FSx отвечает кодом состояния HTTP 400 (Ошибка запроса) при следующих условиях:

  • Значение HAPairs меньше 1 или больше 12.
  • Значение HAPairs больше 1, а значение DeploymentType равно SINGLE_AZ_1 , MULTI_AZ_1 или MULTI_AZ_2 .

ThroughputCapacityPerHAPair -> (целое число)

Используйте для выбора пропускной способности на пару HA. Когда значение HAPairs равно 1, значение ThroughputCapacityPerHAPair — это общая пропускная способность для файловой системы.

Это поле и ThroughputCapacity не могут быть определены в одном вызове API, но одно из них требуется.

Это поле и ThroughputCapacity одинаковы для файловых систем с одной парой HA.

  • Для файловых систем SINGLE_AZ_1 и MULTI_AZ_1 допустимые значения — 128, 256, 512, 1024, 2048 или 4096 Мбит/с.
  • Для SINGLE_AZ_2 допустимые значения — 1536, 3072 или 6144 Мбит/с.
  • Для MULTI_AZ_2 допустимые значения — 384, 768, 1536, 3072 или 6144 Мбит/с.

Amazon FSx отвечает кодом состояния HTTP 400 (Ошибка запроса) при следующих условиях:

  • Значения ThroughputCapacity и ThroughputCapacityPerHAPair не совпадают.
  • Значение типа развертывания равно SINGLE_AZ_2 , а ThroughputCapacity / ThroughputCapacityPerHAPair не является допустимой парой HA (значение между 1 и 12).
  • Значение ThroughputCapacityPerHAPair не является допустимым значением.

FileSystemTypeVersion -> (строка)

Версия Lustre файловой системы Amazon FSx для Lustre, которая может быть 2.10 , 2.12 или 2.15 .

OpenZFSConfiguration -> (структура)

Конфигурация файловой системы Amazon FSx for OpenZFS.

AutomaticBackupRetentionDays -> (целое число)

Количество дней хранения автоматических резервных копий. Установка этого свойства в значение 0 отключает автоматические резервные копии. Вы можете хранить автоматические резервные копии не более 90 дней. По умолчанию значение 30.

CopyTagsToBackups -> (булево)

Булево значение, указывающее, должны ли теги файловой системы копироваться в резервные копии. Если установлено значение true, все теги файловой системы копируются во все автоматические резервные копии и любые резервные копии, созданные пользователем, где пользователь не указывает теги. Если значение равно true и вы указываете один или несколько тегов, только указанные теги копируются в резервные копии. Если вы указываете один или несколько тегов при создании резервной копии, созданной пользователем, теги не копируются из файловой системы, независимо от этого значения.

CopyTagsToVolumes -> (булево)

Булево значение, указывающее, должны ли теги тома копироваться в снимки. По умолчанию значение равно false. Если установлено значение true, все теги тома копируются в снимки, где пользователь не указывает теги. Если значение равно true и вы указываете один или несколько тегов, только указанные теги копируются в снимки. Если вы указываете один или несколько тегов при создании снимка, теги не копируются из тома, независимо от этого значения.

DailyAutomaticBackupStartTime -> (строка)

Ежедневное время, в формате HH:MM. HH — это двузначный час (0-23), а MM — двузначная минута. Например, 05:00 — это 5 часов утра ежедневно.

DeploymentType -> (строка)

Указывает тип развертывания файловой системы. Amazon FSx for OpenZFS поддерживает MULTI_AZ_1, SINGLE_AZ_HA_2, SINGLE_AZ_HA_1, SINGLE_AZ_2 и SINGLE_AZ_1.

ThroughputCapacity -> (целое число)

Пропускная способность файловой системы Amazon FSx, измеряется в мегабайтах в секунду (МБ/с).

WeeklyMaintenanceStartTime -> (строка)

Еженедельное время, в формате D:HH:MM.

D — это день недели, где 1 — понедельник, а 7 — воскресенье. Дополнительные сведения см. в спецификации ISO-8601 на Wikipedia.

HH — это двузначный час (0-23), а MM — двузначная минута.

Например, 1:05:00 указывает техническое обслуживание в 5 часов утра понедельника.

DiskIopsConfiguration -> (структура)

Конфигурация IOPS (входно-выходных операций в секунду) SSD для файловой системы Amazon FSx for NetApp ONTAP, Amazon FSx for Windows File Server или FSx for OpenZFS. По умолчанию Amazon FSx автоматически предоставляет 3 IOPS на каждый ГБ емкости хранилища. Вы можете предоставить дополнительные IOPS на ГБ хранилища. Конфигурация включает общее количество предоставленных IOPS SSD и способ их предоставления, или режим (клиентом или Amazon FSx).

Mode -> (строка)

Указывает, использует ли файловая система значение AUTOMATIC для настройки SSD IOPS в 3 IOPS на каждый ГБ емкости хранилища или использует значение USER_PROVISIONED.

Iops -> (длинное целое число)

Общее количество предоставленных IOPS SSD для файловой системы.

Минимальное и максимальное значения для этого свойства зависят от значений HAPairs и StorageCapacity. Минимальное значение рассчитывается как StorageCapacity * 3 * HAPairs (3 IOPS на каждый ГБ емкости StorageCapacity). Максимальное значение рассчитывается как 200 000 * HAPairs.

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса), если значение Iops находится за пределами минимального или максимального значений.

RootVolumeId -> (строка)

Идентификатор корневого тома файловой системы OpenZFS.

PreferredSubnetId -> (строка)

Требуется, когда DeploymentType установлено в значение MULTI_AZ_1. Указывает подсеть, в которой вы хотите разместить предпочтительный файловый сервер.

EndpointIpAddressRange -> (строка)

(Только Multi-AZ) Указывает диапазон IP-адресов, в котором будут созданы конечные точки для доступа к вашей файловой системе. По умолчанию в API Amazon FSx и консоли Amazon FSx Amazon FSx выбирает доступный диапазон IP-адресов /28 из одного из диапазонов CIDR VPC. У вас могут быть перекрывающиеся IP-адреса конечных точек для файловых систем, развернутых в одном VPC/таблицах маршрутизации.

RouteTableIds -> (список)

(Только Multi-AZ) Таблицы маршрутизации VPC, в которых создаются конечные точки вашей файловой системы.

(строка)

EndpointIpAddress -> (строка)

IP-адрес конечной точки, используемой для доступа к данным или управления файловой системой.

ReadCacheConfiguration -> (структура)

Требуется, когда StorageType установлено в значение INTELLIGENT_TIERING. Указывает необязательный кэширование чтения SSD.

SizingMode -> (строка)

Указывает, как настраивается размер кэширования чтения SSD:

  • Установите значение в NO_CACHE, если вы не хотите использовать кэш чтения SSD с файловой системой Intelligent-Tiering.
  • Установите значение в USER_PROVISIONED, чтобы указать точный размер кэша чтения SSD.
  • Установите значение в PROPORTIONAL_TO_THROUGHPUT_CAPACITY, чтобы кэш чтения SSD был автоматически настроен на основе пропускной способности.

SizeGiB -> (целое число)

Требуется, если SizingMode установлено в значение USER_PROVISIONED. Указывает размер кэша чтения SSD файловой системы в гигабайтах (GiB).

FailureDetails -> (структура)

Предоставляет информацию о неудачном административном действии.

Message -> (строка)

Сообщение об ошибке, содержащее подробности о неудачном административном действии.

TargetVolumeValues -> (структура)

Описание тома Amazon FSx.

CreationTime -> (отметка времени)

Время создания ресурса в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

FileSystemId -> (строка)

Уникальный глобальный идентификатор файловой системы, назначенный Amazon FSx.

Lifecycle -> (строка)

Статус жизненного цикла тома.

  • AVAILABLE - Том полностью доступен для использования.
  • CREATED - Том был создан.
  • CREATING - Amazon FSx создаёт новый том.
  • DELETING - Amazon FSx удаляет существующий том.
  • FAILED - Amazon FSx не смог создать том.
  • MISCONFIGURED - Том находится в состоянии сбоя, но подлежит восстановлению.
  • PENDING - Amazon FSx ещё не начал создание тома.

Name -> (строка)

Имя тома.

OntapConfiguration -> (структура)

Настройка тома Amazon FSx for NetApp ONTAP.

FlexCacheEndpointType -> (строка)

Указывает тип конечной точки FlexCache для тома. Допустимые значения:

  • NONE указывает, что у тома нет конфигурации FlexCache. NONE — значение по умолчанию.
  • ORIGIN указывает, что том является исходным томом для тома FlexCache.
  • CACHE указывает, что том является томом FlexCache.

JunctionPath -> (строка)

Указывает каталог, который клиенты NAS используют для подключения к тому, а также имя домена системы доменных имён (DNS) или IP-адрес виртуальной машины хранения (SVM). Вы можете создать JunctionPath непосредственно под родительским узлом соединения тома или в каталоге внутри тома. JunctionPath для тома под названием vol3 может быть /vol1/vol2/vol3 , или /vol1/dir2/vol3 , или даже /dir1/dir2/vol3 .

SecurityStyle -> (строка)

Стиль безопасности для тома, который может быть UNIX , NTFS , или MIXED .

SizeInMegabytes -> (целое число)

Настроенный размер тома в мегабайтах (МБ).

StorageEfficiencyEnabled -> (булево)

Настройка эффективности хранения тома.

StorageVirtualMachineId -> (строка)

Идентификатор виртуальной машины хранения тома.

StorageVirtualMachineRoot -> (булево)

Булево значение, указывающее, является ли данный том корневым томом для его виртуальной машины хранения (SVM). Только один том на SVM может быть корневым томом. Значение по умолчанию — false . Если это значение равно AUTO, то это корневой том SVM.

Это флаг полезен при удалении SVM, потому что необходимо сначала удалить все некорневые тома. Это значение, установленное в false, помогает определить, какие тома необходимо удалить перед удалением SVM.

TieringPolicy -> (структура)

Настройка TieringPolicy тома.

CoolingPeriod -> (целое число)

Указывает количество дней, в течение которых пользовательские данные в томе должны оставаться неактивными, прежде чем они считаются «холодными» и перемещаются в пул емкости. Используется с политиками тиеринга AUTO и SNAPSHOT_ONLY. Введите целое число от 2 до 183. Значения по умолчанию составляют 31 день для AUTO и 2 дня для SNAPSHOT_ONLY.

Name -> (строка)

Указывает политику тиеринга, используемую для перехода данных. Значение по умолчанию — SNAPSHOT_ONLY.

  • SNAPSHOT_ONLY — перемещает холодные снимки в хранилище пула емкости.
  • AUTO — перемещает холодные пользовательские данные и снимки в хранилище пула емкости на основе ваших шаблонов доступа.
  • ALL — перемещает все блоки пользовательских данных как в активной файловой системе, так и в копиях снимков в хранилище пула емкости.
  • NONE — сохраняет данные тома в первичном хранилище, предотвращая их перемещение в хранилище пула емкости.

UUID -> (строка)

Универсальный уникальный идентификатор (UUID) тома.

OntapVolumeType -> (строка)

Указывает тип тома. Допустимые значения:

  • RW указывает том чтения/записи. RW — значение по умолчанию.
  • DP указывает том защиты данных. Вы можете защитить данные, дублируя их в зеркальные копии защиты данных. При возникновении катастрофы вы можете использовать эти копии зеркального отображения для восстановления данных.
  • LS указывает том зеркального отображения для распределения нагрузки. Зеркальное отображение для распределения нагрузки уменьшает сетевой трафик для тома FlexVol, предоставляя дополнительный доступ для чтения клиентам.

SnapshotPolicy -> (строка)

Указывает политику создания снимков для тома. Существуют три встроенные политики создания снимков:

  • default : Это политика по умолчанию. Максимальное количество снимков — шесть в час, снятые через пять минут после часа. Максимальное количество снимков в день — два, снимаемые с понедельника по субботу в 10 минут после полуночи. Максимальное количество снимков в неделю — два, снимаемые каждую субботу в 15 минут после полуночи.
  • default-1weekly : Эта политика такая же, как и политика default, за исключением того, что она сохраняет только один снимок из еженедельного графика.
  • none : Эта политика не создает никаких снимков. Эта политика может быть назначена томам для предотвращения автоматического создания снимков.

Вы также можете указать имя настроенной политики, созданной с помощью ONTAP CLI или REST API.

Дополнительную информацию см. в руководстве пользователя Amazon FSx for NetApp ONTAP в разделе «Политики снимков».

CopyTagsToBackups -> (булево)

Булево значение, указывающее, следует ли копировать теги тома в резервные копии. По умолчанию значение равно false. Если оно установлено в true, все теги тома копируются во все автоматические и пользовательские резервные копии, где пользователь не указывает теги. Если это значение true, и вы указываете один или несколько тегов, копируются только указанные теги. Если вы указываете один или несколько тегов при создании пользовательской резервной копии, теги не копируются с тома, независимо от этого значения.

SnaplockConfiguration -> (структура)

Объект конфигурации SnapLock для тома SnapLock FSx для ONTAP.

AuditLogVolume -> (boolean)

Включает или отключает том журнала аудита для тома SnapLock FSx для ONTAP. Значение по умолчанию — false. Если вы установите AuditLogVolume на true, том SnapLock создается как том журнала аудита. Минимальный срок хранения для тома журнала аудита составляет шесть месяцев.

Для получения дополнительной информации см. Тома журнала аудита SnapLock.

AutocommitPeriod -> (структура)

Объект конфигурации для установки периода автоматического подтверждения файлов в томе SnapLock FSx для ONTAP.

Type -> (строка)

Определяет тип времени для периода автоматического подтверждения файла в томе SnapLock FSx для ONTAP. Установка этого значения на NONE отключает автоматическое подтверждение. Значение по умолчанию — NONE.

Value -> (целое число)

Определяет длительность периода автоматического подтверждения файла в томе SnapLock FSx для ONTAP. Допустимые диапазоны:

  • Minutes : 5 - 65 535
  • Hours : 1 - 65 535
  • Days : 1 - 3650
  • Months : 1 - 120
  • Years : 1 - 10

PrivilegedDelete -> (строка)

Включает, отключает или постоянно отключает привилегированное удаление на предприятии SnapLock FSx для ONTAP. Включение привилегированного удаления позволяет администраторам SnapLock удалять файлы WORM (Write Once, Read Many), даже если для них установлены активные периоды хранения. PERMANENTLY_DISABLED является конечным состоянием. Если привилегированное удаление постоянно отключено в томе SnapLock, его нельзя включить повторно. Значение по умолчанию — DISABLED.

Для получения дополнительной информации см. Привилегированное удаление.

RetentionPeriod -> (структура)

Указывает срок хранения тома SnapLock FSx для ONTAP.

DefaultRetention -> (структура)

Срок хранения, назначаемый файлу WORM по умолчанию, если для тома SnapLock FSx для ONTAP не задан явный срок хранения. Срок хранения по умолчанию должен быть больше или равен минимальному сроку хранения и меньше или равен максимальному сроку хранения.

Type -> (строка)

Определяет тип времени для срока хранения тома SnapLock FSx для ONTAP. Установите одно из допустимых значений. Если вы установите его на INFINITE, файлы хранятся вечно. Если вы установите его на UNSPECIFIED, файлы хранятся до установки явного срока хранения.

Value -> (целое число)

Определяет длительность срока хранения тома SnapLock FSx для ONTAP. Вы не можете установить значение для INFINITE или UNSPECIFIED. Для всех других вариантов допустимые диапазоны:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

MinimumRetention -> (структура)

Наименьший срок хранения, который можно назначить файлу WORM в томе SnapLock FSx для ONTAP.

Type -> (строка)

Определяет тип времени для срока хранения тома SnapLock FSx для ONTAP. Установите одно из допустимых значений. Если вы установите его на INFINITE, файлы хранятся вечно. Если вы установите его на UNSPECIFIED, файлы хранятся до установки явного срока хранения.

Value -> (целое число)

Определяет длительность срока хранения тома SnapLock FSx для ONTAP. Вы не можете установить значение для INFINITE или UNSPECIFIED. Для всех других вариантов допустимые диапазоны:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

MaximumRetention -> (структура)

Наибольший срок хранения, который можно назначить файлу WORM в томе SnapLock FSx для ONTAP.

Type -> (строка)

Определяет тип времени для срока хранения тома SnapLock FSx для ONTAP. Установите одно из допустимых значений. Если вы установите его на INFINITE, файлы хранятся вечно. Если вы установите его на UNSPECIFIED, файлы хранятся до установки явного срока хранения.

Value -> (целое число)

Определяет длительность срока хранения тома SnapLock FSx для ONTAP. Вы не можете установить значение для INFINITE или UNSPECIFIED. Для всех других вариантов допустимые диапазоны:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

SnaplockType -> (строка)

Указывает режим хранения тома SnapLock FSx для ONTAP. После его установки изменить его нельзя. Вы можете выбрать один из следующих режимов хранения:

  • COMPLIANCE : Файлы, переведенные в режим WORM (Write Once, Read Many) на томе Compliance, нельзя удалить до истечения срока хранения. Этот режим хранения используется для соблюдения государственных или отраслевых требований или для защиты от атак ransomware. Для получения дополнительной информации см. SnapLock Compliance.
  • ENTERPRISE : Файлы, переведенные в режим WORM на томе Enterprise, могут быть удалены авторизованными пользователями до истечения срока хранения с помощью привилегированного удаления. Этот режим хранения используется для повышения целостности данных организации и соблюдения внутренних требований к хранению или для тестирования настроек хранения до использования SnapLock Compliance. Для получения дополнительной информации см. SnapLock Enterprise.

VolumeAppendModeEnabled -> (boolean)

Включает или отключает режим добавления тома в томе SnapLock FSx для ONTAP. Режим добавления тома позволяет создавать файлы, которые можно добавлять в WORM, и записывать данные в них постепенно. Значение по умолчанию — false.

Для получения дополнительной информации см. Режим добавления томов.

VolumeStyle -> (строка)

Используется для указания стиля тома ONTAP. Для получения дополнительной информации о FlexVols и FlexGroups см. Типы томов в руководстве пользователя Amazon FSx для NetApp ONTAP.

AggregateConfiguration -> (структура)

Эта структура указывает параметры конфигурации для агрегата или агрегатов хранения тома.

Aggregates -> (список)

Список агрегатов, на которых находится этот том. Агрегаты — это хранилища, которые составляют вашу основную хранилищную иерархию. Каждая пара высокой доступности (HA) имеет один агрегат. Имена агрегатов соответствуют именам агрегатов в ONTAP CLI и API REST. Для FlexVols всегда будет одна запись.

Amazon FSx возвращает HTTP-код состояния 400 (Bad Request) при следующих условиях:

  • Строки в значении Aggregates не отформатированы как aggrX, где X — число от 1 до 12.
  • Значение Aggregates содержит агрегаты, которых нет.
  • Один или несколько предоставленных агрегатов находятся слишком близко к пределу тома, чтобы добавить больше томов.

(строка)

TotalConstituents -> (целое число)

Общее количество компонентов, имеющих этот том FlexGroup. Неприменимо для FlexVols.

SizeInBytes -> (длинное целое число)

Настроенный размер тома в байтах.

ResourceARN -> (строка)

Идентификатор ресурса Amazon (ARN) для данного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. ARN необходим, когда требуется однозначно указать ресурс в среде Amazon Web Services. Дополнительные сведения см. в разделе Имена ресурсов Amazon (ARN) в Справочнике по Amazon Web Services.

Tags -> (список)

Список значений Tag с максимальным количеством элементов 50.

(структура)

Указывает пару ключ-значение для тега ресурса.

Key -> (строка)

Значение, определяющее TagKey — имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (строка)

Значение, определяющее TagValue — значение, назначенное соответствующему ключу тега. Значения тегов могут быть пустыми и не обязаны быть уникальными в наборе тегов. Например, в наборе тегов может быть пара ключ-значение finances : April, а также payroll : April.

VolumeId -> (строка)

Сгенерированный системой уникальный идентификатор тома.

VolumeType -> (строка)

Тип тома.

LifecycleTransitionReason -> (структура)

Причина изменения статуса жизненного цикла тома.

Message -> (строка)

Подробное сообщение об ошибке.

AdministrativeActions -> (список)

Список административных действий для тома, которые находятся в процессе выполнения или ожидают обработки. Административные действия описывают изменения в томе, которые вы инициировали с помощью действия UpdateVolume.

(структура)

Описывает конкретное административное действие Amazon FSx для текущей файловой системы или тома Windows, Lustre, OpenZFS или ONTAP.

AdministrativeActionType -> (строка)

Описывает тип административного действия следующим образом:

  • FILE_SYSTEM_UPDATE - Административное действие обновления файловой системы, инициированное из консоли Amazon FSx, API (UpdateFileSystem ) или командной строки (update-file-system ).
  • THROUGHPUT_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача THROUGHPUT_OPTIMIZATION. Вы можете отслеживать процесс оптимизации хранилища с помощью свойства ProgressPercent. После успешного завершения THROUGHPUT_OPTIMIZATION, статус родительского действия FILE_SYSTEM_UPDATE меняется на COMPLETED. Для получения дополнительной информации см. Управление пропускной способностью в руководстве пользователя Amazon FSx for Windows File Server.
  • STORAGE_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению емкости хранилища файловой системы запускается задача STORAGE_OPTIMIZATION.
    • Для Windows и ONTAP оптимизация хранилища представляет собой процесс миграции данных файловой системы на новые, более емкие диски.
    • Для Lustre оптимизация хранилища состоит в перераспределении данных по существующим и вновь добавленным файловым серверам.

Вы можете отслеживать процесс оптимизации хранилища с помощью свойства ProgressPercent. После успешного завершения STORAGE_OPTIMIZATION, статус родительского действия FILE_SYSTEM_UPDATE меняется на COMPLETED. Для получения дополнительной информации см. Управление емкостью хранилища в руководстве пользователя Amazon FSx for Windows File Server, Управление емкостью хранилища в руководстве пользователя Amazon FSx for Lustre и Управление емкостью хранилища и выделенными IOPS в руководстве пользователя Amazon FSx for NetApp ONTAP.

  • FILE_SYSTEM_ALIAS_ASSOCIATION - Обновление файловой системы для ассоциации нового псевдонима системы доменных имен (DNS) с файловой системой. Для получения дополнительной информации см. AssociateFileSystemAliases.
  • FILE_SYSTEM_ALIAS_DISASSOCIATION - Обновление файловой системы для отключения псевдонима DNS от файловой системы. Для получения дополнительной информации см. DisassociateFileSystemAliases.
  • IOPS_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача IOPS_OPTIMIZATION. Вы можете отслеживать процесс оптимизации хранилища с помощью свойства ProgressPercent. После успешного завершения IOPS_OPTIMIZATION, статус родительского действия FILE_SYSTEM_UPDATE меняется на COMPLETED. Для получения дополнительной информации см. Управление выделенными IOPS SSD в руководстве пользователя Amazon FSx for Windows File Server.
  • STORAGE_TYPE_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача STORAGE_TYPE_OPTIMIZATION. Вы можете отслеживать процесс оптимизации хранилища с помощью свойства ProgressPercent. После успешного завершения STORAGE_TYPE_OPTIMIZATION, статус родительского действия FILE_SYSTEM_UPDATE меняется на COMPLETED.
  • VOLUME_UPDATE - Обновление тома Amazon FSx для OpenZFS, инициированное из консоли Amazon FSx, API (UpdateVolume ) или командной строки (update-volume ).
  • VOLUME_RESTORE - Том Amazon FSx для OpenZFS возвращается в состояние, сохраненное указанным снимком, инициированное из API (RestoreVolumeFromSnapshot ) или командной строки (restore-volume-from-snapshot ).
  • SNAPSHOT_UPDATE - Обновление снимка для тома Amazon FSx для OpenZFS, инициированное из консоли Amazon FSx, API (UpdateSnapshot ) или командной строки (update-snapshot ).
  • RELEASE_NFS_V3_LOCKS - Отслеживает освобождение блокировок Network File System (NFS) V3 на файловой системе Amazon FSx для OpenZFS.
  • DOWNLOAD_DATA_FROM_BACKUP - Восстановление резервной копии FSx для ONTAP на новый том на файловой системе второго поколения. После загрузки всех метаданных файла на том, вы можете смонтировать том с только чтением.
  • VOLUME_INITIALIZE_WITH_SNAPSHOT - Создание тома из снимка на другой файловой системе FSx для OpenZFS. Вы можете инициировать это из консоли Amazon FSx, API (CreateVolume ) или командной строки (create-volume ) при использовании стратегии FULL_COPY.
  • VOLUME_UPDATE_WITH_SNAPSHOT - Обновление тома из снимка на другой файловой системе FSx для OpenZFS. Вы можете инициировать это из консоли Amazon FSx, API (CopySnapshotAndUpdateVolume ) или командной строки (copy-snapshot-and-update-volume ).

ProgressPercent -> (целое число)

Процентное состояние завершенности административного действия STORAGE_OPTIMIZATION или DOWNLOAD_DATA_FROM_BACKUP. Не относится к другим типам административных действий.

RequestTime -> (временная метка)

Время получения запроса на административное действие.

Status -> (строка)

Статус административного действия, как следует:

  • FAILED - Amazon FSx не смог успешно обработать административное действие.
  • IN_PROGRESS - Amazon FSx обрабатывает административное действие.
  • PENDING - Amazon FSx ожидает обработки административного действия.
  • COMPLETED - Amazon FSx завершил обработку административной задачи. Для восстановления резервной копии до файловой системы FSx для ONTAP второго поколения, указывает, что все данные были загружены в том, и клиенты теперь имеют доступ к тому для чтения и записи.
  • UPDATED_OPTIMIZING - Для обновления увеличения емкости хранилища, Amazon FSx обновил файловую систему до новой емкости хранилища и теперь выполняет процесс оптимизации хранилища.
  • PENDING - Для восстановления резервной копии до файловой системы FSx для ONTAP второго поколения, указывает, что метаданные файла загружаются в том. Состояние жизненного цикла тома - CREATING.
  • IN_PROGRESS - Для восстановления резервной копии до файловой системы FSx для ONTAP второго поколения, указывает, что все метаданные загружены в новый том, и клиенты могут получить доступ к данным только для чтения, в то время как Amazon FSx загружает данные файла в том. Следите за прогрессом этого процесса с помощью элемента ProgressPercent.

TargetFileSystemValues -> (структура)

Целевое значение для администрационного действия, предоставленное в операции UpdateFileSystem. Возвращается для административных действий FILE_SYSTEM_UPDATE.

OwnerId -> (строка)

Учетная запись Amazon Web Services, создавшая файловую систему. Если файловая система была создана пользователем в IAM Identity Center, учетной записью владельца является учетная запись Amazon Web Services, к которой принадлежит IAM-пользователь.

CreationTime -> (отметка времени)

Время создания файловой системы, в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

FileSystemId -> (строка)

Сгенерированный системой уникальный 17-значный идентификатор файловой системы.

FileSystemType -> (строка)

Тип файловой системы Amazon FSx, который может быть LUSTRE , WINDOWS , ONTAP или OPENZFS .

Lifecycle -> (строка)

Статус жизненного цикла файловой системы. Возможные значения и их значение:

  • AVAILABLE - Файловая система находится в здоровом состоянии, доступна и готова к использованию.
  • CREATING - Amazon FSx создает новую файловую систему.
  • DELETING - Amazon FSx удаляет существующую файловую систему.
  • FAILED - Существующая файловая система столкнулась с невосстановимым сбоем. При создании новой файловой системы Amazon FSx не смог создать файловую систему.
  • MISCONFIGURED - Файловая система находится в состоянии сбоя, но восстановима.
  • MISCONFIGURED_UNAVAILABLE - (Только Amazon FSx для Windows File Server) Файловая система в настоящее время недоступна из-за изменения конфигурации Active Directory.
  • UPDATING - Файловая система проходит обновление, инициированное пользователем.

FailureDetails -> (структура)

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

Message -> (строка)

Сообщение, описывающее любые произошедшие сбои.

StorageCapacity -> (целое число)

Емкость хранилища файловой системы в гибибайтах (GiB).

Amazon FSx отвечает кодом состояния HTTP 400 (Ошибка запроса), если значение StorageCapacity находится за пределами минимальных или максимальных значений.

StorageType -> (строка)

Тип хранилища, используемого файловой системой. Если установлено значение SSD , файловая система использует хранилище твердотельных накопителей. Если установлено значение HDD , файловая система использует хранилище на жестких дисках.

VpcId -> (строка)

Идентификатор основной виртуальной частной облачной сети (VPC) для файловой системы.

SubnetIds -> (список)

Указывает идентификаторы подсетей, из которых доступна файловая система. Для развертывания файловой системы Amazon FSx Windows и ONTAP MULTI_AZ_1 есть два идентификатора подсетей, один для предпочтительного сервера файлов и один для резервного сервера файлов. Подсеть предпочтительного сервера файлов указана в свойстве PreferredSubnetID. Все остальные файловые системы имеют только один идентификатор подсети.

Для файловых систем FSx для Lustre и файловых систем Windows с одиночной зоной доступности это идентификатор подсети, содержащей конечную точку файловой системы. Для файловых систем MULTI_AZ_1 Windows и ONTAP конечная точка файловой системы доступна в PreferredSubnetID .

(строка)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашей виртуальной частной облачной сети (VPC). Дополнительную информацию см. в разделе VPC и подсети в Руководстве пользователя Amazon VPC.

NetworkInterfaceIds -> (список)

Идентификаторы интерфейсов эластичной сети, из которых доступна конкретная файловая система. Интерфейс эластичной сети автоматически создается в той же виртуальной частной облачной сети (VPC), в которой была создана файловая система Amazon FSx. Дополнительную информацию см. в разделе Интерфейсы эластичной сети в Руководстве пользователя Amazon EC2.

Для файловой системы Amazon FSx для Windows File Server может быть один идентификатор интерфейса сети. Для файловой системы Amazon FSx для Lustre может быть более одного.

(строка)

Идентификатор интерфейса эластичной сети. Интерфейс эластичной сети — это логический компонент сети в виртуальной частной облачной сети (VPC), представляющий собой виртуальную сетевую карту. Дополнительную информацию см. в разделе Интерфейсы эластичной сети в Руководстве пользователя Amazon EC2 для Linux-инстансов .

DNSName -> (строка)

Имя домена DNS для файловой системы.

KmsKeyId -> (строка)

Идентификатор ключа управления ключами (KMS), используемого для шифрования данных файловой системы Amazon FSx. Используется следующим образом с типами файловых систем Amazon FSx:

  • Amazon FSx для Lustre PERSISTENT_1 и PERSISTENT_2 типы развертывания только. SCRATCH_1 и SCRATCH_2 типы шифруются с использованием ключа KMS службы Amazon FSx для вашей учетной записи.
  • Amazon FSx для NetApp ONTAP
  • Amazon FSx для OpenZFS
  • Amazon FSx для Windows File Server

ResourceARN -> (строка)

Amazon Resource Name (ARN) ресурса файловой системы.

Tags -> (список)

Теги для ассоциации с файловой системой. Дополнительную информацию см. в разделе Маркирование ваших ресурсов Amazon FSx в Руководстве пользователя Amazon FSx для Lustre .

(структура)

Указывает пару ключ-значение для тега ресурса.

Key -> (строка)

Значение, указывающее TagKey , имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (строка)

Значение, указывающее TagValue , значение, присвоенное соответствующему ключу тега. Значения тегов могут быть null и не обязательно должны быть уникальными в наборе тегов. Например, вы можете иметь пару ключ-значение в наборе тегов finances : April и также payroll : April .

WindowsConfiguration -> (структура)

Настройка файловой системы Amazon FSx for Windows File Server.

ActiveDirectoryId -> (строка)

Идентификатор существующего управляемого Microsoft Active Directory экземпляра Amazon Web Services, к которому присоединена файловая система.

SelfManagedActiveDirectoryConfiguration -> (структура)

Настройка автономного каталога Microsoft Active Directory (AD), к которому присоединена виртуальная машина Windows File Server или ONTAP хранилища (SVM).

DomainName -> (строка)

Полное доменное имя автономного каталога AD.

OrganizationalUnitDistinguishedName -> (строка)

Полное отличительное имя организационной единицы в автономном каталоге AD, к которому присоединена виртуальная машина Windows File Server или ONTAP хранилища (SVM).

FileSystemAdministratorsGroup -> (строка)

Имя доменной группы, члены которой имеют административные привилегии для файловой системы FSx.

UserName -> (строка)

Имя пользователя для учетной записи службы в вашем автономном домене AD, которую FSx использует для подключения к вашему домену AD.

DnsIps -> (список)

Список до трёх IP-адресов DNS-серверов или контроллеров домена в автономном каталоге AD.

(строка)

DeploymentType -> (строка)

Указывает тип развертывания файловой системы, допустимые значения следующие:

  • MULTI_AZ_1 - Указывает высокодоступную файловую систему, настроенную для многозонной избыточности для устранения временных сбоев зоны доступности (AZ), поддерживает хранилища SSD и HDD.
  • SINGLE_AZ_1 - (По умолчанию) Указывает файловую систему, настроенную для однозонной избыточности, поддерживает только хранилища SSD.
  • SINGLE_AZ_2 - Файловая система последнего поколения Single AZ. Указывает файловую систему, настроенную для однозонной избыточности и поддерживающую хранилища SSD и HDD.

Для получения дополнительной информации см. Однозонные и многозонные файловые системы.

RemoteAdministrationEndpoint -> (строка)

Для типов развертывания MULTI_AZ_1 используйте этот конечный пункт при выполнении административных задач с файловой системой с помощью Amazon FSx Remote PowerShell.

Для типов развертывания SINGLE_AZ_1 и SINGLE_AZ_2 это имя DNS файловой системы.

Этот конечный пункт временно недоступен, когда файловая система проходит техническое обслуживание.

PreferredSubnetId -> (строка)

Для типов развертывания MULTI_AZ_1 он указывает идентификатор подсети, где находится предпочтительный файловый сервер. Должен быть одним из двух идентификаторов подсетей, указанных в свойстве SubnetIds. Amazon FSx обслуживает трафик из этой подсети, за исключением случаев переключения на вторичный файловый сервер.

Для типов развертывания SINGLE_AZ_1 и SINGLE_AZ_2 это значение такое же, как и для SubnetIDs. Для получения дополнительной информации см. Доступность и долговечность: однозонные и многозонные файловые системы.

PreferredFileServerIp -> (строка)

Для типов развертывания MULTI_AZ_1 IP-адрес первичного или предпочтительного файлового сервера.

Используйте этот IP-адрес при подключении файловой системы к клиентам Linux SMB или Windows SMB, которые не подключены к Microsoft Active Directory. Применимо для всех типов развертывания файловой системы Windows. Этот IP-адрес временно недоступен во время технического обслуживания файловой системы. Для клиентов Linux и Windows SMB, подключенных к Active Directory, используйте имя DNS файловой системы вместо этого. Для получения дополнительной информации о подключении и настройке общих папок см. Доступ к общим папкам.

ThroughputCapacity -> (целое число)

Пропускная способность файловой системы Amazon FSx, измеряемая в мегабайтах в секунду.

MaintenanceOperationsInProgress -> (список)

Список операций технического обслуживания, выполняемых для этой файловой системы.

(строка)

Перечисление, определяющее текущую операцию технического обслуживания.

WeeklyMaintenanceStartTime -> (строка)

Предпочтительное время для проведения еженедельного технического обслуживания, отформатировано d:HH:MM в часовом поясе UTC. d — это номер дня недели от 1 до 7, начиная с понедельника и заканчивая воскресеньем.

DailyAutomaticBackupStartTime -> (строка)

Предпочтительное время для выполнения ежедневных автоматических резервных копий в часовом поясе UTC.

AutomaticBackupRetentionDays -> (целое число)

Количество дней для хранения автоматических резервных копий. Установка значения 0 отключает автоматические резервные копии. Вы можете хранить автоматические резервные копии не более 90 дней.

CopyTagsToBackups -> (булево)

Флаг булевого типа, указывающий, должны ли теги файловой системы копироваться в резервные копии. По умолчанию значение равно false. Если значение установлено в true, все теги файловой системы копируются во все автоматические резервные копии и любые резервные копии, инициированные пользователем, где пользователь не указывает тегов. Если это значение true, и вы указываете один или несколько тегов, копируются только указанные теги. Если вы указываете один или несколько тегов при создании резервной копии, инициированной пользователем, теги не копируются из файловой системы, независимо от этого значения.

Aliases -> (список)

Массив одного или нескольких DNS-псевдонимов, в настоящее время связанных с файловой системой Amazon FSx. Псевдонимы позволяют использовать существующие имена DNS для доступа к данным в вашей файловой системе Amazon FSx. Вы можете связать до 50 псевдонимов с файловой системой в любое время. Вы можете добавить дополнительные DNS-псевдонимы после создания файловой системы с помощью операции AssociateFileSystemAliases. Вы можете удалить DNS-псевдонимы из файловой системы после её создания с помощью операции DisassociateFileSystemAliases. Вам нужно указать только имя псевдонима в теле запроса. Для получения дополнительной информации см. DNS-псевдонимы.

(структура)

DNS-псевдоним, связанный с файловой системой. Вы можете использовать DNS-псевдоним для доступа к файловой системе с помощью определённых вами имён DNS помимо стандартного имени DNS, назначенного файловой системе Amazon FSx. Для получения дополнительной информации см. DNS-псевдонимы в руководстве пользователя FSx for Windows File Server.

Name -> (строка)

Имя DNS-псевдонима. Имя псевдонима должно соответствовать следующим требованиям:

  • Отформатировано как полностью квалифицированное доменное имя (FQDN), hostname.domain, например, accounting.example.com.
  • Может содержать буквенно-цифровые символы, символ подчёркивания (_) и дефис (-).
  • Не может начинаться или заканчиваться дефисом.
  • Может начинаться с цифры.

Для имён DNS Amazon FSx хранит буквенные символы в виде строчных букв (a-z), независимо от того, как вы их указываете: как прописные буквы, строчные буквы или соответствующие буквы в кодах экранирования.

Lifecycle -> (строка)

Описывает состояние DNS-псевдонима.

  • AVAILABLE - DNS-псевдоним связан с файловой системой Amazon FSx.
  • CREATING - Amazon FSx создаёт DNS-псевдоним и связывает его с файловой системой.
  • CREATE_FAILED - Amazon FSx не смог связать DNS-псевдоним с файловой системой.
  • DELETING - Amazon FSx отключает DNS-псевдоним от файловой системы и удаляет его.
  • DELETE_FAILED - Amazon FSx не смог отключить DNS-псевдоним от файловой системы.

AuditLogConfiguration -> (структура)

Настройка, которую Amazon FSx for Windows File Server использует для аудита и регистрации доступа пользователей к файлам, папкам и общим папкам на файловой системе Amazon FSx for Windows File Server.

FileAccessAuditLogLevel -> (строка)

Устанавливает, какие типы попыток регистрируются Amazon FSx для доступа к файлам и папкам.

  • SUCCESS_ONLY - регистрируются только успешные попытки доступа к файлам или папкам.
  • FAILURE_ONLY - регистрируются только неудачные попытки доступа к файлам или папкам.
  • SUCCESS_AND_FAILURE - регистрируются как успешные, так и неудачные попытки доступа к файлам или папкам.
  • DISABLED - аудит доступа к файлам и папкам отключен.

FileShareAccessAuditLogLevel -> (строка)

Устанавливает, какие типы попыток регистрируются Amazon FSx для доступа к общим папкам.

  • SUCCESS_ONLY - регистрируются только успешные попытки доступа к общим папкам.
  • FAILURE_ONLY - регистрируются только неудачные попытки доступа к общим папкам.
  • SUCCESS_AND_FAILURE - регистрируются как успешные, так и неудачные попытки доступа к общим папкам.
  • DISABLED - аудит доступа к общим папкам отключен.

AuditLogDestination -> (строка)

Amazon Resource Name (ARN) для назначения журналов аудита. Назначение может быть любым ARN группы журналов Amazon CloudWatch Logs или потока доставки Amazon Kinesis Data Firehose.

Имя группы журналов Amazon CloudWatch Logs должно начинаться с префикса /aws/fsx. Имя потока доставки Amazon Kinesis Data Firehose должно начинаться с префикса aws-fsx.

ARN назначения (либо группа журналов CloudWatch Logs, либо поток доставки Kinesis Data Firehose) должен находиться в той же области Amazon Web Services, регионе Amazon Web Services и учетной записи Amazon Web Services, что и ваша файловая система Amazon FSx.

DiskIopsConfiguration -> (структура)

Настройка SSD IOPS (ввод/вывод операций в секунду) для файловой системы Amazon FSx for Windows. По умолчанию Amazon FSx автоматически выделяет 3 IOPS на 1 ГБ объёма хранилища. Вы можете выделить дополнительные IOPS на 1 ГБ хранилища, до максимального предела, связанного с выбранной пропускной способностью.

Mode -> (строка)

Указывает, использует ли файловая система настройку AUTOMATIC SSD IOPS в 3 IOPS на ГБ объёма хранилища или использует значение USER_PROVISIONED.

Iops -> (длинное целое число)

Общее количество выделенных SSD IOPS для файловой системы.

Минимальное и максимальное значения для этого свойства зависят от значений HAPairs и StorageCapacity. Минимальное значение вычисляется как StorageCapacity * 3 * HAPairs (3 IOPS на ГБ объёма StorageCapacity). Максимальное значение вычисляется как 200 000 * HAPairs.

Amazon FSx возвращает HTTP-код состояния 400 (Неверный запрос), если значение Iops находится за пределами минимального или максимального значений.

LustreConfiguration -> (структура)

Конфигурация файловой системы Amazon FSx for Lustre.

WeeklyMaintenanceStartTime -> (строка)

Предпочтительное время для выполнения еженедельного технического обслуживания, отформатированное как д:ЧЧ:ММ в часовом поясе UTC. Здесь d — номер дня недели от 1 до 7, начиная с понедельника и заканчивая воскресеньем.

DataRepositoryConfiguration -> (структура)

Объект конфигурации хранилища данных для файловых систем Lustre, возвращаемый в ответе операции CreateFileSystem.

Этот тип данных не поддерживается для файловых систем с ассоциацией хранилища данных. Для файловых систем с ассоциацией хранилища данных см. .

Lifecycle -> (строка)

Описание состояния хранилища долговременных данных S3 файловой системы, если оно настроено с хранилищем S3. Жизненный цикл может принимать следующие значения:

  • CREATING — конфигурация хранилища данных между файловой системой FSx и связанным хранилищем данных S3 создается. Хранилище данных недоступно.
  • AVAILABLE — хранилище данных доступно для использования.
  • MISCONFIGURED — Amazon FSx не может автоматически импортировать обновления из ведра S3, пока конфигурация хранилища данных не будет исправлена. Для получения дополнительной информации см. Устранение неполадок при неправильной настройке связанного ведра S3.
  • UPDATING — хранилище данных проходит обновление, инициированное пользователем, и доступность может быть затронута.
  • FAILED — хранилище данных находится в терминальном состоянии, из которого невозможно восстановиться.

ImportPath -> (строка)

Путь импорта в ведро Amazon S3 (и необязательный префикс), используемый в качестве хранилища данных для вашей файловой системы FSx for Lustre, например s3://import-bucket/optional-prefix. Если после имени ведра Amazon S3 указан префикс, в файловую систему загружаются только ключи объектов с этим префиксом.

ExportPath -> (строка)

Путь экспорта в ведро Amazon S3 (и префикс), используемый для хранения новых и измененных файлов файловой системы Lustre в S3.

ImportedFileChunkSize -> (целое число)

Для файлов, импортированных из хранилища данных, это значение определяет количество полос и максимальный объем данных на файл (в МБ) на одном физическом диске. Максимальное количество дисков, на которые может быть распределен один файл, ограничено общим количеством дисков, составляющих файловую систему.

Размер фрагмента по умолчанию составляет 1024 МБ (1 ГБ) и может достигать 512 000 МБ (500 ГБ). Максимальный размер объектов S3 — 5 ТБ.

AutoImportPolicy -> (строка)

Описание связанного хранилища данных S3 файловой системы AutoImportPolicy. Параметр AutoImportPolicy настраивает, как Amazon FSx поддерживает актуальность списков файлов и каталогов по мере добавления или изменения объектов в связанном ведре S3. AutoImportPolicy может принимать следующие значения:

  • NONE — (По умолчанию) Автоимпорт выключен. Amazon FSx обновляет списки файлов и каталогов из связанного ведра S3 только при создании файловой системы. FSx не обновляет списки файлов и каталогов для новых или измененных объектов после выбора этого параметра.
  • NEW — Автоимпорт включен. Amazon FSx автоматически импортирует списки каталогов любых новых объектов, добавленных в связанное ведро S3, которые в настоящее время не существуют в файловой системе FSx.
  • NEW_CHANGED — Автоимпорт включен. Amazon FSx автоматически импортирует списки файлов и каталогов любых новых объектов, добавленных в ведро S3, и любых существующих объектов, измененных в ведре S3 после выбора этого параметра.
  • NEW_CHANGED_DELETED — Автоимпорт включен. Amazon FSx автоматически импортирует списки файлов и каталогов любых новых объектов, добавленных в ведро S3, любых существующих объектов, измененных в ведре S3, и любых объектов, удаленных из ведра S3.

FailureDetails -> (структура)

Предоставляет подробную информацию о хранилище данных, если его Lifecycle установлено в MISCONFIGURED или FAILED.

Message -> (строка)

Подробное сообщение об ошибке.

DeploymentType -> (строка)

Тип развертывания файловой системы FSx for Lustre. Тип развертывания для временного хранилища предназначен для временного хранения и краткосрочной обработки данных.

SCRATCH_1 и SCRATCH_2 типы развертывания лучше всего подходят для случаев, когда вам нужно временное хранилище и краткосрочная обработка данных. Тип развертывания SCRATCH_2 обеспечивает шифрование данных в процессе передачи и большую пропускную способность при передаче данных, чем SCRATCH_1.

Тип развертывания PERSISTENT_1 и PERSISTENT_2 используется для долгосрочного хранения и рабочих нагрузок, а также шифрования данных в процессе передачи. PERSISTENT_2 предлагает более высокую PerUnitStorageThroughput (до 1000 МБ/с/ТБ) вместе с более низким минимальным требованием к объему хранилища (600 ГБ). Чтобы узнать больше о типах развертывания FSx for Lustre, см. Варианты развертывания FSx for Lustre.

По умолчанию — SCRATCH_1.

PerUnitStorageThroughput -> (целое число)

Пропускная способность на единицу хранилища представляет собой мегабайты в секунду пропускной способности чтения или записи на 1 тебибайт предоставленного хранилища. Пропускная способность файловой системы равна Объем хранилища (ТБ) * PerUnitStorageThroughput (МБ/с/ТБ). Этот параметр действителен только для PERSISTENT_1 и PERSISTENT_2 типов развертывания.

Допустимые значения:

  • Для хранилища PERSISTENT_1 SSD: 50, 100, 200.
  • Для хранилища PERSISTENT_1 HDD: 12, 40.
  • Для хранилища PERSISTENT_2 SSD: 125, 250, 500, 1000.

MountName -> (строка)

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

Для типа развертывания SCRATCH_1 это значение всегда «fsx». Для SCRATCH_2, PERSISTENT_1 и PERSISTENT_2 типов развертывания это значение — строка, уникальная в регионе Amazon Web Services.

DailyAutomaticBackupStartTime -> (строка)

Повторяющееся ежедневное время в формате HH:MM. HH — заполненное нулями значение часа дня (0-23), а MM — заполненное нулями значение минуты часа. Например, 05:00 обозначает 5:00 ежедневно.

AutomaticBackupRetentionDays -> (целое число)

Количество дней хранения автоматических резервных копий. Установка этого параметра в 0 отключает автоматическое резервное копирование. Максимальный срок хранения автоматических резервных копий — 90 дней. По умолчанию — 30.

CopyTagsToBackups -> (логический тип)

Логический флаг, указывающий, копируются ли теги файловой системы в резервные копии. Если он установлен в значение true, все теги файловой системы копируются во все автоматические резервные копии и все резервные копии, инициированные пользователем, где пользователь не указывает тегов. Если это значение равно true, и вы указываете один или несколько тегов, копируются только указанные теги. Если вы указываете один или несколько тегов при создании резервной копии, инициированной пользователем, теги не копируются из файловой системы независимо от этого значения. (По умолчанию = false)

DriveCacheType -> (строка)

Тип кэша диска, используемого файловыми системами PERSISTENT_1, которые спроектированы с жесткими дисками. Этот параметр необходим, когда StorageType — HDD. При установке в READ файловая система имеет кэш хранилища SSD, размер которого составляет 20% от емкости хранилища файловой системы. Это улучшает производительность часто используемых файлов, кэшируя до 20% общего объема хранилища.

Этот параметр необходим, когда StorageType установлен в значение HDD.

DataCompressionType -> (строка)

Настройка сжатия данных для файловой системы. DataCompressionType может принимать следующие значения:

  • NONE — Сжатие данных выключено для файловой системы.
  • LZ4 — Сжатие данных включено с алгоритмом LZ4.

Дополнительная информация — в разделе Сжатие данных Lustre.

LogConfiguration -> (структура)

Конфигурация ведения журнала Lustre. Ведение журнала Lustre записывает включенные события журнала для вашей файловой системы в Amazon CloudWatch Logs.

Level -> (строка)

События хранилища данных, которые регистрируются Amazon FSx.

  • WARN_ONLY — регистрируются только предупреждения.
  • ERROR_ONLY — регистрируются только ошибки.
  • WARN_ERROR — регистрируются и предупреждения, и ошибки.
  • DISABLED — регистрация событий хранилища данных отключена.

Обратите внимание, что Amazon File Cache использует значение по умолчанию WARN_ERROR, которое изменить нельзя.

Destination -> (строка)

Идентификатор ресурса Amazon (ARN), указывающий место назначения журналов. Местом назначения может быть любой ARN группы журналов Amazon CloudWatch Logs. ARN места назначения должен находиться в том же разделе Amazon Web Services, регионе Amazon Web Services и учетной записи Amazon Web Services, что и ваша файловая система Amazon FSx.

RootSquashConfiguration -> (структура)

Конфигурация сжатия корневого пользователя Lustre для файловой системы Amazon FSx for Lustre. При включении сжатия корневого пользователя доступ root-уровня ограничивается для клиентов, пытающихся получить доступ к файловой системе в качестве пользователя root.

RootSquash -> (строка)

Сжатие корневого пользователя можно включить, задав идентификатор пользователя (UID) и идентификатор группы (GID) для файловой системы в формате UID:GID (например, 365534:65534). Значения UID и GID могут варьироваться от 0 до 4294967294:

  • Не нулевые значения для UID и GID включают сжатие корневого пользователя. Значения UID и GID могут отличаться, но каждое из них должно быть ненулевым.
  • Значение 0 (ноль) для UID и GID означает root и, следовательно, отключает сжатие корневого пользователя.

При включенном сжатии корневого пользователя идентификатор пользователя и идентификатор группы пользователя root, получающего доступ к файловой системе, перенаправляются на предоставленные вами UID и GID.

NoSquashNids -> (список)

При включенном сжатии корневого пользователя вы можете дополнительно указать массив NID клиентов, для которых сжатие корневого пользователя не применяется. NID клиента — идентификатор сети Lustre, используемый для уникальной идентификации клиента. Вы можете указать NID как один адрес или диапазон адресов:

  • Один адрес описывается в стандартном формате NID Lustre путем указания IP-адреса клиента и идентификатора сети Lustre (например, 10.0.1.6@tcp).
  • Диапазон адресов описывается с помощью дефиса для разделения диапазона (например, 10.0.[2-10].[1-255]@tcp).

(строка)

MetadataConfiguration -> (структура)

Конфигурация производительности метаданных Lustre для файловой системы Amazon FSx для Lustre с типом развертывания PERSISTENT_2.

Iops -> (целое число)

Количество метаданных IOPS, выделенных для файловой системы. Допустимые значения — 1500 , 3000 , 6000 , 12000 и кратные 12000 до максимального значения 192000.

Mode -> (строка)

Режим конфигурации метаданных для выделения метаданных IOPS для файловой системы.

  • В режиме AUTOMATIC, FSx для Lustre автоматически выделяет и масштабирует количество метаданных IOPS в вашей файловой системе на основе емкости хранения вашей файловой системы.
  • В режиме USER_PROVISIONED вы можете указать количество метаданных IOPS, которые нужно выделить для вашей файловой системы.

EfaEnabled -> (булево)

Указывает, включена ли поддержка Elastic Fabric Adapter (EFA) и GPUDirect Storage (GDS) для файловой системы Amazon FSx для Lustre.

OntapConfiguration -> (структура)

Конфигурация для данной файловой системы Amazon FSx для NetApp ONTAP.

AutomaticBackupRetentionDays -> (целое число)

Количество дней хранения автоматических резервных копий. Установка этого свойства в значение 0 отключает автоматические резервные копии. Вы можете хранить автоматические резервные копии не более 90 дней. По умолчанию — 30.

DailyAutomaticBackupStartTime -> (строка)

Ежедневное время, повторяющееся, в формате HH:MM. HH — это нулевой час дня (0-23), а MM — нулевая минута часа. Например, 05:00 указывает 5:00 ежедневно.

DeploymentType -> (строка)

Указывает тип развертывания файловой системы FSx для ONTAP, используемой в файловой системе.

  • MULTI_AZ_1 — файловая система высокой доступности, настроенная для многозонной избыточности для предотвращения временной недоступности доступной зоны (AZ). Это файловая система первого поколения FSx для ONTAP.
  • MULTI_AZ_2 — файловая система высокой доступности, настроенная для многозонной избыточности для предотвращения временной недоступности доступной зоны (AZ). Это файловая система второго поколения FSx для ONTAP.
  • SINGLE_AZ_1 — файловая система, настроенная для однозонной избыточности. Это файловая система первого поколения FSx для ONTAP.
  • SINGLE_AZ_2 — файловая система, настроенная с несколькими парами высокой доступности (HA) для однозонной избыточности. Это файловая система второго поколения FSx для ONTAP.

Для получения информации о вариантах использования многозонных и однозонных развертываний см. Выбор многозонного или однозонного развертывания файловой системы.

EndpointIpAddressRange -> (строка)

(Только многозонные) Указывает диапазон IP-адресов, в котором будут созданы конечные точки доступа к вашей файловой системе. По умолчанию в Amazon FSx API Amazon FSx выбирает для вас неиспользуемый диапазон IP-адресов из диапазона 198.19.*. По умолчанию в консоли Amazon FSx Amazon FSx выбирает последние 64 IP-адреса из основного диапазона CIDR VPC для использования в качестве диапазона IP-адресов конечной точки для файловой системы. Вы можете иметь перекрывающиеся IP-адреса конечных точек для файловых систем, развернутых в одной VPC/таблицах маршрутизации.

Endpoints -> (структура)

Конечные точки Management и Intercluster, используемые для доступа к данным или управления файловой системой с помощью NetApp ONTAP CLI, REST API или NetApp SnapMirror.

Intercluster -> (структура)

Конечная точка для управления файловой системой путем настройки NetApp SnapMirror с другими системами ONTAP.

DNSName -> (строка)

DNS-имя файловой системы. Вы можете смонтировать файловую систему, используя ее DNS-имя.

IpAddresses -> (список)

IP-адреса конечной точки файловой системы.

(строка)

Management -> (структура)

Конечная точка для управления файловой системой с помощью NetApp ONTAP CLI и NetApp ONTAP API.

DNSName -> (строка)

DNS-имя файловой системы. Вы можете смонтировать файловую систему, используя ее DNS-имя.

IpAddresses -> (список)

IP-адреса конечной точки файловой системы.

(строка)

DiskIopsConfiguration -> (структура)

Конфигурация IOPS SSD для файловой системы ONTAP, указывающая количество выделенных IOPS и режим выделения.

Mode -> (строка)

Указывает, использует ли файловая система значение AUTOMATIC для SSD IOPS в размере 3 IOPS на каждый ГБ емкости хранения или использует значение USER_PROVISIONED.

Iops -> (длинное целое число)

Общее количество выделенных IOPS SSD для файловой системы.

Минимальные и максимальные значения для этого свойства зависят от значений HAPairs и StorageCapacity. Минимальное значение рассчитывается как StorageCapacity * 3 * HAPairs (3 IOPS на каждый ГБ емкости StorageCapacity). Максимальное значение рассчитывается как 200 000 * HAPairs.

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса), если значение Iops выходит за пределы минимального или максимального значения.

PreferredSubnetId -> (строка)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашей виртуальной частной сети (VPC). Дополнительную информацию см. в руководстве по Amazon VPC.

RouteTableIds -> (список)

(Только многозонные) Таблицы маршрутизации VPC, в которых создаются конечные точки вашей файловой системы.

(строка)

ThroughputCapacity -> (целое число)

Непрерывный пропускная способность файловой системы Amazon FSx в мегабайтах в секунду (МБ/с).

WeeklyMaintenanceStartTime -> (строка)

Еженедельное повторяющееся время в формате D:HH:MM.

D — это день недели, где 1 — понедельник, а 7 — воскресенье. Более подробную информацию см. в спецификации ISO-8601, описанной в Википедии.

HH — это нулевой час дня (0-23), а MM — нулевая минута часа.

Например, 1:05:00 указывает техническое обслуживание в 5:00 понедельника.

FsxAdminPassword -> (строка)

Вы можете использовать учетную запись пользователя fsxadmin для доступа к NetApp ONTAP CLI и REST API. Значение пароля всегда скрыто в ответе.

HAPairs -> (целое число)

Указывает количество пар серверов файловой системы высокой доступности (HA), которые должна иметь файловая система. Значение по умолчанию — 1. Значение этого свойства влияет на значения StorageCapacity , Iops и ThroughputCapacity. Дополнительную информацию см. в руководстве по FSx для ONTAP, в разделе Пара высокой доступности (HA).

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса) при следующих условиях:

  • Значение HAPairs меньше 1 или больше 12.
  • Значение HAPairs больше 1, а значение DeploymentType равно SINGLE_AZ_1 , MULTI_AZ_1 или MULTI_AZ_2.

ThroughputCapacityPerHAPair -> (целое число)

Используйте для выбора пропускной способности на пару высокой доступности (HA). При значении HAPairs равном 1, значение ThroughputCapacityPerHAPair равно общей пропускной способности файловой системы.

Это поле и ThroughputCapacity не могут быть определены в одном вызове API, но одно из них обязательно.

Это поле и ThroughputCapacity одинаковы для файловых систем с одной парой высокой доступности.

  • Для файловых систем SINGLE_AZ_1 и MULTI_AZ_1 допустимые значения равны 128, 256, 512, 1024, 2048 или 4096 Мбит/с.
  • Для SINGLE_AZ_2 допустимые значения равны 1536, 3072 или 6144 Мбит/с.
  • Для MULTI_AZ_2 допустимые значения равны 384, 768, 1536, 3072 или 6144 Мбит/с.

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса) при следующих условиях:

  • Значение ThroughputCapacity и ThroughputCapacityPerHAPair не совпадают.
  • Значение типа развертывания равно SINGLE_AZ_2, а ThroughputCapacity / ThroughputCapacityPerHAPair не является допустимой парой HA (значение от 1 до 12).
  • Значение ThroughputCapacityPerHAPair не является допустимым значением.

FileSystemTypeVersion -> (строка)

Версия Lustre файловой системы Amazon FSx для Lustre, которая может быть 2.10 , 2.12 или 2.15.

OpenZFSConfiguration -> (структура)

Настройка этого файлового сервера Amazon FSx for OpenZFS.

AutomaticBackupRetentionDays -> (целое число)

Количество дней, в течение которых будут сохраняться автоматические резервные копии. Установка этого свойства в значение 0 отключает автоматические резервные копии. Вы можете сохранять автоматические резервные копии не более чем на 90 дней. По умолчанию значение равно 30.

CopyTagsToBackups -> (булево)

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

CopyTagsToVolumes -> (булево)

Булево значение, указывающее, нужно ли копировать теги тома в снимки. По умолчанию это значение равно false. Если оно установлено в true, все теги тома копируются в снимки, где пользователь не указывает теги. Если это значение установлено в true, и вы указали один или несколько тегов, только указанные теги копируются в снимки. Если вы указали один или несколько тегов при создании снимка, теги не копируются с тома, независимо от этого значения.

DailyAutomaticBackupStartTime -> (строка)

Ежедневное повторяющееся время в формате HH:MM. HH — это дополненное нулями значение часа (0-23), а MM — дополненное нулями значение минуты. Например, 05:00 указывает 5:00 каждый день.

DeploymentType -> (строка)

Указывает тип развертывания файлового сервера. Amazon FSx for OpenZFS поддерживает MULTI_AZ_1, SINGLE_AZ_HA_2, SINGLE_AZ_HA_1, SINGLE_AZ_2 и SINGLE_AZ_1.

ThroughputCapacity -> (целое число)

Пропускная способность файлового сервера Amazon FSx, измеряемая в мегабайтах в секунду (МБ/с).

WeeklyMaintenanceStartTime -> (строка)

Еженедельное повторяющееся время в формате D:HH:MM.

D — это день недели, где 1 — понедельник, а 7 — воскресенье. Более подробную информацию см. в спецификации ISO-8601 на Википедии.

HH — это дополненное нулями значение часа (0-23), а MM — дополненное нулями значение минуты.

Например, 1:05:00 указывает техническое обслуживание в 5:00 понедельника.

DiskIopsConfiguration -> (структура)

Настройка SSD IOPS (операций ввода/вывода в секунду) для файлового сервера Amazon FSx for NetApp ONTAP, Amazon FSx for Windows File Server или FSx for OpenZFS. По умолчанию Amazon FSx автоматически выделяет 3 IOPS на каждый ГБ емкости хранилища. Вы можете выделить дополнительные IOPS на каждый ГБ емкости хранилища. Настройка включает в себя общее количество выделенных SSD IOPS и способ их выделения, или режим (заказчиком или Amazon FSx).

Mode -> (строка)

Указывает, использует ли файловый сервер значение по умолчанию AUTOMATIC SSD IOPS в 3 IOPS на каждый ГБ емкости хранилища или используется значение USER_PROVISIONED.

Iops -> (длинное целое число)

Общее количество выделенных SSD IOPS для файлового сервера.

Минимальные и максимальные значения для этого свойства зависят от значения HAPairs и StorageCapacity. Минимальное значение рассчитывается как StorageCapacity * 3 * HAPairs (3 IOPS на каждый ГБ StorageCapacity). Максимальное значение рассчитывается как 200 000 * HAPairs.

Amazon FSx отвечает кодом состояния HTTP 400 (Ошибка запроса), если значение Iops находится за пределами минимальных или максимальных значений.

RootVolumeId -> (строка)

Идентификатор основного тома файлового сервера OpenZFS.

PreferredSubnetId -> (строка)

Требуется, когда DeploymentType установлено в значение MULTI_AZ_1. Это указывает подсеть, в которой вы хотите разместить предпочтительный файловый сервер.

EndpointIpAddressRange -> (строка)

(Только Multi-AZ) Указывает диапазон IP-адресов, в котором будут созданы конечные точки для доступа к вашему файловому серверу. По умолчанию в API Amazon FSx и консоли Amazon FSx Amazon FSx выбирает для вас доступный диапазон IP-адресов /28 из одного из диапазонов CIDR VPC. Вы можете иметь перекрывающиеся IP-адреса конечных точек для файловых серверов, развернутых в одной VPC/таблицах маршрутизации.

RouteTableIds -> (список)

(Только Multi-AZ) Таблицы маршрутизации VPC, в которых создаются конечные точки вашего файлового сервера.

(строка)

EndpointIpAddress -> (строка)

IP-адрес конечной точки, используемой для доступа к данным или управления файловым сервером.

ReadCacheConfiguration -> (структура)

Требуется, когда StorageType установлено в значение INTELLIGENT_TIERING. Указывает необязательный выделенный SSD кэш чтения.

SizingMode -> (строка)

Указывает, как настраивается выделенный SSD кэш чтения:

  • Установите в значение NO_CACHE, если вы не хотите использовать SSD кэш чтения с файловым сервером Intelligent-Tiering.
  • Установите в значение USER_PROVISIONED, чтобы указать точный размер SSD кэша чтения.
  • Установите в значение PROPORTIONAL_TO_THROUGHPUT_CAPACITY, чтобы SSD кэш чтения автоматически настраивался на основе вашей пропускной способности.

SizeGiB -> (целое число)

Требуется, если SizingMode установлено в значение USER_PROVISIONED. Указывает размер SSD кэша чтения файлового сервера в гибибайтах (GiB).

FailureDetails -> (структура)

Предоставляет информацию об ошибочном административном действии.

Message -> (строка)

Сообщение об ошибке, содержащее подробности о неудачном административном действии.

TargetVolumeValues -> (структура)

Описание тома Amazon FSx.

CreationTime -> (отметка времени)

Время создания ресурса в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

FileSystemId -> (строка)

Глобально уникальный идентификатор файловой системы, назначенный Amazon FSx.

Lifecycle -> (строка)

Статус жизненного цикла тома.

  • AVAILABLE - Том полностью доступен для использования.
  • CREATED - Том был создан.
  • CREATING - Amazon FSx создаёт новый том.
  • DELETING - Amazon FSx удаляет существующий том.
  • FAILED - Amazon FSx не смог создать том.
  • MISCONFIGURED - Том находится в состоянии ошибки, но может быть восстановлен.
  • PENDING - Amazon FSx ещё не начал создание тома.

Name -> (строка)

Имя тома.

OntapConfiguration -> (структура)

Настройка тома Amazon FSx for NetApp ONTAP.

FlexCacheEndpointType -> (строка)

Указывает тип конечной точки FlexCache тома. Допустимые значения:

  • NONE указывает, что у тома нет конфигурации FlexCache. NONE является значением по умолчанию.
  • ORIGIN указывает, что том является исходным томом для тома FlexCache.
  • CACHE указывает, что том является томом FlexCache.

JunctionPath -> (строка)

Указывает каталог, который клиенты NAS используют для подключения к тома, вместе с именем домена системы доменных имён (DNS) или IP-адресом виртуальной машины хранилища (SVM). Вы можете создать JunctionPath непосредственно под родительским узлом соединения тома или в каталоге внутри тома. JunctionPath для тома с именем vol3 может быть /vol1/vol2/vol3, или /vol1/dir2/vol3, или даже /dir1/dir2/vol3.

SecurityStyle -> (строка)

Стиль безопасности для тома, который может быть UNIX, NTFS или MIXED.

SizeInMegabytes -> (целое число)

Настроенный размер тома в мегабайтах (МБ).

StorageEfficiencyEnabled -> (булево)

Настройка эффективности хранилища тома.

StorageVirtualMachineId -> (строка)

Идентификатор виртуальной машины хранилища тома.

StorageVirtualMachineRoot -> (булево)

Булево значение, указывающее, является ли данный том корневым томом для его виртуальной машины хранилища (SVM). Только один том на SVM может быть корневым. По умолчанию это значение равно false. Если это значение равно true, то это корневой том SVM.

Это флаг полезен при удалении SVM, так как вы должны сначала удалить все тома, которые не являются корневыми. Это значение, установленное как false, помогает определить, какие тома нужно удалить, прежде чем вы сможете удалить SVM.

TieringPolicy -> (структура)

Настройка TieringPolicy тома.

CoolingPeriod -> (целое число)

Указывает количество дней, в течение которых данные пользователя в томе должны оставаться неактивными, прежде чем считаться «холодными» и перемещаться в пул хранилища. Используется с политиками тиеринга AUTO и SNAPSHOT_ONLY. Введите целое число от 2 до 183. Значения по умолчанию составляют 31 день для AUTO и 2 дня для SNAPSHOT_ONLY.

Name -> (строка)

Указывает политику тиеринга, используемую для перемещения данных. Значение по умолчанию — SNAPSHOT_ONLY.

  • SNAPSHOT_ONLY - перемещает холодные снимки в уровень хранилища пула емкости.
  • AUTO - перемещает холодные пользовательские данные и снимки в уровень хранилища пула емкости на основе ваших шаблонов доступа.
  • ALL - перемещает все блоки пользовательских данных как в активной файловой системе, так и в копиях снимков в уровень хранилища пула.
  • NONE - сохраняет данные тома в первичном уровне хранилища, предотвращая их перемещение в уровень хранилища пула.

UUID -> (строка)

Универсальный уникальный идентификатор (UUID) тома.

OntapVolumeType -> (строка)

Указывает тип тома. Допустимые значения:

  • RW указывает том чтения/записи. RW является значением по умолчанию.
  • DP указывает том защиты данных. Вы можете защищать данные, дублируя их в зеркальные копии защиты данных. В случае аварии вы можете использовать эти зеркальные копии защиты данных для восстановления данных.
  • LS указывает том зеркального распределения нагрузки. Зеркальное распределение нагрузки уменьшает сетевой трафик для тома FlexVol, предоставляя дополнительные доступ в чтении клиентам.

SnapshotPolicy -> (строка)

Указывает политику создания снимков для тома. Существует три встроенные политики создания снимков:

  • default : Это политика по умолчанию. Максимальное количество часовых снимков — шесть, создаваемых через пять минут после часа. Максимальное количество ежедневных снимков — два, создаваемых с понедельника по субботу в 10 минут после полуночи. Максимальное количество еженедельных снимков — два, создаваемых каждую среду в 15 минут после полуночи.
  • default-1weekly : Эта политика аналогична политике default, за исключением того, что она сохраняет только один снимок из еженедельного расписания.
  • none : Эта политика не создаёт никаких снимков. Эту политику можно назначить томам, чтобы предотвратить автоматическое создание снимков.

Вы также можете указать имя настраиваемой политики, созданной с помощью ONTAP CLI или REST API.

Для получения дополнительной информации см. Политики создания снимков в руководстве пользователя Amazon FSx for NetApp ONTAP.

CopyTagsToBackups -> (булево)

Булево значение, указывающее, нужно ли копировать метки тома в резервные копии. По умолчанию значение равно false. Если оно равно true, все метки тома копируются во все автоматические и инициированные пользователем резервные копии, где пользователь не указывает метки. Если это значение true, а вы указываете одну или несколько меток, копируются только указанные метки в резервные копии. Если вы указываете одну или несколько меток при создании резервной копии, инициированной пользователем, метки не копируются с тома, независимо от этого значения.

SnaplockConfiguration -> (структура)

Объект конфигурации SnapLock для тома SnapLock FSx для ONTAP.

AuditLogVolume -> (boolean)

Включает или отключает журнал аудита для тома SnapLock FSx для ONTAP. Значение по умолчанию — false. Если вы установите AuditLogVolume в значение true, том SnapLock создаётся как том журнала аудита. Минимальный срок хранения для тома журнала аудита составляет шесть месяцев.

Дополнительную информацию см. в разделе Журналы аудита SnapLock.

AutocommitPeriod -> (структура)

Объект конфигурации для установки периода автоматического сохранения файлов в томе SnapLock FSx для ONTAP.

Type -> (строка)

Определяет тип времени для периода автоматического сохранения файла в томе SnapLock FSx для ONTAP. Установка этого значения в NONE отключает автоматическое сохранение. Значение по умолчанию — NONE.

Value -> (целое число)

Определяет период времени для автоматического сохранения файла в томе SnapLock FSx для ONTAP. Допустимые диапазоны:

  • Minutes : 5 - 65 535
  • Hours : 1 - 65 535
  • Days : 1 - 3650
  • Months : 1 - 120
  • Years : 1 - 10

PrivilegedDelete -> (строка)

Включает, отключает или постоянно отключает привилегированное удаление в томе SnapLock Enterprise FSx для ONTAP. Включение привилегированного удаления позволяет администраторам SnapLock удалять файлы WORM (write once, read many), даже если у них активные периоды хранения. PERMANENTLY_DISABLED — это конечное состояние. Если привилегированное удаление постоянно отключено в томе SnapLock, его нельзя включить заново. Значение по умолчанию — DISABLED.

Дополнительную информацию см. в разделе Привилегированное удаление.

RetentionPeriod -> (структура)

Устанавливает срок хранения тома SnapLock FSx для ONTAP.

DefaultRetention -> (структура)

Срок хранения, по умолчанию назначаемый файлу WORM, если явный срок хранения не установлен для тома SnapLock FSx для ONTAP. Срок хранения по умолчанию должен быть больше или равен минимальному сроку хранения и меньше или равен максимальному сроку хранения.

Type -> (строка)

Определяет тип времени для периода хранения тома SnapLock FSx для ONTAP. Установите одно из допустимых значений. Если вы устанавливаете INFINITE, файлы хранятся постоянно. Если вы устанавливаете UNSPECIFIED, файлы хранятся до установки явного срока хранения.

Value -> (целое число)

Определяет период времени для срока хранения тома SnapLock FSx для ONTAP. Значение не может быть установлено для INFINITE или UNSPECIFIED. Для всех остальных вариантов допустимые диапазоны:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

MinimumRetention -> (структура)

Наименьший срок хранения, который может быть назначен файлу WORM в томе SnapLock FSx для ONTAP.

Type -> (строка)

Определяет тип времени для срока хранения тома SnapLock FSx для ONTAP. Установите одно из допустимых значений. Если вы устанавливаете INFINITE, файлы хранятся постоянно. Если вы устанавливаете UNSPECIFIED, файлы хранятся до установки явного срока хранения.

Value -> (целое число)

Определяет период времени для срока хранения тома SnapLock FSx для ONTAP. Значение не может быть установлено для INFINITE или UNSPECIFIED. Для всех остальных вариантов допустимые диапазоны:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

MaximumRetention -> (структура)

Наибольший срок хранения, который может быть назначен файлу WORM в томе SnapLock FSx для ONTAP.

Type -> (строка)

Определяет тип времени для срока хранения тома SnapLock FSx для ONTAP. Установите одно из допустимых значений. Если вы устанавливаете INFINITE, файлы хранятся постоянно. Если вы устанавливаете UNSPECIFIED, файлы хранятся до установки явного срока хранения.

Value -> (целое число)

Определяет период времени для срока хранения тома SnapLock FSx для ONTAP. Значение не может быть установлено для INFINITE или UNSPECIFIED. Для всех остальных вариантов допустимые диапазоны:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

SnaplockType -> (строка)

Устанавливает режим хранения тома SnapLock FSx для ONTAP. После установки его нельзя изменить. Вы можете выбрать один из следующих режимов хранения:

  • COMPLIANCE : Файлы, переведённые в режим WORM (write once, read many) на томе соответствия, не могут быть удалены до истечения срока хранения. Этот режим хранения используется для соблюдения нормативных требований правительства или отрасли или защиты от атак ransomware. Дополнительную информацию см. в разделе SnapLock Соответствие.
  • ENTERPRISE : Файлы, переведённые в режим WORM на томе Enterprise, могут быть удалены авторизованными пользователями до истечения срока хранения с использованием привилегированного удаления. Этот режим используется для повышения целостности данных и внутренней конформности организации, или для проверки настроек хранения перед использованием SnapLock Соответствие. Дополнительную информацию см. в разделе SnapLock Enterprise.

VolumeAppendModeEnabled -> (boolean)

Включает или отключает режим добавления к тому FSx для ONTAP SnapLock. Режим добавления к томам позволяет создавать файлы WORM, к которым можно добавлять данные по частям. Значение по умолчанию — false.

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

VolumeStyle -> (строка)

Используйте для указания стиля тома ONTAP. Дополнительную информацию о FlexVols и FlexGroups см. в руководстве пользователя Amazon FSx для NetApp ONTAP в разделе Типы томов.

AggregateConfiguration -> (структура)

Эта структура определяет параметры конфигурации для агрегата или агрегатов хранения тома.

Aggregates -> (список)

Список агрегатов, на которых находится этот том. Агрегаты — это хранилища, которые образуют ваш основной уровень хранения. Каждая пара высокой доступности (HA) имеет один агрегат. Имена агрегатов соответствуют именам агрегатов в ONTAP CLI и REST API. Для FlexVols всегда будет одна запись.

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса) при следующих условиях:

  • Строки в значении Aggregates не отформатированы как aggrX, где X — число от 1 до 12.
  • Значение Aggregates содержит агрегаты, которых нет.
  • Один или несколько предоставленных агрегатов слишком близки к лимиту тома, чтобы добавить больше томов.

(строка)

TotalConstituents -> (целое число)

Общее количество составляющих этого тома FlexGroup. Неприменимо к FlexVols.

SizeInBytes -> (длинное целое число)

Настроенный размер тома в байтах.

ResourceARN -> (строка)

Amazon Resource Name (ARN) для данного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. ARN требуется, когда необходимо однозначно указать ресурс во всех сервисах Amazon Web Services. Дополнительную информацию см. в разделе Amazon Resource Names (ARN) в справочнике Amazon Web Services General Reference.

Tags -> (список)

Список значений Tag с максимальным количеством элементов 50.

(структура)

Определяет пару ключ-значение для тега ресурса.

Key -> (строка)

Значение, определяющее TagKey, имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (строка)

Значение, определяющее TagValue, значение, назначенное соответствующему ключу тега. Значения тегов могут быть null и не обязательно уникальными в наборе тегов. Например, вы можете иметь пару ключ-значение в наборе тегов finances : April и также payroll : April.

VolumeId -> (строка)

Сгенерированный системой уникальный идентификатор тома.

VolumeType -> (строка)

Тип тома.

LifecycleTransitionReason -> (структура)

Причина изменения статуса жизненного цикла тома.

Message -> (строка)

Подробное сообщение об ошибке.

OpenZFSConfiguration -> (структура)

Настройка тома Amazon FSx for OpenZFS.

ParentVolumeId -> (string)

Идентификатор родительского тома.

VolumePath -> (string)

Путь к тому от корневого тома. Например, fsx/parentVolume/volume1 .

StorageCapacityReservationGiB -> (integer)

Объем резервируемого пространства в гибибайтах (GiB) из родительского тома. Вы не можете зарезервировать больше пространства, чем резервирует родительский том.

StorageCapacityQuotaGiB -> (integer)

Максимальный объем пространства в гибибайтах (GiB), который может использовать том от своего родителя. Вы можете указать квоту, превышающую объем пространства на родительском томе.

RecordSizeKiB -> (integer)

Размер записи тома OpenZFS в кибибайтах (KiB). Допустимые значения: 4, 8, 16, 32, 64, 128, 256, 512 или 1024 KiB. По умолчанию — 128 KiB. Большинству рабочих нагрузок подходит размер записи по умолчанию. Чтобы узнать, когда следует задать пользовательский размер записи, обратитесь к руководству пользователя Amazon FSx for OpenZFS .

DataCompressionType -> (string)

Указывает метод сжатия данных на томе. По умолчанию используется тип сжатия NONE.

  • NONE — данные на томе не сжимаются. NONE — по умолчанию.
  • ZSTD — данные в томе сжимаются с помощью алгоритма сжатия Zstandard (ZSTD). По сравнению с LZ4, Z-Standard обеспечивает лучшую степень сжатия для минимизации использования места на диске.
  • LZ4 — данные в томе сжимаются с помощью алгоритма сжатия LZ4. По сравнению с Z-Standard, LZ4 требует меньших вычислительных ресурсов и обеспечивает более высокую скорость записи.

CopyTagsToSnapshots -> (boolean)

Булево значение, указывающее, должны ли теги тома копироваться в снимки. По умолчанию это значение равно false . Если оно установлено в значение true, все теги тома копируются в снимки, где пользователь не указывает теги. Если это значение равно true, и вы указываете один или несколько тегов, только указанные теги копируются в снимки. Если вы указываете один или несколько тегов при создании снимка, теги не копируются с тома, независимо от этого значения.

OriginSnapshot -> (structure)

Объект конфигурации, который определяет снимок, используемый в качестве источника данных для тома.

SnapshotARN -> (string)

Amazon Resource Name (ARN) для данного ресурса. ARNs однозначно идентифицируют ресурсы Amazon Web Services. Мы требуем ARN, когда вам необходимо однозначно указать ресурс в рамках всех сервисов Amazon Web Services. Дополнительную информацию см. в разделе Amazon Resource Names (ARNs) в руководстве Amazon Web Services General Reference.

CopyStrategy -> (string)

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

  • CLONE — новый том ссылается на данные в исходном снимке. Клонирование снимка быстрее, чем копирование данных со снимка на новый том и не потребляет пропускную способность диска. Однако исходный снимок не может быть удален, если его скопированные данные используются томом.
  • FULL_COPY — копируются все данные со снимка на новый том.

Примечание

Опция INCREMENTAL_COPY используется только для обновления существующего тома с помощью снимка из другого файлового сервера FSx for OpenZFS. Дополнительную информацию см. в разделе CopySnapshotAndUpdateVolume .

ReadOnly -> (boolean)

Булево значение, указывающее, является ли том только для чтения.

NfsExports -> (list)

Объект конфигурации для подключения файловой системы Network File System (NFS).

(structure)

Настройки Network File System (NFS) для подключения файловой системы Amazon FSx for OpenZFS.

ClientConfigurations -> (list)

Список объектов конфигурации, содержащих клиента и параметры для подключения файловой системы OpenZFS.

(structure)

Указывает, кто может подключиться к файловой системе OpenZFS и какие параметры доступны при подключении к файловой системе.

Clients -> (string)

Значение, указывающее, кто может подключиться к файловой системе. Вы можете указать символ подстановки (*), IP-адрес (0.0.0.0) или CIDR-адрес (192.0.2.0/24). По умолчанию Amazon FSx использует символ подстановки при указании клиента.

Options -> (list)

Параметры для использования при подключении к файловой системе. Список параметров, которые можно использовать с Network File System (NFS), см. в справке exports(5) - Linux man page. При выборе параметров учитывайте следующее:

  • crossmnt используется по умолчанию. Если вы не указываете crossmnt при изменении конфигурации клиента, вы не сможете увидеть или получить доступ к снимкам в каталоге снимков вашей файловой системы.
  • sync используется по умолчанию. Если вместо этого указать async, система подтверждает запись перед записью на диск. Если система аварийно завершит работу до завершения записи, несохраненные данные будут потеряны.

(string)

UserAndGroupQuotas -> (list)

Объект, указывающий, сколько пространства могут использовать пользователи или группы в томе.

(structure)

Используется для настройки квот, которые определяют, сколько пространства может использовать пользователь или группа в томе FSx for OpenZFS. Дополнительную информацию см. в разделе Свойства тома в руководстве пользователя FSx for OpenZFS.

Type -> (string)

Указывает, относится ли квота к пользователю или группе.

Id -> (integer)

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

StorageCapacityQuotaGiB -> (integer)

Квота на хранилище пользователя или группы в гибибайтах (GiB).

RestoreToSnapshot -> (string)

Указывает идентификатор снимка, на который был восстановлен том.

DeleteIntermediateSnaphots -> (boolean)

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

DeleteClonedVolumes -> (boolean)

Булево значение, указывающее, должны ли зависимые клонированные тома, созданные из промежуточных снимков, быть удалены при восстановлении тома со снимка.

DeleteIntermediateData -> (boolean)

Булево значение, указывающее, должны ли данные снимка, которые отличаются между текущим состоянием и указанным снимком, перезаписываться при восстановлении тома со снимка.

SourceSnapshotARN -> (string)

Amazon Resource Name (ARN) для данного ресурса. ARNs однозначно идентифицируют ресурсы Amazon Web Services. Мы требуем ARN, когда вам необходимо однозначно указать ресурс в рамках всех сервисов Amazon Web Services. Дополнительную информацию см. в разделе Amazon Resource Names (ARNs) в руководстве Amazon Web Services General Reference.

DestinationSnapshot -> (string)

Идентификатор снимка, который копируется или был последним скопирован в целевой том.

CopyStrategy -> (string)

Указывает стратегию, используемую при копировании данных со снимка на новый том.

  • CLONE — новый том ссылается на данные в исходном снимке. Клонирование снимка быстрее, чем копирование данных со снимка на новый том и не потребляет пропускную способность диска. Однако исходный снимок не может быть удален, если его скопированные данные используются томом.
  • FULL_COPY — копируются все данные со снимка на новый том. Укажите этот параметр для создания тома со снимка на другом файловом сервере FSx for OpenZFS.

Примечание

Опция INCREMENTAL_COPY используется только для обновления существующего тома с помощью снимка из другого файлового сервера FSx for OpenZFS. Дополнительную информацию см. в разделе CopySnapshotAndUpdateVolume .

TargetSnapshotValues -> (structure)

Снимок тома Amazon FSx for OpenZFS.

ResourceARN -> (string)

Amazon Resource Name (ARN) для данного ресурса. ARNs однозначно идентифицируют ресурсы Amazon Web Services. Мы требуем ARN, когда вам необходимо однозначно указать ресурс в рамках всех сервисов Amazon Web Services. Дополнительную информацию см. в разделе Amazon Resource Names (ARNs) в руководстве Amazon Web Services General Reference.

SnapshotId -> (string)

Идентификатор снимка.

Name -> (string)

Имя снимка.

VolumeId -> (string)

Идентификатор тома, которому принадлежит снимок.

CreationTime -> (timestamp)

Время создания ресурса в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

Lifecycle -> (string)

Статус жизненного цикла снимка.

  • PENDING — Amazon FSx еще не начал создание снимка.
  • CREATING — Amazon FSx создает снимок.
  • DELETING — Amazon FSx удаляет снимок.
  • AVAILABLE — Снимок полностью доступен.

LifecycleTransitionReason -> (structure)

Описание причины изменения состояния жизненного цикла ресурса.

Message -> (string)

Подробное сообщение об ошибке.

Tags -> (list)

Список значений Tag, максимальное количество элементов — 50.

(structure)

Указывает пару ключ-значение для тега ресурса.

Key -> (string)

Значение, указывающее TagKey, имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (string)

Значение, указывающее TagValue, значение, назначенное соответствующему ключу тега. Значения тегов могут быть пустыми и не обязательно должны быть уникальными в наборе тегов. Например, в наборе тегов может быть пара ключ-значение finances : April, а также payroll : April .

TotalTransferBytes -> (long)

Количество байтов, переданных для снимка FSx for OpenZFS, который вы копируете.

RemainingTransferBytes -> (long)

Остаток байтов для передачи для снимка FSx for OpenZFS, который вы копируете.

OpenZFSConfiguration -> (structure)

Настройка тома Amazon FSx for OpenZFS.

ParentVolumeId -> (строка)

Идентификатор родительского тома.

VolumePath -> (строка)

Путь к тому от корневого тома. Например, fsx/parentVolume/volume1 .

StorageCapacityReservationGiB -> (целое число)

Объем выделенного пространства в гибибайтах (GiB) из родительского тома. Вы не можете выделить больше места, чем выделено в родительском томе.

StorageCapacityQuotaGiB -> (целое число)

Максимальный объем пространства в гибибайтах (GiB), который может использовать том из родительского тома. Вы можете указать квоту, превышающую объем памяти в родительском томе.

RecordSizeKiB -> (целое число)

Размер записи тома OpenZFS в кибибайтах (KiB). Допустимые значения: 4, 8, 16, 32, 64, 128, 256, 512 или 1024 KiB. По умолчанию 128 KiB. Большинству рабочих нагрузок подойдет размер записи по умолчанию. Инструкции по настройке пользовательского размера записи см. в руководстве пользователя Amazon FSx for OpenZFS.

DataCompressionType -> (строка)

Указывает метод сжатия данных в томе. Тип сжатия по умолчанию NONE.

  • NONE - Данные в томе не сжимаются. По умолчанию используется NONE.
  • ZSTD - Данные в томе сжимаются с помощью алгоритма Zstandard (ZSTD). По сравнению с LZ4, Z-Standard обеспечивает более высокое сжатие, что позволяет минимизировать использование дискового пространства.
  • LZ4 - Данные в томе сжимаются с помощью алгоритма LZ4. По сравнению с Z-Standard, LZ4 менее ресурсоемкий и обеспечивает более высокую скорость записи.

CopyTagsToSnapshots -> (булево)

Булево значение, указывающее, должны ли теги тома копироваться в снимки. По умолчанию это значение равно false . Если оно установлено в true, все теги тома копируются в снимки, где пользователь не указывает теги. Если это значение равно true, и вы указали один или несколько тегов, в снимки копируются только указанные теги. Если вы укажете один или несколько тегов при создании снимка, теги не копируются из тома независимо от этого значения.

OriginSnapshot -> (структура)

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

SnapshotARN -> (строка)

Amazon Resource Name (ARN) для данного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. Нам необходим ARN, когда требуется однозначно указать ресурс во всех сервисах Amazon Web Services. Дополнительную информацию см. в разделе Имена ресурсов Amazon Resource Names (ARN) в Справочнике Amazon Web Services.

CopyStrategy -> (строка)

Стратегия копирования данных со снимка в новый том.

  • CLONE - Новый том ссылается на данные в исходном снимке. Клонирование снимка быстрее, чем копирование данных со снимка в новый том, и не потребляет пропускную способность диска. Однако исходный снимок нельзя удалить, если его скопированные данные используются в томе.
  • FULL_COPY - Копирует все данные со снимка в новый том.

Примечание

Опция INCREMENTAL_COPY используется только для обновления существующего тома с помощью снимка из другого файлового сервера FSx for OpenZFS. Дополнительную информацию см. в разделе CopySnapshotAndUpdateVolume.

ReadOnly -> (булево)

Булево значение, указывающее, является ли том только для чтения.

NfsExports -> (список)

Объект конфигурации для подключения файловой системы Network File System (NFS).

(структура)

Настройки NFS для подключения файловой системы Amazon FSx for OpenZFS.

ClientConfigurations -> (список)

Список объектов конфигурации, содержащих клиента и параметры для подключения файловой системы OpenZFS.

(структура)

Указывает, кто может подключиться к файловой системе OpenZFS и доступные параметры при подключении.

Clients -> (строка)

Значение, указывающее, кто может подключиться к файловой системе. Вы можете указать символ подстановки (*), IP-адрес (0.0.0.0) или адрес CIDR (192.0.2.0/24). По умолчанию Amazon FSx использует символ подстановки при указании клиента.

Options -> (список)

Параметры для использования при подключении к файловой системе. Список параметров, которые можно использовать с Network File System (NFS), см. в справке exports(5) - Linux.

  • crossmnt используется по умолчанию. Если вы не укажете crossmnt при изменении конфигурации клиента, вы не сможете увидеть или получить доступ к снимкам в каталоге снимков файловой системы.
  • sync используется по умолчанию. Если вы вместо этого укажете async, система подтверждает записи перед записью на диск. Если система аварийно завершит работу до завершения записей, вы потеряете несохранённые данные.

(строка)

UserAndGroupQuotas -> (список)

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

(структура)

Используется для настройки квот, которые определяют, сколько места может использовать пользователь или группа на томе FSx for OpenZFS. Дополнительную информацию см. в разделе Свойства тома в руководстве пользователя FSx for OpenZFS.

Type -> (строка)

Указывает, относится ли квота к пользователю или группе.

Id -> (целое число)

Идентификатор пользователя или группы, к которой относится квота.

StorageCapacityQuotaGiB -> (целое число)

Квота места пользователя или группы в гибибайтах (GiB).

RestoreToSnapshot -> (строка)

Указывает идентификатор снимка, на который был восстановлен том.

DeleteIntermediateSnaphots -> (булево)

Булево значение, указывающее, должны ли снимки между текущим состоянием и указанным снимком удаляться при восстановлении тома со снимка.

DeleteClonedVolumes -> (булево)

Булево значение, указывающее, должны ли зависящие клонированные тома, созданные из промежуточных снимков, удаляться при восстановлении тома со снимка.

DeleteIntermediateData -> (булево)

Булево значение, указывающее, должны ли данные снимка, отличающиеся между текущим состоянием и указанным снимком, перезаписываться при восстановлении тома со снимка.

SourceSnapshotARN -> (строка)

Amazon Resource Name (ARN) для данного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. Нам необходим ARN, когда требуется однозначно указать ресурс во всех сервисах Amazon Web Services. Дополнительную информацию см. в разделе Имена ресурсов Amazon Resource Names (ARN) в Справочнике Amazon Web Services.

DestinationSnapshot -> (строка)

Идентификатор снимка, который копируется или был недавно скопирован в целевой том.

CopyStrategy -> (строка)

Указывает стратегию копирования данных со снимка в новый том.

  • CLONE - Новый том ссылается на данные в исходном снимке. Клонирование снимка быстрее, чем копирование данных со снимка в новый том, и не потребляет пропускную способность диска. Однако исходный снимок нельзя удалить, если его скопированные данные используются в томе.
  • FULL_COPY - Копирует все данные со снимка в новый том. Укажите этот параметр для создания тома на основе снимка другого файлового сервера FSx for OpenZFS.

Примечание

Опция INCREMENTAL_COPY используется только для обновления существующего тома с помощью снимка из другого файлового сервера FSx for OpenZFS. Дополнительную информацию см. в разделе CopySnapshotAndUpdateVolume.

TargetSnapshotValues -> (структура)

Снимок тома Amazon FSx для OpenZFS.

ResourceARN -> (строка)

Идентификатор Amazon Resource Name (ARN) данного ресурса. ARN уникально идентифицируют ресурсы Amazon Web Services. ARN необходим, когда требуется однозначно указать ресурс во всех сервисах Amazon Web Services. Дополнительную информацию см. в разделе Имена ресурсов Amazon Resource Names (ARN) в Общие сведения об Amazon Web Services.

SnapshotId -> (строка)

Идентификатор снимка.

Name -> (строка)

Название снимка.

VolumeId -> (строка)

Идентификатор тома, для которого сделан снимок.

CreationTime -> (метка времени)

Время создания ресурса, в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

Lifecycle -> (строка)

Состояние жизненного цикла снимка.

  • PENDING - Amazon FSx еще не начал создание снимка.
  • CREATING - Amazon FSx создает снимок.
  • DELETING - Amazon FSx удаляет снимок.
  • AVAILABLE - Снимок полностью доступен.

LifecycleTransitionReason -> (структура)

Описание причины изменения состояния жизненного цикла ресурса.

Message -> (строка)

Подробное сообщение об ошибке.

Tags -> (список)

Список значений тегов, с максимальным количеством 50 элементов.

(структура)

Определяет пару ключ-значение для тега ресурса.

Key -> (строка)

Значение, определяющее ключ тега, имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (строка)

Значение, определяющее значение тега, значение, присвоенное соответствующему ключу тега. Значения тегов могут быть null и не обязательно уникальными в наборе тегов. Например, вы можете иметь пару ключ-значение в наборе тегов finances : April и также payroll : April.

AdministrativeActions -> (список)

Список административных действий для файловой системы, которые выполняются или ожидают обработки. Административные действия описывают изменения в системе Amazon FSx.

(структура)

Описание конкретного административного действия Amazon FSx для текущей файловой системы Windows, Lustre, OpenZFS или ONTAP, или тома.

AdministrativeActionType -> (строка)

Описание типа административного действия:

  • FILE_SYSTEM_UPDATE - Административное действие обновления файловой системы, инициированное из консоли Amazon FSx, API (UpdateFileSystem ) или CLI (update-file-system ).
  • THROUGHPUT_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача THROUGHPUT_OPTIMIZATION. Вы можете отслеживать прогресс оптимизации хранилища с помощью свойства ProgressPercent. После успешного завершения THROUGHPUT_OPTIMIZATION, состояние родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED. Дополнительную информацию см. в разделе Управление пропускной способностью в руководстве пользователя Amazon FSx для Windows File Server.
  • STORAGE_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению емкости хранилища файловой системы запускается задача STORAGE_OPTIMIZATION.
    • Для Windows и ONTAP оптимизация хранилища — это процесс миграции данных файловой системы на новые более крупные диски.
    • Для Lustre оптимизация хранилища состоит из перераспределения данных по существующим и вновь добавленным файловым серверам.

Вы можете отслеживать прогресс оптимизации хранилища с помощью свойства ProgressPercent. После успешного завершения STORAGE_OPTIMIZATION, состояние родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED. Дополнительную информацию см. в разделе Управление емкостью хранилища в Руководстве пользователя Amazon FSx для Windows File Server, Управление емкостью хранилища в Руководстве пользователя Amazon FSx для Lustre и Управление емкостью хранилища и выделенной пропускной способностью IOPS в Руководстве пользователя Amazon FSx для NetApp ONTAP.

  • FILE_SYSTEM_ALIAS_ASSOCIATION - Обновление файловой системы для добавления нового псевдонима доменного имени системы (DNS) к файловой системе. Дополнительную информацию см. в разделе AssociateFileSystemAliases.
  • FILE_SYSTEM_ALIAS_DISASSOCIATION - Обновление файловой системы для отсоединения псевдонима DNS от файловой системы. Дополнительную информацию см. в разделе DisassociateFileSystemAliases.
  • IOPS_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача IOPS_OPTIMIZATION. Вы можете отслеживать прогресс оптимизации хранилища с помощью свойства ProgressPercent. После успешного завершения IOPS_OPTIMIZATION, состояние родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED. Дополнительную информацию см. в разделе Управление выделенной пропускной способностью SSD IOPS в руководстве пользователя Amazon FSx для Windows File Server.
  • STORAGE_TYPE_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача STORAGE_TYPE_OPTIMIZATION. Вы можете отслеживать прогресс оптимизации хранилища с помощью свойства ProgressPercent. После успешного завершения STORAGE_TYPE_OPTIMIZATION, состояние родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED.
  • VOLUME_UPDATE - Обновление тома Amazon FSx для OpenZFS, инициированное из консоли Amazon FSx, API (UpdateVolume ) или CLI (update-volume ).
  • VOLUME_RESTORE - Том Amazon FSx для OpenZFS возвращается в состояние, сохраненное указанным снимком, инициированное из API (RestoreVolumeFromSnapshot ) или CLI (restore-volume-from-snapshot ).
  • SNAPSHOT_UPDATE - Обновление снимка тома Amazon FSx для OpenZFS, инициированное из консоли Amazon FSx, API (UpdateSnapshot ) или CLI (update-snapshot ).
  • RELEASE_NFS_V3_LOCKS - Отслеживание освобождения блокировок NFS V3 в файловой системе Amazon FSx для OpenZFS.
  • DOWNLOAD_DATA_FROM_BACKUP - Восстановление резервной копии FSx для ONTAP на новый том на файловой системе второго поколения. После загрузки всех метаданных файла о томе, вы можете смонтировать том с чтением только для чтения. В процессе.
  • VOLUME_INITIALIZE_WITH_SNAPSHOT - Создание тома из снимка на другой файловой системе FSx для OpenZFS. Это можно инициировать из консоли Amazon FSx, API (CreateVolume ) или CLI (create-volume ), используя стратегию FULL_COPY.
  • VOLUME_UPDATE_WITH_SNAPSHOT - Обновление тома из снимка на другой файловой системе FSx для OpenZFS. Это можно инициировать из консоли Amazon FSx, API (CopySnapshotAndUpdateVolume ) или CLI (copy-snapshot-and-update-volume ).

ProgressPercent -> (целое число)

Процентное состояние завершения административного действия STORAGE_OPTIMIZATION или DOWNLOAD_DATA_FROM_BACKUP. Не применимо к другим типам административных действий.

RequestTime -> (метка времени)

Время получения запроса административного действия.

Status -> (строка)

Состояние административного действия:

  • FAILED - Amazon FSx не смог успешно обработать административное действие.
  • IN_PROGRESS - Amazon FSx обрабатывает административное действие.
  • PENDING - Amazon FSx ожидает обработки административного действия.
  • COMPLETED - Amazon FSx завершил обработку административной задачи. Для восстановления резервной копии резервной копии в файловую систему FSx для ONTAP второго поколения означает, что все данные были загружены в том, и клиенты теперь имеют доступ к тому для чтения и записи.
  • UPDATED_OPTIMIZING - При увеличении емкости хранилища Amazon FSx обновил файловую систему с новой емкостью хранилища и сейчас выполняет процесс оптимизации хранилища.
  • PENDING - Для восстановления резервной копии резервной копии в файловую систему FSx для ONTAP второго поколения означает, что метаданные файла загружаются в том. Состояние жизненного цикла тома — CREATING.
  • IN_PROGRESS - Для восстановления резервной копии резервной копии в файловую систему FSx для ONTAP второго поколения означает, что все метаданные были загружены в новый том, и клиенты имеют доступ к данным только для чтения, в то время как Amazon FSx загружает данные файла в том. Следите за прогрессом этого процесса с элементом ProgressPercent.

TargetFileSystemValues -> (структура)

Целевое значение для администрационного действия, предоставленное в операции UpdateFileSystem. Возвращается для административных действий FILE_SYSTEM_UPDATE.

OwnerId -> (строка)

Учетная запись Amazon Web Services, которая создала файловую систему. Если файловая система была создана пользователем в IAM Identity Center, учетной записью владельца является учетная запись Amazon Web Services, к которой принадлежит IAM-пользователь.

CreationTime -> (метка времени)

Время создания файловой системы в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

FileSystemId -> (строка)

Сгенерированный системой уникальный 17-значный идентификатор файловой системы.

FileSystemType -> (строка)

Тип файловой системы Amazon FSx, который может быть LUSTRE , WINDOWS , ONTAP или OPENZFS.

Lifecycle -> (строка)

Статус жизненного цикла файловой системы. Ниже приведены возможные значения и их значение:

  • AVAILABLE - Файловая система находится в нормальном состоянии, доступна и готова к использованию.
  • CREATING - Amazon FSx создаёт новую файловую систему.
  • DELETING - Amazon FSx удаляет существующую файловую систему.
  • FAILED - Существующая файловая система столкнулась с невосстановимым сбоем. При создании новой файловой системы Amazon FSx не смог создать файловую систему.
  • MISCONFIGURED - Файловая система находится в состоянии сбоя, но её можно восстановить.
  • MISCONFIGURED_UNAVAILABLE - (Только Amazon FSx для Windows File Server) Файловая система в данный момент недоступна из-за изменения конфигурации Active Directory.
  • UPDATING - Файловая система проходит обновление, инициированное клиентом.

FailureDetails -> (структура)

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

Message -> (строка)

Сообщение, описывающее любые произошедшие сбои.

StorageCapacity -> (целое число)

Ёмкость хранилища файловой системы в гибибайтах (GiB).

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса), если значение StorageCapacity выходит за пределы минимальных или максимальных значений.

StorageType -> (строка)

Тип хранилища, используемого файловой системой. Если установлено значение SSD, файловая система использует хранилище на твердотельных накопителях. Если установлено значение HDD, файловая система использует хранилище на жёстких дисках.

VpcId -> (строка)

Идентификатор основной виртуальной частной сети (VPC) для файловой системы.

SubnetIds -> (список)

Указывает идентификаторы подсетей, с которых доступна файловая система. Для развертывания файловой системы Amazon FSx Windows и ONTAP MULTI_AZ_1 есть два идентификатора подсетей: один для предпочтительного сервера файлов и один для резервного сервера файлов. Подсеть предпочтительного сервера файлов указана в свойстве PreferredSubnetID. Все остальные файловые системы имеют только один идентификатор подсети.

Для файловых систем FSx для Lustre и файловых систем Windows с одной зоной доступности (Single-AZ) это идентификатор подсети, содержащей конечную точку файловой системы. Для файловых систем MULTI_AZ_1 Windows и ONTAP конечная точка файловой системы доступна в PreferredSubnetID.

(строка)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашей виртуальной частной сети (VPC). Дополнительную информацию см. в разделе VPC и подсети в Руководстве пользователя Amazon VPC.

NetworkInterfaceIds -> (список)

Идентификаторы эластичных сетевых интерфейсов, с которых доступна определенная файловая система. Эластичный сетевой интерфейс автоматически создается в той же виртуальной частной сети (VPC), в которой была создана файловая система Amazon FSx. Дополнительную информацию см. в разделе Эластичные сетевые интерфейсы в Руководстве пользователя Amazon EC2.

Для файловой системы Amazon FSx для Windows File Server может быть один идентификатор сетевого интерфейса. Для файловой системы Amazon FSx для Lustre может быть более одного.

(строка)

Идентификатор эластичного сетевого интерфейса. Эластичный сетевой интерфейс — это логический сетевой компонент в виртуальной частной сети (VPC), представляющий собой виртуальную сетевую карту. Дополнительную информацию см. в разделе Эластичные сетевые интерфейсы в Руководстве пользователя Amazon EC2 для Linux-инстансов.

DNSName -> (строка)

Имя домена DNS для файловой системы.

KmsKeyId -> (строка)

Идентификатор ключа службы управления ключами (KMS), используемого для шифрования данных файловой системы Amazon FSx. Используется следующим образом с типами файловых систем Amazon FSx:

  • Amazon FSx для Lustre PERSISTENT_1 и PERSISTENT_2 типы развертывания только. SCRATCH_1 и SCRATCH_2 типы зашифрованы с использованием ключа KMS службы Amazon FSx для вашей учетной записи.
  • Amazon FSx для NetApp ONTAP
  • Amazon FSx для OpenZFS
  • Amazon FSx для Windows File Server

ResourceARN -> (строка)

Amazon Resource Name (ARN) ресурса файловой системы.

Tags -> (список)

Теги для ассоциации с файловой системой. Дополнительную информацию см. в разделе Размещение тегов ресурсов Amazon FSx в Руководстве пользователя Amazon FSx для Lustre.

(структура)

Указывает пару ключ-значение для тега ресурса.

Key -> (строка)

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

Value -> (строка)

Значение, которое указывает TagValue, значение, присвоенное соответствующему ключу тега. Значения тегов могут быть null и не обязательно должны быть уникальными в наборе тегов. Например, вы можете иметь пару ключ-значение в наборе тегов finances : April и также payroll : April.

WindowsConfiguration -> (структура)

Конфигурация файловой системы Amazon FSx для Windows File Server.

ActiveDirectoryId -> (строка)

Идентификатор существующего управляемого Microsoft Active Directory экземпляра Amazon Web Services, к которому присоединена файловая система.

SelfManagedActiveDirectoryConfiguration -> (структура)

Конфигурация автономного каталога Microsoft Active Directory (AD), к которому присоединена виртуальная машина Windows File Server или ONTAP хранилища (SVM).

DomainName -> (строка)

Полное доменное имя автономного каталога AD.

OrganizationalUnitDistinguishedName -> (строка)

Полное квалифицированное имя единицы организации в автономном каталоге AD, к которому присоединена виртуальная машина Windows File Server или ONTAP хранилища (SVM).

FileSystemAdministratorsGroup -> (строка)

Имя доменной группы, члены которой обладают административными привилегиями для файловой системы FSx.

UserName -> (строка)

Имя пользователя для учетной записи службы в автономном домене AD, которую FSx использует для подключения к вашему домену AD.

DnsIps -> (список)

Список из до трёх IP-адресов DNS-серверов или контроллеров домена в автономном каталоге AD.

(строка)

DeploymentType -> (строка)

Указывает тип развертывания файловой системы, допустимые значения:

  • MULTI_AZ_1 - Указывает высокодоступную файловую систему, настроенную для отказоустойчивости Multi-AZ, способную выдерживать временные сбои зоны доступности (AZ), поддерживает SSD и HDD хранилища.
  • SINGLE_AZ_1 - (По умолчанию) Указывает файловую систему, настроенную для отказоустойчивости Single AZ, поддерживает только SSD хранилища.
  • SINGLE_AZ_2 - Файловая система нового поколения Single AZ. Указывает файловую систему, настроенную для отказоустойчивости Single AZ и поддерживающую SSD и HDD хранилища.

Дополнительную информацию см. в разделе Однозонные и многозонные файловые системы.

RemoteAdministrationEndpoint -> (строка)

Для типов развертывания MULTI_AZ_1, используйте этот конечный пункт при выполнении административных задач на файловой системе с помощью Amazon FSx Remote PowerShell.

Для типов развертывания SINGLE_AZ_1 и SINGLE_AZ_2 это имя DNS файловой системы.

Этот конечный пункт временно недоступен, когда файловая система проходит техническое обслуживание.

PreferredSubnetId -> (строка)

Для типов развертывания MULTI_AZ_1, он указывает идентификатор подсети, где расположен предпочтительный файловый сервер. Должен быть одним из двух идентификаторов подсетей, указанных в свойстве SubnetIds. Amazon FSx обслуживает трафик из этой подсети, за исключением случая аварийного переключения на вторичный файловый сервер.

Для типов развертывания SINGLE_AZ_1 и SINGLE_AZ_2 это значение такое же, как у SubnetIDs. Дополнительную информацию см. в разделе Доступность и долговечность: однозонные и многозонные файловые системы.

PreferredFileServerIp -> (строка)

Для типов развертывания MULTI_AZ_1, IP-адрес первичного или предпочтительного файлового сервера.

Используйте этот IP-адрес при подключении файловой системы к клиентам SMB на Linux или Windows, которые не подключены к Microsoft Active Directory. Применимо ко всем типам развертывания файловых систем Windows. Этот IP-адрес временно недоступен во время технического обслуживания файловой системы. Для клиентов SMB Linux и Windows, подключенных к Active Directory, используйте DNSName файловой системы. Дополнительную информацию о сопоставлении и подключении общих папок см. в разделе Доступ к общим папкам.

ThroughputCapacity -> (целое число)

Пропускная способность файловой системы Amazon FSx, измеряемая в мегабайтах в секунду.

MaintenanceOperationsInProgress -> (список)

Список операций технического обслуживания, выполняемых для этой файловой системы.

(строка)

Перечисление текущей выполняемой операции технического обслуживания.

WeeklyMaintenanceStartTime -> (строка)

Предпочтительное время начала еженедельного технического обслуживания, отформатированное в формате d:ЧЧ:ММ в часовом поясе UTC. d - номер дня недели от 1 до 7, начиная с понедельника и заканчивая воскресеньем.

DailyAutomaticBackupStartTime -> (строка)

Предпочтительное время для ежедневного автоматического резервного копирования в часовом поясе UTC.

AutomaticBackupRetentionDays -> (целое число)

Количество дней хранения автоматических резервных копий. Установка значения 0 отключает автоматическое резервное копирование. Вы можете хранить автоматические резервные копии не более 90 дней.

CopyTagsToBackups -> (булево)

Флаг, указывающий, нужно ли копировать теги файловой системы в резервные копии. По умолчанию false. Если true, все теги файловой системы копируются во все автоматические резервные копии и любые резервные копии, созданные пользователем, где пользователь не указывает теги. Если true, и вы указываете один или несколько тегов, только указанные теги копируются в резервные копии. Если вы указываете один или несколько тегов при создании резервной копии пользователем, теги не копируются из файловой системы, независимо от этого значения.

Aliases -> (список)

Массив из одного или нескольких DNS-псевдонимов, в настоящее время связанных с файловой системой Amazon FSx. Псевдонимы позволяют использовать существующие имена DNS для доступа к данным в вашей файловой системе Amazon FSx. Вы можете связать до 50 псевдонимов с файловой системой одновременно. Вы можете связать дополнительные DNS-псевдонимы после создания файловой системы с помощью операции AssociateFileSystemAliases. Вы можете удалить DNS-псевдонимы из файловой системы после ее создания с помощью операции DisassociateFileSystemAliases. Вам нужно указать только имя псевдонима в теле запроса. Дополнительную информацию см. в разделе DNS-псевдонимы.

(структура)

DNS-псевдоним, связанный с файловой системой. Вы можете использовать DNS-псевдоним для доступа к файловой системе с помощью определенных пользователем имен DNS помимо стандартного имени DNS, которое Amazon FSx назначает файловой системе. Дополнительную информацию см. в разделе DNS-псевдонимы в Руководстве пользователя FSx для Windows File Server.

Name -> (строка)

Имя DNS-псевдонима. Имя псевдонима должно соответствовать следующим требованиям:

  • Отформатировано как полностью квалифицированное доменное имя (FQDN), hostname.domain, например, accounting.example.com.
  • Может содержать буквенно-цифровые символы, символ подчеркивания (_) и дефис (-).
  • Не может начинаться или заканчиваться дефисом.
  • Может начинаться с цифры.

Для имен DNS Amazon FSx хранит буквенные символы в нижнем регистре (a-z), независимо от того, как вы их указываете: как прописные буквы, строчные буквы или соответствующие буквы в кодах ссылок.

Lifecycle -> (строка)

Описание состояния DNS-псевдонима.

  • AVAILABLE - DNS-псевдоним связан с файловой системой Amazon FSx.
  • CREATING - Amazon FSx создаёт DNS-псевдоним и связывает его с файловой системой.
  • CREATE_FAILED - Amazon FSx не удалось связать DNS-псевдоним с файловой системой.
  • DELETING - Amazon FSx отсоединяет DNS-псевдоним от файловой системы и удаляет его.
  • DELETE_FAILED - Amazon FSx не удалось отсоединить DNS-псевдоним от файловой системы.

AuditLogConfiguration -> (структура)

Конфигурация, которую Amazon FSx для Windows File Server использует для аудита и регистрации пользовательских обращений к файлам, папкам и общим папкам в файловой системе Amazon FSx для Windows File Server.

FileAccessAuditLogLevel -> (строка)

Устанавливает, какой тип попытки регистрируется Amazon FSx для доступа к файлам и папкам.

  • SUCCESS_ONLY - регистрируются только успешные попытки доступа к файлам или папкам.
  • FAILURE_ONLY - регистрируются только неудачные попытки доступа к файлам или папкам.
  • SUCCESS_AND_FAILURE - регистрируются как успешные, так и неудачные попытки доступа к файлам или папкам.
  • DISABLED - аудит доступа к файлам и папкам выключен.

FileShareAccessAuditLogLevel -> (строка)

Устанавливает, какой тип попытки регистрируется Amazon FSx для доступа к общим папкам.

  • SUCCESS_ONLY - регистрируются только успешные попытки доступа к общим папкам.
  • FAILURE_ONLY - регистрируются только неудачные попытки доступа к общим папкам.
  • SUCCESS_AND_FAILURE - регистрируются как успешные, так и неудачные попытки доступа к общим папкам.
  • DISABLED - аудит доступа к общим папкам выключен.

AuditLogDestination -> (строка)

Amazon Resource Name (ARN) для назначения аудиторских журналов. Назначение может быть любой Amazon CloudWatch Logs группой журнала ARN или Amazon Kinesis Data Firehose потоком доставки ARN.

Имя группы журнала Amazon CloudWatch Logs должно начинаться с префикса /aws/fsx. Имя потока доставки Amazon Kinesis Data Firehose должно начинаться с префикса aws-fsx.

ARN назначения (группа журнала CloudWatch Logs или поток доставки Kinesis Data Firehose) должен находиться в том же разделе Amazon Web Services, регионе Amazon Web Services и учетной записи Amazon Web Services, что и ваша файловая система Amazon FSx.

DiskIopsConfiguration -> (структура)

Конфигурация SSD IOPS (ввод/вывод операций в секунду) для файловой системы Amazon FSx для Windows. По умолчанию Amazon FSx автоматически выделяет 3 IOPS на каждый ГБ емкости хранилища. Вы можете выделить дополнительные IOPS на каждый ГБ емкости хранилища до максимального предела, связанного с выбранной пропускной способностью.

Mode -> (строка)

Указывает, использует ли файловая система значение AUTOMATIC для SSD IOPS 3 IOPS на ГБ емкости хранилища или использует значение USER_PROVISIONED.

Iops -> (длинное целое число)

Общее количество выделенных SSD IOPS для файловой системы.

Минимальные и максимальные значения для этого свойства зависят от значения HAPairs и StorageCapacity. Минимальное значение вычисляется как StorageCapacity * 3 * HAPairs (3 IOPS на ГБ емкости StorageCapacity). Максимальное значение вычисляется как 200 000 * HAPairs.

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса), если значение Iops находится вне минимального или максимального значений.

LustreConfiguration -> (структура)

Настройка файловой системы Amazon FSx для Lustre.

WeeklyMaintenanceStartTime -> (строка)

Предпочтительное время начала еженедельного обслуживания, отформатированное как d:HH:MM в часовом поясе UTC. Здесь d — номер дня недели от 1 до 7, начиная с понедельника и заканчивая воскресеньем.

DataRepositoryConfiguration -> (структура)

Объект конфигурации хранилища данных для файловых систем Lustre, возвращаемый в ответе операции CreateFileSystem.

Этот тип данных не поддерживается для файловых систем с ассоциацией хранилища данных. Для файловых систем с ассоциацией хранилища данных см. .

Lifecycle -> (строка)

Описание состояния хранилища долговременных данных S3 файловой системы, если оно настроено с хранилищем S3. Жизненный цикл может иметь следующие значения:

  • CREATING — Настройка хранилища данных между файловой системой FSx и связанным хранилищем данных S3 создается. Хранилище данных недоступно.
  • AVAILABLE — Хранилище данных доступно для использования.
  • MISCONFIGURED — Amazon FSx не может автоматически импортировать обновления из ведра S3, пока конфигурация хранилища данных не будет исправлена. Дополнительную информацию см. в разделе Устранение неполадок при неправильной настройке связанного ведра S3.
  • UPDATING — Хранилище данных проходит обновление, инициированное пользователем, и доступность может быть затронута.
  • FAILED — Хранилище данных находится в терминальном состоянии, из которого невозможно восстановиться.

ImportPath -> (строка)

Путь импорта к ведру Amazon S3 (и необязательному префиксу), который вы используете в качестве хранилища данных для вашей файловой системы FSx для Lustre, например s3://import-bucket/optional-prefix . Если после имени ведра Amazon S3 указан префикс, в файловую систему загружаются только ключи объектов с этим префиксом.

ExportPath -> (строка)

Путь экспорта к ведру Amazon S3 (и префиксу), которое вы используете для хранения новых и измененных файлов файловой системы Lustre в S3.

ImportedFileChunkSize -> (целое число)

Для файлов, импортированных из хранилища данных, это значение определяет количество полос и максимальный объем данных на файл (в МБ) на одном физическом диске. Максимальное количество дисков, на которые может быть распределён один файл, ограничено общим количеством дисков, составляющих файловую систему.

Размер фрагмента по умолчанию составляет 1024 МБ (1 ГБ) и может достигать 512 000 МБ (500 ГБ). Объекты Amazon S3 имеют максимальный размер 5 ТБ.

AutoImportPolicy -> (строка)

Описание связанного хранилища данных S3 файловой системы. AutoImportPolicy. Конфигурация AutoImportPolicy определяет, как Amazon FSx поддерживает актуальность списков файлов и каталогов по мере добавления или изменения объектов в связанном ведре S3. AutoImportPolicy может иметь следующие значения:

  • NONE — (По умолчанию) Автоимпорт отключен. Amazon FSx обновляет списки файлов и каталогов из связанного ведра S3 только при создании файловой системы. После выбора этого параметра FSx не обновляет списки файлов и каталогов для новых или измененных объектов.
  • NEW — Автоимпорт включен. Amazon FSx автоматически импортирует списки каталогов любых новых объектов, добавленных в связанное ведро S3, которые в настоящее время не существуют в файловой системе FSx.
  • NEW_CHANGED — Автоимпорт включен. Amazon FSx автоматически импортирует списки файлов и каталогов любых новых объектов, добавленных в ведро S3, и любых существующих объектов, которые были изменены в ведре S3 после выбора этого параметра.
  • NEW_CHANGED_DELETED — Автоимпорт включен. Amazon FSx автоматически импортирует списки файлов и каталогов любых новых объектов, добавленных в ведро S3, любых существующих объектов, которые были изменены в ведре S3, и любых объектов, которые были удалены из ведра S3.

FailureDetails -> (структура)

Предоставляет подробную информацию о хранилище данных, если его Lifecycle установлено в MISCONFIGURED или FAILED.

Message -> (строка)

Подробное сообщение об ошибке.

DeploymentType -> (строка)

Тип развертывания файловой системы FSx для Lustre. Тип развертывания «Рабочая область» предназначен для временного хранения и краткосрочной обработки данных.

SCRATCH_1 и SCRATCH_2 типы развертывания лучше всего подходят для случаев, когда вам требуется временное хранилище и краткосрочная обработка данных. Тип развертывания SCRATCH_2 обеспечивает шифрование данных в процессе передачи и более высокую пропускную способность при всплесках, чем SCRATCH_1.

Тип развертывания PERSISTENT_1 и PERSISTENT_2 используется для долгосрочного хранения и рабочих нагрузок, а также шифрования данных в процессе передачи. PERSISTENT_2 предлагает более высокую PerUnitStorageThroughput (до 1000 МБ/с/ТБ) вместе с меньшими требованиями к минимальному объёму хранилища (600 ГБ). Чтобы узнать больше о типах развертывания FSx для Lustre, см. варианты развертывания FSx для Lustre.

По умолчанию — SCRATCH_1.

PerUnitStorageThroughput -> (целое число)

Пропускная способность хранения на единицу представляет собой количество мегабайт в секунду пропускной способности чтения или записи на каждый 1 тебибайт предоставленного хранилища. Пропускная способность файловой системы равна объёму хранилища (ТБ) * PerUnitStorageThroughput (МБ/с/ТБ). Этот параметр действителен только для типов развертывания PERSISTENT_1 и PERSISTENT_2.

Допустимые значения:

  • Для хранилища PERSISTENT_1 SSD: 50, 100, 200.
  • Для хранилища PERSISTENT_1 HDD: 12, 40.
  • Для хранилища PERSISTENT_2 SSD: 125, 250, 500, 1000.

MountName -> (строка)

Вы используете значение MountName при подключении файловой системы.

Для типа развертывания SCRATCH_1 это значение всегда «fsx ». Для типов развертывания SCRATCH_2, PERSISTENT_1 и PERSISTENT_2 это значение — строка, уникальная в пределах региона Amazon Web Services.

DailyAutomaticBackupStartTime -> (строка)

Ежедневное повторяющееся время в формате HH:MM. HH — нулевой час дня (0-23), а MM — нулевая минута часа. Например, 05:00 обозначает 5:00 ежедневно.

AutomaticBackupRetentionDays -> (целое число)

Количество дней для хранения автоматических резервных копий. Установка этого свойства в 0 отключает автоматические резервные копии. Вы можете хранить автоматические резервные копии не более 90 дней. По умолчанию — 30.

CopyTagsToBackups -> (логическое значение)

Логический флаг, указывающий, копируются ли теги файловой системы в резервные копии. Если он установлен в значение true, все теги файловой системы копируются во все автоматические резервные копии и в любые резервные копии, инициированные пользователем, где пользователь не указывает теги. Если это значение true, и вы указываете один или несколько тегов, копируются только указанные теги. Если вы указываете один или несколько тегов при создании резервной копии, инициированной пользователем, теги не копируются из файловой системы независимо от этого значения. (По умолчанию = false)

DriveCacheType -> (строка)

Тип кэша диска, используемый файловыми системами PERSISTENT_1, которые настроены с устройствами хранения HDD. Этот параметр необходим, когда StorageType — HDD. Если установлено значение READ, файловая система имеет кэш SSD-хранилища, размер которого составляет 20% от объема хранилища файловой системы. Это улучшает производительность часто используемых файлов, кэшируя до 20% общего объема хранилища.

Этот параметр необходим, когда StorageType установлено в HDD.

DataCompressionType -> (строка)

Настройка сжатия данных для файловой системы. DataCompressionType может иметь следующие значения:

  • NONE — Сжатие данных выключено для файловой системы.
  • LZ4 — Сжатие данных включено с алгоритмом LZ4.

Дополнительную информацию см. в разделе Сжатие данных Lustre.

LogConfiguration -> (структура)

Конфигурация ведения журнала Lustre. Ведение журнала Lustre записывает разрешённые события журнала для вашей файловой системы в Amazon CloudWatch Logs.

Level -> (строка)

События ведения журнала хранилища данных, регистрируемые Amazon FSx.

  • WARN_ONLY — регистрируются только предупреждения.
  • ERROR_ONLY — регистрируются только ошибки.
  • WARN_ERROR — регистрируются и предупреждения, и ошибки.
  • DISABLED — регистрация событий хранилища данных отключена.

Обратите внимание, что Amazon File Cache использует значение по умолчанию WARN_ERROR, которое нельзя изменить.

Destination -> (строка)

Идентификатор ресурса Amazon (ARN), указывающий место назначения журналов. Местом назначения может быть любой ARN группы журналов Amazon CloudWatch Logs. ARN места назначения должен находиться в том же подразделении Amazon Web Services, том же регионе Amazon Web Services и том же аккаунте Amazon Web Services, что и ваша файловая система Amazon FSx.

RootSquashConfiguration -> (структура)

Настройка сжатия корня Lustre для файловой системы Amazon FSx для Lustre. При включении сжатия корня ограничивается доступ на уровне корня со стороны клиентов, которые пытаются получить доступ к файловой системе от имени корневого пользователя.

RootSquash -> (строка)

Сжатие корня включается путём установки идентификатора пользователя (UID) и идентификатора группы (GID) для файловой системы в формате UID:GID (например, 365534:65534). Значения UID и GID могут находиться в диапазоне от 0 до 4294967294:

  • Не нулевые значения для UID и GID включают сжатие корня. Значения UID и GID могут отличаться, но каждое должно быть отличным от нуля.
  • Значение 0 (ноль) для UID и GID указывает на root и, следовательно, отключает сжатие корня.

При включенном сжатии корня идентификатор пользователя и идентификатор группы корневого пользователя, пытающегося получить доступ к файловой системе, переназначаются на предоставленные вами UID и GID.

NoSquashNids -> (список)

При включенном сжатии корня вы можете дополнительно указать массив NID клиентов, для которых сжатие корня не применяется. NID клиента — это идентификатор сети Lustre, используемый для уникальной идентификации клиента. Вы можете указать NID как отдельный адрес или диапазон адресов:

  • Один адрес описывается в стандартном формате NID Lustre, указанием IP-адреса клиента, за которым следует идентификатор сети Lustre (например, 10.0.1.6@tcp).
  • Диапазон адресов описывается с помощью дефиса, разделяющего диапазон (например, 10.0.[2-10].[1-255]@tcp).

(строка)

MetadataConfiguration -> (структура)

Настройка производительности метаданных Lustre для файловой системы Amazon FSx for Lustre с типом развертывания PERSISTENT_2.

Iops -> (целое число)

Количество метаданных IOPS, предоставленных для файловой системы. Допустимые значения — 1500 , 3000 , 6000 , 12000 и кратные 12000 до максимального значения 192000 .

Mode -> (строка)

Режим настройки метаданных для предоставления метаданных IOPS для файловой системы.

  • В режиме AUTOMATIC, FSx for Lustre автоматически предоставляет и масштабирует количество метаданных IOPS в вашей файловой системе на основе емкости хранения вашей файловой системы.
  • В режиме USER_PROVISIONED вы можете выбрать, какое количество метаданных IOPS предоставить для вашей файловой системы.

EfaEnabled -> (логическое значение)

Указывает, включена ли поддержка Elastic Fabric Adapter (EFA) и GPUDirect Storage (GDS) для файловой системы Amazon FSx for Lustre.

OntapConfiguration -> (структура)

Настройка этой файловой системы Amazon FSx for NetApp ONTAP.

AutomaticBackupRetentionDays -> (целое число)

Количество дней, в течение которых сохраняются автоматические резервные копии. Установка этого свойства в значение 0 отключает автоматические резервные копии. Вы можете сохранять автоматические резервные копии максимум на 90 дней. Значение по умолчанию — 30 .

DailyAutomaticBackupStartTime -> (строка)

Ежедневное время, повторяющееся по расписанию, в формате HH:MM . HH — это заполненное нулями значение часа дня (0-23), а MM — это заполненное нулями значение минуты часа. Например, 05:00 означает 5:00 ежедневно.

DeploymentType -> (строка)

Указывает тип развертывания файловой системы FSx for ONTAP, используемой в файловой системе.

  • MULTI_AZ_1 — высокодоступная файловая система, настроенная для многозонной избыточности, чтобы переносить временную недоступность зоны доступности (AZ). Это файловая система первого поколения FSx for ONTAP.
  • MULTI_AZ_2 — высокодоступная файловая система, настроенная для многозонной избыточности, чтобы переносить временную недоступность зоны доступности (AZ). Это файловая система второго поколения FSx for ONTAP.
  • SINGLE_AZ_1 — файловая система, настроенная для однозонной избыточности. Это файловая система первого поколения FSx for ONTAP.
  • SINGLE_AZ_2 — файловая система, настроенная с несколькими парами высокодоступности (HA) для однозонной избыточности. Это файловая система второго поколения FSx for ONTAP.

Для получения информации о вариантах использования многозонных и однозонных развертываний см. Выбор развертывания файловой системы Multi-AZ или Single-AZ.

EndpointIpAddressRange -> (строка)

(Только Multi-AZ) Указывает диапазон IP-адресов, в котором будут созданы конечные точки доступа к вашей файловой системе. По умолчанию в API Amazon FSx Amazon FSx выбирает для вас неиспользуемый диапазон IP-адресов из диапазона 198.19.*. По умолчанию в консоли Amazon FSx Amazon FSx выбирает последние 64 IP-адреса из основного диапазона CIDR VPC для использования в качестве диапазона IP-адресов конечных точек для файловой системы. Вы можете иметь перекрывающиеся IP-адреса конечных точек для файловых систем, развернутых в одном VPC/таблицах маршрутизации.

Endpoints -> (структура)

Конечные точки Management и Intercluster, которые используются для доступа к данным или для управления файловой системой с помощью NetApp ONTAP CLI, REST API или NetApp SnapMirror.

Intercluster -> (структура)

Конечная точка для управления вашей файловой системой путем настройки NetApp SnapMirror с другими системами ONTAP.

DNSName -> (строка)

Имя DNS файловой системы. Вы можете подключиться к вашей файловой системе, используя ее имя DNS.

IpAddresses -> (список)

IP-адреса конечной точки файловой системы.

(строка)

Management -> (структура)

Конечная точка для управления вашей файловой системой с помощью NetApp ONTAP CLI и NetApp ONTAP API.

DNSName -> (строка)

Имя DNS файловой системы. Вы можете подключиться к вашей файловой системе, используя ее имя DNS.

IpAddresses -> (список)

IP-адреса конечной точки файловой системы.

(строка)

DiskIopsConfiguration -> (структура)

Настройка IOPS SSD для файловой системы ONTAP, определяющая количество предоставленных IOPS и режим предоставления.

Mode -> (строка)

Указывает, использует ли файловая система значение AUTOMATIC для IOPS SSD 3 IOPS на 1 ГБ емкости хранения, или же она использует значение USER_PROVISIONED.

Iops -> (длинное целое число)

Общее количество предоставленных IOPS SSD для файловой системы.

Минимальные и максимальные значения для этого свойства зависят от значений HAPairs и StorageCapacity . Минимальное значение рассчитывается как StorageCapacity * 3 * HAPairs (3 IOPS на ГБ емкости StorageCapacity ). Максимальное значение рассчитывается как 200 000 * HAPairs.

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса), если значение Iops выходит за пределы минимального или максимального значений.

PreferredSubnetId -> (строка)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашей виртуальной частной сети (VPC). Дополнительную информацию см. в разделе VPC и подсети в Руководстве пользователя Amazon VPC.

RouteTableIds -> (список)

(Только Multi-AZ) Таблицы маршрутизации VPC, в которых создаются конечные точки вашей файловой системы.

(строка)

ThroughputCapacity -> (целое число)

Непрерывная пропускная способность файловой системы Amazon FSx в мегабайтах в секунду (MBps).

WeeklyMaintenanceStartTime -> (строка)

Еженедельное время, повторяющееся по расписанию, в формате D:HH:MM .

D — это день недели, где 1 соответствует понедельнику, а 7 — воскресенью. Подробнее см. спецификацию ISO-8601, описанную на Wikipedia.

HH — это заполненное нулями значение часа дня (0-23), а MM — это заполненное нулями значение минуты часа.

Например, 1:05:00 указывает техническое обслуживание в 5:00 понедельника.

FsxAdminPassword -> (строка)

Вы можете использовать учетную запись пользователя fsxadmin для доступа к NetApp ONTAP CLI и REST API. Значение пароля всегда скрывается в ответе.

HAPairs -> (целое число)

Указывает, сколько пар серверов файловой системы высокой доступности (HA) будет у файловой системы. Значение по умолчанию — 1. Это свойство влияет на значения StorageCapacity , Iops и ThroughputCapacity . Дополнительную информацию см. в руководстве пользователя FSx for ONTAP в разделе «Пары высокой доступности (HA)».

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса) в следующих случаях:

  • Значение HAPairs меньше 1 или больше 12.
  • Значение HAPairs больше 1, а значение DeploymentType равно SINGLE_AZ_1 , MULTI_AZ_1 или MULTI_AZ_2.

ThroughputCapacityPerHAPair -> (целое число)

Используйте для выбора пропускной способности на пару высокой доступности (HA). Если значение HAPairs равно 1, то значение ThroughputCapacityPerHAPair — это общая пропускная способность для файловой системы.

Это поле и ThroughputCapacity не могут быть определены в одном вызове API, но одно из них обязательно.

Это поле и ThroughputCapacity одинаковы для файловых систем с одной парой HA.

  • Для файловых систем SINGLE_AZ_1 и MULTI_AZ_1 допустимые значения составляют 128, 256, 512, 1024, 2048 или 4096 Мбит/с.
  • Для SINGLE_AZ_2 допустимые значения составляют 1536, 3072 или 6144 Мбит/с.
  • Для MULTI_AZ_2 допустимые значения составляют 384, 768, 1536, 3072 или 6144 Мбит/с.

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса) в следующих случаях:

  • Значения ThroughputCapacity и ThroughputCapacityPerHAPair не совпадают.
  • Значение типа развертывания равно SINGLE_AZ_2, а ThroughputCapacity / ThroughputCapacityPerHAPair не является допустимой парой HA (значение от 1 до 12).
  • Значение ThroughputCapacityPerHAPair не является допустимым.

FileSystemTypeVersion -> (строка)

Версия Lustre файловой системы Amazon FSx for Lustre, которая может быть 2.10 , 2.12 или 2.15.

OpenZFSConfiguration -> (структура)

Конфигурация этого файлового сервера Amazon FSx для OpenZFS.

AutomaticBackupRetentionDays -> (целое число)

Количество дней, в течение которых необходимо хранить автоматические резервные копии. Установка этого свойства в значение 0 отключает автоматические резервные копии. Вы можете хранить автоматические резервные копии не более 90 дней. По умолчанию значение равно 30 .

CopyTagsToBackups -> (булево)

Булево значение, указывающее, следует ли копировать теги файловой системы в резервные копии. Если это значение равно true , все теги файловой системы копируются во все автоматические резервные копии и в любые резервные копии, созданные пользователем, где пользователь не указывает теги. Если это значение равно true и вы указываете один или несколько тегов, то только указанные теги копируются в резервные копии. Если вы указываете один или несколько тегов при создании резервной копии, созданной пользователем, никакие теги не копируются из файловой системы, независимо от этого значения.

CopyTagsToVolumes -> (булево)

Булево значение, указывающее, следует ли копировать теги тома в снимки. По умолчанию это значение равно false . Если это значение равно true , все теги тома копируются в снимки, где пользователь не указывает теги. Если это значение равно true и вы указываете один или несколько тегов, то только указанные теги копируются в снимки. Если вы указываете один или несколько тегов при создании снимка, никакие теги не копируются из тома, независимо от этого значения.

DailyAutomaticBackupStartTime -> (строка)

Ежедневное время, повторяющееся, в формате HH:MM . HH — это двузначный час (0-23), а MM — это двузначная минута часа. Например, 05:00 — это 5:00 ежедневно.

DeploymentType -> (строка)

Указывает тип развертывания файловой системы. Amazon FSx для OpenZFS поддерживает MULTI_AZ_1 , SINGLE_AZ_HA_2 , SINGLE_AZ_HA_1 , SINGLE_AZ_2 и SINGLE_AZ_1 .

ThroughputCapacity -> (целое число)

Пропускная способность файловой системы Amazon FSx, измеряемая в мегабайтах в секунду (МБ/с).

WeeklyMaintenanceStartTime -> (строка)

Еженедельное время, повторяющееся, в формате D:HH:MM .

D — это день недели, где 1 соответствует понедельнику, а 7 — воскресенью. Более подробную информацию см. в спецификации ISO-8601, описанной на Википедии.

HH — это двузначный час (0-23), а MM — это двузначная минута часа.

Например, 1:05:00 указывает техническое обслуживание в 5:00 понедельника.

DiskIopsConfiguration -> (структура)

Конфигурация SSD IOPS (операций ввода/вывода в секунду) для файловой системы Amazon FSx для NetApp ONTAP, Amazon FSx для Windows File Server или FSx для OpenZFS. По умолчанию Amazon FSx автоматически выделяет 3 IOPS на 1 ГБ емкости хранилища. Вы можете выделить дополнительные IOPS на 1 ГБ емкости хранилища. Конфигурация состоит из общего количества выделенных SSD IOPS и способа их выделения или режима (клиентом или Amazon FSx).

Mode -> (строка)

Указывает, использует ли файловая система настройку AUTOMATIC SSD IOPS в 3 IOPS на 1 ГБ емкости хранилища или использует значение USER_PROVISIONED.

Iops -> (длинное целое число)

Общее количество выделенных SSD IOPS для файловой системы.

Минимальные и максимальные значения для этого свойства зависят от значения HAPairs и StorageCapacity . Минимальное значение вычисляется как StorageCapacity * 3 * HAPairs (3 IOPS на 1 ГБ емкости StorageCapacity). Максимальное значение вычисляется как 200 000 * HAPairs.

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса), если значение Iops находится вне минимального или максимального значений.

RootVolumeId -> (строка)

Идентификатор корневого тома файловой системы OpenZFS.

PreferredSubnetId -> (строка)

Требуется, когда DeploymentType установлено в значение MULTI_AZ_1. Это указывает подсеть, в которой вы хотите разместить предпочтительный файловый сервер.

EndpointIpAddressRange -> (строка)

(Только для Multi-AZ) Указывает диапазон IP-адресов, в котором будут созданы конечные точки для доступа к файловой системе. По умолчанию в API Amazon FSx и консоли Amazon FSx Amazon FSx выбирает для вас доступный диапазон IP-адресов /28 из одного из диапазонов CIDR VPC. Вы можете иметь перекрывающиеся IP-адреса конечных точек для файловых систем, развернутых в одной VPC/таблице маршрутизации.

RouteTableIds -> (список)

(Только для Multi-AZ) Таблицы маршрутизации VPC, в которых создаются конечные точки вашей файловой системы.

(строка)

EndpointIpAddress -> (строка)

IP-адрес конечной точки, используемой для доступа к данным или управления файловой системой.

ReadCacheConfiguration -> (структура)

Требуется, когда StorageType установлено в значение INTELLIGENT_TIERING. Указывает необязательный кэш чтения SSD.

SizingMode -> (строка)

Указывает, как размер кэша чтения SSD задается следующим образом:

  • Установите значение NO_CACHE, если вы не хотите использовать кэш чтения SSD с файловой системой Intelligent-Tiering.
  • Установите значение USER_PROVISIONED, чтобы указать точный размер кэша чтения SSD.
  • Установите значение PROPORTIONAL_TO_THROUGHPUT_CAPACITY, чтобы кэш чтения SSD был автоматически настроен на основе вашей пропускной способности.

SizeGiB -> (целое число)

Требуется, если SizingMode установлено в значение USER_PROVISIONED. Указывает размер кэша чтения SSD файловой системы в гигабайтах (GiB).

FailureDetails -> (структура)

Предоставляет информацию об ошибочном административном действии.

Message -> (строка)

Сообщение об ошибке, предоставляющее подробности об ошибочном административном действии.

TargetVolumeValues -> (структура)

Описание тома Amazon FSx.

CreationTime -> (отметка времени)

Время создания ресурса в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

FileSystemId -> (строка)

Глобально уникальный идентификатор файловой системы, присвоенный Amazon FSx.

Lifecycle -> (строка)

Статус жизненного цикла тома.

  • AVAILABLE - Том полностью готов к использованию.
  • CREATED - Том был создан.
  • CREATING - Amazon FSx создает новый том.
  • DELETING - Amazon FSx удаляет существующий том.
  • FAILED - Amazon FSx не смог создать том.
  • MISCONFIGURED - Том находится в состоянии ошибки, но может быть восстановлен.
  • PENDING - Amazon FSx еще не начал создание тома.

Name -> (строка)

Имя тома.

OntapConfiguration -> (структура)

Настройка тома Amazon FSx for NetApp ONTAP.

FlexCacheEndpointType -> (строка)

Указывает тип конечной точки FlexCache для тома. Допустимые значения следующие:

  • NONE указывает, что у тома нет конфигурации FlexCache. NONE — значение по умолчанию.
  • ORIGIN указывает, что том является исходным томом для тома FlexCache.
  • CACHE указывает, что том является томом FlexCache.

JunctionPath -> (строка)

Указывает каталог, который клиенты NAS используют для подключения тома, вместе с именем домена системы доменных имен (DNS) или IP-адресом виртуальной машины хранения (SVM). Вы можете создать JunctionPath непосредственно под родительским узлом соединения тома или в каталоге внутри тома. JunctionPath для тома под именем vol3 может быть /vol1/vol2/vol3 , или /vol1/dir2/vol3 , или даже /dir1/dir2/vol3 .

SecurityStyle -> (строка)

Стиль безопасности тома, который может быть UNIX , NTFS или MIXED .

SizeInMegabytes -> (целое число)

Настроенный размер тома в мегабайтах (МБ).

StorageEfficiencyEnabled -> (булево значение)

Настройка эффективности хранения тома.

StorageVirtualMachineId -> (строка)

Идентификатор виртуальной машины хранения тома.

StorageVirtualMachineRoot -> (булево значение)

Логическое значение, указывающее, является ли данный том корневым томом для его виртуальной машины хранения (SVM). Только один том на SVM может быть корневым. По умолчанию это значение false . Если это значение true , то это корневой том SVM.

Это поле полезно при удалении SVM, поскольку необходимо сначала удалить все некорневые тома. Это значение, установленное в false , помогает определить, какие тома следует удалить перед удалением SVM.

TieringPolicy -> (структура)

Настройка политики TieringPolicy тома.

CoolingPeriod -> (целое число)

Указывает количество дней, в течение которых данные пользователя в томе должны оставаться неактивными, прежде чем они считаются «холодными» и перемещаются в пул емкости. Используется с политиками тиеринга AUTO и SNAPSHOT_ONLY. Введите целое число от 2 до 183. Значения по умолчанию составляют 31 день для AUTO и 2 дня для SNAPSHOT_ONLY.

Name -> (строка)

Указывает политику тиеринга, используемую для перемещения данных. Значение по умолчанию — SNAPSHOT_ONLY.

  • SNAPSHOT_ONLY - перемещает холодные снимки в хранилище пула емкости.
  • AUTO - перемещает холодные данные пользователей и снимки в хранилище пула емкости на основе ваших шаблонов доступа.
  • ALL - перемещает все блоки данных пользователей как в активной файловой системе, так и в копиях снимков в хранилище пула.
  • NONE - сохраняет данные тома в основном хранилище, предотвращая их перемещение в хранилище пула емкости.

UUID -> (строка)

Универсальный уникальный идентификатор (UUID) тома.

OntapVolumeType -> (строка)

Указывает тип тома. Допустимые значения следующие:

  • RW указывает том для чтения/записи. RW — значение по умолчанию.
  • DP указывает том для защиты данных. Вы можете защищать данные, дублируя их в зеркальные копии защиты данных. При возникновении катастрофы вы можете использовать эти зеркальные копии защиты данных для восстановления данных.
  • LS указывает том для совместного использования нагрузки. Зеркало для совместного использования нагрузки снижает сетевой трафик для тома FlexVol, обеспечивая дополнительный доступ для чтения для клиентов.

SnapshotPolicy -> (строка)

Указывает политику снимка для тома. Существует три встроенные политики снимка:

  • default : Это политика по умолчанию. Максимальное количество снимков — шесть ежечасно, через пять минут после часа. Максимальное количество снимков в день — два, с понедельника по субботу в 10 минут после полуночи. Максимальное количество еженедельных снимков — два, каждое воскресенье в 15 минут после полуночи.
  • default-1weekly : Эта политика аналогична политике default, за исключением того, что она сохраняет только один снимок из еженедельного расписания.
  • none : Эта политика не создает никаких снимков. Эту политику можно назначить томам, чтобы предотвратить автоматическое создание снимков.

Вы также можете указать имя настраиваемой политики, созданной с помощью ONTAP CLI или REST API.

Дополнительные сведения см. в руководстве пользователя Amazon FSx for NetApp ONTAP в разделе «Политики снимков».

CopyTagsToBackups -> (булево значение)

Логическое значение, указывающее, следует ли копировать теги тома в резервные копии. По умолчанию это значение false. Если оно установлено в true, все теги тома копируются во все автоматические и инициированные пользователем резервные копии, в которых пользователь не указывает теги. Если это значение true, а вы указываете один или несколько тегов, копируются только указанные теги. Если вы указываете один или несколько тегов при создании резервной копии, инициированной пользователем, теги не копируются из тома независимо от этого значения.

SnaplockConfiguration -> (структура)

Объект конфигурации SnapLock для тома SnapLock FSx для ONTAP.

AuditLogVolume -> (boolean)

Включает или отключает том журнала аудита для тома SnapLock FSx для ONTAP. Значение по умолчанию — false. Если вы установите AuditLogVolume в true, том SnapLock создается как том журнала аудита. Минимальный срок хранения для тома журнала аудита составляет шесть месяцев.

Дополнительную информацию см. в разделе Журналы аудита SnapLock.

AutocommitPeriod -> (структура)

Объект конфигурации для настройки периода автоматического сохранения файлов в томе SnapLock FSx для ONTAP.

Type -> (строка)

Определяет тип времени для периода автоматического сохранения файла в томе SnapLock FSx для ONTAP. Установка этого значения в NONE отключает автоматическое сохранение. Значение по умолчанию — NONE.

Value -> (целое число)

Определяет продолжительность периода автоматического сохранения файла в томе SnapLock FSx для ONTAP. Допустимые диапазоны:

  • Minutes : 5 - 65 535
  • Hours : 1 - 65 535
  • Days : 1 - 3 650
  • Months : 1 - 120
  • Years : 1 - 10

PrivilegedDelete -> (строка)

Включает, отключает или навсегда отключает привилегированное удаление в томе SnapLock Enterprise FSx для ONTAP. Включение привилегированного удаления позволяет администраторам SnapLock удалять файлы WORM (write once, read many), даже если у них активны периоды хранения. PERMANENTLY_DISABLED — конечное состояние. Если привилегированное удаление навсегда отключено для тома SnapLock, его нельзя включить заново. Значение по умолчанию — DISABLED.

Дополнительную информацию см. в разделе Привилегированное удаление.

RetentionPeriod -> (структура)

Указывает период хранения для тома SnapLock FSx для ONTAP.

DefaultRetention -> (структура)

Период хранения, который назначается файлу WORM по умолчанию, если явное значение периода хранения не задано для тома SnapLock FSx для ONTAP. Период хранения по умолчанию должен быть больше или равен минимальному периоду хранения и меньше или равен максимальному периоду хранения.

Type -> (строка)

Определяет тип времени для периода хранения тома SnapLock FSx для ONTAP. Установите одно из допустимых значений. Если вы установите INFINITE, файлы хранятся постоянно. Если вы установите UNSPECIFIED, файлы хранятся до тех пор, пока вы не зададите явный период хранения.

Value -> (целое число)

Определяет продолжительность периода хранения тома SnapLock FSx для ONTAP. Значение не может быть установлено для INFINITE или UNSPECIFIED. Для всех остальных вариантов допустимые диапазоны:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

MinimumRetention -> (структура)

Наименьший период хранения, который может быть назначен файлу WORM в томе SnapLock FSx для ONTAP.

Type -> (строка)

Определяет тип времени для периода хранения тома SnapLock FSx для ONTAP. Установите одно из допустимых значений. Если вы установите INFINITE, файлы хранятся постоянно. Если вы установите UNSPECIFIED, файлы хранятся до тех пор, пока вы не зададите явный период хранения.

Value -> (целое число)

Определяет продолжительность периода хранения тома SnapLock FSx для ONTAP. Значение не может быть установлено для INFINITE или UNSPECIFIED. Для всех остальных вариантов допустимые диапазоны:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

MaximumRetention -> (структура)

Наибольший период хранения, который может быть назначен файлу WORM в томе SnapLock FSx для ONTAP.

Type -> (строка)

Определяет тип времени для периода хранения тома SnapLock FSx для ONTAP. Установите одно из допустимых значений. Если вы установите INFINITE, файлы хранятся постоянно. Если вы установите UNSPECIFIED, файлы хранятся до тех пор, пока вы не зададите явный период хранения.

Value -> (целое число)

Определяет продолжительность периода хранения тома SnapLock FSx для ONTAP. Значение не может быть установлено для INFINITE или UNSPECIFIED. Для всех остальных вариантов допустимые диапазоны:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

SnaplockType -> (строка)

Указывает режим хранения тома SnapLock FSx для ONTAP. После установки его изменить нельзя. Вы можете выбрать один из следующих режимов хранения:

  • COMPLIANCE : Файлы, переведенные в режим WORM (write once, read many) на томе Compliance, нельзя удалить до истечения срока хранения. Этот режим хранения используется для соблюдения правительственных или отраслевых требований или для защиты от атак ransomware. Дополнительную информацию см. в разделе SnapLock Compliance.
  • ENTERPRISE : Файлы, переведенные в режим WORM на томе Enterprise, могут быть удалены авторизованными пользователями до истечения срока хранения с помощью привилегированного удаления. Этот режим хранения используется для повышения целостности данных и соответствия внутренним требованиям организации, а также для проверки настроек хранения перед использованием SnapLock Compliance. Дополнительную информацию см. в разделе SnapLock Enterprise.

VolumeAppendModeEnabled -> (boolean)

Включает или отключает режим добавления к томам для тома SnapLock FSx для ONTAP. Режим добавления к томам позволяет создавать файлы WORM и добавлять к ним данные по частям. Значение по умолчанию — false.

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

VolumeStyle -> (строка)

Используйте для указания стиля тома ONTAP. Дополнительную информацию о FlexVols и FlexGroups см. в руководстве пользователя Amazon FSx для NetApp ONTAP.

AggregateConfiguration -> (структура)

Эта структура определяет параметры конфигурации для агрегата хранения или агрегатов тома.

Aggregates -> (список)

Список агрегатов, на которых находится этот том. Агрегаты — это хранилища, которые составляют основной уровень хранения. У каждой пары высокой доступности (HA) есть один агрегат. Имена агрегатов соответствуют именам агрегатов в ONTAP CLI и REST API. Для FlexVols всегда будет одна запись.

Amazon FSx возвращает код состояния HTTP 400 (Bad Request) при следующих условиях:

  • Строки в значении Aggregates не отформатированы как aggrX, где X — число от 1 до 12.
  • Значение Aggregates содержит агрегаты, которых нет.
  • Один или несколько указанных агрегатов слишком близки к лимиту томов для поддержки добавления других томов.

(строка)

TotalConstituents -> (целое число)

Общее количество составляющих этого тома FlexGroup. Не относится к FlexVols.

SizeInBytes -> (длинное целое число)

Настроенный размер тома в байтах.

ResourceARN -> (строка)

Идентификатор ресурса Amazon (ARN) для данного ресурса. ARN уникально идентифицируют ресурсы Amazon Web Services. ARN требуется, когда необходимо однозначно указать ресурс во всех службах Amazon Web Services. Дополнительную информацию см. в разделе Идентификаторы ресурсов Amazon (ARN) в справочнике Amazon Web Services.

Tags -> (список)

Список значений тегов Tag с максимальным количеством элементов 50.

(структура)

Указывает пару ключ-значение для тега ресурса.

Key -> (строка)

Значение, определяющее TagKey, имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (строка)

Значение, определяющее TagValue, значение, назначенное соответствующему ключу тега. Значения тегов могут быть пустыми и не обязательно должны быть уникальными в наборе тегов. Например, в наборе тегов может быть пара ключ-значение finances : April, а также payroll : April.

VolumeId -> (строка)

Сгенерированный системой уникальный идентификатор тома.

VolumeType -> (строка)

Тип тома.

LifecycleTransitionReason -> (структура)

Причина изменения статуса жизненного цикла тома.

Message -> (строка)

Подробное сообщение об ошибке.

OpenZFSConfiguration -> (структура)

Конфигурация тома Amazon FSx for OpenZFS.

ParentVolumeId -> (строка)

Идентификатор родительского тома.

VolumePath -> (строка)

Путь к тому от корневого тома. Например, fsx/parentVolume/volume1 .

StorageCapacityReservationGiB -> (целое число)

Количество резервируемого пространства в гибибайтах (GiB) от родительского тома. Вы не можете зарезервировать больше пространства, чем зарезервировано в родительском томе.

StorageCapacityQuotaGiB -> (целое число)

Максимальное количество пространства в гибибайтах (GiB), которое может использовать том от родительского. Вы можете указать квоту, превышающую пространство на родительском томе.

RecordSizeKiB -> (целое число)

Размер записи тома OpenZFS в кибибайтах (KiB). Допустимые значения: 4, 8, 16, 32, 64, 128, 256, 512 или 1024 KiB. По умолчанию 128 KiB. Большинству рабочих нагрузок следует использовать значение по умолчанию. Инструкции по настройке пользовательского размера записи см. в руководстве пользователя Amazon FSx for OpenZFS.

DataCompressionType -> (строка)

Указывает метод сжатия данных в томе. Тип сжатия задаётся по умолчанию как NONE.

  • NONE - Данные в томе не сжимаются. NONE - значение по умолчанию.
  • ZSTD - Сжатие данных в томе с помощью алгоритма Zstandard (ZSTD). По сравнению с LZ4, Z-Standard обеспечивает лучшую степень сжатия для минимизации использования места на диске.
  • LZ4 - Сжатие данных в томе с помощью алгоритма LZ4. По сравнению с Z-Standard, LZ4 требует меньших вычислительных ресурсов и обеспечивает более высокую скорость записи.

CopyTagsToSnapshots -> (булево)

Булево значение, указывающее, следует ли копировать теги тома в снимки. По умолчанию это значение равно false . Если оно установлено в значение true, все теги тома копируются в снимки, в которых пользователь не указывает теги. Если это значение равно true и вы укажите один или несколько тегов, то в снимки будут скопированы только указанные теги. Если при создании снимка вы укажете один или несколько тегов, то теги не будут скопированы из тома, независимо от этого значения.

OriginSnapshot -> (структура)

Объект конфигурации, который определяет снимок, используемый в качестве источника данных для тома.

SnapshotARN -> (строка)

Идентификатор ресурса Amazon (ARN) для данного ресурса. ARNs уникально идентифицируют ресурсы Amazon Web Services. ARN необходим для однозначной идентификации ресурса в Amazon Web Services. Дополнительную информацию см. в разделе Amazon Resource Names (ARNs) в Справочнике по Amazon Web Services.

CopyStrategy -> (строка)

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

  • CLONE - Новый том ссылается на данные в исходном снимке. Клонирование снимка быстрее, чем копирование данных со снимка в новый том, и не потребляет пропускную способность диска. Однако исходный снимок нельзя удалить, если его скопированные данные используются томом.
  • FULL_COPY - Все данные со снимка копируются в новый том.

Примечание

Вариант INCREMENTAL_COPY используется только для обновления существующего тома с помощью снимка из другого файловой системы FSx for OpenZFS. Дополнительную информацию см. в разделе CopySnapshotAndUpdateVolume.

ReadOnly -> (булево)

Булево значение, указывающее, является ли том только для чтения.

NfsExports -> (список)

Объект конфигурации для подключения файловой системы Network File System (NFS).

(структура)

Конфигурации Network File System (NFS) для подключения файловой системы Amazon FSx for OpenZFS.

ClientConfigurations -> (список)

Список объектов конфигурации, содержащих клиента и параметры для подключения файловой системы OpenZFS.

(структура)

Указывает, кто может подключиться к файловой системе OpenZFS и какие параметры доступны при подключении к файловой системе.

Clients -> (строка)

Значение, указывающее, кто может подключиться к файловой системе. Вы можете указать символ подстановки (*), IP-адрес (0.0.0.0) или адрес CIDR (192.0.2.0/24). По умолчанию Amazon FSx использует символ подстановки при указании клиента.

Options -> (список)

Параметры для использования при подключении к файловой системе. Список параметров для Network File System (NFS) см. в справочной странице man для exports(5) - Linux. При выборе параметров учтите следующее:

  • crossmnt используется по умолчанию. Если при изменении конфигурации клиента не указать crossmnt, вы не сможете просмотреть или получить доступ к снимкам в каталоге снимков файловой системы.
  • sync используется по умолчанию. Если вместо этого указать async, система подтверждает записи перед записью на диск. Если система завершается сбоем до завершения записей, не записанные данные потеряны.

(строка)

UserAndGroupQuotas -> (список)

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

(структура)

Используется для настройки квот, которые определяют, сколько пространства могут использовать пользователь или группа в томе FSx for OpenZFS. Дополнительную информацию см. в разделе Свойства томов в руководстве пользователя FSx for OpenZFS.

Type -> (строка)

Указывает, к пользователю или группе относится ли квота.

Id -> (целое число)

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

StorageCapacityQuotaGiB -> (целое число)

Квота на хранилище пользователя или группы в гибибайтах (GiB).

RestoreToSnapshot -> (строка)

Указывает ID снимка, к которому был восстановлен том.

DeleteIntermediateSnaphots -> (булево)

Булево значение, указывающее, следует ли удалить снимки между текущим состоянием и указанным снимком при восстановлении тома со снимка.

DeleteClonedVolumes -> (булево)

Булево значение, указывающее, следует ли удалить зависимые клонированные тома, созданные из промежуточных снимков, при восстановлении тома со снимка.

DeleteIntermediateData -> (булево)

Булево значение, указывающее, следует ли перезаписать данные снимка, отличающиеся между текущим состоянием и указанным снимком, при восстановлении тома со снимка.

SourceSnapshotARN -> (строка)

Идентификатор ресурса Amazon (ARN) для данного ресурса. ARNs уникально идентифицируют ресурсы Amazon Web Services. ARN необходим для однозначной идентификации ресурса в Amazon Web Services. Дополнительную информацию см. в разделе Amazon Resource Names (ARNs) в Справочнике по Amazon Web Services.

DestinationSnapshot -> (строка)

Идентификатор снимка, который копируется или был недавно скопирован в целевой том.

CopyStrategy -> (строка)

Указывает стратегию, используемую при копировании данных со снимка в новый том.

  • CLONE - Новый том ссылается на данные в исходном снимке. Клонирование снимка быстрее, чем копирование данных со снимка в новый том, и не потребляет пропускную способность диска. Однако исходный снимок нельзя удалить, если его скопированные данные используются томом.
  • FULL_COPY - Все данные со снимка копируются в новый том. Укажите этот параметр для создания тома из снимка на другой файловой системе FSx for OpenZFS.

Примечание

Вариант INCREMENTAL_COPY используется только для обновления существующего тома с помощью снимка из другой файловой системы FSx for OpenZFS. Дополнительную информацию см. в разделе CopySnapshotAndUpdateVolume.

( … рекурсивный … )TotalTransferBytes -> (длинное целое)

Количество переданных байтов для снимка FSx for OpenZFS, который копируется.

RemainingTransferBytes -> (длинное целое)

Остальные байты для передачи для снимка FSx for OpenZFS, который копируется.

TotalTransferBytes -> (длинное целое)

Количество переданных байтов для снимка FSx for OpenZFS, который копируется.

RemainingTransferBytes -> (длинное целое)

Остальные байты для передачи для снимка FSx for OpenZFS, который копируется.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API