Spec-Zone.ru › AWS CLI v2

[ aws . cloudfront ]

get-cache-policy

Описание

Получает политику кэширования, включая следующие метаданные:

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

Для получения политики кэширования необходимо указать идентификатор политики. Если политика кэширования прикреплена к поведению кэша распределения, вы можете получить идентификатор политики, используя ListDistributions или GetDistribution. Если политика кэширования не прикреплена к поведению кэша, вы можете получить идентификатор, используя ListCachePolicies.

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

Синтаксис

  get-cache-policy
--id <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]

Параметры

--id (строка)

Уникальный идентификатор политики кэширования. Если политика кэширования прикреплена к поведению кэша распределения, вы можете получить идентификатор политики, используя ListDistributions или GetDistribution. Если политика кэширования не прикреплена к поведению кэша, вы можете получить идентификатор, используя ListCachePolicies.

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

Вывод

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

Политика кэширования.

Id -> (строка)

Уникальный идентификатор политики кэширования.

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

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

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

Настройка политики кэширования.

Comment -> (строка)

Комментарий для описания политики кэширования. Комментарий не может быть длиннее 128 символов.

Name -> (строка)

Уникальное имя для идентификации политики кэширования.

DefaultTTL -> (целое число)

Максимальное время в секундах, которое объекты будут храниться в кэше CloudFront, прежде чем CloudFront отправит еще один запрос к источнику, чтобы узнать, обновлялся ли объект. CloudFront использует это значение как время жизни объекта (TTL) только в том случае, если источник *не* отправляет заголовки Cache-Control или Expires вместе с объектом. Подробнее см. Управление временем хранения контента в кэше на границе (Истечение срока действия) в руководстве разработчика Amazon CloudFront.

Значение по умолчанию для этого поля составляет 86400 секунд (один день). Если значение MinTTL больше 86400 секунд, то значение по умолчанию для этого поля такое же, как у MinTTL .

MaxTTL -> (целое число)

Максимальное время в секундах, которое объекты остаются в кэше CloudFront, прежде чем CloudFront отправит еще один запрос к источнику, чтобы проверить, был ли объект обновлён. CloudFront использует это значение только в том случае, если источник отправляет заголовки Cache-Control или Expires вместе с объектом. Подробнее см. Управление временем хранения контента в кэше на границе (Истечение срока действия) в руководстве разработчика Amazon CloudFront.

Значение по умолчанию для этого поля составляет 31536000 секунд (один год). Если значение MinTTL или DefaultTTL больше 31536000 секунд, то значение по умолчанию для этого поля такое же, как у DefaultTTL .

MinTTL -> (целое число)

Минимальное время в секундах, в течение которого вы хотите, чтобы объекты хранились в кэше CloudFront, прежде чем CloudFront отправит еще один запрос к источнику, чтобы проверить, был ли объект обновлён. Подробнее см. Управление временем хранения контента в кэше на границе (Истечение срока действия) в руководстве разработчика Amazon CloudFront.

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

HTTP-заголовки, куки и параметры запроса URL, которые следует включить в ключ кэша. Значения, включенные в ключ кэша, также включаются в запросы, которые CloudFront отправляет к источнику.

EnableAcceptEncodingGzip -> (булево)

Флаг, который может повлиять на включение HTTP-заголовка Accept-Encoding в ключ кэша и в запросы, которые CloudFront отправляет к источнику.

Это поле связано с полем EnableAcceptEncodingBrotli. Если одно или оба из этих полей имеют значение true, *и* запрос пользователя включает заголовок Accept-Encoding, тогда CloudFront выполняет следующие действия:

  • Нормализует значение заголовка Accept-Encoding пользователя
  • Включает нормализованный заголовок в ключ кэша
  • Включает нормализованный заголовок в запрос к источнику, если это необходимо

Подробнее см. Поддержка сжатия в руководстве разработчика Amazon CloudFront.

Если вы установите это значение в true, и в этом поведении кэша также прикреплена политика запросов к источнику, не включайте заголовок Accept-Encoding в политику запросов к источнику. CloudFront всегда включает заголовок Accept-Encoding в запросы к источнику, когда значение этого поля равно true, поэтому включение этого заголовка в политику запросов к источнику не повлияет.

Если оба этих поля равны false, CloudFront обрабатывает заголовок Accept-Encoding как любой другой HTTP-заголовок в запросе пользователя. По умолчанию он не включается в ключ кэша и не включается в запросы к источнику. В этом случае вы можете вручную добавить Accept-Encoding в список разрешенных заголовков, как и любой другой HTTP-заголовок.

EnableAcceptEncodingBrotli -> (булево)

Флаг, который может повлиять на включение HTTP-заголовка Accept-Encoding в ключ кэша и в запросы, которые CloudFront отправляет к источнику.

Это поле связано с полем EnableAcceptEncodingGzip. Если одно или оба из этих полей имеют значение true, *и* запрос пользователя включает заголовок Accept-Encoding, тогда CloudFront выполняет следующие действия:

  • Нормализует значение заголовка Accept-Encoding пользователя
  • Включает нормализованный заголовок в ключ кэша
  • Включает нормализованный заголовок в запрос к источнику, если это необходимо

