Spec-Zone.ru › AWS CLI v2

[ aws . fsx ]

обновить-файловую-систему

Описание

Используйте эту операцию для обновления конфигурации существующей файловой системы Amazon FSx. Вы можете обновить несколько свойств в одном запросе.

Для файловых систем FSx для Windows File Server вы можете обновить следующие свойства:

  • AuditLogConfiguration
  • AutomaticBackupRetentionDays
  • DailyAutomaticBackupStartTime
  • SelfManagedActiveDirectoryConfiguration
  • StorageCapacity
  • StorageType
  • ThroughputCapacity
  • DiskIopsConfiguration
  • WeeklyMaintenanceStartTime

Для файловых систем FSx для Lustre вы можете обновить следующие свойства:

  • AutoImportPolicy
  • AutomaticBackupRetentionDays
  • DailyAutomaticBackupStartTime
  • DataCompressionType
  • FileSystemTypeVersion
  • LogConfiguration
  • LustreRootSquashConfiguration
  • MetadataConfiguration
  • PerUnitStorageThroughput
  • StorageCapacity
  • WeeklyMaintenanceStartTime

Для файловых систем FSx для ONTAP вы можете обновить следующие свойства:

  • AddRouteTableIds
  • AutomaticBackupRetentionDays
  • DailyAutomaticBackupStartTime
  • DiskIopsConfiguration
  • FsxAdminPassword
  • HAPairs
  • RemoveRouteTableIds
  • StorageCapacity
  • ThroughputCapacity
  • ThroughputCapacityPerHAPair
  • WeeklyMaintenanceStartTime

Для файловых систем FSx для OpenZFS вы можете обновить следующие свойства:

  • AddRouteTableIds
  • AutomaticBackupRetentionDays
  • CopyTagsToBackups
  • CopyTagsToVolumes
  • DailyAutomaticBackupStartTime
  • DiskIopsConfiguration
  • ReadCacheConfiguration
  • RemoveRouteTableIds
  • StorageCapacity
  • ThroughputCapacity
  • WeeklyMaintenanceStartTime

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

Синтаксис

  update-file-system
--file-system-id <value>
[--client-request-token <value>]
[--storage-capacity <value>]
[--windows-configuration <value>]
[--lustre-configuration <value>]
[--ontap-configuration <value>]
[--open-zfs-configuration <value>]
[--storage-type <value>]
[--file-system-type-version <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]

Параметры

--file-system-id (строка)

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

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

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

--storage-capacity (целое число)

Используйте этот параметр для увеличения емкости хранилища для FSx для Windows File Server, FSx для Lustre, FSx для OpenZFS или FSx для ONTAP. Указывает целевое значение емкости хранилища в Гигабайтах (GiB) для увеличения емкости хранилища для обновляемой файловой системы.

Примечание

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

Для файловых систем Lustre целевое значение емкости хранилища может быть следующим:

  • Для SCRATCH_2 , PERSISTENT_1 и PERSISTENT_2 SSD типов развертывания допустимые значения — кратные 2400 GiB. Значение должно быть больше текущей емкости хранилища.
  • Для файловых систем PERSISTENT HDD допустимые значения — кратные 6000 GiB для пропускной способности 12 Мбит/с на ТБ файловой системы и кратные 1800 GiB для пропускной способности 40 Мбит/с на ТБ файловой системы. Значения должны быть больше текущей емкости хранилища.
  • Для файловых систем SCRATCH_1 увеличение емкости хранилища невозможно.

Дополнительную информацию см. в руководстве FSx для Lustre User Guide в разделе Управление емкостью хранилища и пропускной способностью.

Для файловых систем FSx для OpenZFS целевое значение емкости хранилища должно быть на 10 процентов больше текущего значения емкости хранилища. Дополнительную информацию см. в руководстве FSx для OpenZFS User Guide в разделе Управление емкостью хранилища.

Для файловых систем Windows целевое значение емкости хранилища должно быть на 10 процентов больше текущего значения емкости хранилища. Для увеличения емкости хранилища файловая система должна иметь не менее 16 Мбит/с пропускной способности. Дополнительную информацию см. в руководстве Amazon FSxfor Windows File Server User Guide в разделе Управление емкостью хранилища.

Для файловых систем ONTAP целевое значение емкости хранилища должно быть на 10 процентов больше текущего значения емкости хранилища. Дополнительную информацию см. в руководстве Amazon FSx for NetApp ONTAP User Guide в разделе Управление емкостью хранилища и выделенными IOPS.

--windows-configuration (структура)

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

WeeklyMaintenanceStartTime -> (строка)

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

DailyAutomaticBackupStartTime -> (строка)

Предпочтительное время запуска ежедневной автоматической резервной копии в часовом поясе UTC, например, 02:00

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

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

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

Устанавливает целевое значение пропускной способности файловой системы в Мбит/с, для которой вы обновляете файловую систему. Допустимые значения: 8, 16, 32, 64, 128, 256, 512, 1024, 2048. Запрос на обновление пропускной способности не может быть отправлен, если уже есть активный запрос на обновление пропускной способности. Дополнительную информацию см. в разделе Управление пропускной способностью.

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

Конфигурация Amazon FSx для подключения экземпляра Windows File Server к домену самообслуживаемого каталога Microsoft AD. Запрос на обновление самообслуживаемого каталога Microsoft AD не может быть отправлен, если уже есть активный запрос на обновление самообслуживаемого каталога Microsoft AD.

