Spec-Zone.ru › AWS CLI v2

[ aws . resource-explorer-2 ]

обновить-вид

Описание

Изменяет некоторые детали представления. Можно изменить строку фильтра и список включённых свойств. Нельзя изменить имя представления.

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

Синтаксис

  update-view
[--filters <value>]
[--included-properties <value>]
--view-arn <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]

Параметры

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

Массив строк, определяющих, какие ресурсы включаются в результаты запросов, выполняемых с помощью этого представления. Когда вы используете это представление в операции поиска, строка фильтра объединяется с параметром поиска QueryString с помощью логического оператора AND.

Дополнительную информацию о поддерживаемом синтаксисе см. в справке по запросам поиска для Resource Explorer в Руководстве пользователя Amazon Web Services Resource Explorer.

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

Строка запроса в контексте этой операции поддерживает только префиксы фильтра с необязательными операторами. Она не поддерживает свободный текст. Например, строка region:us* service:ec2 -tag:stage=prod включает все ресурсы Amazon EC2 во всех регионах Amazon Web Services, начинающиеся с букв us и не помеченные ключом Stage со значением prod.

FilterString -> (строка)

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

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

FilterString=string

Синтаксис JSON:

{
  "FilterString": "string"
}

--included-properties (список)

Указывает необязательные поля, которые вы хотите включить в результаты поиска из этого представления. Это список объектов, каждый из которых описывает поле для включения.

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

(структура)

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

Name -> (строка)

Имя свойства, включенного в это представление.

Для этого поля можно указать следующие имена свойств:

  • tags

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

Name=string ...

Синтаксис JSON:

[
  {
    "Name": "string"
  }
  ...
]

--view-arn (строка)

Amazon Resource Name (ARN) представления, которое требуется изменить.

--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. Эти примеры потребуется адаптировать к правилам цитирования вашей консоли. Дополнительную информацию см. в разделе Использование кавычек со строками в Руководстве пользователя AWS CLI.

Пример 1: Изменение поля IncludedProperties для представления Resource Explorer

Следующий update-view пример обновляет указанное представление, добавляя `tags` к необязательным `IncludedProperties`. После выполнения этой операции операции поиска, использующие это представление, включают информацию о тегах, прикрепленных к ресурсам, которые отображаются в результатах.

aws resource-explorer-2 update-view \
    --included-properties Name=tags \
    --view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222

Вывод:

{
    "View": {
        "Filters": {
            "FilterString": ""
        },
        "IncludedProperties": [
            {
                "Name": "tags"
            }
        ],
        "LastUpdatedAt": "2022-07-19T17:41:21.710000+00:00",
        "Owner": "123456789012",
        "Scope": "arn:aws:iam::123456789012:root",
        "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111"
    }
}

Пример 2: Изменение фильтров, прикреплённых к представлению

Следующий update-view пример обновляет указанное представление, чтобы использовать фильтр, ограничивающий результаты только типами ресурсов, связанными с сервисом Amazon EC2.

aws resource-explorer-2 update-view \
    --filters FilterString="service:ec2" \
    --view-arn arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222

Вывод:

{
    "View": {
    "Filters": {
        "FilterString": "service:ec2"
    },
    "IncludedProperties": [],
    "LastUpdatedAt": "2022-07-19T17:41:21.710000+00:00",
        "Owner": "123456789012",
        "Scope": "arn:aws:iam::123456789012:root",
        "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222"
    }
}

Дополнительную информацию о представлениях см. в разделе Обзор представлений Resource Explorer в Руководстве пользователя AWS Resource Explorer.

Вывод

View -> (структура)

Подробная информация о представлении, которое было изменено в ходе этой операции.

Filters -> (структура)

Массив объектов SearchFilter, определяющих, какие ресурсы могут быть включены в результаты запросов, выполняемых с помощью этого представления.

FilterString -> (строка)

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

IncludedProperties -> (список)

Структура, содержащая дополнительную информацию о представлении.

(структура)

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

Name -> (строка)

Имя свойства, включённого в это представление.

Для этого поля можно указать следующие имена свойств:

  • tags

LastUpdatedAt -> (метка времени)

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

Owner -> (строка)

AWS-аккаунт, владеющий этим представлением.

Scope -> (строка)

Amazon Resource Name (ARN) AWS-аккаунта, организации или организационной единицы (OU), определяющий, включает ли это представление ресурсы только из указанного AWS-аккаунта, все аккаунты в указанной организации или все аккаунты в указанной OU.

Если не указано, значение по умолчанию — AWS-аккаунт, используемый для вызова этой операции.

ViewArn -> (строка)

Amazon Resource Name (ARN) представления.

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

Spec-Zone.ru

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