Spec-Zone.ru › AWS CLI v2

[ aws . fsx ]

create-file-system

Описание

Создаёт новый пустой файловый сервер Amazon FSx. Используя API-оператор CreateFileSystem, вы можете создать следующие поддерживаемые файловые системы Amazon FSx:

  • Amazon FSx для Lustre
  • Amazon FSx для NetApp ONTAP
  • Amazon FSx для OpenZFS
  • Amazon FSx для Windows File Server

Для этого оператора требуется маркер запроса клиента в запросе, который Amazon FSx использует для обеспечения идемпотентного создания. Это означает, что многократный вызов оператора с тем же маркером запроса клиента не повлияет на результат. Благодаря идемпотентному оператору, вы можете повторить операцию CreateFileSystem без риска создания дополнительной файловой системы. Этот подход может быть полезен, когда первоначальный вызов завершился неудачно, что делает неясно, была ли файловая система создана. Примерами могут быть истечение таймаута уровня транспорта или сброс соединения. Если вы используете тот же маркер запроса клиента и первоначальный вызов создал файловую систему, клиент получит успех, если параметры будут такими же.

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

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

Примечание

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

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

Синтаксис

  create-file-system
[--client-request-token <value>]
--file-system-type <value>
[--storage-capacity <value>]
[--storage-type <value>]
--subnet-ids <value>
[--security-group-ids <value>]
[--tags <value>]
[--kms-key-id <value>]
[--windows-configuration <value>]
[--lustre-configuration <value>]
[--ontap-configuration <value>]
[--file-system-type-version <value>]
[--open-zfs-configuration <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

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

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

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

Тип файловой системы Amazon FSx для создания. Допустимые значения - WINDOWS , LUSTRE , ONTAP и OPENZFS .

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

  • WINDOWS
  • LUSTRE
  • ONTAP
  • OPENZFS

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

Устанавливает объём хранилища файловой системы, которую вы создаёте, в гибибайтах (GiB).

Файловые системы FSx для Lustre - Объём хранилища, который вы можете настроить, зависит от значения, установленного для StorageType и Lustre DeploymentType, как показано ниже:
  • Для SCRATCH_2 , PERSISTENT_2 и PERSISTENT_1 типов развертывания, использующих тип хранилища SSD, допустимые значения составляют 1200 GiB, 2400 GiB и приращения по 2400 GiB.
  • Для файловых систем Lustre с HDD, допустимые значения составляют приращения по 6000 GiB для файловых систем с 12 МБ/с/ТиБ и приращения по 1800 GiB для файловых систем с 40 МБ/с/ТиБ.
  • Для типа развертывания SCRATCH_1 допустимые значения составляют 1200 GiB, 2400 GiB и приращения по 3600 GiB.

Файловые системы FSx для ONTAP - Объём хранилища, который вы можете настроить, зависит от значения свойства HAPairs. Минимальное значение вычисляется как 1024 * HAPairs, а максимальное - как 524288 * HAPairs.

Файловые системы FSx для OpenZFS - Объём хранилища, который вы можете настроить, составляет от 64 GiB до 524288 GiB (512 TiB).

Файловые системы FSx для Windows File Server - Объём хранилища, который вы можете настроить, зависит от значения, установленного для StorageType, как показано ниже:

  • Для хранилища SSD допустимые значения составляют 32 GiB—65536 GiB (64 TiB).
  • Для хранилища HDD допустимые значения составляют 2000 GiB—65536 GiB (64 TiB).

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

Устанавливает класс хранилища для создаваемой файловой системы. Допустимые значения - SSD , HDD и INTELLIGENT_TIERING .

  • Установите значение SSD, чтобы использовать хранилище твердотельных накопителей. SSD поддерживается во всех типах развертывания Windows, Lustre, ONTAP и OpenZFS.
  • Установите значение HDD, чтобы использовать хранилище жёстких дисков. HDD поддерживается в типах развертывания SINGLE_AZ_2 и MULTI_AZ_1 файловых систем Windows, а также в типах развертывания PERSISTENT_1 файловых систем Lustre.
  • Установите значение INTELLIGENT_TIERING, чтобы использовать полностью эластичное, интеллектуально-распределённое хранилище. Интеллектуальное тирирование доступно только для файловых систем OpenZFS с типом развертывания Multi-AZ.

Значение по умолчанию - SSD. Дополнительную информацию см. в разделе «Параметры типа хранилища» в Руководстве пользователя FSx для Windows File Server, «Несколько вариантов хранения» в Руководстве пользователя FSx для Lustre и «Работа с интеллектуальным тирированием» в Руководстве пользователя Amazon FSx для OpenZFS.

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

  • SSD
  • HDD
  • INTELLIGENT_TIERING

--subnet-ids (список)

Указывает идентификаторы подсетей, из которых будет доступна файловая система. Для типов развертывания Windows и ONTAP MULTI_AZ_1 предоставьте ровно два идентификатора подсетей, один для предпочтительного файлового сервера и один для резервного файлового сервера. Вы указываете одну из этих подсетей как предпочтительную, используя свойства WindowsConfiguration > PreferredSubnetID или OntapConfiguration > PreferredSubnetID. Дополнительную информацию о конфигурации файловой системы Multi-AZ см. в разделе «Доступность и надёжность: файловые системы Single-AZ и Multi-AZ» в Руководстве пользователя Amazon FSx для Windows и «Доступность и надёжность» в Руководстве пользователя Amazon FSx для ONTAP.

Для Windows SINGLE_AZ_1 и SINGLE_AZ_2 и всех типов развертывания Lustre предоставьте ровно один идентификатор подсети. Файловый сервер запускается в зоне доступности этой подсети.

(строка)

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

Синтаксис:

"string" "string" ...

--security-group-ids (список)

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

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

Вы должны указать группу безопасности, если вы создаёте файловую систему FSx для ONTAP Multi-AZ в подсети VPC, которая была с вами разделена.

(строка)

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

Синтаксис:

"string" "string" ...

--tags (список)

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

(структура)

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

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

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

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

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

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

Key=string,Value=string ...

JSON-синтаксис:

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

--kms-key-id (строка)

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

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

Если KmsKeyId не указан, используется управляемый Amazon FSx ключ KMS для вашей учётной записи. Дополнительную информацию см. в разделе «Шифрование» в Справочнике по API службы управления ключами.

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

Настройка Microsoft Windows для создаваемой файловой системы.

ActiveDirectoryId -> (строка)

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

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

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

DomainName -> (строка)

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

OrganizationalUnitDistinguishedName -> (строка)

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

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

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

FileSystemAdministratorsGroup -> (строка)

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

UserName -> (строка)

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

Password -> (строка)

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

DnsIps -> (список)

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

(строка)

DeploymentType -> (строка)

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

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

Дополнительную информацию см. в разделе Доступность и надёжность: однозонные и многозонные файловые системы.

PreferredSubnetId -> (строка)

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

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

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

WeeklyMaintenanceStartTime -> (строка)

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

DailyAutomaticBackupStartTime -> (строка)

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

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

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

CopyTagsToBackups -> (булево значение)

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

Aliases -> (список)

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

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

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

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

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

(строка)

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

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

FileAccessAuditLogLevel -> (строка)

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

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

FileShareAccessAuditLogLevel -> (строка)

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

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

AuditLogDestination -> (строка)

Amazon Resource Name (ARN), указывающий место назначения аудиторских журналов.

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

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

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

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

Mode -> (строка)

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

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

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

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

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

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

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

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

Примечание

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

  • AutoImportPolicy
  • ExportPath
  • ImportedFileChunkSize
  • ImportPath

WeeklyMaintenanceStartTime -> (string)

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

ImportPath -> (string)

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

Примечание

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

ExportPath -> (string)

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

Ведро Amazon S3 для экспорта должно быть таким же, как ведро импорта, указанное в ImportPath. Если вы укажете только имя ведра, например: s3://import-bucket, вы получите взаимно однозначное соответствие между объектами файловой системы и объектами ведра 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 для Lustre.

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

Примечание

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

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

(Значение по умолчанию = SCRATCH_1 )

AutoImportPolicy -> (string)

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

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

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

Примечание

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

PerUnitStorageThroughput -> (integer)

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

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

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

DailyAutomaticBackupStartTime -> (string)

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

AutomaticBackupRetentionDays -> (integer)

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

CopyTagsToBackups -> (boolean)

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

(Значение по умолчанию = false)

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

DriveCacheType -> (string)

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

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

DataCompressionType -> (string)

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

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

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

EfaEnabled -> (boolean)

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

(Значение по умолчанию = false)

LogConfiguration -> (structure)

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

Уровень -> (строка)

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

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

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

Идентификатор ресурса 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 для Lustre) или /aws/fsx/filecache (для Amazon File Cache).
  • Если Destination предоставлен, и ресурс не существует, запрос завершится с ошибкой BadRequest.
  • Если Level установлено в значение DISABLED, вы не можете указать место назначения в Destination.

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

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

RootSquash -> (строка)

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

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

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

NoSquashNids -> (список)

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

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

(строка)

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

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

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

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

Примечание

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

Режим -> (строка)

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

  • В режиме AUTOMATIC FSx для 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"
  }
}

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

Свойства конфигурации ONTAP файловой системы FSx for ONTAP, которую вы создаёте.

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

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

DailyAutomaticBackupStartTime -> (строка)

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

DeploymentType -> (строка)

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

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

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

EndpointIpAddressRange -> (строка)

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

FsxAdminPassword -> (строка)

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

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

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

Mode -> (строка)

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

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

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

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

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

PreferredSubnetId -> (строка)

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

RouteTableIds -> (список)

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

Примечание

Amazon FSx управляет этими таблицами маршрутизации для многозонных файловых систем с помощью аутентификации на основе тегов. Эти таблицы маршрутизации помечены тегом Key: AmazonFSx; Value: ManagedByAmazonFSx . При создании файловых систем FSx for ONTAP Multi-AZ с помощью CloudFormation рекомендуется вручную добавить тег Key: AmazonFSx; Value: ManagedByAmazonFSx.

(строка)

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

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

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

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

WeeklyMaintenanceStartTime -> (строка)

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

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

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

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

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

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

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

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

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

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

Вы можете определить либо ThroughputCapacityPerHAPair , либо ThroughputCapacity при создании файловой системы, но не оба значения.

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

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

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

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

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

AutomaticBackupRetentionDays=integer,DailyAutomaticBackupStartTime=string,DeploymentType=string,EndpointIpAddressRange=string,FsxAdminPassword=string,DiskIopsConfiguration={Mode=string,Iops=long},PreferredSubnetId=string,RouteTableIds=string,string,ThroughputCapacity=integer,WeeklyMaintenanceStartTime=string,HAPairs=integer,ThroughputCapacityPerHAPair=integer

Синтаксис JSON:

{
  "AutomaticBackupRetentionDays": integer,
  "DailyAutomaticBackupStartTime": "string",
  "DeploymentType": "MULTI_AZ_1"|"SINGLE_AZ_1"|"SINGLE_AZ_2"|"MULTI_AZ_2",
  "EndpointIpAddressRange": "string",
  "FsxAdminPassword": "string",
  "DiskIopsConfiguration": {
    "Mode": "AUTOMATIC"|"USER_PROVISIONED",
    "Iops": long
  },
  "PreferredSubnetId": "string",
  "RouteTableIds": ["string", ...],
  "ThroughputCapacity": integer,
  "WeeklyMaintenanceStartTime": "string",
  "HAPairs": integer,
  "ThroughputCapacityPerHAPair": integer
}

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

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

  • 2.10 поддерживается типами развертывания Scratch и Persistent_1 Lustre.
  • 2.12 поддерживается всеми типами развертывания Lustre, за исключением PERSISTENT_2 с режимом конфигурации метаданных.
  • 2.15 поддерживается всеми типами развертывания Lustre и рекомендуется для всех новых файловых систем.

Значение по умолчанию — 2.10 , за исключением следующих развертываний:

  • Значение по умолчанию — 2.12, когда DeploymentType установлено в PERSISTENT_2 без режима конфигурации метаданных.
  • Значение по умолчанию — 2.15, когда DeploymentType установлено в PERSISTENT_2 с режимом конфигурации метаданных.

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

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

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

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

CopyTagsToBackups -> (булево)

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

CopyTagsToVolumes -> (булево)

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

DailyAutomaticBackupStartTime -> (строка)

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

DeploymentType -> (строка)

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

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

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

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

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

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

Вы оплачиваете дополнительную пропускную способность, которую вы предоставляете.

WeeklyMaintenanceStartTime -> (строка)

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

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

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

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

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

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

Mode -> (строка)

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

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

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

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

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

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

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

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

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

DataCompressionType -> (строка)

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

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

NfsExports -> (список)

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

(структура)

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

ClientConfigurations -> (список)

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

(структура)

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

Clients -> (строка)

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

Options -> (список)

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

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

(строка)

UserAndGroupQuotas -> (список)

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

(структура)

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

Type -> (строка)

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

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

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

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

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

CopyTagsToSnapshots -> (булево)

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

ReadOnly -> (булево)

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

PreferredSubnetId -> (строка)

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

EndpointIpAddressRange -> (строка)

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

RouteTableIds -> (список)

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

(строка)

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

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

SizingMode -> (строка)

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

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

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

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

Синтаксис 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
  }
}

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

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

Общие параметры

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

Включить отладочный вывод.

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

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

--no-verify-ssl (логическое значение)

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

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

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

--output (строка)

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

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

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

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

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

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

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

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

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

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

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

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

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

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

  • base64
  • raw-in-base64-out

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

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

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

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

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

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

Вывод

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

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

OwnerId -> (строка)

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

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

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

FileSystemId -> (строка)

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

FileSystemType -> (строка)

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

Lifecycle -> (строка)

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

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

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

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

Message -> (строка)

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

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

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

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

StorageType -> (строка)

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

VpcId -> (строка)

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

SubnetIds -> (список)

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

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

(строка)

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

NetworkInterfaceIds -> (список)

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

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

(строка)

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

DNSName -> (строка)

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

KmsKeyId -> (строка)