UserName -> (строка)

Указывает обновленное имя пользователя для учетной записи службы в вашем домене самообслуживаемого Active Directory. Amazon FSx использует эту учетную запись для подключения к вашему домену самообслуживаемого Active Directory.

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

Password -> (строка)

Указывает обновленный пароль для учетной записи службы в вашем домене самообслуживаемого Active Directory. Amazon FSx использует эту учетную запись для подключения к вашему домену самообслуживаемого Active Directory.

DnsIps -> (список)

Список до трех IP-адресов серверов DNS или контроллеров домена в вашем домене самообслуживаемого Active Directory.

(строка)

DomainName -> (строка)

Указывает обновленное полное доменное имя вашей конфигурации самообслуживаемого Active Directory.

OrganizationalUnitDistinguishedName -> (строка)

Указывает обновленное полное различающее имя организационной единицы в вашем самообслуживаемом Active Directory.

FileSystemAdministratorsGroup -> (строка)

Только для файловых систем FSx для ONTAP — Указывает обновленное имя группы домена самообслуживаемого Active Directory, члены которой получают административные привилегии для ресурса Amazon FSx.

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, с следующими требованиями:

  • ARN места назначения (группа журналов CloudWatch Logs или поток доставки Kinesis Data Firehose) должен находиться в той же облачной платформе Amazon Web Services, регионе и учетной записи Amazon Web Services, что и ваша файловая система Amazon FSx.
  • Имя группы журналов Amazon CloudWatch Logs должно начинаться с префикса /aws/fsx . Имя потока доставки Amazon Kinesis Data Firehose должно начинаться с префикса aws-fsx .
  • Если вы не укажете место назначения в AuditLogDestination , Amazon FSx создаст и будет использовать поток в группе журналов CloudWatch Logs /aws/fsx/windows .
  • Если AuditLogDestination указано, а ресурс не существует, запрос завершится с ошибкой BadRequest .
  • Если FileAccessAuditLogLevel и FileShareAccessAuditLogLevel оба установлены в DISABLED , вы не можете указать место назначения в AuditLogDestination .

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

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

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

Сокращенная синтаксическая запись:

WeeklyMaintenanceStartTime=string,DailyAutomaticBackupStartTime=string,AutomaticBackupRetentionDays=integer,ThroughputCapacity=integer,SelfManagedActiveDirectoryConfiguration={UserName=string,Password=string,DnsIps=[string,string],DomainName=string,OrganizationalUnitDistinguishedName=string,FileSystemAdministratorsGroup=string},AuditLogConfiguration={FileAccessAuditLogLevel=string,FileShareAccessAuditLogLevel=string,AuditLogDestination=string},DiskIopsConfiguration={Mode=string,Iops=long}

Синтаксис JSON:

{
  "WeeklyMaintenanceStartTime": "string",
  "DailyAutomaticBackupStartTime": "string",
  "AutomaticBackupRetentionDays": integer,
  "ThroughputCapacity": integer,
  "SelfManagedActiveDirectoryConfiguration": {
    "UserName": "string",
    "Password": "string",
    "DnsIps": ["string", ...],
    "DomainName": "string",
    "OrganizationalUnitDistinguishedName": "string",
    "FileSystemAdministratorsGroup": "string"
  },
  "AuditLogConfiguration": {
    "FileAccessAuditLogLevel": "DISABLED"|"SUCCESS_ONLY"|"FAILURE_ONLY"|"SUCCESS_AND_FAILURE",
    "FileShareAccessAuditLogLevel": "DISABLED"|"SUCCESS_ONLY"|"FAILURE_ONLY"|"SUCCESS_AND_FAILURE",
    "AuditLogDestination": "string"
  },
  "DiskIopsConfiguration": {
    "Mode": "AUTOMATIC"|"USER_PROVISIONED",
    "Iops": long
  }
}

--lustre-configuration (структура)

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

WeeklyMaintenanceStartTime -> (строка)

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

DailyAutomaticBackupStartTime -> (строка)

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

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

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

AutoImportPolicy -> (строка)

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

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

DataCompressionType -> (строка)

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

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

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

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

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

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

Level -> (строка)

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

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

Destination -> (строка)

Идентификатор ресурса Amazon (ARN), который указывает место назначения журналов.

Место назначения может быть любым ARN группы журналов Amazon CloudWatch Logs со следующими требованиями:

  • Предоставленный вами ARN местонахождения должен находиться в том же разделе Amazon Web Services, регионе Amazon Web Services и учетной записи Amazon Web Services, что и ваша файловая система Amazon FSx.
  • Имя группы журналов Amazon CloudWatch Logs должно начинаться с префикса /aws/fsx.
  • Если вы не укажете место назначения, Amazon FSx создаст и будет использовать поток журнала в группе журналов CloudWatch Logs /aws/fsx/lustre (для Amazon FSx for Lustre) или /aws/fsx/filecache (для Amazon File Cache).
  • Если Destination указан, и ресурс не существует, запрос завершится с ошибкой BadRequest.
  • Если Level установлено в значение DISABLED, вы не можете указать место назначения в Destination.

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

Конфигурация сжатия корневого пользователя Lustre, используемая при обновлении файловой системы Amazon FSx for 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).

(строка)

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

