update-cache-policy

Описание

Обновляет конфигурацию политики кэширования.

При обновлении конфигурации политики кэширования все поля обновляются значениями, указанными в запросе. Некоторые поля нельзя обновить независимо от других. Чтобы обновить конфигурацию политики кэширования:

Используйте GetCachePolicyConfig для получения текущей конфигурации.
Локально измените поля в конфигурации политики кэширования, которые вы хотите обновить.
Вызовите UpdateCachePolicy, предоставив всю конфигурацию политики кэширования, включая изменённые и неизменённые поля.

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

Синтаксис

  update-cache-policy
--cache-policy-config <value>
--id <value>
[--if-match <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]

Параметры

--cache-policy-config (структура)

Конфигурация политики кэширования.

Комментарий -> (строка)

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

Имя -> (строка)

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

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-заголовки, файлы cookie и строки запроса 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 -> (булево)

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

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

Дополнительную информацию см. в разделе «Поддержка сжатия» в руководстве разработчика Amazon CloudFront.

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

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

HeaderBehavior -> (строка)

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

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

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

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

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

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

Items -> (список)

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

(строка)

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

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

CookieBehavior -> (строка)

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

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

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

Содержит список имён файлов cookie.

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

Количество имён файлов cookie в списке Items.

Items -> (список)

Список имён файлов cookie.

(строка)

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

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

QueryStringBehavior -> (строка)

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

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

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

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

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

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

Items -> (список)

Список имён строк запроса.

(строка)

Синтаксис JSON:

{
  "Comment": "string",
  "Name": "string",
  "DefaultTTL": long,
  "MaxTTL": long,
  "MinTTL": long,
  "ParametersInCacheKeyAndForwardedToOrigin": {
    "EnableAcceptEncodingGzip": true|false,
    "EnableAcceptEncodingBrotli": true|false,
    "HeadersConfig": {
      "HeaderBehavior": "none"|"whitelist",
      "Headers": {
        "Quantity": integer,
        "Items": ["string", ...]
      }
    },
    "CookiesConfig": {
      "CookieBehavior": "none"|"whitelist"|"allExcept"|"all",
      "Cookies": {
        "Quantity": integer,
        "Items": ["string", ...]
      }
    },
    "QueryStringsConfig": {
      "QueryStringBehavior": "none"|"whitelist"|"allExcept"|"all",
      "QueryStrings": {
        "Quantity": integer,
        "Items": ["string", ...]
      }
    }
  }
}

--id (строка)

Уникальный идентификатор политики кэширования, которую вы обновляете. Идентификатор возвращается в поле CachePolicyId поведения кэша в ответе на GetDistributionConfig.

--if-match (строка)

Версия политики кэширования, которую вы обновляете. Версия возвращается в поле ETag политики кэширования в ответе на GetCachePolicyConfig.

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

Вывод

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

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

Id -> (строка)

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

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

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

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

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

Comment -> (строка)

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

Name -> (строка)

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

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

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

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

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

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

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

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

HTTP-заголовки, файлы cookie и строки запроса 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 -> (логическое значение)

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

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

Дополнительную информацию см. в разделе Поддержка сжатия в руководстве разработчика Amazon CloudFront.

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

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

HeaderBehavior -> (строка)

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

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

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

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

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

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

Items -> (список)

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

(строка)

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

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

CookieBehavior -> (строка)

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

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

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

Содержит список имен файлов cookie.

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

Количество имен файлов cookie в списке Items.

Items -> (список)

Список имен файлов cookie.

(строка)

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

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

QueryStringBehavior -> (строка)

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

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

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

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

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

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

Items -> (список)

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

(строка)

ETag -> (строка)

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

END_OF_DOCUMENT_MARKER