Spec-Zone.ru › AWS CLI v2

[ aws . ecr ]

create-repository-creation-template

Описание

Создаёт шаблон создания репозитория. Этот шаблон используется для определения настроек репозиториев, создаваемых Amazon ECR от вашего имени. Например, репозитории, созданные через действия кеширования pull-through. Дополнительную информацию см. в разделе Шаблоны создания частных репозиториев в руководстве пользователя Amazon Elastic Container Registry.

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

Синтаксис

  create-repository-creation-template
--prefix <value>
[--description <value>]
[--encryption-configuration <value>]
[--resource-tags <value>]
[--image-tag-mutability <value>]
[--repository-policy <value>]
[--lifecycle-policy <value>]
--applied-for <value>
[--custom-role-arn <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]

Параметры

--prefix (строка)

Префикс пространства имён репозитория, который следует ассоциировать с шаблоном. Все репозитории, созданные с этим префиксом, будут иметь применённые настройки, определённые в этом шаблоне. Например, префикс prod будет применяться ко всем репозиториям, начинающимся с prod/. Аналогично, префикс prod/team будет применяться ко всем репозиториям, начинающимся с prod/team/.

Чтобы применить шаблон ко всем репозиториям в вашем реестре, у которых нет связанного шаблона создания, вы можете использовать ROOT в качестве префикса.

Предупреждение

В префикс всегда предполагается добавление /. Если вы укажете ecr-public в качестве префикса, Amazon ECR будет трактовать это как ecr-public/. При использовании правила pull-through кеширования, префикс репозитория, указанный при создании правила, должен быть также указан в качестве префикса шаблона создания репозитория.

--description (строка)

Описание шаблона создания репозитория.

--encryption-configuration (структура)

Настройка шифрования для репозиториев, созданных с использованием шаблона.

encryptionType -> (строка)

Тип шифрования, который нужно использовать.

Если вы используете тип шифрования KMS, содержимое репозитория будет зашифровано с помощью серверного шифрования с ключом управления ключами, хранящимся в KMS. Когда вы используете KMS для шифрования данных, вы можете использовать стандартный управляемый Amazon Web Services ключ KMS для Amazon ECR, или указать свой собственный ключ KMS, который вы уже создали. Дополнительную информацию см. в разделе Защита данных с помощью серверного шифрования с ключом KMS, хранящимся в службе управления ключами (SSE-KMS) в руководстве разработчика консоли Amazon Simple Storage Service.

Если вы используете тип шифрования AES256, Amazon ECR использует серверное шифрование с управляемыми ключами шифрования Amazon S3, которое шифрует изображения в репозитории с помощью алгоритма шифрования AES256. Дополнительную информацию см. в разделе Защита данных с помощью серверного шифрования с управляемыми ключами шифрования Amazon S3 (SSE-S3) в руководстве разработчика консоли Amazon Simple Storage Service.

kmsKey -> (строка)

Если вы используете тип шифрования KMS, укажите ключ KMS для шифрования. Необходимо указать полный ARN ключа KMS. Ключ должен находиться в том же регионе, что и репозиторий. Если ключ не указан, будет использован стандартный управляемый Amazon Web Services ключ KMS для Amazon ECR.

Сокращённый синтаксис:

encryptionType=string,kmsKey=string

Синтаксис JSON:

{
  "encryptionType": "AES256"|"KMS"|"KMS_DSSE",
  "kmsKey": "string"
}

--resource-tags (список)

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

(структура)

Метаданные, применяемые к ресурсу для помощи в категоризации и организации. Каждая метка состоит из ключа и значения, которые вы определяете. Длина ключей меток может составлять максимум 128 символов, а длина значений меток — максимум 256 символов.

Key -> (строка)

Одна часть пары «ключ-значение», составляющей метку. Ключ — это общая метка, которая действует как категория для более конкретных значений меток.

Value -> (строка)

Значение действует как описание в категории меток (ключ).

Сокращённый синтаксис:

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--image-tag-mutability (строка)

Настройка изменяемости меток для репозитория. Если этот параметр опущен, будет использоваться значение по умолчанию MUTABLE, которое позволит перезаписывать метки изображений. Если указано IMMUTABLE, все метки изображений в репозитории будут неизменяемыми, что предотвратит их перезапись.

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

  • MUTABLE
  • IMMUTABLE

--repository-policy (строка)

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