Пропускная способность файловой системы Amazon FSx for Lustre на основе Persistent SSD, измеряемая в мегабайтах в секунду на терабайт (МБ/с/ТиБ). Вы можете увеличить или уменьшить пропускную способность вашей файловой системы. Допустимые значения зависят от типа развертывания файловой системы, как указано ниже:

  • Для типов развертывания на основе SSD PERSISTENT_1 допустимые значения составляют 50, 100 и 200 МБ/с/ТиБ.
  • Для типов развертывания на основе SSD PERSISTENT_2 допустимые значения составляют 125, 250, 500 и 1000 МБ/с/ТиБ.

Дополнительную информацию см. в разделе Управление пропускной способностью.

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

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

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

(только режим USER_PROVISIONED) Указывает количество IOPS метаданных, которые необходимо зарезервировать для вашей файловой системы. Допустимые значения: 1500, 3000, 6000, 12000 и кратные 12000 до максимального значения 192000.

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

Mode -> (строка)

Режим конфигурации метаданных для резервирования IOPS метаданных для файловой системы FSx for Lustre, использующей тип развертывания PERSISTENT_2.

  • Для увеличения IOPS метаданных или переключения с режима AUTOMATIC укажите USER_PROVISIONED в качестве значения для этого параметра. Затем используйте параметр Iops, чтобы задать значение IOPS метаданных, которое больше или равно текущему количеству IOPS метаданных, зарезервированных для файловой системы.
  • Для переключения с режима USER_PROVISIONED укажите AUTOMATIC в качестве значения для этого параметра, но не вводите значение для Iops.

Примечание

Если вы запросите переключение с режима USER_PROVISIONED на AUTOMATIC, и текущее значение IOPS метаданных больше автоматизированного значения по умолчанию, FSx for Lustre отклонит запрос, поскольку уменьшение IOPS метаданных не поддерживается.

Сокращенная запись:

WeeklyMaintenanceStartTime=string,DailyAutomaticBackupStartTime=string,AutomaticBackupRetentionDays=integer,AutoImportPolicy=string,DataCompressionType=string,LogConfiguration={Level=string,Destination=string},RootSquashConfiguration={RootSquash=string,NoSquashNids=[string,string]},PerUnitStorageThroughput=integer,MetadataConfiguration={Iops=integer,Mode=string}

Синтаксис JSON:

{
  "WeeklyMaintenanceStartTime": "string",
  "DailyAutomaticBackupStartTime": "string",
  "AutomaticBackupRetentionDays": integer,
  "AutoImportPolicy": "NONE"|"NEW"|"NEW_CHANGED"|"NEW_CHANGED_DELETED",
  "DataCompressionType": "NONE"|"LZ4",
  "LogConfiguration": {
    "Level": "DISABLED"|"WARN_ONLY"|"ERROR_ONLY"|"WARN_ERROR",
    "Destination": "string"
  },
  "RootSquashConfiguration": {
    "RootSquash": "string",
    "NoSquashNids": ["string", ...]
  },
  "PerUnitStorageThroughput": integer,
  "MetadataConfiguration": {
    "Iops": integer,
    "Mode": "AUTOMATIC"|"USER_PROVISIONED"
  }
}

--ontap-configuration (структура)

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

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

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

DailyAutomaticBackupStartTime -> (строка)

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

FsxAdminPassword -> (строка)

Обновите пароль для пользователя fsxadmin, введя новый пароль. Вы используете пользователя fsxadmin для доступа к NetApp ONTAP CLI и REST API для управления ресурсами вашей файловой системы. Дополнительную информацию см. в разделе Управление ресурсами с помощью NetApp Application.

WeeklyMaintenanceStartTime -> (строка)

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

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

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

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

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

Конфигурация IOPS (ввода-вывода в секунду) SSD для файловой системы Amazon FSx for NetApp ONTAP. По умолчанию — 3 IOPS на ГБ емкости хранилища, но вы можете запросить дополнительные IOPS на ГБ емкости хранилища. Конфигурация состоит из режима IOPS (AUTOMATIC или USER_PROVISIONED), и в случае USER_PROVISIONED IOPS — общее количество IOPS SSD, зарезервированных для вашей файловой системы. Дополнительную информацию см. в разделе Обновление емкости хранилища SSD и IOPS.

Mode -> (строка)

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

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

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

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

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

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

Введите новое значение для изменения объема пропускной способности файловой системы в мегабайтах в секунду (MBps). Дополнительную информацию см. в разделе Управление пропускной способностью в руководстве пользователя FSx для ONTAP.

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

  • Значение ThroughputCapacity и ThroughputCapacityPerHAPair не совпадают.
  • Значение ThroughputCapacity, деленное на значение HAPairs, выходит за допустимый диапазон для ThroughputCapacity.

AddRouteTableIds -> (список)

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

(строка)

RemoveRouteTableIds -> (список)

(Только Multi-AZ) Список идентификаторов существующих таблиц маршрутизации виртуальной частной сети (VPC), которые необходимо отсоединить (удалить) от вашей файловой системы Amazon FSx for NetApp ONTAP. Вы можете использовать операцию API для получения списка идентификаторов таблиц маршрутизации VPC для файловой системы.

(строка)

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

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

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

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

  • Для файловых систем типа 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 не совпадают для файловых систем с одной парой HA.
  • Значение типа развертывания — SINGLE_AZ_2, а ThroughputCapacity / ThroughputCapacityPerHAPair не является допустимой парой HA (значение от 1 до 12).
  • Значение ThroughputCapacityPerHAPair не является допустимым.

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

