Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

отсоединить-том

Описание

Отсоединяет том EBS от экземпляра. Убедитесь, что вы отключили все файловые системы на устройстве в вашей операционной системе перед отсоединением тома. Если этого не сделать, том может зависнуть в состоянии busy во время отсоединения. В этом случае отсоединение может быть задерживано неопределенно долго, пока вы не отключите том, не принудительно не отсоедините его, не перезапустите экземпляр или не выполните все три действия. Если том EBS является корневым устройством экземпляра, его нельзя отсоединить, пока экземпляр работает. Чтобы отсоединить корневой том, сначала остановите экземпляр.

При отсоединении тома с кодом продукта Amazon Web Services Marketplace от экземпляра, код продукта больше не ассоциируется с экземпляром.

Вы не можете отсоединить или принудительно отсоединить тома, подключенные к задачам Amazon ECS или Fargate. Попытка сделать это приводит к исключению UnsupportedOperationException с сообщением об ошибке Unable to detach volume attached to ECS tasks.

Для получения дополнительной информации см. Отсоединение тома Amazon EBS в Руководстве пользователя Amazon EBS.

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

Синтаксис

  detach-volume
[--device <value>]
[--force | --no-force]
[--instance-id <value>]
--volume-id <value>
[--dry-run | --no-dry-run]
[--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]

Параметры

--device (строка)

Имя устройства.

--force | --no-force (логическое значение)

Принудительно отсоединяет, если предыдущая попытка отсоединения не прошла успешно (например, вы вошли в экземпляр, отключили том и попытались отсоединить его обычным способом). Этот параметр может привести к потере данных или повреждению файловой системы. Используйте этот параметр только в крайнем случае для отсоединения тома от неисправного экземпляра. Экземпляр не сможет сбросить кэш файловой системы или метаданные файловой системы. Если вы используете этот параметр, вы должны выполнить проверку и ремонт файловой системы.

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

Идентификатор экземпляра. Если вы отсоединяете том, поддерживающий многократное подключение, вы должны указать идентификатор экземпляра.

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

Идентификатор тома.

--dry-run | --no-dry-run (логическое значение)

Проверяет, имеете ли вы необходимые разрешения для действия, не отправляя фактический запрос, и возвращает ответ об ошибке. Если у вас есть необходимые разрешения, ответ об ошибке будет DryRunOperation. В противном случае — UnauthorizedOperation.

--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
  • текст
  • таблица
  • 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.

Примеры

Примечание

Для использования следующих примеров вам необходимо установить и настроить AWS CLI. Дополнительные сведения см. в руководстве по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила кавычек, подобные unix-like. Эти примеры необходимо адаптировать к правилам кавычек вашей оболочки. См. раздел Использование кавычек со строками в Руководстве пользователя AWS CLI.

Для отсоединения тома от экземпляра

В этом примере команды отсоединяется том (vol-049df61146c4d7901) от экземпляра, к которому он подключен.

Команда:

aws ec2 detach-volume --volume-id vol-1234567890abcdef0

Вывод:

{
    "AttachTime": "2014-02-27T19:23:06.000Z",
    "InstanceId": "i-1234567890abcdef0",
    "VolumeId": "vol-049df61146c4d7901",
    "State": "detaching",
    "Device": "/dev/sdb"
}

Вывод

DeleteOnTermination -> (логическое значение)

Указывает, удаляется ли том EBS при завершении работы экземпляра.

AssociatedResource -> (строка)

ARN задачи Amazon ECS или Fargate, к которой подключен том.

InstanceOwningService -> (строка)

Основной принцип сервиса Amazon Web Services, владеющего основным экземпляром, к которому подключен том.

Этот параметр возвращается только для томов, подключенных к задачам Fargate.

VolumeId -> (строка)

Идентификатор тома.

InstanceId -> (строка)

Идентификатор экземпляра.

Если том подключен к задаче Fargate, этот параметр возвращает null.

Device -> (строка)

Имя устройства.

Если том подключен к задаче Fargate, этот параметр возвращает null.

State -> (строка)

Состояние подключения тома.

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

Временная метка начала подключения.

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

Spec-Zone.ru

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