--lifecycle-policy (строка)

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

--applied-for (список)

Список перечисляемых строк, представляющих сценарии создания репозитория Amazon ECR, к которым будет применяться этот шаблон. Два поддерживаемых сценария — PULL_THROUGH_CACHE и REPLICATION

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  REPLICATION
  PULL_THROUGH_CACHE

--custom-role-arn (строка)

ARN роли, которая будет принята Amazon ECR. Эта роль должна быть в той же учётной записи, что и реестр, который вы настраиваете. Amazon ECR примет вашу предоставленную роль, когда будет указан customRoleArn. Когда этот параметр не указан, Amazon ECR будет использовать связанную с сервисом роль для шаблона создания репозитория.

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

Вывод

registryId -> (строка)

Идентификатор реестра, связанный с запросом.

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

Подробности шаблона создания репозитория, связанные с запросом.

prefix -> (строка)

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

description -> (строка)

Описание, связанное с шаблоном создания репозитория.

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

Настройка шифрования, связанная с шаблоном создания репозитория.

encryptionType -> (строка)

Тип шифрования.

Если вы используете тип шифрования KMS, содержимое репозитория будет зашифровано с помощью серверного шифрования с ключом службы управления ключами (KMS). Когда вы используете KMS для шифрования данных, вы можете использовать управляемый Amazon Web Services ключ KMS по умолчанию для Amazon ECR или указать свой собственный ключ KMS, который вы уже создали. Дополнительную информацию см. в разделе Защита данных с помощью серверного шифрования с ключом KMS, хранящимся в службе управления ключами (SSE-KMS), в Руководстве разработчика консоли Amazon Simple Storage Service.

Если вы используете тип шифрования AES256, Amazon ECR использует серверное шифрование с управляемыми ключами Amazon S3, которое шифрует изображения в репозитории с помощью алгоритма шифрования AES256. Дополнительную информацию см. в разделе Защита данных с помощью серверного шифрования с управляемыми ключами Amazon S3 (SSE-S3) в Руководстве разработчика консоли Amazon Simple Storage Service.

kmsKey -> (строка)

Если вы используете тип шифрования KMS, укажите ключ KMS, который следует использовать для шифрования. Необходимо указать полный ARN ключа KMS. Ключ должен существовать в том же регионе, что и репозиторий. Если ключ не указан, будет использоваться управляемый Amazon Web Services ключ KMS по умолчанию для Amazon ECR.

resourceTags -> (список)

Метаданные, которые необходимо применить к репозиторию для сортировки и организации. Каждый тег состоит из ключа и необязательного значения, которые вы определяете. Длина ключа тега может составлять максимум 128 символов, а длина значения тега — максимум 256 символов.

(структура)

Метаданные, которые необходимо применить к ресурсу для сортировки и организации. Каждый тег состоит из ключа и значения, которые вы определяете. Длина ключа тега может составлять максимум 128 символов, а длина значения тега — максимум 256 символов.

Key -> (строка)

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

Value -> (строка)

value действует как описатель в категории тега (ключ).

imageTagMutability -> (строка)

Параметр изменяемости тегов изображений для репозитория. Если этот параметр опущен, будет использоваться значение по умолчанию MUTABLE, которое позволит перезаписывать теги изображений. Если указано IMMUTABLE, все теги изображений в репозитории будут неизменяемыми, что предотвратит их перезапись.

repositoryPolicy -> (строка)

Политика репозитория, которая применяется к репозиториям, созданным по шаблону. Политика репозитория — это политика разрешений, связанная с репозиторием, для управления разрешениями доступа.

lifecyclePolicy -> (строка)

Политика жизненного цикла для репозиториев, созданных по шаблону.

appliedFor -> (список)

Список перечисляемых строк, представляющих сценарии создания репозитория, к которым будет применяться этот шаблон. Два поддерживаемых сценария — PULL_THROUGH_CACHE и REPLICATION

(строка)

customRoleArn -> (строка)

ARN роли, которая должна быть принята Amazon ECR. Amazon ECR примет вашу предоставленную роль, когда указан customRoleArn. Если это поле не указано, Amazon ECR будет использовать роль сопоставления сервисов для шаблона создания репозитория.

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

Дата и время создания шаблона создания репозитория в формате даты JavaScript.

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

Дата и время последнего обновления шаблона создания репозитория в формате даты JavaScript.

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

Spec-Zone.ru

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