describe-data-repository-associations
Описание
Возвращает описание конкретных ассоциаций хранилища данных Amazon FSx для Lustre или Amazon File Cache, если в запросе предоставлены одно или несколько значений AssociationIds, или если в запросе используются фильтры. Ассоциации хранилища данных поддерживаются для ресурсов Amazon File Cache и всех файловых систем FSx для Lustre 2.12 и 2.15, за исключением типа развертывания scratch_1.
Вы можете использовать фильтры, чтобы сузить ответ, включив только ассоциации хранилища данных для конкретных файловых систем (используйте фильтр file-system-id с идентификатором файловой системы) или кэшей (используйте фильтр file-cache-id с идентификатором кэша), или ассоциации хранилища данных для определенного типа хранилища (используйте фильтр data-repository-type со значением S3 или NFS). Если вы не используете фильтры, ответ возвращает все ассоциации хранилища данных, принадлежащие вашей учетной записи Amazon Web Services в регионе Amazon Web Services конечной точки, к которой вы обращаетесь.
При получении всех ассоциаций хранилища данных вы можете использовать необязательный параметр MaxResults для ограничения количества ассоциаций хранилища данных, возвращаемых в ответе. Если остаются другие ассоциации хранилища данных, возвращается значение NextToken в ответе. В этом случае отправьте последующий запрос со значением параметра запроса NextToken, установленным на значение NextToken из последнего ответа.
См. также: Документация API AWS
Синтаксис
describe-data-repository-associations
[--association-ids <value>]
[--filters <value>]
[--max-results <value>]
[--next-token <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-ids (список)
Идентификаторы ассоциаций хранилища данных, описание которых вы хотите получить (Строка).
(строка)
Синтаксис:
"string" "string" ...
--filters (список)
Список элементов Filter.
(структура)
Фильтр, используемый для ограничения результатов вызовов describe. Вы можете использовать несколько фильтров, чтобы вернуть результаты, соответствующие всем применяемым требованиям фильтра.
Имя -> (строка)
Значения -> (список)
Значения фильтра. Это все значения для любых примененных фильтров.
(строка)
Сокращенный синтаксис:
Name=string,Values=string,string ...
Синтаксис JSON:
[
{
"Name": "file-system-id"|"backup-type"|"file-system-type"|"volume-id"|"data-repository-type"|"file-cache-id"|"file-cache-type",
"Values": ["string", ...]
}
...
]
--max-results (целое число)
--next-token (строка)
NextToken.--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного значения JSON, так как строка будет воспринята буквально. Это может не быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит скелет JSON в стандартный вывод без отправки запроса API. Если предоставлено без значения или со значением input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, это выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, оно проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный скелет JSON не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном скелете JSON.
Глобальные параметры
--debug (логическое значение)
Включить отладочную запись в журнал.
--endpoint-url (строка)
Переопределить адрес URL по умолчанию команды заданным адресом URL.
--no-verify-ssl (логическое значение)
По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (логическое значение)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования для вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/окружения.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- on
- off
- auto
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (строка)
Файл сертификата CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/окружения.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.
--cli-binary-format (строка)
Стиль форматирования, используемый для двоичных блоков. По умолчанию формат — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной строки base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображающего двоичный блок, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла непосредственно, независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для конфигурированного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (логическое значение)
Отключить пейджер CLI для вывода.
--cli-auto-prompt (логическое значение)
Автоматически запросить параметры входных данных CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запросы параметров входных данных CLI.
Вывод
Associations -> (список)
Массив из одного или нескольких описаний ассоциации хранилища данных.
(структура)
Настройка ассоциации хранилища данных, которая связывает файловую систему Amazon FSx для Lustre с ведром Amazon S3 или ресурс Amazon File Cache с ведром Amazon S3 или файловой системой NFS. Объект конфигурации ассоциации хранилища данных возвращается в ответ на следующие операции:
CreateDataRepositoryAssociationUpdateDataRepositoryAssociationDescribeDataRepositoryAssociations
Ассоциации хранилищ данных поддерживаются для ресурсов Amazon File Cache и всех файловых систем FSx для Lustre 2.12 и 2.15, за исключением типа развертывания scratch_1.
AssociationId -> (строка)
ResourceARN -> (строка)
FileSystemId -> (строка)
Lifecycle -> (строка)
Описание состояния ассоциации хранилища данных. Состояние может принимать следующие значения:
-
CREATING— Ассоциация хранилища данных между файловой системой или кешем и хранилищем данных создается. Хранилище данных недоступно. -
AVAILABLE— Ассоциация хранилища данных доступна для использования. -
MISCONFIGURED— Ассоциация хранилища данных неправильно настроена. Пока конфигурация не будет исправлена, автоматический импорт и автоматическая экспорт будут недоступны (только для Amazon FSx для Lustre). -
UPDATING— Ассоциация хранилища данных проходит обновление, инициированное пользователем, что может повлиять на её доступность. -
DELETING— Ассоциация хранилища данных проходит удаление, инициированное пользователем. -
FAILED— Ассоциация хранилища данных находится в терминальном состоянии, которое невозможно восстановить.
FailureDetails -> (структура)
Предоставляет подробную информацию о хранилище данных, если его состояние (Lifecycle) установлено в MISCONFIGURED или FAILED.
Message -> (строка)
FileSystemPath -> (строка)
Путь в файловой системе Amazon FSx для 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 для Lustre путь может быть ведром S3 или префиксом в формате
s3://bucket-name/prefix/(гдеprefixнеобязателен).
BatchImportMetaDataOnCreate -> (булево)
Флаг булевого типа, указывающий, должна ли задача импорта хранилища данных для импорта метаданных выполняться после создания ассоциации хранилища данных. Задача выполняется, если этот флаг установлен в true.
Примечание
BatchImportMetaDataOnCreate не поддерживается для хранилищ данных, связанных с ресурсом Amazon File Cache.ImportedFileChunkSize -> (целое число)
Для файлов, импортированных из хранилища данных, это значение определяет количество полос и максимальный объём данных на файл (в MiB), хранимые на одном физическом диске. Максимальное количество дисков, на которые один файл может быть распределён, ограничено общим числом дисков, составляющих файловую систему или кеш.
Размер по умолчанию — 1024 MiB (1 GiB), и он может быть до 512000 MiB (500 GiB). Максимальный размер объектов 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.
(строка)
Tags -> (список)
Список значений Tag, максимальное количество элементов 50.
(структура)
Определяет пару ключ-значение для тега ресурса.
Key -> (строка)
TagKey, имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.Value -> (строка)
TagValue, значение, назначенное соответствующему ключу тега. Значения тегов могут быть null и не обязательно должны быть уникальными в наборе тегов. Например, вы можете иметь пару ключ-значение в наборе тегов finances : April и также payroll : April.CreationTime -> (метка времени)
FileCacheId -> (строка)
FileCachePath -> (строка)
Путь в Amazon File Cache, указывающий на папку высокого уровня (например, /ns1/) или подпапку (например, /ns1/subdir/), которая будет сопоставлена 1:1 с DataRepositoryPath. Ведущий слеш в пути обязателен. Две ассоциации хранилища данных не могут иметь перекрывающихся путей кеша. Например, если хранилище данных ассоциировано с путём кеша /ns1/, то нельзя связать другое хранилище данных с путём кеша /ns1/ns2.
Этот путь определяет каталог в вашем кеше, из которого будут экспортироваться файлы. Этот каталог кеша может быть связан только с одним хранилищем данных (S3 или NFS), и ни одно другое хранилище данных не может быть связано с этим каталогом.
Примечание
Путь кеша может быть установлен только в корне (/) на NFS DRA, когда указан параметр DataRepositorySubdirectories. Если вы укажете корень (/) в качестве пути кеша, вы сможете создать только одну DRA в кеше.
Путь кеша не может быть установлен в корень (/) для DRA S3.
DataRepositorySubdirectories -> (список)
Для Amazon File Cache — список каталогов экспорта NFS, которые будут связаны с ассоциацией NFS-хранилища данных. Все подкаталоги должны находиться в одной NFS-файловой системе. Пути экспорта имеют формат /exportpath1. Для использования этого параметра необходимо настроить DataRepositoryPath в качестве доменного имени NFS-файловой системы. Доменное имя NFS-файловой системы фактически является корнем подкаталогов. Обратите внимание, что DataRepositorySubdirectories не поддерживается для хранилищ данных S3.
(строка)
NFS -> (структура)
Настройка хранилища данных NFS, связанного с ресурсом Amazon File Cache с помощью ассоциации хранилища данных.
Version -> (string)
NFS3, которое указывает, что хранилище данных должно поддерживать протокол NFSv3.DnsIps -> (list)
Список из не более чем 2 IP-адресов DNS-серверов, используемых для разрешения доменного имени файловой системы NFS. Предоставленные IP-адреса могут быть IP-адресами DNS-шлюза или решателя, управляемых и работающих клиентом в VPC клиента, или IP-адресами локальных DNS-серверов.
(string)
AutoExportPolicy -> (structure)
Этот параметр не поддерживается для Amazon File Cache.
Events -> (list)
AutoExportPolicy может иметь следующие значения событий:
-
NEW- Новые файлы и каталоги автоматически экспортируются в хранилище данных по мере добавления их в файловую систему. -
CHANGED- Изменения файлов и каталогов в файловой системе автоматически экспортируются в хранилище данных. -
DELETED- Файлы и каталоги автоматически удаляются из хранилища данных при удалении их из файловой системы.
Вы можете определить любую комбинацию типов событий для вашего AutoExportPolicy.
(string)
NextToken -> (string)
NextToken.
© Copyright 2025, Amazon Web Services. Created using Sphinx.