Используется для обновления количества пар высокой доступности (HA) для файловой системы второго поколения с единой зоной. Если вы увеличиваете количество пар HA для вашей файловой системы, вы должны указать пропорциональное увеличение для StorageCapacity, Iops и ThroughputCapacity. Дополнительную информацию см. в руководстве пользователя FSx for ONTAP по парам высокой доступности (HA). Поддержка протоколов хранения блоков (iSCSI и NVMe over TCP) отключена для файловых систем с более чем 6 парами HA. Дополнительную информацию см. в разделе Использование протоколов хранения блоков.

Краткая запись синтаксиса:

AutomaticBackupRetentionDays=integer,DailyAutomaticBackupStartTime=string,FsxAdminPassword=string,WeeklyMaintenanceStartTime=string,DiskIopsConfiguration={Mode=string,Iops=long},ThroughputCapacity=integer,AddRouteTableIds=string,string,RemoveRouteTableIds=string,string,ThroughputCapacityPerHAPair=integer,HAPairs=integer

Синтаксис JSON:

{
  "AutomaticBackupRetentionDays": integer,
  "DailyAutomaticBackupStartTime": "string",
  "FsxAdminPassword": "string",
  "WeeklyMaintenanceStartTime": "string",
  "DiskIopsConfiguration": {
    "Mode": "AUTOMATIC"|"USER_PROVISIONED",
    "Iops": long
  },
  "ThroughputCapacity": integer,
  "AddRouteTableIds": ["string", ...],
  "RemoveRouteTableIds": ["string", ...],
  "ThroughputCapacityPerHAPair": integer,
  "HAPairs": integer
}

--open-zfs-configuration (структура)

Настройки обновления для файловой системы FSx для OpenZFS.

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

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

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

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

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

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

DailyAutomaticBackupStartTime -> (строка)

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

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

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

  • Для MULTI_AZ_1 и SINGLE_AZ_2 допустимые значения составляют 160, 320, 640, 1280, 2560, 3840, 5120, 7680 или 10240 МБ/с.
  • Для SINGLE_AZ_1 допустимые значения составляют 64, 128, 256, 512, 1024, 2048, 3072 или 4096 МБ/с.

WeeklyMaintenanceStartTime -> (строка)

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

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

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

AddRouteTableIds -> (список)

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

(строка)

RemoveRouteTableIds -> (список)

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

(строка)

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

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

SizingMode -> (строка)

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

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

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

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

Сокращенная синтаксическая запись:

AutomaticBackupRetentionDays=integer,CopyTagsToBackups=boolean,CopyTagsToVolumes=boolean,DailyAutomaticBackupStartTime=string,ThroughputCapacity=integer,WeeklyMaintenanceStartTime=string,DiskIopsConfiguration={Mode=string,Iops=long},AddRouteTableIds=string,string,RemoveRouteTableIds=string,string,ReadCacheConfiguration={SizingMode=string,SizeGiB=integer}

Синтаксис JSON:

{
  "AutomaticBackupRetentionDays": integer,
  "CopyTagsToBackups": true|false,
  "CopyTagsToVolumes": true|false,
  "DailyAutomaticBackupStartTime": "string",
  "ThroughputCapacity": integer,
  "WeeklyMaintenanceStartTime": "string",
  "DiskIopsConfiguration": {
    "Mode": "AUTOMATIC"|"USER_PROVISIONED",
    "Iops": long
  },
  "AddRouteTableIds": ["string", ...],
  "RemoveRouteTableIds": ["string", ...],
  "ReadCacheConfiguration": {
    "SizingMode": "NO_CACHE"|"USER_PROVISIONED"|"PROPORTIONAL_TO_THROUGHPUT_CAPACITY",
    "SizeGiB": integer
  }
}

--storage-type (строка)

Указывает тип хранилища файловой системы.

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

  • SSD
  • HDD
  • INTELLIGENT_TIERING

--file-system-type-version (строка)

Версия Lustre, до которой вы обновляете файловую систему FSx для Lustre. Допустимые значения - 2.12 и 2.15. Выбранное значение должно быть новее текущей версии Lustre файловой системы.

--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
  • table
  • yaml
  • yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • on
  • off
  • auto

--no-sign-request (логическое значение)

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

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

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

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

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

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

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

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

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

  • base64
  • raw-in-base64-out

--no-cli-pager (логическое значение)

Отключить страницу CLI для вывода.

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Вывод

Файловая система -> (структура)

Описание обновлённой файловой системы.

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.

ActiveDirectoryId -> (строка)

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

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

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

DomainName -> (строка)

Полное доменное имя собственного каталога AD.

OrganizationalUnitDistinguishedName -> (строка)

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

FileSystemAdministratorsGroup -> (строка)

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

UserName -> (строка)

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

DnsIps -> (список)

Список до трех IP-адресов DNS-серверов или контроллеров домена в собственном каталоге AD.

(строка)

DeploymentType -> (строка)

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

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

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

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. Для получения дополнительной информации см. Доступность и надежность: файловые системы Single-AZ и Multi-AZ .

PreferredFileServerIp -> (строка)

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

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

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

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

MaintenanceOperationsInProgress -> (список)

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

(строка)

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

WeeklyMaintenanceStartTime -> (строка)

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

DailyAutomaticBackupStartTime -> (строка)

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

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

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

CopyTagsToBackups -> (булево)

Флажок 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 for Windows File Server.

Name -> (строка)

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

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

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

