Spec-Zone.ru › AWS CLI v2

[ aws . organizations ]

list-handshakes-for-account

Описание

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

Соглашения, находящиеся в состоянии ACCEPTED , DECLINED , CANCELED или EXPIRED, отображаются в результатах данного API в течение 30 дней после перехода в указанное состояние. После этого они удаляются и больше недоступны.

Примечание

Всегда проверяйте параметр ответа NextToken на наличие значения null при вызове операции List*. Эти операции могут иногда возвращать пустой набор результатов, даже если доступны дополнительные результаты. Значение параметра ответа NextToken равно null только тогда, когда больше результатов для отображения нет.

Данная операция может быть вызвана с любого счёта в организации.

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

list-handshakes-for-account является постраничной операцией. Для получения всего набора результатов может потребоваться несколько вызовов API. Вы можете отключить постраничную загрузку, указав аргумент --no-paginate. При использовании --output text и аргумента --query с постраничным ответом, аргумент --query должен извлекать данные из результатов следующих выражений запроса: Handshakes

Синтаксис

  list-handshakes-for-account
[--filter <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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]

Параметры

--filter (структура)

Фильтрует соглашения, которые должны быть включены в ответ. По умолчанию включаются все типы. Используйте элемент ActionType, чтобы ограничить вывод только указанным типом, например INVITE , ENABLE_ALL_FEATURES или APPROVE_ALL_FEATURES. В качестве альтернативы, для соглашения ENABLE_ALL_FEATURES, которое генерирует отдельное соглашение дочернего уровня для каждого счёта-члена, вы можете указать ParentHandshakeId, чтобы увидеть только соглашения, сгенерированные этим родительским запросом.

ActionType -> (строка)

Указывает тип действия соглашения.

Если вы укажете ActionType, вы не можете также указать ParentHandshakeId.

ParentHandshakeId -> (строка)

Указывает родительское соглашение. Используется только для типов соглашений, которые являются дочерними по отношению к другому типу.

Если вы укажете ParentHandshakeId, вы не можете также указать ActionType.

Шаблон регулярных выражений для строки идентификатора соглашения требует «h-», за которым следуют от 8 до 32 строчных букв или цифр.

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

ActionType=string,ParentHandshakeId=string

Синтаксис JSON:

{
  "ActionType": "INVITE"|"ENABLE_ALL_FEATURES"|"APPROVE_ALL_FEATURES"|"ADD_ORGANIZATIONS_SERVICE_LINKED_ROLE",
  "ParentHandshakeId": "string"
}

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON следует формату, указанному в --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные в JSON. Передача произвольных двоичных значений с помощью предоставленного значения JSON невозможна, так как строка будет интерпретироваться буквально. Это может не быть указано вместе с --cli-input-yaml.

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

Маркер для указания, с какой точки начать постраничный вывод. Это NextToken из ранее усеченного ответа.

Примеры использования см. в разделе «Постраничная загрузка» в Руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы, получаемой при обращении к службе AWS. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству обращений к службе AWS, получая меньше элементов в каждом обращении. Это может помочь предотвратить истечение времени ожидания вызовов служб AWS.

Примеры использования см. в разделе «Постраничная загрузка» в Руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов для возвращения в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken. Для возобновления постраничной загрузки укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе «Постраничная загрузка» в Руководстве пользователя AWS Command Line Interface.

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

Получение списка соглашений, отправленных на счёт

В следующем примере показано, как получить список всех соглашений, связанных со счётом, используемыми для вызова операции учетными данными:

aws organizations list-handshakes-for-account

Вывод включает список структур соглашений с информацией о каждом соглашении, включая его текущее состояние:

{
        "Handshake": {
                "Action": "INVITE",
                "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111",
                "ExpirationTimestamp": 1482952459.257,
                "Id": "h-examplehandshakeid111",
                "Parties": [
                        {
                                "Id": "o-exampleorgid",
                                "Type": "ORGANIZATION"
                        },
                        {
                                "Id": "juan@example.com",
                                "Type": "EMAIL"
                        }
                ],
                "RequestedTimestamp": 1481656459.257,
                "Resources": [
                        {
                                "Resources": [
                                        {
                                                "Type": "MASTER_EMAIL",
                                                "Value": "bill@amazon.com"
                                        },
                                        {
                                                "Type": "MASTER_NAME",
                                                "Value": "Org Master Account"
                                        },
                                        {
                                                "Type": "ORGANIZATION_FEATURE_SET",
                                                "Value": "FULL"
                                        }
                                ],
                                "Type": "ORGANIZATION",
                                "Value": "o-exampleorgid"
                        },
                        {
                                "Type": "EMAIL",
                                "Value": "juan@example.com"
                        }
                ],
                "State": "OPEN"
        }
}

Вывод

Рукопожатия -> (список)

Список объектов Рукопожатия с подробной информацией о каждом рукопожатии, связанном с указанной учетной записью.

(структура)

Содержит информацию, которая должна быть обменена для безопасного установления связи между двумя учетными записями (инициатором и получателем). Например, когда учетная запись управления (инициатор) приглашает другую учетную запись (получателя) присоединиться к своей организации, две учетные записи обмениваются информацией в виде серии запросов и ответов о рукопожатии.

Примечание: Рукопожатия, которые являются CANCELED , ACCEPTED , DECLINED или EXPIRED, отображаются в списках только 30 дней после перехода в указанное состояние. После этого они удаляются.

Id -> (строка)

Уникальный идентификатор (ID) рукопожатия. Инициаторская учетная запись создает ID при инициировании рукопожатия.

