create-file-system

Описание

Создаёт новый пустой файловый сервер. Для операции требуется маркер создания в запросе, который Amazon EFS использует для обеспечения идемпотентности создания (вызов операции с тем же маркером создания не имеет эффекта). Если файловый сервер в настоящее время не существует и принадлежит учётной записи вызывающего Amazon Web Services с указанным маркером создания, эта операция выполняет следующие действия:

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

В противном случае эта операция возвращает ошибку FileSystemAlreadyExists с идентификатором существующего файлового сервера.

Идемпотентная операция позволяет повторно выполнить CreateFileSystem вызов без риска создания дополнительного файлового сервера. Это может произойти, когда начальный вызов завершается таким образом, что неясно, был ли файловый сервер на самом деле создан. Примером может служить таймаут транспортного уровня или сброс соединения. Пока вы используете тот же маркер создания, если начальный вызов успешно создал файловый сервер, клиент может узнать о его существовании по ошибке FileSystemAlreadyExists.

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

Эта операция принимает необязательный PerformanceMode параметр, который вы выбираете для своего файлового сервера. Мы рекомендуем generalPurpose PerformanceMode для всех файловых серверов. Режим maxIO — это предыдущий тип производительности, предназначенный для высокопараллельных рабочих нагрузок, которые могут терпеть более высокие задержки, чем режим generalPurpose. Режим MaxIO не поддерживается для файловых серверов одной зоны или файловых серверов, использующих упругий пропуск.

PerformanceMode не может быть изменён после создания файлового сервера. Дополнительную информацию см. в разделе Режимы производительности Amazon EFS .

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

После того, как файловый сервер будет полностью создан, Amazon EFS установит его состояние жизненного цикла в available, в этот момент вы можете создать одну или несколько целевых точек подключения для файлового сервера в вашей VPC. Дополнительную информацию см. в разделе CreateMountTarget. Вы подключаетесь к файловому серверу Amazon EFS на экземплярах EC2 в вашей VPC, используя целевую точку подключения. Дополнительную информацию см. в разделе Amazon EFS: Как это работает .

Для этой операции требуются разрешения на действие elasticfilesystem:CreateFileSystem.

Файловые серверы могут быть помечены при создании. Если теги указаны в операции создания, IAM выполняет дополнительный авторизацию действия elasticfilesystem:TagResource, чтобы проверить, имеют ли пользователи разрешения на создание тегов. Поэтому вы должны предоставить явные разрешения для использования действия elasticfilesystem:TagResource. Дополнительную информацию см. в разделе Назначение разрешений для тегов ресурсов при создании .

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

Синтаксис

  create-file-system
[--creation-token <value>]
[--performance-mode <value>]
[--encrypted | --no-encrypted]
[--kms-key-id <value>]
[--throughput-mode <value>]
[--provisioned-throughput-in-mibps <value>]
[--availability-zone-name <value>]
[--backup | --no-backup]
[--tags <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]

Параметры

--creation-token (строка)

--performance-mode (строка)

--encrypted | --no-encrypted (булево)

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

--throughput-mode (строка)

--provisioned-throughput-in-mibps (двойное число)

--availability-zone-name (строка)

--backup | --no-backup (булево)

--tags (список)

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

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "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 (string)

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (string)

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

• json
• text
• table
• yaml
• yaml-stream

--query (string)

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

--profile (string)

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

--region (string)

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

--version (string)

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

--color (string)

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

• on
• off
• auto

--no-sign-request (boolean)

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

--ca-bundle (string)

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

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

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной строки base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку 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.

Примеры

Для создания зашифрованного файлового хранилища

Следующий create-file-system пример создаёт зашифрованное файловое хранилище, используя по умолчанию CMK. Он также добавляет тег Name=my-file-system.

aws efs create-file-system \
    --performance-mode generalPurpose \
    --throughput-mode bursting \
    --encrypted \
    --tags Key=Name,Value=my-file-system

Вывод:

{
    "OwnerId": "123456789012",
    "CreationToken": "console-d7f56c5f-e433-41ca-8307-9d9c0example",
    "FileSystemId": "fs-c7a0456e",
    "FileSystemArn": "arn:aws:elasticfilesystem:us-west-2:123456789012:file-system/fs-48499b4d",
    "CreationTime": 1595286880.0,
    "LifeCycleState": "creating",
    "Name": "my-file-system",
    "NumberOfMountTargets": 0,
    "SizeInBytes": {
        "Value": 0,
        "ValueInIA": 0,
        "ValueInStandard": 0
    },
    "PerformanceMode": "generalPurpose",
    "Encrypted": true,
    "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/a59b3472-e62c-42e4-adcf-30d92example",
    "ThroughputMode": "bursting",
    "Tags": [
        {
            "Key": "Name",
            "Value": "my-file-system"
        }
    ]
}

Дополнительную информацию см. в руководстве пользователя Amazon Elastic File System по созданию файловых систем Amazon EFS.

Вывод

OwnerId -> (string)

CreationToken -> (string)

FileSystemId -> (string)

FileSystemArn -> (string)

CreationTime -> (timestamp)

LifeCycleState -> (string)

Name -> (string)

NumberOfMountTargets -> (integer)

SizeInBytes -> (structure)

PerformanceMode -> (string)

Encrypted -> (boolean)

KmsKeyId -> (string)

ThroughputMode -> (string)

ProvisionedThroughputInMibps -> (double)

AvailabilityZoneName -> (string)

AvailabilityZoneId -> (string)

Tags -> (list)

FileSystemProtection -> (structure)