Spec-Zone.ru › AWS CLI v2

[ aws . workspaces ]

terminate-workspaces

Описание

Прекращает работу указанных WorkSpaces.

Предупреждение

Прекращение работы WorkSpace — это постоянное действие, которое невозможно отменить. Данные пользователя будут уничтожены. Если вам необходимо сохранить любые данные пользователя, обратитесь в службу поддержки Amazon Web Services, прежде чем прекратить работу WorkSpace.

Вы можете прекратить работу WorkSpace, находящегося в любом состоянии, кроме SUSPENDED.

Эта операция асинхронна и возвращает результат до полного завершения прекращения работы WorkSpaces. После прекращения работы WorkSpace состояние TERMINATED возвращается ненадолго перед очисткой метаданных каталога WorkSpace, поэтому это состояние редко возвращается. Чтобы подтвердить, что WorkSpace прекратил работу, проверьте идентификатор WorkSpace, используя DescribeWorkSpaces. Если идентификатор WorkSpace не возвращается, это означает, что WorkSpace успешно прекратил работу.

Примечание

Простые каталоги Active Directory (AD) и каталоги AD Connector предоставляются вам бесплатно для использования с WorkSpaces. Если WorkSpaces не используются с каталогом Simple AD или AD Connector в течение 30 последовательных дней, этот каталог будет автоматически аннулирован для использования с Amazon WorkSpaces, и вы будете оплачивать его в соответствии с ценами на услуги каталога.

Чтобы удалить пустые каталоги, см. Удаление каталога ваших WorkSpaces. Если вы удалите свой каталог Simple AD или AD Connector, вы всегда сможете создать новый, когда захотите снова начать использовать WorkSpaces.

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

Синтаксис

  terminate-workspaces
--terminate-workspace-requests <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]

Параметры

--terminate-workspace-requests (список)

WorkSpaces, которые необходимо прекратить. Вы можете указать до 25 WorkSpaces.

(структура)

Описывает информацию, используемую для прекращения работы WorkSpace.

WorkspaceId -> (строка)

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

Сокращенная форма:

--terminate-workspace-requests WorkspaceId1 WorkspaceId2 WorkspaceId3

Синтаксис JSON:

[
  {
    "WorkspaceId": "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.

Примеры

Примечание

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

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

Прекращение работы WorkSpace

Следующий terminate-workspaces пример прекращает работу указанного workspace.

aws workspaces terminate-workspaces \
    --terminate-workspace-requests ws-dk1xzr417

Вывод:

{
    "FailedRequests": []
}

Дополнительную информацию см. в разделе Удаление WorkSpace в Руководстве по администрированию Amazon WorkSpaces.

Вывод

FailedRequests -> (список)

Информация о WorkSpaces, которые не удалось прекратить.

(структура)

Описание WorkSpace, который не удалось перезагрузить (RebootWorkspaces), перестроить (RebuildWorkspaces), восстановить (RestoreWorkspace), прекратить работу (TerminateWorkspaces), запустить (StartWorkspaces) или остановить (StopWorkspaces).

WorkspaceId -> (строка)

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

ErrorCode -> (строка)

Код ошибки, возвращаемый, если WorkSpace не может быть перезагружен.

ErrorMessage -> (строка)

Текст сообщения об ошибке, возвращаемый, если WorkSpace не может быть перезагружен.

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

Spec-Zone.ru

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