обновление-связи-с-хранилищем-данных

Описание

Обновляет конфигурацию существующей связи с хранилищем данных на файловой системе Amazon FSx для Lustre. Связи с хранилищами данных поддерживаются на всех файловых системах FSx для Lustre 2.12 и 2.15, за исключением scratch_1 типа развертывания.

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

Синтаксис

  update-data-repository-association
--association-id <value>
[--client-request-token <value>]
[--imported-file-chunk-size <value>]
[--s3 <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]

Параметры

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

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

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

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

--imported-file-chunk-size (целое число)

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

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

--s3 (структура)

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

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

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

Events -> (список)

AutoImportPolicy может иметь следующие значения событий:

NEW - Amazon FSx автоматически импортирует метаданные файлов, добавленных в связанное ведро S3, которые в настоящее время не существуют в файловой системе FSx.
CHANGED - Amazon FSx автоматически обновляет метаданные файлов и делает недействительным содержимое существующих файлов в файловой системе, поскольку файлы изменяются в хранилище данных.
DELETED - Amazon FSx автоматически удаляет файлы в файловой системе, поскольку соответствующие файлы удаляются в хранилище данных.

Вы можете определить любые сочетания типов событий для вашего AutoImportPolicy.

(строка)

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

Определяет тип обновленных объектов (новые, измененные, удаленные), которые будут автоматически экспортированы из вашей файловой системы в связанное ведро S3.

Events -> (список)

AutoExportPolicy может иметь следующие значения событий:

NEW - Новые файлы и каталоги автоматически экспортируются в хранилище данных по мере их добавления в файловую систему.
CHANGED - Изменения в файлах и каталогах в файловой системе автоматически экспортируются в хранилище данных.
DELETED - Файлы и каталоги автоматически удаляются в хранилище данных, когда они удаляются в файловой системе.

Вы можете определить любые сочетания типов событий для вашего AutoExportPolicy.

(строка)

Упрощенный синтаксис:

AutoImportPolicy={Events=[string,string]},AutoExportPolicy={Events=[string,string]}

Синтаксис JSON:

{
  "AutoImportPolicy": {
    "Events": ["NEW"|"CHANGED"|"DELETED", ...]
  },
  "AutoExportPolicy": {
    "Events": ["NEW"|"CHANGED"|"DELETED", ...]
  }
}

--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 для вывода.

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

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

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

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

Вывод

Ассоциация -> (структура)

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

AssociationId -> (строка)

Уникальный, сгенерированный системой, идентификатор ассоциации хранилища данных.

ResourceARN -> (строка)

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

FileSystemId -> (строка)

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

Lifecycle -> (строка)

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

CREATING - Ассоциация хранилища данных между файловой системой или кешем и хранилищем данных создается. Хранилище данных недоступно.
AVAILABLE - Ассоциация хранилища данных доступна для использования.
MISCONFIGURED - Ассоциация хранилища данных неправильно настроена. До тех пор, пока конфигурация не будет исправлена, автоматический импорт и автоматическая экспорт не будут работать (только для Amazon FSx for Lustre).
UPDATING - Ассоциация хранилища данных проходит обновление, инициированное пользователем, которое может повлиять на ее доступность.
DELETING - Ассоциация хранилища данных проходит удаление, инициированное пользователем.
FAILED - Ассоциация хранилища данных находится в терминальном состоянии, из которого невозможно восстановиться.

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

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

Message -> (строка)

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

FileSystemPath -> (строка)

Путь в файловой системе Amazon FSx for Lustre, указывающий на директорию высокого уровня (например, /ns1/ ) или поддиректорию (например, /ns1/subdir/ ), которая будет сопоставлена 1 к 1 с DataRepositoryPath . Требуется ведущий обратный слэш в имени. Две ассоциации хранилища данных не могут иметь перекрывающихся путей файловой системы. Например, если хранилище данных ассоциировано с путем файловой системы /ns1/ , то вы не можете связать другое хранилище данных с путем файловой системы /ns1/ns2.

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

Примечание

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

DataRepositoryPath -> (строка)

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

Для Amazon File Cache путь может быть хранилищем данных NFS, которое будет связано с кешем. Путь может быть в одном из двух форматов:
- Если вы не используете параметр DataRepositorySubdirectories , путь указывает на каталог экспорта NFS (или одну из его поддиректорий) в формате nsf://nfs-domain-name/exportpath . Таким образом, вы можете связать один каталог экспорта NFS с одной ассоциацией хранилища данных.
- Если вы используете параметр DataRepositorySubdirectories , путь — это доменное имя файловой системы NFS в формате nfs://filer-domain-name , который указывает корень поддиректорий, указанных в параметре DataRepositorySubdirectories.
Для Amazon File Cache путь может быть ковшером S3 или префиксом в формате s3://bucket-name/prefix/ (где prefix необязательно).
Для Amazon FSx for Lustre путь может быть ковшером S3 или префиксом в формате s3://bucket-name/prefix/ (где prefix необязательно).

