Spec-Zone.ru › AWS CLI v2

[ aws . fsx ]

create-file-system-from-backup

Description

Создает новую файловую систему Amazon FSx for Lustre, Amazon FSx for Windows File Server или Amazon FSx for OpenZFS из существующей резервной копии Amazon FSx.

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

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

Параметры, такие как Active Directory, имя общей папки по умолчанию, автоматическое резервное копирование и параметры резервного копирования, по умолчанию соответствуют параметрам файловой системы, с которой была создана резервная копия, если они не переопределены. Вы можете явно предоставить другие настройки.

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

Note

The CreateFileSystemFromBackup call returns while the file system’s lifecycle state is still CREATING . You can check the file-system creation status by calling the DescribeFileSystems operation, which returns the file system state along with other information.

См. также: AWS API Documentation

Synopsis

  create-file-system-from-backup
--backup-id <value>
[--client-request-token <value>]
--subnet-ids <value>
[--security-group-ids <value>]
[--tags <value>]
[--windows-configuration <value>]
[--lustre-configuration <value>]
[--storage-type <value>]
[--kms-key-id <value>]
[--file-system-type-version <value>]
[--open-zfs-configuration <value>]
[--storage-capacity <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]

Options

--backup-id (string)

The ID of the source backup. Specifies the backup that you are copying.

--client-request-token (string)

A string of up to 63 ASCII characters that Amazon FSx uses to ensure idempotent creation. This string is automatically filled on your behalf when you use the Command Line Interface (CLI) or an Amazon Web Services SDK.

--subnet-ids (list)

Указывает идентификаторы подсетей, из которых будет доступна файловая система. Для типов развертывания файловой системы Windows MULTI_AZ_1 предоставьте ровно два идентификатора подсети, один для предпочтительного файлового сервера и один для резервного файлового сервера. Вы указываете одну из этих подсетей в качестве предпочтительной подсети, используя свойство WindowsConfiguration > PreferredSubnetID .

Типы развертывания файловой системы Windows SINGLE_AZ_1 и SINGLE_AZ_2, файловые системы Lustre и файловые системы OpenZFS предоставляют ровно один идентификатор подсети. Файловый сервер запускается в зоне доступности этой подсети.

(string)

The ID for a subnet. A subnet is a range of IP addresses in your virtual private cloud (VPC). For more information, see VPC and subnets in the Amazon VPC User Guide.

Синтаксис:

"string" "string" ...

--security-group-ids (list)

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

(string)

Идентификатор вашей группы безопасности Amazon EC2. Этот идентификатор используется для управления сетевым доступом к конечной точке, которую Amazon FSx создает от вашего имени в каждой подсети. Для получения дополнительной информации см. Группы безопасности Amazon EC2 для экземпляров Linux в Руководстве пользователя Amazon EC2 .

Синтаксис:

"string" "string" ...

--tags (list)

Теги, которые будут применены к файловой системе при ее создании. Ключ значения тега Name отображается в консоли как имя файловой системы.

(structure)

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

Key -> (string)

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

Value -> (string)

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

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

Key=string,Value=string ...

JSON Syntax:

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

--windows-configuration (structure)

Конфигурация для этой файловой системы Microsoft Windows.

ActiveDirectoryId -> (string)

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

SelfManagedActiveDirectoryConfiguration -> (structure)

Конфигурация, которую Amazon FSx использует для присоединения файловой системы FSx для Windows File Server или виртуальной машины хранилища FSx для ONTAP (SVM) к самоуправляемому (включая локальное) каталогу Microsoft Active Directory (AD). Для получения дополнительной информации см. раздел Использование Amazon FSx для Windows с вашим самоуправляемым Microsoft Active Directory или Управление SVM FSx для ONTAP .

DomainName -> (string)

Полное доменное имя самоуправляемого каталога AD, например corp.example.com .

OrganizationalUnitDistinguishedName -> (string)

(Необязательно) Полное различающееся имя организационного подразделения в вашем самоуправляемом каталоге AD. Amazon FSx принимает только OU в качестве прямого родителя файловой системы. Примером является OU=FSx,DC=yourdomain,DC=corp,DC=com . Чтобы узнать больше, см. RFC 2253 . Если ни один из них не предоставлен, файловая система FSx создается в месте по умолчанию вашего самоуправляемого каталога AD.

Предупреждение

Только объекты Organizational Unit (OU) могут быть прямым родителем создаваемой файловой системы.

FileSystemAdministratorsGroup -> (string)

(Необязательно) Имя группового домена, участникам которого предоставлены права администратора для файловой системы. Права администратора включают в себя владение файлами и папками, настройку элементов управления аудитом (ACL аудита) для файлов и папок и удаленное администрирование файловой системы с помощью FSx Remote PowerShell. Указанная вами группа должна уже существовать в вашем домене. Если вы не предоставите его, будет использована группа Domain Admins вашего домена AD.

UserName -> (string)

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

Password -> (string)

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

DnsIps -> (list)

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

(string)

DeploymentType -> (string)

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

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

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

PreferredSubnetId -> (string)

Требуется, когда DeploymentType установлено значение MULTI_AZ_1 . Это указывает подсеть, в которой вы хотите, чтобы находился предпочтительный файловый сервер. Для приложений в Amazon Web Services мы рекомендуем запускать ваши клиенты в той же зоне доступности (AZ), что и ваш предпочтительный файловый сервер, чтобы снизить затраты на передачу данных между AZ и минимизировать задержку.

ThroughputCapacity -> (integer)

Устанавливает пропускную способность файловой системы Amazon FSx, измеряемую в мегабайтах в секунду (МБ/с), с шагом 2 в n-й степени, от 2^3 (8) до 2^11 (2048).

WeeklyMaintenanceStartTime -> (string)

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

DailyAutomaticBackupStartTime -> (string)

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

AutomaticBackupRetentionDays -> (integer)

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

CopyTagsToBackups -> (boolean)

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

Aliases -> (list)

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

Для получения дополнительной информации см. раздел Работа с DNS-псевдонимами и Руководство 5: Использование DNS-псевдонимов для доступа к вашей файловой системе , включая дополнительные шаги, которые необходимо выполнить, чтобы иметь возможность доступа к вашей файловой системе с использованием DNS-псевдонима.

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

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

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

(string)

AuditLogConfiguration -> (structure)

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

FileAccessAuditLogLevel -> (string)

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

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

FileShareAccessAuditLogLevel -> (string)

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

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

AuditLogDestination -> (string)

Имя ресурса Amazon (ARN), определяющее место назначения журналов аудита.

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

  • ARN места назначения, который вы предоставляете (либо группа журналов CloudWatch Logs, либо поток доставки Kinesis Data Firehose), должен находиться в том же разделе Amazon Web Services, регионе 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 -> (structure)

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

Mode -> (string)

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

Iops -> (long)

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

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

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

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

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

Синтаксис JSON:

{
  "ActiveDirectoryId": "string",
  "SelfManagedActiveDirectoryConfiguration": {
    "DomainName": "string",
    "OrganizationalUnitDistinguishedName": "string",
    "FileSystemAdministratorsGroup": "string",
    "UserName": "string",
    "Password": "string",
    "DnsIps": ["string", ...]
  },
  "DeploymentType": "MULTI_AZ_1"|"SINGLE_AZ_1"|"SINGLE_AZ_2",
  "PreferredSubnetId": "string",
  "ThroughputCapacity": integer,
  "WeeklyMaintenanceStartTime": "string",
  "DailyAutomaticBackupStartTime": "string",
  "AutomaticBackupRetentionDays": integer,
  "CopyTagsToBackups": true|false,
  "Aliases": ["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 (structure)

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

Примечание

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

  • AutoImportPolicy
  • ExportPath
  • ImportedFileChunkSize
  • ImportPath

WeeklyMaintenanceStartTime -> (string)

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

ImportPath -> (string)

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

Примечание

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

ExportPath -> (string)

(Необязательно) Указывает путь в корзине Amazon S3, куда экспортируется корень вашей файловой системы Amazon FSx. Путь должен использовать ту же корзину Amazon S3, что указана в ImportPath. Вы можете указать необязательный префикс, к которому должны экспортироваться новые и измененные данные из вашей файловой системы Amazon FSx for Lustre. Если ExportPath значение не указано, Amazon FSx задает путь экспорта по умолчанию, s3://import-bucket/FSxLustre[creation-timestamp] . Метка времени имеет формат UTC, например s3://import-bucket/FSxLustre20181105T222312Z .

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

Примечание

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

ImportedFileChunkSize -> (integer)

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

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

Примечание

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

DeploymentType -> (string)

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

Выберите PERSISTENT_1 для долгосрочного хранения и для рабочих нагрузок, ориентированных на пропускную способность, которые не чувствительны к задержкам. PERSISTENT_1 поддерживает шифрование данных в пути и доступен во всех регионах Amazon Web Services, в которых доступен FSx for Lustre.

Выберите PERSISTENT_2 для долгосрочного хранения и для рабочих нагрузок, чувствительных к задержкам, которые требуют наивысшего уровня IOPS/пропускной способности. PERSISTENT_2 поддерживает хранение на SSD и предлагает более высокий PerUnitStorageThroughput (до 1000 МБ/с/ТиБ). При желании вы можете указать режим конфигурации метаданных для PERSISTENT_2 , который поддерживает повышение производительности метаданных. PERSISTENT_2 доступен в ограниченном количестве регионов Amazon Web Services. Для получения дополнительной информации и актуального списка регионов Amazon Web Services, в которых доступен PERSISTENT_2 , см. раздел «Параметры развертывания файловой системы для FSx for Lustre» в Руководстве пользователя Amazon FSx for Lustre .

Примечание

Если вы выберете PERSISTENT_2 и установите для параметра FileSystemTypeVersion значение 2.10 , операция CreateFileSystem завершится неудачей.

Шифрование данных в пути автоматически включается при доступе к файловым системам SCRATCH_2 , PERSISTENT_1 и PERSISTENT_2 из экземпляров Amazon EC2, которые поддерживают автоматическое шифрование в регионах Amazon Web Services, где они доступны. Дополнительные сведения о шифровании в пути для файловых систем FSx for Lustre см. в разделе Шифрование данных в пути в Руководстве пользователя Amazon FSx for Lustre .

(По умолчанию = SCRATCH_1 )

AutoImportPolicy -> (string)

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

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

Дополнительные сведения см. в разделе Автоматический импорт обновлений из корзины S3 .

Примечание

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

PerUnitStorageThroughput -> (integer)

Обязательно для типов развертывания PERSISTENT_1 и PERSISTENT_2 , обеспечивает объем пропускной способности чтения и записи для каждого 1 тебибайта (ТиБ) емкости хранилища файловой системы, в МБ/с/ТиБ. Пропускная способность файловой системы рассчитывается путем умножения емкости хранилища файловой системы (ТиБ) на PerUnitStorageThroughput (МБ/с/ТиБ). Для файловой системы объемом 2,4 ТиБ, выделение 50 МБ/с/ТиБ PerUnitStorageThroughput дает 120 МБ/с пропускной способности файловой системы. Вы платите за объем выделенной пропускной способности.

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

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

DailyAutomaticBackupStartTime -> (string)

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

AutomaticBackupRetentionDays -> (integer)

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

CopyTagsToBackups -> (boolean)

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

(По умолчанию = false )

Дополнительные сведения см. в разделе Работа с резервными копиями в Руководстве пользователя Amazon FSx for Lustre .

DriveCacheType -> (string)

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

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

DataCompressionType -> (string)

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

  • NONE - (По умолчанию) Сжатие данных отключено при создании файловой системы.
  • LZ4 - Сжатие данных включено с помощью алгоритма LZ4.

Дополнительные сведения см. в разделе Сжатие данных Lustre в Руководстве пользователя Amazon FSx for Lustre .

EfaEnabled -> (boolean)

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

(По умолчанию = false )

LogConfiguration -> (structure)

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

Level -> (string)

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

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

Destination -> (string)

Имя ресурса 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 -> (structure)

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

RootSquash -> (string)

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

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

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

NoSquashNids -> (list)

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

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

(string)

MetadataConfiguration -> (structure)

Конфигурация производительности метаданных Lustre для создания файловой системы FSx for Lustre с использованием типа развертывания PERSISTENT_2.

Iops -> (integer)

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

Примечание

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

Mode -> (string)

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

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

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

WeeklyMaintenanceStartTime=string,ImportPath=string,ExportPath=string,ImportedFileChunkSize=integer,DeploymentType=string,AutoImportPolicy=string,PerUnitStorageThroughput=integer,DailyAutomaticBackupStartTime=string,AutomaticBackupRetentionDays=integer,CopyTagsToBackups=boolean,DriveCacheType=string,DataCompressionType=string,EfaEnabled=boolean,LogConfiguration={Level=string,Destination=string},RootSquashConfiguration={RootSquash=string,NoSquashNids=[string,string]},MetadataConfiguration={Iops=integer,Mode=string}

Синтаксис JSON:

{
  "WeeklyMaintenanceStartTime": "string",
  "ImportPath": "string",
  "ExportPath": "string",
  "ImportedFileChunkSize": integer,
  "DeploymentType": "SCRATCH_1"|"SCRATCH_2"|"PERSISTENT_1"|"PERSISTENT_2",
  "AutoImportPolicy": "NONE"|"NEW"|"NEW_CHANGED"|"NEW_CHANGED_DELETED",
  "PerUnitStorageThroughput": integer,
  "DailyAutomaticBackupStartTime": "string",
  "AutomaticBackupRetentionDays": integer,
  "CopyTagsToBackups": true|false,
  "DriveCacheType": "NONE"|"READ",
  "DataCompressionType": "NONE"|"LZ4",
  "EfaEnabled": true|false,
  "LogConfiguration": {
    "Level": "DISABLED"|"WARN_ONLY"|"ERROR_ONLY"|"WARN_ERROR",
    "Destination": "string"
  },
  "RootSquashConfiguration": {
    "RootSquash": "string",
    "NoSquashNids": ["string", ...]
  },
  "MetadataConfiguration": {
    "Iops": integer,
    "Mode": "AUTOMATIC"|"USER_PROVISIONED"
  }
}

--storage-type (string)

Задает тип хранилища для файловой системы Windows или OpenZFS, которую вы создаете из резервной копии. Допустимые значения: SSD и HDD.

  • Установите значение SSD для использования хранилища на твердотельных накопителях (SSD). SSD поддерживается во всех типах развертывания Windows и OpenZFS.
  • Установите значение HDD для использования хранилища на жестких дисках (HDD). HDD поддерживается в файловых системах SINGLE_AZ_2 и MULTI_AZ_1 FSx for Windows File Server.

Значение по умолчанию: SSD.

Примечание

Типы хранилища HDD и SSD имеют разные минимальные требования к емкости хранилища. Емкость хранилища восстановленной файловой системы привязана к файловой системе, которая была архивирована. Вы можете создать файловую систему, использующую хранилище HDD, из резервной копии файловой системы, использующей хранилище SSD, если исходная файловая система SSD имела емкость хранилища не менее 2000 ГиБ.

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

  • SSD
  • HDD
  • INTELLIGENT_TIERING

--kms-key-id (string)

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

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

Если KmsKeyId не указан, используется ключ KMS, управляемый Amazon FSx, для вашей учетной записи. Дополнительную информацию см. в разделе Encrypt в справочнике по API Key Management Service.

--file-system-type-version (string)

Задает версию файловой системы Amazon FSx for Lustre, которую вы создаете из резервной копии. Допустимые значения: 2.10 , 2.12 и 2.15.

Вы можете ввести версию Lustre, более новую, чем параметр FileSystemTypeVersion резервной копии. Если вы не введете более новую версию Lustre, будет использоваться параметр резервной копии по умолчанию.

--open-zfs-configuration (structure)

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

AutomaticBackupRetentionDays -> (integer)

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

CopyTagsToBackups -> (boolean)

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

CopyTagsToVolumes -> (boolean)

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

DailyAutomaticBackupStartTime -> (string)

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

DeploymentType -> (string)

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

  • MULTI_AZ_1 — создает файловые системы с высокой доступностью и надежностью путем репликации ваших данных и поддержки отработки отказа в нескольких зонах доступности в одном регионе Amazon Web Services.
  • SINGLE_AZ_HA_2 — создает файловые системы с высокой доступностью и пропускной способностью 160–10 240 МБ/с с использованием кэша NVMe L2ARC, развертывая основную и резервную файловые системы в одной зоне доступности.
  • SINGLE_AZ_HA_1 — создает файловые системы с высокой доступностью и пропускной способностью 64–4 096 МБ/с путем развертывания основной и резервной файловых систем в одной зоне доступности.
  • SINGLE_AZ_2 — создает файловые системы с пропускной способностью 160–10 240 МБ/с с использованием кэша NVMe L2ARC, которые автоматически восстанавливаются в пределах одной зоны доступности.
  • SINGLE_AZ_1 — создает файловые системы с пропускной способностью 64–4 096 МБ/с, которые автоматически восстанавливаются в пределах одной зоны доступности.

Список регионов Amazon Web Services, в которых доступен каждый тип развертывания, см. в разделе Доступность типов развертывания . Дополнительные сведения о различиях в производительности между типами развертывания см. в разделе Производительность файловой системы в Руководстве пользователя Amazon FSx для OpenZFS .

ThroughputCapacity -> (integer)

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

  • Для 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 -> (string)

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

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

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

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

DiskIopsConfiguration -> (structure)

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

Mode -> (string)

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

Iops -> (long)

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

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

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

RootVolumeConfiguration -> (structure)

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

RecordSizeKiB -> (integer)

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

DataCompressionType -> (string)

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

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

NfsExports -> (list)

Объект конфигурации для монтирования файловой системы.

(structure)

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

ClientConfigurations -> (list)

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

(structure)

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

Clients -> (string)

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

Options -> (list)

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

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

(string)

UserAndGroupQuotas -> (list)

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

(structure)

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

Type -> (string)

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

Id -> (integer)

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

StorageCapacityQuotaGiB -> (integer)

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

CopyTagsToSnapshots -> (boolean)

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

ReadOnly -> (boolean)

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

PreferredSubnetId -> (string)

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

EndpointIpAddressRange -> (string)

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

RouteTableIds -> (list)

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

(string)

ReadCacheConfiguration -> (structure)

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

SizingMode -> (string)

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

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

SizeGiB -> (integer)

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

Синтаксис JSON:

{
  "AutomaticBackupRetentionDays": integer,
  "CopyTagsToBackups": true|false,
  "CopyTagsToVolumes": true|false,
  "DailyAutomaticBackupStartTime": "string",
  "DeploymentType": "SINGLE_AZ_1"|"SINGLE_AZ_2"|"SINGLE_AZ_HA_1"|"SINGLE_AZ_HA_2"|"MULTI_AZ_1",
  "ThroughputCapacity": integer,
  "WeeklyMaintenanceStartTime": "string",
  "DiskIopsConfiguration": {
    "Mode": "AUTOMATIC"|"USER_PROVISIONED",
    "Iops": long
  },
  "RootVolumeConfiguration": {
    "RecordSizeKiB": integer,
    "DataCompressionType": "NONE"|"ZSTD"|"LZ4",
    "NfsExports": [
      {
        "ClientConfigurations": [
          {
            "Clients": "string",
            "Options": ["string", ...]
          }
          ...
        ]
      }
      ...
    ],
    "UserAndGroupQuotas": [
      {
        "Type": "USER"|"GROUP",
        "Id": integer,
        "StorageCapacityQuotaGiB": integer
      }
      ...
    ],
    "CopyTagsToSnapshots": true|false,
    "ReadOnly": true|false
  },
  "PreferredSubnetId": "string",
  "EndpointIpAddressRange": "string",
  "RouteTableIds": ["string", ...],
  "ReadCacheConfiguration": {
    "SizingMode": "NO_CACHE"|"USER_PROVISIONED"|"PROPORTIONAL_TO_THROUGHPUT_CAPACITY",
    "SizeGiB": integer
  }
}

--storage-capacity (integer)

Устанавливает объем хранилища файловой системы OpenZFS, которую вы создаете из резервной копии, в гибибайтах (GiB). Допустимые значения от 64 GiB до 524 288 GiB (512 TiB). Однако указанное вами значение должно быть равно или больше значения емкости хранилища резервной копии. Если вы не используете параметр StorageCapacity, значение по умолчанию - значение StorageCapacity резервной копии.

Если используется для создания файловой системы, отличной от OpenZFS, вы должны указать значение, соответствующее значению StorageCapacity резервной копии. Если вы предоставите какое-либо другое значение, Amazon FSx ответит кодом состояния HTTP 400 Bad Request.

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

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

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

--debug (boolean)

Включить отладочное ведение журнала.

--endpoint-url (string)

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (string)

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

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

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

--profile (string)

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

--region (string)

Регион для использования. Переопределяет настройки config/env.

--version (string)

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

--color (string)

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

  • on
  • off
  • auto

--no-sign-request (boolean)

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

--ca-bundle (string)

Пакет сертификатов CA для использования при проверке сертификатов SSL. Переопределяет настройки config/env.

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

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

--cli-binary-format (string)

Стиль форматирования, который будет использоваться для двоичных больших двоичных объектов. Формат по умолчанию - 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 (boolean)

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

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Output

FileSystem -> (structure)

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

OwnerId -> (string)

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

CreationTime -> (timestamp)

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

FileSystemId -> (string)

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

FileSystemType -> (string)

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

Lifecycle -> (string)

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

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

FailureDetails -> (structure)

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

Message -> (string)

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

StorageCapacity -> (integer)

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

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

StorageType -> (string)

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

VpcId -> (string)

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

SubnetIds -> (list)

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

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

(string)

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

NetworkInterfaceIds -> (list)

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

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

(string)

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

DNSName -> (string)

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

KmsKeyId -> (string)

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

  • Amazon FSx for 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 -> (string)

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

Tags -> (list)

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

(structure)

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

Key -> (string)

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

Value -> (string)

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

WindowsConfiguration -> (structure)

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

ActiveDirectoryId -> (string)

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

SelfManagedActiveDirectoryConfiguration -> (structure)

Конфигурация собственной управляемой службы Microsoft Active Directory (AD), к которой присоединена файловая система Windows File Server или виртуальная машина хранилища (SVM) ONTAP.

DomainName -> (string)

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

OrganizationalUnitDistinguishedName -> (string)

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

FileSystemAdministratorsGroup -> (string)

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

UserName -> (string)

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

DnsIps -> (list)

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

(string)

DeploymentType -> (string)

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

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

Дополнительные сведения см. в разделе Файловые системы с одной AZ и Multi-AZ .

RemoteAdministrationEndpoint -> (string)

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

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

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

PreferredSubnetId -> (string)

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

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

PreferredFileServerIp -> (string)

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

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

ThroughputCapacity -> (integer)

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

MaintenanceOperationsInProgress -> (list)

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

(string)

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

WeeklyMaintenanceStartTime -> (string)

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

DailyAutomaticBackupStartTime -> (string)

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

AutomaticBackupRetentionDays -> (integer)

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

CopyTagsToBackups -> (boolean)

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

Aliases -> (list)

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

(structure)

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

Name -> (string)

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

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

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

Lifecycle -> (string)

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

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

AuditLogConfiguration -> (structure)

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

FileAccessAuditLogLevel -> (string)

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

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

FileShareAccessAuditLogLevel -> (string)

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

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

AuditLogDestination -> (string)

Имя ресурса Amazon (ARN) для назначения журналов аудита. Назначением может быть любой ARN группы журналов Amazon CloudWatch Logs или ARN потока доставки 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 -> (structure)

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

Mode -> (string)

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

Iops -> (long)

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

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

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

LustreConfiguration -> (structure)

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

WeeklyMaintenanceStartTime -> (string)

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

DataRepositoryConfiguration -> (structure)

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

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

Lifecycle -> (string)

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

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

ImportPath -> (string)

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

ExportPath -> (string)

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

ImportedFileChunkSize -> (integer)

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

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

AutoImportPolicy -> (string)

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

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

FailureDetails -> (structure)

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

Message -> (string)

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

DeploymentType -> (string)

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

Типы развертывания 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 -> (integer)

Пропускная способность хранилища на единицу представляет собой мегабайты в секунду пропускной способности чтения или записи на 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 -> (string)

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

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

DailyAutomaticBackupStartTime -> (string)

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

AutomaticBackupRetentionDays -> (integer)

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

CopyTagsToBackups -> (boolean)

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

DriveCacheType -> (string)

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

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

DataCompressionType -> (string)

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

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

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

LogConfiguration -> (structure)

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

Level -> (string)

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

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

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

Destination -> (string)

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

RootSquashConfiguration -> (structure)

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

RootSquash -> (string)

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

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

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

NoSquashNids -> (list)

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

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

(string)

MetadataConfiguration -> (structure)

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

Iops -> (integer)

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

Mode -> (string)

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

  • В режиме AUTOMATIC (Автоматический) FSx для Lustre автоматически подготавливает и масштабирует количество операций ввода-вывода метаданных в секунду в вашей файловой системе в зависимости от емкости хранилища файловой системы.
  • В режиме USER_PROVISIONED (Предоставлено пользователем) можно указать количество операций ввода-вывода метаданных в секунду для подготовки для файловой системы.

EfaEnabled -> (boolean)

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

AdministrativeActions -> (list)

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

(structure)

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

AdministrativeActionType -> (string)

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

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

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

  • FILE_SYSTEM_ALIAS_ASSOCIATION — обновление файловой системы для связывания нового псевдонима Domain Name System (DNS) с файловой системой. Дополнительные сведения см. в разделе AssociateFileSystemAliases.
  • FILE_SYSTEM_ALIAS_DISASSOCIATION — обновление файловой системы для отмены привязки псевдонима DNS к файловой системе. Дополнительные сведения см. в разделе DisassociateFileSystemAliases.
  • IOPS_OPTIMIZATION — после успешного завершения задачи FILE_SYSTEM_UPDATE для увеличения пропускной способности файловой системы начинается задача IOPS_OPTIMIZATION. Вы можете отслеживать ход оптимизации хранилища с помощью свойства ProgressPercent. Когда IOPS_OPTIMIZATION завершилась успешно, состояние родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED. Дополнительные сведения см. в разделе «Управление подготовленными операциями ввода-вывода в секунду SSD» в Руководстве пользователя 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 для 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 -> (integer)

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

RequestTime -> (timestamp)

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

Status -> (string)

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

  • 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 -> (structure)

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

OwnerId -> (string)

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

CreationTime -> (timestamp)

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

FileSystemId -> (string)

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

FileSystemType -> (string)

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

Lifecycle -> (string)

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

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

FailureDetails -> (structure)

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

Message -> (string)

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

StorageCapacity -> (integer)

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

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

StorageType -> (string)

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

VpcId -> (string)

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

SubnetIds -> (list)

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

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

(string)

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

NetworkInterfaceIds -> (list)

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

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

(string)

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

DNSName -> (string)

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

KmsKeyId -> (string)

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

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

ResourceARN -> (string)

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

Tags -> (list)

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

(structure)

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

Key -> (string)

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

Value -> (string)

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

WindowsConfiguration -> (structure)

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

ActiveDirectoryId -> (string)

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

SelfManagedActiveDirectoryConfiguration -> (structure)

Конфигурация самостоятельно управляемой Microsoft Active Directory (AD), к которой присоединяется файловый сервер Windows или виртуальная машина хранилища ONTAP (SVM).

DomainName -> (string)

Полное доменное имя самостоятельно управляемой AD.

OrganizationalUnitDistinguishedName -> (string)

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

FileSystemAdministratorsGroup -> (string)

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

UserName -> (string)

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

DnsIps -> (list)

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

(string)

DeploymentType -> (string)

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

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

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

RemoteAdministrationEndpoint -> (string)

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

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

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

PreferredSubnetId -> (string)

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

Для типов развертывания SINGLE_AZ_1 и SINGLE_AZ_2 это значение совпадает со значением для SubnetIDs . Для получения дополнительной информации см. Availability and durability: Single-AZ and Multi-AZ file systems .

PreferredFileServerIp -> (string)

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

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

ThroughputCapacity -> (integer)

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

MaintenanceOperationsInProgress -> (list)

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

(string)

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

WeeklyMaintenanceStartTime -> (string)

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

DailyAutomaticBackupStartTime -> (string)

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

AutomaticBackupRetentionDays -> (integer)

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

CopyTagsToBackups -> (boolean)

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

Aliases -> (list)

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

(structure)

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

Name -> (string)

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

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

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

Lifecycle -> (string)

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

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

AuditLogConfiguration -> (structure)

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

FileAccessAuditLogLevel -> (string)

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

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

FileShareAccessAuditLogLevel -> (string)

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

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

AuditLogDestination -> (string)

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

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

Mode -> (string)

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

Iops -> (long)

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

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

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

LustreConfiguration -> (structure)

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

WeeklyMaintenanceStartTime -> (string)

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

DataRepositoryConfiguration -> (structure)

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

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

Lifecycle -> (string)

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

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

ImportPath -> (string)

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

ExportPath -> (string)

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

ImportedFileChunkSize -> (integer)

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

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

AutoImportPolicy -> (string)

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

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

FailureDetails -> (structure)

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

Message -> (string)

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

DeploymentType -> (string)

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

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

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

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

PerUnitStorageThroughput -> (integer)

Пропускная способность хранилища на единицу представляет собой мегабайты в секунду пропускной способности чтения или записи на 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 -> (string)

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

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

DailyAutomaticBackupStartTime -> (string)

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

AutomaticBackupRetentionDays -> (integer)

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

CopyTagsToBackups -> (boolean)

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

DriveCacheType -> (string)

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

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

DataCompressionType -> (string)

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

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

Для получения дополнительной информации см. Сжатие данных Lustre .

LogConfiguration -> (structure)

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

Level -> (string)

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

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

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

Destination -> (string)

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

RootSquashConfiguration -> (structure)

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

RootSquash -> (string)

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

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

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

NoSquashNids -> (list)

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

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

(string)

MetadataConfiguration -> (structure)

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

Iops -> (integer)

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

Mode -> (string)

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

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

EfaEnabled -> (boolean)

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

AdministrativeActions -> (list)

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

(structure)

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

AdministrativeActionType -> (string)

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

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

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

  • FILE_SYSTEM_ALIAS_ASSOCIATION — обновление файловой системы для связывания нового псевдонима Domain Name System (DNS) с файловой системой. Для получения дополнительной информации см. AssociateFileSystemAliases .
  • FILE_SYSTEM_ALIAS_DISASSOCIATION — обновление файловой системы для отмены связи псевдонима DNS с файловой системой. Для получения дополнительной информации см. DisassociateFileSystemAliases .
  • IOPS_OPTIMIZATION — после успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы начинается задача IOPS_OPTIMIZATION. Вы можете отслеживать ход оптимизации хранилища с помощью свойства ProgressPercent. Когда IOPS_OPTIMIZATION завершено успешно, статус родительского действия FILE_SYSTEM_UPDATE меняется на COMPLETED . Для получения дополнительной информации см. раздел «Управление выделенными операциями ввода-вывода в секунду SSD» в Руководстве пользователя 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 для 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 -> (integer)

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

RequestTime -> (timestamp)

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

Status -> (string)

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

  • 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.

( … recursive … )FailureDetails -> (structure)

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

Message -> (string)

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

TargetVolumeValues -> (structure)

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

CreationTime -> (timestamp)

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

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 : эта политика не создает снимки. Эту политику можно назначить томам, чтобы предотвратить автоматическое создание снимков.

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

Для получения дополнительной информации см. Snapshot policies в Amazon FSx for NetApp ONTAP User Guide.

CopyTagsToBackups -> (boolean)

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

SnaplockConfiguration -> (structure)

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

AuditLogVolume -> (boolean)

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

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

AutocommitPeriod -> (structure)

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

Type -> (string)

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

Value -> (integer)

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

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

PrivilegedDelete -> (string)

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

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

RetentionPeriod -> (structure)

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

DefaultRetention -> (structure)

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

Type -> (string)

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

Value -> (integer)

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

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

MinimumRetention -> (structure)

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

Type -> (string)

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

Value -> (integer)

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

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

MaximumRetention -> (structure)

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

Type -> (string)

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

Value -> (integer)

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

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

SnaplockType -> (string)

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

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

VolumeAppendModeEnabled -> (boolean)

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

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

VolumeStyle -> (string)

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

AggregateConfiguration -> (structure)

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

Aggregates -> (list)

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

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

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

(string)

TotalConstituents -> (integer)

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

SizeInBytes -> (long)

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

ResourceARN -> (string)

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

Tags -> (list)

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

(structure)

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

Key -> (string)

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

Value -> (string)

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

VolumeId -> (string)

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

VolumeType -> (string)

Тип тома.

LifecycleTransitionReason -> (structure)

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

Message -> (string)

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

OpenZFSConfiguration -> (structure)

Конфигурация тома Amazon FSx for OpenZFS.

ParentVolumeId -> (string)

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

VolumePath -> (string)

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

StorageCapacityReservationGiB -> (integer)

Объем хранилища в гибибайтах (GiB) для резервирования из родительского тома. Нельзя зарезервировать больше хранилища, чем зарезервировано в родительском томе.

StorageCapacityQuotaGiB -> (integer)

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

RecordSizeKiB -> (integer)

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

DataCompressionType -> (string)

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

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

CopyTagsToSnapshots -> (boolean)

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

OriginSnapshot -> (structure)

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

SnapshotARN -> (string)

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

CopyStrategy -> (string)

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

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

Примечание

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

ReadOnly -> (boolean)

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

NfsExports -> (list)

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

(structure)

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

ClientConfigurations -> (list)

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

(structure)

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

Clients -> (string)

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

Options -> (list)

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

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

(string)

UserAndGroupQuotas -> (list)

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

(structure)

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

Type -> (string)

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

Id -> (integer)

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

StorageCapacityQuotaGiB -> (integer)

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

RestoreToSnapshot -> (string)

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

DeleteIntermediateSnaphots -> (boolean)

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

DeleteClonedVolumes -> (boolean)

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

DeleteIntermediateData -> (boolean)

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

SourceSnapshotARN -> (string)

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

DestinationSnapshot -> (string)

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

CopyStrategy -> (string)

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

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

Примечание

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

TargetSnapshotValues -> (structure)

Моментальный снимок тома Amazon FSx for OpenZFS.

ResourceARN -> (string)

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

SnapshotId -> (string)

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

Name -> (string)

Имя моментального снимка.

VolumeId -> (string)

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

CreationTime -> (timestamp)

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

Lifecycle -> (string)

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

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

LifecycleTransitionReason -> (structure)

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

Message -> (string)

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

Tags -> (list)

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

(structure)

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

Key -> (string)

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

Value -> (string)

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

TotalTransferBytes -> (long)

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

RemainingTransferBytes -> (long)

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

OntapConfiguration -> (structure)

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

AutomaticBackupRetentionDays -> (integer)

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

DailyAutomaticBackupStartTime -> (string)

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

DeploymentType -> (string)

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

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

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

EndpointIpAddressRange -> (string)

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

Endpoints -> (structure)

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

Intercluster -> (structure)

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

DNSName -> (string)

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

IpAddresses -> (list)

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

(string)

Management -> (structure)

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

DNSName -> (string)

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

IpAddresses -> (list)

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

(string)

DiskIopsConfiguration -> (structure)

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

Mode -> (string)

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

Iops -> (long)

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

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

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

PreferredSubnetId -> (string)

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

RouteTableIds -> (list)

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

(string)

ThroughputCapacity -> (integer)

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

WeeklyMaintenanceStartTime -> (string)

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

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

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

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

FsxAdminPassword -> (string)

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

HAPairs -> (integer)

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

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

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

ThroughputCapacityPerHAPair -> (integer)

Используйте для выбора пропускной способности на пару 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 (Bad Request) при следующих условиях:

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

FileSystemTypeVersion -> (string)

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

OpenZFSConfiguration -> (structure)

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

AutomaticBackupRetentionDays -> (integer)

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

CopyTagsToBackups -> (boolean)

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

CopyTagsToVolumes -> (boolean)

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

DailyAutomaticBackupStartTime -> (string)

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

DeploymentType -> (string)

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

ThroughputCapacity -> (integer)

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

WeeklyMaintenanceStartTime -> (string)

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

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

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

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

DiskIopsConfiguration -> (structure)

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

Mode -> (string)

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

Iops -> (long)

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

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

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

RootVolumeId -> (string)

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

PreferredSubnetId -> (string)

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

EndpointIpAddressRange -> (string)

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

RouteTableIds -> (list)

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

(string)

EndpointIpAddress -> (string)

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

ReadCacheConfiguration -> (structure)

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

SizingMode -> (string)

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

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

SizeGiB -> (integer)

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

FailureDetails -> (structure)

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

Message -> (string)

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

TargetVolumeValues -> (structure)

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

CreationTime -> (timestamp)

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

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 for NetApp ONTAP.

FlexCacheEndpointType -> (string)

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

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

JunctionPath -> (string)

Указывает каталог, который клиенты NAS (сетевое хранилище) используют для монтирования тома, вместе с именем DNS или IP-адресом Storage Virtual Machine (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 - перемещает все блоки пользовательских данных как в активной файловой системе, так и в копиях Snapshot в уровень пула хранения.
  • NONE - сохраняет данные тома в основном уровне хранения, не допуская их перемещения в уровень пула емкости.

UUID -> (string)

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

OntapVolumeType -> (string)

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

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

SnapshotPolicy -> (string)

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

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

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

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

CopyTagsToBackups -> (boolean)

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

SnaplockConfiguration -> (structure)

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

AuditLogVolume -> (boolean)

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

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

AutocommitPeriod -> (structure)

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

Type -> (string)

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

Value -> (integer)

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

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

PrivilegedDelete -> (string)

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

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

RetentionPeriod -> (structure)

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

DefaultRetention -> (structure)

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

Type -> (string)

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

Value -> (integer)

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

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

MinimumRetention -> (structure)

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

Type -> (string)

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

Value -> (integer)

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

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

MaximumRetention -> (structure)

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

Type -> (string)

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

Value -> (integer)

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

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

SnaplockType -> (string)

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

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

VolumeAppendModeEnabled -> (boolean)

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

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

VolumeStyle -> (string)

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

AggregateConfiguration -> (structure)

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

Aggregates -> (list)

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

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

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

(string)

TotalConstituents -> (integer)

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

SizeInBytes -> (long)

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

ResourceARN -> (string)

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

Tags -> (list)

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

(structure)

Задает пару «ключ — значение» для тега ресурса.

Key -> (string)

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

Value -> (string)

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

VolumeId -> (string)

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

VolumeType -> (string)

Тип тома.

LifecycleTransitionReason -> (structure)

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

Message -> (string)

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

AdministrativeActions -> (list)

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

(структура)

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

AdministrativeActionType -> (string)

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

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

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

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

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

RequestTime -> (timestamp)

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

Status -> (string)

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

  • 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 -> (structure)

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

OwnerId -> (string)

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

CreationTime -> (timestamp)

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

FileSystemId -> (string)

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

FileSystemType -> (string)

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

Lifecycle -> (string)

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

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

FailureDetails -> (structure)

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

Message -> (string)

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

StorageCapacity -> (integer)

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

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

StorageType -> (string)

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

VpcId -> (string)

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

SubnetIds -> (list)

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

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

(string)

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

NetworkInterfaceIds -> (list)

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

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

(string)

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

DNSName -> (string)

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

KmsKeyId -> (string)

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

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

ResourceARN -> (string)

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

Tags -> (list)

Теги для связывания с файловой системой. Дополнительные сведения см. в разделе «Тегирование ваших ресурсов Amazon FSx» в Руководстве пользователя Amazon FSx for Lustre.

(structure)

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

Key -> (string)

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

Value -> (string)

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

WindowsConfiguration -> (structure)

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

ActiveDirectoryId -> (string)

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

SelfManagedActiveDirectoryConfiguration -> (structure)

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

DomainName -> (string)

Полностью определенное имя домена самостоятельно управляемого каталога AD.

OrganizationalUnitDistinguishedName -> (string)

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

FileSystemAdministratorsGroup -> (string)

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

UserName -> (string)

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

DnsIps -> (list)

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

(string)

DeploymentType -> (string)

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

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

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

RemoteAdministrationEndpoint -> (string)

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

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

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

PreferredSubnetId -> (string)

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

Для типов развертывания SINGLE_AZ_1 и SINGLE_AZ_2 это значение совпадает со значением SubnetIDs . Для получения дополнительной информации см. Availability and durability: Single-AZ and Multi-AZ file systems .

PreferredFileServerIp -> (string)

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

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

ThroughputCapacity -> (integer)

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

MaintenanceOperationsInProgress -> (list)

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

(string)

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

WeeklyMaintenanceStartTime -> (string)

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

DailyAutomaticBackupStartTime -> (string)

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

AutomaticBackupRetentionDays -> (integer)

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

CopyTagsToBackups -> (boolean)

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

Aliases -> (list)

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

(structure)

Псевдоним DNS, который связан с файловой системой. Вы можете использовать псевдоним DNS для доступа к файловой системе, используя пользовательские имена DNS, в дополнение к имени DNS по умолчанию, которое Amazon FSx присваивает файловой системе. Для получения дополнительной информации см. DNS aliases в FSx for Windows File Server User Guide .

Name -> (string)

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

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

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

Lifecycle -> (string)

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

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

AuditLogConfiguration -> (structure)

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

FileAccessAuditLogLevel -> (string)

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

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

FileShareAccessAuditLogLevel -> (string)

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

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

AuditLogDestination -> (string)

Имя ресурса Amazon (ARN) для назначения журналов аудита. Назначением может быть любой ARN группы журналов Amazon CloudWatch Logs или ARN потока доставки 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 -> (structure)

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

Mode -> (string)

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

Iops -> (long)

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

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

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

LustreConfiguration -> (structure)

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

WeeklyMaintenanceStartTime -> (string)

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

DataRepositoryConfiguration -> (structure)

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

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

Lifecycle -> (string)

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

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

ImportPath -> (string)

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

ExportPath -> (string)

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

ImportedFileChunkSize -> (integer)

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

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

AutoImportPolicy -> (string)

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

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

FailureDetails -> (structure)

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

Message -> (string)

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

DeploymentType -> (string)

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

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

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

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

PerUnitStorageThroughput -> (integer)

Пропускная способность хранилища на единицу представляет собой мегабайты в секунду пропускной способности чтения или записи на 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 -> (string)

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

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

DailyAutomaticBackupStartTime -> (string)

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

AutomaticBackupRetentionDays -> (integer)

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

CopyTagsToBackups -> (boolean)

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

DriveCacheType -> (string)

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

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

DataCompressionType -> (string)

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

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

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

LogConfiguration -> (structure)

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

Level -> (string)

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

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

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

Destination -> (string)

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

RootSquashConfiguration -> (structure)

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

RootSquash -> (string)

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

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

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

NoSquashNids -> (list)

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

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

(string)

MetadataConfiguration -> (structure)

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

Iops -> (integer)

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

Mode -> (string)

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

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

EfaEnabled -> (boolean)

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

OntapConfiguration -> (structure)

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

AutomaticBackupRetentionDays -> (integer)

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

DailyAutomaticBackupStartTime -> (string)

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

DeploymentType -> (string)

Указывает тип развертывания файловой системы 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 -> (string)

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

Endpoints -> (structure)

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

Intercluster -> (structure)

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

DNSName -> (string)

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

IpAddresses -> (list)

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

(string)

Management -> (structure)

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

DNSName -> (string)

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

IpAddresses -> (list)

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

(string)

DiskIopsConfiguration -> (structure)

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

Mode -> (string)

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

Iops -> (long)

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

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

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

PreferredSubnetId -> (string)

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

RouteTableIds -> (list)

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

(string)

ThroughputCapacity -> (integer)

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

WeeklyMaintenanceStartTime -> (string)

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

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

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

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

FsxAdminPassword -> (string)

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

HAPairs -> (integer)

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

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

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

ThroughputCapacityPerHAPair -> (integer)

Используйте для выбора пропускной способности на пару 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 (Bad Request) при следующих условиях:

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

FileSystemTypeVersion -> (string)

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

OpenZFSConfiguration -> (structure)

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

AutomaticBackupRetentionDays -> (integer)

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

CopyTagsToBackups -> (boolean)

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

CopyTagsToVolumes -> (boolean)

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

DailyAutomaticBackupStartTime -> (string)

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

DeploymentType -> (string)

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

ThroughputCapacity -> (integer)

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

WeeklyMaintenanceStartTime -> (string)

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

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

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

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

DiskIopsConfiguration -> (structure)

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

Mode -> (string)

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

Iops -> (long)

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

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

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

RootVolumeId -> (string)

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

PreferredSubnetId -> (string)

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

EndpointIpAddressRange -> (string)

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

RouteTableIds -> (list)

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

(string)

EndpointIpAddress -> (string)

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

ReadCacheConfiguration -> (structure)

Необходимо, когда StorageType имеет значение INTELLIGENT_TIERING . Указывает дополнительный выделенный кэш чтения SSD.

SizingMode -> (string)

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

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

SizeGiB -> (integer)

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

FailureDetails -> (structure)

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

Message -> (string)

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

TargetVolumeValues -> (structure)

Описывает том 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: Это политика по умолчанию. Максимум шесть почасовых снимков, сделанных через пять минут после часа. Максимум два ежедневных снимка, сделанных с понедельника по субботу в 0:10. Максимум два еженедельных снимка, сделанных каждое воскресенье в 0:15.
  • default-1weekly: Эта политика идентична политике default, за исключением того, что она сохраняет только один снимок из еженедельного расписания.
  • none: Эта политика не делает снимков. Эту политику можно назначить томам, чтобы предотвратить автоматическое создание снимков.

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

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

CopyTagsToBackups -> (boolean)

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

SnaplockConfiguration -> (structure)

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

AuditLogVolume -> (boolean)

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

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

AutocommitPeriod -> (structure)

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

Type -> (string)

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

Value -> (integer)

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

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

PrivilegedDelete -> (string)

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

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

RetentionPeriod -> (structure)

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

DefaultRetention -> (structure)

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

Type -> (string)

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

Value -> (integer)

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

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

MinimumRetention -> (structure)

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

Type -> (string)

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

Value -> (integer)

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

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

MaximumRetention -> (structure)

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

Type -> (string)

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

Value -> (integer)

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

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

SnaplockType -> (string)

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

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

VolumeAppendModeEnabled -> (boolean)

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

Для получения дополнительной информации см. Volume-append mode.

VolumeStyle -> (string)

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

AggregateConfiguration -> (structure)

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

Aggregates -> (list)

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

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

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

(string)

TotalConstituents -> (integer)

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

SizeInBytes -> (long)

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

ResourceARN -> (string)

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

Tags -> (list)

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

(structure)

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

Key -> (string)

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

Value -> (string)

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

VolumeId -> (string)

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

VolumeType -> (string)

Тип тома.

LifecycleTransitionReason -> (structure)

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

Message -> (string)

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

OpenZFSConfiguration -> (structure)

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

ParentVolumeId -> (string)

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

VolumePath -> (string)

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

StorageCapacityReservationGiB -> (integer)

Объем хранилища в гибибайтах (GiB) для резервирования из родительского тома. Нельзя зарезервировать больше хранилища, чем зарезервировал родительский том.

StorageCapacityQuotaGiB -> (integer)

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

RecordSizeKiB -> (integer)

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

DataCompressionType -> (string)

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

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

CopyTagsToSnapshots -> (boolean)

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

OriginSnapshot -> (structure)

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

SnapshotARN -> (string)

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

CopyStrategy -> (string)

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

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

Примечание

Параметр INCREMENTAL_COPY предназначен только для обновления существующего тома с помощью снимка из другой файловой системы FSx для OpenZFS. Дополнительные сведения см. в разделе CopySnapshotAndUpdateVolume .

ReadOnly -> (boolean)

Логическое значение, указывающее, является ли том доступным только для чтения.

NfsExports -> (list)

Объект конфигурации для монтирования файловой системы Network File System (NFS).

(structure)

Конфигурации Network File System (NFS) для монтирования файловой системы Amazon FSx для OpenZFS.

ClientConfigurations -> (list)

Список объектов конфигурации, содержащих клиент и параметры для монтирования файловой системы OpenZFS.

(structure)

Указывает, кто может монтировать файловую систему OpenZFS и доступные параметры при монтировании файловой системы.

Clients -> (string)

Значение, указывающее, кто может монтировать файловую систему. Можно указать подстановочный знак (* ), IP-адрес (0.0.0.0 ) или адрес CIDR (192.0.2.0/24 ). По умолчанию Amazon FSx использует подстановочный знак при указании клиента.

Options -> (list)

Параметры, используемые при монтировании файловой системы. Список параметров, которые можно использовать с Network File System (NFS), см. на странице руководства по экспорту(5) Linux . При выборе параметров учитывайте следующее:

  • crossmnt используется по умолчанию. Если вы не укажете crossmnt при изменении конфигурации клиента, вы не сможете просматривать или получать доступ к снимкам в каталоге снимков вашей файловой системы.
  • sync используется по умолчанию. Если вместо этого указать async , система подтверждает записи перед записью на диск. Если система завершит работу до завершения записи, вы потеряете незаписанные данные.

(string)

UserAndGroupQuotas -> (list)

Объект, указывающий, сколько хранилища пользователи или группы могут использовать на томе.

(structure)

Используется для настройки квот, которые определяют, сколько хранилища пользователь или группа могут использовать на томе FSx для OpenZFS. Дополнительные сведения см. в разделе Свойства тома в руководстве пользователя FSx для OpenZFS.

Type -> (string)

Указывает, применяется ли квота к пользователю или группе.

Id -> (integer)

Идентификатор пользователя или группы, к которому применяется квота.

StorageCapacityQuotaGiB -> (integer)

Квота хранилища пользователя или группы в гибибайтах (GiB).

RestoreToSnapshot -> (string)

Указывает идентификатор снимка, в который был восстановлен том.

DeleteIntermediateSnaphots -> (boolean)

Логическое значение, указывающее, следует ли удалять снимки между текущим состоянием и указанным снимком при восстановлении тома из снимка.

DeleteClonedVolumes -> (boolean)

Логическое значение, указывающее, следует ли удалять зависимые клонированные тома, созданные из промежуточных снимков, при восстановлении тома из снимка.

DeleteIntermediateData -> (boolean)

Логическое значение, указывающее, следует ли перезаписывать данные снимка, которые отличаются между текущим состоянием и указанным снимком, при восстановлении тома из снимка.

SourceSnapshotARN -> (string)

Имя ресурса Amazon (ARN) для заданного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. Нам требуется ARN, когда необходимо однозначно указать ресурс во всех службах Amazon Web Services. Дополнительные сведения см. в разделе Имена ресурсов Amazon (ARN) в Общем справочнике Amazon Web Services .

DestinationSnapshot -> (string)

Идентификатор снимка, который копируется или был недавно скопирован в целевой том.

CopyStrategy -> (string)

Указывает стратегию, используемую при копировании данных из снимка в новый том.

  • CLONE — новый том ссылается на данные в исходном снимке. Клонирование снимка выполняется быстрее, чем копирование данных из снимка в новый том, и не потребляет пропускную способность диска. Однако исходный снимок нельзя удалить, если существует том, использующий его скопированные данные.
  • FULL_COPY — копирует все данные из снимка в новый том. Укажите этот параметр, чтобы создать том из снимка в другой файловой системе FSx для OpenZFS.

Примечание

Параметр INCREMENTAL_COPY предназначен только для обновления существующего тома с помощью снимка из другой файловой системы FSx для OpenZFS. Дополнительные сведения см. в разделе CopySnapshotAndUpdateVolume .

TargetSnapshotValues -> (structure)

Снимок тома Amazon FSx для OpenZFS.

ResourceARN -> (string)

Имя ресурса Amazon (ARN) для заданного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. Нам требуется ARN, когда необходимо однозначно указать ресурс во всех службах Amazon Web Services. Дополнительные сведения см. в разделе Имена ресурсов Amazon (ARN) в Общем справочнике Amazon Web Services .

SnapshotId -> (string)

Идентификатор снимка.

Name -> (string)

Имя снимка.

VolumeId -> (string)

Идентификатор тома, снимок которого сделан.

CreationTime -> (timestamp)

Время создания ресурса в секундах (с 01.01.1970T00:00:00Z), также известное как время Unix.

Lifecycle -> (string)

Состояние жизненного цикла снимка.

  • PENDING — Amazon FSx не начал создание снимка.
  • CREATING — Amazon FSx создает снимок.
  • DELETING — Amazon FSx удаляет снимок.
  • AVAILABLE — снимок полностью доступен.

LifecycleTransitionReason -> (structure)

Описывает, почему изменилось состояние жизненного цикла ресурса.

Message -> (string)

Подробное сообщение об ошибке.

Tags -> (list)

Список Tag значений, не более 50 элементов.

(structure)

Указывает пару ключ-значение для тега ресурса.

Key -> (string)

Значение, определяющее TagKey , имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (string)

Значение, определяющее TagValue , значение, присвоенное соответствующему ключу тега. Значения тегов могут быть пустыми и не обязательно должны быть уникальными в наборе тегов. Например, в наборе тегов может быть пара ключ-значение finances : April , а также payroll : April .

TotalTransferBytes -> (long)

Количество байтов, переданных для снимка FSx для OpenZFS, который копируется.

RemainingTransferBytes -> (long)

Оставшееся количество байтов для передачи для снимка FSx для OpenZFS, который копируется.

OpenZFSConfiguration -> (structure)

Конфигурация тома Amazon FSx for OpenZFS.

ParentVolumeId -> (string)

Идентификатор родительского тома.

VolumePath -> (string)

Путь к тому от корневого тома. Например, fsx/parentVolume/volume1 .

StorageCapacityReservationGiB -> (integer)

Объем хранилища в гибибайтах (GiB) для резервирования из родительского тома. Нельзя зарезервировать больше хранилища, чем зарезервировано в родительском томе.

StorageCapacityQuotaGiB -> (integer)

Максимальный объем хранилища в гибибайтах (GiB), который том может использовать от своего родительского. Можно указать квоту больше, чем хранилище в родительском томе.

RecordSizeKiB -> (integer)

Размер записи тома OpenZFS в кибибайтах (KiB). Допустимые значения: 4, 8, 16, 32, 64, 128, 256, 512 или 1024 KiB. По умолчанию используется 128 KiB. Большинство рабочих нагрузок должны использовать размер записи по умолчанию. Руководство по установке пользовательского размера записи см. в Руководстве пользователя Amazon FSx for OpenZFS .

DataCompressionType -> (string)

Указывает метод, используемый для сжатия данных в томе. Тип сжатия по умолчанию — NONE.

  • NONE — Не сжимает данные в томе. NONE используется по умолчанию.
  • ZSTD — Сжимает данные в томе с помощью алгоритма сжатия Zstandard (ZSTD). По сравнению с LZ4, Z-Standard обеспечивает лучшее соотношение сжатия для минимизации использования дискового пространства.
  • LZ4 — Сжимает данные в томе с помощью алгоритма сжатия LZ4. По сравнению с Z-Standard, LZ4 менее интенсивен в вычислительном отношении и обеспечивает более высокую скорость записи.

CopyTagsToSnapshots -> (boolean)

Логическое значение, указывающее, следует ли копировать теги тома в снимки. По умолчанию для этого значения используется false . Если установлено значение true , все теги тома копируются в снимки, где пользователь не указывает теги. Если это значение равно true , и вы указываете один или несколько тегов, в снимки копируются только указанные теги. Если при создании снимка указать один или несколько тегов, теги из тома не копируются, независимо от этого значения.

OriginSnapshot -> (structure)

Объект конфигурации, указывающий снимок для использования в качестве источника данных для тома.

SnapshotARN -> (string)

Имя ресурса Amazon (ARN) для данного ресурса. ARN уникально идентифицируют ресурсы Amazon Web Services. Требуется ARN, когда необходимо однозначно указать ресурс во всех сервисах Amazon Web Services. Дополнительные сведения см. в разделе Имена ресурсов Amazon (ARN) в Общем справочнике Amazon Web Services .

CopyStrategy -> (string)

Стратегия, используемая при копировании данных из снимка в новый том.

  • CLONE — Новый том ссылается на данные в исходном снимке. Клонирование снимка быстрее, чем копирование данных из снимка в новый том, и не потребляет пропускную способность диска. Однако исходный снимок нельзя удалить, если том использует его скопированные данные.
  • FULL_COPY — Копирует все данные из снимка в новый том.

Примечание

Параметр INCREMENTAL_COPY предназначен только для обновления существующего тома с помощью снимка из другой файловой системы FSx for OpenZFS. Дополнительные сведения см. в разделе CopySnapshotAndUpdateVolume .

ReadOnly -> (boolean)

Логическое значение, указывающее, является ли том доступным только для чтения.

NfsExports -> (list)

Объект конфигурации для монтирования файловой системы Network File System (NFS).

(structure)

Конфигурации Network File System (NFS) для монтирования файловой системы Amazon FSx for OpenZFS.

ClientConfigurations -> (list)

Список объектов конфигурации, содержащих клиент и параметры для монтирования файловой системы OpenZFS.

(structure)

Указывает, кто может монтировать файловую систему OpenZFS, и доступные параметры при монтировании файловой системы.

Clients -> (string)

Значение, указывающее, кто может монтировать файловую систему. Можно указать символ подстановки (* ), IP-адрес (0.0.0.0 ) или адрес CIDR (192.0.2.0/24 ). По умолчанию Amazon FSx использует символ подстановки при указании клиента.

Options -> (list)

Параметры, используемые при монтировании файловой системы. Список параметров, которые можно использовать с Network File System (NFS), см. в man-странице exports(5) Linux . При выборе параметров учитывайте следующее:

  • crossmnt используется по умолчанию. Если не указать crossmnt при изменении конфигурации клиента, вы не сможете просматривать или получать доступ к снимкам в каталоге снимков файловой системы.
  • sync используется по умолчанию. Если вместо этого указать async , система подтверждает записи перед записью на диск. Если система завершит работу до завершения записи, вы потеряете незаписанные данные.

(string)

UserAndGroupQuotas -> (list)

Объект, указывающий, сколько хранилища могут использовать пользователи или группы в томе.

(structure)

Используется для настройки квот, определяющих, сколько хранилища может использовать пользователь или группа в томе FSx for OpenZFS. Дополнительные сведения см. в разделе Свойства тома в руководстве пользователя FSx for OpenZFS.

Type -> (string)

Указывает, применяется ли квота к пользователю или группе.

Id -> (integer)

Идентификатор пользователя или группы, к которой применяется квота.

StorageCapacityQuotaGiB -> (integer)

Квота хранилища пользователя или группы в гибибайтах (GiB).

RestoreToSnapshot -> (string)

Указывает идентификатор снимка, к которому был восстановлен том.

DeleteIntermediateSnaphots -> (boolean)

Логическое значение, указывающее, следует ли удалять снимки между текущим состоянием и указанным снимком при восстановлении тома из снимка.

DeleteClonedVolumes -> (boolean)

Логическое значение, указывающее, следует ли удалять зависимые клонированные тома, созданные из промежуточных снимков, при восстановлении тома из снимка.

DeleteIntermediateData -> (boolean)

Логическое значение, указывающее, следует ли перезаписывать данные снимка, которые различаются между текущим состоянием и указанным снимком при восстановлении тома из снимка.

SourceSnapshotARN -> (string)

Имя ресурса Amazon (ARN) для данного ресурса. ARN уникально идентифицируют ресурсы Amazon Web Services. Требуется ARN, когда необходимо однозначно указать ресурс во всех сервисах Amazon Web Services. Дополнительные сведения см. в разделе Имена ресурсов Amazon (ARN) в Общем справочнике Amazon Web Services .

DestinationSnapshot -> (string)

Идентификатор снимка, который копируется или был недавно скопирован в том назначения.

CopyStrategy -> (string)

Указывает стратегию, используемую при копировании данных из снимка в новый том.

  • CLONE — Новый том ссылается на данные в исходном снимке. Клонирование снимка быстрее, чем копирование данных из снимка в новый том, и не потребляет пропускную способность диска. Однако исходный снимок нельзя удалить, если том использует его скопированные данные.
  • FULL_COPY — Копирует все данные из снимка в новый том. Укажите этот параметр, чтобы создать том из снимка в другой файловой системе FSx for OpenZFS.

Примечание

Параметр INCREMENTAL_COPY предназначен только для обновления существующего тома с помощью снимка из другой файловой системы FSx for OpenZFS. Дополнительные сведения см. в разделе CopySnapshotAndUpdateVolume .

TargetSnapshotValues -> (structure)

Снимок тома Amazon FSx для OpenZFS.

ResourceARN -> (string)

Имя ресурса Amazon (ARN) для данного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. Нам требуется ARN, когда вам нужно однозначно указать ресурс во всех Amazon Web Services. Для получения дополнительной информации см. Amazon Resource Names (ARNs) в Справочнике Amazon Web Services General Reference .

SnapshotId -> (string)

Идентификатор снимка.

Name -> (string)

Имя снимка.

VolumeId -> (string)

Идентификатор тома, снимок которого сделан.

CreationTime -> (timestamp)

Время создания ресурса в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

Lifecycle -> (string)

Статус жизненного цикла снимка.

  • PENDING - Amazon FSx не начал создавать снимок.
  • CREATING - Amazon FSx создает снимок.
  • DELETING - Amazon FSx удаляет снимок.
  • AVAILABLE - Снимок полностью доступен.

LifecycleTransitionReason -> (structure)

Описывает, почему изменилось состояние жизненного цикла ресурса.

Message -> (string)

Подробное сообщение об ошибке.

Tags -> (list)

Список Tag значений, не более 50 элементов.

(structure)

Указывает пару "ключ-значение" для тега ресурса.

Key -> (string)

Значение, которое указывает TagKey , имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (string)

Значение, указывающее TagValue , значение, присвоенное соответствующему ключу тега. Значения тегов могут быть null и не должны быть уникальными в наборе тегов. Например, в наборе тегов может быть пара "ключ-значение" finances : April , а также payroll : April .

AdministrativeActions -> (list)

Список административных действий для файловой системы, которые находятся в процессе обработки или ожидают обработки. Административные действия описывают изменения в системе Amazon FSx.

(structure)

Описывает определенное административное действие Amazon FSx для текущей файловой системы или тома Windows, Lustre, OpenZFS или ONTAP.

AdministrativeActionType -> (string)

Описывает тип административного действия следующим образом:

  • 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 . Для получения дополнительной информации см. раздел Managing throughput capacity в Руководстве пользователя Amazon FSx for Windows File Server .
  • STORAGE_OPTIMIZATION - После успешного завершения FILE_SYSTEM_UPDATE задачи по увеличению емкости хранилища файловой системы начинается задача STORAGE_OPTIMIZATION .
    • Для Windows и ONTAP оптимизация хранилища — это процесс миграции данных файловой системы на новые диски большего размера.
    • Для Lustre оптимизация хранилища состоит из перераспределения данных между существующими и вновь добавленными файловыми серверами.

Вы можете отслеживать ход оптимизации хранилища, используя свойство ProgressPercent . Когда STORAGE_OPTIMIZATION успешно завершена, статус родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED . Для получения дополнительной информации см. разделы Managing storage capacity в Руководстве пользователя Amazon FSx for Windows File Server , Managing storage capacity в Руководстве пользователя Amazon FSx for Lustre и Managing storage capacity and provisioned IOPS в Руководстве пользователя Amazon FSx for NetApp ONTAP .

  • FILE_SYSTEM_ALIAS_ASSOCIATION - Обновление файловой системы для связывания нового псевдонима Domain Name System (DNS) с файловой системой. Для получения дополнительной информации см. AssociateFileSystemAliases .
  • FILE_SYSTEM_ALIAS_DISASSOCIATION - Обновление файловой системы для разъединения псевдонима DNS с файловой системой. Для получения дополнительной информации см. DisassociateFileSystemAliases .
  • IOPS_OPTIMIZATION - После успешного завершения FILE_SYSTEM_UPDATE задачи по увеличению пропускной способности файловой системы начинается задача IOPS_OPTIMIZATION . Вы можете отслеживать ход оптимизации хранилища, используя свойство ProgressPercent . Когда IOPS_OPTIMIZATION успешно завершена, статус родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED . Для получения дополнительной информации см. раздел Managing provisioned SSD IOPS в Руководстве пользователя Amazon FSx for Windows File Server.
  • STORAGE_TYPE_OPTIMIZATION - После успешного завершения FILE_SYSTEM_UPDATE задачи по увеличению пропускной способности файловой системы начинается задача STORAGE_TYPE_OPTIMIZATION . Вы можете отслеживать ход оптимизации хранилища, используя свойство ProgressPercent . Когда STORAGE_TYPE_OPTIMIZATION успешно завершена, статус родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED .
  • VOLUME_UPDATE - Обновление тома до тома Amazon FSx для OpenZFS, инициированное из консоли Amazon FSx, API (UpdateVolume ) или 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 -> (integer)

Статус завершения в процентах STORAGE_OPTIMIZATION или DOWNLOAD_DATA_FROM_BACKUP административного действия. Не относится ни к какому другому типу административного действия.

RequestTime -> (timestamp)

Время получения запроса административного действия.

Status -> (string)

Статус административного действия следующим образом:

  • 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 -> (structure)

Целевое значение для действия администрирования, указанное в операции UpdateFileSystem. Возвращается для административных действий FILE_SYSTEM_UPDATE.

OwnerId -> (string)

Учетная запись Amazon Web Services, создавшая файловую систему. Если файловая система создана пользователем в IAM Identity Center, владельцем является учетная запись Amazon Web Services, к которой принадлежит пользователь IAM.

CreationTime -> (timestamp)

Время создания файловой системы в секундах (с 1970-01-01T00:00:00Z), также известное как Unix-время.

FileSystemId -> (string)

Сгенерированный системой уникальный 17-значный идентификатор файловой системы.

FileSystemType -> (string)

Тип файловой системы Amazon FSx, который может быть LUSTRE , WINDOWS , ONTAP или OPENZFS .

Lifecycle -> (string)

Статус жизненного цикла файловой системы. Возможные значения и их значения:

  • AVAILABLE - Файловая система находится в работоспособном состоянии, доступна и пригодна для использования.
  • CREATING - Amazon FSx создает новую файловую систему.
  • DELETING - Amazon FSx удаляет существующую файловую систему.
  • FAILED - Существующая файловая система подверглась неустранимой ошибке. При создании новой файловой системы Amazon FSx не удалось создать файловую систему.
  • MISCONFIGURED - Файловая система находится в состоянии сбоя, но подлежит восстановлению.
  • MISCONFIGURED_UNAVAILABLE - (Только для Amazon FSx for Windows File Server) Файловая система в настоящее время недоступна из-за изменений в конфигурации Active Directory.
  • UPDATING - Файловая система подвергается обновлению, инициированному клиентом.

FailureDetails -> (structure)

Структура, предоставляющая подробную информацию о любых возникших сбоях.

Message -> (string)

Сообщение, описывающее любые произошедшие сбои.

StorageCapacity -> (integer)

Объем хранилища файловой системы в гибибайтах (GiB).

Amazon FSx отвечает с кодом состояния HTTP 400 (Bad Request), если значение StorageCapacity находится за пределами минимального или максимального значения.

StorageType -> (string)

Тип хранилища, используемого файловой системой. Если установлено значение SSD , файловая система использует хранилище на твердотельных накопителях. Если установлено значение HDD , файловая система использует хранилище на жестких дисках.

VpcId -> (string)

Идентификатор основной виртуальной частной сети (VPC) для файловой системы.

SubnetIds -> (list)

Указывает идентификаторы подсетей, из которых доступна файловая система. Для типов развертывания файловых систем Amazon FSx Windows и ONTAP MULTI_AZ_1 существует два идентификатора подсети: один для предпочтительного файлового сервера и один для резервного файлового сервера. Предпочтительная подсеть файлового сервера определена в свойстве PreferredSubnetID. Все остальные файловые системы имеют только один идентификатор подсети.

Для файловых систем FSx for Lustre и однозоновых файловых систем Windows это идентификатор подсети, содержащей конечную точку файловой системы. Для файловых систем MULTI_AZ_1 Windows и ONTAP конечная точка файловой системы доступна в PreferredSubnetID .

(string)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашей виртуальной частной сети (VPC). Дополнительную информацию см. в разделе VPC и подсети в Руководстве пользователя Amazon VPC.

NetworkInterfaceIds -> (list)

Идентификаторы эластичных сетевых интерфейсов, из которых доступна конкретная файловая система. Эластичный сетевой интерфейс автоматически создается в той же виртуальной частной сети (VPC), в которой была создана файловая система Amazon FSx. Дополнительную информацию см. в разделе Эластичные сетевые интерфейсы в Руководстве пользователя Amazon EC2.

Для файловой системы Amazon FSx for Windows File Server может быть один идентификатор сетевого интерфейса. Для файловой системы Amazon FSx for Lustre может быть больше одного.

(string)

Идентификатор эластичного сетевого интерфейса. Эластичный сетевой интерфейс — это логический сетевой компонент в виртуальной частной сети (VPC), представляющий виртуальную сетевую карту. Дополнительную информацию см. в разделе Эластичные сетевые интерфейсы в Руководстве пользователя Amazon EC2 для экземпляров Linux .

DNSName -> (string)

Имя Domain Name System (DNS) для файловой системы.

KmsKeyId -> (string)

Идентификатор ключа Key Management Service (KMS), используемого для шифрования данных файловой системы Amazon FSx. Используется следующим образом с типами файловых систем Amazon FSx:

  • Только для типов развертывания Amazon FSx for Lustre PERSISTENT_1 и PERSISTENT_2. Типы SCRATCH_1 и SCRATCH_2 зашифрованы с использованием ключа KMS сервиса Amazon FSx для вашей учетной записи.
  • Amazon FSx for NetApp ONTAP
  • Amazon FSx for OpenZFS
  • Amazon FSx for Windows File Server

ResourceARN -> (string)

Ресурсный идентификатор Amazon (ARN) ресурса файловой системы.

Tags -> (list)

Теги для связывания с файловой системой. Дополнительную информацию см. в разделе Тегирование ресурсов Amazon FSx в Руководстве пользователя Amazon FSx for Lustre .

(structure)

Указывает пару ключ-значение для тега ресурса.

Key -> (string)

Значение, указывающее TagKey , имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (string)

Значение, указывающее TagValue , значение, присвоенное соответствующему ключу тега. Значения тегов могут быть null и не должны быть уникальными в наборе тегов. Например, в наборе тегов может быть пара ключ-значение finances : April , а также payroll : April .

WindowsConfiguration -> (structure)

Конфигурация для этой файловой системы Amazon FSx для Windows File Server.

ActiveDirectoryId -> (string)

Идентификатор существующего экземпляра Microsoft Active Directory в Amazon Web Services, к которому присоединена файловая система.

SelfManagedActiveDirectoryConfiguration -> (structure)

Конфигурация саморегулируемого каталога Microsoft Active Directory (AD), к которому присоединены файловая система Windows File Server или экземпляр виртуальной машины хранилища ONTAP (SVM).

DomainName -> (string)

Полностью определенное доменное имя саморегулируемого каталога AD.

OrganizationalUnitDistinguishedName -> (string)

Полностью определенное различающееся имя организационного подразделения в саморегулируемом каталоге AD, к которому присоединены файловая система Windows File Server или виртуальная машина хранилища ONTAP (SVM).

FileSystemAdministratorsGroup -> (string)

Имя доменной группы, члены которой имеют права администратора для файловой системы FSx.

UserName -> (string)

Имя пользователя для учетной записи службы в вашем саморегулируемом домене AD, которое FSx использует для присоединения к вашему домену AD.

DnsIps -> (list)

Список до трех IP-адресов DNS-серверов или контроллеров домена в саморегулируемом каталоге AD.

(string)

DeploymentType -> (string)

Указывает тип развертывания файловой системы, допустимыми значениями являются следующие:

  • MULTI_AZ_1 - Указывает файловую систему высокой доступности, которая настроена для резервирования Multi-AZ для обеспечения отказоустойчивости к временной недоступности зоны доступности (AZ) и поддерживает хранилище SSD и HDD.
  • SINGLE_AZ_1 - (По умолчанию) Указывает файловую систему, настроенную для резервирования с одной зоной доступности, поддерживает только хранилище SSD.
  • SINGLE_AZ_2 - Файловая система Single AZ последнего поколения. Указывает файловую систему, которая настроена для резервирования с одной зоной доступности и поддерживает хранилище SSD и HDD.

Дополнительные сведения см. в разделе Файловые системы Single-AZ и Multi-AZ .

RemoteAdministrationEndpoint -> (string)

Для типов развертывания MULTI_AZ_1 используйте эту конечную точку при выполнении административных задач в файловой системе с помощью Amazon FSx Remote PowerShell.

Для типов развертывания SINGLE_AZ_1 и SINGLE_AZ_2 это DNS-имя файловой системы.

Эта конечная точка временно недоступна, когда в файловой системе проводится техническое обслуживание.

PreferredSubnetId -> (string)

Для типов развертывания MULTI_AZ_1 он указывает идентификатор подсети, в которой расположен предпочтительный файловый сервер. Должен быть одним из двух идентификаторов подсети, указанных в свойстве SubnetIds . Amazon FSx обслуживает трафик из этой подсети, за исключением случая отработки отказа на вторичный файловый сервер.

Для типов развертывания SINGLE_AZ_1 и SINGLE_AZ_2 это значение совпадает со значением SubnetIDs . Дополнительные сведения см. в разделе Доступность и долговечность: файловые системы Single-AZ и Multi-AZ .

PreferredFileServerIp -> (string)

Для типов развертывания MULTI_AZ_1 IP-адрес основного, или предпочтительного, файлового сервера.

Используйте этот IP-адрес при монтировании файловой системы на клиентах SMB Linux или клиентах SMB Windows, которые не присоединены к Microsoft Active Directory. Применимо ко всем типам развертывания файловой системы Windows. Этот IP-адрес временно недоступен, когда в файловой системе проводится техническое обслуживание. Для клиентов SMB Linux и Windows, присоединенных к Active Directory, вместо этого используйте DNSName файловой системы. Дополнительные сведения о сопоставлении и монтировании общих папок см. в разделе Доступ к общим папкам .

ThroughputCapacity -> (integer)

Пропускная способность файловой системы Amazon FSx, измеряемая в мегабайтах в секунду.

MaintenanceOperationsInProgress -> (list)

Список выполняющихся операций технического обслуживания для этой файловой системы.

(string)

Перечисление, определяющее текущую выполняющуюся операцию технического обслуживания.

WeeklyMaintenanceStartTime -> (string)

Предпочтительное время начала еженедельного технического обслуживания в формате d:HH:MM в часовом поясе UTC. d — это номер дня недели, от 1 до 7, начиная с понедельника и заканчивая воскресеньем.

DailyAutomaticBackupStartTime -> (string)

Предпочтительное время для выполнения ежедневного автоматического резервного копирования в часовом поясе UTC.

AutomaticBackupRetentionDays -> (integer)

Количество дней хранения автоматических резервных копий. Установка этого значения в 0 отключает автоматическое резервное копирование. Вы можете хранить автоматические резервные копии максимум 90 дней.

CopyTagsToBackups -> (boolean)

Логический флаг, указывающий, следует ли копировать теги в файловой системе в резервные копии. По умолчанию это значение равно false. Если оно установлено в true, все теги в файловой системе копируются во все автоматические резервные копии и любые резервные копии, инициированные пользователем, где пользователь не указывает никаких тегов. Если это значение равно true, и вы укажете один или несколько тегов, только указанные теги будут скопированы в резервные копии. Если вы укажете один или несколько тегов при создании резервной копии, инициированной пользователем, никакие теги не будут скопированы из файловой системы, независимо от этого значения.

Aliases -> (list)

Массив из одного или нескольких DNS-псевдонимов, которые в настоящее время связаны с файловой системой Amazon FSx. Псевдонимы позволяют использовать существующие имена DNS для доступа к данным в вашей файловой системе Amazon FSx. Вы можете связать до 50 псевдонимов с файловой системой в любое время. Вы можете связать дополнительные DNS-псевдонимы после создания файловой системы с помощью операции AssociateFileSystemAliases. Вы можете удалить DNS-псевдонимы из файловой системы после ее создания с помощью операции DisassociateFileSystemAliases. Вам нужно указать только имя псевдонима в полезных данных запроса. Дополнительные сведения см. в разделе DNS-псевдонимы .

(structure)

DNS-псевдоним, связанный с файловой системой. Вы можете использовать DNS-псевдоним для доступа к файловой системе, используя определенные пользователем имена DNS, в дополнение к имени DNS по умолчанию, которое Amazon FSx присваивает файловой системе. Дополнительные сведения см. в разделе DNS-псевдонимы в Руководстве пользователя FSx для Windows File Server .

Name -> (string)

Имя DNS-псевдонима. Имя псевдонима должно соответствовать следующим требованиям:

  • Форматируется как полное доменное имя (FQDN), hostname.domain , например, accounting.example.com .
  • Может содержать буквенно-цифровые символы, символ подчеркивания (_) и дефис (-).
  • Не может начинаться или заканчиваться дефисом.
  • Может начинаться с цифры.

Для имен DNS Amazon FSx хранит буквенные символы как строчные буквы (a-z), независимо от того, как вы их указываете: как прописные буквы, строчные буквы или соответствующие буквы в escape-кодах.

Lifecycle -> (string)

Описывает состояние DNS-псевдонима.

  • AVAILABLE - DNS-псевдоним связан с файловой системой Amazon FSx.
  • CREATING - Amazon FSx создает DNS-псевдоним и связывает его с файловой системой.
  • CREATE_FAILED - Amazon FSx не удалось связать DNS-псевдоним с файловой системой.
  • DELETING - Amazon FSx отменяет связь DNS-псевдонима с файловой системой и удаляет его.
  • DELETE_FAILED - Amazon FSx не удалось отменить связь DNS-псевдонима с файловой системой.

AuditLogConfiguration -> (structure)

Конфигурация, которую Amazon FSx для Windows File Server использует для аудита и ведения журналов доступа пользователей к файлам, папкам и общим папкам в файловой системе Amazon FSx для Windows File Server.

FileAccessAuditLogLevel -> (string)

Устанавливает, какой тип попыток регистрируется Amazon FSx для доступа к файлам и папкам.

  • SUCCESS_ONLY - регистрируются только успешные попытки доступа к файлам или папкам.
  • FAILURE_ONLY - регистрируются только неудачные попытки доступа к файлам или папкам.
  • SUCCESS_AND_FAILURE - регистрируются как успешные, так и неудачные попытки доступа к файлам или папкам.
  • DISABLED - аудит доступа к файлам и папкам отключен.

FileShareAccessAuditLogLevel -> (string)

Устанавливает, какой тип попыток регистрируется Amazon FSx для доступа к общим папкам.

  • SUCCESS_ONLY - регистрируются только успешные попытки доступа к общим папкам.
  • FAILURE_ONLY - регистрируются только неудачные попытки доступа к общим папкам.
  • SUCCESS_AND_FAILURE - регистрируются как успешные, так и неудачные попытки доступа к общим папкам.
  • DISABLED - аудит доступа к общим папкам отключен.

AuditLogDestination -> (string)

Имя ресурса Amazon (ARN) для назначения журналов аудита. Назначением может быть любой ARN группы журналов Amazon CloudWatch Logs или ARN потока доставки данных 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 -> (structure)

Конфигурация SSD IOPS (операции ввода-вывода в секунду) для файловой системы Amazon FSx для Windows. По умолчанию Amazon FSx автоматически предоставляет 3 IOPS на ГиБ емкости хранилища. Вы можете предоставить дополнительные IOPS на ГиБ хранилища, вплоть до максимального лимита, связанного с выбранной вами пропускной способностью.

Mode -> (string)

Указывает, использует ли файловая система параметр AUTOMATIC SSD IOPS, равный 3 IOPS на ГБ емкости хранилища, или значение USER_PROVISIONED .

Iops -> (long)

Общее количество SSD IOPS, предоставленных для файловой системы.

Минимальные и максимальные значения для этого свойства зависят от значения HAPairs и StorageCapacity . Минимальное значение рассчитывается как StorageCapacity * 3 * HAPairs (3 IOPS на ГБ StorageCapacity ). Максимальное значение рассчитывается как 200 000 * HAPairs .

Amazon FSx отвечает кодом состояния HTTP 400 (Bad Request), если значение Iops выходит за пределы минимального или максимального значения.

LustreConfiguration -> (structure)

Настройка для файловой системы Amazon FSx для Lustre.

WeeklyMaintenanceStartTime -> (string)

Предпочитаемое время начала еженедельного обслуживания, отформатированное d:HH:MM в часовом поясе UTC. Здесь, d — номер дня недели, от 1 до 7, начиная с понедельника и заканчивая воскресеньем.

DataRepositoryConfiguration -> (structure)

Объект конфигурации репозитория данных для файловых систем Lustre, возвращенный в ответе операции CreateFileSystem.

Этот тип данных не поддерживается в файловых системах с ассоциацией репозитория данных. Для файловых систем с ассоциацией репозитория данных см. .

Lifecycle -> (string)

Описывает состояние устойчивого репозитория данных S3 файловой системы, если он настроен с репозиторием S3. Жизненный цикл может иметь следующие значения:

  • CREATING - Конфигурация репозитория данных между файловой системой FSx и связанным репозиторием данных S3 создается. Репозиторий данных недоступен.
  • AVAILABLE - Репозиторий данных доступен для использования.
  • MISCONFIGURED - Amazon FSx не может автоматически импортировать обновления из корзины S3 до тех пор, пока не будет исправлена конфигурация репозитория данных. Для получения дополнительной информации см. Устранение неполадок в неправильно настроенной связанной корзине S3 .
  • UPDATING - Репозиторий данных проходит обновление, инициированное клиентом, и доступность может быть нарушена.
  • FAILED - Репозиторий данных находится в конечном состоянии, которое невозможно восстановить.

ImportPath -> (string)

Путь импорта в корзину Amazon S3 (и необязательный префикс), которую вы используете в качестве репозитория данных для вашей файловой системы FSx для Lustre, например s3://import-bucket/optional-prefix . Если префикс указан после имени корзины Amazon S3, в файловую систему загружаются только ключи объектов с этим префиксом.

ExportPath -> (string)

Путь экспорта в корзину Amazon S3 (и префикс), который вы используете для хранения новых и измененных файлов файловой системы Lustre в S3.

ImportedFileChunkSize -> (integer)

Для файлов, импортированных из репозитория данных, это значение определяет количество полос и максимальный объем данных на файл (в МиБ), хранящихся на одном физическом диске. Максимальное количество дисков, на которых может быть выполнена полоса для одного файла, ограничено общим количеством дисков, составляющих файловую систему.

Размер фрагмента по умолчанию — 1024 МиБ (1 ГиБ) и может достигать 512 000 МиБ (500 ГиБ). Объекты Amazon S3 имеют максимальный размер 5 ТБ.

AutoImportPolicy -> (string)

Описывает AutoImportPolicy связанного репозитория данных S3 файловой системы. AutoImportPolicy настраивает способ, которым Amazon FSx поддерживает актуальность списков файлов и каталогов при добавлении или изменении объектов в связанной корзине S3. AutoImportPolicy может иметь следующие значения:

  • NONE - (По умолчанию) AutoImport выключен. Amazon FSx обновляет списки файлов и каталогов из связанной корзины S3 только при создании файловой системы. FSx не обновляет списки файлов и каталогов для каких-либо новых или измененных объектов после выбора этого параметра.
  • NEW - AutoImport включен. Amazon FSx автоматически импортирует списки каталогов любых новых объектов, добавленных в связанную корзину S3, которых в настоящее время нет в файловой системе FSx.
  • NEW_CHANGED - AutoImport включен. Amazon FSx автоматически импортирует списки файлов и каталогов любых новых объектов, добавленных в корзину S3, и любых существующих объектов, измененных в корзине S3 после выбора этого параметра.
  • NEW_CHANGED_DELETED - AutoImport включен. Amazon FSx автоматически импортирует списки файлов и каталогов любых новых объектов, добавленных в корзину S3, любых существующих объектов, измененных в корзине S3, и любых объектов, которые были удалены в корзине S3.

FailureDetails -> (structure)

Предоставляет подробную информацию о репозитории данных, если его Lifecycle установлено на MISCONFIGURED или FAILED.

Message -> (string)

Подробное сообщение об ошибке.

DeploymentType -> (string)

Тип развертывания файловой системы FSx для Lustre. Тип развертывания Scratch предназначен для временного хранения и краткосрочной обработки данных.

SCRATCH_1 и SCRATCH_2 типы развертывания лучше всего подходят для тех случаев, когда вам требуется временное хранилище и краткосрочная обработка данных. Тип развертывания SCRATCH_2 обеспечивает шифрование данных во время передачи и более высокую пропускную способность burst, чем SCRATCH_1 .

Тип развертывания PERSISTENT_1 и PERSISTENT_2 используется для долгосрочного хранения и рабочих нагрузок, а также для шифрования данных во время передачи. PERSISTENT_2 предлагает более высокую PerUnitStorageThroughput (до 1000 МБ/с/ТиБ) наряду с более низкими минимальными требованиями к емкости хранилища (600 ГиБ). Чтобы узнать больше о типах развертывания FSx для Lustre, см. Параметры развертывания FSx для Lustre .

По умолчанию используется SCRATCH_1 .

PerUnitStorageThroughput -> (integer)

Пропускная способность хранилища на единицу представляет мегабайты в секунду пропускной способности чтения или записи на 1 тебибайт подготовленного хранилища. Пропускная способность файловой системы равна емкости хранилища (TiB) * PerUnitStorageThroughput (МБ/с/ТиБ). Этот параметр действителен только для типов развертывания PERSISTENT_1 и PERSISTENT_2.

Допустимые значения:

  • Для PERSISTENT_1 SSD-хранилища: 50, 100, 200.
  • Для PERSISTENT_1 HDD-хранилища: 12, 40.
  • Для PERSISTENT_2 SSD-хранилища: 125, 250, 500, 1000.

MountName -> (string)

Вы используете значение MountName при монтировании файловой системы.

Для типа развертывания SCRATCH_1 это значение всегда “fsx ". Для типов развертывания SCRATCH_2, PERSISTENT_1 и PERSISTENT_2 это значение представляет собой строку, которая уникальна в рамках региона Amazon Web Services.

DailyAutomaticBackupStartTime -> (string)

Повторяющееся ежедневное время в формате HH:MM. HH — это час дня с заполнением нулями (0–23), а MM — минута часа с заполнением нулями. Например, 05:00 указывает 5 утра ежедневно.

AutomaticBackupRetentionDays -> (integer)

Количество дней для хранения автоматических резервных копий. Установка этого свойства в 0 отключает автоматическое резервное копирование. Автоматические резервные копии можно хранить максимум 90 дней. По умолчанию используется 30 .

CopyTagsToBackups -> (boolean)

Логический флаг, указывающий, копируются ли теги файловой системы в резервные копии. Если установлено значение true, все теги файловой системы копируются во все автоматические резервные копии и любые резервные копии, инициированные пользователем, в которых пользователь не указывает никаких тегов. Если это значение равно true, и вы указываете один или несколько тегов, в резервные копии копируются только указанные теги. Если вы указываете один или несколько тегов при создании резервной копии, инициированной пользователем, теги из файловой системы не копируются, независимо от этого значения. (По умолчанию = false)

DriveCacheType -> (string)

Тип кэша диска, используемый файловыми системами PERSISTENT_1, которые предоставляются с устройствами хранения HDD. Этот параметр требуется, когда StorageType — HDD. При установке значения READ файловая система имеет кэш SSD, размер которого составляет 20% от емкости хранилища файловой системы. Это улучшает производительность часто используемых файлов, кэшируя до 20% от общей емкости хранилища.

Этот параметр требуется, когда StorageType установлено значение HDD.

DataCompressionType -> (string)

Конфигурация сжатия данных для файловой системы. DataCompressionType может иметь следующие значения:

  • NONE - Сжатие данных отключено для файловой системы.
  • LZ4 - Сжатие данных включено с алгоритмом LZ4.

Дополнительные сведения см. в разделе Сжатие данных Lustre .

LogConfiguration -> (structure)

Конфигурация ведения журнала Lustre. Ведение журнала Lustre записывает включенные события журнала для вашей файловой системы в Amazon CloudWatch Logs.

Level -> (string)

События репозитория данных, которые регистрируются Amazon FSx.

  • WARN_ONLY - регистрируются только предупреждения.
  • ERROR_ONLY - регистрируются только ошибки.
  • WARN_ERROR - регистрируются как предупреждения, так и ошибки.
  • DISABLED - ведение журнала событий репозитория данных отключено.

Обратите внимание, что Amazon File Cache использует настройку по умолчанию WARN_ERROR, которую нельзя изменить.

Destination -> (string)

Имя ресурса Amazon (ARN), указывающее пункт назначения журналов. Назначением может быть любой ARN группы журналов Amazon CloudWatch Logs. Целевой ARN должен находиться в том же разделе Amazon Web Services, регионе Amazon Web Services и учетной записи Amazon Web Services, что и ваша файловая система Amazon FSx.

RootSquashConfiguration -> (structure)

Конфигурация сжатия root Lustre для файловой системы Amazon FSx для Lustre. При включении сжатие root ограничивает доступ root-уровня с клиентов, пытающихся получить доступ к вашей файловой системе в качестве пользователя root.

RootSquash -> (string)

Вы включаете root squash, установив идентификатор пользователя (UID) и идентификатор группы (GID) для файловой системы в формате UID:GID (например, 365534:65534 ). Значения UID и GID могут варьироваться от 0 до 4294967294:

  • Ненулевое значение для UID и GID включает root squash. Значения UID и GID могут быть разными, но каждое из них должно быть ненулевым значением.
  • Значение 0 (ноль) для UID и GID указывает root и, следовательно, отключает root squash.

Когда включено root squash, идентификатор пользователя и идентификатор группы пользователя root, обращающегося к файловой системе, переназначаются на UID и GID, которые вы предоставляете.

NoSquashNids -> (list)

Когда root squash включен, вы можете дополнительно указать массив NID клиентов, для которых root squash не применяется. NID клиента — это сетевой идентификатор Lustre, используемый для уникальной идентификации клиента. Вы можете указать NID как отдельный адрес, так и диапазон адресов:

  • Одиночный адрес описывается в стандартном формате Lustre NID путем указания IP-адреса клиента, за которым следует сетевой идентификатор Lustre (например, 10.0.1.6@tcp ).
  • Диапазон адресов описывается с использованием тире для разделения диапазона (например, 10.0.[2-10].[1-255]@tcp ).

(string)

MetadataConfiguration -> (structure)

Конфигурация производительности метаданных Lustre для файловой системы Amazon FSx for Lustre с использованием типа развертывания PERSISTENT_2.

Iops -> (integer)

Количество подготовленных операций ввода-вывода в секунду (IOPS) метаданных для файловой системы. Допустимые значения: 1500 , 3000 , 6000 , 12000 и кратные 12000 до максимума 192000 .

Mode -> (string)

Режим конфигурации метаданных для выделения IOPS метаданных для файловой системы.

  • В режиме AUTOMATIC FSx for Lustre автоматически выделяет и масштабирует количество IOPS метаданных в вашей файловой системе в зависимости от емкости хранилища вашей файловой системы.
  • В режиме USER_PROVISIONED можно указать количество IOPS метаданных для выделения для вашей файловой системы.

EfaEnabled -> (boolean)

Указывает, включена ли поддержка Elastic Fabric Adapter (EFA) и GPUDirect Storage (GDS) для файловой системы Amazon FSx for Lustre.

OntapConfiguration -> (structure)

Конфигурация для этой файловой системы Amazon FSx for NetApp ONTAP.

AutomaticBackupRetentionDays -> (integer)

Количество дней для хранения автоматических резервных копий. Установка этого свойства в значение 0 отключает автоматическое резервное копирование. Вы можете хранить автоматические резервные копии не более 90 дней. Значение по умолчанию — 30 .

DailyAutomaticBackupStartTime -> (string)

Повторяющееся ежедневное время в формате HH:MM . HH — это час дня с заполнением нулями (0-23), а MM — это минута часа с заполнением нулями. Например, 05:00 указывает на 5 утра ежедневно.

DeploymentType -> (string)

Указывает тип развертывания файловой системы FSx for ONTAP, используемый в файловой системе.

  • MULTI_AZ_1 — файловая система высокой доступности, настроенная для избыточности Multi-AZ для обеспечения отказоустойчивости при временной недоступности зоны доступности (AZ). Это файловая система FSx for ONTAP первого поколения.
  • MULTI_AZ_2 — файловая система высокой доступности, настроенная для избыточности Multi-AZ для обеспечения отказоустойчивости при временной недоступности AZ. Это файловая система FSx for ONTAP второго поколения.
  • SINGLE_AZ_1 — файловая система, настроенная для избыточности Single-AZ. Это файловая система FSx for ONTAP первого поколения.
  • SINGLE_AZ_2 — файловая система, настроенная с несколькими парами высокой доступности (HA) для избыточности Single-AZ. Это файловая система FSx for ONTAP второго поколения.

Для получения информации о вариантах использования развертываний Multi-AZ и Single-AZ см. раздел Выбор развертывания файловой системы Multi-AZ или Single-AZ .

EndpointIpAddressRange -> (string)

(Только для Multi-AZ) Указывает диапазон IP-адресов, в котором будут созданы конечные точки для доступа к вашей файловой системе. По умолчанию в API Amazon FSx Amazon FSx выбирает неиспользуемый диапазон IP-адресов для вас из диапазона 198.19.*. По умолчанию в консоли Amazon FSx Amazon FSx выбирает последние 64 IP-адреса из основного диапазона CIDR VPC для использования в качестве диапазона IP-адресов конечной точки для файловой системы. У вас могут быть перекрывающиеся IP-адреса конечных точек для файловых систем, развернутых в одной и той же VPC/таблице маршрутизации.

Endpoints -> (structure)

Конечные точки Management и Intercluster , которые используются для доступа к данным или управления файловой системой с помощью NetApp ONTAP CLI, REST API или NetApp SnapMirror.

Intercluster -> (structure)

Конечная точка для управления вашей файловой системой путем настройки NetApp SnapMirror с другими системами ONTAP.

DNSName -> (string)

DNS-имя файловой системы. Вы можете смонтировать свою файловую систему, используя ее DNS-имя.

IpAddresses -> (list)

IP-адреса конечной точки файловой системы.

(string)

Management -> (structure)

Конечная точка для управления вашей файловой системой с помощью NetApp ONTAP CLI и NetApp ONTAP API.

DNSName -> (string)

DNS-имя файловой системы. Вы можете смонтировать свою файловую систему, используя ее DNS-имя.

IpAddresses -> (list)

IP-адреса конечной точки файловой системы.

(string)

DiskIopsConfiguration -> (structure)

Конфигурация SSD IOPS для файловой системы ONTAP, указывающая количество подготовленных IOPS и режим подготовки.

Mode -> (string)

Указывает, использует ли файловая система настройку AUTOMATIC SSD IOPS 3 IOPS на ГБ емкости хранилища или использует значение USER_PROVISIONED .

Iops -> (long)

Общее количество SSD IOPS, подготовленных для файловой системы.

Минимальное и максимальное значения этого свойства зависят от значения HAPairs и StorageCapacity . Минимальное значение рассчитывается как StorageCapacity * 3 * HAPairs (3 IOPS на ГБ StorageCapacity ). Максимальное значение рассчитывается как 200 000 * HAPairs .

Amazon FSx отвечает кодом состояния HTTP 400 (Bad Request), если значение Iops выходит за пределы минимального или максимального значений.

PreferredSubnetId -> (string)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашей виртуальной частной облаке (VPC). Дополнительные сведения см. в разделах VPC и подсети в Руководстве пользователя Amazon VPC.

RouteTableIds -> (list)

(Только для Multi-AZ) Таблицы маршрутизации VPC, в которых создаются конечные точки вашей файловой системы.

(string)

ThroughputCapacity -> (integer)

Устойчивая пропускная способность файловой системы Amazon FSx в мегабайтах в секунду (МБ/с).

WeeklyMaintenanceStartTime -> (string)

Повторяющееся еженедельное время в формате D:HH:MM .

D — это день недели, где 1 представляет понедельник, а 7 — воскресенье. Для получения более подробной информации см. спецификацию ISO-8601, описанную в Wikipedia .

HH — это час дня с заполнением нулями (0-23), а MM — это минута часа с заполнением нулями.

Например, 1:05:00 указывает на обслуживание в 5 утра в понедельник.

FsxAdminPassword -> (string)

Вы можете использовать учетную запись пользователя fsxadmin для доступа к NetApp ONTAP CLI и REST API. Значение пароля всегда редактируется в ответе.

HAPairs -> (integer)

Указывает, сколько пар файловых серверов высокой доступности (HA) будет иметь файловая система. Значение по умолчанию — 1. Значение этого свойства влияет на значения StorageCapacity , Iops и ThroughputCapacity . Дополнительные сведения см. в разделе Пары высокой доступности (HA) в руководстве пользователя FSx for ONTAP.

Amazon FSx отвечает кодом состояния HTTP 400 (Bad Request) при следующих условиях:

  • Значение HAPairs меньше 1 или больше 12.
  • Значение HAPairs больше 1, а значение DeploymentType равно SINGLE_AZ_1 , MULTI_AZ_1 или MULTI_AZ_2 .

ThroughputCapacityPerHAPair -> (integer)

Используйте для выбора пропускной способности на пару 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 (Bad Request) при следующих условиях:

  • Значение ThroughputCapacity и ThroughputCapacityPerHAPair не совпадают.
  • Тип развертывания — SINGLE_AZ_2, а ThroughputCapacity / ThroughputCapacityPerHAPair не является допустимой парой HA (значение от 1 до 12).
  • Значение ThroughputCapacityPerHAPair недопустимо.

FileSystemTypeVersion -> (string)

Версия Lustre файловой системы Amazon FSx for Lustre, которая может быть 2.10 , 2.12 или 2.15 .

OpenZFSConfiguration -> (structure)

Конфигурация для этой файловой системы Amazon FSx for OpenZFS.

AutomaticBackupRetentionDays -> (integer)

Количество дней хранения автоматических резервных копий. Установка этого свойства в 0 отключает автоматическое резервное копирование. Вы можете хранить автоматические резервные копии максимум 90 дней. Значение по умолчанию - 30 .

CopyTagsToBackups -> (boolean)

Логическое значение, указывающее, должны ли теги в файловой системе копироваться в резервные копии. Если оно установлено в true , все теги в файловой системе копируются во все автоматические резервные копии и любые резервные копии, инициированные пользователем, где пользователь не указывает никаких тегов. Если это значение равно true , и вы указываете один или несколько тегов, в резервные копии копируются только указанные теги. Если вы указываете один или несколько тегов при создании резервной копии, инициированной пользователем, теги из файловой системы не копируются, независимо от этого значения.

CopyTagsToVolumes -> (boolean)

Логическое значение, указывающее, должны ли теги для тома копироваться в моментальные снимки. Это значение по умолчанию равно false . Если оно установлено в true , все теги для тома копируются в моментальные снимки, где пользователь не указывает теги. Если это значение равно true , и вы указываете один или несколько тегов, в моментальные снимки копируются только указанные теги. Если вы указываете один или несколько тегов при создании моментального снимка, теги из тома не копируются, независимо от этого значения.

DailyAutomaticBackupStartTime -> (string)

Повторяющееся ежедневное время в формате HH:MM . HH — это час дня с заполнением нулями (0–23), а MM — минута часа с заполнением нулями. Например, 05:00 указывает на 5 утра ежедневно.

DeploymentType -> (string)

Указывает тип развертывания файловой системы. Amazon FSx for OpenZFS поддерживает MULTI_AZ_1 , SINGLE_AZ_HA_2 , SINGLE_AZ_HA_1 , SINGLE_AZ_2 и SINGLE_AZ_1 .

ThroughputCapacity -> (integer)

Пропускная способность файловой системы Amazon FSx, измеряемая в мегабайтах в секунду (МБ/с).

WeeklyMaintenanceStartTime -> (string)

Повторяющееся еженедельное время в формате D:HH:MM .

D — это день недели, где 1 соответствует понедельнику, а 7 — воскресенью. Для получения дополнительной информации см. спецификацию ISO-8601, как описано в Wikipedia .

HH — это час дня с заполнением нулями (0–23), а MM — минута часа с заполнением нулями.

Например, 1:05:00 указывает на техническое обслуживание в 5 утра в понедельник.

DiskIopsConfiguration -> (structure)

Конфигурация SSD IOPS (операции ввода-вывода в секунду) для файловой системы Amazon FSx for NetApp ONTAP, Amazon FSx for Windows File Server или FSx for OpenZFS. По умолчанию Amazon FSx автоматически выделяет 3 IOPS на ГБ емкости хранилища. Вы можете выделить дополнительные IOPS на ГБ хранилища. Конфигурация состоит из общего количества выделенных SSD IOPS и способа их выделения, или режима (клиентом или Amazon FSx).

Mode -> (string)

Указывает, использует ли файловая система настройку AUTOMATIC SSD IOPS со значением 3 IOPS на ГБ емкости хранилища, или использует значение USER_PROVISIONED .

Iops -> (long)

Общее количество SSD IOPS, выделенных для файловой системы.

Минимальные и максимальные значения для этого свойства зависят от значения HAPairs и StorageCapacity . Минимальное значение рассчитывается как StorageCapacity * 3 * HAPairs (3 IOPS на ГБ StorageCapacity ). Максимальное значение рассчитывается как 200 000 * HAPairs .

Amazon FSx отвечает с кодом состояния HTTP 400 (Bad Request), если значение Iops выходит за пределы минимального или максимального значения.

RootVolumeId -> (string)

Идентификатор корневого тома файловой системы OpenZFS.

PreferredSubnetId -> (string)

Требуется, когда DeploymentType имеет значение MULTI_AZ_1 . Это указывает подсеть, в которой вы хотите, чтобы находился предпочтительный файловый сервер.

EndpointIpAddressRange -> (string)

(Только Multi-AZ) Указывает диапазон IP-адресов, в котором будут созданы конечные точки для доступа к вашей файловой системе. По умолчанию в API Amazon FSx и консоли Amazon FSx Amazon FSx выбирает доступный диапазон IP-адресов /28 для вас из одного из диапазонов CIDR VPC. У вас могут быть перекрывающиеся IP-адреса конечных точек для файловых систем, развернутых в одной и той же таблице VPC/маршрутизации.

RouteTableIds -> (list)

(Только Multi-AZ) Таблицы маршрутизации VPC, в которых создаются конечные точки вашей файловой системы.

(string)

EndpointIpAddress -> (string)

IP-адрес конечной точки, используемой для доступа к данным или управления файловой системой.

ReadCacheConfiguration -> (structure)

Требуется, когда StorageType имеет значение INTELLIGENT_TIERING . Указывает дополнительный выделенный кэш чтения SSD.

SizingMode -> (string)

Указывает, как определяется размер выделенного кэша чтения SSD, следующим образом:

  • Установите значение NO_CACHE , если вы не хотите использовать кэш чтения SSD с файловой системой Intelligent-Tiering.
  • Установите значение USER_PROVISIONED , чтобы указать точный размер кэша чтения SSD.
  • Установите значение PROPORTIONAL_TO_THROUGHPUT_CAPACITY , чтобы кэш чтения SSD автоматически определял размер в зависимости от пропускной способности.

SizeGiB -> (integer)

Требуется, если SizingMode имеет значение USER_PROVISIONED . Указывает размер кэша чтения SSD файловой системы в гибибайтах (ГиБ).

FailureDetails -> (structure)

Предоставляет информацию о неудачном административном действии.

Message -> (string)

Сообщение об ошибке с подробностями о неудачном административном действии.

TargetVolumeValues -> (structure)

Описывает том 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 - перемещает все блоки пользовательских данных как в активной файловой системе, так и в копиях Snapshot в уровень хранилища пула.
  • NONE - сохраняет данные тома в основном уровне хранилища, не позволяя им перемещаться в уровень пула емкости.

UUID -> (string)

Универсальный уникальный идентификатор (UUID) тома.

OntapVolumeType -> (string)

Указывает тип тома. Допустимые значения:

  • RW указывает том для чтения/записи. RW является значением по умолчанию.
  • DP указывает том защиты данных. Вы можете защитить данные, реплицируя их в зеркальные копии защиты данных. В случае аварии вы можете использовать эти зеркальные копии защиты данных для восстановления данных.
  • LS указывает зеркальный том с совместным использованием нагрузки. Зеркало с совместным использованием нагрузки уменьшает сетевой трафик для тома FlexVol, обеспечивая дополнительный доступ только для чтения к клиентам.

SnapshotPolicy -> (string)

Указывает политику снимков для тома. Существует три встроенные политики снимков:

  • default : это политика по умолчанию. Максимум шесть почасовых снимков, сделанных через пять минут после часа. Максимум два ежедневных снимка, сделанных с понедельника по субботу в 00:10. Максимум два еженедельных снимка, сделанных каждое воскресенье в 00:15.
  • default-1weekly : эта политика такая же, как и политика default , за исключением того, что она сохраняет только один снимок из еженедельного расписания.
  • none : эта политика не делает никаких снимков. Эту политику можно назначить томам, чтобы предотвратить автоматическое создание снимков.

Вы также можете указать имя пользовательской политики, созданной с помощью CLI или REST API ONTAP.

Для получения дополнительной информации см. раздел «Политики снимков» в Руководстве пользователя Amazon FSx для NetApp ONTAP.

CopyTagsToBackups -> (boolean)

Логический флаг, указывающий, должны ли теги для тома копироваться в резервные копии. Значение по умолчанию — false. Если установлено значение true, все теги для тома копируются во все автоматические и инициированные пользователем резервные копии, в которых пользователь не указывает теги. Если это значение равно true, и вы укажете один или несколько тегов, только указанные теги будут скопированы в резервные копии. Если вы укажете один или несколько тегов при создании резервной копии, инициированной пользователем, теги не будут скопированы из тома, независимо от этого значения.

SnaplockConfiguration -> (structure)

Объект конфигурации SnapLock для тома FSx для ONTAP SnapLock.

AuditLogVolume -> (boolean)

Включает или отключает том журнала аудита для тома FSx для ONTAP SnapLock. Значение по умолчанию false . Если вы установите AuditLogVolume в true , том SnapLock будет создан как том журнала аудита. Минимальный срок хранения для тома журнала аудита составляет шесть месяцев.

Более подробную информацию см. в разделе Тома журнала аудита SnapLock .

AutocommitPeriod -> (structure)

Объект конфигурации для установки периода автоматической фиксации файлов в томе FSx для ONTAP SnapLock.

Type -> (string)

Определяет тип времени для периода автоматической фиксации файла в томе FSx для ONTAP SnapLock. Установка этого значения в NONE отключает автоматическую фиксацию. Значение по умолчанию NONE .

Value -> (integer)

Определяет количество времени для периода автоматической фиксации файла в томе FSx для ONTAP SnapLock. Допустимы следующие диапазоны:

  • Minutes : 5 - 65,535
  • Hours : 1 - 65,535
  • Days : 1 - 3,650
  • Months : 1 - 120
  • Years : 1 - 10

PrivilegedDelete -> (string)

Включает, отключает или окончательно отключает привилегированное удаление в томе FSx для ONTAP SnapLock Enterprise. Включение привилегированного удаления позволяет администраторам SnapLock удалять файлы write once, read many (WORM), даже если у них есть активные периоды хранения. PERMANENTLY_DISABLED является терминальным состоянием. Если привилегированное удаление окончательно отключено в томе SnapLock, вы не сможете включить его повторно. Значение по умолчанию DISABLED .

Более подробную информацию см. в разделе Привилегированное удаление .

RetentionPeriod -> (structure)

Указывает период хранения тома FSx для ONTAP SnapLock.

DefaultRetention -> (structure)

Период хранения, назначенный файлу write once, read many (WORM) по умолчанию, если для тома FSx для ONTAP SnapLock не установлен явный период хранения. Период хранения по умолчанию должен быть больше или равен минимальному периоду хранения и меньше или равен максимальному периоду хранения.

Type -> (string)

Определяет тип времени для периода хранения тома FSx для ONTAP SnapLock. Установите его в один из допустимых типов. Если вы установите его в INFINITE , файлы будут храниться вечно. Если вы установите его в UNSPECIFIED , файлы будут храниться до тех пор, пока вы не установите явный период хранения.

Value -> (integer)

Определяет количество времени для периода хранения тома FSx для ONTAP SnapLock. Вы не можете установить значение для INFINITE или UNSPECIFIED . Для всех остальных вариантов допустимы следующие диапазоны:

  • Seconds : 0 - 65,535
  • Minutes : 0 - 65,535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

MinimumRetention -> (structure)

Самый короткий период хранения, который можно назначить файлу WORM в томе FSx для ONTAP SnapLock.

Type -> (string)

Определяет тип времени для периода хранения тома FSx для ONTAP SnapLock. Установите его в один из допустимых типов. Если вы установите его в INFINITE , файлы будут храниться вечно. Если вы установите его в UNSPECIFIED , файлы будут храниться до тех пор, пока вы не установите явный период хранения.

Value -> (integer)

Определяет количество времени для периода хранения тома FSx для ONTAP SnapLock. Вы не можете установить значение для INFINITE или UNSPECIFIED . Для всех остальных вариантов допустимы следующие диапазоны:

  • Seconds : 0 - 65,535
  • Minutes : 0 - 65,535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

MaximumRetention -> (structure)

Самый длинный период хранения, который можно назначить файлу WORM в томе FSx для ONTAP SnapLock.

Type -> (string)

Определяет тип времени для периода хранения тома FSx для ONTAP SnapLock. Установите его в один из допустимых типов. Если вы установите его в INFINITE , файлы будут храниться вечно. Если вы установите его в UNSPECIFIED , файлы будут храниться до тех пор, пока вы не установите явный период хранения.

Value -> (integer)

Определяет количество времени для периода хранения тома FSx для ONTAP SnapLock. Вы не можете установить значение для INFINITE или UNSPECIFIED . Для всех остальных вариантов допустимы следующие диапазоны:

  • Seconds : 0 - 65,535
  • Minutes : 0 - 65,535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

SnaplockType -> (string)

Указывает режим хранения тома FSx для ONTAP SnapLock. После установки его нельзя изменить. Вы можете выбрать один из следующих режимов хранения:

  • COMPLIANCE : Файлы, переведенные в режим write once, read many (WORM) в томе Compliance, нельзя удалить до истечения срока их хранения. Этот режим хранения используется для решения государственных или отраслевых мандатов или для защиты от атак программ-вымогателей. Более подробную информацию см. в разделе SnapLock Compliance .
  • ENTERPRISE : Файлы, переведенные в режим WORM в томе Enterprise, могут быть удалены авторизованными пользователями до истечения срока их хранения с помощью привилегированного удаления. Этот режим хранения используется для повышения целостности данных и внутренней соответствия требованиям организации или для тестирования настроек хранения перед использованием SnapLock Compliance. Более подробную информацию см. в разделе SnapLock Enterprise .

VolumeAppendModeEnabled -> (boolean)

Включает или отключает режим добавления в том в томе FSx для ONTAP SnapLock. Режим добавления в том позволяет создавать файлы с возможностью добавления WORM и записывать данные в них постепенно. Значение по умолчанию false .

Более подробную информацию см. в разделе Режим добавления в том .

VolumeStyle -> (string)

Используйте для указания стиля тома ONTAP. Более подробную информацию о FlexVols и FlexGroups см. в разделе Типы томов в Руководстве пользователя Amazon FSx для NetApp ONTAP.

AggregateConfiguration -> (structure)

Эта структура указывает параметры конфигурации для агрегата или агрегатов хранилища тома.

Aggregates -> (list)

Список агрегатов, на которых находится этот том. Агрегаты — это пулы хранилища, которые составляют ваш основной уровень хранилища. Каждая пара высокой доступности (HA) имеет один агрегат. Имена агрегатов отображаются на имена агрегатов в ONTAP CLI и REST API. Для FlexVols всегда будет одна запись.

Amazon FSx отвечает с кодом состояния HTTP 400 (Bad Request) для следующих условий:

  • Строки в значении Aggregates не отформатированы как aggrX , где X — число от 1 до 12.
  • Значение Aggregates содержит отсутствующие агрегаты.
  • Один или несколько предоставленных агрегатов находятся слишком близко к лимиту тома, чтобы поддерживать добавление большего количества томов.

(string)

TotalConstituents -> (integer)

Общее количество составляющих этого тома FlexGroup. Неприменимо для FlexVols.

SizeInBytes -> (long)

Настроенный размер тома в байтах.

ResourceARN -> (string)

Имя ресурса Amazon (ARN) для данного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. Нам нужен ARN, когда вам нужно однозначно указать ресурс во всех службах Amazon Web Services. Более подробную информацию см. в разделе Имена ресурсов Amazon (ARN) в Справочнике Amazon Web Services .

Tags -> (list)

Список значений Tag , не более 50 элементов.

(structure)

Указывает пару ключ-значение для тега ресурса.

Key -> (string)

Значение, которое указывает TagKey , имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (string)

Значение, которое указывает TagValue , значение, присвоенное соответствующему ключу тега. Значения тегов могут быть нулевыми и не обязательно должны быть уникальными в наборе тегов. Например, у вас может быть пара ключ-значение в наборе тегов finances : April , а также payroll : April .

VolumeId -> (string)

Системный, уникальный идентификатор тома.

VolumeType -> (string)

Тип тома.

LifecycleTransitionReason -> (structure)

Причина, по которой изменился статус жизненного цикла тома.

Message -> (string)

Подробное сообщение об ошибке.

OpenZFSConfiguration -> (structure)

Конфигурация тома Amazon FSx для OpenZFS.

ParentVolumeId -> (string)

Идентификатор родительского тома.

VolumePath -> (string)

Путь к тому от корневого тома. Например, fsx/parentVolume/volume1 .

StorageCapacityReservationGiB -> (integer)

Объем хранилища в гибибайтах (GiB) для резервирования из родительского тома. Нельзя зарезервировать больше хранилища, чем зарезервировано в родительском томе.

StorageCapacityQuotaGiB -> (integer)

Максимальный объем хранилища в гибибайтах (GiB), который том может использовать из родительского. Можно указать квоту больше, чем хранилище в родительском томе.

RecordSizeKiB -> (integer)

Размер записи тома OpenZFS в килобайтах (KiB). Допустимые значения: 4, 8, 16, 32, 64, 128, 256, 512 или 1024 KiB. Значение по умолчанию — 128 KiB. Большинство рабочих нагрузок должны использовать размер записи по умолчанию. Руководство по настройке пользовательского размера записи см. в Amazon FSx for OpenZFS User Guide .

DataCompressionType -> (string)

Указывает метод, используемый для сжатия данных в томе. Тип сжатия по умолчанию — NONE .

  • NONE — не сжимает данные в томе. NONE — значение по умолчанию.
  • ZSTD — сжимает данные в томе с помощью алгоритма сжатия Zstandard (ZSTD). По сравнению с LZ4 Z-Standard обеспечивает лучшее соотношение сжатия для минимизации использования дискового пространства.
  • LZ4 — сжимает данные в томе с помощью алгоритма сжатия LZ4. По сравнению с Z-Standard LZ4 менее ресурсоемкий и обеспечивает более высокую скорость записи.

CopyTagsToSnapshots -> (boolean)

Логическое значение, указывающее, следует ли копировать теги для тома в моментальные снимки. По умолчанию это значение равно false . Если задано значение true , все теги для тома копируются в моментальные снимки, где пользователь не указывает теги. Если это значение равно true и указан один или несколько тегов, в моментальные снимки копируются только указанные теги. Если при создании моментального снимка указан один или несколько тегов, теги из тома не копируются, независимо от этого значения.

OriginSnapshot -> (structure)

Объект конфигурации, который указывает моментальный снимок, который будет использоваться в качестве источника данных для тома.

SnapshotARN -> (string)

Имя ресурса Amazon (ARN) для заданного ресурса. ARN уникально идентифицируют ресурсы Amazon Web Services. ARN требуется, когда необходимо однозначно указать ресурс во всех службах Amazon Web Services. Дополнительные сведения см. в разделе Имена ресурсов Amazon (ARN) в Справочнике по Amazon Web Services .

CopyStrategy -> (string)

Стратегия, используемая при копировании данных из моментального снимка в новый том.

  • CLONE — новый том ссылается на данные в исходном моментальном снимке. Клонирование моментального снимка выполняется быстрее, чем копирование данных из моментального снимка в новый том, и не потребляет пропускную способность диска. Однако исходный моментальный снимок нельзя удалить, если есть том, использующий его скопированные данные.
  • FULL_COPY — копирует все данные из моментального снимка в новый том.

Примечание

Параметр INCREMENTAL_COPY предназначен только для обновления существующего тома с помощью моментального снимка из другой файловой системы FSx для OpenZFS. Дополнительные сведения см. в разделе CopySnapshotAndUpdateVolume .

ReadOnly -> (boolean)

Логическое значение, указывающее, является ли том доступным только для чтения.

NfsExports -> (list)

Объект конфигурации для монтирования файловой системы Network File System (NFS).

(structure)

Конфигурации Network File System (NFS) для монтирования файловой системы Amazon FSx для OpenZFS.

ClientConfigurations -> (list)

Список объектов конфигурации, содержащих клиент и параметры для монтирования файловой системы OpenZFS.

(structure)

Указывает, кто может монтировать файловую систему OpenZFS, и доступные параметры при монтировании файловой системы.

Clients -> (string)

Значение, указывающее, кто может монтировать файловую систему. Можно указать символ подстановки (* ), IP-адрес (0.0.0.0 ) или адрес CIDR (192.0.2.0/24 ). По умолчанию Amazon FSx использует символ подстановки при указании клиента.

Options -> (list)

Параметры, используемые при монтировании файловой системы. Список параметров, которые можно использовать с Network File System (NFS), см. в man-странице экспортов (5) Linux . При выборе параметров учитывайте следующее:

  • crossmnt используется по умолчанию. Если вы не укажете crossmnt при изменении конфигурации клиента, вы не сможете просматривать или получать доступ к моментальным снимкам в каталоге моментальных снимков вашей файловой системы.
  • sync используется по умолчанию. Если вместо этого указать async , система подтверждает записи перед записью на диск. Если система аварийно завершит работу до завершения записи, вы потеряете незаписанные данные.

(string)

UserAndGroupQuotas -> (list)

Объект, указывающий, сколько места для хранения могут использовать пользователи или группы в томе.

(structure)

Используется для настройки квот, определяющих, сколько хранилища пользователь или группа могут использовать в томе FSx для OpenZFS. Дополнительные сведения см. в разделе Свойства тома в Руководстве пользователя FSx для OpenZFS.

Type -> (string)

Указывает, применяется ли квота к пользователю или группе.

Id -> (integer)

Идентификатор пользователя или группы, к которым применяется квота.

StorageCapacityQuotaGiB -> (integer)

Квота хранилища пользователя или группы в гибибайтах (GiB).

RestoreToSnapshot -> (string)

Указывает идентификатор моментального снимка, к которому был восстановлен том.

DeleteIntermediateSnaphots -> (boolean)

Логическое значение, указывающее, следует ли удалять моментальные снимки между текущим состоянием и указанным моментальным снимком при восстановлении тома из моментального снимка.

DeleteClonedVolumes -> (boolean)

Логическое значение, указывающее, следует ли удалять зависимые клонированные тома, созданные из промежуточных моментальных снимков, при восстановлении тома из моментального снимка.

DeleteIntermediateData -> (boolean)

Логическое значение, указывающее, следует ли перезаписывать данные моментального снимка, которые отличаются между текущим состоянием и указанным моментальным снимком при восстановлении тома из моментального снимка.

SourceSnapshotARN -> (string)

Имя ресурса Amazon (ARN) для заданного ресурса. ARN уникально идентифицируют ресурсы Amazon Web Services. ARN требуется, когда необходимо однозначно указать ресурс во всех службах Amazon Web Services. Дополнительные сведения см. в разделе Имена ресурсов Amazon (ARN) в Справочнике по Amazon Web Services .

DestinationSnapshot -> (string)

Идентификатор моментального снимка, который копируется или был недавно скопирован в целевой том.

CopyStrategy -> (string)

Указывает стратегию, используемую при копировании данных из моментального снимка в новый том.

  • CLONE — новый том ссылается на данные в исходном моментальном снимке. Клонирование моментального снимка выполняется быстрее, чем копирование данных из моментального снимка в новый том, и не потребляет пропускную способность диска. Однако исходный моментальный снимок нельзя удалить, если есть том, использующий его скопированные данные.
  • FULL_COPY — копирует все данные из моментального снимка в новый том. Укажите этот параметр, чтобы создать том из моментального снимка в другой файловой системе FSx для OpenZFS.

Примечание

Параметр INCREMENTAL_COPY предназначен только для обновления существующего тома с помощью моментального снимка из другой файловой системы FSx для OpenZFS. Дополнительные сведения см. в разделе CopySnapshotAndUpdateVolume .

TargetSnapshotValues -> (structure)

Моментальный снимок тома Amazon FSx для OpenZFS.

ResourceARN -> (string)

Имя ресурса Amazon (ARN) для заданного ресурса. ARN уникально идентифицируют ресурсы Amazon Web Services. ARN требуется, когда необходимо однозначно указать ресурс во всех службах Amazon Web Services. Дополнительные сведения см. в разделе Имена ресурсов Amazon (ARN) в Справочнике по Amazon Web Services .

SnapshotId -> (string)

Идентификатор моментального снимка.

Name -> (string)

Имя моментального снимка.

VolumeId -> (string)

Идентификатор тома, моментальный снимок которого делается.

CreationTime -> (timestamp)

Время создания ресурса в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

Lifecycle -> (string)

Состояние жизненного цикла моментального снимка.

  • PENDING — Amazon FSx не начал создание моментального снимка.
  • CREATING — Amazon FSx создает моментальный снимок.
  • DELETING — Amazon FSx удаляет моментальный снимок.
  • AVAILABLE — моментальный снимок полностью доступен.

LifecycleTransitionReason -> (structure)

Описывает, почему изменилось состояние жизненного цикла ресурса.

Message -> (string)

Подробное сообщение об ошибке.

Tags -> (list)

Список значений Tag , не более 50 элементов.

(structure)

Указывает пару «ключ-значение» для тега ресурса.

Key -> (string)

Значение, определяющее TagKey , имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (string)

Значение, определяющее TagValue , значение, присвоенное соответствующему ключу тега. Значения тегов могут быть null и не должны быть уникальными в наборе тегов. Например, в наборе тегов может быть пара «ключ-значение» finances : April и payroll : April .

TotalTransferBytes -> (long)

Количество байтов, перенесенных для моментального снимка FSx для OpenZFS, который копируется.

RemainingTransferBytes -> (long)

Оставшиеся байты для передачи для моментального снимка FSx для OpenZFS, который копируется.

TotalTransferBytes -> (long)

Количество байтов, перенесенных для моментального снимка FSx для OpenZFS, который копируется.

RemainingTransferBytes -> (long)

Оставшиеся байты для передачи для моментального снимка FSx для OpenZFS, который копируется.

OntapConfiguration -> (structure)

Конфигурация для этой файловой системы Amazon FSx for NetApp ONTAP.

AutomaticBackupRetentionDays -> (integer)

Количество дней хранения автоматических резервных копий. Установка этого свойства в 0 отключает автоматическое резервное копирование. Вы можете хранить автоматические резервные копии максимум 90 дней. По умолчанию используется 30.

DailyAutomaticBackupStartTime -> (string)

Повторяющееся ежедневное время в формате HH:MM. HH - это час дня с заполнением нулями (0-23), а MM - это минута часа с заполнением нулями. Например, 05:00 указывает 5 утра ежедневно.

DeploymentType -> (string)

Указывает тип развертывания файловой системы FSx for ONTAP, используемый в файловой системе.

  • MULTI_AZ_1 - файловая система высокой доступности, настроенная для избыточности Multi-AZ для обеспечения устойчивости к временной недоступности зоны доступности (AZ). Это файловая система FSx for ONTAP первого поколения.
  • MULTI_AZ_2 - файловая система высокой доступности, настроенная для избыточности Multi-AZ для обеспечения устойчивости к временной недоступности AZ. Это файловая система FSx for ONTAP второго поколения.
  • SINGLE_AZ_1 - файловая система, настроенная для избыточности Single-AZ. Это файловая система FSx for ONTAP первого поколения.
  • SINGLE_AZ_2 - файловая система, настроенная с несколькими парами высокой доступности (HA) для избыточности Single-AZ. Это файловая система FSx for ONTAP второго поколения.

Информацию об вариантах использования развертываний Multi-AZ и Single-AZ см. в разделе Выбор развертывания файловой системы Multi-AZ или Single-AZ.

EndpointIpAddressRange -> (string)

(Только для Multi-AZ) Указывает диапазон IP-адресов, в котором будут созданы конечные точки для доступа к вашей файловой системе. По умолчанию в API Amazon FSx Amazon FSx выбирает неиспользуемый диапазон IP-адресов для вас из диапазона 198.19.*. По умолчанию в консоли Amazon FSx Amazon FSx выбирает последние 64 IP-адреса из основного диапазона CIDR VPC, чтобы использовать в качестве диапазона IP-адресов конечной точки для файловой системы. У вас могут быть перекрывающиеся IP-адреса конечных точек для файловых систем, развернутых в одной и той же таблице маршрутизации/VPC.

Endpoints -> (structure)

Конечные точки Management и Intercluster, которые используются для доступа к данным или управления файловой системой с помощью NetApp ONTAP CLI, REST API или NetApp SnapMirror.

Intercluster -> (structure)

Конечная точка для управления вашей файловой системой путем настройки NetApp SnapMirror с другими системами ONTAP.

DNSName -> (string)

DNS-имя файловой системы. Вы можете подключить свою файловую систему, используя ее DNS-имя.

IpAddresses -> (list)

IP-адреса конечной точки файловой системы.

(string)

Management -> (structure)

Конечная точка для управления вашей файловой системой с помощью NetApp ONTAP CLI и NetApp ONTAP API.

DNSName -> (string)

DNS-имя файловой системы. Вы можете подключить свою файловую систему, используя ее DNS-имя.

IpAddresses -> (list)

IP-адреса конечной точки файловой системы.

(string)

DiskIopsConfiguration -> (structure)

Конфигурация SSD IOPS для файловой системы ONTAP, указывающая количество выделенных IOPS и режим выделения.

Mode -> (string)

Указывает, использует ли файловая система настройку AUTOMATIC SSD IOPS 3 IOPS на ГБ емкости хранилища или использует значение USER_PROVISIONED.

Iops -> (long)

Общее количество выделенных SSD IOPS для файловой системы.

Минимальные и максимальные значения этого свойства зависят от значения HAPairs и StorageCapacity. Минимальное значение вычисляется как StorageCapacity * 3 * HAPairs (3 IOPS на ГБ StorageCapacity). Максимальное значение вычисляется как 200 000 * HAPairs.

Amazon FSx отвечает с кодом состояния HTTP 400 (Bad Request), если значение Iops выходит за пределы минимальных или максимальных значений.

PreferredSubnetId -> (string)

Идентификатор подсети. Подсеть - это диапазон IP-адресов в вашей виртуальной частной облаке (VPC). Дополнительные сведения см. в разделе VPC и подсети в Руководстве пользователя Amazon VPC.

RouteTableIds -> (list)

(Только для Multi-AZ) Таблицы маршрутизации VPC, в которых создаются конечные точки вашей файловой системы.

(string)

ThroughputCapacity -> (integer)

Устойчивая пропускная способность файловой системы Amazon FSx в мегабайтах в секунду (МБ/с).

WeeklyMaintenanceStartTime -> (string)

Повторяющееся еженедельное время в формате D:HH:MM.

D - это день недели, где 1 соответствует понедельнику, а 7 - воскресенью. Более подробную информацию см. в спецификации ISO-8601, описанной в Википедии.

HH - это час дня с заполнением нулями (0-23), а MM - это минута часа с заполнением нулями.

Например, 1:05:00 указывает на обслуживание в 5 утра в понедельник.

FsxAdminPassword -> (string)

Вы можете использовать учетную запись пользователя fsxadmin для доступа к NetApp ONTAP CLI и REST API. Значение пароля всегда удаляется в ответе.

HAPairs -> (integer)

Указывает, сколько пар серверов высокой доступности (HA) будет иметь файловая система. Значение по умолчанию - 1. Значение этого свойства влияет на значения StorageCapacity, Iops и ThroughputCapacity. Дополнительные сведения см. в разделе Пары высокой доступности (HA) в руководстве пользователя FSx for ONTAP.

Amazon FSx отвечает с кодом состояния HTTP 400 (Bad Request) при следующих условиях:

  • Значение HAPairs меньше 1 или больше 12.
  • Значение HAPairs больше 1, а значение DeploymentType равно SINGLE_AZ_1, MULTI_AZ_1 или MULTI_AZ_2.

ThroughputCapacityPerHAPair -> (integer)

Используйте для выбора пропускной способности на пару 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 (Bad Request) при следующих условиях:

  • Значения ThroughputCapacity и ThroughputCapacityPerHAPair не совпадают.
  • Тип развертывания - SINGLE_AZ_2, а ThroughputCapacity / ThroughputCapacityPerHAPair не является допустимой парой HA (значение от 1 до 12).
  • Значение ThroughputCapacityPerHAPair недопустимо.

FileSystemTypeVersion -> (string)

Версия Lustre файловой системы Amazon FSx for Lustre, которая может быть 2.10, 2.12 или 2.15.

OpenZFSConfiguration -> (structure)

Конфигурация для этой файловой системы Amazon FSx for OpenZFS.

AutomaticBackupRetentionDays -> (integer)

Количество дней для хранения автоматических резервных копий. Установка этого свойства в 0 отключает автоматическое резервное копирование. Вы можете хранить автоматические резервные копии максимум 90 дней. По умолчанию 30 .

CopyTagsToBackups -> (boolean)

Логическое значение, указывающее, следует ли копировать теги в файловой системе в резервные копии. Если установлено значение true , все теги в файловой системе копируются во все автоматические резервные копии и любые резервные копии, инициированные пользователем, где пользователь не указывает никаких тегов. Если это значение равно true и вы указываете один или несколько тегов, только указанные теги копируются в резервные копии. Если вы укажете один или несколько тегов при создании резервной копии, инициированной пользователем, никакие теги не копируются из файловой системы, независимо от этого значения.

CopyTagsToVolumes -> (boolean)

Логическое значение, указывающее, следует ли копировать теги для тома в снимки. По умолчанию это значение равно false . Если установлено значение true , все теги для тома копируются в снимки, где пользователь не указывает теги. Если это значение равно true и вы указываете один или несколько тегов, только указанные теги копируются в снимки. Если вы укажете один или несколько тегов при создании снимка, никакие теги не копируются из тома, независимо от этого значения.

DailyAutomaticBackupStartTime -> (string)

Повторяющееся ежедневное время в формате HH:MM . HH - это час дня с заполнением нулями (0-23), а MM - минута часа с заполнением нулями. Например, 05:00 указывает 5 утра ежедневно.

DeploymentType -> (string)

Указывает тип развертывания файловой системы. Amazon FSx for OpenZFS поддерживает MULTI_AZ_1 , SINGLE_AZ_HA_2 , SINGLE_AZ_HA_1 , SINGLE_AZ_2 и SINGLE_AZ_1 .

ThroughputCapacity -> (integer)

Пропускная способность файловой системы Amazon FSx, измеряемая в мегабайтах в секунду (МБ/с).

WeeklyMaintenanceStartTime -> (string)

Повторяющееся еженедельное время в формате D:HH:MM .

D - это день недели, где 1 представляет понедельник, а 7 - воскресенье. Для получения дополнительной информации см. спецификацию ISO-8601, как описано в Wikipedia .

HH - это час дня с заполнением нулями (0-23), а MM - минута часа с заполнением нулями.

Например, 1:05:00 указывает обслуживание в 5 утра в понедельник.

DiskIopsConfiguration -> (structure)

Конфигурация SSD IOPS (операций ввода-вывода в секунду) для файловой системы Amazon FSx for NetApp ONTAP, Amazon FSx for Windows File Server или FSx for OpenZFS. По умолчанию Amazon FSx автоматически выделяет 3 IOPS на ГБ емкости хранилища. Вы можете выделить дополнительные IOPS на ГБ хранилища. Конфигурация состоит из общего количества выделенных SSD IOPS и способа их выделения, или режима (клиентом или Amazon FSx).

Mode -> (string)

Указывает, использует ли файловая система настройку AUTOMATIC SSD IOPS в 3 IOPS на ГБ емкости хранилища или использует значение USER_PROVISIONED .

Iops -> (long)

Общее количество SSD IOPS, выделенных для файловой системы.

Минимальные и максимальные значения для этого свойства зависят от значения HAPairs и StorageCapacity . Минимальное значение рассчитывается как StorageCapacity * 3 * HAPairs (3 IOPS на ГБ StorageCapacity ). Максимальное значение рассчитывается как 200 000 * HAPairs .

Amazon FSx отвечает с кодом состояния HTTP 400 (Bad Request), если значение Iops выходит за пределы минимальных или максимальных значений.

RootVolumeId -> (string)

Идентификатор корневого тома файловой системы OpenZFS.

PreferredSubnetId -> (string)

Требуется, когда DeploymentType установлено в MULTI_AZ_1 . Это указывает подсеть, в которой вы хотите, чтобы находился предпочтительный файловый сервер.

EndpointIpAddressRange -> (string)

(Только Multi-AZ) Указывает диапазон IP-адресов, в котором будут созданы конечные точки для доступа к вашей файловой системе. По умолчанию в API Amazon FSx и консоли Amazon FSx Amazon FSx выбирает доступный диапазон IP-адресов /28 для вас из одного из диапазонов CIDR VPC. У вас могут быть перекрывающиеся IP-адреса конечных точек для файловых систем, развернутых в одной и той же VPC/таблицах маршрутизации.

RouteTableIds -> (list)

(Только Multi-AZ) Таблицы маршрутизации VPC, в которых создаются конечные точки вашей файловой системы.

(string)

EndpointIpAddress -> (string)

IP-адрес конечной точки, используемой для доступа к данным или управления файловой системой.

ReadCacheConfiguration -> (structure)

Требуется, когда StorageType установлено в INTELLIGENT_TIERING . Указывает дополнительный выделенный кэш чтения SSD.

SizingMode -> (string)

Указывает, как определяется размер выделенного кэша чтения SSD, следующим образом:

  • Установите значение NO_CACHE , если вы не хотите использовать кэш чтения SSD с файловой системой Intelligent-Tiering.
  • Установите значение USER_PROVISIONED , чтобы указать точный размер вашего кэша чтения SSD.
  • Установите значение PROPORTIONAL_TO_THROUGHPUT_CAPACITY , чтобы размер вашего кэша чтения SSD автоматически определялся на основе вашей пропускной способности.

SizeGiB -> (integer)

Требуется, если SizingMode установлено в USER_PROVISIONED . Указывает размер кэша чтения SSD файловой системы в гибибайтах (GiB).

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API