Spec-Zone.ru › AWS CLI v2

[ aws . resource-explorer-2 ]

изменение типа индекса

Описание

Изменяет тип индекса с одного из следующих типов на другой. Более подробную информацию об индексах и их роли в Amazon Web Services Resource Explorer см. в разделе Включение межрегионального поиска путем создания индекса агрегатора в руководстве пользователя Amazon Web Services Resource Explorer.

  • Тип индекса «АГРЕГАТОР» Индекс содержит информацию о ресурсах из всех регионов Amazon Web Services в учетной записи Amazon Web Services, в которой вы создали индекс Resource Explorer. Информация о ресурсах из всех других регионов дублируется в индекс этого региона. При изменении типа индекса на AGGREGATOR Resource Explorer включает дублирование всей обнаруженной информации о ресурсах из других регионов Amazon Web Services в вашей учетной записи в этот индекс. Затем вы сможете выполнять запросы поиска ресурсов, охватывающие все регионы Amazon Web Services в вашей учетной записи Amazon Web Services, только из этого региона. Включение дублирования из всех других регионов выполняется асинхронными фоновыми задачами. Вы можете проверить статус асинхронных задач, используя операцию GetIndex. После завершения асинхронных задач ответ операции Status изменяется с UPDATING на ACTIVE. После этого вы можете начать видеть результаты из других регионов Amazon Web Services в результатах запросов. Однако на дублирование из всех других регионов может потребоваться несколько часов.

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

В одной учетной записи Amazon Web Services может быть только один индекс агрегатора. Прежде чем вы сможете повысить другой индекс до статуса индекса агрегатора для учетной записи, необходимо сначала понизить существующий индекс агрегатора до типа LOCAL.
  • Тип индекса «МЕСТНЫЙ» Индекс содержит информацию о ресурсах только в регионе Amazon Web Services, в котором существует индекс. Если существует индекс агрегатора в другом регионе, то информация в этом локальном индексе дублируется в индекс агрегатора. При изменении типа индекса на LOCAL Resource Explorer отключает дублирование информации о ресурсах из всех других регионов Amazon Web Services в вашей учетной записи Amazon Web Services в этот регион. Индекс агрегатора остается в состоянии UPDATING до тех пор, пока не завершится весь процесс дублирования с другими регионами. Вы можете проверить статус асинхронной задачи, используя операцию GetIndex. Когда Resource Explorer успешно останавливает весь процесс дублирования с другими регионами, ответ операции Status изменяется с UPDATING на ACTIVE. Отдельно информация о ресурсах из других регионов, которая ранее хранилась в индексе, удаляется в течение 30 дней другой фоновой задачей. До тех пор, пока эта асинхронная задача не будет выполнена, некоторые результаты из других регионов могут по-прежнему отображаться в результатах поиска.

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

После понижения индекса агрегатора до локального индекса необходимо подождать 24 часа, прежде чем можно будет повысить другой индекс до нового индекса агрегатора для учетной записи.

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

Синтаксис

  update-index-type
--arn <value>
--type <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]

Параметры

--arn (строка)

Amazon Resource Name (ARN) индекса, который необходимо обновить.

--type (строка)

Тип индекса. Для понимания различий между LOCAL и AGGREGATOR см. раздел Включение межрегионального поиска в руководстве пользователя Amazon Web Services Resource Explorer.

Возможные значения:

  • LOCAL
  • AGGREGATOR

--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 в руководстве пользователя AWS CLI.

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

Чтобы изменить тип индекса Resource Explorer

В следующем примере update-index-type указанный индекс изменяется с типа local на тип aggregator, чтобы включить возможность поиска ресурсов по всем регионам AWS в учетной записи. Запрос необходимо отправлять в регион AWS, в котором находится индекс, который нужно обновить.

aws resource-explorer-2 update-index-type \
    --arn arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111 \
    --type aggregator \
    --region us-east-1

Вывод:

{
    "Arn":"arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111",
    "LastUpdatedAt":"2022-07-13T18:41:58.799Z",
    "State":"updating",
    "Type":"aggregator"
}

Дополнительную информацию об изменении типа индекса см. в разделе Включение межрегионального поиска путем создания индекса агрегатора в руководстве пользователя AWS Resource Explorer.

Вывод

Arn -> (строка)

Amazon Resource Name (ARN) обновленного индекса.

LastUpdatedAt -> (дата и время)

Дата и время последнего обновления индекса.

State -> (строка)

Указывает состояние запроса на обновление индекса. Эта операция асинхронная. Для проверки изменений используйте операцию GetIndex.

Type -> (строка)

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

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

Spec-Zone.ru

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