Идентификатор ключа службы управления ключами (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 -> (строка)

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

Tags -> (список)

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

(структура)

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

Key -> (строка)

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

Value -> (строка)

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

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

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

ActiveDirectoryId -> (строка)

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

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

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

DomainName -> (строка)

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

OrganizationalUnitDistinguishedName -> (строка)

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

FileSystemAdministratorsGroup -> (строка)

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

UserName -> (строка)

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

DnsIps -> (список)

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

(строка)

DeploymentType -> (строка)

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

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

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

RemoteAdministrationEndpoint -> (строка)

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

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

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

PreferredSubnetId -> (строка)

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

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

PreferredFileServerIp -> (строка)

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

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

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

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

MaintenanceOperationsInProgress -> (список)

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

(строка)

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

WeeklyMaintenanceStartTime -> (строка)

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

DailyAutomaticBackupStartTime -> (строка)

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

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

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

CopyTagsToBackups -> (булево)

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

Aliases -> (список)

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

(структура)

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

Name -> (строка)

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

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

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

Lifecycle -> (строка)

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

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

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

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

FileAccessAuditLogLevel -> (строка)

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

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

FileShareAccessAuditLogLevel -> (строка)

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

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

AuditLogDestination -> (строка)

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

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

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

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

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

Mode -> (строка)

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

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

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

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

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

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

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

WeeklyMaintenanceStartTime -> (строка)

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

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

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

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

Lifecycle -> (строка)

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

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

ImportPath -> (строка)

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

ExportPath -> (строка)

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

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

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

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

AutoImportPolicy -> (строка)

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

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

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

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

Message -> (строка)

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

DeploymentType -> (строка)

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

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

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

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

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

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

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

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

MountName -> (строка)

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

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

DailyAutomaticBackupStartTime -> (строка)

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

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

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

CopyTagsToBackups -> (булево)

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

DriveCacheType -> (строка)

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

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

DataCompressionType -> (строка)

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

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

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

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

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

Level -> (строка)

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

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

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

Destination -> (строка)

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

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

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

RootSquash -> (строка)

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

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

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

NoSquashNids -> (список)

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

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

(строка)

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

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

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

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

Mode -> (строка)

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

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

EfaEnabled -> (булево)

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

AdministrativeActions -> (список)

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

(структура)

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

AdministrativeActionType -> (строка)

Описание типа административного действия:

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

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

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

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

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

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

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

Status -> (строка)

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

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

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

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

OwnerId -> (строка)

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

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

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

FileSystemId -> (строка)

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

FileSystemType -> (строка)

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

Lifecycle -> (строка)

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

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

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

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

Message -> (строка)

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

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

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

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

StorageType -> (строка)

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

VpcId -> (строка)

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

SubnetIds -> (список)

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

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

(строка)

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

NetworkInterfaceIds -> (список)

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

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

(строка)

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

DNSName -> (строка)

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

KmsKeyId -> (строка)

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

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

ResourceARN -> (строка)

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

Tags -> (список)

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

(структура)

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

Key -> (строка)

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

Value -> (строка)

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

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

```

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

ActiveDirectoryId -> (строка)

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

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

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

DomainName -> (строка)

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

OrganizationalUnitDistinguishedName -> (строка)

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

FileSystemAdministratorsGroup -> (строка)

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

UserName -> (строка)

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

DnsIps -> (список)

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

(строка)

DeploymentType -> (строка)

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

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

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

RemoteAdministrationEndpoint -> (строка)

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

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

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

PreferredSubnetId -> (строка)

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

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

PreferredFileServerIp -> (строка)

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

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

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

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

MaintenanceOperationsInProgress -> (список)

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

(строка)

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

WeeklyMaintenanceStartTime -> (строка)

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

DailyAutomaticBackupStartTime -> (строка)

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

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

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

CopyTagsToBackups -> (булево значение)

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

Aliases -> (список)

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

(структура)

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

Name -> (строка)

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

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

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

Lifecycle -> (строка)

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

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

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

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

FileAccessAuditLogLevel -> (строка)

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

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

FileShareAccessAuditLogLevel -> (строка)

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

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

AuditLogDestination -> (строка)

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

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

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

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

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

Mode -> (строка)

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

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

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

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

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

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

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

WeeklyMaintenanceStartTime -> (строка)

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

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

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

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

Lifecycle -> (строка)

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

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

ImportPath -> (строка)

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

ExportPath -> (строка)

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

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

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

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

AutoImportPolicy -> (строка)

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

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

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

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

Message -> (строка)

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

DeploymentType -> (строка)

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

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

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

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

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

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

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

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

MountName -> (строка)

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

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

DailyAutomaticBackupStartTime -> (строка)

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

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

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

CopyTagsToBackups -> (булево)

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

DriveCacheType -> (строка)

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

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

DataCompressionType -> (строка)

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

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

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

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

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

Level -> (строка)

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

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

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

Destination -> (строка)

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

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

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

RootSquash -> (строка)

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

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

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

NoSquashNids -> (список)

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

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

(строка)

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

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

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

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

Mode -> (строка)

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

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

EfaEnabled -> (булево)

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

AdministrativeActions -> (список)

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

(структура)

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

AdministrativeActionType -> (строка)

Описание типа административного действия:

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

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

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

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

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

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

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

Status -> (строка)

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

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

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

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

Message -> (строка)

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

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

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

CreationTime -> (timestamp)

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

FileSystemId -> (string)

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

Lifecycle -> (string)

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

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

Name -> (string)

Имя тома.

OntapConfiguration -> (structure)

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

FlexCacheEndpointType -> (string)

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

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

JunctionPath -> (string)

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

SecurityStyle -> (string)

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

SizeInMegabytes -> (integer)

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

StorageEfficiencyEnabled -> (boolean)

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

StorageVirtualMachineId -> (string)

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

StorageVirtualMachineRoot -> (boolean)

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

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

TieringPolicy -> (structure)

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

CoolingPeriod -> (integer)

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

Name -> (string)

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

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

UUID -> (string)

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

OntapVolumeType -> (string)

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

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

SnapshotPolicy -> (string)

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

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

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

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

CopyTagsToBackups -> (boolean)

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

SnaplockConfiguration -> (structure)

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

AuditLogVolume -> (boolean)

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

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

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

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

Type -> (строка)

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

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

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

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

PrivilegedDelete -> (строка)

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

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

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

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

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

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

Type -> (строка)

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

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

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

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

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

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

Type -> (строка)

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

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

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

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

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

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

Type -> (строка)

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

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

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

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

SnaplockType -> (строка)

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

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

VolumeAppendModeEnabled -> (boolean)

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

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

VolumeStyle -> (строка)

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

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

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

Aggregates -> (список)

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

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

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

(строка)

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

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

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

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

ResourceARN -> (строка)

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

Tags -> (список)

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

(структура)

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

Key -> (строка)

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

Value -> (строка)

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

VolumeId -> (строка)

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

VolumeType -> (строка)

Тип тома.

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

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

Message -> (строка)

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

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

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

ParentVolumeId -> (строка)

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

VolumePath -> (строка)

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

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

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

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

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

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

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

DataCompressionType -> (строка)

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

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

CopyTagsToSnapshots -> (булево)

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

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

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

SnapshotARN -> (строка)

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

CopyStrategy -> (строка)

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

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

Примечание

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

ReadOnly -> (булево)

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

NfsExports -> (список)

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

(структура)

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

ClientConfigurations -> (список)

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

(структура)

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

Clients -> (строка)

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

Options -> (список)

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

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

(строка)

UserAndGroupQuotas -> (список)

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

(структура)

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

Type -> (строка)

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

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

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

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

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

RestoreToSnapshot -> (строка)

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

DeleteIntermediateSnaphots -> (булево)

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

DeleteClonedVolumes -> (булево)

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

DeleteIntermediateData -> (булево)

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

SourceSnapshotARN -> (строка)

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

DestinationSnapshot -> (строка)

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

CopyStrategy -> (строка)

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

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

Примечание

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

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

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

ResourceARN -> (строка)

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

SnapshotId -> (строка)

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

Name -> (строка)

Имя снимка.

VolumeId -> (строка)

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

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

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

Lifecycle -> (строка)

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

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

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

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

Message -> (строка)

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

Tags -> (список)

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

(структура)

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

Key -> (строка)

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

Value -> (строка)

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

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

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

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

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

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

Настройка этого файлового сервера Amazon FSx for NetApp ONTAP.

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

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

DailyAutomaticBackupStartTime -> (строка)

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

DeploymentType -> (строка)

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

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

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

EndpointIpAddressRange -> (строка)

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

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

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

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

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

DNSName -> (строка)

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

IpAddresses -> (список)

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

(строка)

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

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

DNSName -> (строка)

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

IpAddresses -> (список)

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

(строка)

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

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

Mode -> (строка)

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

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

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

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

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

PreferredSubnetId -> (строка)

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

RouteTableIds -> (список)

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

(строка)

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

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

WeeklyMaintenanceStartTime -> (строка)

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

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

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

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

FsxAdminPassword -> (строка)

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

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

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

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

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

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

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

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

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

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

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

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

FileSystemTypeVersion -> (строка)

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

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

Настройка этого файлового сервера Amazon FSx for OpenZFS.

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

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

CopyTagsToBackups -> (булево)

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

CopyTagsToVolumes -> (булево)

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

DailyAutomaticBackupStartTime -> (строка)

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

DeploymentType -> (строка)

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

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

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

WeeklyMaintenanceStartTime -> (строка)

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

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

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

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

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

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

Mode -> (строка)

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

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

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

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

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

RootVolumeId -> (строка)

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

PreferredSubnetId -> (строка)

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

EndpointIpAddressRange -> (строка)

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

RouteTableIds -> (список)

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

(строка)

EndpointIpAddress -> (строка)

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

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

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

SizingMode -> (строка)

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

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

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

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

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

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

Message -> (строка)

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

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

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

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

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

FileSystemId -> (строка)

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

Lifecycle -> (строка)

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

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

Name -> (строка)

Имя тома.

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

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

FlexCacheEndpointType -> (строка)

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

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

JunctionPath -> (строка)

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

SecurityStyle -> (строка)

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

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

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

StorageEfficiencyEnabled -> (булево значение)

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

StorageVirtualMachineId -> (строка)

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

StorageVirtualMachineRoot -> (булево значение)

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

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

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

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

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

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

Name -> (строка)

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

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

UUID -> (строка)

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

OntapVolumeType -> (строка)

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

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

SnapshotPolicy -> (строка)

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

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

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

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

CopyTagsToBackups -> (булево значение)

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

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

Объект конфигурации SnapLock для тома SnapLock FSx for ONTAP.

AuditLogVolume -> (boolean)

Включает или отключает журнал аудита для тома SnapLock FSx for ONTAP. Значение по умолчанию — false. Если вы установите AuditLogVolume в true, том SnapLock будет создан как том журнала аудита. Минимальный срок хранения для тома журнала аудита составляет шесть месяцев.

Для получения дополнительной информации см. журналы аудита SnapLock.

AutocommitPeriod -> (структура)

Объект конфигурации для установки периода автоматической фиксации файлов в томе SnapLock FSx for ONTAP.

Type -> (строка)

Определяет тип времени для периода автоматической фиксации файла в томе SnapLock FSx for ONTAP. Установка этого значения в NONE отключает автоматическую фиксацию. Значение по умолчанию — NONE.

Value -> (целое число)

Определяет продолжительность периода автоматической фиксации файла в томе SnapLock FSx for ONTAP. Следующие диапазоны допустимы:

  • Minutes : 5 - 65 535
  • Hours : 1 - 65 535
  • Days : 1 - 3650
  • Months : 1 - 120
  • Years : 1 - 10

PrivilegedDelete -> (строка)

Включает, отключает или постоянно отключает привилегированное удаление в томе SnapLock Enterprise FSx for ONTAP. Включение привилегированного удаления позволяет администраторам SnapLock удалять файлы WORM (write once, read many), даже если у них активны периоды хранения. PERMANENTLY_DISABLED — это конечное состояние. Если привилегированное удаление постоянно отключено для тома SnapLock, его нельзя включить повторно. Значение по умолчанию — DISABLED.

Для получения дополнительной информации см. привилегированное удаление.

RetentionPeriod -> (структура)

Устанавливает период хранения для тома SnapLock FSx for ONTAP.

DefaultRetention -> (структура)

Срок хранения, назначаемый файлу WORM по умолчанию, если для тома SnapLock FSx for ONTAP не установлен явный срок хранения. Период хранения по умолчанию должен быть больше или равен минимальному периоду хранения и меньше или равен максимальному периоду хранения.

Type -> (строка)

Определяет тип времени для периода хранения тома SnapLock FSx for ONTAP. Установите одно из допустимых значений. Если вы установите INFINITE, файлы хранятся вечно. Если вы установите UNSPECIFIED, файлы хранятся до тех пор, пока вы не установите явный срок хранения.

Value -> (целое число)

Определяет продолжительность периода хранения тома SnapLock FSx for ONTAP. Для INFINITE или UNSPECIFIED значение установить нельзя. Для всех остальных вариантов допустимы следующие диапазоны:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

MinimumRetention -> (структура)

Наименьший период хранения, который можно назначить файлу WORM в томе SnapLock FSx for ONTAP.

Type -> (строка)

Определяет тип времени для периода хранения тома SnapLock FSx for ONTAP. Установите одно из допустимых значений. Если вы установите INFINITE, файлы хранятся вечно. Если вы установите UNSPECIFIED, файлы хранятся до тех пор, пока вы не установите явный срок хранения.

Value -> (целое число)

Определяет продолжительность периода хранения тома SnapLock FSx for ONTAP. Для INFINITE или UNSPECIFIED значение установить нельзя. Для всех остальных вариантов допустимы следующие диапазоны:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

MaximumRetention -> (структура)

Наибольший период хранения, который можно назначить файлу WORM в томе SnapLock FSx for ONTAP.

Type -> (строка)

Определяет тип времени для периода хранения тома SnapLock FSx for ONTAP. Установите одно из допустимых значений. Если вы установите INFINITE, файлы хранятся вечно. Если вы установите UNSPECIFIED, файлы хранятся до тех пор, пока вы не установите явный срок хранения.

Value -> (целое число)

Определяет продолжительность периода хранения тома SnapLock FSx for ONTAP. Для INFINITE или UNSPECIFIED значение установить нельзя. Для всех остальных вариантов допустимы следующие диапазоны:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

SnaplockType -> (строка)

Указывает режим хранения тома SnapLock FSx for ONTAP. После установки его изменить нельзя. Вы можете выбрать один из следующих режимов хранения:

  • COMPLIANCE : Файлы, переведенные в режим WORM (write once, read many) на томе Compliance, не могут быть удалены до истечения срока хранения. Этот режим хранения используется для удовлетворения требований, связанных с правительственными или отраслевыми нормами, или для защиты от атак с использованием вредоносного ПО. Для получения дополнительной информации см. SnapLock Compliance.
  • ENTERPRISE : Файлы, переведенные в режим WORM на томе Enterprise, могут быть удалены авторизованными пользователями до истечения срока хранения с помощью привилегированного удаления. Этот режим хранения используется для повышения целостности данных организации и соответствия внутренним требованиям или для тестирования параметров хранения перед использованием SnapLock Compliance. Для получения дополнительной информации см. SnapLock Enterprise.

VolumeAppendModeEnabled -> (boolean)

Включает или отключает режим добавления к томам в томе SnapLock FSx for ONTAP. Режим добавления к томам позволяет создавать файлы, к которым можно добавлять данные инкрементально. Значение по умолчанию — false.

Для получения дополнительной информации см. режим добавления к томам.

VolumeStyle -> (строка)

Используйте для указания стиля тома ONTAP. Дополнительную информацию о FlexVols и FlexGroups см. в руководстве пользователя Amazon FSx for NetApp ONTAP в разделе Типы томов.

AggregateConfiguration -> (структура)

Эта структура определяет параметры конфигурации агрегата или агрегатов хранения тома.

Aggregates -> (список)

Список агрегатов, на которых находится данный том. Агрегаты — это хранилища, составляющие основной уровень хранения. Каждая пара высокой доступности (HA) имеет один агрегат. Названия агрегатов соответствуют именам агрегатов в ONTAP CLI и REST API. Для FlexVols всегда будет одна запись.

Amazon FSx возвращает код состояния HTTP 400 (Ошибка запроса) в следующих условиях:

  • Строки в значении Aggregates не отформатированы как aggrX, где X — число от 1 до 12.
  • Значение Aggregates содержит агрегаты, которых нет.
  • Один или несколько предоставленных агрегатов слишком близки к пределу тома, чтобы можно было добавить больше томов.

(строка)

TotalConstituents -> (целое число)

Общее количество компонентов, имеющихся у тома FlexGroup. Не применимо для FlexVols.

SizeInBytes -> (длинное целое число)

Настроенный размер тома в байтах.

ResourceARN -> (строка)

Amazon Resource Name (ARN) для данного ресурса. ARNs однозначно идентифицируют ресурсы Amazon Web Services. ARN необходимы, когда вам нужно однозначно указать ресурс во всей системе Amazon Web Services. Для получения дополнительной информации см. Amazon Resource Names (ARNs) в Общие сведения о службах Amazon Web Services.

Tags -> (список)

Список значений Tag, с максимальным количеством элементов 50.

(структура)

Указывает пару ключ-значение для тега ресурса.

Key -> (строка)

Значение, определяющее TagKey, имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (строка)

Значение, определяющее TagValue, значение, присвоенное соответствующему ключу тега. Значения тегов могут быть пустыми и не обязательно должны быть уникальными в наборе тегов. Например, вы можете иметь пару ключ-значение в наборе тегов finances : April и также payroll : April.

VolumeId -> (строка)

Сгенерированный системой уникальный идентификатор тома.

VolumeType -> (строка)

Тип тома.

LifecycleTransitionReason -> (структура)

Причина изменения статуса жизненного цикла тома.

Message -> (строка)

Подробное сообщение об ошибке.

AdministrativeActions -> (список)

Список административных действий для тома, которые находятся в процессе обработки или ожидают обработки. Административные действия описывают изменения в томе, инициированные вами с помощью действия UpdateVolume.

(структура)

Описывает конкретное административное действие Amazon FSx для текущей файловой системы или тома Windows, Lustre, OpenZFS или ONTAP.

AdministrativeActionType -> (строка)

Описывает тип административного действия следующим образом:

  • FILE_SYSTEM_UPDATE - Административное действие обновления файловой системы, инициированное из консоли Amazon FSx, API (UpdateFileSystem ) или командной строки (update-file-system ).
  • THROUGHPUT_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача THROUGHPUT_OPTIMIZATION. Вы можете отслеживать процесс оптимизации хранилища, используя свойство ProgressPercent. После успешного завершения THROUGHPUT_OPTIMIZATION, статус родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED. Дополнительную информацию см. в руководстве пользователя Amazon FSx for Windows File Server в разделе Управление пропускной способностью.
  • STORAGE_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению емкости хранилища файловой системы запускается задача STORAGE_OPTIMIZATION.
    • Для Windows и ONTAP оптимизация хранилища — это процесс миграции данных файловой системы на новые, более емкие диски.
    • Для Lustre оптимизация хранилища состоит из перебалансировки данных по существующим и вновь добавленным файловым серверам.

Вы можете отслеживать процесс оптимизации хранилища, используя свойство ProgressPercent. После успешного завершения STORAGE_OPTIMIZATION, статус родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED. Дополнительную информацию см. в руководстве пользователя Amazon FSx for Windows File Server в разделе Управление емкостью хранилища, руководстве пользователя Amazon FSx for Lustre в разделе Управление емкостью хранилища и предоставленной пропускной способностью IOPS в руководстве пользователя Amazon FSx for NetApp ONTAP.

  • FILE_SYSTEM_ALIAS_ASSOCIATION - Обновление файловой системы для добавления нового псевдонима домена имен (DNS) к файловой системе. Дополнительную информацию см. в разделе AssociateFileSystemAliases.
  • FILE_SYSTEM_ALIAS_DISASSOCIATION - Обновление файловой системы для отключения псевдонима DNS от файловой системы. Дополнительную информацию см. в разделе DisassociateFileSystemAliases.
  • IOPS_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача IOPS_OPTIMIZATION. Вы можете отслеживать процесс оптимизации хранилища, используя свойство ProgressPercent. После успешного завершения IOPS_OPTIMIZATION, статус родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED. Дополнительную информацию см. в руководстве пользователя Amazon FSx for Windows File Server в разделе Управление предоставленной пропускной способностью IOPS SSD.
  • STORAGE_TYPE_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача STORAGE_TYPE_OPTIMIZATION. Вы можете отслеживать процесс оптимизации хранилища, используя свойство ProgressPercent. После успешного завершения STORAGE_TYPE_OPTIMIZATION, статус родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED.
  • VOLUME_UPDATE - Обновление тома Amazon FSx для OpenZFS, инициированное из консоли Amazon FSx, API (UpdateVolume ) или командной строки (update-volume ).
  • VOLUME_RESTORE - Возвращение тома Amazon FSx для OpenZFS в состояние, сохраненное указанным снимком, инициированное через API (RestoreVolumeFromSnapshot ) или командную строку (restore-volume-from-snapshot ).
  • SNAPSHOT_UPDATE - Обновление снимка тома Amazon FSx для OpenZFS, инициированное из консоли Amazon FSx, API (UpdateVolume ) или командной строки (update-volume ).
  • RELEASE_NFS_V3_LOCKS - Отслеживание освобождения блокировок Network File System (NFS) V3 на файловой системе Amazon FSx для OpenZFS.
  • DOWNLOAD_DATA_FROM_BACKUP - Восстановление резервной копии FSx для ONTAP на новый том на файловой системе второго поколения. После загрузки всех метаданных файла на том, вы можете смонтировать том с чтением без записи.
  • VOLUME_INITIALIZE_WITH_SNAPSHOT - Создание тома со снимка на другой файловой системе FSx для OpenZFS. Вы можете инициировать это из консоли Amazon FSx, API (CreateVolume ) или командной строки (create-volume ) при использовании стратегии FULL_COPY.
  • VOLUME_UPDATE_WITH_SNAPSHOT - Обновление тома со снимка на другой файловой системе FSx для OpenZFS. Вы можете инициировать это из консоли Amazon FSx, API (CopySnapshotAndUpdateVolume ) или командной строки (copy-snapshot-and-update-volume ).

ProgressPercent -> (целое число)

Процент завершения административного действия STORAGE_OPTIMIZATION или DOWNLOAD_DATA_FROM_BACKUP. Не относится к другим типам административных действий.

RequestTime -> (отметка времени)

Время получения запроса на административное действие.

Status -> (строка)

Статус административного действия:

  • FAILED - Amazon FSx не смог успешно обработать административное действие.
  • IN_PROGRESS - Amazon FSx обрабатывает административное действие.
  • PENDING - Amazon FSx ожидает обработки административного действия.
  • COMPLETED - Amazon FSx завершил обработку административной задачи. Для восстановления резервной копии резервного копирования на файловой системе FSx для ONTAP второго поколения указывает, что все данные были загружены на том, и клиенты теперь имеют доступ к тома с записью и чтением.
  • UPDATED_OPTIMIZING - При обновлении емкости хранилища Amazon FSx обновил файловую систему с новой емкостью хранилища и теперь выполняет процесс оптимизации хранилища.
  • PENDING - При восстановлении резервной копии резервного копирования на файловой системе FSx для ONTAP второго поколения указывает, что метаданные файла загружаются на том. Состояние жизненного цикла тома — CREATING.
  • IN_PROGRESS - При восстановлении резервной копии резервного копирования на файловой системе FSx для ONTAP второго поколения указывает, что все метаданные загружены на новый том, и клиенты могут получить доступ к данным только для чтения, пока Amazon FSx загружает данные файла на том. Отслеживайте прогресс этого процесса с элементом ProgressPercent.

TargetFileSystemValues -> (структура)

``` END_OF_DOCUMENT_MARKER

Целевое значение для администрационного действия, предоставленное в операции UpdateFileSystem. Возвращается для административных действий FILE_SYSTEM_UPDATE.

OwnerId -> (строка)

Учетная запись Amazon Web Services, которая создала файловую систему. Если файловая система была создана пользователем в IAM Identity Center, учетной записью Amazon Web Services, к которой принадлежит пользователь IAM, является владелец.

CreationTime -> (метка времени)

Время создания файловой системы в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

FileSystemId -> (строка)

Сгенерированный системой уникальный 17-значный идентификатор файловой системы.

FileSystemType -> (строка)

Тип файловой системы Amazon FSx, который может быть LUSTRE, WINDOWS, ONTAP или OPENZFS.

Lifecycle -> (строка)

Статус жизненного цикла файловой системы. Ниже приведены возможные значения и их смысл:

  • AVAILABLE - Файловая система находится в работоспособном состоянии и доступна для использования.
  • CREATING - Amazon FSx создает новую файловую систему.
  • DELETING - Amazon FSx удаляет существующую файловую систему.
  • FAILED - Существующая файловая система столкнулась с невосстанавливаемой ошибкой. При создании новой файловой системы Amazon FSx не смог создать файловую систему.
  • MISCONFIGURED - Файловая система находится в состоянии сбоя, но может быть восстановлена.
  • MISCONFIGURED_UNAVAILABLE - (Только Amazon FSx для Windows File Server) Файловая система в настоящее время недоступна из-за изменения конфигурации Active Directory.
  • UPDATING - Файловая система проходит обновление, инициированное пользователем.

FailureDetails -> (структура)

Структура, предоставляющая подробности о любых произошедших ошибках.

Message -> (строка)

Сообщение, описывающее любые произошедшие ошибки.

StorageCapacity -> (целое число)

Емкость хранилища файловой системы в гигабайтах (GiB).

Amazon FSx возвращает HTTP-код состояния 400 (Неверный запрос), если значение StorageCapacity находится за пределами минимальных или максимальных значений.

StorageType -> (строка)

Тип хранилища, используемого файловой системой. Если установлено значение SSD, файловая система использует хранилище твердотельных дисков. Если установлено значение HDD, файловая система использует хранилище жестких дисков.

VpcId -> (строка)

Идентификатор основной виртуальной частной сети (VPC) для файловой системы.

SubnetIds -> (список)

Указывает идентификаторы подсетей, из которых доступна файловая система. Для развертывания Amazon FSx Windows и ONTAP MULTI_AZ_1, есть два идентификатора подсетей, один для предпочтительного файлового сервера и один для резервного файлового сервера. Подсеть предпочтительного файлового сервера указана в свойстве PreferredSubnetID. Все остальные файловые системы имеют только один идентификатор подсети.

Для файловых систем FSx для Lustre и однозонных файловых систем Windows это идентификатор подсети, содержащей конечную точку файловой системы. Для MULTI_AZ_1 Windows и ONTAP файловых систем конечная точка файловой системы доступна в PreferredSubnetID.

(строка)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашей виртуальной частной сети (VPC). Дополнительную информацию см. в руководстве пользователя Amazon VPC.

NetworkInterfaceIds -> (список)

Идентификаторы интерфейсов эластичной сети, из которых доступна определенная файловая система. Интерфейс эластичной сети автоматически создается в той же виртуальной частной сети (VPC), в которой была создана файловая система Amazon FSx. Дополнительную информацию см. в руководстве пользователя Amazon EC2.

Для файловой системы Amazon FSx для Windows File Server можно иметь один идентификатор сетевого интерфейса. Для файловой системы Amazon FSx для Lustre можно иметь более одного.

(строка)

Идентификатор интерфейса эластичной сети. Интерфейс эластичной сети — это логический сетевой компонент в виртуальной частной сети (VPC), представляющий собой виртуальную сетевую карту. Дополнительную информацию см. в руководстве пользователя Amazon EC2 для Linux-инстансов.

DNSName -> (строка)

Имя домена DNS для файловой системы.

KmsKeyId -> (строка)

Идентификатор ключа службы управления ключами (KMS), используемого для шифрования данных файловой системы Amazon FSx. Используется следующим образом с типами файловых систем Amazon FSx:

  • Amazon FSx для Lustre PERSISTENT_1 и PERSISTENT_2 типы развертывания только. SCRATCH_1 и SCRATCH_2 типы шифруются с помощью ключа KMS службы Amazon FSx для вашей учетной записи.
  • Amazon FSx для NetApp ONTAP
  • Amazon FSx для OpenZFS
  • Amazon FSx для Windows File Server

ResourceARN -> (строка)

Amazon Resource Name (ARN) ресурса файловой системы.

Tags -> (список)

Теги, которые нужно ассоциировать с файловой системой. Дополнительную информацию см. в руководстве пользователя Amazon FSx для Lustre.

(структура)

Указывает пару ключ-значение для тега ресурса.

Key -> (строка)

Значение, определяющее TagKey, имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (строка)

Значение, определяющее TagValue, значение, назначенное соответствующему ключу тега. Значения тегов могут быть null и не обязательно должны быть уникальными в наборе тегов. Например, вы можете иметь пару ключ-значение в наборе тегов finances : April и также payroll : April.

WindowsConfiguration -> (структура)

Настройка этого файловой системы Amazon FSx для Windows File Server.

ActiveDirectoryId -> (строка)

Идентификатор существующей управляемой Microsoft Active Directory службы Amazon Web Services, к которой присоединена файловая система.

SelfManagedActiveDirectoryConfiguration -> (структура)

Настройка автономного каталога Microsoft Active Directory (AD), к которому подключен виртуальный компьютер Windows File Server или ONTAP storage (SVM).

DomainName -> (строка)

Полное доменное имя автономного каталога AD.

OrganizationalUnitDistinguishedName -> (строка)

Полное различающее имя организационной единицы в автономном каталоге AD, к которому подключен виртуальный компьютер Windows File Server или ONTAP storage (SVM).

FileSystemAdministratorsGroup -> (строка)

Имя доменной группы, члены которой имеют административные привилегии для файловой системы FSx.

UserName -> (строка)

Имя пользователя учетной записи службы в вашем автономном домене AD, которую FSx использует для подключения к вашему домену AD.

DnsIps -> (список)

Список до трех IP-адресов DNS-серверов или контроллеров домена в автономном каталоге AD.

(строка)

DeploymentType -> (строка)

Указывает тип развертывания файловой системы, допустимые значения следующие:

  • MULTI_AZ_1 - Указывает файловую систему с высокой доступностью, настроенную для отказоустойчивости Multi-AZ, которая может переносить временную недоступность зоны доступности (AZ) и поддерживает хранилище SSD и HDD.
  • SINGLE_AZ_1 - (По умолчанию) Указывает файловую систему, настроенную для отказоустойчивости в одной AZ, поддерживает только хранилище SSD.
  • SINGLE_AZ_2 - Файловая система новейшего поколения Single AZ. Указывает файловую систему, настроенную для отказоустойчивости в одной AZ и поддерживающую хранилище SSD и HDD.

Для получения дополнительной информации см. Файловые системы Single-AZ и Multi-AZ.

RemoteAdministrationEndpoint -> (строка)

Для типов развертывания MULTI_AZ_1 используйте этот конечный пункт при выполнении административных задач для файловой системы с помощью Amazon FSx Remote PowerShell.

Для типов развертывания SINGLE_AZ_1 и SINGLE_AZ_2 это имя DNS файловой системы.

Этот конечный пункт временно недоступен при проведении технического обслуживания файловой системы.

PreferredSubnetId -> (строка)

Для типов развертывания MULTI_AZ_1, он указывает идентификатор подсети, где расположен предпочтительный файловый сервер. Должен быть одним из двух идентификаторов подсети, указанных в свойстве SubnetIds. Amazon FSx обслуживает трафик из этой подсети, за исключением случаев переключения на вторичный файловый сервер.

Для типов развертывания SINGLE_AZ_1 и SINGLE_AZ_2 это значение такое же, как и для SubnetIDs. Для получения дополнительной информации см. Доступность и долговечность: файловые системы Single-AZ и Multi-AZ.

PreferredFileServerIp -> (строка)

Для типов развертывания MULTI_AZ_1 — IP-адрес первичного или предпочтительного файлового сервера.

Используйте этот IP-адрес при подключении файловой системы к клиентам Linux SMB или Windows SMB, которые не подключены к Microsoft Active Directory. Применимо ко всем типам развертывания файловых систем Windows. Этот IP-адрес временно недоступен при проведении технического обслуживания файловой системы. Для клиентов Linux и Windows SMB, подключенных к Active Directory, используйте DNSName файловой системы. Для получения дополнительной информации о подключении и установке общих папок, см. Доступ к общим папкам.

ThroughputCapacity -> (целое число)

Производительность файловой системы Amazon FSx, измеряемая в мегабайтах в секунду.

MaintenanceOperationsInProgress -> (список)

Список операций технического обслуживания, выполняемых для этой файловой системы.

(строка)

Перечисление, указывающее текущую выполняющуюся операцию технического обслуживания.

WeeklyMaintenanceStartTime -> (строка)

Предпочтительное время начала еженедельного технического обслуживания, отформатированное d:HH:MM в часовом поясе UTC. d — это номер дня недели от 1 до 7, начиная с понедельника и заканчивая воскресеньем.

DailyAutomaticBackupStartTime -> (строка)

Предпочтительное время для создания ежедневных автоматических резервных копий в часовом поясе UTC.

AutomaticBackupRetentionDays -> (целое число)

Количество дней хранения автоматических резервных копий. Установка этого значения в 0 отключает автоматические резервные копии. Максимальный срок хранения автоматических резервных копий — 90 дней.

CopyTagsToBackups -> (логическое значение)

Флаг логического типа, указывающий, следует ли копировать метки файловой системы в резервные копии. По умолчанию это значение равно false. Если оно установлено в true, все метки файловой системы копируются во все автоматические резервные копии и любые резервные копии, созданные пользователем, в которых пользователь не указал какие-либо метки. Если это значение равно true, и вы указали одну или несколько меток, копируются только указанные метки. Если вы указали одну или несколько меток при создании резервной копии, созданной пользователем, метки не копируются из файловой системы, независимо от этого значения.

Aliases -> (список)

Массив одного или нескольких DNS-псевдонимов, которые в настоящее время связаны с файловой системой Amazon FSx. Псевдонимы позволяют использовать существующие имена DNS для доступа к данным в вашей файловой системе Amazon FSx. Вы можете связать до 50 псевдонимов с файловой системой в любое время. Вы можете связать дополнительные DNS-псевдонимы после создания файловой системы с помощью операции AssociateFileSystemAliases. Вы можете удалить DNS-псевдонимы из файловой системы после ее создания с помощью операции DisassociateFileSystemAliases. Вам нужно указать только имя псевдонима в теле запроса. Для получения дополнительной информации см. DNS-псевдонимы.

(структура)

DNS-псевдоним, связанный с файловой системой. Вы можете использовать DNS-псевдоним для доступа к файловой системе с помощью определенных пользователем имен DNS помимо имени DNS по умолчанию, назначенного Amazon FSx для файловой системы. Для получения дополнительной информации см. DNS-псевдонимы в руководстве пользователя FSx для Windows File Server.

Name -> (строка)

Имя DNS-псевдонима. Имя псевдонима должно соответствовать следующим требованиям:

  • Отформатировано как полное доменное имя (FQDN), hostname.domain, например, accounting.example.com.
  • Может содержать буквенно-цифровые символы, символ подчеркивания (_) и дефис (-).
  • Не может начинаться или заканчиваться дефисом.
  • Может начинаться с цифры.

Для имен DNS Amazon FSx хранит буквенные символы в виде строчных букв (a-z), независимо от того, как вы их указываете: как прописные буквы, строчные буквы или соответствующие буквы в кодах с escape-последовательностями.

Lifecycle -> (строка)

Описывает состояние DNS-псевдонима.

  • AVAILABLE - DNS-псевдоним связан с файловой системой Amazon FSx.
  • CREATING - Amazon FSx создает DNS-псевдоним и связывает его с файловой системой.
  • CREATE_FAILED - Amazon FSx не смог связать DNS-псевдоним с файловой системой.
  • DELETING - Amazon FSx отсоединяет DNS-псевдоним от файловой системы и удаляет его.
  • DELETE_FAILED - Amazon FSx не смог отсоединить DNS-псевдоним от файловой системы.

AuditLogConfiguration -> (структура)

Настройка, которую Amazon FSx для Windows File Server использует для аудита и регистрации доступов пользователей к файлам, папкам и общим папкам в файловой системе Amazon FSx для Windows File Server.

FileAccessAuditLogLevel -> (строка)

Устанавливает тип попытки, регистрируемой Amazon FSx для доступа к файлам и папкам.

  • SUCCESS_ONLY - регистрируются только успешные попытки доступа к файлам или папкам.
  • FAILURE_ONLY - регистрируются только неудачные попытки доступа к файлам или папкам.
  • SUCCESS_AND_FAILURE - регистрируются как успешные, так и неудачные попытки доступа к файлам или папкам.
  • DISABLED - аудит доступа к файлам и папкам выключен.

FileShareAccessAuditLogLevel -> (строка)

Устанавливает тип попытки, регистрируемой Amazon FSx для доступа к общим папкам.

  • SUCCESS_ONLY - регистрируются только успешные попытки доступа к общим папкам.
  • FAILURE_ONLY - регистрируются только неудачные попытки доступа к общим папкам.
  • SUCCESS_AND_FAILURE - регистрируются как успешные, так и неудачные попытки доступа к общим папкам.
  • DISABLED - аудит доступа к общим папкам выключен.

AuditLogDestination -> (строка)

Amazon Resource Name (ARN) для места назначения журналов аудита. Местом назначения может быть любой журнал Amazon CloudWatch Logs или поток доставки Amazon Kinesis Data Firehose.

Имя группы журнала Amazon CloudWatch Logs должно начинаться с префикса /aws/fsx. Имя потока доставки Amazon Kinesis Data Firehose должно начинаться с префикса aws-fsx.

ARN места назначения (группа журнала CloudWatch Logs или поток доставки Kinesis Data Firehose) должен находиться в той же области AWS, регионе AWS и учетной записи AWS, что и ваша файловая система Amazon FSx.

DiskIopsConfiguration -> (структура)

Настройка SSD IOPS (входно-выходных операций в секунду) для файловой системы Amazon FSx для Windows. По умолчанию Amazon FSx автоматически выделяет 3 IOPS на 1 ГБ емкости хранилища. Вы можете выделить дополнительные IOPS на 1 ГБ емкости хранилища, до максимального предела, связанного с выбранной пропускной способностью.

Mode -> (строка)

Указывает, использует ли файловая система значение AUTOMATIC для SSD IOPS (3 IOPS на 1 ГБ емкости хранилища) или использует значение USER_PROVISIONED.

Iops -> (целое число)

Общее количество SSD IOPS, выделенных для файловой системы.

Минимальные и максимальные значения для этого свойства зависят от значения HAPairs и StorageCapacity. Минимальное значение рассчитывается как StorageCapacity * 3 * HAPairs (3 IOPS на 1 ГБ StorageCapacity). Максимальное значение рассчитывается как 200 000 * HAPairs.

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса), если значение Iops находится за пределами минимального или максимального значения.

