GetResources#

Description#

Запрос на получение списка ресурсов, для которых существуют теги.

Request Parameters#

  • PaginationToken — PaginationToken из предыдущего вызова (см. Response Elements).

    • Тип: String

    • Необходимо: Нет

  • ResourceARNList — Список Amazon Resource Name (ARN) ресурсов.

    • Необходимо: Нет

    • Тип: Array of strings

    • Ограничение длины: До 100 элементов

    • Ограничения: Нельзя использовать вместе с опцией ResourceTypeFilters

    • Допустимые значения: См. ResourceARNList

  • ResourceTypeFilters — Список фильтров для выборки результата по сервису и/или типу ресурса.

    • Необходимо: Нет

    • Тип: Array of strings

    • Ограничение длины: До 100 элементов

    • Ограничения: Нельзя использовать вместе с опцией ResourceARNList

    • Шаблон: <service_name> | <service_name>:<resource_type>

    • Допустимые значения: См. :ref: ResourceTypeFiltersValues

  • ResourcesPerPage — Ограничение на количество возвращаемых ресурсов.

    • Тип: Integer

    • Необходимо: Нет

    • Значение по умолчанию: 20

    • Минимальное значение: 1

    • Максимальное значение: 100

  • TagFilters — Список фильтров для выборки результата по ключам/значениям тегов.

    • Необходимо: Нет

    • Тип: Список объектов TagFilter

    • Ограничение длины: До 50 элементов

    Примечание

    Фильтры TagFilters определяют, какие ресурсы будут включены в ответ: он будет содержать только те ресурсы, у которых есть хотя бы один тег, соответствующий фильтрам. Для каждого ресурса, присутствующего в ответе, будут возвращены все его теги.

Response Elements#

  • PaginationToken — Токен возвращается только в том случае, когда не удалось вернуть все ресурсы с тегами. Чтобы продолжить вывод данных, полученное значение нужно передать в параметре PaginationToken такого же запроса.

    • Тип: String

  • ResourceTagMappingList — Список ресурсов с тегами.

Examples#

c2-rgt GetResources
c2-rgt GetResources ResourceARNList.1 "arn:c2:ec2::<login>:subnet/<resource-id>"
c2-rgt GetResources ResourceTypeFilters.1 "efs" ResourceTypeFilters.2 "ec2:vpc"
c2-rgt GetResources TagFilters.1.Key "tag_key" TagFilters.1.Values.1 "tag_value_1" TagFilters.1.Values.2 "tag_value_2"
c2-rgt GetResources ResourcesPerPage 50 PaginationToken <pagination_token>