Lifecycle -> (строка)

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

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

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

Настройка, которую Amazon FSx для 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 места назначения (журнал Amazon CloudWatch Logs или поток доставки Amazon Kinesis Data Firehose) должен находиться в той же части Amazon Web Services, той же области Amazon Web Services и в том же аккаунте Amazon Web Services, что и ваша файловая система Amazon FSx.

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

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

Mode -> (строка)

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

Iops -> (целое число с длинной точностью)

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

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

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

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

Настройка файловой системы Amazon FSx для 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 -> (целое число)

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

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

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

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

Mode -> (строка)

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

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

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) или командной строки (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, раздел Управление емкостью хранилища и выделенными операциями ввода/вывода.

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

NetworkInterfaceIds -> (список)

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

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

(строка)

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

DNSName -> (строка)

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

KmsKeyId -> (строка)

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

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

ResourceARN -> (строка)

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

Tags -> (список)

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

(структура)

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

Key -> (строка)

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

Value -> (строка)

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

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

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

ActiveDirectoryId -> (строка)

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

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

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

DomainName -> (строка)

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

OrganizationalUnitDistinguishedName -> (строка)

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

FileSystemAdministratorsGroup -> (строка)

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

UserName -> (строка)

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

DnsIps -> (список)

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

(строка)

DeploymentType -> (строка)

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

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

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

RemoteAdministrationEndpoint -> (строка)

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

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

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

PreferredSubnetId -> (строка)

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

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

PreferredFileServerIp -> (строка)

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

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

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

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

MaintenanceOperationsInProgress -> (список)

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

(строка)

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

WeeklyMaintenanceStartTime -> (строка)

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

DailyAutomaticBackupStartTime -> (строка)

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

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

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

CopyTagsToBackups -> (булево)

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

Aliases -> (список)

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

(структура)

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

Name -> (строка)

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

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

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

Lifecycle -> (строка)

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

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

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

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

FileAccessAuditLogLevel -> (строка)

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

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

FileShareAccessAuditLogLevel -> (строка)

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

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

AuditLogDestination -> (строка)

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

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

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

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

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

Mode -> (строка)

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

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

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

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

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

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

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

WeeklyMaintenanceStartTime -> (строка)

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

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

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

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

Lifecycle -> (строка)

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

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

ImportPath -> (строка)

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

ExportPath -> (строка)

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

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

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

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

AutoImportPolicy -> (строка)

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

  • NONE — (По умолчанию) Автоимпорт выключен. 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 типов развертывания.

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

  • Для хранилища 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.

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 для 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 for Lustre и руководстве пользователя Amazon FSx for NetApp ONTAP.

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

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

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

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

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

Status -> (строка)

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

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

( … рекурсивно … )FailureDetails -> (структура)

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

Message -> (строка)

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

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

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

CreationTime -> (timestamp)

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

FileSystemId -> (string)

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

Lifecycle -> (string)

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

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

Name -> (string)

Имя тома.

OntapConfiguration -> (structure)

Настройка тома Amazon FSx для NetApp ONTAP.

FlexCacheEndpointType -> (string)

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

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

JunctionPath -> (string)

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

SecurityStyle -> (string)

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

SizeInMegabytes -> (integer)

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

StorageEfficiencyEnabled -> (boolean)

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

StorageVirtualMachineId -> (string)

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

StorageVirtualMachineRoot -> (boolean)

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

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

TieringPolicy -> (structure)

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

CoolingPeriod -> (integer)

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

Name -> (string)

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

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

UUID -> (string)

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

OntapVolumeType -> (string)

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

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

SnapshotPolicy -> (string)

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

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

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

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

CopyTagsToBackups -> (boolean)

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

SnaplockConfiguration -> (structure)

``` END_OF_DOCUMENT_MARKER

Объект конфигурации 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), даже если они имеют активные периоды хранения. PERMANENTLY_DISABLED является конечным состоянием. Если привилегированное удаление окончательно отключено в томе SnapLock, его нельзя включить повторно. Значение по умолчанию — DISABLED.

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

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

Определяет период хранения тома SnapLock FSx for ONTAP.

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

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

Type -> (строка)

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

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

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

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

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

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

Type -> (строка)

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

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

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

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

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

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

Type -> (строка)

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

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

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

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

SnaplockType -> (строка)

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

  • COMPLIANCE : Файлы, переведенные в режим «запись один раз, чтение многократно» (WORM) на томе соответствия, нельзя удалять до истечения срока хранения. Этот режим хранения используется для соблюдения требований правительственных органов или отраслевых стандартов или для защиты от атак с использованием программ-вымогателей. Дополнительную информацию см. в разделе SnapLock 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, значение, назначенное соответствующему ключу тега. Значения тегов могут быть null и не обязательно должны быть уникальными в наборе тегов. Например, в наборе тегов может быть пара ключ-значение finances : April, а также payroll : April.

VolumeId -> (строка)

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

VolumeType -> (строка)

Тип тома.

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

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

Message -> (строка)

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

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

Конфигурация тома Amazon FSx для 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 для 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 для 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), см. в справке exports(5) - Linux man page. При выборе параметров учитывайте следующее:

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

(строка)

UserAndGroupQuotas -> (список)

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

(структура)

Используется для настройки квот, определяющих, сколько хранилища может использовать пользователь или группа в томе FSx для OpenZFS. Дополнительную информацию см. в разделе Свойства тома в руководстве пользователя FSx для 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 для OpenZFS.

Примечание

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

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

Снимок тома Amazon FSx для OpenZFS.

ResourceARN -> (строка)

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

SnapshotId -> (строка)

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

Name -> (строка)

Имя снимка.

VolumeId -> (строка)

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

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

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

Lifecycle -> (строка)

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

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

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

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

Message -> (строка)

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

Tags -> (список)

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

(структура)

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

Key -> (строка)

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

Value -> (строка)

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

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

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

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

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

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-адресов, в котором будут созданы конечные точки для доступа к вашей файловой системе. По умолчанию в API Amazon FSx 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 CLI и 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 -> (список)

(Только многозонная) Таблицы маршрутизации 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 for ONTAP в разделе Пара высокой доступности (HA).

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

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

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

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

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

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

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

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

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

FileSystemTypeVersion -> (строка)

Версия Lustre файловой системы Amazon FSx 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 . MM - это час дня с нулевым заполнением (0-23), а MM - это минута часа с нулевым заполнением. Например, 05:00 указывает 5 часов утра ежедневно.

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 часов утра понедельника.

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 для настройки SSD IOPS в размере 3 IOPS на ГБ емкости хранилища или использует значение USER_PROVISIONED.

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

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

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

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

RootVolumeId -> (строка)

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

PreferredSubnetId -> (строка)

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

EndpointIpAddressRange -> (строка)

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

RouteTableIds -> (список)

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

(строка)

EndpointIpAddress -> (строка)

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

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

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

SizingMode -> (строка)

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

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

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

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

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

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

Message -> (строка)

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

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

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

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

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

FileSystemId -> (строка)

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

Lifecycle -> (строка)

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

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

Name -> (строка)

Имя тома.

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

Настройка тома Amazon FSx для NetApp ONTAP.

FlexCacheEndpointType -> (строка)

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

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

JunctionPath -> (строка)

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

SecurityStyle -> (строка)

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

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

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

StorageEfficiencyEnabled -> (булево)

Настройка эффективности использования хранилища тома.

StorageVirtualMachineId -> (строка)

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

StorageVirtualMachineRoot -> (булево)

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

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

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

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

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

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

Name -> (строка)

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

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

UUID -> (строка)

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

OntapVolumeType -> (строка)

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

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

SnapshotPolicy -> (строка)

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

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

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

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

CopyTagsToBackups -> (булево)

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

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

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

AuditLogVolume -> (boolean)

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

Дополнительную информацию см. в разделе Тома журнала аудита SnapLock.

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

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

Type -> (строка)

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

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

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

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

PrivilegedDelete -> (строка)

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

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

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

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

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

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

Type -> (строка)

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

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

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

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

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

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

Type -> (строка)

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

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

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

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

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

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

Type -> (строка)

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

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

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

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

SnaplockType -> (строка)

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

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

VolumeAppendModeEnabled -> (boolean)

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

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

VolumeStyle -> (строка)

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

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

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

Aggregates -> (список)

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

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

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

(строка)

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

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

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

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

ResourceARN -> (строка)

Amazon 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 -> (строка)

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

AdministrativeActions -> (список)

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

(структура)

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

AdministrativeActionType -> (строка)

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

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

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

  • FILE_SYSTEM_ALIAS_ASSOCIATION - Обновление файловой системы для добавления нового псевдонима доменного имени системы (DNS) к файловой системе. Дополнительную информацию см. в разделе AssociateFileSystemAliases.
  • FILE_SYSTEM_ALIAS_DISASSOCIATION - Обновление файловой системы для удаления псевдонима DNS из файловой системы. Дополнительную информацию см. в разделе DisassociateFileSystemAliases.
  • IOPS_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача IOPS_OPTIMIZATION. Вы можете отслеживать прогресс оптимизации хранилища с помощью свойства ProgressPercent. После успешного завершения задачи IOPS_OPTIMIZATION, статус родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED. Дополнительную информацию см. в руководстве пользователя Amazon FSx for Windows File Server по управлению выделенной производительностью SSD IOPS.
  • STORAGE_TYPE_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача STORAGE_TYPE_OPTIMIZATION. Вы можете отслеживать прогресс оптимизации хранилища с помощью свойства ProgressPercent. После успешного завершения задачи STORAGE_TYPE_OPTIMIZATION, статус родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED.
  • VOLUME_UPDATE - Обновление тома Amazon FSx для OpenZFS, инициированное из консоли Amazon FSx, API (UpdateVolume ) или CLI (update-volume ).
  • VOLUME_RESTORE - Том Amazon FSx для OpenZFS возвращается в состояние, сохраненное указанным снимком, инициированное через API (RestoreVolumeFromSnapshot ) или CLI (restore-volume-from-snapshot ).
  • SNAPSHOT_UPDATE - Обновление снимка тома Amazon FSx для OpenZFS, инициированное из консоли Amazon FSx, API (UpdateSnapshot ) или CLI (update-snapshot ).
  • RELEASE_NFS_V3_LOCKS - Отслеживает освобождение блокировок 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 -> (структура)

```

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

OwnerId -> (строка)

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

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

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

FileSystemId -> (строка)

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

FileSystemType -> (строка)

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

Lifecycle -> (строка)

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

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

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

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

Message -> (строка)

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

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

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

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

StorageType -> (строка)

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

VpcId -> (строка)

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

SubnetIds -> (список)

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

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

(строка)

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

NetworkInterfaceIds -> (список)

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

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

(строка)

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

DNSName -> (строка)

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

KmsKeyId -> (строка)

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

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

ResourceARN -> (строка)

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

Tags -> (список)

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

(структура)

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

Key -> (строка)

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

Value -> (строка)

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

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

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

ActiveDirectoryId -> (строка)

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

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

Конфигурация автономного каталога Microsoft Active Directory (AD), к которому подключён экземпляр Windows File Server или хранилища ONTAP (SVM).

DomainName -> (строка)

Полное доменное имя автономного каталога AD.

OrganizationalUnitDistinguishedName -> (строка)

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

FileSystemAdministratorsGroup -> (строка)

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

UserName -> (строка)

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

DnsIps -> (список)

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

(строка)

DeploymentType -> (строка)

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

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

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

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. Для получения дополнительной информации см. Доступность и устойчивость: файловые системы Single-AZ и Multi-AZ .

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) для места назначения аудиторских журналов. Местом назначения может быть любой 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 -> (строка)