LustreConfiguration -> (структура)

Настройка файловой системы Amazon FSx for Lustre.

WeeklyMaintenanceStartTime -> (строка)

Предпочтительное время для проведения еженедельного технического обслуживания, отформатированное как d:HH:MM в часовом поясе UTC. Здесь d — номер дня недели от 1 до 7, начиная с понедельника и заканчивая воскресеньем.

DataRepositoryConfiguration -> (структура)

Объект конфигурации хранилища данных для файловых систем Lustre, возвращаемый в ответ на операцию CreateFileSystem.

Этот тип данных не поддерживается для файловых систем с ассоциацией хранилища данных. Для файловых систем с ассоциацией хранилища данных см. .

Lifecycle -> (строка)

Описание состояния хранилища долговременных данных S3 файловой системы, если оно настроено с хранилищем S3. Жизненный цикл может принимать следующие значения:

  • CREATING — конфигурация хранилища данных между файловой системой FSx и связанным хранилищем данных S3 создается. Хранилище данных недоступно.
  • AVAILABLE — хранилище данных доступно для использования.
  • MISCONFIGURED — Amazon FSx не может автоматически импортировать обновления из ведра S3, пока конфигурация хранилища данных не будет исправлена. Для получения дополнительной информации см. Устранение неполадок с неправильно настроенным связанным ведром S3 .
  • UPDATING — хранилище данных проходит обновление, инициированное пользователем, и доступность может быть затронута.
  • FAILED — хранилище данных находится в терминальном состоянии, из которого невозможно восстановиться.

ImportPath -> (строка)

Путь импорта к ведру Amazon S3 (и необязательному префиксу), используемому вами как хранилище данных для вашей файловой системы FSx для Lustre, например, s3://import-bucket/optional-prefix . Если после имени ведра Amazon S3 указан префикс, в файловую систему загружаются только ключи объектов с этим префиксом.

ExportPath -> (строка)

Путь экспорта к ведру Amazon S3 (и префиксу), которое вы используете для хранения новых и измененных файлов файловой системы Lustre в S3.

ImportedFileChunkSize -> (целое число)

Для файлов, импортированных из хранилища данных, это значение определяет количество полос и максимальный объем данных на файл (в МБ) на одном физическом диске. Максимальное количество дисков, на которые может быть распределен один файл, ограничено общим количеством дисков, составляющих файловую систему.

Размер фрагмента по умолчанию составляет 1024 МБ (1 ГБ) и может достигать 512 000 МБ (500 ГБ). Максимальный размер объектов S3 составляет 5 ТБ.

AutoImportPolicy -> (строка)

Описание автоматического импорта хранилища данных связанного с файловой системой S3. Параметр AutoImportPolicy определяет, как Amazon FSx поддерживает актуальность списков файлов и каталогов по мере добавления или изменения объектов в связанном ведре S3. Параметр AutoImportPolicy может принимать следующие значения:

  • NONE — (По умолчанию) Автоимпорт выключен. Amazon FSx обновляет списки файлов и каталогов из связанного ведра S3 только при создании файловой системы. После выбора этого параметра FSx не обновляет списки файлов и каталогов для новых или измененных объектов.
  • NEW — Автоимпорт включен. Amazon FSx автоматически импортирует списки каталогов любых новых объектов, добавленных в связанное ведро S3, которые в настоящее время отсутствуют в файловой системе FSx.
  • NEW_CHANGED — Автоимпорт включен. Amazon FSx автоматически импортирует списки файлов и каталогов любых новых объектов, добавленных в ведро S3, и любых существующих объектов, измененных в ведре S3, после выбора этого параметра.
  • NEW_CHANGED_DELETED — Автоимпорт включен. Amazon FSx автоматически импортирует списки файлов и каталогов любых новых объектов, добавленных в ведро S3, любых существующих объектов, измененных в ведре S3, и любых объектов, удаленных из ведра S3.

FailureDetails -> (структура)

Предоставляет подробную информацию о хранилище данных, если его параметр Lifecycle установлен на MISCONFIGURED или FAILED.

Message -> (строка)

Подробное сообщение об ошибке.

DeploymentType -> (строка)

Тип развертывания файловой системы FSx для Lustre. Тип развертывания «Рабочая область» предназначен для временного хранения и краткосрочной обработки данных.

SCRATCH_1 и SCRATCH_2 типы развертывания лучше всего подходят для случаев, когда вам нужно временное хранилище и краткосрочная обработка данных. SCRATCH_2 тип развертывания обеспечивает шифрование данных в процессе передачи и более высокую пропускную способность при передаче данных, чем SCRATCH_1.

PERSISTENT_1 и PERSISTENT_2 типы развертывания используются для долгосрочного хранения и рабочих нагрузок, а также шифрования данных в процессе передачи. PERSISTENT_2 обеспечивает более высокую PerUnitStorageThroughput (до 1000 МБ/с/ТиБ) наряду с меньшими требованиями к минимальному объему хранилища (600 ГБ). Чтобы узнать больше о типах развертывания FSx для Lustre, см. Варианты развертывания FSx для Lustre.

По умолчанию — SCRATCH_1.

PerUnitStorageThroughput -> (целое число)

Пропускная способность хранения на единицу измерения представляет собой мегабайты в секунду пропускной способности чтения или записи на 1 тебибайт предоставленного хранилища. Пропускная способность файловой системы равна емкости хранилища (ТиБ) * PerUnitStorageThroughput (МБ/с/ТиБ). Этот параметр действителен только для типов развертывания PERSISTENT_1 и PERSISTENT_2.

Допустимые значения:

  • Для хранилища PERSISTENT_1 SSD: 50, 100, 200.
  • Для хранилища PERSISTENT_1 HDD: 12, 40.
  • Для хранилища PERSISTENT_2 SSD: 125, 250, 500, 1000.

MountName -> (строка)

Вы используете значение MountName при подключении файловой системы.

Для типа развертывания SCRATCH_1 это значение всегда «fsx». Для типов развертывания SCRATCH_2, PERSISTENT_1 и PERSISTENT_2 это значение — строка, уникальная в пределах региона Amazon Web Services.

DailyAutomaticBackupStartTime -> (строка)

Ежедневное повторяющееся время в формате HH:MM. HH — нулевой час суток (0-23), а MM — нулевые минуты часа. Например, 05:00 указывает на 5 часов утра ежедневно.

AutomaticBackupRetentionDays -> (целое число)

Количество дней для хранения автоматических резервных копий. Установка этого свойства на 0 отключает автоматические резервные копии. Вы можете хранить автоматические резервные копии не более 90 дней. По умолчанию — 30.

CopyTagsToBackups -> (булево)

Флаг булевого типа, указывающий, копируются ли теги файловой системы в резервные копии. Если он установлен в значение true, все теги файловой системы копируются во все автоматические резервные копии и в любые резервные копии, инициированные пользователем, где пользователь не указывает теги. Если это значение равно true, и вы указываете один или несколько тегов, в резервные копии копируются только указанные теги. Если вы указываете один или несколько тегов при создании резервной копии, инициированной пользователем, теги не копируются из файловой системы, независимо от этого значения. (По умолчанию = false)

DriveCacheType -> (строка)

Тип кэша диска, используемого файловыми системами PERSISTENT_1, которые снабжены устройствами хранения HDD. Этот параметр необходим, когда StorageType равен HDD. Если он установлен на READ, файловая система имеет кэш хранилища SSD, размер которого составляет 20% от емкости хранилища файловой системы. Это повышает производительность часто используемых файлов за счет кэширования до 20% от общей емкости хранилища.

Этот параметр необходим, когда StorageType установлен в HDD.

DataCompressionType -> (строка)

Настройка сжатия данных для файловой системы. DataCompressionType может принимать следующие значения:

  • NONE — Сжатие данных выключено для файловой системы.
  • LZ4 — Сжатие данных включено с алгоритмом LZ4.

Для получения дополнительной информации см. Сжатие данных Lustre.

LogConfiguration -> (структура)

Конфигурация ведения журнала Lustre. Ведение журнала Lustre записывает разрешенные события журнала для вашей файловой системы в Amazon CloudWatch Logs.

Level -> (строка)

События хранилища данных, которые регистрируются Amazon FSx.

  • WARN_ONLY — регистрируются только предупреждающие события.
  • ERROR_ONLY — регистрируются только события об ошибках.
  • WARN_ERROR — регистрируются как предупреждающие, так и события об ошибках.
  • DISABLED — регистрация событий хранилища данных выключена.

Обратите внимание, что Amazon File Cache использует значение по умолчанию WARN_ERROR, которое нельзя изменить.

Destination -> (строка)

Идентификатор ресурса Amazon (ARN), который определяет место назначения журналов. Местом назначения может быть любой ARN группы журналов Amazon CloudWatch Logs. ARN места назначения должен находиться в той же части Amazon Web Services, том же регионе Amazon Web Services и том же аккаунте Amazon Web Services, что и ваша файловая система Amazon FSx.

RootSquashConfiguration -> (структура)

Настройка сжатия корневого пользователя Lustre для файловой системы Amazon FSx для Lustre. При включении сжатия корневого пользователя, ограничивается доступ на уровне root от клиентов, которые пытаются получить доступ к файловой системе в качестве пользователя root.

RootSquash -> (строка)

Вы включаете сжатие root, установив идентификатор пользователя (UID) и идентификатор группы (GID) для файловой системы в формате UID:GID (например, 365534:65534). Значения UID и GID могут варьироваться от 0 до 4294967294:

  • Значение UID и GID, отличное от нуля, включает сжатие root. Значения UID и GID могут быть разными, но каждое должно быть отличным от нуля.
  • Значение 0 (ноль) для UID и GID означает root и, следовательно, отключает сжатие root.

При включенном сжатии корневого пользователя идентификатор пользователя и идентификатор группы пользователя root, пытающегося получить доступ к файловой системе, переназначаются на предоставленные вами значения UID и GID.

NoSquashNids -> (список)

При включенном сжатии root, вы можете дополнительно указать массив NID клиентов, для которых сжатие root не применяется. NID клиента — это идентификатор сети Lustre, используемый для уникальной идентификации клиента. Вы можете указать NID как один адрес или диапазон адресов:

  • Один адрес описывается в стандартном формате NID Lustre, указанием IP-адреса клиента и идентификатора сети Lustre (например, 10.0.1.6@tcp).
  • Диапазон адресов описывается с помощью дефиса для разделения диапазона (например, 10.0.[2-10].[1-255]@tcp).

(строка)

MetadataConfiguration -> (структура)

Настройка производительности метаданных Lustre для файловой системы Amazon FSx for Lustre с типом развертывания PERSISTENT_2.

Iops -> (целое число)

Количество метаданных IOPS, предоставленных для файловой системы. Допустимые значения — 1500 , 3000 , 6000 , 12000 и кратные 12000 до максимального значения 192000 .

Mode -> (строка)

Режим конфигурации метаданных для предоставления метаданных IOPS для файловой системы.

  • В режиме AUTOMATIC FSx for Lustre автоматически предоставляет и масштабирует количество метаданных IOPS для вашей файловой системы на основе емкости хранилища вашей файловой системы.
  • В режиме USER_PROVISIONED вы можете указать количество метаданных IOPS, которые нужно предоставить для вашей файловой системы.

EfaEnabled -> (булево)

Указывает, включена ли поддержка Elastic Fabric Adapter (EFA) и GPUDirect Storage (GDS) для файловой системы Amazon FSx for Lustre.

OntapConfiguration -> (структура)

Настройка для этой файловой системы Amazon FSx for NetApp ONTAP.

AutomaticBackupRetentionDays -> (целое число)

Количество дней, на которые нужно сохранить автоматические резервные копии. Установка этого свойства в значение 0 отключает автоматические резервные копии. Вы можете сохранить автоматические резервные копии не более чем на 90 дней. По умолчанию это значение равно 30 .

DailyAutomaticBackupStartTime -> (строка)

Ежедневное повторяющееся время в формате HH:MM . HH — это отформатированное число часа (0–23), а MM — отформатированное число минуты (0–59). Например, 05:00 указывает на ежедневное резервное копирование в 5:00.

DeploymentType -> (строка)

Указывает тип развертывания файловой системы 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 -> (строка)

(Только Multi-AZ) Указывает диапазон IP-адресов, в котором будут созданы конечные точки для доступа к вашей файловой системе. По умолчанию в Amazon FSx API Amazon FSx выбирает для вас неиспользуемый диапазон IP-адресов из диапазона 198.19. *. По умолчанию в консоли Amazon FSx Amazon FSx выбирает последние 64 IP-адреса из основного CIDR-диапазона VPC в качестве диапазона IP-адресов конечных точек для файловой системы. Вы можете иметь перекрывающиеся IP-адреса конечных точек для файловых систем, развернутых в одной VPC/таблицах маршрутизации.

Endpoints -> (структура)

Конечные точки Management и Intercluster, используемые для доступа к данным или для управления файловой системой с помощью NetApp ONTAP CLI, REST API или NetApp SnapMirror.

Intercluster -> (структура)

Конечная точка для управления вашей файловой системой путем настройки NetApp SnapMirror с другими системами ONTAP.

DNSName -> (строка)

Имя DNS файловой системы. Вы можете подключиться к файловой системе, используя ее имя DNS.

IpAddresses -> (список)

IP-адреса конечной точки файловой системы.

(строка)

Management -> (структура)

Конечная точка для управления вашей файловой системой с помощью NetApp ONTAP CLI и NetApp ONTAP API.

DNSName -> (строка)

Имя DNS файловой системы. Вы можете подключиться к файловой системе, используя ее имя DNS.

IpAddresses -> (список)

IP-адреса конечной точки файловой системы.

(строка)

DiskIopsConfiguration -> (структура)

Конфигурация IOPS SSD для файловой системы ONTAP, определяющая количество предоставленных IOPS и режим предоставления.

Mode -> (строка)

Указывает, использует ли файловая система значение AUTOMATIC для IOPS SSD (3 IOPS на 1 ГБ емкости хранилища) или другое значение USER_PROVISIONED .

Iops -> (длинное целое)

Общее количество предоставленных IOPS SSD для файловой системы.

Минимальные и максимальные значения для этого свойства зависят от значений HAPairs и StorageCapacity . Минимальное значение рассчитывается как StorageCapacity * 3 * HAPairs (3 IOPS на ГБ емкости StorageCapacity). Максимальное значение рассчитывается как 200 000 * HAPairs .

Amazon FSx возвращает HTTP-код состояния 400 (Неверный запрос), если значение Iops находится за пределами минимальных или максимальных значений.

PreferredSubnetId -> (строка)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашей виртуальной частной сети (VPC). Дополнительную информацию см. в разделе VPC и подсети в Руководстве пользователя Amazon VPC.

RouteTableIds -> (список)

(Только Multi-AZ) Таблицы маршрутизации VPC, в которых создаются конечные точки вашей файловой системы.

(строка)

ThroughputCapacity -> (целое число)

Непрерывная пропускная способность файловой системы Amazon FSx в мегабайтах в секунду (МБ/с).

WeeklyMaintenanceStartTime -> (строка)

Еженедельное повторяющееся время в формате D:HH:MM .

D — день недели, где 1 соответствует понедельнику, а 7 — воскресенью. Дополнительные сведения см. в спецификации ISO-8601 на Wikipedia.

HH — это отформатированное число часа (0–23), а MM — отформатированное число минуты (0–59).

Например, 1:05:00 указывает на техническое обслуживание в 5:00 понедельника.

FsxAdminPassword -> (строка)

Вы можете использовать учетную запись пользователя fsxadmin для доступа к NetApp ONTAP CLI и REST API. Значение пароля всегда скрывается в ответе.

HAPairs -> (целое число)

Указывает количество пар серверов файловой системы с высокой доступностью (HA), которые будет иметь файловая система. Значение по умолчанию равно 1. Значение этого свойства влияет на значения StorageCapacity , Iops и ThroughputCapacity . Дополнительную информацию см. в руководстве пользователя FSx for ONTAP в разделе Пара высокодоступности (HA).

