Spec-Zone.ru › AWS CLI v2

[ aws . lightsail ]

create-distribution

Описание

Создаёт распределение сети доставки контента (CDN) Amazon Lightsail.

Распределение — это глобально распределённая сеть кэширующих серверов, которая улучшает производительность вашего веб-сайта или веб-приложения, размещённых на экземпляре Lightsail. Дополнительную информацию см. в статье Сети доставки контента в Amazon Lightsail.

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

Синтаксис

  create-distribution
--distribution-name <value>
--origin <value>
--default-cache-behavior <value>
[--cache-behavior-settings <value>]
[--cache-behaviors <value>]
--bundle-id <value>
[--ip-address-type <value>]
[--tags <value>]
[--certificate-name <value>]
[--viewer-minimum-tls-protocol-version <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]

Параметры

--distribution-name (строка)

Имя распределения.

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

Объект, описывающий исходный ресурс для распределения, например, экземпляр Lightsail, ведро или балансировщик нагрузки.

Распределение извлекает, кэширует и предоставляет контент из источника.

name -> (строка)

Имя исходного ресурса.

regionName -> (строка)

Имя AWS региона исходного ресурса.

protocolPolicy -> (строка)

Протокол, который использует ваше распределение Amazon Lightsail при установлении соединения с источником для извлечения контента.

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

Время в секундах, которое распределение ожидает ответа после перенаправления запроса источнику. Минимальное время ожидания — 1 секунда, максимальное — 60 секунд, а по умолчанию (если вы не укажете другое) — 30 секунд.

Сокращенная синтаксическая запись:

name=string,regionName=string,protocolPolicy=string,responseTimeout=integer

Синтаксис JSON:

{
  "name": "string",
  "regionName": "us-east-1"|"us-east-2"|"us-west-1"|"us-west-2"|"eu-west-1"|"eu-west-2"|"eu-west-3"|"eu-central-1"|"ca-central-1"|"ap-south-1"|"ap-southeast-1"|"ap-southeast-2"|"ap-northeast-1"|"ap-northeast-2"|"eu-north-1",
  "protocolPolicy": "http-only"|"https-only",
  "responseTimeout": integer
}

--default-cache-behavior (структура)

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

behavior -> (строка)

Поведение кэширования распределения.

Можно указать следующие варианты поведения кэширования:

  • **cache ** — Этот вариант подходит для статических сайтов. При указании данного варианта ваше распределение кэширует и предоставляет весь ваш веб-сайт как статический контент. Это поведение идеально подходит для веб-сайтов со статическим контентом, который не меняется в зависимости от пользователя, или для веб-сайтов, не использующих cookie, заголовки или строки запроса для персонализации контента.
  • **dont-cache ** — Этот вариант подходит для сайтов, которые предоставляют как статический, так и динамический контент. При указании данного варианта ваше распределение кэширует и предоставляет только тот контент, который указан в параметре CacheBehaviorPerPath распределения. Это поведение идеально подходит для веб-сайтов или веб-приложений, использующих cookie, заголовки и строки запроса для персонализации контента для каждого пользователя.

Сокращенная синтаксическая запись:

behavior=string

Синтаксис JSON:

{
  "behavior": "dont-cache"|"cache"
}

--cache-behavior-settings (структура)

Объект, описывающий параметры поведения кэширования для распределения.

defaultTTL -> (длинное целое число)

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

Примечание

Указанное значение применяется только в том случае, если источник не добавляет HTTP-заголовки, такие как Cache-Control max-age , Cache-Control s-maxage и Expires к объектам.

minimumTTL -> (длинное целое число)

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

Значение 0 должно быть указано для minimumTTL, если распределение настроено на пересылку всех заголовков источнику.

maximumTTL -> (длинное целое число)

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

Указанное значение применяется только в том случае, если источник добавляет HTTP-заголовки, такие как Cache-Control max-age , Cache-Control s-maxage и Expires к объектам.

