Spec-Zone.ru › AWS CLI v2

[ aws . fsx ]

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

Устанавливает версию Lustre для кэша, который вы создаёте, которая должна быть 2.12.

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

Ёмкость кэша в гигабайтах (GiB). Допустимые значения: 1200 GiB, 2400 GiB и приращения по 2400 GiB.

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

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

(строка)

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

Синтаксис:

"string" "string" ...

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

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

(строка)

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

Синтаксис:

"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 (булево)

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

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

Указывает идентификатор ключа службы управления ключами (KMS), который нужно использовать для шифрования данных в Amazon File Cache. Если KmsKeyId не указан, используется управляемый Amazon FSx ключ KMS для вашей учетной записи. Для получения дополнительной информации см. Encrypt в справочнике API службы управления ключами.

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

Конфигурация ресурса Amazon File Cache, который создаётся.

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

Зарезервированный объём пропускной способности чтения и записи на каждый 1 тебибайт (TiB) ёмкости кэша в МБ/с/TiB. Поддерживается только значение 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 -> (целое число)

Ёмкость хранилища объёма Lustre MDT (Metadata Target) в гигабайтах (GiB). Поддерживается только значение 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 -> (строка)

Версия протокола NFS (Network File System) хранилища данных NFS. Поддерживается только значение 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 -> (строка)

Идентификатор учетной записи Amazon Web Services. Этот идентификатор — 12-значное число, которое используется для построения имен ресурсов Amazon Resource Names (ARN).

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

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

FileCacheId -> (строка)

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

FileCacheType -> (строка)

Тип кэша, который должен быть LUSTRE .

FileCacheTypeVersion -> (строка)

Версия Lustre кэша, которая должна быть 2.12 .

Lifecycle -> (строка)

Статус жизненного цикла кэша. Следующие значения и их соответствия:

  • AVAILABLE - Кэш находится в работоспособном состоянии, доступен и готов к использованию.
  • CREATING - Новый кэш создается.
  • DELETING - Существующий кэш удаляется.
  • UPDATING - Кэш проходит обновление, инициированное пользователем.
  • FAILED - Существующий кэш испытывает необратимую ошибку. При создании нового кэша его невозможно создать.

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

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

Message -> (строка)

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

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

Ёмкость кэша в гибибайтах (GiB).

VpcId -> (строка)

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

SubnetIds -> (список)

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

(строка)

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

NetworkInterfaceIds -> (список)

Список идентификаторов сетевых интерфейсов.

(строка)

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

DNSName -> (строка)

Имя домена системы доменных имен (DNS) для кэша.

KmsKeyId -> (строка)

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

ResourceARN -> (строка)

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

Tags -> (список)

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

(структура)

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

Key -> (строка)

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

Value -> (строка)

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

CopyTagsToDataRepositoryAssociations -> (boolean)

Флаг boolean, указывающий, следует ли копировать теги кэша в ассоциации репозиториев данных.

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

Настройки для ресурса Amazon File Cache.

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

Производительность на единицу хранения представляет собой мегабайты в секунду пропускной способности чтения или записи на 1 тебибайт предоставленного хранилища. Ёмкость пропускной способности кэша равна ёмкости хранилища (TiB) * Производительность на единицу хранения (МБ/с/TiB). Поддерживается только значение 1000 .

DeploymentType -> (строка)

Тип развертывания ресурса Amazon File Cache, который должен быть 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 -> (целое число)

Ёмкость хранилища Lustre MDT (Metadata Target) в гибибайтах (GiB). Поддерживается только значение 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 -> (строка)

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

DataRepositoryAssociationIds -> (список)

Список идентификаторов ассоциаций репозиториев данных, связанных с этим кэшем.

(строка)

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API