Amazon FSx возвращает HTTP-код состояния 400 (Неверный запрос) при следующих условиях:

  • Значение HAPairs меньше 1 или больше 12.
  • Значение HAPairs больше 1, а значение DeploymentType — SINGLE_AZ_1 , MULTI_AZ_1 или MULTI_AZ_2 .

ThroughputCapacityPerHAPair -> (целое число)

Используйте для выбора пропускной способности на каждую пару HA. Когда значение HAPairs равно 1, значение ThroughputCapacityPerHAPair — это общая пропускная способность для файловой системы.

Это поле и ThroughputCapacity не могут быть определены в одном вызове API, но одно из них обязательно.

Это поле и ThroughputCapacity совпадают для файловых систем с одной парой HA.

  • Для файловых систем SINGLE_AZ_1 и MULTI_AZ_1 допустимые значения равны 128, 256, 512, 1024, 2048 или 4096 Мбит/с.
  • Для SINGLE_AZ_2 допустимые значения равны 1536, 3072 или 6144 Мбит/с.
  • Для MULTI_AZ_2 допустимые значения равны 384, 768, 1536, 3072 или 6144 Мбит/с.

Amazon FSx возвращает HTTP-код состояния 400 (Неверный запрос) при следующих условиях:

  • Значения ThroughputCapacity и ThroughputCapacityPerHAPair не совпадают.
  • Значение типа развертывания — SINGLE_AZ_2 , а ThroughputCapacity / ThroughputCapacityPerHAPair не является допустимой парой HA (значение от 1 до 12).
  • Значение ThroughputCapacityPerHAPair не является допустимым.

FileSystemTypeVersion -> (строка)

Версия Lustre файловой системы Amazon FSx for Lustre, которая может быть 2.10 , 2.12 или 2.15 .

OpenZFSConfiguration -> (структура)

Настройка этого файлового сервера Amazon FSx for OpenZFS.

AutomaticBackupRetentionDays -> (целое число)

Количество дней для сохранения автоматических резервных копий. Установка этого свойства в значение 0 отключает автоматические резервные копии. Вы можете сохранять автоматические резервные копии не более 90 дней. По умолчанию значение 30 .

CopyTagsToBackups -> (булево)

Булево значение, указывающее, нужно ли копировать метки файловой системы в резервные копии. Если значение равно true , все метки файловой системы копируются во все автоматические резервные копии и любые резервные копии, созданные пользователем, без указания пользователем меток. Если значение равно true, и вы указали одну или несколько меток, то только указанные метки копируются в резервные копии. Если вы указали одну или несколько меток при создании резервной копии пользователем, метки не копируются с файловой системы, независимо от этого значения.

CopyTagsToVolumes -> (булево)

Булево значение, указывающее, нужно ли копировать метки тома в снимки. По умолчанию значение равно false. Если значение равно true, все метки тома копируются в снимки, в которых пользователь не указывает метки. Если значение равно true, и вы указали одну или несколько меток, то только указанные метки копируются в снимки. Если вы указали одну или несколько меток при создании снимка, метки не копируются с тома, независимо от этого значения.

DailyAutomaticBackupStartTime -> (строка)

Повторяющееся ежедневное время в формате HH:MM. HH — это заполненное нулями число часа (0-23), а MM — это заполненное нулями число минуты. Например, 05:00 означает 5:00 ежедневно.

DeploymentType -> (строка)

Указывает тип развертывания файловой системы. Amazon FSx for OpenZFS поддерживает MULTI_AZ_1 , SINGLE_AZ_HA_2 , SINGLE_AZ_HA_1 , SINGLE_AZ_2 и SINGLE_AZ_1.

ThroughputCapacity -> (целое число)

Пропускная способность файловой системы Amazon FSx, измеряемая в мегабайтах в секунду (МБ/с).

WeeklyMaintenanceStartTime -> (строка)

Повторяющееся еженедельное время в формате D:HH:MM.

D — это день недели, где 1 соответствует понедельнику, а 7 — воскресенью. Для получения дополнительной информации см. спецификацию ISO-8601, описанную на Википедии.

HH — это заполненное нулями число часа (0-23), а MM — это заполненное нулями число минуты.

Например, 1:05:00 означает техническое обслуживание в 5:00 понедельника.

DiskIopsConfiguration -> (структура)

Настройка SSD IOPS (операций ввода/вывода в секунду) для файловой системы Amazon FSx for NetApp ONTAP, Amazon FSx for Windows File Server или FSx for OpenZFS. По умолчанию Amazon FSx автоматически выделяет 3 IOPS на каждый ГБ емкости хранилища. Вы можете выделить дополнительные IOPS на каждый ГБ емкости хранилища. Настройка включает общее количество выделенных SSD IOPS и способ их выделения, или режим (клиентом или Amazon FSx).

Mode -> (строка)

Указывает, использует ли файловая система значение AUTOMATIC для SSD IOPS в 3 IOPS на каждый ГБ емкости хранилища, или использует значение USER_PROVISIONED.

Iops -> (длинное целое)

Общее количество выделенных SSD IOPS для файловой системы.

Минимальные и максимальные значения для этого свойства зависят от значений HAPairs и StorageCapacity. Минимальное значение рассчитывается как StorageCapacity * 3 * HAPairs (3 IOPS на каждый ГБ емкости StorageCapacity). Максимальное значение рассчитывается как 200 000 * HAPairs.

Amazon FSx отвечает кодом состояния HTTP 400 (Ошибка запроса), если значение Iops находится вне минимальных или максимальных значений.

RootVolumeId -> (строка)

Идентификатор корневого тома файловой системы OpenZFS.

PreferredSubnetId -> (строка)

Требуется, когда DeploymentType установлено в значение MULTI_AZ_1. Это указывает подсеть, в которой вы хотите расположить предпочтительный файловый сервер.

EndpointIpAddressRange -> (строка)

(Только Multi-AZ) Указывает диапазон IP-адресов, в котором будут созданы конечные точки для доступа к вашей файловой системе. По умолчанию в Amazon FSx API и консоли Amazon FSx Amazon FSx выбирает для вас доступный диапазон IP-адресов /28 из одного из диапазонов CIDR VPC. Вы можете иметь перекрывающиеся IP-адреса конечных точек для файловых систем, развернутых в одной VPC/таблицах маршрутизации.

RouteTableIds -> (список)

(Только Multi-AZ) Таблицы маршрутизации VPC, в которых создаются конечные точки вашей файловой системы.

(строка)

EndpointIpAddress -> (строка)

IP-адрес конечной точки, используемой для доступа к данным или управления файловой системой.

ReadCacheConfiguration -> (структура)

Требуется, когда StorageType установлено в значение INTELLIGENT_TIERING. Указывает необязательный выделенный SSD кэш чтения.

SizingMode -> (строка)

Указывает, как определяется размер выделенного SSD кэша чтения:

  • Установите значение NO_CACHE, если вы не хотите использовать SSD кэш чтения с файловой системой Intelligent-Tiering.
  • Установите значение USER_PROVISIONED, чтобы указать точный размер вашего SSD кэша чтения.
  • Установите значение PROPORTIONAL_TO_THROUGHPUT_CAPACITY, чтобы ваш SSD кэш чтения автоматически определялся на основе вашей пропускной способности.

SizeGiB -> (целое число)

Требуется, если SizingMode установлено в значение USER_PROVISIONED. Указывает размер SSD кэша чтения файловой системы в гигабайтах (GiB).

FailureDetails -> (структура)

Предоставляет информацию об ошибочном административном действии.

Message -> (строка)

Сообщение об ошибке, предоставляющее подробности об ошибочном административном действии.

TargetVolumeValues -> (структура)

Описание тома Amazon FSx.

CreationTime -> (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 for NetApp ONTAP.

FlexCacheEndpointType -> (string)

Указывает тип конечной точки FlexCache тома. Допустимые значения следующие:

  • NONE указывает, что у тома нет конфигурации FlexCache. NONE является значением по умолчанию.
  • ORIGIN указывает, что том является исходным для тома FlexCache.
  • CACHE указывает, что том является томом FlexCache.

JunctionPath -> (string)

Указывает каталог, который клиенты сетевого хранилища (NAS) используют для подключения тома, вместе с именем домена системы доменных имён (DNS) или IP-адресом виртуальной машины хранения (SVM). Вы можете создать JunctionPath непосредственно ниже родительского узла тома или в каталоге внутри тома. JunctionPath для тома, названного vol3, может быть /vol1/vol2/vol3 или /vol1/dir2/vol3, или даже /dir1/dir2/vol3.

SecurityStyle -> (string)

Стиль безопасности тома, который может быть UNIX, NTFS или MIXED.

SizeInMegabytes -> (integer)

Настроенный размер тома в мегабайтах (МБ).

StorageEfficiencyEnabled -> (boolean)

Настройка эффективности хранения тома.

StorageVirtualMachineId -> (string)

Идентификатор виртуальной машины хранения тома.

StorageVirtualMachineRoot -> (boolean)

Логический флаг, указывающий, является ли данный том корневым томом для его виртуальной машины хранения (SVM). Только один том на SVM может быть корневым. По умолчанию это значение равно false. Если это значение равно true, то это корневой том SVM.

Этот флаг полезен при удалении SVM, потому что необходимо сначала удалить все некорневые тома. Этот флаг, установленный в false, помогает определить, какие тома необходимо удалить перед удалением SVM.

TieringPolicy -> (structure)

Настройка TieringPolicy тома.

CoolingPeriod -> (integer)

Указывает количество дней, в течение которых данные пользователя в томе должны оставаться неактивными, прежде чем считаться «холодными» и перемещаться в пул ресурсов. Используется с политиками тиеринга AUTO и SNAPSHOT_ONLY. Введите целое число от 2 до 183. Значения по умолчанию составляют 31 день для AUTO и 2 дня для SNAPSHOT_ONLY.

Name -> (string)

Указывает политику тиеринга, используемую для перевода данных. Значение по умолчанию - SNAPSHOT_ONLY.

  • SNAPSHOT_ONLY - перемещает холодные снимки в хранилище пула ресурсов.
  • AUTO - перемещает холодные данные пользователей и снимки в хранилище пула ресурсов на основе ваших шаблонов доступа.
  • ALL - перемещает все блоки данных пользователя в активной файловой системе и копиях снимков в хранилище пула ресурсов.
  • NONE - сохраняет данные тома в основном хранилище, предотвращая их перемещение в хранилище пула ресурсов.

UUID -> (string)

Универсальный уникальный идентификатор (UUID) тома.

OntapVolumeType -> (string)

Указывает тип тома. Допустимые значения следующие:

  • RW указывает том чтения/записи. RW является значением по умолчанию.
  • DP указывает том защиты данных. Вы можете защитить данные, дублируя их в зеркальные копии защиты данных. В случае аварии вы можете использовать эти зеркальные копии для восстановления данных.
  • LS указывает том зеркалирования для совместного использования нагрузки. Зеркалирование для совместного использования нагрузки уменьшает сетевой трафик для тома FlexVol, предоставляя дополнительный доступ только для чтения клиентам.

SnapshotPolicy -> (string)

Указывает политику создания снимков для тома. Существует три встроенные политики создания снимков:

  • default : Это политика по умолчанию. Максимальное количество ежечасных снимков — шесть, созданных через пять минут после часа. Максимальное количество ежедневных снимков — два, созданных с понедельника по субботу в 10 минут после полуночи. Максимальное количество еженедельных снимков — два, созданных каждую субботу в 15 минут после полуночи.
  • default-1weekly : Эта политика аналогична политике default, за исключением того, что она сохраняет только один снимок из еженедельного графика.
  • none : Эта политика не создаёт никаких снимков. Эта политика может быть назначена томам, чтобы предотвратить автоматическое создание снимков.

Вы также можете указать имя настраиваемой политики, созданной с помощью ONTAP CLI или REST API.

Дополнительную информацию см. в руководстве пользователя Amazon FSx for NetApp ONTAP по политике создания снимков.

CopyTagsToBackups -> (boolean)

Логический флаг, указывающий, должны ли тэги тома копироваться в резервные копии. По умолчанию это значение равно false. Если оно установлено в true, все тэги тома копируются во все автоматические и инициированные пользователем резервные копии, где пользователь не указывает тэги. Если это значение равно true, и вы указываете один или несколько тэгов, копируются только указанные тэги. Если вы указываете один или несколько тэгов при создании резервной копии инициированной пользователем, тэги не копируются из тома, независимо от этого значения.

SnaplockConfiguration -> (structure)

Объект конфигурации SnapLock для тома SnapLock FSx for ONTAP.

AuditLogVolume -> (boolean)

Включает или отключает том журнала аудита для тома SnapLock FSx for ONTAP. Значение по умолчанию — false. Если вы установите AuditLogVolume в true, том SnapLock будет создан как том журнала аудита. Минимальный срок хранения для тома журнала аудита составляет шесть месяцев.

Дополнительную информацию см. в разделе Журналы аудита SnapLock.

AutocommitPeriod -> (структура)

Объект конфигурации для установки периода автоматического сохранения файлов в томе SnapLock FSx for ONTAP.

Type -> (строка)

Определяет тип времени для периода автоматического сохранения файла в томе SnapLock FSx for ONTAP. Установка этого значения в NONE отключает автоматическое сохранение. Значение по умолчанию — NONE.

Value -> (целое число)

Определяет продолжительность периода автоматического сохранения файла в томе SnapLock FSx for ONTAP. Допустимые диапазоны:

  • Minutes : 5 — 65 535
  • Hours : 1 — 65 535
  • Days : 1 — 3650
  • Months : 1 — 120
  • Years : 1 — 10

PrivilegedDelete -> (строка)

Включает, отключает или постоянно отключает привилегированное удаление в томе SnapLock Enterprise FSx for ONTAP. Включение привилегированного удаления позволяет администраторам SnapLock удалять файлы WORM (Write Once, Read Many), даже если они имеют активные сроки хранения. PERMANENTLY_DISABLED — это терминальное состояние. Если привилегированное удаление постоянно отключено в томе SnapLock, его нельзя включить обратно. Значение по умолчанию — DISABLED.

Дополнительную информацию см. в разделе Привилегированное удаление.

RetentionPeriod -> (структура)

Указывает срок хранения тома SnapLock FSx for ONTAP.

DefaultRetention -> (структура)

Срок хранения, назначаемый файлу WORM по умолчанию, если для тома SnapLock FSx for ONTAP не установлен явный срок хранения. Срок хранения по умолчанию должен быть больше или равен минимальному сроку хранения и меньше или равен максимальному сроку хранения.

Type -> (строка)

Определяет тип времени для срока хранения тома SnapLock FSx for ONTAP. Установите одно из допустимых значений. Если установить значение INFINITE, файлы хранятся вечно. Если установить значение UNSPECIFIED, файлы хранятся до тех пор, пока вы не установите явный срок хранения.

Value -> (целое число)

Определяет продолжительность срока хранения тома SnapLock FSx for ONTAP. Для значений INFINITE и UNSPECIFIED нельзя установить значение. Для всех остальных вариантов допустимые диапазоны:

  • Seconds : 0 — 65 535
  • Minutes : 0 — 65 535
  • Hours : 0 — 24
  • Days : 0 — 365
  • Months : 0 — 12
  • Years : 0 — 100

MinimumRetention -> (структура)

Наименьший срок хранения, который может быть назначен файлу WORM в томе SnapLock FSx for ONTAP.

Type -> (строка)

Определяет тип времени для срока хранения тома SnapLock FSx for ONTAP. Установите одно из допустимых значений. Если установить значение INFINITE, файлы хранятся вечно. Если установить значение UNSPECIFIED, файлы хранятся до тех пор, пока вы не установите явный срок хранения.

Value -> (целое число)

Определяет продолжительность срока хранения тома SnapLock FSx for ONTAP. Для значений INFINITE и UNSPECIFIED нельзя установить значение. Для всех остальных вариантов допустимые диапазоны:

  • Seconds : 0 — 65 535
  • Minutes : 0 — 65 535
  • Hours : 0 — 24
  • Days : 0 — 365
  • Months : 0 — 12
  • Years : 0 — 100

MaximumRetention -> (структура)

Наибольший срок хранения, который может быть назначен файлу WORM в томе SnapLock FSx for ONTAP.

Type -> (строка)

Определяет тип времени для срока хранения тома SnapLock FSx for ONTAP. Установите одно из допустимых значений. Если установить значение INFINITE, файлы хранятся вечно. Если установить значение UNSPECIFIED, файлы хранятся до тех пор, пока вы не установите явный срок хранения.

Value -> (целое число)

Определяет продолжительность срока хранения тома SnapLock FSx for ONTAP. Для значений INFINITE и UNSPECIFIED нельзя установить значение. Для всех остальных вариантов допустимые диапазоны:

  • Seconds : 0 — 65 535
  • Minutes : 0 — 65 535
  • Hours : 0 — 24
  • Days : 0 — 365
  • Months : 0 — 12
  • Years : 0 — 100

SnaplockType -> (строка)

Указывает режим хранения тома SnapLock FSx for ONTAP. После установки его изменить нельзя. Вы можете выбрать один из следующих режимов хранения:

  • COMPLIANCE : Файлы, переведенные в режим WORM в томе Compliance, нельзя удалить до истечения срока их хранения. Этот режим хранения используется для соблюдения нормативных требований определенных отраслей или защиты от атак с помощью ransomware. Дополнительную информацию см. в разделе SnapLock Compliance.
  • ENTERPRISE : Файлы, переведенные в режим WORM в томе Enterprise, могут быть удалены авторизованными пользователями до истечения срока их хранения с помощью привилегированного удаления. Этот режим хранения используется для повышения целостности данных организации и внутренней совместимости или для тестирования настроек хранения перед использованием SnapLock Compliance. Дополнительную информацию см. в разделе SnapLock Enterprise.

VolumeAppendModeEnabled -> (boolean)

Включает или отключает режим добавления к томам FSx for ONTAP SnapLock. Режим добавления к томам позволяет создавать файлы, к которым можно добавлять данные, и записывать в них данные по частям. Значение по умолчанию — false.

Дополнительную информацию см. в разделе Режим добавления к томам.

VolumeStyle -> (строка)

Используется для указания стиля тома ONTAP. Дополнительную информацию о FlexVols и FlexGroups см. в руководстве пользователя Amazon FSx for NetApp ONTAP, раздел Типы томов.

AggregateConfiguration -> (структура)

Эта структура определяет параметры конфигурации для агрегата или агрегатов хранилища тома.

Aggregates -> (список)

Список агрегатов, на которых находится этот том. Агрегаты — это хранилища, составляющие ваш основной уровень хранения. Каждая пара высокой доступности (HA) имеет один агрегат. Названия агрегатов соответствуют именам агрегатов в ONTAP CLI и REST API. Для FlexVols всегда будет один элемент.

Amazon FSx возвращает код HTTP 400 (Ошибка запроса) при следующих условиях:

  • Строки в значении Aggregates не отформатированы как aggrX, где X — число от 1 до 12.
  • Значение Aggregates содержит агрегаты, которых нет.
  • Один или несколько предоставленных агрегатов слишком близки к пределу тома, чтобы поддерживать добавление дополнительных томов.

(строка)

TotalConstituents -> (целое число)

Общее количество компонентов, которые имеет этот том FlexGroup. Неприменимо для FlexVols.

SizeInBytes -> (длинное целое число)

Настроенный размер тома в байтах.

ResourceARN -> (строка)

Amazon Resource Name (ARN) для данного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. ARN необходимы, когда требуется однозначно указать ресурс во всех сервисах Amazon Web Services. Дополнительную информацию см. в разделе Amazon Resource Names (ARN) в Справочном руководстве Amazon Web Services.

Tags -> (список)

Список значений Tag, с максимальным количеством элементов 50.

(структура)

Указывает пару ключ-значение для тега ресурса.

Key -> (строка)

Значение, определяющее TagKey, имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (строка)

Значение, определяющее TagValue, значение, назначенное соответствующему ключу тега. Значения тегов могут быть пустыми и не обязательно должны быть уникальными в наборе тегов. Например, в наборе тегов может быть пара ключ-значение finances : April, а также payroll : April.

VolumeId -> (строка)

Сгенерированный системой уникальный идентификатор тома.

VolumeType -> (строка)

Тип тома.

LifecycleTransitionReason -> (структура)

Причина изменения состояния жизненного цикла тома.

Message -> (строка)

Подробное сообщение об ошибке.

OpenZFSConfiguration -> (структура)

Настройка тома 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.

DataCompressionType -> (string)

Указывает метод сжатия данных в томе. По умолчанию используется тип сжатия NONE.

  • NONE - Данные в томе не сжимаются. По умолчанию используется NONE.
  • ZSTD - Данные в томе сжимаются с помощью алгоритма сжатия Zstandard (ZSTD). По сравнению с LZ4, Z-Standard обеспечивает более высокую степень сжатия, чтобы свести к минимуму использование дискового пространства.
  • LZ4 - Данные в томе сжимаются с помощью алгоритма сжатия LZ4. По сравнению с Z-Standard, LZ4 требует меньших вычислительных ресурсов и обеспечивает более высокую скорость записи.

CopyTagsToSnapshots -> (boolean)

Булево значение, указывающее, должны ли метки тома копироваться в снимки. По умолчанию это значение равно false. Если оно установлено в true, все метки тома копируются в снимки, где пользователь не указывает метки. Если это значение равно true, и вы указываете одну или несколько меток, копируются только указанные метки. Если вы указываете одну или несколько меток при создании снимка, метки не копируются из тома, независимо от этого значения.

OriginSnapshot -> (structure)

Объект конфигурации, который определяет снимок, используемый в качестве источника данных для тома.

SnapshotARN -> (string)

Amazon Resource Name (ARN) для данного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. Нам нужен ARN, когда нужно однозначно указать ресурс в рамках всех Amazon Web Services. Дополнительную информацию см. в разделе Имена ресурсов Amazon Resource Names (ARN) в Справочнике по Amazon Web Services.

CopyStrategy -> (string)

Стратегия, используемая при копировании данных из снимка в новый том.

  • CLONE - Новый том ссылается на данные в исходном снимке. Клонирование снимка быстрее, чем копирование данных из снимка в новый том, и не потребляет пропускную способность диска. Однако исходный снимок нельзя удалить, если существует том, использующий его скопированные данные.
  • FULL_COPY - Все данные из снимка копируются в новый том.

Примечание

Вариант INCREMENTAL_COPY используется только для обновления существующего тома с помощью снимка из другого файлового сервера FSx для OpenZFS. Дополнительную информацию см. в разделе CopySnapshotAndUpdateVolume.

ReadOnly -> (boolean)

Булево значение, указывающее, является ли том только для чтения.

NfsExports -> (list)

Объект конфигурации для подключения файловой системы NFS.

(structure)

Конфигурации 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)

