create-file-cache
Описание
Создаёт новый ресурс Amazon File Cache.
Вы можете использовать запрос с маркером клиента в запросе, который Amazon File Cache использует для обеспечения идемпотентного создания. Если кэш с указанным маркером клиента существует и параметры совпадают, CreateFileCache возвращает описание существующего кэша. Если кэш с указанным маркером клиента существует, а параметры не совпадают, этот вызов возвращает IncompatibleParameterError. Если кэш с указанным маркером клиента не существует, CreateFileCache выполняет следующие действия:
- Создаёт новый пустой ресурс Amazon File Cache с назначенным идентификатором и начальным состоянием жизненного цикла
CREATING. - Возвращает описание кэша в формате JSON.
Примечание
ВызовCreateFileCache возвращает результат, пока состояние жизненного цикла кэша всё ещё CREATING. Вы можете проверить статус создания кэша, вызвав операцию DescribeFileCaches, которая возвращает состояние кэша вместе с другой информацией.См. также: AWS API документация
Синтаксис
create-file-cache
[--client-request-token <value>]
--file-cache-type <value>
--file-cache-type-version <value>
--storage-capacity <value>
--subnet-ids <value>
[--security-group-ids <value>]
[--tags <value>]
[--copy-tags-to-data-repository-associations | --no-copy-tags-to-data-repository-associations]
[--kms-key-id <value>]
[--lustre-configuration <value>]
[--data-repository-associations <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 символов. Этот маркер автоматически заполняется от вашего имени, когда вы используете командную строку (CLI) или Amazon Web Services SDK.
Используя идемпотентную операцию, вы можете повторить операцию CreateFileCache без риска создания дополнительного кэша. Этот подход может быть полезен, когда первоначальный вызов завершается неудачно, и неясно, был ли создан кэш. Примерами являются таймаут транспортного уровня или сброс соединения. Если вы используете тот же токен запроса клиента и первоначальный вызов создал кэш, клиент получает успех, пока параметры остаются неизменными.
--file-cache-type (строка)
Тип кэша, который вы создаёте, который должен быть LUSTRE.
Возможные значения:
LUSTRE
--file-cache-type-version (строка)
2.12.--storage-capacity (целое число)
--subnet-ids (список)
Список идентификаторов подсетей, из которых кэш будет доступен. Вы можете указать только один идентификатор подсети в вызове операции CreateFileCache.
(строка)
Синтаксис:
"string" "string" ...
--security-group-ids (список)
Список идентификаторов, указывающих на группы безопасности, которые применяются ко всем сетевым интерфейсам, созданным для доступа к Amazon File Cache. Этот список не возвращается в последующих запросах для описания кэша.
(строка)
Синтаксис:
"string" "string" ...
--tags (список)
Список значений Tag, с максимальным количеством 50 элементов.
(структура)
Указывает пару ключ-значение для тега ресурса.
Ключ -> (строка)
TagKey, имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.Значение -> (строка)
TagValue, значение, назначенное соответствующему ключу тега. Значения тегов могут быть null и не обязательно должны быть уникальными в наборе тегов. Например, вы можете иметь пару ключ-значение в наборе тегов finances : April, а также payroll : April.Сокращенный синтаксис:
Key=string,Value=string ...
JSON-синтаксис:
[
{
"Key": "string",
"Value": "string"
}
...
]
--copy-tags-to-data-repository-associations | --no-copy-tags-to-data-repository-associations (булево)
--kms-key-id (строка)
KmsKeyId не указан, используется управляемый Amazon FSx ключ KMS для вашей учетной записи. Для получения дополнительной информации см. Encrypt в справочнике API службы управления ключами.--lustre-configuration (структура)
Конфигурация ресурса Amazon File Cache, который создаётся.
PerUnitStorageThroughput -> (целое число)
1000.DeploymentType -> (строка)
CACHE_1.WeeklyMaintenanceStartTime -> (строка)
Еженедельное время повторения в формате D:HH:MM.
D — день недели, где 1 соответствует понедельнику, а 7 — воскресенью. Для получения дополнительной информации см. спецификацию ISO-8601 на Википедии.
HH — нулевое заполнение часа (0-23), а MM — нулевое заполнение минуты (0-59).
Например, 1:05:00 указывает обслуживание в 5:00 по понедельникам.
MetadataConfiguration -> (структура)
Конфигурация хранилища объёма Lustre MDT (Metadata Target).
StorageCapacity -> (целое число)
2400 GiB.Сокращенный синтаксис:
PerUnitStorageThroughput=integer,DeploymentType=string,WeeklyMaintenanceStartTime=string,MetadataConfiguration={StorageCapacity=integer}
JSON-синтаксис:
{
"PerUnitStorageThroughput": integer,
"DeploymentType": "CACHE_1",
"WeeklyMaintenanceStartTime": "string",
"MetadataConfiguration": {
"StorageCapacity": integer
}
}
--data-repository-associations (список)
Список до 8 конфигураций ассоциаций хранилищ данных (DRA), которые должны быть созданы во время создания кэша. DRA связывают кэш с хранилищем данных Amazon S3 или хранилищем данных Network File System (NFS), поддерживающим протокол NFSv3.
Конфигурации DRA должны соответствовать следующим требованиям:
- Все конфигурации в списке должны быть одного типа хранилища данных, либо все S3, либо все NFS. Кэш не может одновременно подключаться к разным типам хранилищ данных.
- NFS DRA должен связываться с файловой системой NFS, которая поддерживает протокол NFSv3.
Автоматический импорт и экспорт DRA не поддерживается.
(структура)
Конфигурация ассоциации хранилища данных (DRA), которая создаётся во время создания ресурса Amazon File Cache. DRA связывает кэш с ведром или префиксом Amazon S3, или хранилищем данных Network File System (NFS), поддерживающим протокол NFSv3.
DRA не поддерживает автоматический импорт или экспорт.
FileCachePath -> (строка)
Путь в кэше, указывающий на каталог высокого уровня (например, /ns1/) или подкаталог (например, /ns1/subdir/), которые будут отображаться 1:1 с DataRepositoryPath. Требуется ведущий слеш в имени. Две ассоциации хранилищ данных не могут иметь перекрывающиеся пути кэша. Например, если ассоциация хранилища данных связана с путём кэша /ns1/, то вы не можете связать другое хранилище данных с путём кэша /ns1/ns2.
Этот путь указывает, откуда в кэше будут экспортироваться файлы. Этот каталог кэша может быть связан только с одним хранилищем данных, и никакое другое хранилище данных не может быть связано с каталогом.
Примечание
Путь к кэшу может быть установлен только в корень (/) в NFS DRA, когда DataRepositorySubdirectories указан. Если вы указываете корень (/), вы можете создать только одну DRA в кэше.
Путь к кэшу не может быть установлен в корень (/) для S3 DRA.
DataRepositoryPath -> (строка)
Путь к хранилищу данных S3 или NFS, который связывается с кэшем. Вы должны указать один из следующих путей:
- Путь может быть хранилищем данных NFS, которое связывается с кэшем. Путь может быть в одном из двух форматов:
- Если вы не используете параметр
DataRepositorySubdirectories, путь указывает на каталог экспорта NFS (или один из его подкаталогов) в форматеnfs://nfs-domain-name/exportpath. Таким образом, вы можете связать один экспорт NFS с одной ассоциацией хранилища данных. - Если вы используете параметр
DataRepositorySubdirectories, путь указывает на доменное имя файловой системы NFS в форматеnfs://filer-domain-name, который указывает на корень подкаталогов, указанных параметромDataRepositorySubdirectories.
- Если вы не используете параметр
- Путь может быть ведром или префиксом S3 в формате
s3://bucket-name/prefix/(гдеprefixнеобязательно).
DataRepositorySubdirectories -> (список)
Список экспортов NFS, которые будут связаны с этой ассоциацией хранилища данных. Пути экспорта находятся в формате /exportpath1. Для использования этого параметра необходимо задать DataRepositoryPath как доменное имя файловой системы NFS. Доменное имя файловой системы NFS фактически является корнем подкаталогов. Обратите внимание, что DataRepositorySubdirectories не поддерживается для хранилищ данных S3.
(строка)
NFS -> (структура)
Конфигурация ассоциации хранилища данных, которая связывает Amazon File Cache с хранилищем данных NFS.
Version -> (строка)
NFS3, которое указывает, что хранилище данных должно поддерживать протокол NFSv3.DnsIps -> (список)
Список до 2 IP-адресов DNS-серверов, используемых для разрешения доменного имени файловой системы NFS. Предоставленные IP-адреса могут быть IP-адресами DNS-forwarder или -resolver, управляемыми и работающими внутри VPC клиента, или IP-адресами локальных DNS-серверов.
(строка)
Сокращенный синтаксис:
FileCachePath=string,DataRepositoryPath=string,DataRepositorySubdirectories=string,string,NFS={Version=string,DnsIps=[string,string]} ...
JSON-синтаксис:
[
{
"FileCachePath": "string",
"DataRepositoryPath": "string",
"DataRepositorySubdirectories": ["string", ...],
"NFS": {
"Version": "NFS3",
"DnsIps": ["string", ...]
}
}
...
]
--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 (boolean)
Включить отладку регистрации.
--endpoint-url (строка)
Переопределить значение URL по умолчанию для команды заданным URL.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI проверяет SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (boolean)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования для вывода команд.
- json
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из файла учетных данных.
--region (строка)
Используемый регион. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--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 (boolean)
Отключить вывод страницы cli.
--cli-auto-prompt (boolean)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запросы параметров ввода CLI.
Вывод
FileCache -> (структура)
Описание созданного кэша.
OwnerId -> (строка)
CreationTime -> (временная метка)
FileCacheId -> (строка)
FileCacheType -> (строка)
LUSTRE .FileCacheTypeVersion -> (строка)
2.12 .Lifecycle -> (строка)
Статус жизненного цикла кэша. Следующие значения и их соответствия:
-
AVAILABLE- Кэш находится в работоспособном состоянии, доступен и готов к использованию. -
CREATING- Новый кэш создается. -
DELETING- Существующий кэш удаляется. -
UPDATING- Кэш проходит обновление, инициированное пользователем. -
FAILED- Существующий кэш испытывает необратимую ошибку. При создании нового кэша его невозможно создать.
FailureDetails -> (структура)
Структура, содержащая подробности о любых ошибках, произошедших при создании кэша.
Message -> (строка)
StorageCapacity -> (целое число)
VpcId -> (строка)
SubnetIds -> (список)
Список идентификаторов подсетей, из которых кэш будет доступен. В вызове операции CreateFileCache можно указать только один идентификатор подсети.
(строка)
NetworkInterfaceIds -> (список)
Список идентификаторов сетевых интерфейсов.
(строка)
DNSName -> (строка)
KmsKeyId -> (строка)
KmsKeyId не указан, используется управляемый Amazon FSx ключ KMS для вашей учетной записи. Дополнительную информацию можно найти в разделе «Шифрование» в справочнике API службы управления ключами.ResourceARN -> (строка)
Tags -> (список)
Список значений тегов, с максимальным количеством 50 элементов.
(структура)
Указывает пару ключ-значение для тега ресурса.
Key -> (строка)
TagKey, имя тега. Ключи тегов должны быть уникальными для ресурса, к которому они прикреплены.Value -> (строка)
TagValue, значение, назначенное соответствующему ключу тега. Значения тегов могут быть null и не обязательно должны быть уникальными в наборе тегов. Например, вы можете иметь пару ключ-значение в наборе тегов finances : April и также payroll : April .CopyTagsToDataRepositoryAssociations -> (boolean)
LustreConfiguration -> (структура)
Настройки для ресурса Amazon File Cache.
PerUnitStorageThroughput -> (целое число)
1000 .DeploymentType -> (строка)
CACHE_1 .MountName -> (строка)
MountName используется при подключении к кэшу. Если вы передадите идентификатор кэша в операцию DescribeFileCaches, она вернёт значение MountName в качестве части описания кэша.WeeklyMaintenanceStartTime -> (строка)
Еженедельное время, в формате D:HH:MM .
D — это день недели, где 1 — понедельник, а 7 — воскресенье. Для получения более подробной информации см. спецификацию ISO-8601 на Википедии.
HH — нулевое заполнение часа суток (0-23), а MM — нулевое заполнение минуты часа.
Например, 1:05:00 указывает обслуживание в 5:00 по понедельникам.
MetadataConfiguration -> (структура)
Настройки для объёма хранилища Lustre MDT (Metadata Target).
StorageCapacity -> (целое число)
2400 GiB.LogConfiguration -> (структура)
Настройки для ведения журнала Lustre, используемые для записи событий регистрации, включенных для вашего ресурса Amazon File Cache, в Amazon CloudWatch Logs.
Level -> (строка)
События репозиториев данных, регистрируемые Amazon FSx.
-
WARN_ONLY- регистрируются только предупреждения. -
ERROR_ONLY- регистрируются только ошибки. -
WARN_ERROR- регистрируются как предупреждения, так и ошибки. -
DISABLED- регистрация событий репозитория данных выключена.
Обратите внимание, что Amazon File Cache использует значение по умолчанию WARN_ERROR, которое нельзя изменить.
Destination -> (строка)
DataRepositoryAssociationIds -> (список)
Список идентификаторов ассоциаций репозиториев данных, связанных с этим кэшем.
(строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.