BatchImportMetaDataOnCreate -> (булево)

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

Примечание

BatchImportMetaDataOnCreate не поддерживается для хранилищ данных, связанных с ресурсом Amazon File Cache.

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

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

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

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

Настройка для хранилища данных Amazon S3, связанного с файловой системой Amazon FSx for Lustre с ассоциацией хранилища данных.

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

Указывает тип обновленных объектов (новые, измененные, удаленные), которые будут автоматически импортированы из связанного ковшера S3 в вашу файловую систему.

Events -> (список)

AutoImportPolicy может иметь следующие значения событий:

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

Вы можете определить любую комбинацию типов событий для вашей AutoImportPolicy.

(строка)

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

Указывает тип обновленных объектов (новые, измененные, удаленные), которые будут автоматически экспортированы из вашей файловой системы в связанный ковшер S3.

Events -> (список)

AutoExportPolicy может иметь следующие значения событий:

NEW - Новые файлы и каталоги автоматически экспортируются в хранилище данных по мере их добавления в файловую систему.
CHANGED - Изменения в файлах и каталогах в файловой системе автоматически экспортируются в хранилище данных.
DELETED - Файлы и каталоги автоматически удаляются в хранилище данных при их удалении в файловой системе.

Вы можете определить любую комбинацию типов событий для вашей AutoExportPolicy.

(строка)

Tags -> (список)

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

(структура)

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

Key -> (строка)

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

Value -> (строка)

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

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

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

FileCacheId -> (строка)

Глобально уникальный идентификатор ресурса Amazon File Cache.

FileCachePath -> (строка)

Путь в Amazon File Cache, указывающий на директорию высокого уровня (например, /ns1/ ) или поддиректорию (например, /ns1/subdir/ ), которая будет сопоставлена 1 к 1 с DataRepositoryPath . Требуется ведущий обратный слэш в пути. Две ассоциации хранилища данных не могут иметь перекрывающихся путей кеша. Например, если хранилище данных ассоциировано с путем кеша /ns1/ , то вы не можете связать другое хранилище данных с путем кеша /ns1/ns2 .

Этот путь определяет каталог в вашем кэше, из которого будут экспортироваться файлы. Этот каталог кеша может быть связан только с одним хранилищем данных (S3 или NFS), и никакое другое хранилище данных не может быть связано с этим каталогом.

Примечание

Путь к кешу может быть установлен только в корень (/) при указании параметра DataRepositorySubdirectories. Если вы укажете корень (/) в качестве пути к кешу, вы можете создать только одну ассоциацию хранилища данных на кеше.

Путь к кешу не может быть установлен в корень (/) для ассоциации хранилища данных S3.

DataRepositorySubdirectories -> (список)

Для Amazon File Cache — список каталогов экспорта NFS, которые будут связаны с ассоциацией хранилища данных NFS. Все подкаталоги должны находиться в одной файловой системе NFS. Пути экспорта имеют формат /exportpath1 . Для использования этого параметра необходимо настроить DataRepositoryPath в качестве доменного имени файловой системы NFS. Доменное имя файловой системы NFS по умолчанию — корень поддиректорий. Обратите внимание, что DataRepositorySubdirectories не поддерживается для хранилищ данных S3.

(строка)

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

Настройка для хранилища данных NFS, связанного с ресурсом Amazon File Cache с ассоциацией хранилища данных.

Version -> (строка)

Версия протокола NFS (Network File System) хранилища данных NFS. В настоящее время единственное поддерживаемое значение — NFS3, что указывает на то, что хранилище данных должно поддерживать протокол NFSv3.

DnsIps -> (список)

Список до 2 IP-адресов DNS-серверов, используемых для разрешения доменного имени файловой системы NFS. Предоставленные IP-адреса могут быть IP-адресами DNS-прокси или резолвера, которые клиент управляет и запускает внутри VPC клиента, или IP-адресами серверов DNS на стороне клиента.

(строка)

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

Этот параметр не поддерживается для Amazon File Cache.

Events -> (список)

AutoExportPolicy может иметь следующие значения событий:

NEW - Новые файлы и каталоги автоматически экспортируются в хранилище данных по мере их добавления в файловую систему.
CHANGED - Изменения в файлах и каталогах в файловой системе автоматически экспортируются в хранилище данных.
DELETED - Файлы и каталоги автоматически удаляются в хранилище данных при их удалении в файловой системе.

Вы можете определить любую комбинацию типов событий для вашей AutoExportPolicy.

(строка)