Параметры, используемые при подключении к файловой системе. Список параметров, которые можно использовать с NFS, см. в справке по Linux man exports(5). При выборе параметров следует учитывать следующее:

  • crossmnt используется по умолчанию. Если вы не укажете crossmnt при изменении конфигурации клиента, вы не сможете увидеть или получить доступ к снимкам в каталоге снимков вашей файловой системы.
  • sync используется по умолчанию. Если вы укажете async, система подтверждает записи перед записью на диск. Если система выйдет из строя до завершения записей, несохраненные данные будут потеряны.

(string)

UserAndGroupQuotas -> (list)

Объект, определяющий, сколько памяти могут использовать пользователи или группы в томе.

(structure)

Используется для настройки квот, определяющих, сколько памяти может использовать пользователь или группа в томе FSx для OpenZFS. Дополнительную информацию см. в разделе Свойства тома в руководстве пользователя FSx для OpenZFS.

Type -> (string)

Указывает, относится ли квота к пользователю или группе.

Id -> (integer)

Идентификатор пользователя или группы, на которую распространяется квота.

StorageCapacityQuotaGiB -> (integer)

Квота на использование памяти пользователем или группой в гибибайтах (GiB).

RestoreToSnapshot -> (string)

Указывает ID снимка, к которому был восстановлен том.

DeleteIntermediateSnaphots -> (boolean)

Булево значение, указывающее, следует ли удалять снимки между текущим состоянием и указанным снимком при восстановлении тома из снимка.

DeleteClonedVolumes -> (boolean)

Булево значение, указывающее, следует ли удалять зависимые клонированные тома, созданные из промежуточных снимков, при восстановлении тома из снимка.

DeleteIntermediateData -> (boolean)

Булево значение, указывающее, следует ли перезаписывать данные снимка, которые отличаются между текущим состоянием и указанным снимком, при восстановлении тома из снимка.

SourceSnapshotARN -> (string)