Предпочтительное время начала еженедельного технического обслуживания, отформатированное как д:ЧЧ:ММ в часовом поясе 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_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: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 Resource Name (ARN), определяющий место назначения журналов. Местом назначения может быть любой ARN группы журналов Amazon CloudWatch Logs. ARN места назначения должен находиться в той же облачной системе AWS, том же регионе AWS и том же аккаунте AWS, что и ваша файловая система Amazon FSx.

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

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

RootSquash -> (строка)

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

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

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

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

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

Mode -> (строка)

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

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

EfaEnabled -> (булево)

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

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

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

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

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

DailyAutomaticBackupStartTime -> (строка)

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

DeploymentType -> (строка)

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

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

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

EndpointIpAddressRange -> (строка)

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

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

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

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

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

DNSName -> (строка)

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

IpAddresses -> (список)

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

(строка)

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

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

DNSName -> (строка)

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

IpAddresses -> (список)

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

(строка)

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

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

Mode -> (строка)

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

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

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

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

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

PreferredSubnetId -> (строка)

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

RouteTableIds -> (список)

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

(строка)

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

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

WeeklyMaintenanceStartTime -> (строка)

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

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

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

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

FsxAdminPassword -> (строка)

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

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

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

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

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

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

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

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

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

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

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

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

FileSystemTypeVersion -> (строка)

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

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