Подробнее см. Поддержка сжатия в руководстве разработчика Amazon CloudFront.

Если вы установите это значение в true, и в этом поведении кэша также прикреплена политика запросов к источнику, не включайте заголовок Accept-Encoding в политику запросов к источнику. CloudFront всегда включает заголовок Accept-Encoding в запросы к источнику, когда значение этого поля равно true, поэтому включение этого заголовка в политику запросов к источнику не повлияет.

Если оба этих поля равны false, CloudFront обрабатывает заголовок Accept-Encoding как любой другой HTTP-заголовок в запросе пользователя. По умолчанию он не включается в ключ кэша и не включается в запросы к источнику. В этом случае вы можете вручную добавить Accept-Encoding в список разрешенных заголовков, как и любой другой HTTP-заголовок.

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

Объект, который определяет, включать ли любые HTTP-заголовки (и если да, то какие) в ключ кэша и в запросы, которые CloudFront отправляет к источнику.

HeaderBehavior -> (строка)

Определяет, включать ли HTTP-заголовки в ключ кэша и в запросы, которые CloudFront отправляет к источнику. Допустимые значения:

  • none – HTTP-заголовки не включаются в ключ кэша или в запросы, которые CloudFront отправляет к источнику. Даже если это поле установлено в none, любые заголовки, перечисленные в OriginRequestPolicy, *включаются* в запросы к источнику.
  • whitelist – Только HTTP-заголовки, перечисленные в типе Headers, включаются в ключ кэша и в запросы, которые CloudFront отправляет к источнику.

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

Содержит список имён HTTP-заголовков.

Quantity -> (целое число)

Количество имён заголовков в списке Items.

Items -> (список)

Список имён HTTP-заголовков.

(строка)

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

Объект, определяющий, включать ли любые куки из запросов пользователя (и если да, то какие) в ключ кэша и в запросы, которые CloudFront отправляет к источнику.

CookieBehavior -> (строка)

Определяет, включать ли куки из запросов пользователя в ключ кэша и в запросы, которые CloudFront отправляет к источнику. Допустимые значения:

  • none – Куки из запросов пользователя не включаются в ключ кэша или в запросы, которые CloudFront отправляет к источнику. Даже если это поле установлено в none, любые куки, перечисленные в OriginRequestPolicy, *включаются* в запросы к источнику.
  • whitelist – Только куки из запросов пользователя, перечисленные в типе CookieNames, включаются в ключ кэша и в запросы, которые CloudFront отправляет к источнику.
  • allExcept – Все куки из запросов пользователя включаются в ключ кэша и в запросы, которые CloudFront отправляет к источнику, * кроме * тех, которые перечислены в типе CookieNames, которые не включаются.
  • all – Все куки из запросов пользователя включаются в ключ кэша и в запросы, которые CloudFront отправляет к источнику.

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

Содержит список имён куки.

Quantity -> (целое число)

Количество имён куки в списке Items.

Items -> (список)

Список имён куки.

(строка)

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

Объект, определяющий, включать ли параметры URL-запроса из запросов пользователя (и если да, то какие) в ключ кэша и в запросы, которые CloudFront отправляет к источнику.

QueryStringBehavior -> (строка)

Определяет, включать ли параметры URL-запроса из запросов пользователя в ключ кэша и в запросы, которые CloudFront отправляет к источнику. Допустимые значения:

  • none – Параметры URL-запроса из запросов пользователя не включаются в ключ кэша или в запросы, которые CloudFront отправляет к источнику. Даже если это поле установлено в none, любые параметры URL-запроса, перечисленные в OriginRequestPolicy, *включаются* в запросы к источнику.
  • whitelist – Только параметры URL-запроса из запросов пользователя, перечисленные в типе QueryStringNames, включаются в ключ кэша и в запросы, которые CloudFront отправляет к источнику.
  • allExcept – Все параметры URL-запроса из запросов пользователя включаются в ключ кэша и в запросы, которые CloudFront отправляет к источнику, * кроме * тех, которые перечислены в типе QueryStringNames, которые не включаются.
  • all – Все параметры URL-запроса из запросов пользователя включаются в ключ кэша и в запросы, которые CloudFront отправляет к источнику.

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

Содержит список параметров URL-запроса из запросов пользователя, которые * включаются * или * не включаются * в ключ кэша и в запросы, которые CloudFront отправляет к источнику. Поведение зависит от того, установлено ли поле QueryStringBehavior в типе CachePolicyQueryStringsConfig в whitelist (перечисленные параметры URL-запроса * включаются *), или в allExcept (перечисленные параметры URL-запроса * не включаются *, но все остальные — включаются).

Quantity -> (целое число)

Количество имён параметров URL-запроса в списке Items.

Items -> (список)

Список имён параметров URL-запроса.

(строка)

ETag -> (строка)

Текущая версия политики кэширования.

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

Spec-Zone.ru

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