Amazon Resource Name (ARN) для данного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. Нам нужен ARN, когда нужно однозначно указать ресурс в рамках всех Amazon Web Services. Дополнительную информацию см. в разделе Имена ресурсов Amazon Resource Names (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 Resource Name (ARN) для данного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. Нам нужен ARN, когда нужно однозначно указать ресурс в рамках всех Amazon Web Services. Дополнительную информацию см. в разделе Имена ресурсов Amazon Resource Names (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, который вы копируете.

OpenZFSConfiguration -> (structure)

Настройка тома Amazon FSx for OpenZFS.

ParentVolumeId -> (строка)

Идентификатор родительского тома.

VolumePath -> (строка)

Путь к тому от корневого тома. Например, fsx/parentVolume/volume1 .

StorageCapacityReservationGiB -> (целое число)

Объем резервируемого хранилища в гибибайтах (GiB) от родительского тома. Вы не можете зарезервировать больше хранилища, чем резервирует родительский том.

StorageCapacityQuotaGiB -> (целое число)

Максимальный объем хранилища в гибибайтах (GiB), который может использовать том от своего родителя. Вы можете указать квоту, превышающую объем хранилища на родительском томе.

RecordSizeKiB -> (целое число)

Размер записи тома OpenZFS в кибибайтах (KiB). Допустимые значения: 4, 8, 16, 32, 64, 128, 256, 512 или 1024 KiB. По умолчанию используется 128 KiB. Большинство рабочих нагрузок должны использовать значение по умолчанию. Дополнительные сведения о том, когда необходимо установить настраиваемый размер записи, см. в руководстве пользователя Amazon FSx for OpenZFS.

DataCompressionType -> (строка)

Определяет метод сжатия данных в томе. Тип сжатия по умолчанию — NONE.

  • NONE — Данные в томе не сжимаются. NONE — значение по умолчанию.
  • ZSTD — Сжимает данные в томе с помощью алгоритма сжатия Zstandard (ZSTD). По сравнению с LZ4, Z-Standard обеспечивает лучшую степень сжатия, чтобы свести к минимуму использование дискового пространства.
  • LZ4 — Сжимает данные в томе с помощью алгоритма сжатия LZ4. По сравнению со Z-Standard, LZ4 менее ресурсоемкий и обеспечивает более высокую скорость записи.

CopyTagsToSnapshots -> (булево)

Булево значение, указывающее, должны ли теги тома копироваться в снимки. По умолчанию это значение равно false. Если оно установлено в true, все теги тома копируются в снимки, где пользователь не указывает теги. Если это значение равно true, и вы указываете один или несколько тегов, только указанные теги копируются в снимки. Если вы указываете один или несколько тегов при создании снимка, теги не копируются из тома независимо от этого значения.

OriginSnapshot -> (структура)

Объект конфигурации, определяющий снимок, который необходимо использовать в качестве источника данных для тома.

SnapshotARN -> (строка)

Amazon Resource Name (ARN) для данного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. Нам необходим ARN, когда вам нужно однозначно указать ресурс во всей экосистеме Amazon Web Services. Дополнительные сведения см. в разделе Имена ресурсов Amazon (ARN) в Общей справке Amazon Web Services.

CopyStrategy -> (строка)

Стратегия, используемая при копировании данных со снимка на новый том.

  • CLONE — Новый том ссылается на данные в исходном снимке. Клонирование снимка быстрее, чем копирование данных со снимка на новый том и не потребляет пропускную способность диска. Однако исходный снимок нельзя удалить, если том использует скопированные данные.
  • FULL_COPY — Копирует все данные со снимка на новый том.

Примечание

Опция INCREMENTAL_COPY используется только для обновления существующего тома с помощью снимка из другого файловой системы FSx for OpenZFS. Дополнительные сведения см. в CopySnapshotAndUpdateVolume.

ReadOnly -> (булево)

Булево значение, указывающее, является ли том только для чтения.

NfsExports -> (список)

Объект конфигурации для подключения файловой системы Network File System (NFS).

(структура)

Настройки Network File System (NFS) для подключения файловой системы Amazon FSx for OpenZFS.

ClientConfigurations -> (список)

Список объектов конфигурации, содержащих клиента и параметры для подключения файловой системы OpenZFS.

(структура)

Указывает, кто может подключиться к файловой системе OpenZFS и какие параметры доступны при подключении к файловой системе.

Clients -> (строка)

Значение, указывающее, кто может подключиться к файловой системе. Вы можете указать символ подстановки (*), IP-адрес (0.0.0.0) или адрес CIDR (192.0.2.0/24). По умолчанию Amazon FSx использует символ подстановки при указании клиента.

Options -> (список)

Параметры для использования при подключении к файловой системе. Список параметров, которые можно использовать с Network File System (NFS), см. в справке exports(5) - man Linux. При выборе параметров следует учитывать следующее:

  • crossmnt используется по умолчанию. Если вы не указываете crossmnt при изменении конфигурации клиента, вы не сможете просматривать или получать доступ к снимкам в каталоге снимков файловой системы.
  • sync используется по умолчанию. Если вместо этого указать async, система подтверждает записи перед записью на диск. Если система выходит из строя до завершения записи, потерянные данные не будут сохранены.

(строка)

UserAndGroupQuotas -> (список)

Объект, указывающий, сколько хранилища могут использовать пользователи или группы в томе.

(структура)

Используется для настройки квот, определяющих, сколько хранилища может использовать пользователь или группа в томе FSx for OpenZFS. Дополнительные сведения см. в разделе Свойства тома в Руководстве пользователя FSx for OpenZFS.

Type -> (строка)

Указывает, относится ли квота к пользователю или группе.

Id -> (целое число)

Идентификатор пользователя или группы, на которую распространяется квота.

StorageCapacityQuotaGiB -> (целое число)

Квота хранилища пользователя или группы в гибибайтах (GiB).

RestoreToSnapshot -> (строка)

Указывает идентификатор снимка, к которому был восстановлен том.

DeleteIntermediateSnaphots -> (булево)

Булево значение, указывающее, должны ли снимки между текущим состоянием и указанным снимком быть удалены при восстановлении тома из снимка.

DeleteClonedVolumes -> (булево)

Булево значение, указывающее, должны ли быть удалены зависимые клонированные тома, созданные из промежуточных снимков, при восстановлении тома из снимка.

DeleteIntermediateData -> (булево)

Булево значение, указывающее, должны ли данные снимка, которые отличаются между текущим состоянием и указанным снимком, перезаписываться при восстановлении тома из снимка.

SourceSnapshotARN -> (строка)

Amazon Resource Name (ARN) для данного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. Нам необходим ARN, когда вам нужно однозначно указать ресурс во всей экосистеме Amazon Web Services. Дополнительные сведения см. в разделе Имена ресурсов Amazon (ARN) в Общей справке Amazon Web Services.

DestinationSnapshot -> (строка)

Идентификатор снимка, который копируется или был последним скопирован в целевой том.

CopyStrategy -> (строка)

Указывает стратегию, используемую при копировании данных со снимка на новый том.

  • CLONE — Новый том ссылается на данные в исходном снимке. Клонирование снимка быстрее, чем копирование данных со снимка на новый том и не потребляет пропускную способность диска. Однако исходный снимок нельзя удалить, если том использует скопированные данные.
  • FULL_COPY — Копирует все данные со снимка на новый том. Укажите этот параметр, чтобы создать том из снимка в другой файловой системе FSx for OpenZFS.

Примечание

Опция INCREMENTAL_COPY используется только для обновления существующего тома с помощью снимка из другой файловой системы FSx for OpenZFS. Дополнительные сведения см. в CopySnapshotAndUpdateVolume.

TargetSnapshotValues -> (структура)

Снимок тома Amazon FSx для OpenZFS.

ResourceARN -> (строка)

Идентификатор Amazon Resource Name (ARN) для данного ресурса. ARN однозначно идентифицируют ресурсы Amazon Web Services. Нам требуется ARN, когда необходимо однозначно указать ресурс во всей экосистеме Amazon Web Services. Для получения дополнительной информации см. Amazon Resource Names (ARNs) в Общие сведения об Amazon Web Services.

SnapshotId -> (строка)

Идентификатор снимка.

Name -> (строка)

Название снимка.

VolumeId -> (строка)

Идентификатор тома, для которого создан снимок.

CreationTime -> (метка времени)

Время создания ресурса, в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

Lifecycle -> (строка)

Статус жизненного цикла снимка.

  • PENDING - Amazon FSx еще не начал создание снимка.
  • CREATING - Amazon FSx создаёт снимок.
  • DELETING - Amazon FSx удаляет снимок.
  • AVAILABLE - Снимок полностью доступен.

LifecycleTransitionReason -> (структура)

Описание причины изменения состояния жизненного цикла ресурса.

Message -> (строка)

Подробное сообщение об ошибке.

Tags -> (список)

Список значений тегов, с максимальным количеством 50 элементов.

(структура)

Указывает пару ключ-значение для тега ресурса.

Key -> (строка)

Значение, определяющее TagKey , имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (строка)

Значение, определяющее TagValue , значение, присвоенное соответствующему ключу тега. Значения тегов могут быть null и не обязательно должны быть уникальными в наборе тегов. Например, вы можете иметь пару ключ-значение в наборе тегов finances : April и также payroll : April.

AdministrativeActions -> (список)

Список административных действий для файловой системы, которые находятся в процессе выполнения или ожидают обработки. Административные действия описывают изменения в системе Amazon FSx.

(структура)

Описывает конкретное административное действие Amazon FSx для текущей файловой системы или тома Windows, Lustre, OpenZFS или ONTAP.

AdministrativeActionType -> (строка)

Описание типа административного действия:

  • FILE_SYSTEM_UPDATE - Административное действие обновления файловой системы, инициированное из консоли Amazon FSx, API (UpdateFileSystem ) или командной строки (update-file-system ).
  • THROUGHPUT_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача THROUGHPUT_OPTIMIZATION. Вы можете отслеживать прогресс оптимизации хранилища, используя свойство ProgressPercent. После успешного завершения THROUGHPUT_OPTIMIZATION, статус родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED. Дополнительные сведения см. в руководстве пользователя Amazon FSx for Windows File Server по управлению пропускной способностью.
  • STORAGE_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению емкости хранилища файловой системы запускается задача STORAGE_OPTIMIZATION.
    • Для Windows и ONTAP оптимизация хранилища — это процесс миграции данных файловой системы на новые более крупные диски.
    • Для Lustre оптимизация хранилища заключается в перебалансировке данных между существующими и вновь добавленными файловыми серверами.

Вы можете отслеживать прогресс оптимизации хранилища, используя свойство ProgressPercent. После успешного завершения STORAGE_OPTIMIZATION, статус родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED. Дополнительные сведения см. в руководстве пользователя Amazon FSx для Windows File Server по управлению емкостью хранилища, в руководстве пользователя Amazon FSx для Lustre по управлению емкостью хранилища и выделенных IOPS в руководстве пользователя Amazon FSx для NetApp ONTAP.

  • FILE_SYSTEM_ALIAS_ASSOCIATION - Обновление файловой системы для добавления нового псевдонима доменного имени системы (DNS) к файловой системе. Дополнительные сведения см. в разделе AssociateFileSystemAliases.
  • FILE_SYSTEM_ALIAS_DISASSOCIATION - Обновление файловой системы для отключения псевдонима DNS от файловой системы. Дополнительные сведения см. в разделе DisassociateFileSystemAliases.
  • IOPS_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача IOPS_OPTIMIZATION. Вы можете отслеживать прогресс оптимизации хранилища, используя свойство ProgressPercent. После успешного завершения IOPS_OPTIMIZATION, статус родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED. Дополнительные сведения см. в руководстве пользователя Amazon FSx для Windows File Server по управлению выделенными IOPS SSD.
  • STORAGE_TYPE_OPTIMIZATION - После успешного завершения задачи FILE_SYSTEM_UPDATE по увеличению пропускной способности файловой системы запускается задача STORAGE_TYPE_OPTIMIZATION. Вы можете отслеживать прогресс оптимизации хранилища, используя свойство ProgressPercent. После успешного завершения STORAGE_TYPE_OPTIMIZATION, статус родительского действия FILE_SYSTEM_UPDATE изменяется на COMPLETED.
  • VOLUME_UPDATE - Обновление тома для тома Amazon FSx для OpenZFS, инициированное из консоли Amazon FSx, API (UpdateVolume ) или командной строки (update-volume ).
  • VOLUME_RESTORE - Возврат тома Amazon FSx для OpenZFS в состояние, сохраненное указанным снимком, инициированное с помощью API (RestoreVolumeFromSnapshot ) или командной строки (restore-volume-from-snapshot ).
  • SNAPSHOT_UPDATE - Обновление снимка для тома Amazon FSx для OpenZFS, инициированное из консоли Amazon FSx, API (UpdateSnapshot ) или командной строки (update-snapshot ).
  • RELEASE_NFS_V3_LOCKS - Отслеживает освобождение блокировок NFS V3 в файловой системе Amazon FSx для OpenZFS.
  • DOWNLOAD_DATA_FROM_BACKUP - Восстановление резервной копии FSx для ONTAP в новый том на файловой системе второго поколения. После загрузки всех метаданных файлов в том вы можете подключить том с чтением только для чтения. В процессе этого.
  • VOLUME_INITIALIZE_WITH_SNAPSHOT - Создание тома из снимка на другой файловой системе FSx для OpenZFS. Вы можете инициировать это из консоли Amazon FSx, API (CreateVolume ) или командной строки (create-volume ), используя стратегию FULL_COPY.
  • VOLUME_UPDATE_WITH_SNAPSHOT - Обновление тома из снимка на другой файловой системе FSx для OpenZFS. Вы можете инициировать это из консоли Amazon FSx, API (CopySnapshotAndUpdateVolume ) или командной строки (copy-snapshot-and-update-volume).

ProgressPercent -> (целое число)

Процент завершения административного действия STORAGE_OPTIMIZATION или DOWNLOAD_DATA_FROM_BACKUP. Не применяется к другим типам административных действий.

RequestTime -> (метка времени)

Время получения запроса на административное действие.

Status -> (строка)

Статус административного действия:

  • FAILED - Amazon FSx не смог успешно обработать административное действие.
  • IN_PROGRESS - Amazon FSx обрабатывает административное действие.
  • PENDING - Amazon FSx ожидает обработки административного действия.
  • COMPLETED - Amazon FSx завершил обработку административной задачи. Для восстановления резервной копии до файловой системы FSx для ONTAP второго поколения указывает, что все данные были загружены в том, и клиенты теперь имеют доступ к тому для чтения и записи.
  • UPDATED_OPTIMIZING - Для обновления с увеличением емкости хранилища Amazon FSx обновил файловую систему до новой емкости хранилища и теперь выполняет процесс оптимизации хранилища.
  • PENDING - Для восстановления резервной копии до файловой системы FSx для ONTAP второго поколения указывает, что метаданные файла загружаются в том. Состояние жизненного цикла тома — CREATING.
  • IN_PROGRESS - Для восстановления резервной копии до файловой системы FSx для ONTAP второго поколения указывает, что все метаданные загружены в новый том, и клиенты могут получить доступ к данным только для чтения, в то время как Amazon FSx загружает данные файла в том. Следите за прогрессом этого процесса с помощью элемента ProgressPercent.

TargetFileSystemValues -> (структура)

Целевое значение для административного действия, предоставленное в операции UpdateFileSystem. Возвращается для административных действий FILE_SYSTEM_UPDATE.

OwnerId -> (строка)

Учетная запись Amazon Web Services, создавшая файловую систему. Если файловая система была создана пользователем в IAM Identity Center, учетная запись Amazon Web Services, к которой принадлежит IAM-пользователь, является владельцем.

CreationTime -> (отметка времени)

Время создания файловой системы в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

FileSystemId -> (строка)

Сгенерированный системой уникальный 17-значный идентификатор файловой системы.

FileSystemType -> (строка)

Тип файловой системы Amazon FSx, который может быть LUSTRE , WINDOWS , ONTAP или OPENZFS.

Lifecycle -> (строка)

Статус жизненного цикла файловой системы. Следующие являются возможными значениями и их значениями:

  • AVAILABLE - Файловая система находится в исправном состоянии, доступна и готова к использованию.
  • CREATING - Amazon FSx создает новую файловую систему.
  • DELETING - Amazon FSx удаляет существующую файловую систему.
  • FAILED - Существующая файловая система столкнулась с невосстановимой ошибкой. При создании новой файловой системы Amazon FSx не смог создать файловую систему.
  • MISCONFIGURED - Файловая система находится в состоянии ошибки, но восстанавливаемом.
  • MISCONFIGURED_UNAVAILABLE - (Только Amazon FSx для Windows File Server) Файловая система в настоящее время недоступна из-за изменения конфигурации Active Directory.
  • UPDATING - Файловая система проходит обновление, инициированное пользователем.

FailureDetails -> (структура)

Структура, предоставляющая подробности любых возникших ошибок.

Message -> (строка)

Сообщение, описывающее любые возникшие ошибки.

StorageCapacity -> (целое число)

Ёмкость хранилища файловой системы в гибибайтах (GiB).

Amazon FSx отвечает кодом состояния HTTP 400 (Ошибка запроса), если значение StorageCapacity выходит за пределы минимальных или максимальных значений.

StorageType -> (строка)

Тип хранилища, используемого файловой системой. Если установлено значение SSD, файловая система использует хранилище твердотельных накопителей. Если установлено значение HDD, файловая система использует хранилище жёстких дисков.

VpcId -> (строка)

Идентификатор основной виртуальной частной сети (VPC) для файловой системы.

SubnetIds -> (список)

Указывает идентификаторы подсетей, с которых доступна файловая система. Для развертывания файловой системы Amazon FSx Windows и ONTAP MULTI_AZ_1 , существуют два идентификатора подсетей, один для предпочтительного файлового сервера и один для резервного файлового сервера. Предпочтительная подсеть файлового сервера указана в свойстве PreferredSubnetID. Все остальные файловые системы имеют только один идентификатор подсети.

Для файловых систем FSx для Lustre и файловых систем Windows с одной зоной доступности это идентификатор подсети, содержащей конечную точку файловой системы. Для файловых систем MULTI_AZ_1 Windows и ONTAP конечная точка файловой системы доступна в PreferredSubnetID.

(строка)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашей виртуальной частной сети (VPC). Дополнительную информацию см. в руководстве по VPC и подсетям Amazon VPC User Guide.

NetworkInterfaceIds -> (список)

Идентификаторы сетевых интерфейсов, с которых доступна конкретная файловая система. Сетевой интерфейс автоматически создается в той же виртуальной частной сети (VPC), в которой была создана файловая система Amazon FSx. Дополнительную информацию см. в руководстве по сетевым интерфейсам Amazon EC2 User Guide.

Для файловой системы Amazon FSx для Windows File Server может быть один идентификатор сетевого интерфейса. Для файловой системы Amazon FSx для Lustre может быть более одного.

(строка)

Идентификатор сетевого интерфейса. Сетевой интерфейс — это логический сетевой компонент в виртуальной частной сети (VPC), представляющий виртуальную сетевую карту. Дополнительную информацию см. в руководстве по сетевым интерфейсам Amazon EC2 User Guide for Linux Instances.

DNSName -> (строка)

Имя доменной системы (DNS) для файловой системы.

KmsKeyId -> (строка)

Идентификатор ключа службы управления ключами (KMS), используемого для шифрования данных файловой системы Amazon FSx. Используется следующим образом с типами файловых систем Amazon FSx:

  • Amazon FSx для Lustre PERSISTENT_1 и PERSISTENT_2 типы развертывания только. SCRATCH_1 и SCRATCH_2 типы зашифрованы с помощью ключа KMS службы Amazon FSx для вашей учетной записи.
  • Amazon FSx для NetApp ONTAP
  • Amazon FSx для OpenZFS
  • Amazon FSx для Windows File Server

ResourceARN -> (строка)

Amazon Resource Name (ARN) ресурса файловой системы.

Tags -> (список)

Теги для присвоения файловой системе. Дополнительную информацию см. в разделе Маркировка ресурсов Amazon FSx в руководстве пользователя Amazon FSx для Lustre.

(структура)

Указывает пару ключ-значение для тега ресурса.

Key -> (строка)

Значение, определяющее TagKey , имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (строка)

Значение, определяющее TagValue , значение, назначенное соответствующему ключу тега. Значения тегов могут быть null и не обязаны быть уникальными в наборе тегов. Например, вы можете иметь пару ключ-значение в наборе тегов finances : April и также payroll : April.

WindowsConfiguration -> (структура)

Настройка этого файлового сервера Amazon FSx для Windows.

ActiveDirectoryId -> (строка)

Идентификатор существующего управляемого Microsoft Active Directory экземпляра Amazon Web Services, к которому подключён файловый сервер.

SelfManagedActiveDirectoryConfiguration -> (структура)

Настройка домена самообслуживаемого Microsoft Active Directory (AD), к которому подключен экземпляр Windows File Server или ONTAP виртуальной машины хранилища (SVM).

DomainName -> (строка)

Полное доменное имя самообслуживаемого AD домена.

OrganizationalUnitDistinguishedName -> (строка)

Полное различающее имя организационной единицы в самообслуживаемом AD домене, к которому подключен экземпляр Windows File Server или ONTAP виртуальной машины хранилища (SVM).

FileSystemAdministratorsGroup -> (строка)

Имя доменной группы, члены которой имеют административные привилегии для файловой системы FSx.

UserName -> (строка)

Имя пользователя учетной записи службы в вашем самообслуживаемом AD домене, которую FSx использует для подключения к вашему AD домену.

DnsIps -> (список)

Список из до трех IP-адресов DNS-серверов или контроллеров домена в самообслуживаемом AD домене.

(строка)

DeploymentType -> (строка)

Указывает тип развертывания файловой системы, допустимые значения:

  • MULTI_AZ_1 - Указывает файловую систему с высокой доступностью, настроенную для многозонной избыточности, чтобы переносить временную недоступность зоны доступности (AZ), поддерживает SSD и HDD хранилища.
  • SINGLE_AZ_1 - (По умолчанию) Указывает файловую систему, настроенную для однозонной избыточности, поддерживает только SSD хранилища.
  • SINGLE_AZ_2 - Файловая система последнего поколения с однозонной избыточностью. Указывает файловую систему, настроенную для однозонной избыточности и поддерживает SSD и HDD хранилища.

Для получения дополнительной информации см. Однозонные и многозонные файловые системы .

RemoteAdministrationEndpoint -> (строка)

Для типов развертывания MULTI_AZ_1 используйте этот конечный пункт при выполнении административных задач на файловой системе с помощью Amazon FSx Remote PowerShell.

Для типов развертывания SINGLE_AZ_1 и SINGLE_AZ_2 это имя DNS файловой системы.

Этот конечный пункт временно недоступен во время проведения технического обслуживания файловой системы.

PreferredSubnetId -> (строка)

Для типов развертывания MULTI_AZ_1 он указывает идентификатор подсети, где расположен предпочтительный файловый сервер. Должен быть одним из двух идентификаторов подсети, указанных в свойстве SubnetIds. Amazon FSx передает трафик из этой подсети, за исключением случаев переключения на резервный файловый сервер.

Для типов развертывания SINGLE_AZ_1 и SINGLE_AZ_2 это значение совпадает с тем, что для SubnetIDs. Для получения дополнительной информации см. Доступность и долговечность: однозонные и многозонные файловые системы .

PreferredFileServerIp -> (строка)

Для типов развертывания MULTI_AZ_1 IP-адрес первичного или предпочтительного файлового сервера.

Используйте этот IP-адрес при подключении файловой системы к клиентам SMB на Linux или Windows SMB, которые не подключены к Microsoft Active Directory. Применимо ко всем типам развертывания файловой системы Windows. Этот IP-адрес временно недоступен во время проведения технического обслуживания файловой системы. Для клиентов Linux и Windows SMB, подключенных к Active Directory, используйте имя DNS файловой системы вместо этого. Для получения дополнительной информации о подключении и подключении к файловым ресурсам см. Доступ к файловым ресурсам .

ThroughputCapacity -> (целое число)

Пропускная способность файловой системы Amazon FSx, измеряемая в мегабайтах в секунду.

MaintenanceOperationsInProgress -> (список)

Список операций технического обслуживания, которые выполняются для этой файловой системы.

(строка)

Перечисление, определяющее текущую выполняемую операцию технического обслуживания.

WeeklyMaintenanceStartTime -> (строка)

Предпочтительное время начала еженедельного технического обслуживания, отформатированное как d:HH:MM в часовом поясе UTC. d — это номер дня недели, от 1 до 7, начиная с понедельника и заканчивая воскресеньем.

DailyAutomaticBackupStartTime -> (строка)

Предпочтительное время для выполнения ежедневных автоматических резервных копий в часовом поясе UTC.

AutomaticBackupRetentionDays -> (целое число)

Количество дней для хранения автоматических резервных копий. Установка значения 0 отключает автоматические резервные копии. Вы можете хранить автоматические резервные копии не более 90 дней.

CopyTagsToBackups -> (булево)

Флаг булевого типа, указывающий, должны ли теги файловой системы копироваться в резервные копии. По умолчанию значение равно false. Если значение равно true, все теги файловой системы копируются во все автоматические резервные копии и в любые созданные пользователем резервные копии, где пользователь не указывает теги. Если это значение равно true, и вы указываете один или несколько тегов, копируются только указанные теги. Если вы указываете один или несколько тегов при создании резервной копии пользователем, теги не копируются из файловой системы, независимо от этого значения.

Aliases -> (список)

Массив из одного или нескольких DNS псевдонимов, которые в настоящее время связаны с файловой системой Amazon FSx. Псевдонимы позволяют использовать существующие имена DNS для доступа к данным в вашей файловой системе Amazon FSx. Вы можете связать до 50 псевдонимов с файловой системой в любое время. Вы можете связать дополнительные DNS псевдонимы после создания файловой системы с помощью операции AssociateFileSystemAliases. Вы можете удалить DNS псевдонимы из файловой системы после ее создания с помощью операции DisassociateFileSystemAliases. Вам нужно указать только имя псевдонима в содержимом запроса. Для получения дополнительной информации см. DNS псевдонимы .

(структура)

DNS псевдоним, связанный с файловой системой. Вы можете использовать DNS псевдоним для доступа к файловой системе с помощью определенных пользователем имен DNS, помимо имени DNS по умолчанию, назначенного файловой системе Amazon FSx. Для получения дополнительной информации см. DNS псевдонимы в руководстве пользователя FSx для Windows File Server .

Name -> (строка)

Имя DNS псевдонима. Имя псевдонима должно соответствовать следующим требованиям:

  • Форматировано как полное доменное имя (FQDN), hostname.domain , например, accounting.example.com .
  • Может содержать буквенно-цифровые символы, символ подчеркивания (_) и дефис (-).
  • Не может начинаться или заканчиваться дефисом.
  • Может начинаться с цифры.

Для имён DNS Amazon FSx хранит буквенные символы в нижнем регистре (a-z), независимо от того, как вы их указываете: как прописные буквы, строчные буквы или соответствующие буквы в кодах экранирования.

Lifecycle -> (строка)

Описывает состояние DNS псевдонима.

  • AVAILABLE - DNS псевдоним связан с файловой системой Amazon FSx.
  • CREATING - Amazon FSx создает DNS псевдоним и связывает его с файловой системой.
  • CREATE_FAILED - Amazon FSx не смог связать DNS псевдоним с файловой системой.
  • DELETING - Amazon FSx отсоединяет DNS псевдоним от файловой системы и удаляет его.
  • DELETE_FAILED - Amazon FSx не смог отсоединить DNS псевдоним от файловой системы.

AuditLogConfiguration -> (структура)

Настройка, которую Amazon FSx для Windows File Server использует для аудита и протоколирования доступа пользователей к файлам, папкам и сетевым ресурсам на файловой системе Amazon FSx для Windows File Server.

FileAccessAuditLogLevel -> (строка)

Определяет, какие типы попыток доступа к файлам и папкам регистрирует Amazon FSx.

  • SUCCESS_ONLY - регистрируются только успешные попытки доступа к файлам или папкам.
  • FAILURE_ONLY - регистрируются только неудачные попытки доступа к файлам или папкам.
  • SUCCESS_AND_FAILURE - регистрируются как успешные, так и неудачные попытки доступа к файлам или папкам.
  • DISABLED - аудит доступа к файлам и папкам отключен.

FileShareAccessAuditLogLevel -> (строка)

Определяет, какие типы попыток доступа к сетевым ресурсам регистрирует Amazon FSx.

  • SUCCESS_ONLY - регистрируются только успешные попытки доступа к сетевым ресурсам.
  • FAILURE_ONLY - регистрируются только неудачные попытки доступа к сетевым ресурсам.
  • SUCCESS_AND_FAILURE - регистрируются как успешные, так и неудачные попытки доступа к сетевым ресурсам.
  • DISABLED - аудит доступа к сетевым ресурсам отключен.

AuditLogDestination -> (строка)

Amazon Resource Name (ARN) назначения журналов аудита. Назначение может быть любым ARN группы журналов Amazon CloudWatch Logs или потока доставки Amazon Kinesis Data Firehose.

Имя группы журналов Amazon CloudWatch Logs должно начинаться с префикса /aws/fsx. Имя потока доставки Amazon Kinesis Data Firehose должно начинаться с префикса aws-fsx.

ARN назначения (либо группа журналов CloudWatch Logs, либо поток доставки Kinesis Data Firehose) должен находиться в той же облачной платформе Amazon Web Services, регионе Amazon Web Services и учетной записи Amazon Web Services, что и ваша файловая система Amazon FSx.

DiskIopsConfiguration -> (структура)

Настройка SSD IOPS (операций ввода/вывода в секунду) для файловой системы Amazon FSx для Windows. По умолчанию Amazon FSx автоматически предоставляет 3 IOPS на каждый Гигабайт емкости хранилища. Вы можете предоставить дополнительные IOPS на каждый Гигабайт хранилища, до максимального предела, связанного с выбранной пропускной способностью.

Mode -> (строка)

Указывает, использует ли файловая система настройку AUTOMATIC SSD IOPS в 3 IOPS на каждый ГБ емкости хранилища, или использует значение USER_PROVISIONED.

Iops -> (целое число)

Общее количество SSD IOPS, предоставленных для файловой системы.

Минимальные и максимальные значения для этого свойства зависят от значения HAPairs и StorageCapacity. Минимальное значение вычисляется как StorageCapacity * 3 * HAPairs (3 IOPS на каждый ГБ StorageCapacity). Максимальное значение вычисляется как 200000 * HAPairs.

Amazon FSx возвращает HTTP-код состояния 400 (Неверный запрос), если значение Iops находится вне минимального или максимального значения.

LustreConfiguration -> (структура)

Настройка файловой системы Amazon FSx for Lustre.

WeeklyMaintenanceStartTime -> (строка)

Предпочтительное время проведения еженедельного технического обслуживания, отформатированное как д:ЧЧ:ММ в часовом поясе UTC. Здесь d — номер дня недели от 1 до 7, начиная с понедельника и заканчивая воскресеньем.

DataRepositoryConfiguration -> (структура)

Объект конфигурации хранилища данных для файловых систем Lustre, возвращаемый в ответе операции CreateFileSystem.

Этот тип данных не поддерживается для файловых систем с ассоциированным хранилищем данных. Для файловых систем с ассоциированным хранилищем данных см. .

Lifecycle -> (строка)

Описывает состояние хранилища S3 с долговременными данными файловой системы, если оно настроено с хранилищем S3. Жизненный цикл может иметь следующие значения:

  • CREATING — настройка хранилища данных между файловой системой FSx и связанным хранилищем данных S3 создается. Хранилище данных недоступно.
  • AVAILABLE — хранилище данных доступно для использования.
  • MISCONFIGURED — Amazon FSx не может автоматически импортировать обновления из ведра S3, пока конфигурация хранилища данных не будет исправлена. Для получения дополнительной информации см. Устранение неполадок некорректно настроенного связанного ведра S3.
  • UPDATING — хранилище данных проходит обновление, инициированное пользователем, и доступность может быть затронута.
  • FAILED — хранилище данных находится в терминальном состоянии, из которого нельзя восстановиться.

ImportPath -> (строка)

Путь импорта к ведру Amazon S3 (и (необязательному) префиксу), которое вы используете в качестве хранилища данных для своей файловой системы FSx for Lustre, например, s3://import-bucket/optional-prefix. Если после имени ведра Amazon S3 указан префикс, в файловую систему загружаются только ключи объектов с этим префиксом.

ExportPath -> (строка)

Путь экспорта к ведру Amazon S3 (и префиксу), которое вы используете для хранения новых и изменённых файлов файловой системы Lustre в S3.

ImportedFileChunkSize -> (целое число)

Для файлов, импортированных из хранилища данных, это значение определяет количество полос и максимальный объем данных на файл (в МБ), хранящихся на одном физическом диске. Максимальное количество дисков, на которые может быть распределён один файл, ограничено общим количеством дисков, образующих файловую систему.

Размер фрагмента по умолчанию составляет 1024 МБ (1 ГБ) и может достигать 512 000 МБ (500 ГБ). Объекты Amazon S3 имеют максимальный размер 5 ТБ.

AutoImportPolicy -> (строка)

Описывает AutoImportPolicy связанного хранилища данных S3 файловой системы. Параметр AutoImportPolicy настраивает, как Amazon FSx поддерживает актуальность списков файлов и каталогов при добавлении или изменении объектов в связанном ведре S3. AutoImportPolicy может иметь следующие значения:

  • NONE — (По умолчанию) Автоимпорт отключён. Amazon FSx обновляет списки файлов и каталогов из связанного ведра S3 только при создании файловой системы. После выбора этого параметра FSx не обновляет списки файлов и каталогов для новых или изменённых объектов.
  • NEW — Автоимпорт включён. Amazon FSx автоматически импортирует списки каталогов любых новых объектов, добавленных в связанное ведро S3 и которых нет в файловой системе FSx.
  • NEW_CHANGED — Автоимпорт включён. Amazon FSx автоматически импортирует списки файлов и каталогов любых новых объектов, добавленных в ведро S3, и любых существующих объектов, которые были изменены в ведре S3 после выбора этого параметра.
  • NEW_CHANGED_DELETED — Автоимпорт включён. Amazon FSx автоматически импортирует списки файлов и каталогов любых новых объектов, добавленных в ведро S3, любых существующих объектов, которые были изменены в ведре S3, и любых объектов, которые были удалены из ведра S3.

FailureDetails -> (структура)

Предоставляет подробную информацию о хранилище данных, если его Lifecycle установлено в MISCONFIGURED или FAILED.

Message -> (строка)

Подробное сообщение об ошибке.

DeploymentType -> (строка)

Тип развертывания файловой системы FSx for Lustre. Тип развертывания «Рабочая папка» предназначен для временного хранения и обработки данных в краткосрочной перспективе.

SCRATCH_1 и SCRATCH_2 типы развертывания лучше всего подходят, когда вам необходимо временное хранилище и краткосрочная обработка данных. Тип развертывания SCRATCH_2 обеспечивает шифрование данных в процессе передачи и более высокую пропускную способность всплесков, чем SCRATCH_1.

Тип развертывания PERSISTENT_1 и PERSISTENT_2 используется для долгосрочного хранения и рабочих нагрузок и шифрования данных в процессе передачи. PERSISTENT_2 обеспечивает более высокую PerUnitStorageThroughput (до 1000 МБ/с/ТиБ) вместе с меньшим минимальным объемом хранилища (600 ГБ). Чтобы узнать больше о типах развертывания FSx for Lustre, см. Варианты развертывания FSx for Lustre.

По умолчанию — SCRATCH_1.

PerUnitStorageThroughput -> (целое число)

Пропускная способность хранилища на единицу объема соответствует пропускной способности чтения или записи в мегабайтах в секунду на 1 терабайт предоставленного хранилища. Емкость пропускной способности файловой системы равна объему хранилища (ТиБ) * PerUnitStorageThroughput (МБ/с/ТиБ). Этот параметр действителен только для типов развертывания PERSISTENT_1 и PERSISTENT_2.

Допустимые значения:

  • Для хранилища PERSISTENT_1 SSD: 50, 100, 200.
  • Для хранилища PERSISTENT_1 HDD: 12, 40.
  • Для хранилища PERSISTENT_2 SSD: 125, 250, 500, 1000.

MountName -> (строка)

Значение MountName используется при подключении файловой системы.

Для типа развертывания SCRATCH_1 это значение всегда «fsx». Для типов развертывания SCRATCH_2, PERSISTENT_1 и PERSISTENT_2 это значение является строкой, уникальной в пределах региона Amazon Web Services.

DailyAutomaticBackupStartTime -> (строка)

Ежедневное повторяющееся время в формате HH:MM. HH — это заполненное нулями число часа (0-23), а MM — это заполненное нулями число минуты часа. Например, 05:00 соответствует 5:00 ежедневно.

AutomaticBackupRetentionDays -> (целое число)

Количество дней хранения автоматических резервных копий. Установка этого свойства в 0 отключает автоматические резервные копии. Вы можете хранить автоматические резервные копии в течение максимум 90 дней. По умолчанию — 30.

CopyTagsToBackups -> (логическое значение)

Логический флаг, указывающий, копируются ли теги файловой системы в резервные копии. Если значение равно true, все теги файловой системы копируются во все автоматические резервные копии и в любые резервные копии, инициированные пользователем, где пользователь не указывает теги. Если это значение равно true, и вы указываете один или несколько тегов, копируются только указанные теги. Если вы указываете один или несколько тегов при создании резервной копии, инициированной пользователем, теги не копируются из файловой системы, независимо от этого значения. (По умолчанию = false)

DriveCacheType -> (строка)

Тип кэша дисков, используемый файловыми системами PERSISTENT_1, которые настроены с устройствами хранения HDD. Этот параметр обязателен, когда StorageType установлен в HDD. При установке значения READ файловая система имеет кэш хранилища SSD, размер которого составляет 20% от объема хранилища файловой системы. Это повышает производительность часто используемых файлов, кэшируя до 20% от общего объема хранилища.

Этот параметр обязателен, когда StorageType установлен в HDD.

DataCompressionType -> (строка)

Настройка сжатия данных для файловой системы. DataCompressionType может иметь следующие значения:

  • NONE — Сжатие данных выключено для файловой системы.
  • LZ4 — Сжатие данных включено с алгоритмом LZ4.

Дополнительную информацию см. в разделе Сжатие данных Lustre.

LogConfiguration -> (структура)

Конфигурация ведения журнала Lustre. Ведение журнала Lustre записывает разрешённые события журнала вашей файловой системы в Amazon CloudWatch Logs.

Level -> (строка)

События хранилища данных, регистрируемые Amazon FSx.

  • WARN_ONLY — регистрируются только предупреждения.
  • ERROR_ONLY — регистрируются только ошибки.
  • WARN_ERROR — регистрируются как предупреждения, так и ошибки.
  • DISABLED — регистрация событий хранилища данных отключена.

Обратите внимание, что Amazon File Cache использует значение по умолчанию WARN_ERROR, которое нельзя изменить.

Destination -> (строка)

Идентификатор ресурса Amazon (ARN), определяющий место назначения журналов. Местом назначения может быть любой ARN группы журналов Amazon CloudWatch Logs. ARN места назначения должен находиться в той же области, регионе и учетной записи Amazon Web Services, что и ваша файловая система Amazon FSx.

RootSquashConfiguration -> (структура)

Конфигурация сжатия корневого пользователя Lustre для файловой системы Amazon FSx for Lustre. При включении сжатия корневого пользователя ограничивается доступ на уровне root от клиентов, которые пытаются получить доступ к вашей файловой системе в качестве пользователя root.

RootSquash -> (строка)

Сжатие корневого пользователя можно включить, установив идентификатор пользователя (UID) и идентификатор группы (GID) для файловой системы в формате UID:GID (например, 365534:65534). Значения UID и GID могут изменяться от 0 до 4294967294:

  • Неноль значение для UID и GID включает сжатие корневого пользователя. Значения UID и GID могут отличаться, но каждое должно быть отличным от нуля.
  • Значение 0 (ноль) для UID и GID означает root и, следовательно, отключает сжатие корневого пользователя.

При включении сжатия корневого пользователя идентификатор пользователя и идентификатор группы пользователя root, обращающегося к файловой системе, сопоставляются с указанными вами UID и GID.

NoSquashNids -> (список)

При включенном сжатии корневого пользователя можно необязательно указать массив NID клиентов, для которых сжатие корневого пользователя не применяется. NID клиента — это идентификатор сети Lustre, используемый для уникальной идентификации клиента. Вы можете указать NID как один адрес или диапазон адресов:

  • Один адрес описывается в стандартном формате NID Lustre, указав IP-адрес клиента и идентификатор сети Lustre (например, 10.0.1.6@tcp).
  • Диапазон адресов описывается с помощью дефиса для разделения диапазона (например, 10.0.[2-10].[1-255]@tcp).

(строка)

MetadataConfiguration -> (структура)

Конфигурация производительности метаданных Lustre для файловой системы Amazon FSx для Lustre с типом развертывания PERSISTENT_2.

Iops -> (целое число)

Количество метаданных IOPS, выделенных для файловой системы. Допустимые значения — 1500 , 3000 , 6000 , 12000 и кратные 12000 до максимального значения 192000 .

Mode -> (строка)

Режим конфигурации метаданных для выделения метаданных IOPS для файловой системы.

  • В режиме AUTOMATIC, FSx для Lustre автоматически выделяет и масштабирует количество метаданных IOPS в вашей файловой системе на основе емкости хранилища вашей файловой системы.
  • В режиме USER_PROVISIONED вы можете указать количество метаданных IOPS, которые нужно выделить для вашей файловой системы.

EfaEnabled -> (булево)

Указывает, включена ли поддержка Elastic Fabric Adapter (EFA) и GPUDirect Storage (GDS) для файловой системы Amazon FSx для Lustre.

OntapConfiguration -> (структура)

Конфигурация для этой файловой системы Amazon FSx для NetApp ONTAP.

AutomaticBackupRetentionDays -> (целое число)

Количество дней, в течение которых необходимо сохранять автоматические резервные копии. Установка этого свойства в значение 0 отключает автоматические резервные копии. Вы можете хранить автоматические резервные копии не более 90 дней. По умолчанию — 30 .

DailyAutomaticBackupStartTime -> (строка)

Ежедневное повторяющееся время в формате HH:MM . HH — это заполненное нулями число часа (0-23), а MM — заполненное нулями число минуты. Например, 05:00 — это 5:00 каждый день.

DeploymentType -> (строка)

Указывает тип развертывания файловой системы FSx для ONTAP, используемый в файловой системе.

  • MULTI_AZ_1 — файловая система с высокой доступностью, настроенная на отказоустойчивость Multi-AZ для перерывов в работе зоны доступности (AZ). Это файловая система первого поколения FSx для ONTAP.
  • MULTI_AZ_2 — файловая система с высокой доступностью, настроенная на отказоустойчивость Multi-AZ для перерывов в работе зоны доступности (AZ). Это файловая система второго поколения FSx для ONTAP.
  • SINGLE_AZ_1 — файловая система, настроенная на отказоустойчивость Single-AZ. Это файловая система первого поколения FSx для ONTAP.
  • SINGLE_AZ_2 — файловая система, настроенная с несколькими парами высокой доступности (HA) для отказоустойчивости Single-AZ. Это файловая система второго поколения FSx для ONTAP.

Дополнительную информацию о вариантах использования развертываний Multi-AZ и Single-AZ см. в разделе Выбор развертывания файловой системы Multi-AZ или Single-AZ.

EndpointIpAddressRange -> (строка)

(Только Multi-AZ) Указывает диапазон IP-адресов, в котором будут созданы конечные точки для доступа к вашей файловой системе. По умолчанию в API Amazon FSx Amazon FSx выбирает для вас неиспользуемый диапазон IP-адресов из диапазона 198.19.*. По умолчанию в консоли Amazon FSx Amazon FSx выбирает последние 64 IP-адреса из основного диапазона CIDR VPC, чтобы использовать их в качестве диапазона IP-адресов конечной точки для файловой системы. У вас могут быть перекрывающиеся IP-адреса конечных точек для файловых систем, развернутых в одной VPC/таблицах маршрутизации.

Endpoints -> (структура)

Конечные точки Management и Intercluster, используемые для доступа к данным или управления файловой системой с помощью NetApp ONTAP CLI, REST API или NetApp SnapMirror.

Intercluster -> (структура)

Конечная точка для управления вашей файловой системой путем настройки NetApp SnapMirror с другими системами ONTAP.

DNSName -> (строка)

Имя DNS файловой системы. Вы можете подключиться к файловой системе, используя ее имя DNS.

IpAddresses -> (список)

IP-адреса конечной точки файловой системы.

(строка)

Management -> (структура)

Конечная точка для управления вашей файловой системой с помощью NetApp ONTAP CLI и NetApp ONTAP API.

DNSName -> (строка)

Имя DNS файловой системы. Вы можете подключиться к файловой системе, используя ее имя DNS.

IpAddresses -> (список)

IP-адреса конечной точки файловой системы.

(строка)

DiskIopsConfiguration -> (структура)

Конфигурация IOPS SSD для файловой системы ONTAP, определяющая количество выделенных IOPS и режим выделения.

Mode -> (строка)

Указывает, использует ли файловая система значение AUTOMATIC для IOPS SSD — 3 IOPS на каждый ГБ емкости хранилища, или используется значение USER_PROVISIONED.

Iops -> (длинное целое число)

Общее количество IOPS SSD, выделенных для файловой системы.

Минимальные и максимальные значения для этого свойства зависят от значений HAPairs и StorageCapacity . Минимальное значение вычисляется как StorageCapacity * 3 * HAPairs (3 IOPS на каждый ГБ емкости StorageCapacity ). Максимальное значение вычисляется как 200 000 * HAPairs .

Amazon FSx возвращает HTTP-код состояния 400 (Bad Request), если значение Iops выходит за пределы минимального или максимального значений.

PreferredSubnetId -> (строка)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашей виртуальной частной сети (VPC). Дополнительную информацию см. в разделе VPC и подсети в Руководстве пользователя Amazon VPC.

RouteTableIds -> (список)

(Только Multi-AZ) Таблицы маршрутизации VPC, в которых создаются конечные точки вашей файловой системы.

(строка)

ThroughputCapacity -> (целое число)

Непрерывная пропускная способность файловой системы Amazon FSx в мегабайтах в секунду (MBps).

WeeklyMaintenanceStartTime -> (строка)

Еженедельное повторяющееся время в формате D:HH:MM .

D — это день недели, где 1 — понедельник, а 7 — воскресенье. Дополнительную информацию см. в спецификации ISO-8601 на Википедии.

HH — это заполненное нулями число часа (0-23), а MM — заполненное нулями число минуты.

Например, 1:05:00 указывает техническое обслуживание в 5:00 понедельника.

FsxAdminPassword -> (строка)

Вы можете использовать учетную запись пользователя fsxadmin для доступа к NetApp ONTAP CLI и REST API. Значение пароля всегда замаскировано в ответе.

HAPairs -> (целое число)

Указывает количество пар серверов файловой системы высокой доступности (HA), которые будет иметь файловая система. Значение по умолчанию — 1. Значение этого свойства влияет на значения StorageCapacity , Iops и ThroughputCapacity . Дополнительную информацию см. в руководстве пользователя FSx для ONTAP в разделе Пара высокой доступности (HA).

Amazon FSx возвращает HTTP-код состояния 400 (Bad Request) в следующих случаях:

  • Значение HAPairs меньше 1 или больше 12.
  • Значение HAPairs больше 1, а значение DeploymentType равно SINGLE_AZ_1 , MULTI_AZ_1 или MULTI_AZ_2 .

ThroughputCapacityPerHAPair -> (целое число)

Используйте для выбора пропускной способности на каждую пару высокой доступности (HA). Когда значение HAPairs равно 1, значение ThroughputCapacityPerHAPair — это общая пропускная способность файловой системы.

Это поле и ThroughputCapacity не могут быть определены в одном вызове API, но одно из них требуется.

Это поле и ThroughputCapacity одинаковы для файловых систем с одной парой высокой доступности.

  • Для файловых систем SINGLE_AZ_1 и MULTI_AZ_1 допустимые значения — 128, 256, 512, 1024, 2048 или 4096 Мбит/с.
  • Для SINGLE_AZ_2 допустимые значения — 1536, 3072 или 6144 Мбит/с.
  • Для MULTI_AZ_2 допустимые значения — 384, 768, 1536, 3072 или 6144 Мбит/с.

Amazon FSx возвращает HTTP-код состояния 400 (Bad Request) в следующих случаях:

  • Значения ThroughputCapacity и ThroughputCapacityPerHAPair не совпадают.
  • Значение типа развертывания — SINGLE_AZ_2 , а ThroughputCapacity / ThroughputCapacityPerHAPair — это не допустимая пара высокой доступности (значение от 1 до 12).
  • Значение ThroughputCapacityPerHAPair не является допустимым.

FileSystemTypeVersion -> (строка)

Версия Lustre файловой системы Amazon FSx для Lustre, которая может быть 2.10 , 2.12 или 2.15 .

OpenZFSConfiguration -> (структура)

Настройка этого файлового сервера Amazon FSx for OpenZFS.

AutomaticBackupRetentionDays -> (целое число)

Количество дней хранения автоматических резервных копий. Установка этого свойства в значение 0 отключает автоматические резервные копии. Вы можете хранить автоматические резервные копии не более 90 дней. По умолчанию значение 30 .

CopyTagsToBackups -> (булево)

Булево значение, указывающее, следует ли копировать теги файлового сервера в резервные копии. Если значение равно true, все теги файлового сервера копируются во все автоматические резервные копии и в любые резервные копии, инициированные пользователем, где пользователь не указывает теги. Если это значение равно true, и вы указываете один или несколько тегов, то только указанные теги копируются в резервные копии. Если вы указываете один или несколько тегов при создании резервной копии, инициированной пользователем, теги не копируются с файлового сервера, независимо от этого значения.

CopyTagsToVolumes -> (булево)

Булево значение, указывающее, следует ли копировать теги тома в снимки. По умолчанию это значение равно false. Если это значение равно true, все теги тома копируются в снимки, где пользователь не указывает теги. Если это значение равно true, и вы указываете один или несколько тегов, то только указанные теги копируются в снимки. Если вы указываете один или несколько тегов при создании снимка, теги не копируются с тома, независимо от этого значения.

DailyAutomaticBackupStartTime -> (строка)

Ежедневное время в формате HH:MM . HH — это час суток (0-23) с нулями перед единицами, а MM — это минута часа с нулями перед единицами. Например, 05:00 означает 5 часов утра ежедневно.

DeploymentType -> (строка)

Определяет тип развертывания файлового сервера. Amazon FSx for OpenZFS поддерживает MULTI_AZ_1, SINGLE_AZ_HA_2, SINGLE_AZ_HA_1, SINGLE_AZ_2 и SINGLE_AZ_1.

ThroughputCapacity -> (целое число)

Пропускная способность файлового сервера Amazon FSx, измеряемая в мегабайтах в секунду (МБ/с).

WeeklyMaintenanceStartTime -> (строка)

Еженедельное время в формате D:HH:MM.

D — это день недели, где 1 соответствует понедельнику, а 7 — воскресенью. Для получения дополнительной информации см. спецификацию ISO-8601, описанную в Википедии.

HH — это час суток (0-23) с нулями перед единицами, а MM — это минута часа с нулями перед единицами.

Например, 1:05:00 означает техническое обслуживание в 5 часов утра понедельника.

DiskIopsConfiguration -> (структура)

Настройка SSD IOPS (операций ввода/вывода в секунду) для файлового сервера Amazon FSx для NetApp ONTAP, Amazon FSx для Windows File Server или FSx для OpenZFS. По умолчанию Amazon FSx автоматически предоставляет 3 IOPS на ГБ емкости хранилища. Вы можете предоставить дополнительные IOPS на ГБ емкости хранилища. Настройка состоит из общего числа предоставленных SSD IOPS и способа их предоставления, или режима (клиентом или Amazon FSx).

Mode -> (строка)

Указывает, использует ли файловый сервер значение AUTOMATIC для SSD IOPS, равное 3 IOPS на ГБ емкости хранилища, или использует значение USER_PROVISIONED.

Iops -> (длинное целое)

Общее число предоставленных SSD IOPS для файлового сервера.

Минимальное и максимальное значения для этого свойства зависят от значений HAPairs и StorageCapacity. Минимальное значение вычисляется как StorageCapacity * 3 * HAPairs (3 IOPS на ГБ емкости хранилища). Максимальное значение вычисляется как 200 000 * HAPairs.

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса), если значение Iops находится вне минимального или максимального значений.

RootVolumeId -> (строка)

Идентификатор корневого тома файлового сервера OpenZFS.

PreferredSubnetId -> (строка)

Требуется, когда DeploymentType установлено в значение MULTI_AZ_1. Это определяет подсеть, в которой должен находиться предпочтительный файловый сервер.

EndpointIpAddressRange -> (строка)

(Только Multi-AZ) Указывает диапазон IP-адресов, в котором будут созданы конечные точки для доступа к вашему файловому серверу. По умолчанию в Amazon FSx API и консоли Amazon FSx Amazon FSx выбирает для вас доступный диапазон IP-адресов /28 из одного из диапазонов CIDR VPC. У вас могут быть перекрывающиеся IP-адреса конечных точек для файловых серверов, развернутых в одной VPC/таблицах маршрутизации.

RouteTableIds -> (список)

(Только Multi-AZ) Таблицы маршрутизации VPC, в которых созданы конечные точки вашего файлового сервера.

(строка)

EndpointIpAddress -> (строка)

IP-адрес конечной точки, используемой для доступа к данным или управления файловым сервером.

ReadCacheConfiguration -> (структура)

Требуется, когда StorageType установлено в значение INTELLIGENT_TIERING. Указывает необязательный кэширование чтения SSD.

SizingMode -> (строка)

Указывает, как размер кэша чтения SSD, как следует:

  • Установите значение в NO_CACHE, если вы не хотите использовать кэш чтения SSD с вашим файловым сервером Intelligent-Tiering.
  • Установите значение в USER_PROVISIONED, чтобы указать точный размер кэша чтения SSD.
  • Установите значение в PROPORTIONAL_TO_THROUGHPUT_CAPACITY, чтобы размер кэша чтения SSD автоматически подбирался на основе вашей пропускной способности.

SizeGiB -> (целое число)

Требуется, если SizingMode установлено в значение USER_PROVISIONED. Указывает размер кэша чтения SSD файлового сервера в гигабайтах (GiB).

FailureDetails -> (структура)

Предоставляет информацию об ошибочном административном действии.

Message -> (строка)

Сообщение об ошибке, предоставляющее подробную информацию об ошибочном административном действии.

TargetVolumeValues -> (структура)

Описание тома Amazon FSx.

CreationTime -> (отметка времени)

Время создания ресурса в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

FileSystemId -> (строка)

Глобально уникальный идентификатор файловой системы, назначенный Amazon FSx.

Lifecycle -> (строка)

Статус жизненного цикла тома.

  • AVAILABLE - Том полностью доступен для использования.
  • CREATED - Том был создан.
  • CREATING - Amazon FSx создает новый том.
  • DELETING - Amazon FSx удаляет существующий том.
  • FAILED - Amazon FSx не смог создать том.
  • MISCONFIGURED - Том находится в состоянии отказа, но подлежит восстановлению.
  • PENDING - Amazon FSx еще не начал создание тома.

Name -> (строка)

Имя тома.

OntapConfiguration -> (структура)

Конфигурация тома Amazon FSx для NetApp ONTAP.

FlexCacheEndpointType -> (строка)

Указывает тип конечной точки FlexCache для тома. Допустимые значения следующие:

  • NONE указывает, что у тома нет конфигурации FlexCache. NONE — значение по умолчанию.
  • ORIGIN указывает, что том является исходным томом для тома FlexCache.
  • CACHE указывает, что том является томом FlexCache.

JunctionPath -> (строка)

Указывает каталог, который клиенты сетевого хранилища (NAS) используют для подключения к тому, а также имя домена системы доменных имен (DNS) или IP-адрес виртуальной машины хранения (SVM). Вы можете создать JunctionPath непосредственно ниже родительского узла подключения тома или в каталоге внутри тома. JunctionPath для тома с именем vol3 может быть /vol1/vol2/vol3 , или /vol1/dir2/vol3 , или даже /dir1/dir2/vol3 .

SecurityStyle -> (строка)

Стиль безопасности для тома, который может быть UNIX , NTFS или MIXED .

SizeInMegabytes -> (целое число)

Настроенный размер тома в мегабайтах (МБ).

StorageEfficiencyEnabled -> (булево значение)

Настройка эффективности хранения тома.

StorageVirtualMachineId -> (строка)

Идентификатор виртуальной машины хранения тома.

StorageVirtualMachineRoot -> (булево значение)

Флаг булевого типа, указывающий, является ли данный том корневым томом для своей виртуальной машины хранения (SVM). Только один том на SVM может быть корневым томом. Значение по умолчанию — false . Если это значение равно true , то это корневой том SVM.

Этот флаг полезен при удалении SVM, поскольку сначала необходимо удалить все тома, которые не являются корневыми. Этот флаг, установленный в false , помогает определить, какие тома необходимо удалить перед удалением SVM.

TieringPolicy -> (структура)

Настройка TieringPolicy тома.

CoolingPeriod -> (целое число)

Указывает количество дней, в течение которых данные пользователя в томе должны оставаться неактивными, прежде чем считаться «холодными» и перемещаться в пул емкости. Используется с политиками тиражирования AUTO и SNAPSHOT_ONLY . Введите целое число от 2 до 183. Значения по умолчанию составляют 31 день для AUTO и 2 дня для SNAPSHOT_ONLY .

Name -> (строка)

Указывает политику тиражирования, используемую для перехода данных. Значение по умолчанию — SNAPSHOT_ONLY .

  • SNAPSHOT_ONLY - перемещает холодные снимки в хранилище пула емкости.
  • AUTO - перемещает холодные данные пользователей и снимки в хранилище пула емкости на основе ваших шаблонов доступа.
  • ALL - перемещает все блоки данных пользователя как в активной файловой системе, так и в копиях снимков в хранилище пула емкости.
  • NONE - сохраняет данные тома в первичном хранилище, предотвращая их перемещение в хранилище пула емкости.

UUID -> (строка)

Универсальный уникальный идентификатор (UUID) тома.

OntapVolumeType -> (строка)

Указывает тип тома. Допустимые значения следующие:

  • RW указывает том для чтения/записи. RW — значение по умолчанию.
  • DP указывает том для защиты данных. Вы можете защищать данные, дублируя их в зеркальных копиях защиты данных. В случае катастрофы вы можете использовать эти зеркальные копии защиты данных для восстановления данных.
  • LS указывает том для совместного использования нагрузки. Зеркало совместного использования нагрузки уменьшает сетевой трафик для тома FlexVol, предоставляя дополнительные права на чтение клиентам.

SnapshotPolicy -> (строка)

Указывает политику создания снимков для тома. Существует три встроенные политики создания снимков:

  • default : Это политика по умолчанию. Максимально шесть ежечасных снимков, сделанных через пять минут после часа. Максимально два ежедневных снимка, сделанных с понедельника по субботу в 10 минут после полуночи. Максимально два еженедельных снимка, сделанных каждую пятницу в 15 минут после полуночи.
  • default-1weekly : Эта политика такая же, как политика default , за исключением того, что она сохраняет только один снимок из еженедельного графика.
  • none : Эта политика не создает никаких снимков. Эту политику можно назначить томам, чтобы предотвратить автоматическое создание снимков.

Вы также можете указать имя настроенной политики, созданной с помощью ONTAP CLI или REST API.

Дополнительную информацию см. в руководстве пользователя Amazon FSx для NetApp ONTAP по политике создания снимков.

CopyTagsToBackups -> (булево значение)

Флаг булевого типа, указывающий, нужно ли копировать метки тома в резервные копии. Значение по умолчанию — false. Если оно равно true, все метки тома копируются во все автоматические и инициированные пользователем резервные копии, где пользователь не указывает метки. Если это значение равно true, и вы указываете одну или несколько меток, копируются только указанные метки в резервные копии. Если вы указываете одну или несколько меток при создании резервной копии, инициированной пользователем, никакие метки не копируются с тома, независимо от этого значения.

SnaplockConfiguration -> (структура)

Объект конфигурации SnapLock для тома SnapLock FSx for ONTAP.

AuditLogVolume -> (boolean)

Включает или отключает журнал аудита для тома SnapLock FSx for ONTAP. Значение по умолчанию — false. Если вы установите AuditLogVolume в значение true, том SnapLock будет создан как том журнала аудита. Минимальный срок хранения для тома журнала аудита составляет шесть месяцев.

Дополнительную информацию см. в разделе Журналы аудита SnapLock.

AutocommitPeriod -> (структура)

Объект конфигурации для настройки периода автоматического подтверждения файлов в томе SnapLock FSx for ONTAP.

Type -> (строка)

Определяет тип времени для периода автоматического подтверждения файла в томе SnapLock FSx for ONTAP. Установка этого значения в NONE отключает автоматическое подтверждение. Значение по умолчанию — NONE.

Value -> (целое число)

Определяет период времени для автоматического подтверждения файла в томе SnapLock FSx for ONTAP. Действительные диапазоны:

  • Minutes : 5 - 65 535
  • Hours : 1 - 65 535
  • Days : 1 - 3 650
  • Months : 1 - 120
  • Years : 1 - 10

PrivilegedDelete -> (строка)

Включает, отключает или постоянно отключает привилегированное удаление на томе SnapLock Enterprise FSx for ONTAP. Включение привилегированного удаления позволяет администраторам SnapLock удалять файлы WORM (write once, read many), даже если они имеют активные периоды хранения. PERMANENTLY_DISABLED — это конечное состояние. Если привилегированное удаление постоянно отключено в томе SnapLock, его нельзя включить обратно. Значение по умолчанию — DISABLED.

Дополнительную информацию см. в разделе Привилегированное удаление.

RetentionPeriod -> (структура)

Устанавливает срок хранения для тома SnapLock FSx for ONTAP.

DefaultRetention -> (структура)

Срок хранения, назначаемый файлу WORM по умолчанию, если для тома SnapLock FSx for ONTAP не задан явный срок хранения. Срок хранения по умолчанию должен быть больше или равен минимальному сроку хранения и меньше или равен максимальному сроку хранения.

Type -> (строка)

Определяет тип времени для срока хранения тома SnapLock FSx for ONTAP. Установите одно из допустимых значений. Если вы установите INFINITE, файлы будут храниться вечно. Если вы установите UNSPECIFIED, файлы будут храниться до тех пор, пока вы не зададите явный срок хранения.

Value -> (целое число)

Определяет срок хранения тома SnapLock FSx for ONTAP. Для INFINITE и UNSPECIFIED значение установить нельзя. Для всех остальных вариантов допустимы следующие диапазоны:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

MinimumRetention -> (структура)

Наименьший срок хранения, который можно назначить файлу WORM в томе SnapLock FSx for ONTAP.

Type -> (строка)

Определяет тип времени для срока хранения тома SnapLock FSx for ONTAP. Установите одно из допустимых значений. Если вы установите INFINITE, файлы будут храниться вечно. Если вы установите UNSPECIFIED, файлы будут храниться до тех пор, пока вы не зададите явный срок хранения.

Value -> (целое число)

Определяет срок хранения тома SnapLock FSx for ONTAP. Для INFINITE и UNSPECIFIED значение установить нельзя. Для всех остальных вариантов допустимы следующие диапазоны:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

MaximumRetention -> (структура)

Наибольший срок хранения, который можно назначить файлу WORM в томе SnapLock FSx for ONTAP.

Type -> (строка)

Определяет тип времени для срока хранения тома SnapLock FSx for ONTAP. Установите одно из допустимых значений. Если вы установите INFINITE, файлы будут храниться вечно. Если вы установите UNSPECIFIED, файлы будут храниться до тех пор, пока вы не зададите явный срок хранения.

Value -> (целое число)

Определяет срок хранения тома SnapLock FSx for ONTAP. Для INFINITE и UNSPECIFIED значение установить нельзя. Для всех остальных вариантов допустимы следующие диапазоны:

  • Seconds : 0 - 65 535
  • Minutes : 0 - 65 535
  • Hours : 0 - 24
  • Days : 0 - 365
  • Months : 0 - 12
  • Years : 0 - 100

SnaplockType -> (строка)

Определяет режим хранения тома SnapLock FSx for ONTAP. После его установки изменить его нельзя. Вы можете выбрать один из следующих режимов хранения:

  • COMPLIANCE : Файлы, перемещенные в режим WORM (write once, read many) на томе Compliance, нельзя удалить до истечения срока хранения. Этот режим хранения используется для соблюдения отраслевых или правительственных требований или защиты от атак с вымогательством. Дополнительную информацию см. в разделе SnapLock Compliance.
  • ENTERPRISE : Файлы, перемещенные в режим WORM на томе Enterprise, могут быть удалены авторизованными пользователями до истечения срока хранения с помощью привилегированного удаления. Этот режим хранения используется для повышения целостности данных организации и соблюдения внутренних стандартов или для тестирования настроек хранения до использования SnapLock Compliance. Дополнительную информацию см. в разделе SnapLock Enterprise.

VolumeAppendModeEnabled -> (boolean)

Включает или отключает режим добавления к томам FSx for ONTAP SnapLock. Режим добавления к томам позволяет создавать файлы WORM, к которым можно добавлять данные, и записывать данные в них поэтапно. Значение по умолчанию — false.

Дополнительную информацию см. в разделе Режим добавления к томам.

VolumeStyle -> (строка)

Используется для указания стиля тома ONTAP. Дополнительную информацию о FlexVols и FlexGroups см. в руководстве пользователя Amazon FSx for NetApp ONTAP, раздел Типы томов.

AggregateConfiguration -> (структура)

Эта структура определяет параметры конфигурации для агрегатов хранения тома.

Aggregates -> (список)

Список агрегатов, на которых находится этот том. Агрегаты — это хранилища, которые составляют ваш основной уровень хранения. Каждая пара высокой доступности (HA) имеет один агрегат. Названия агрегатов соответствуют именам агрегатов в ONTAP CLI и REST API. Для FlexVols всегда будет одна запись.

Amazon FSx возвращает код HTTP 400 (Ошибка запроса) при следующих условиях:

  • Строки в значении Aggregates не отформатированы как aggrX, где X — число от 1 до 12.
  • Значение Aggregates содержит агрегаты, которых нет.
  • Один или несколько предоставленных агрегатов слишком близки к пределу тома, чтобы добавить больше томов.

(строка)

TotalConstituents -> (целое число)

Общее количество составляющих тома FlexGroup. Не применимо к FlexVols.

SizeInBytes -> (длинное целое число)

Настроенный размер тома в байтах.

ResourceARN -> (строка)

Идентификатор Amazon Resource Name (ARN) для данного ресурса. ARNs однозначно идентифицируют ресурсы Amazon Web Services. ARN требуется, когда необходимо однозначно указать ресурс во всех службах Amazon Web Services. Дополнительную информацию см. в разделе Идентификаторы Amazon Resource Name (ARN) в Общие сведения о службах Amazon Web Services.

Tags -> (список)

Список значений Tag, максимальное количество элементов — 50.

(структура)

Определяет пару ключ-значение для тега ресурса.

Key -> (строка)

Значение, определяющее TagKey, имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (строка)

Значение, определяющее TagValue, значение, присвоенное соответствующему ключу тега. Значения тегов могут быть нулевыми и не обязательно уникальными в наборе тегов. Например, вы можете иметь пару ключ-значение в наборе тегов finances : April и также payroll : April.

VolumeId -> (строка)

Уникальный ID тома, сгенерированный системой.

VolumeType -> (строка)

Тип тома.

LifecycleTransitionReason -> (структура)

Причина изменения статуса жизненного цикла тома.

Message -> (строка)

Подробное сообщение об ошибке.

OpenZFSConfiguration -> (структура)

Настройка тома Amazon FSx для OpenZFS.

ParentVolumeId -> (строка)

Идентификатор родительского тома.

VolumePath -> (строка)

Путь к тому от корневого тома. Например, fsx/parentVolume/volume1 .

StorageCapacityReservationGiB -> (целое число)

Количество резервируемого хранилища в гибибайтах (GiB) из родительского тома. Вы не можете зарезервировать больше хранилища, чем зарезервировано в родительском томе.

StorageCapacityQuotaGiB -> (целое число)

Максимальное количество хранилища в гибибайтах (GiB), которое может использовать том из своего родительского тома. Вы можете указать квоту, превышающую объем хранилища в родительском томе.

RecordSizeKiB -> (целое число)

Размер записи тома OpenZFS в кибибайтах (KiB). Допустимые значения: 4, 8, 16, 32, 64, 128, 256, 512 или 1024 KiB. По умолчанию используется 128 KiB. Большинству рабочих нагрузок подойдет значение по умолчанию. Инструкции по установке пользовательского размера записи см. в руководстве пользователя Amazon FSx для OpenZFS.

DataCompressionType -> (строка)

Указывает метод сжатия данных в томе. По умолчанию используется тип сжатия NONE.

  • NONE - Данные в томе не сжимаются. NONE — значение по умолчанию.
  • ZSTD - Данные в томе сжимаются с помощью алгоритма сжатия Zstandard (ZSTD). По сравнению с LZ4, Z-Standard обеспечивает лучшее сжатие для минимизации использования дискового пространства.
  • LZ4 - Данные в томе сжимаются с помощью алгоритма сжатия LZ4. По сравнению с Z-Standard, LZ4 менее ресурсоемкий и обеспечивает более высокую скорость записи.

CopyTagsToSnapshots -> (булево)

Булево значение, указывающее, нужно ли копировать теги тома в снимки. По умолчанию это значение равно false . Если это значение установлено в true , все теги тома копируются в снимки, где пользователь не указывает теги. Если это значение равно true и вы указываете один или несколько тегов, копируются только указанные теги. Если вы указываете один или несколько тегов при создании снимка, теги из тома не копируются, независимо от этого значения.

OriginSnapshot -> (структура)

Объект конфигурации, определяющий снимок, используемый в качестве источника данных для тома.

SnapshotARN -> (строка)

Amazon Resource Name (ARN) для данного ресурса. ARNs однозначно идентифицируют ресурсы Amazon Web Services. Нам требуется ARN, когда вам нужно однозначно указать ресурс во всех сервисах Amazon Web Services. Дополнительная информация приведена в разделе Amazon Resource Names (ARNs) в Amazon Web Services General Reference .

CopyStrategy -> (строка)

Стратегия, используемая при копировании данных со снимка в новый том.

  • CLONE - Новый том ссылается на данные в исходном снимке. Клонирование снимка быстрее, чем копирование данных со снимка в новый том, и не потребляет пропускную способность диска. Однако исходный снимок нельзя удалить, если его скопированные данные используются томом.
  • FULL_COPY - Копирует все данные со снимка в новый том.

Примечание

Опция INCREMENTAL_COPY доступна только для обновления существующего тома с использованием снимка из другого файлового сервера FSx для OpenZFS. Дополнительную информацию см. в разделе CopySnapshotAndUpdateVolume.

ReadOnly -> (булево)

Булево значение, указывающее, является ли том только для чтения.

NfsExports -> (список)

Объект конфигурации для подключения файловой системы Network File System (NFS).

(структура)

Конфигурации Network File System (NFS) для подключения файловой системы Amazon FSx для OpenZFS.

ClientConfigurations -> (список)

Список объектов конфигурации, содержащих клиента и параметры для подключения файловой системы OpenZFS.

(структура)

Указывает, кто может подключиться к файловой системе OpenZFS и какие параметры доступны при подключении к файловой системе.

Clients -> (строка)

Значение, указывающее, кто может подключиться к файловой системе. Вы можете использовать символ подстановки (* ), IP-адрес (0.0.0.0 ) или адрес CIDR (192.0.2.0/24 ). По умолчанию Amazon FSx использует символ подстановки при указании клиента.

Options -> (список)

Параметры для использования при подключении к файловой системе. Список параметров Network File System (NFS) см. в справке man exports(5) для Linux. При выборе параметров учитывайте следующее:

  • crossmnt используется по умолчанию. Если вы не укажете crossmnt при изменении конфигурации клиента, вы не сможете увидеть или получить доступ к снимкам в каталоге снимков файловой системы.
  • sync используется по умолчанию. Если вы укажете async , система подтверждает записи перед записью на диск. Если система аварийно завершит работу до завершения записи, несохраненные данные будут потеряны.

(строка)

UserAndGroupQuotas -> (список)

Объект, определяющий, сколько хранилища могут использовать пользователи или группы в томе.

(структура)

Используется для настройки квот, определяющих, сколько хранилища может использовать пользователь или группа на томе FSx для OpenZFS. Дополнительную информацию см. в разделе Свойства тома в руководстве пользователя FSx для OpenZFS.

Type -> (строка)

Указывает, относится ли квота к пользователю или группе.

Id -> (целое число)

Идентификатор пользователя или группы, к которому относится квота.

StorageCapacityQuotaGiB -> (целое число)

Квота хранилища пользователя или группы в гибибайтах (GiB).

RestoreToSnapshot -> (строка)

Указывает идентификатор снимка, на который был восстановлен том.

DeleteIntermediateSnaphots -> (булево)

Булево значение, указывающее, нужно ли удалять снимки между текущим состоянием и указанным снимком при восстановлении тома из снимка.

DeleteClonedVolumes -> (булево)

Булево значение, указывающее, нужно ли удалять зависимые клонированные тома, созданные из промежуточных снимков, при восстановлении тома из снимка.

DeleteIntermediateData -> (булево)

Булево значение, указывающее, нужно ли перезаписывать данные снимка, отличающиеся между текущим состоянием и указанным снимком, при восстановлении тома из снимка.

SourceSnapshotARN -> (строка)

Amazon Resource Name (ARN) для данного ресурса. ARNs однозначно идентифицируют ресурсы Amazon Web Services. Нам требуется ARN, когда вам нужно однозначно указать ресурс во всех сервисах Amazon Web Services. Дополнительная информация приведена в разделе Amazon Resource Names (ARNs) в Amazon Web Services General Reference .

DestinationSnapshot -> (строка)

Идентификатор снимка, который копируется или был последним скопирован в целевой том.

CopyStrategy -> (строка)

Указывает стратегию, используемую при копировании данных со снимка в новый том.

  • CLONE - Новый том ссылается на данные в исходном снимке. Клонирование снимка быстрее, чем копирование данных со снимка в новый том, и не потребляет пропускную способность диска. Однако исходный снимок нельзя удалить, если его скопированные данные используются томом.
  • FULL_COPY - Копирует все данные со снимка в новый том. Укажите этот параметр для создания тома из снимка на другом файловом сервере FSx для OpenZFS.

Примечание

Опция INCREMENTAL_COPY доступна только для обновления существующего тома с использованием снимка из другого файлового сервера FSx для OpenZFS. Дополнительную информацию см. в разделе CopySnapshotAndUpdateVolume.

TargetSnapshotValues -> (структура)

Снимок тома Amazon FSx для OpenZFS.

ResourceARN -> (строка)

Amazon Resource Name (ARN) для данного ресурса. ARNs однозначно идентифицируют ресурсы Amazon Web Services. Нам требуется ARN, когда вам нужно однозначно указать ресурс во всех сервисах Amazon Web Services. Дополнительная информация приведена в разделе Amazon Resource Names (ARNs) в Amazon Web Services General Reference .

SnapshotId -> (строка)

Идентификатор снимка.

Name -> (строка)

Имя снимка.

VolumeId -> (строка)

Идентификатор тома, которому принадлежит снимок.

CreationTime -> (метка времени)

Время создания ресурса в секундах (с 1970-01-01T00:00:00Z), также известное как время Unix.

Lifecycle -> (строка)

Статус жизненного цикла снимка.

  • PENDING - Amazon FSx еще не начал создание снимка.
  • CREATING - Amazon FSx создает снимок.
  • DELETING - Amazon FSx удаляет снимок.
  • AVAILABLE - Снимок полностью доступен.

LifecycleTransitionReason -> (структура)

Описание причины изменения состояния жизненного цикла ресурса.

Message -> (строка)

Подробное сообщение об ошибке.

Tags -> (список)

Список значений Tag, с максимальным количеством элементов 50.

(структура)

Определяет пару ключ-значение для тега ресурса.

Key -> (строка)

Значение, определяющее TagKey, имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.

Value -> (строка)

Значение, определяющее TagValue, значение, присвоенное соответствующему ключу тега. Значения тегов могут быть null и не обязательно должны быть уникальными в наборе тегов. Например, вы можете иметь пару ключ-значение в наборе тегов finances : April и также payroll : April.

TotalTransferBytes -> (длинное целое число)

Количество переданных байтов для снимка FSx для OpenZFS, который вы копируете.

RemainingTransferBytes -> (длинное целое число)

Остальные байты для передачи для снимка FSx для OpenZFS, который вы копируете.

TotalTransferBytes -> (длинное целое число)

Количество переданных байтов для снимка FSx для OpenZFS, который вы копируете.

RemainingTransferBytes -> (длинное целое число)

Остальные байты для передачи для снимка FSx для OpenZFS, который вы копируете.

OntapConfiguration -> (структура)

Настройка этого файлового сервера Amazon FSx for NetApp ONTAP.

AutomaticBackupRetentionDays -> (целое число)

Количество дней хранения автоматических резервных копий. Установка этого свойства в значение 0 отключает автоматическое создание резервных копий. Вы можете хранить автоматические резервные копии не более 90 дней. По умолчанию значение 30 .

DailyAutomaticBackupStartTime -> (строка)

Ежедневное повторяющееся время в формате HH:MM . HH — это заполненное нулями число часа (0-23), а MM — это заполненное нулями число минуты. Например, 05:00 — это 5:00 каждый день.

DeploymentType -> (строка)

Указывает тип развертывания файлового сервера FSx for ONTAP, используемый в файловой системе.

  • MULTI_AZ_1 — высокодоступная файловая система, настроенная для многозонной избыточности для предотвращения временной недоступности зоны доступности (AZ). Это файловая система первого поколения FSx for ONTAP.
  • MULTI_AZ_2 — высокодоступная файловая система, настроенная для многозонной избыточности для предотвращения временной недоступности AZ. Это файловая система второго поколения FSx for ONTAP.
  • SINGLE_AZ_1 — файловая система, настроенная для однозонной избыточности. Это файловая система первого поколения FSx for ONTAP.
  • SINGLE_AZ_2 — файловая система, настроенная с несколькими парами высокодоступных (HA) серверов для однозонной избыточности. Это файловая система второго поколения FSx for ONTAP.

Дополнительную информацию об использовании многозонных и однозонных развертываний см. в разделе Выбор многозонного или однозонного развертывания файловой системы.

EndpointIpAddressRange -> (строка)

(Только для многозонной) Указывает диапазон IP-адресов, в котором будут созданы конечные точки для доступа к вашей файловой системе. По умолчанию в API Amazon FSx Amazon FSx выбирает для вас неиспользуемый диапазон IP-адресов из диапазона 198.19.*. По умолчанию в консоли Amazon FSx Amazon FSx выбирает последние 64 IP-адреса из основного диапазона CIDR VPC в качестве диапазона IP-адресов конечных точек для файловой системы. Вы можете иметь перекрывающиеся IP-адреса конечных точек для файловых систем, развернутых в одном VPC/таблицах маршрутизации.

Endpoints -> (структура)

Management и Intercluster конечные точки, используемые для доступа к данным или для управления файловой системой с помощью NetApp ONTAP CLI, REST API или NetApp SnapMirror.

Intercluster -> (структура)

Конечная точка для управления вашей файловой системой, настраивая NetApp SnapMirror с другими системами ONTAP.

DNSName -> (строка)

DNS-имя файловой системы. Вы можете подключиться к файловой системе, используя ее DNS-имя.

IpAddresses -> (список)

IP-адреса конечной точки файловой системы.

(строка)

Management -> (структура)

Конечная точка для управления вашей файловой системой с помощью NetApp ONTAP CLI и NetApp ONTAP API.

DNSName -> (строка)

DNS-имя файловой системы. Вы можете подключиться к файловой системе, используя ее DNS-имя.

IpAddresses -> (список)

IP-адреса конечной точки файловой системы.

(строка)

DiskIopsConfiguration -> (структура)

Настройка SSD IOPS для файловой системы ONTAP, указывающая количество выделенных IOPS и режим выделения.

Mode -> (строка)

Указывает, использует ли файловая система настройку AUTOMATIC SSD IOPS в размере 3 IOPS на ГБ емкости хранилища или использует значение USER_PROVISIONED .

Iops -> (длинное целое число)

Общее количество выделенных SSD IOPS для файловой системы.

Минимальное и максимальное значения для этого свойства зависят от значения HAPairs и StorageCapacity . Минимальное значение вычисляется как StorageCapacity * 3 * HAPairs (3 IOPS на ГБ StorageCapacity ). Максимальное значение вычисляется как 200 000 * HAPairs .

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса), если значение Iops находится вне минимального или максимального значения.