Настройка этого файлового сервера Amazon FSx для 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 -> (структура)

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

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 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 -> (строка)

Включает, отключает или постоянно отключает привилегированное удаление в томе 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) на томе 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 (Bad Request) при следующих условиях:

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

(строка)

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

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

SizeInBytes -> (целое число с большой точностью)

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

ResourceARN -> (строка)

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

Tags -> (список)

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

(структура)

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

Key -> (строка)

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

Value -> (строка)

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

VolumeId -> (строка)

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

VolumeType -> (строка)

Тип тома.

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

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

Message -> (строка)

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

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

Настройка тома Amazon FSx для 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 для OpenZFS.

DataCompressionType -> (строка)

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

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

CopyTagsToSnapshots -> (булево)

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

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

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

SnapshotARN -> (строка)

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

CopyStrategy -> (строка)

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

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

Примечание

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

ReadOnly -> (булево)

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

NfsExports -> (список)

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

(структура)

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

ClientConfigurations -> (список)

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

(структура)

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

Clients -> (строка)

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

Options -> (список)

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

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

(строка)

UserAndGroupQuotas -> (список)

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

(структура)

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

Type -> (строка)

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

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

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

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

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

RestoreToSnapshot -> (строка)

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

DeleteIntermediateSnaphots -> (булево)

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

DeleteClonedVolumes -> (булево)

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

DeleteIntermediateData -> (булево)

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

SourceSnapshotARN -> (строка)

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

ResourceARN -> (строка)

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

SnapshotId -> (строка)

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

Name -> (строка)

Имя снимка.

VolumeId -> (строка)

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

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

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

Lifecycle -> (строка)

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

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

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

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

Message -> (строка)

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

Tags -> (список)

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

(структура)

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

Key -> (строка)

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

Value -> (строка)

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

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

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

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

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

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

Настройка тома Amazon FSx для 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 для 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 (ARNs) в справке 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 (ARNs) в справке Amazon Web Services.

DestinationSnapshot -> (строка)

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

CopyStrategy -> (строка)

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

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

Примечание

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

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

Снимок тома Amazon FSx для OpenZFS.

ResourceARN -> (строка)

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

SnapshotId -> (строка)

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

Name -> (строка)

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

VolumeId -> (строка)

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

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

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

Lifecycle -> (строка)

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

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

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

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

Message -> (строка)

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

Tags -> (список)

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

(структура)

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

Key -> (строка)

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

Value -> (строка)

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

AdministrativeActions -> (список)

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

(структура)

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

AdministrativeActionType -> (строка)

Описание типа административного действия, как указано ниже:

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

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

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

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

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

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

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

Status -> (строка)

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

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

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

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

OwnerId -> (строка)

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

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

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

FileSystemId -> (строка)

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

FileSystemType -> (строка)

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