allowedHTTPMethods -> (строка)

HTTP-методы, которые обрабатываются и пересылаются источнику распределения.

Можно указать следующие варианты:

  • GET,HEAD — Распределение пересылает методы GET и HEAD.
  • GET,HEAD,OPTIONS — Распределение пересылает методы GET , HEAD и OPTIONS.
  • GET,HEAD,OPTIONS,PUT,PATCH,POST,DELETE — Распределение пересылает методы GET , HEAD , OPTIONS , PUT , PATCH , POST и DELETE.

Если вы укажете третий вариант, вам может потребоваться ограничить доступ к источнику вашего распределения, чтобы пользователи не могли выполнять операции, которые вы не хотите, чтобы они выполняли. Например, вы можете не разрешить пользователям право удалять объекты из источника.

cachedHTTPMethods -> (строка)

HTTP-методы ответов, которые кэшируются вашим распределением.

Можно указать следующие варианты:

  • GET,HEAD — Распределение кэширует ответы на методы GET и HEAD.
  • GET,HEAD,OPTIONS — Распределение кэширует ответы на методы GET , HEAD и OPTIONS.

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

Объект, описывающий cookie, которые пересылаются источнику. Ваш контент кэшируется на основе пересылаемых cookie.

option -> (строка)

Указывает, какие cookie пересылать источнику распределения: all , none или allow-list для пересылки только тех cookie, которые указаны в параметре cookiesAllowList.

cookiesAllowList -> (список)

Конкретные cookie, которые нужно пересылать источнику вашего распределения.

(строка)

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

Объект, описывающий заголовки, которые пересылаются источнику. Ваш контент кэшируется на основе пересылаемых заголовков.

option -> (строка)

Заголовки, которые вы хотите, чтобы ваше распределение пересылало вашему источнику и на основе которых производилось кэширование.

Вы можете настроить распределение, чтобы выполнить одно из следующих действий:

  • **all ** — Пересылать все заголовки вашему источнику.
  • **none ** — Пересылать только стандартные заголовки.
  • **allow-list ** — Пересылать только указанные вами заголовки, используя параметр headersAllowList.

headersAllowList -> (список)

Конкретные заголовки, которые нужно пересылать источнику вашего распределения.

(строка)

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

Объект, описывающий строки запроса, которые пересылаются источнику. Ваш контент кэшируется на основе пересылаемых строк запроса.

option -> (булево)

Указывает, пересылает ли распределение и кэширует ли оно строки запроса.

queryStringsAllowList -> (список)

Конкретные строки запроса, которые распределение пересылает источнику.

Ваше распределение будет кэшировать контент на основе указанных строк запроса.

Если параметр option имеет значение true, то ваше распределение пересылает все строки запроса, независимо от того, что вы укажете с помощью параметра queryStringsAllowList.

(строка)

Сокращенная синтаксическая запись:

defaultTTL=long,minimumTTL=long,maximumTTL=long,allowedHTTPMethods=string,cachedHTTPMethods=string,forwardedCookies={option=string,cookiesAllowList=[string,string]},forwardedHeaders={option=string,headersAllowList=[string,string]},forwardedQueryStrings={option=boolean,queryStringsAllowList=[string,string]}

Синтаксис JSON:

{
  "defaultTTL": long,
  "minimumTTL": long,
  "maximumTTL": long,
  "allowedHTTPMethods": "string",
  "cachedHTTPMethods": "string",
  "forwardedCookies": {
    "option": "none"|"allow-list"|"all",
    "cookiesAllowList": ["string", ...]
  },
  "forwardedHeaders": {
    "option": "none"|"allow-list"|"all",
    "headersAllowList": ["Accept"|"Accept-Charset"|"Accept-Datetime"|"Accept-Encoding"|"Accept-Language"|"Authorization"|"CloudFront-Forwarded-Proto"|"CloudFront-Is-Desktop-Viewer"|"CloudFront-Is-Mobile-Viewer"|"CloudFront-Is-SmartTV-Viewer"|"CloudFront-Is-Tablet-Viewer"|"CloudFront-Viewer-Country"|"Host"|"Origin"|"Referer", ...]
  },
  "forwardedQueryStrings": {
    "option": true|false,
    "queryStringsAllowList": ["string", ...]
  }
}