PreferredSubnetId -> (строка)

Идентификатор подсети. Подсеть — это диапазон IP-адресов в вашей виртуальной частной сети (VPC). Дополнительные сведения см. в разделе VPC и подсети в руководстве пользователя Amazon VPC.

RouteTableIds -> (список)

(Только для многозонной) Таблицы маршрутизации VPC, в которых создаются конечные точки вашей файловой системы.

(строка)

ThroughputCapacity -> (целое число)

Непрерывная пропускная способность файловой системы Amazon FSx в мегабайтах в секунду (МБ/с).

WeeklyMaintenanceStartTime -> (строка)

Повторяющееся еженедельное время в формате D:HH:MM .

D — это день недели, где 1 соответствует понедельнику, а 7 — воскресенью. Более подробную информацию см. в спецификации ISO-8601, описанной в Википедии.

HH — это заполненное нулями число часа (0-23), а MM — это заполненное нулями число минуты.

Например, 1:05:00 указывает техническое обслуживание в 5:00 понедельника.

FsxAdminPassword -> (строка)

Вы можете использовать учетную запись пользователя fsxadmin для доступа к NetApp ONTAP CLI и REST API. Значение пароля всегда замаскировано в ответе.

HAPairs -> (целое число)

Указывает количество пар серверов файловой системы высокой доступности (HA). Значение по умолчанию равно 1. Значение этого свойства влияет на значения StorageCapacity , Iops и ThroughputCapacity . Дополнительные сведения см. в руководстве пользователя FSx for ONTAP в разделе Пара высокодоступности (HA).

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса) в следующих случаях:

  • Значение HAPairs меньше 1 или больше 12.
  • Значение HAPairs больше 1, а значение DeploymentType равно SINGLE_AZ_1 , MULTI_AZ_1 или MULTI_AZ_2 .