Шаблон регулярных выражений для строки идентификатора рукопожатия требует «h-», за которым следуют от 8 до 32 строчных букв или цифр.

Arn -> (строка)

Amazon Resource Name (ARN) рукопожатия.

Дополнительную информацию о значениях ARN в Организациях см. в разделе Форматы ARN, поддерживаемые Организациями, в Справочнике по авторизации служб Amazon Web Services.

Стороны -> (список)

Информация о двух учетных записях, участвующих в рукопожатии.

(структура)

Идентифицирует участника в рукопожатии.

Id -> (строка)

Уникальный идентификатор (ID) для стороны.

Шаблон регулярных выражений для строки идентификатора рукопожатия требует «h-», за которым следуют от 8 до 32 строчных букв или цифр.

Тип -> (строка)

Тип стороны.

Состояние -> (строка)

Текущее состояние рукопожатия. Используйте состояние для отслеживания потока рукопожатия через процесс от создания до его принятия. Значение каждого из допустимых значений следующее:

  • ЗАПРОШЕННОЕ : Это рукопожатие было отправлено нескольким получателям (применимо только к некоторым типам рукопожатий), и пока не все получатели ответили. Запрос остается в этом состоянии до тех пор, пока все получатели не ответят.
  • ОТКРЫТОЕ : Это рукопожатие было отправлено нескольким получателям (применимо только к некоторым типам политики) и все получатели ответили, что позволяет инициатору завершить действие рукопожатия.
  • ОТМЕНЕННОЕ : Это рукопожатие больше не активно, потому что оно было отменено инициатором.
  • ПРИНЯТОЕ : Это рукопожатие завершено, так как было принято получателем.
  • ОТКЛОНЕННОЕ : Это рукопожатие больше не активно, потому что оно было отклонено получателем.
  • ИСТЁКШЕЕ : Это рукопожатие больше не активно, потому что инициатор не получил никакого ответа от получателя до истечения срока действия (15 дней).

ДатаЗапроса -> (метка времени)

Дата и время запроса рукопожатия.

ДатаИстечения -> (метка времени)

Дата и время истечения срока действия рукопожатия. Если получатель запроса рукопожатия не отвечает до указанной даты и времени, рукопожатие становится неактивным и больше недействительным.

Действие -> (строка)

Тип рукопожатия, указывающий, какое действие происходит при принятии рукопожатия получателем. Поддерживаются следующие типы рукопожатий:

  • ПРИГЛАШЕНИЕ : Этот тип рукопожатия представляет собой запрос на присоединение к организации. Он всегда отправляется от учетной записи управления только учетным записям, которые не являются членами.
  • ВКЛЮЧИТЬ_ВСЕ_ФУНКЦИИ : Этот тип рукопожатия представляет собой запрос на включение всех функций в организации. Он всегда отправляется от учетной записи управления только приглашенным учетным записям-членам. Созданные учетные записи не получают этого, поскольку эти учетные записи были созданы учетной записью управления организации, и утверждение подразумевается.
  • УТВЕРДИТЬ_ВСЕ_ФУНКЦИИ : Этот тип рукопожатия отправляется службой Организации, когда все учетные записи-члены одобрили приглашение ENABLE_ALL_FEATURES. Оно отправляется только учетной записи управления и сигнализирует мастеру, что он может завершить процесс включения всех функций.

Ресурсы -> (список)

Дополнительная информация, необходимая для обработки рукопожатия.

(структура)

Содержит дополнительные данные, необходимые для обработки рукопожатия.

Значение -> (строка)

Информация, передаваемая другой стороне в рукопожатии. Формат строки значения должен соответствовать требованиям указанного типа.

Тип -> (строка)

Тип передаваемой информации, указывающий, как значение будет интерпретироваться другой стороной:

  • ACCOUNT - Указывает номер идентификатора учетной записи Amazon Web Services.
  • ORGANIZATION - Указывает номер идентификатора организации.
  • EMAIL - Указывает адрес электронной почты, связанный с учетной записью, которая получает рукопожатие.
  • OWNER_EMAIL - Указывает адрес электронной почты, связанный с учетной записью управления. Включено в качестве информации об организации.
  • OWNER_NAME - Указывает имя, связанное с учетной записью управления. Включено в качестве информации об организации.
  • NOTES - Дополнительный текст, предоставленный инициатором рукопожатия, предназначенный для прочтения получателем.

Ресурсы -> (список)

При необходимости содержит дополнительный массив объектов HandshakeResource.

(структура)

Содержит дополнительные данные, необходимые для обработки рукопожатия.

Значение -> (строка)

Информация, передаваемая другой стороне в рукопожатии. Формат строки значения должен соответствовать требованиям указанного типа.

Тип -> (строка)

Тип передаваемой информации, указывающий, как значение будет интерпретироваться другой стороной:

  • ACCOUNT - Указывает номер идентификатора учетной записи Amazon Web Services.
  • ORGANIZATION - Указывает номер идентификатора организации.
  • EMAIL - Указывает адрес электронной почты, связанный с учетной записью, которая получает рукопожатие.
  • OWNER_EMAIL - Указывает адрес электронной почты, связанный с учетной записью управления. Включено в качестве информации об организации.
  • OWNER_NAME - Указывает имя, связанное с учетной записью управления. Включено в качестве информации об организации.
  • NOTES - Дополнительный текст, предоставленный инициатором рукопожатия, предназначенный для прочтения получателем.

СледующийТокен -> (строка)

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

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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