--cache-behaviors (список)

Массив объектов, описывающих поведение кэширования по пути для распределения.

(структура)

Описывает поведение кэширования по пути для распределения сети доставки контента (CDN) Amazon Lightsail.

Поведение кэширования по пути используется для переопределения или добавления исключения к поведению кэширования по умолчанию для распределения. Например, если cacheBehavior установлено в cache , то поведение кэширования по пути можно использовать для указания каталога, файла или типа файла, который ваше распределение будет кэшировать. В качестве альтернативы, если поведение кэширования распределения cacheBehavior установлено в dont-cache , то поведение кэширования по пути можно использовать для указания каталога, файла или типа файла, который ваше распределение не будет кэшировать.

path -> (строка)

Путь к каталогу или файлу для кэширования или исключения из кэширования. Используйте символ звездочки для указания подстановочных знаков каталогов (path/to/assets/* ) и типов файлов (*.html, *jpg, *js ). Каталоги и пути к файлам чувствительны к регистру.

Примеры:

  • Укажите следующее, чтобы кэшировать все файлы в корневом каталоге веб-сервера Apache, работающего на экземпляре Lightsail. var/www/html/
  • Укажите следующий файл, чтобы кэшировать только страницу index в корневом каталоге веб-сервера Apache. var/www/html/index.html
  • Укажите следующее, чтобы кэшировать только файлы .html в корневом каталоге веб-сервера Apache. var/www/html/*.html
  • Укажите следующее, чтобы кэшировать только файлы .jpg, .png и .gif в подкаталоге images корневого каталога веб-сервера Apache. var/www/html/images/*.jpg var/www/html/images/*.png var/www/html/images/*.gif Укажите следующее, чтобы кэшировать все файлы в подкаталоге images корневого каталога веб-сервера Apache. var/www/html/images/

behavior -> (строка)

Поведение кэширования для указанного пути.

Можно указать одно из следующих поведений кэширования по пути:

  • **cache ** — Это поведение кэширует указанный путь.
  • **dont-cache ** — Это поведение не кэширует указанный путь.

Сокращенная синтаксическая запись:

path=string,behavior=string ...

Синтаксис JSON:

[
  {
    "path": "string",
    "behavior": "dont-cache"|"cache"
  }
  ...
]

--bundle-id (строка)

Идентификатор пакета для распределения.

Пакет распределения описывает параметры вашего распределения, такие как ежемесячные затраты и ежемесячный лимит сетевого трафика.

Используйте действие GetDistributionBundles , чтобы получить список идентификаторов пакетов распределения, которые можно указать.

--ip-address-type (строка)

Тип IP-адреса для распределения.

Возможные значения: ipv4 для только IPv4 и dualstack для IPv4 и IPv6.

Значение по умолчанию — dualstack.

Возможные значения:

  • dualstack
  • ipv4
  • ipv6

--tags (список)

Ключи тегов и необязательные значения, которые нужно добавить в распределение во время создания.

Используйте действие TagResource, чтобы добавить тег к ресурсу после его создания.

(структура)

Описание ключа тега и необязательного значения, назначенного ресурсу Amazon Lightsail.

Дополнительную информацию о тегах в Lightsail см. в руководстве разработчика Amazon Lightsail.

key -> (строка)

Ключ тега.

Ограничения: ключи тегов принимают максимум 128 символов, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @

value -> (строка)

Значение тега.

Ограничения: значения тегов принимают максимум 256 символов, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @

Сокращенная синтаксическая запись:

key=string,value=string ...

Синтаксис JSON:

[
  {
    "key": "string",
    "value": "string"
  }
  ...
]

--certificate-name (строка)

Имя сертификата SSL/TLS, который вы хотите прикрепить к распределению.

Используйте действие GetCertificates, чтобы получить список имен сертификатов, которые можно указать.

--viewer-minimum-tls-protocol-version (строка)

Минимальная версия протокола TLS для сертификата SSL/TLS.

Возможные значения:

  • TLSv1.1_2016
  • TLSv1.2_2018
  • TLSv1.2_2019
  • TLSv1.2_2021

--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 (строка)

Включение/отключение цветного вывода.

  • включено
  • выключено
  • автоматически

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

Вывод

распределение -> (структура)

Объект, описывающий созданное распределение.

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

Название распределения.

arn -> (строка)

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

код_поддержки -> (строка)

Код поддержки. Включите этот код в ваше электронное письмо в службу поддержки, если у вас есть вопросы о вашем распределении Lightsail. Этот код позволит нашей команде поддержки легче найти вашу информацию о Lightsail.

дата_создания -> (временная_метка)

Временная метка, когда было создано распределение.

местоположение -> (структура)

Объект, описывающий расположение распределения, например, регион Amazon Web Services и зону доступности.

Примечание

Распределения Lightsail являются глобальными ресурсами, которые могут ссылаться на источник в любом регионе Amazon Web Services и распределять контент по всему миру. Однако все распределения находятся в регионе us-east-1.

зона_доступности -> (строка)

Зона доступности. Следует формату us-east-2a (регистрозависимый).

имя_региона -> (строка)

Название региона Amazon Web Services.

тип_ресурса -> (строка)

Тип ресурса Lightsail (Distribution).

дополнительные_имена_доменов -> (список)

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

(строка)

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

Статус распределения.

включено -> (булево)

Указывает, включено ли распределение.

имя_домена -> (строка)

Имя домена распределения.

идентификатор_пакета -> (строка)

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

имя_сертификата -> (строка)

Имя сертификата SSL/TLS, прикрепленного к распределению, если таковой имеется.

источник -> (структура)

Объект, описывающий исходный ресурс распределения, например, экземпляр Lightsail, ведро или балансировщик нагрузки.

Распределение получает, кэширует и предоставляет контент из источника.

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

Название исходного ресурса.

тип_ресурса -> (строка)

Тип ресурса источника (Экземпляр).

имя_региона -> (строка)

Имя региона AWS исходного ресурса.

политика_протокола -> (строка)

Протокол, который ваше распределение Amazon Lightsail использует при установлении подключения к источнику для получения контента.

таймаут_ответа -> (целое_число)

Время в секундах, которое распределение ждет ответа после перенаправления запроса к источнику. Минимальный таймаут составляет 1 секунду, максимальный — 60 секунд, а по умолчанию (если вы не укажете иначе) — 30 секунд.

общедоступный_DNS_источника -> (строка)

Общедоступный DNS источника.

поведение_по_умолчанию_кэширования -> (структура)

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

поведение -> (строка)

Поведение кэширования распределения.

Можно указать следующие виды поведения кэширования:

  • **cache ** - Этот вариант подходит для статических сайтов. При указании этого варианта распределение кэширует и предоставляет весь ваш веб-сайт как статический контент. Это поведение идеально подходит для веб-сайтов со статическим контентом, который не меняется в зависимости от того, кто его просматривает, или для веб-сайтов, которые не используют cookie, заголовки или строки запроса для персонализации контента.
  • **dont-cache ** - Этот вариант подходит для сайтов, которые предоставляют смешанный статический и динамический контент. При указании этого варианта распределение кэширует и предоставляет только тот контент, который указан в параметре CacheBehaviorPerPath распределения. Это поведение идеально подходит для веб-сайтов или веб-приложений, которые используют cookie, заголовки и строки запроса для персонализации контента для каждого пользователя.

настройки_поведения_кэширования -> (структура)

Объект, описывающий настройки поведения кэширования распределения.

значение_по_умолчанию_TTL -> (длинное_целое)

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

Примечание

Указанное значение применяется только тогда, когда источник не добавляет HTTP-заголовки, такие как Cache-Control max-age, Cache-Control s-maxage и Expires, к объектам.

минимальное_значение_TTL -> (длинное_целое)

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

Значение 0 должно быть указано для minimumTTL, если распределение настроено на пересылку всех заголовков источнику.

максимальное_значение_TTL -> (длинное_целое)

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

Указанное значение применяется только тогда, когда источник добавляет HTTP-заголовки, такие как Cache-Control max-age, Cache-Control s-maxage и Expires, к объектам.

разрешённые_HTTP_методы -> (строка)

HTTP-методы, которые обрабатываются и перенаправляются к источнику распределения.

Вы можете указать следующие варианты:

  • GET,HEAD - Распределение пересылает методы GET и HEAD.
  • GET,HEAD,OPTIONS - Распределение пересылает методы GET, HEAD и OPTIONS.
  • GET,HEAD,OPTIONS,PUT,PATCH,POST,DELETE - Распределение пересылает методы GET, HEAD, OPTIONS, PUT, PATCH, POST и DELETE.

Если вы укажете третий вариант, вам, возможно, потребуется ограничить доступ к источнику вашего распределения, чтобы пользователи не могли выполнять операции, которые вы не хотите им разрешать. Например, вы можете не захотеть, чтобы пользователи имели разрешение на удаление объектов из вашего источника.

кэшируемые_HTTP_методы -> (строка)

Ответы HTTP-методов, которые кэшируются вашим распределением.

Вы можете указать следующие варианты:

  • GET,HEAD - Распределение кэширует ответы на методы GET и HEAD.
  • GET,HEAD,OPTIONS - Распределение кэширует ответы на методы GET, HEAD и OPTIONS.

пересылаемые_cookie -> (структура)

Объект, описывающий cookie, которые пересылаются источнику. Ваш контент кэшируется на основе пересылаемых cookie.

вариант -> (строка)

Указывает, какие cookie пересылать источнику распределения: all, none или allow-list, чтобы пересылать только cookie, указанные в параметре cookiesAllowList.

список_разрешённых_cookie -> (список)

Конкретные cookie, которые пересылать источнику вашего распределения.

(строка)

пересылаемые_заголовки -> (структура)

Объект, описывающий заголовки, которые пересылаются источнику. Ваш контент кэшируется на основе пересылаемых заголовков.

вариант -> (строка)

Заголовки, которые вы хотите, чтобы ваше распределение пересылало вашему источнику и на основании которых производить кэширование.

Вы можете настроить распределение следующим образом:

  • **all ** - Пересылать все заголовки вашему источнику.
  • **none ** - Пересылать только заголовки по умолчанию.
  • **allow-list ** - Пересылать только те заголовки, которые вы укажете с помощью параметра headersAllowList.

список_разрешённых_заголовков -> (список)

Конкретные заголовки, которые пересылать вашему источнику распределения.

(строка)

пересылаемые_строки_запроса -> (структура)

Объект, описывающий строки запроса, которые пересылаются источнику. Ваш контент кэшируется на основе пересылаемых строк запроса.

вариант -> (булево)

Указывает, пересылает ли распределение и кэширует ли на основе строк запроса.

список_разрешённых_строк_запроса -> (список)

Конкретные строки запроса, которые распределение пересылает источнику.

Ваше распределение будет кэшировать контент на основе указанных строк запроса.

Если параметр option равен true, то распределение пересылает все строки запроса, независимо от того, что вы укажете с помощью параметра queryStringsAllowList.

(строка)

поведения_кэширования -> (список)

Массив объектов, описывающих поведение кэша для каждого пути в распределении.

(структура)

Описывает поведение кэша для каждого пути в распределении Amazon Lightsail CDN.

Поведение кэша для каждого пути используется для переопределения или добавления исключения к стандартному поведению кэша распределения. Например, если поле cacheBehavior установлено в значение cache, то поведение кэша для каждого пути можно использовать для указания каталога, файла или типа файла, которые будет кэшировать ваше распределение. В противном случае, если поле cacheBehavior распределения установлено в значение dont-cache, то поведение кэша для каждого пути можно использовать для указания каталога, файла или типа файла, которые ваше распределение не будет кэшировать.

path -> (строка)

Путь к каталогу или файлу, который нужно кэшировать или не кэшировать. Используйте символ звездочки для указания подстановочных каталогов (path/to/assets/* ) и типов файлов (*.html, *jpg, *js ). Пути к каталогам и файлам чувствительны к регистру.

Примеры:

  • Укажите следующее, чтобы кэшировать все файлы в корневом каталоге веб-сервера Apache, работающего на экземпляре Lightsail. var/www/html/
  • Укажите следующий файл, чтобы кэшировать только главную страницу в корневом каталоге веб-сервера Apache. var/www/html/index.html
  • Укажите следующее, чтобы кэшировать только файлы с расширением .html в корневом каталоге веб-сервера Apache. var/www/html/*.html
  • Укажите следующее, чтобы кэшировать только файлы с расширениями .jpg, .png и .gif в подкаталоге images корневого каталога веб-сервера Apache. var/www/html/images/*.jpg var/www/html/images/*.png var/www/html/images/*.gif Укажите следующее, чтобы кэшировать все файлы в подкаталоге images корневого каталога веб-сервера Apache. var/www/html/images/

behavior -> (строка)

Поведение кэша для указанного пути.

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

  • **cache ** - Это поведение кэширует указанный путь.
  • **dont-cache ** - Это поведение не кэширует указанный путь.

ableToUpdateBundle -> (булево)

Указывает, можно ли изменить пакет, который в настоящее время применён к вашему распределению, указанный параметром distributionName, на другой пакет.

Используйте действие UpdateDistributionBundle для изменения пакета вашего распределения.

ipAddressType -> (строка)

Тип IP-адреса распределения.

Возможные значения: ipv4 для только IPv4 и dualstack для IPv4 и IPv6.

tags -> (список)

Ключи тегов и необязательные значения для ресурса. Дополнительную информацию о тегах в Lightsail см. в руководстве разработчика Amazon Lightsail.

(структура)

Описывает ключ тега и необязательное значение, назначенные ресурсу Amazon Lightsail.

Дополнительно о тегах в Lightsail смотрите в руководстве разработчика Amazon Lightsail.

key -> (строка)

Ключ тега.

Ограничения: Ключи тегов могут содержать максимум 128 символов, цифр, пробелов в UTF-8, или следующие символы: + - = . _ : / @

value -> (строка)

Значение тега.

Ограничения: Значения тегов могут содержать максимум 256 символов, цифр, пробелов в UTF-8, или следующие символы: + - = . _ : / @

viewerMinimumTlsProtocolVersion -> (строка)

Минимальная версия протокола TLS, которую распределение может использовать для связи с пользователями.

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

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

id -> (строка)

Идентификатор операции.

resourceName -> (строка)

Имя ресурса.

resourceType -> (строка)

Тип ресурса.

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

Метка времени инициализации операции (1479816991.349).

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

Регион и зона доступности Amazon Web Services.

availabilityZone -> (строка)

Зона доступности. Формат соответствует шаблону us-east-2a (чувствителен к регистру).

regionName -> (строка)

Имя региона Amazon Web Services.

isTerminal -> (булево)

Булево значение, указывающее, является ли операция конечной.

operationDetails -> (строка)

Подробности об операции (Debian-1GB-Ohio-1).

operationType -> (строка)

Тип операции.

status -> (строка)

Статус операции.

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

Метка времени изменения статуса (1479816991.349).

errorCode -> (строка)

Код ошибки.

errorDetails -> (строка)

Подробности об ошибке.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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