ThroughputCapacityPerHAPair -> (целое число)

Используйте для выбора пропускной способности на пару HA. Когда значение HAPairs равно 1, значение ThroughputCapacityPerHAPair — это общая пропускная способность файловой системы.

Это поле и ThroughputCapacity не могут быть определены в одном вызове API, но одно из них требуется.

Это поле и ThroughputCapacity одинаковы для файловых систем с одной парой HA.

  • Для файловых систем SINGLE_AZ_1 и MULTI_AZ_1 допустимые значения — 128, 256, 512, 1024, 2048 или 4096 МБ/с.
  • Для SINGLE_AZ_2 допустимые значения — 1536, 3072 или 6144 МБ/с.
  • Для MULTI_AZ_2 допустимые значения — 384, 768, 1536, 3072 или 6144 МБ/с.

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса) в следующих случаях:

  • Значение ThroughputCapacity и ThroughputCapacityPerHAPair не совпадают.
  • Тип развертывания — SINGLE_AZ_2, а ThroughputCapacity / ThroughputCapacityPerHAPair не является допустимой парой HA (значение между 1 и 12).
  • Значение ThroughputCapacityPerHAPair не является допустимым.

FileSystemTypeVersion -> (строка)

Версия Lustre файловой системы Amazon FSx for Lustre, которая может быть 2.10 , 2.12 или 2.15 .

OpenZFSConfiguration -> (структура)

Настройка этого файлового сервера Amazon FSx for OpenZFS.

AutomaticBackupRetentionDays -> (целое число)

Количество дней хранения автоматических резервных копий. Установка этого свойства в значение 0 отключает автоматические резервные копии. Вы можете хранить автоматические резервные копии не более 90 дней. По умолчанию установлено значение 30 .

CopyTagsToBackups -> (булево)

Булево значение, указывающее, нужно ли копировать теги файлового сервера в резервные копии. Если установлено значение true , все теги файлового сервера копируются во все автоматические резервные копии и любые резервные копии, созданные пользователем, в которых пользователь не указывает теги. Если это значение равно true и вы укажите один или несколько тегов, только указанные теги будут скопированы в резервные копии. Если вы укажете один или несколько тегов при создании резервной копии, созданной пользователем, теги не будут скопированы с файлового сервера, независимо от этого значения.

CopyTagsToVolumes -> (булево)

Булево значение, указывающее, нужно ли копировать теги тома в снимки. По умолчанию это значение установлено в false . Если установлено значение true , все теги тома копируются в снимки, в которых пользователь не указывает теги. Если это значение равно true и вы укажите один или несколько тегов, только указанные теги будут скопированы в снимки. Если вы укажите один или несколько тегов при создании снимка, теги не будут скопированы с тома, независимо от этого значения.

DailyAutomaticBackupStartTime -> (строка)

Ежедневное время, в формате HH:MM . HH — это дополненное нулями значение часа (0–23), а MM — это дополненное нулями значение минуты часа. Например, 05:00 соответствует 5:00 ежедневно.

DeploymentType -> (строка)

Указывает тип развертывания файлового сервера. Amazon FSx for OpenZFS поддерживает MULTI_AZ_1 , SINGLE_AZ_HA_2 , SINGLE_AZ_HA_1 , SINGLE_AZ_2 и SINGLE_AZ_1 .

ThroughputCapacity -> (целое число)

Пропускная способность файлового сервера Amazon FSx, измеряемая в мегабайтах в секунду (МБ/с).

WeeklyMaintenanceStartTime -> (строка)

Еженедельное время, в формате D:HH:MM .

D — это день недели, где 1 соответствует понедельнику, а 7 — воскресенью. Для получения дополнительной информации см. спецификацию ISO-8601, описанную в Википедии.

HH — это дополненное нулями значение часа (0–23), а MM — это дополненное нулями значение минуты часа.

Например, 1:05:00 означает техническое обслуживание в 5:00 понедельника.

DiskIopsConfiguration -> (структура)

Настройка SSD IOPS (операций ввода/вывода в секунду) для файлового сервера Amazon FSx for NetApp ONTAP, Amazon FSx for Windows File Server или FSx for OpenZFS. По умолчанию Amazon FSx автоматически выделяет 3 IOPS на ГБ емкости хранилища. Вы можете выделить дополнительные IOPS на ГБ хранилища. Настройка включает общее количество выделенных SSD IOPS и способ их выделения, или режим (клиентом или Amazon FSx).

Mode -> (строка)

Указывает, использует ли файловый сервер AUTOMATIC установку SSD IOPS 3 IOPS на ГБ емкости хранилища или использует значение USER_PROVISIONED .

Iops -> (длинное целое)

Общее количество выделенных SSD IOPS для файлового сервера.

Минимальные и максимальные значения для этого свойства зависят от значения HAPairs и StorageCapacity . Минимальное значение рассчитывается как StorageCapacity * 3 * HAPairs (3 IOPS на ГБ StorageCapacity ). Максимальное значение рассчитывается как 200 000 * HAPairs .

Amazon FSx возвращает HTTP-код состояния 400 (Ошибка запроса), если значение Iops выходит за пределы минимального или максимального значений.

RootVolumeId -> (строка)

Идентификатор корневого тома файлового сервера OpenZFS.

PreferredSubnetId -> (строка)

Требуется, когда DeploymentType установлено в значение MULTI_AZ_1 . Это указывает подсеть, в которой должен находиться предпочтительный файловый сервер.

EndpointIpAddressRange -> (строка)

(Только для Multi-AZ) Указывает диапазон IP-адресов, в котором будут созданы конечные точки доступа к вашему файловому серверу. По умолчанию в Amazon FSx API и консоли Amazon FSx Amazon FSx выбирает доступный диапазон IP-адресов /28 из одного из диапазонов CIDR VPC. Можно иметь перекрывающиеся IP-адреса конечных точек для файловых серверов, развернутых в одном VPC/таблицах маршрутизации.

RouteTableIds -> (список)

(Только для Multi-AZ) Таблицы маршрутизации VPC, в которых создаются конечные точки вашего файлового сервера.

(строка)

EndpointIpAddress -> (строка)

IP-адрес конечной точки, используемой для доступа к данным или управления файловым сервером.

ReadCacheConfiguration -> (структура)

Требуется, когда StorageType установлено в значение INTELLIGENT_TIERING . Указывает необязательный выделенный кэш чтения SSD.

SizingMode -> (строка)

Указывает, как настраивается выделенный кэш чтения SSD, следующим образом:

  • Установлено значение NO_CACHE, если вы не хотите использовать кэш чтения SSD с файловым сервером Intelligent-Tiering.
  • Установлено значение USER_PROVISIONED для указания точного размера кэша чтения SSD.
  • Установлено значение PROPORTIONAL_TO_THROUGHPUT_CAPACITY для автоматического определения размера кэша чтения SSD на основе вашей пропускной способности.

SizeGiB -> (целое число)

Требуется, если SizingMode установлено в значение USER_PROVISIONED . Указывает размер кэша чтения SSD файлового сервера в гибибайтах (GiB).

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API