Spec-Zone.ru › AWS CLI v2

[ aws . fsx ]

copy-snapshot-and-update-volume

Описание

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

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

Синтаксис

  copy-snapshot-and-update-volume
[--client-request-token <value>]
--volume-id <value>
--source-snapshot-arn <value>
[--copy-strategy <value>]
[--options <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.

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

Указывает ID тома, в который вы копируете снимок.

--source-snapshot-arn (строка)

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

--copy-strategy (строка)

Указывает стратегию копирования данных со снимка на том.

  • FULL_COPY - Копирует все данные со снимка на том.
  • INCREMENTAL_COPY - Копирует только данные снимка, изменённые с момента предыдущей репликации.

Примечание

CLONE — недопустимый вариант стратегии копирования для операции CopySnapshotAndUpdateVolume.

Возможные значения:

  • CLONE
  • FULL_COPY
  • INCREMENTAL_COPY

--options (список)

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

Репликация завершится ошибкой, если вы не укажите параметр для определённого типа данных, и эти данные присутствуют на вашем целевом томе. Например, если вы не укажете DELETE_INTERMEDIATE_SNAPSHOTS, и на целевом томе есть промежуточные снимки, вы не сможете скопировать снимок.

  • DELETE_INTERMEDIATE_SNAPSHOTS - Удаляет снимки на целевом томе, которых нет на исходном томе.
  • DELETE_CLONED_VOLUMES - Удаляет клона снимков на целевом томе, которых нет на исходном томе.
  • DELETE_INTERMEDIATE_DATA - Перезаписывает снимки на целевом томе, которые не совпадают с исходным снимком, который вы копируете.

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  DELETE_INTERMEDIATE_SNAPSHOTS
  DELETE_CLONED_VOLUMES
  DELETE_INTERMEDIATE_DATA

--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
  • text
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • вкл
  • выкл
  • авто

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

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

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

Файл сертификата корневого удостоверения для проверки сертификатов 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 для вывода.

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

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

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

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

Вывод

VolumeId -> (строка)

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

Lifecycle -> (строка)

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

AdministrativeActions -> (список)

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

(структура)

Описание конкретного административного действия 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 в разделе Управление емкостью хранилища и в руководстве пользователя Amazon FSx для 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 для 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 - Отслеживание снятия блокировок 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 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 -> (строка)

Идентификатор существующего управляемого 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-адрес при подключении файловой системы к клиентам SMB на Linux или Windows, которые не подключены к 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 -> (структура)

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

Mode -> (строка)

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

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

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

Минимальные и максимальные значения для этого свойства зависят от значений HAPairs и StorageCapacity. Минимальное значение вычисляется как StorageCapacity * 3 * HAPairs (3 IOPS на 1 ГБ емкости хранилища). Максимальное значение вычисляется как 200000 * 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 для Lustre, например, s3://import-bucket/optional-prefix . Если после имени ведра Amazon S3 указан префикс, в файловую систему будут загружены только ключи объектов с этим префиксом.

ExportPath -> (строка)

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

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

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

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

AutoImportPolicy -> (строка)

Описывает AutoImportPolicy связанного хранилища данных S3 файловой системы. Параметр 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 тебибайт предоставленного объёма хранения. Ёмкость пропускной способности файловой системы равна Ёмкость хранилища (ТиБ) * Пропускная способность на единицу объёма (МБ/с/ТиБ). Этот параметр действует только для типов развертывания 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-пользователь.

RootSquash -> (строка)

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

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

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

NoSquashNids -> (список)

При включенном сжатии корневого пользователя вы можете дополнительно указать массив NIDs клиентов, для которых сжатие корневого пользователя не применяется. 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.

AdministrativeActions -> (список)

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

(структура)

Описывает конкретное административное действие 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 — Управление выделенными 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) или 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 — отслеживает освобождение блокировок Network File System (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 -> (структура)

``` END_OF_DOCUMENT_MARKER

Целевое значение для администрационного действия, предоставленное в операции 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 для 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, используйте имя 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 для 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) должен находиться в той же облачной среде AWS, в том же регионе AWS и в той же учетной записи AWS, что и ваша файловая система 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 -> (строка)

Описание состояния репозитория данных Durable Data Repository 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 — (По умолчанию) Автоимпорт выключен. 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 -> (булево)

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

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.

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.

Дополнительную информацию об использовании развертываний 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, REST API или NetApp SnapMirror.

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

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

DNSName -> (строка)

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

IpAddresses -> (список)

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

(строка)

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

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

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). Максимальное значение рассчитывается как 200 000 * 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 и REST API. Значение пароля всегда скрывается в ответе.

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

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

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: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, соответствующее 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 -> (структура)

Настройка политики тиеринга тома.

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), даже если у них есть активные сроки хранения. 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 в томе Compliance, не могут быть удалены до истечения срока их хранения. Этот режим хранения используется для соблюдения правительственных или отраслевых требований или для защиты от атак ransomware. Дополнительную информацию см. в разделе SnapLock Compliance.
  • ENTERPRISE : Файлы, переведенные в режим WORM в корпоративном томе, могут быть удалены авторизованными пользователями до истечения срока их хранения с помощью привилегированного удаления. Этот режим хранения используется для повышения целостности данных организации и соблюдения внутренних требований или для тестирования настроек хранения перед использованием 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 (Ошибка запроса) при следующих условиях:

  • Строки в значении 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 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 -> (список)

Объект конфигурации для подключения сетевой файловой системы (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 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 for 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 time.

Lifecycle -> (строка)

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

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

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

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

Message -> (строка)

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

Tags -> (список)

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

(структура)

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

Key -> (строка)

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

Value -> (строка)

Значение, указывающее TagValue, значение, назначенное соответствующему ключу тега. Значения тегов могут быть нулевыми и не должны быть уникальными в наборе тегов. Например, в наборе тегов может быть пара ключ-значение 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 — высокодоступная файловая система, настроенная для многозонной избыточности, чтобы переносить временное отсутствие доступности зоны доступности. Это файловая система первого поколения FSx для ONTAP.
  • MULTI_AZ_2 — высокодоступная файловая система, настроенная для многозонной избыточности, чтобы переносить временное отсутствие доступности зоны доступности. Это файловая система второго поколения 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 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). Дополнительная информация см. в разделе 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 одинаковы для файловых систем с одной парой 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 для 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 на каждый ГБ емкости хранилища. Вы можете выделить дополнительные IOPS на каждый ГБ хранилища. Настройка состоит из общего количества выделенных IOPS SSD и способа их выделения, или режима (по запросу клиента или Amazon FSx).

Mode -> (строка)

Указывает, использует ли файловая система значение AUTOMATIC для IOPS SSD (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-адресов, в котором будут созданы конечные точки для доступа к вашей файловой системе. По умолчанию в Amazon FSx API и консоли Amazon FSx Amazon FSx выбирает доступный диапазон IP-адресов /28 из одного из диапазонов CIDR VPC. Для файловых систем, развернутых в одной VPC/таблицах маршрутизации, могут быть перекрывающиеся IP-адреса конечных точек.

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 Enterprise FSx for ONTAP. Включение привилегированного удаления позволяет администраторам SnapLock удалять файлы WORM (write once, read many), даже если они имеют активные периоды хранения. 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 (write once, read many) на томе соответствия, нельзя удалить до истечения срока их хранения. Этот режим хранения используется для удовлетворения требований конкретных правительств или отраслей или для защиты от атак с помощью программ-вымогателей. Дополнительные сведения см. в разделе SnapLock Compliance.
  • ENTERPRISE : Файлы, переведенные в режим WORM на томе Enterprise, могут быть удалены авторизованными пользователями до истечения срока их хранения с помощью привилегированного удаления. Этот режим хранения используется для повышения целостности данных организации и соблюдения внутренних требований к хранению или для тестирования параметров хранения перед использованием SnapLock Compliance. Дополнительные сведения см. в разделе SnapLock Enterprise.

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 (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 в разделе Управление емкостью хранилища и в руководстве пользователя 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 в разделе Управление предоставленными 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 - Отслеживает освобождение блокировок NFS V3 (Network File System) на файловой системе 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). Дополнительную информацию см. в руководстве пользователя Amazon VPC по 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 для Lustre по маркировке ваших ресурсов Amazon FSx.

(структура)

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

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 - Указывает на высокодоступную файловую систему, настроенную для многозонной избыточности для предотвращения временного отсутствия доступности зоны доступности (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 -> (булево)

Флаг boolean, указывающий, должны ли теги файловой системы копироваться в резервные копии. По умолчанию это значение равно 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 на 1 ГБ емкости хранилища. Вы можете выделить дополнительные IOPS на 1 ГБ емкости хранилища до максимального лимита, связанного с выбранной пропускной способностью.

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 выходит за пределы минимального или максимального значений.

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

``` END_OF_DOCUMENT_MARKER

Конфигурация файловой системы 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 — (По умолчанию) Автоимпорт выключен. 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 тебибайт выделенного объёма хранилища. Ёмкость пропускной способности файловой системы равна Объём хранилища (ТБ) * Пропускная способность на единицу объёма (МБ/с/ТБ). Этот параметр действителен только для 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 часов утра ежедневно.

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 — Высокодоступная файловая система, настроенная для многозонной избыточности, чтобы переносить временные неполадки доступности зоны (AZ). Это файловая система первого поколения FSx для ONTAP.
  • MULTI_AZ_2 — Высокодоступная файловая система, настроенная для многозонной избыточности, чтобы переносить временные неполадки доступности зоны (AZ). Это файловая система второго поколения FSx для ONTAP.
  • SINGLE_AZ_1 — Файловая система, настроенная для однозонной избыточности. Это файловая система первого поколения FSx для ONTAP.
  • SINGLE_AZ_2 — Файловая система, настроенная с несколькими парами высокой доступности (HA) для однозонной избыточности. Это файловая система второго поколения 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 для файловой системы ONTAP, определяющая количество выделенных операций ввода/вывода и режим выделения.

Mode -> (строка)

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

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

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

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

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

PreferredSubnetId -> (строка)

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

RouteTableIds -> (список)

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

(строка)

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

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

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 MBps.
  • Для SINGLE_AZ_2 допустимые значения — 1536, 3072 или 6144 MBps.
  • Для MULTI_AZ_2 допустимые значения — 384, 768, 1536, 3072 или 6144 MBps.

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 для 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 на каждый ГБ емкости хранилища. Вы можете выделить дополнительные 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-адресов, в котором будут созданы конечные точки для доступа к вашему файловому серверу. По умолчанию в Amazon FSx API и консоли 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 FSx для ONTAP. Включение привилегированного удаления позволяет администраторам SnapLock удалять файлы WORM (write once, read many), даже если у них есть активные периоды хранения. PERMANENTLY_DISABLED — это конечное состояние. Если привилегированное удаление постоянно отключено в томе SnapLock, его нельзя включить повторно. Значение по умолчанию — DISABLED.

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

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

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

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

Срок хранения, назначаемый файлу WORM (write once, read many) по умолчанию, если для тома 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. Режим добавления к тому позволяет создавать файлы, к которым можно добавлять данные, и записывать данные в них постепенно. Значение по умолчанию — 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.

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 Resource Name (ARN) для данного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. ARN необходим для однозначной идентификации ресурса во всех сервисах Amazon Web Services. Дополнительную информацию см. в разделе Amazon Resource Names (ARN) в Справочнике Amazon Web Services General Reference.

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 Resource Name (ARN) для данного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. ARN необходим для однозначной идентификации ресурса во всех сервисах Amazon Web Services. Дополнительную информацию см. в разделе Amazon Resource Names (ARN) в Справочнике Amazon Web Services General Reference.

DestinationSnapshot -> (строка)

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

CopyStrategy -> (строка)

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

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

Примечание

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

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

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

ResourceARN -> (строка)

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

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, значение, назначенное соответствующему ключу тега. Значения тегов могут быть нулевыми и не обязательно должны быть уникальными в наборе тегов. Например, в наборе тегов может быть пара ключ-значение finances : April и также payroll : April.

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

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

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

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

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 Resource Name (ARN) для данного ресурса. ARNs однозначно идентифицируют ресурсы Amazon Web Services. ARN необходим для однозначной идентификации ресурса во всей экосистеме Amazon Web Services. Дополнительную информацию см. в разделе Amazon Resource Names (ARN) в «Справочнике по Amazon Web Services».

CopyStrategy -> (строка)

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

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

Примечание

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

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

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

NfsExports -> (список)

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

(структура)

Настройки Network File System (NFS) для подключения файловой системы Amazon FSx для 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 для OpenZFS. Дополнительные сведения см. в разделе Свойства тома в руководстве пользователя FSx для OpenZFS.

Type -> (строка)

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

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

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

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

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

RestoreToSnapshot -> (строка)

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

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

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

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

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

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

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

SourceSnapshotARN -> (строка)

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

DestinationSnapshot -> (строка)

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

CopyStrategy -> (строка)

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

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

Примечание

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

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

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

ResourceARN -> (строка)

Идентификатор Amazon Resource Name (ARN) для данного ресурса. ARNs однозначно идентифицируют ресурсы Amazon Web Services. ARN необходим для однозначной идентификации ресурса в рамках всех сервисов Amazon Web Services. Дополнительную информацию см. в разделе Имена ресурсов Amazon Resource Names (ARNs) в Общей справке 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 -> (строка)

Значение, указывающее на 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, разделе Управление выделенными IOPS SSD.
  • STORAGE_TYPE_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача STORAGE_TYPE_OPTIMIZATION. Вы можете отслеживать прогресс оптимизации хранилища с помощью свойства ProgressPercent. После успешного завершения STORAGE_TYPE_OPTIMIZATION, состояние родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED.
  • VOLUME_UPDATE - Обновление тома Amazon FSx for OpenZFS, запущенное из консоли Amazon FSx, API (UpdateVolume ) или CLI (update-volume ).
  • VOLUME_RESTORE - Том Amazon FSx for OpenZFS возвращается в состояние, сохраненное указанным снимком, запущенное из API (RestoreVolumeFromSnapshot ) или CLI (restore-volume-from-snapshot ).
  • SNAPSHOT_UPDATE - Обновление снимка тома Amazon FSx for OpenZFS, запущенное из консоли Amazon FSx, API (UpdateSnapshot ) или CLI (update-snapshot ).
  • RELEASE_NFS_V3_LOCKS - Отслеживает освобождение блокировок NFS V3 на файловой системе Amazon FSx for OpenZFS.
  • DOWNLOAD_DATA_FROM_BACKUP - Восстановление резервной копии FSx for ONTAP на новый том на файловой системе второго поколения. После загрузки всех метаданных файлов на том вы можете смонтировать том с чтением.
  • VOLUME_INITIALIZE_WITH_SNAPSHOT - Создается том из снимка на другой файловой системе FSx for OpenZFS. Вы можете инициировать это из консоли Amazon FSx, API (CreateVolume ) или CLI (create-volume ) при использовании стратегии FULL_COPY.
  • VOLUME_UPDATE_WITH_SNAPSHOT - Том обновляется из снимка на другой файловой системе FSx for 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 -> (строка)

Учетная запись 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 для 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-адрес при подключении файловой системы к клиентам SMB на Linux или 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.

Name -> (строка)

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

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

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

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 на 1 ГБ емкости хранилища. Вы можете выделить дополнительные IOPS на 1 ГБ емкости хранилища до максимального значения, связанного с выбранной пропускной способностью.

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 находится вне минимального или максимального значений.

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 предназначен для временного хранения и краткосрочной обработки данных.

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 указывает корневого пользователя и, следовательно, отключает сжатие корневого пользователя.

При включенном сжатии корневого пользователя идентификатор пользователя и идентификатор группы корневого пользователя, получающего доступ к файловой системе, перенаправляются на предоставленные вами 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.

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

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 -> (длинное целое число)

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

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

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

PreferredSubnetId -> (строка)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашей виртуальной частной сети (VPC). Дополнительную информацию см. в разделе 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 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 на ГБ хранилища. Настройка включает в себя общее количество выделенных SSD IOPS и способ их выделения, или режим (заказчиком или Amazon FSx).

Mode -> (строка)

Указывает, использует ли файловая система значение AUTOMATIC настроек SSD IOPS в 3 IOPS на ГБ емкости хранилища или использует значение 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 для 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 - 3650
  • Months : 1 - 120
  • Years : 1 - 10

PrivilegedDelete -> (строка)

Включает, отключает или постоянно отключает привилегированное удаление в Enterprise-томе SnapLock FSx for ONTAP. Включение привилегированного удаления позволяет администраторам SnapLock удалять файлы WORM (write once, read many), даже если они имеют активные периоды хранения. 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 (write once, read many) в томе Compliance, не могут быть удалены до истечения срока хранения. Этот режим хранения используется для соответствия правительственным или отраслевым требованиям или для защиты от атак ransomware. Для получения дополнительной информации см. SnapLock Compliance .
  • ENTERPRISE : Файлы, переведенные в режим WORM в Enterprise-томе, могут быть удалены авторизованными пользователями до истечения срока хранения с помощью привилегированного удаления. Этот режим используется для повышения целостности данных организации и соблюдения внутренних правил или для тестирования настроек хранения перед использованием SnapLock Compliance. Для получения дополнительной информации см. SnapLock Enterprise .

VolumeAppendModeEnabled -> (boolean)

Включает или отключает режим добавления к томам в томе SnapLock FSx for ONTAP. Режим добавления к томам позволяет создавать файлы, которые можно добавлять в WORM, и наращивать запись данных в них. Значение по умолчанию — 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 (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 -> (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) для данного ресурса. ARN однозначно идентифицируют ресурсы 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)

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

DeleteIntermediateSnaphots -> (boolean)

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

DeleteClonedVolumes -> (boolean)

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

DeleteIntermediateData -> (boolean)

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

SourceSnapshotARN -> (string)

Amazon Resource Name (ARN) для данного ресурса. ARN однозначно идентифицируют ресурсы 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) для данного ресурса. ARN однозначно идентифицируют ресурсы 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, который вы копируете.

TotalTransferBytes -> (long)

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

RemainingTransferBytes -> (long)

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

© Copyright 2025, Amazon Web Services. Created using Sphinx.

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API