создать-точку-монтирования

Описание

Создает точку монтирования для файловой системы. Затем вы можете смонтировать файловую систему на экземпляры EC2, используя точку монтирования.

Вы можете создать одну точку монтирования в каждой зоне доступности в вашей VPC. Все экземпляры EC2 в VPC в данной зоне доступности используют одну общую точку монтирования для данной файловой системы. Если у вас несколько подсетей в зоне доступности, вы создаёте точку монтирования в одной из подсетей. Экземплярам EC2 не нужно находиться в той же подсети, что и точка монтирования, для доступа к файловой системе.

Вы можете создать только одну точку монтирования для файловой системы One Zone. Вы должны создать эту точку монтирования в той же зоне доступности, в которой расположена файловая система. Используйте свойства AvailabilityZoneName и AvailabiltyZoneId в объекте ответа DescribeFileSystems, чтобы получить эту информацию. Используйте значение subnetId, связанное с зоной доступности файловой системы при создании точки монтирования.

Дополнительную информацию см. в Amazon EFS: Как это работает .

Для создания точки монтирования для файловой системы состояние жизненного цикла файловой системы должно быть available . Дополнительную информацию см. в DescribeFileSystems .

В запросе укажите следующее:

• Идентификатор файловой системы, для которой вы создаёте точку монтирования.
• Идентификатор подсети, который определяет следующее:
  • VPC, в которой Amazon EFS создаёт точку монтирования
  • Зону доступности, в которой Amazon EFS создаёт точку монтирования
  • Диапазон IP-адресов, из которого Amazon EFS выбирает IP-адрес точки монтирования (если вы не указали IP-адрес в запросе)

После создания точки монтирования Amazon EFS возвращает ответ, содержащий MountTargetId и IpAddress. Вы используете этот IP-адрес при монтировании файловой системы на экземпляре EC2. Вы также можете использовать DNS-имя точки монтирования при монтировании файловой системы. Экземпляр EC2, на котором вы монтируете файловую систему с помощью точки монтирования, может разрешить DNS-имя точки монтирования до её IP-адреса. Дополнительную информацию см. в How it Works: Обзор реализации .

Обратите внимание, что вы можете создать точки монтирования для файловой системы только в одной VPC, и может быть только одна точка монтирования на одну зону доступности. То есть, если для файловой системы уже создано одна или несколько точек монтирования, подсеть, указанная в запросе для добавления ещё одной точки монтирования, должна удовлетворять следующим требованиям:

• Должна принадлежать той же VPC, что и подсети существующих точек монтирования
• Не должна находиться в той же зоне доступности, что и любая из подсетей существующих точек монтирования

Если запрос удовлетворяет требованиям, Amazon EFS выполняет следующие действия:

• Создаёт новую точку монтирования в указанной подсети.
• Также создаёт новый сетевой интерфейс в подсети следующим образом:
  • Если запрос предоставляет IpAddress, Amazon EFS назначает этот IP-адрес сетевому интерфейсу. В противном случае Amazon EFS назначает свободный адрес в подсети (так же, как и вызов Amazon EC2 CreateNetworkInterface, когда запрос не указывает первичный частный IP-адрес).
  • Если запрос предоставляет SecurityGroups, этот сетевой интерфейс ассоциируется с этими группами безопасности. В противном случае он принадлежит группе безопасности по умолчанию для VPC подсети.
  • Присваивает описание Mount target *fsmt-id* for file system *fs-id* `` where `` *fsmt-id* `` is the mount target ID, and `` *fs-id* `` is the ``FileSystemId.
  • Устанавливает свойство requesterManaged сетевого интерфейса в true, а значение requesterId в EFS.

У каждой точки монтирования Amazon EFS есть один соответствующий сетевой интерфейс EC2, управляемый запросом. После создания сетевого интерфейса Amazon EFS устанавливает поле NetworkInterfaceId в описании точки монтирования в идентификатор сетевого интерфейса и поле IpAddress в его адрес. Если создание сетевого интерфейса завершается ошибкой, вся операция CreateMountTarget завершается ошибкой.

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

Для этой операции требуются разрешения на выполнение следующего действия для файловой системы:

• elasticfilesystem:CreateMountTarget

Для этой операции также требуются разрешения на следующие действия Amazon EC2:

• ec2:DescribeSubnets
• ec2:DescribeNetworkInterfaces
• ec2:CreateNetworkInterface

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

Синтаксис

  create-mount-target
--file-system-id <value>
--subnet-id <value>
[--ip-address <value>]
[--security-groups <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]

Параметры

--file-system-id (строка)

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

--ip-address (строка)

--security-groups (список)

Синтаксис:

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

Включить отладочную запись.

--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.

Примеры

Для создания точки монтирования

Следующий пример create-mount-target создаёт точку монтирования для указанной файловой системы.

aws efs create-mount-target \
    --file-system-id fs-c7a0456e \
    --subnet-id subnet-02bf4c428bexample \
    --security-groups sg-068f739363example

Вывод:

{
    "OwnerId": "123456789012",
    "MountTargetId": "fsmt-f9a14450",
    "FileSystemId": "fs-c7a0456e",
    "SubnetId": "subnet-02bf4c428bexample",
    "LifeCycleState": "creating",
    "IpAddress": "10.0.1.24",
    "NetworkInterfaceId": "eni-02d542216aexample",
    "AvailabilityZoneId": "use2-az2",
    "AvailabilityZoneName": "us-east-2b",
    "VpcId": "vpc-0123456789abcdef0"
}

Дополнительную информацию см. в разделе Создание точек монтирования в Руководстве пользователя Amazon Elastic File System.

Вывод

OwnerId -> (строка)

MountTargetId -> (строка)

FileSystemId -> (строка)

SubnetId -> (строка)

LifeCycleState -> (строка)

IpAddress -> (строка)

NetworkInterfaceId -> (строка)

AvailabilityZoneId -> (строка)

AvailabilityZoneName -> (строка)

VpcId -> (строка)