Lifecycle -> (строка)

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

  • AVAILABLE - Файловая система находится в здоровом состоянии, доступна и готова к использованию.
  • CREATING - Amazon FSx создает новую файловую систему.
  • DELETING - Amazon FSx удаляет существующую файловую систему.
  • FAILED - Существующая файловая система столкнулась с невосстановимой ошибкой. При создании новой файловой системы Amazon FSx не смог создать файловую систему.
  • MISCONFIGURED - Файловая система находится в состоянии ошибки, но восстановима.
  • MISCONFIGURED_UNAVAILABLE - (Только Amazon FSx for 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, это ID подсети, содержащей конечную точку файловой системы. Для файловых систем Windows и ONTAP MULTI_AZ_1 конечная точка файловой системы доступна в PreferredSubnetID.

(строка)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашей виртуальной частной сети (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 для Lustre.

(структура)

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

Key -> (строка)

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

Value -> (строка)

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

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

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

ActiveDirectoryId -> (строка)

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

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

Настройка автономного каталога Microsoft Active Directory (AD), к которому присоединена виртуальная машина Windows File Server или ONTAP storage (SVM).

DomainName -> (строка)

Полное доменное имя автономного каталога AD.

OrganizationalUnitDistinguishedName -> (строка)

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

FileSystemAdministratorsGroup -> (строка)

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

UserName -> (строка)

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

DnsIps -> (список)

Список до трех IP-адресов DNS-серверов или контроллеров домена в автономном каталоге AD.

(строка)

DeploymentType -> (строка)

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

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

Дополнительную информацию см. в разделе Single-AZ и Multi-AZ File Systems.

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. Дополнительную информацию см. в разделе Доступность и надежность: файловые системы Single-AZ и Multi-AZ.

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 for Windows File Server.

Name -> (строка)

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

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

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

Lifecycle -> (строка)

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

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

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

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

FileAccessAuditLogLevel -> (строка)

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

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

FileShareAccessAuditLogLevel -> (строка)

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

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

AuditLogDestination -> (строка)

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

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

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

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

Настройка IOPS (операций ввода/вывода в секунду) SSD для файловой системы Amazon FSx for Windows. По умолчанию Amazon FSx автоматически выделяет 3 IOPS на каждый Гигабайт емкости хранилища. Вы можете выделить дополнительные 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 находится вне минимального или максимального значения.

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

Настройка файловой системы Amazon FSx for Lustre.

WeeklyMaintenanceStartTime -> (строка)

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

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

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

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

Lifecycle -> (строка)

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

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

ImportPath -> (строка)

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

ExportPath -> (строка)

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

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

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

Размер блока по умолчанию составляет 1024 МиБ (1 ГиБ) и может достигать 512 000 МиБ (500 ГиБ). Максимальный размер объектов 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 for Lustre. Тип развертывания «временный» предназначен для временного хранения и кратковременной обработки данных.

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

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

По умолчанию установлено значение SCRATCH_1.

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

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

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

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

MountName -> (строка)

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

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

DailyAutomaticBackupStartTime -> (строка)

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

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

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

CopyTagsToBackups -> (булево)

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

DriveCacheType -> (строка)

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

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

DataCompressionType -> (строка)

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

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

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

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

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

Level -> (строка)

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

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

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

Destination -> (строка)

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

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

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

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

EndpointIpAddressRange -> (строка)

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

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

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

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

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

DNSName -> (строка)

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

IpAddresses -> (список)

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

(строка)

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

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

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). Дополнительную информацию см. в руководстве пользователя Amazon VPC по 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 и API REST. Значение пароля всегда скрыто в ответе.

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

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

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

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

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

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

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

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

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

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

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

FileSystemTypeVersion -> (строка)

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

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

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

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

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

CopyTagsToBackups -> (булево)

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

CopyTagsToVolumes -> (булево)

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

DailyAutomaticBackupStartTime -> (строка)

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

DeploymentType -> (строка)

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

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

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

WeeklyMaintenanceStartTime -> (строка)

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

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

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

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

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

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

Mode -> (строка)

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

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

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

Минимальные и максимальные значения для этого свойства зависят от значения 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 -> (строка)

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

VolumeAppendModeEnabled -> (boolean)

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

Tags -> (список)

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

(структура)

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

Key -> (строка)

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

Value -> (строка)

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

VolumeId -> (строка)

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

VolumeType -> (строка)

Тип тома.

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

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

Message -> (строка)

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

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

Настройка тома Amazon FSx для 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 для 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 для 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) для данного ресурса. ARN однозначно идентифицируют ресурсы 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 для OpenZFS.

ResourceARN -> (строка)

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

SnapshotId -> (строка)

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

Name -> (строка)

Имя снимка.

VolumeId -> (строка)

Идентификатор тома, которому принадлежит снимок.

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

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

Lifecycle -> (строка)

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

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

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

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

Message -> (строка)

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

Tags -> (список)

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

(структура)

Определяет пару ключ-значение для тэга ресурса.

Key -> (строка)

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

Value -> (строка)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

DNSName -> (строка)

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

IpAddresses -> (список)

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

(строка)

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

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

DNSName -> (строка)

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

IpAddresses -> (список)

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

(строка)

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

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

Mode -> (строка)

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

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

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

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

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

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

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

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

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

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

FileSystemTypeVersion -> (строка)

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

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

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

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

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

CopyTagsToBackups -> (булево)

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

CopyTagsToVolumes -> (булево)

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

DailyAutomaticBackupStartTime -> (строка)

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

DeploymentType -> (строка)

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

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

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

WeeklyMaintenanceStartTime -> (строка)

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

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

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

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

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

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

Mode -> (строка)

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

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. Для файловых систем, развернутых в одной 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).

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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