[ aws . apigateway ]
get-method
Описание
Описывает существующий ресурс метода.
См. также: Документация AWS API
Синтаксис
get-method
--rest-api-id <value>
--resource-id <value>
--http-method <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]
Параметры
--rest-api-id (строка)
--resource-id (строка)
--http-method (строка)
--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
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определённый профиль из файла ключей.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- on
- off
- auto
--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-auto-prompt (логическое значение)
Автоматически запросить параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запроса параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной среды. См. Использование кавычек со строками в руководстве пользователя AWS CLI.
Чтобы получить конфигурацию ресурса метода для HTTP-метода, определённого в ресурсе REST API
Команда:
aws apigateway get-method --rest-api-id 1234123412 --resource-id y9h6rt --http-method GET
Вывод:
{
"apiKeyRequired": false,
"httpMethod": "GET",
"methodIntegration": {
"integrationResponses": {
"200": {
"responseTemplates": {
"application/json": null
},
"statusCode": "200"
}
},
"cacheKeyParameters": [],
"uri": "arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123412341234:function:My_Function/invocations",
"httpMethod": "POST",
"cacheNamespace": "y9h6rt",
"type": "AWS"
},
"requestParameters": {},
"methodResponses": {
"200": {
"responseModels": {
"application/json": "Empty"
},
"statusCode": "200"
}
},
"authorizationType": "NONE"
}
Вывод
httpMethod -> (строка)
authorizationType -> (строка)
NONE для открытого доступа, AWS_IAM для использования разрешений AWS IAM, CUSTOM для использования пользовательского авторизатора или COGNITO_USER_POOLS для использования пула пользователей Cognito.authorizerId -> (строка)
authorizationType должен быть CUSTOM.apiKeyRequired -> (логическое значение)
requestValidatorId -> (строка)
operationName -> (строка)
operationName значение ListPets для метода GET /pets в примере PetStore.requestParameters -> (массив)
Массив пар ключ-значение, определяющих обязательные или необязательные параметры запроса метода, которые могут быть приняты API Gateway. Ключ — имя параметра запроса метода, соответствующее шаблону method.request.{location}.{name}, где location — querystring, path или header, а name — действительное и уникальное имя параметра. Значение, связанное с ключом, представляет собой булевый флаг, указывающий, является ли параметр обязательным (true) или необязательным (false). Имена параметров запроса метода, определённые здесь, доступны в интеграции для сопоставления с параметрами запроса интеграции или шаблонами.
ключ -> (строка)
значение -> (логическое значение)
requestModels -> (массив)
Массив пар ключ-значение, определяющий схемы данных, представленные ресурсами модели (в качестве сопоставленного значения) загрузок запросов для заданных типов контента (в качестве ключа сопоставления).
ключ -> (строка)
значение -> (строка)
methodResponses -> (массив)
Получает ответ метода, связанный с заданным кодом HTTP-статуса.
ключ -> (строка)
значение -> (структура)
Представляет ответ метода для заданного кода HTTP-статуса, возвращаемого клиенту. Ответ метода передаётся с заднего плана через связанный ответ интеграции, который может быть преобразован с помощью шаблона сопоставления.
statusCode -> (строка)
responseParameters -> (массив)
Массив пар ключ-значение, определяющих обязательные или необязательные параметры ответа, которые API Gateway может возвращать вызывающему объекту. Ключ определяет заголовок ответа метода, а значение определяет, является ли соответствующий заголовок ответа метода обязательным. Выражение ключа должно соответствовать шаблону method.response.header.{name}, где name — допустимое и уникальное имя заголовка. API Gateway передаёт определённые данные ответа интеграции в заголовки ответа метода, указанные здесь, согласно сопоставлению, которое вы определяете в IntegrationResponse API. Данные ответа интеграции, которые могут быть сопоставлены, включают заголовок ответа интеграции, выраженный в integration.response.header.{name}, статическое значение, заключенное в одинарные кавычки (например, 'application/json'), или JSON-выражение из полезной нагрузки ответа от заднего плана в форме integration.response.body.{JSON-expression}, где JSON-expression — допустимое JSON-выражение без префикса $.
ключ -> (строка)
значение -> (логическое значение)
responseModels -> (массив)
Определяет ресурсы модели, используемые для типа контента ответа. Модели ответов представлены как массивом пар ключ/значение, где тип контента является ключом, а имя модели — значением.
ключ -> (строка)
значение -> (строка)
methodIntegration -> (структура)
Получает метод интеграции, ответственный за передачу запроса, отправленного клиентом, на бэкенд и выполнение необходимых преобразований для соответствия запроса бэкенду.
type -> (строка)
Указывает тип интеграции API-метода. Допустимое значение — одно из следующих:
Для интеграций HTTP и HTTP-прокси каждая интеграция может указать протокол (http/https ), порт и путь. Поддерживаются стандартные порты 80 и 443, а также пользовательские порты выше 1024. Интеграция HTTP или HTTP-прокси с типом connectionType VPC_LINK называется частной интеграцией и использует VpcLink для подключения API Gateway к балансировщику нагрузки сети VPC.
httpMethod -> (строка)
MOCK , это свойство является необязательным. Для интеграций Lambda вы должны установить метод интеграции на POST . Для всех других типов вы должны указать это свойство.uri -> (строка)
Указывает унифицированный идентификатор ресурса (URI) конечной точки интеграции.
Для интеграций HTTP или HTTP_PROXY URI должен быть полностью сформированным, закодированным URL-адресом HTTP(S) в соответствии со спецификацией RFC-3986 для стандартных интеграций. Если connectionType VPC_LINK , укажите имя DNS балансировщика сетевой нагрузки. Для интеграций AWS или AWS_PROXY URI имеет вид arn:aws:apigateway:{region}:{subdomain.service|service}:path|action/{service_api} . Здесь {Region} — регион API Gateway (например, us-east-1); {service} — имя интегрированной Amazon Web Services-службы (например, s3); а {subdomain} — выделенный домен, поддерживаемый определенными Amazon Web Services-службами для быстрого поиска имени хоста. Для API на основе действий Amazon Web Services можно использовать action, используя строку запроса Action={name}&{p1}={v1}&p2={v2}…. Полученный {service_api} относится к поддерживаемому действию {name} плюс все необходимые входные параметры. В качестве альтернативы для API на основе путей Amazon Web Services можно использовать path. Полученный service_api относится к пути к ресурсу Amazon Web Services-службы, включая регион интегрированной Amazon Web Services-службы, если применимо. Например, для интеграции с API S3 GetObject URI может быть либо arn:aws:apigateway:us-west-2:s3:action/GetObject&Bucket={bucket}&Key={key} , либо arn:aws:apigateway:us-west-2:s3:path/{bucket}/{key}
connectionType -> (строка)
INTERNET для подключений через общедоступный маршрутизируемый интернет или VPC_LINK для частных подключений между API Gateway и балансировщиком сетевой нагрузки в VPC. Значение по умолчанию — INTERNET .connectionId -> (строка)
connectionType=VPC_LINK и неопределен, в противном случае.credentials -> (строка)
arn:aws:iam::\*:user/\* . Чтобы использовать разрешения на основе ресурсов в поддерживаемых Amazon Web Services-службах, укажите null.requestParameters -> (карта)
Ключевое значение карты, определяющее параметры запроса, передаваемые от запроса метода к бэкенду. Ключ — имя параметра запроса интеграции, а соответствующее значение — значение параметра запроса метода или статическое значение, которое должно быть заключено в одинарные кавычки и предварительно закодировано, как требуется бэкендом. Значение параметра запроса метода должно соответствовать шаблону method.request.{location}.{name} , где location является querystring , path или header , а name должно быть допустимым и уникальным именем параметра запроса метода.
key -> (строка)
value -> (строка)
requestTemplates -> (карта)
Представляет карту шаблонов Velocity, которые применяются к полезной нагрузке запроса на основе значения заголовка Content-Type, отправленного клиентом. Значение типа содержимого является ключом в этой карте, а шаблон (как строка) — значением.
key -> (строка)
value -> (строка)
passthroughBehavior -> (строка)
requestTemplates . Допустимое значение — одно из следующих: WHEN_NO_MATCH : передает тело запроса метода через запрос интеграции на бэкенд без преобразований, когда тип содержимого запроса метода не соответствует ни одному из типов содержимого, связанных с шаблонами сопоставления, определенными в запросе интеграции. WHEN_NO_TEMPLATES : передает тело запроса метода через запрос интеграции на бэкенд без преобразований, когда в запросе интеграции не определен ни один шаблон сопоставления. Если шаблон определен при выборе этого параметра, запрос метода с типом содержимого, не имеющим сопоставления, будет отклонен с ответом HTTP 415 Unsupported Media Type. NEVER : отклоняет запрос метода с ответом HTTP 415 Unsupported Media Type, когда либо тип содержимого запроса метода не соответствует ни одному из типов содержимого, связанных с шаблонами сопоставления, определенными в запросе интеграции, либо в запросе интеграции не определен ни один шаблон сопоставления.contentHandling -> (строка)
Указывает, как обрабатывать преобразования типов содержимого полезной нагрузки запроса. Поддерживаемые значения — CONVERT_TO_BINARY и CONVERT_TO_TEXT , с последующим поведением:
Если это свойство не определено, полезная нагрузка запроса будет передана из запроса метода в запрос интеграции без изменений при условии, что passthroughBehavior настроена на поддержку передачи полезной нагрузки.
timeoutInMillis -> (целое число)
cacheNamespace -> (строка)
cacheNamespace . Вы можете указать один и тот же cacheNamespace для ресурсов, чтобы возвращать одни и те же кэшированные данные для запросов к различным ресурсам.cacheKeyParameters -> (список)
Список параметров запроса, значения которых кэшируются API Gateway. Чтобы быть допустимыми значениями для cacheKeyParameters , эти параметры также должны быть указаны для метода requestParameters .
(строка)
integrationResponses -> (карта)
Определяет ответы интеграции.
key -> (строка)
value -> (структура)
Представляет ответ интеграции. Код состояния должен соответствовать существующему MethodResponse, а параметры и шаблоны могут использоваться для преобразования ответа бэкенда.
statusCode -> (строка)
selectionPattern -> (строка)
.+ для сопоставления ответа об ошибке. Однако в таких случаях убедитесь, что ответ об ошибке не содержит символа новой строки (\n ). Если бэкендом является функция Lambda, совпадает заголовок ошибки Lambda-функции. Для всех других HTTP- и Amazon Web Services-бэкендов сопоставляется код HTTP-статуса.responseParameters -> (карта)
Ключевое значение карты, определяющее параметры ответа, которые передаются из ответа бэкенда в ответ метода. Ключ — имя параметра заголовка ответа метода, а сопоставленное значение — значение заголовка ответа интеграции, статическое значение, заключенное в пару одинарных кавычек, или выражение JSON из тела ответа интеграции. Ключ сопоставления должен соответствовать шаблону method.response.header.{name} , где name — допустимое и уникальное имя заголовка. Сопоставленное нестатическое значение должно соответствовать шаблону integration.response.header.{name} или integration.response.body.{JSON-expression} , где name — допустимое и уникальное имя заголовка ответа, а JSON-expression — допустимое выражение JSON без префикса $ .
key -> (строка)
value -> (строка)
responseTemplates -> (карта)
Указывает шаблоны, используемые для преобразования тела ответа интеграции. Шаблоны ответов представлены в виде карты ключ/значение, где тип содержимого является ключом, а шаблон — значением.
key -> (строка)
value -> (строка)
contentHandling -> (строка)
Указывает, как обрабатывать преобразования типов содержимого полезной нагрузки ответа. Поддерживаемые значения — CONVERT_TO_BINARY и CONVERT_TO_TEXT , с последующим поведением:
Если это свойство не определено, полезная нагрузка ответа будет передана из ответа интеграции в ответ метода без изменений.
tlsConfig -> (структура)
Указывает конфигурацию TLS для интеграции.
insecureSkipVerification -> (булево)
Указывает, пропускать ли API Gateway проверку того, выдан ли сертификат для конечной точки интеграции авторитетным центром сертификации. Это не рекомендуется, но позволяет использовать сертификаты, подписанные частными центрами сертификации или самоподписанные сертификаты. Если включено, API Gateway по-прежнему выполняет базовую проверку сертификата, которая включает проверку срока действия сертификата, имени хоста и наличия корневого сертификата центра сертификации. Поддерживается только для интеграций HTTP и HTTP_PROXY.
Предупреждение
ВключениеinsecureSkipVerification не рекомендуется, особенно для интеграций с общедоступными HTTPS-конечными точками. Если вы включите insecureSkipVerification , вы повышаете риск атак «человек посередине».authorizationScopes -> (список)
Список областей авторизации, настроенных для метода. Области используются с авторизатором COGNITO_USER_POOLS для авторизации вызова метода. Авторизация работает путем сопоставления областей метода с областями, извлеченными из маркера доступа в входящем запросе. Вызов метода авторизуется, если хотя бы одна область метода совпадает с областью, заявленной в маркере доступа. В противном случае вызов не авторизуется. При настройке области метода клиент должен предоставить маркер доступа, а не токен идентификатора для целей авторизации.
(строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.