INTEGRITY Документация

Создание предустановленных вариантов

Варианты позволяют задать, как изменять размер изображений для разных сценариев использования. По умолчанию изображения отдаются с public вариант, но можно создать до 100 вариантов под свои задачи. Чтобы создать вариант, выполните следующие шаги.

  1. На панели управления Cloudflare перейдите к разделу Размещённые изображения страницу.

    Перейдите в Размещённые изображения ↗
  2. Выберите Доставка на вкладке.

  3. Выберите Создать вариант.

  4. Задайте имя варианта и выберите Создание.

  5. Определите параметры нового варианта, такие как настройки изменения размера, способ подгонки и отдельные параметры метаданных.

Изменение размера через API

Сделайте POST запрос к создать вариант.

curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/images/v1/variants" \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{"id":"<NAME_OF_THE_VARIANT>","options":{"fit":"scale-down","metadata":"none","width":1366,"height":768},"neverRequireSignedURLs":true}

Параметры fit

Fit описывает, как следует интерпретировать значения ширины и высоты. В таблице ниже описан каждый из вариантов.

Параметры Fit Поведение
Уменьшение размера Размер изображения уменьшается так, чтобы оно полностью вписалось в заданную ширину или высоту, но не увеличивается.
Contain Размер изображения изменяется (уменьшается или увеличивается) так, чтобы оно было как можно больше в пределах заданной ширины или высоты с сохранением соотношения сторон.
Cover Размер изображения изменяется так, чтобы точно заполнить всю область, заданную шириной и высотой, при необходимости изображение обрезается.
Crop Изображение уменьшается и обрезается, чтобы вписаться в область, заданную шириной и высотой. Увеличение изображения не производится. Для изображений меньше заданных размеров результат совпадает с scale-down. Для изображений, превышающих заданные размеры, это равнозначно cover.
Pad Размер изображения изменяется (уменьшается или увеличивается) так, чтобы оно было как можно больше в пределах заданной ширины или высоты с сохранением соотношения сторон. Оставшаяся область заполняется цветом фона (по умолчанию белым).

Параметры метаданных

Варианты позволяют выбрать, что делать с метаданными изображения. В разделе Метаданные раскрывающемся списке выберите:

Публичный доступ

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