Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Plantillas para controlar los repositorios creados durante una acción de extracción, creación mediante inserción o replicación
Utilice plantillas de creación de repositorios de Amazon ECR para definir la configuración que se aplicará a los repositorios creados por Amazon ECR en su nombre. La configuración de una plantilla de creación de repositorios solo se aplica durante la creación del repositorio y no tiene ningún efecto en los repositorios existentes ni en los repositorios creados mediante cualquier otro método. Actualmente, las plantillas de creación de repositorios se pueden utilizar para aplicar la configuración durante la creación del repositorio para las siguientes características:
+ Caché de extracción
+ Crea al instante
+ Replicación
## Cómo funcionan las plantillas de creación de repositorios
Hay ocasiones en las que Amazon ECR necesita crear un nuevo repositorio privado en su nombre. Por ejemplo:
+ La primera vez que utilice una regla de caché de extracción para recuperar el contenido de un repositorio principal y almacenarlo en su registro privado de Amazon ECR.
+ Cuando envías una imagen a un repositorio que aún no existe.
+ Cuando desee que Amazon ECR replique un repositorio en otra región o cuenta.
Cuando no hay una plantilla de creación de repositorios que se ajuste a la regla de caché de extracción o repositorio replicado, Amazon ECR utiliza la configuración predeterminada para el nuevo repositorio. Estas configuraciones predeterminadas incluyen desactivar la inmutabilidad de las etiquetas, utilizar el cifrado `AES-256` y no aplicar ninguna política de repositorio o ciclo de vida.
Cuando no haya una plantilla de creación de repositorios que coincida con el repositorio de destino para una inserción de imágenes, Amazon ECR no creará un repositorio con la configuración predeterminada.
El uso de una plantilla de creación de repositorios le permite definir la configuración que Amazon ECR aplica a los nuevos repositorios creados mediante la caché de extracción, la creación mediante inserción y las acciones de replicación. Puede definir la inmutabilidad de las etiquetas, la configuración del cifrado, los permisos de los repositorios, la política de ciclo de vida y las etiquetas de recursos para los nuevos repositorios.
En el siguiente diagrama, se muestra el flujo de trabajo que Amazon ECR usa cuando se usa una plantilla de creación de repositorio.
![\[Muestra cómo se aplican las plantillas de creación de repositorios a los repositorios nuevos.\]](http://docs.aws.amazon.com/es_es/AmazonECR/latest/userguide/images/repository_creation_template_light.png)
A continuación se describe en detalle cada parámetro de una plantilla de creación de repositorios.
Prefijo
El **prefijo es el prefijo** del espacio de nombres del repositorio que se va a asociar a la plantilla. A todos los repositorios creados con este prefijo se les aplicará la configuración definida en esta plantilla. Por ejemplo, el prefijo de `prod` se aplicaría a todos los repositorios que comiencen por `prod/`. De forma similar, el prefijo de `prod/team` se aplicaría a todos los repositorios que comiencen por `prod/team/`. En un registro que contenga dos plantillas, si una de ellas tiene el prefijo «prod» y la otra el prefijo «/». prod/team", the template with the prefix "prod/team" will be applied to all repositories whose names start with "prod/team
Para aplicar una plantilla a todos los repositorios de su registro que no tengan una plantilla de creación asociada, puede utilizar `ROOT` como prefijo.
Siempre se aplica una suposición `/` al final del prefijo. Si especifica `ecr-public` como prefijo, Amazon ECR lo tratará como `ecr-public/`. Cuando utilice una regla de caché de extracción, el prefijo de repositorio que especifique durante la creación de la regla es el que debe especificar también como prefijo de la plantilla de creación de repositorios.
Description (Descripción)
Esta **descripción de la plantilla** es opcional y se utiliza para describir el propósito de la plantilla de creación de repositorios.
Aplicar a
La configuración **applied for** (aplicar a) determinará los repositorios creados por Amazon ECR que se crearán con esta plantilla. Los valores válidos son `PULL_THROUGH_CACHE`, `CREATE_ON_PUSH` y `REPLICATION`. Por ejemplo, la primera vez que utilice una regla de caché de extracción para recuperar el contenido de un repositorio de origen y almacenarlo en su registro privado de Amazon ECR. Cuando no hay una plantilla de creación de repositorios que se ajuste a la regla de caché de extracción, Amazon ECR utiliza la configuración predeterminada para el nuevo repositorio.
Rol de creación de repositorios
El **rol de creación de repositorios** es un ARN del rol de IAM que Amazon ECR asumirá al crear y configurar repositorios mediante plantillas de creación de repositorios. Esta función debe proporcionarse cuando se utilizan las etiquetas de repositorio and/or KMS en la plantilla; de lo contrario, se producirá un error en la creación del repositorio.
Mutabilidad de etiquetas de imágenes
La configuración de **mutabilidad de etiquetas** que se utilizará en los repositorios creados con la plantilla. Si se omite este parámetro, se utilizará la configuración predeterminada de **MUTABLE**, lo que permitirá sobrescribir las etiquetas de imágenes. Esta es la configuración recomendada para las plantillas utilizadas en los repositorios creados mediante acciones de caché de extracción. Esto garantiza que Amazon ECR pueda actualizar las imágenes almacenadas en caché cuando las etiquetas sean las mismas.
Si se especifica **INMUTABLE**, todas las etiquetas de imagen dentro del repositorio serán inmutables, lo que evitará que se sobrescriban.
La configuración de cifrado
El cifrado de doble capa del lado del servidor con AWS KMS (DSSE-KMS) solo está disponible en las regiones. AWS GovCloud (US)
La **configuración de cifrado** que se utilizará en los repositorios creados con la plantilla.
Si utiliza el tipo de cifrado de **KMS**, el contenido del repositorio se cifrará mediante el cifrado de lado del servidor con la clave de AWS Key Management Service almacenada en AWS KMS. Cuando utiliza AWS KMS para cifrar sus datos, puede utilizar la AWS KMS clave AWS gestionada predeterminada para Amazon ECR o especificar su propia AWS KMS clave, que ya ha creado. También puede optar por utilizar el cifrado de una o dos capas con. AWS KMS Para obtener más información, consulte [Cifrado en reposo](encryption-at-rest.md) . Si utiliza el tipo de cifrado **KMS** junto con la replicación entre regiones, es posible que necesite permisos adicionales. Para obtener más información, consulte [Crear una política de claves de KMS para la replicación](https://docs.aws.amazon.com/AmazonECR/latest/userguide/registry-permissions-create.html).
Si utiliza el tipo de encriptación **AES256**, Amazon ECR utiliza el cifrado del lado del servidor con claves de cifrado administradas por Amazon S3 que cifran las imágenes del repositorio mediante un algoritmo de cifrado AES-256. Para obtener más información, consulte [Protección de datos mediante el cifrado del lado del servidor con las claves de cifrado administradas por Amazon S3 (SSE-S3)](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html) en la *Guía del usuario de Amazon Simple Storage Service*.
Permisos de repositorio
La **política de repositorios** que se aplicará a los repositorios creados con la plantilla. Una política de repositorio utiliza permisos basados en recursos para controlar el acceso a un repositorio. Los permisos basados en recursos permiten especificar qué usuarios o roles de IAM tienen acceso a un repositorio y qué acciones pueden realizar en él. De forma predeterminada, solo la AWS cuenta que creó el repositorio tiene acceso a un repositorio. Puede aplicar un documento de política para otorgar o denegar permisos adicionales a su repositorio. Para obtener más información, consulte [Políticas de repositorios privados en Amazon ECR](repository-policies.md).
Política del ciclo de vida de repositorio
La **política de ciclo de vida** que se utilizará para los repositorios creados con la plantilla. Una política de ciclo de vida proporciona más control sobre la administración del ciclo de vida de las imágenes en un repositorio privado. Una política de ciclo de vida incluye una o varias reglas, en la que cada regla define una acción de Amazon ECR. Esto proporciona una forma de automatizar la limpieza de sus imágenes de contenedor, cuyo vencimiento se produce en función de su antigüedad o recuento. Para obtener más información, consulte [Automatice la limpieza de imágenes mediante el uso de políticas de ciclo de vida en Amazon ECR](LifecyclePolicies.md).
Etiquetas de recursos
Las **etiquetas de recursos** son metadatos que se aplican a los repositorios para ayudarlo a categorizarlos y organizarlos. Cada etiqueta está formada por una clave y un valor opcional, ambos definidos por el usuario. Si utiliza plantillas de creación de repositorios con replicación entre regiones, este permiso se debe aplicar a la política de registro de destino.
# Crear una plantilla de creación de repositorios en Amazon ECR
Puede crear una plantilla de creación de repositorios para definir la configuración que se utilizará en los repositorios creados por Amazon ECR en su nombre durante las acciones de extracción de memoria caché, creación mediante inserción o replicación. Una vez creada la plantilla de creación de repositorios, se aplicará la configuración a todos los repositorios nuevos que se creen. Esto no tiene ningún efecto en ningún repositorio creado anteriormente.
Al configurar un repositorio con plantillas, puede especificar las claves KMS y las etiquetas de recursos. Si pretende utilizar claves de KMS, etiquetas de recursos o una combinación de ambas en una o más plantillas, tiene que realizar lo siguiente:
+ [Cree una política personalizada para las plantillas de creación de repositorios](repository-creation-templates-custom.md).
+ [Cree un rol de IAM para las plantillas de creación de repositorios](repository-creation-templates-create-iam.md).
Una vez finalizada la configuración, puede adjuntar el rol personalizado a plantillas específicas de su registro.
## Permisos de IAM para crear plantillas de creación de repositorio
Los siguientes permisos son necesarios para que una entidad principal de IAM administre las plantillas de creación de repositorios. Este permiso debe otorgarse a través de una política de IAM basada en identidad.
+ `ecr:CreateRepositoryCreationTemplate`: otorga permiso para crear una plantilla de creación de repositorio.
+ `ecr:UpdateRepositoryCreationTemplate`: otorga permiso para actualizar una plantilla de creación de repositorio.
+ `ecr:DescribeRepositoryCreationTemplates`: otorga permiso para enumerar plantillas de creación de repositorio en un registro.
+ `ecr:DeleteRepositoryCreationTemplate`: otorga permiso para eliminar una plantilla de creación de repositorio.
+ `ecr:CreateRepository`: otorga permiso para crear un repositorio de Amazon ECR.
+ `ecr:PutLifecyclePolicy`: otorga permiso para crear una política de ciclo de vida y aplicarla a un repositorio. Este permiso solo es necesario si la plantilla de creación del repositorio incluye una política de ciclo de vida.
+ `ecr:SetRepositoryPolicy`: otorga permiso para crear una política de permisos para un repositorio. Este permiso solo es necesario si la plantilla de creación del repositorio incluye una política de repositorio.
+ `iam:PassRole`: otorga permiso para permitir que una entidad transfiera un rol a un servicio o a una aplicación. Este permiso es necesario para los servicios y las aplicaciones que necesitan adoptar un rol con el fin de realizar acciones en su nombre.
# Cree una política personalizada para las plantillas de creación de repositorios
Puede utilizarla Consola de administración de AWS para definir una política que se asociará posteriormente a un rol de IAM. Este rol de IAM se puede utilizar luego como un rol de creación de repositorios al configurar una plantilla de creación de repositorios.
------
#### [ Consola de administración de AWS ]
**Para utilizar el editor de políticas de JSON y crear una política personalizada para las plantillas de creación de repositorios.**
1. Inicie sesión en la consola de IAM Consola de administración de AWS y ábrala en. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)
1. En el panel de navegación de la izquierda, elija **Políticas**.
1. Elija **Crear política**.
1. En la sección **Editor de políticas**, seleccione la opción **JSON**.
1. Introduzca la siguiente política en el campo de **JSON**.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ecr:CreateRepository",
"ecr:ReplicateImage",
"ecr:TagResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"kms:CreateGrant",
"kms:RetireGrant",
"kms:DescribeKey"
],
"Resource": "*"
}
]
}
```
------
1. Resuelva las advertencias de seguridad, errores o advertencias generales que se generen durante la[ validación de la política](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_policy-validator.html) y luego elija **Siguiente**.
1. Cuando haya terminado de agregar permisos a la política, seleccione **Siguiente**.
1. En la página **Revisar y crear**, escriba el **Nombre de la política** y la **Descripción** (opcional) para la política que está creando. Revise los **Permisos definidos en esta política** para ver los permisos que concede la política.
1. Elija **Crear política** para guardar la nueva política.
1. Cree un rol para asignar esta política a la plantilla de creación, consulte [Cree un rol de IAM para las plantillas de creación de repositorios](repository-creation-templates-create-iam.md).
------
# Cree un rol de IAM para las plantillas de creación de repositorios
Puede utilizarla Consola de administración de AWS para crear una función que Amazon ECR pueda utilizar cuando especifique la función de creación de repositorios en una plantilla de creación de repositorios que utilice etiquetas de repositorio o KMS en una plantilla.
------
#### [ Consola de administración de AWS ]
**Para crear un rol.**
1. Inicie sesión en la consola de IAM Consola de administración de AWS y ábrala en. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)
1. En el panel de navegación de la consola, elija **Roles** y, a continuación, seleccione **Crear rol**.
1. Elija el tipo de rol **Política de confianza personalizada**.
1. En la sección **Política de confianza personalizada**, pegue la política de confianza personalizada que se indica a continuación:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "ecr.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
1. Elija **Siguiente**.
1. En la página **Añadir permisos**, seleccione la casilla de verificación situada junto a la política personalizada que creó anteriormente en la lista de Políticas de permisos y seleccione **Siguiente**.
1. Escriba un nombre para el rol en **Nombre de rol**. Los nombres de los roles deben ser únicos dentro de su. Cuenta de AWS Cuando se utiliza un nombre de rol en una política o como parte de un ARN, el nombre del rol distingue entre mayúsculas y minúsculas. Cuando los clientes ven un nombre de rol en la consola, por ejemplo, durante el proceso de inicio de sesión, el nombre del rol no distingue entre mayúsculas y minúsculas. Dado que varias entidades pueden hacer referencia al rol, no se puede editar el nombre del rol una vez que se crea.
1. (Opcional) En **Descripción**, ingrese una descripción para el nuevo rol.
1. Revise el rol y, a continuación, seleccione **Crear rol**.
------
## Cree una plantilla de creación de repositorios
Una vez que haya completado los requisitos previos necesarios para las plantillas, puede proceder a crear las plantillas de creación de repositorios.
------
#### [ Consola de administración de AWS ]
**Crear una plantilla de creación de repositorios (Consola de administración de AWS)**
1. Abra la consola Amazon ECR en [https://console.aws.amazon.com/ecr/](https://console.aws.amazon.com/ecr/).
1. En la barra de navegación, elija la región en la que crear la plantilla de creación del repositorio.
1. En el panel de navegación, elija **Registro privado**, **Plantillas de creación de repositorios**.
1. En la página de **plantillas de creación de repositorios**, seleccione **Crear plantilla**.
1. En la página **Step 1: Define template**, (Paso 1: definir una plantilla), en **Template details** (Detalles de la plantilla), seleccione **A specific prefix** (Un prefijo específico) para aplicar la plantilla a un prefijo de espacio de nombres de repositorio específico, o seleccione **Any prefix in your ECR registry** (Cualquier prefijo de su registro de ECR) para aplicar la plantilla a todos los repositorios que no coincidan con ninguna otra plantilla de la región.
1. Si elige **Un prefijo específico**, especifique el prefijo del espacio de nombres del repositorio al que se va a aplicar la plantilla en **Prefijo**. Siempre se aplica una suposición `/` al final del prefijo. Por ejemplo, el prefijo de `prod` se aplicaría a todos los repositorios que comiencen por `prod/`. De forma similar, el prefijo de `prod/team` se aplicaría a todos los repositorios que comiencen por `prod/team/`.
1. Si selecciona **Cualquier prefijo en su registro ECR**, el **Prefijo** se establecerá en `ROOT`.
1. En **aplicar a**, especifique a qué flujos de trabajo de Amazon ECR se aplicará esta plantilla. Las opciones son `PULL_THROUGH_CACHE`, `CREATE_ON_PUSH` y `REPLICATION`.
1. En **Descripción de la plantilla**, especifique una descripción opcional para la plantilla y, a continuación, seleccione **Siguiente**.
1. En la página del **Paso 2: Agregar la configuración de creación de repositorios**, especifique la configuración del repositorio que se aplicará a los repositorios creados con la plantilla.
1. Para **Mutabilidad de la etiqueta de imagen**, elija la configuración de mutabilidad de la etiqueta que desea utilizar. Para obtener más información, consulte [Cómo impedir que se sobrescriban las etiquetas de imagen en Amazon ECR](image-tag-mutability.md).
+ **Mutable**: elija esta opción si desea que se sobrescriban las etiquetas de las imágenes. Se recomienda para los repositorios que utilizan acciones de caché de extracción para asegurar que Amazon ECR actualice las imágenes en caché. Asimismo, para deshabilitar las actualizaciones de etiquetas para algunas etiquetas mutables, ingrese los nombres de las etiquetas o utilice comodines (\$1) para hacer coincidir varias etiquetas similares en el cuadro de texto **Exclusión de etiquetas mutables**.
+ **Inmutable**: seleccione esta opción si desea evitar que las etiquetas de imagen se sobrescriban y se aplica a todas las etiquetas y exclusiones del repositorio cuando se inserta una imagen con una etiqueta existente. Amazon ECR devuelve un `ImageTagAlreadyExistsException` si intenta insertar una imagen con una etiqueta existente. Asimismo, para activar las actualizaciones de etiquetas para algunas etiquetas inmutables, ingrese los nombres de las etiquetas o utilice comodines (\$1) para hacer coincidir varias etiquetas similares en el cuadro de texto **Exclusión de etiquetas inmutables**.
1. Para **Configuración del cifrado**, elija el ajuste de cifrado que desee utilizar. Para obtener más información, consulte [Cifrado en reposo](encryption-at-rest.md).
Cuando se selecciona **AES-256**, Amazon ECR utiliza cifrado del lado del servidor con claves de cifrado administradas por Amazon Simple Storage Service que cifra sus datos en reposo mediante un algoritmo de cifrado AES-256 estándar de la industria. Esto se ofrece sin costo adicional.
Cuando se selecciona **AWS KMS**, Amazon ECR utiliza el cifrado del lado del servidor con las claves almacenadas en AWS Key Management Service (AWS KMS). Cuando utiliza AWS KMS para cifrar sus datos, puede utilizar la clave AWS gestionada predeterminada, que gestiona Amazon ECR, o especificar su propia AWS KMS clave, que se denomina clave *gestionada por el cliente*.
**nota**
La configuración de cifrado de un repositorio no se puede cambiar una vez creado el repositorio.
1. En **Permisos del repositorio**, especifique la política de permisos del repositorio que se aplicará a los repositorios creados con esta plantilla. Si lo desea, puede utilizar el menú desplegable para seleccionar uno de los ejemplos de JSON para los casos de uso más comunes. Para obtener más información, consulte [Políticas de repositorios privados en Amazon ECR](repository-policies.md).
1. En **Política de ciclo de vida del repositorio**, especifique la política de ciclo de vida del repositorio que se aplicará a los repositorios creados con esta plantilla. Si lo desea, puede utilizar el menú desplegable para seleccionar uno de los ejemplos de JSON para los casos de uso más comunes. Para obtener más información, consulte [Automatice la limpieza de imágenes mediante el uso de políticas de ciclo de vida en Amazon ECR](LifecyclePolicies.md).
1. **En el caso de las ** AWS etiquetas de repositorio**, especifique los metadatos, en forma de pares clave-valor, que desee asociar a los repositorios creados con esta plantilla y, a continuación, seleccione Siguiente.** Para obtener más información, consulte [Etiquetado de un repositorio privado en Amazon ECR](ecr-using-tags.md).
1. Para el **rol de creación de repositorios**, seleccione un rol de IAM personalizado desde el menú desplegable con el fin de utilizarlo en las plantillas de creación de repositorios cuando se usen etiquetas de repositorio o KMS en la plantilla (para obtener más información, consulte [Cree un rol de IAM para las plantillas de creación de repositorios](repository-creation-templates-create-iam.md)). A continuación, presione **Siguiente**.
1. En la página del **Paso 3: Revisar y crear**, revise la configuración que especificó para la plantilla de creación del repositorio. Seleccione la opción **Editar** para realizar cambios. Cuando haya terminado, elija **Crear**.
------
#### [ AWS CLI ]
El [create-repository-creation-template](https://docs.aws.amazon.com/cli/latest/reference/ecr/create-repository-creation-template.html) AWS CLI comando se utiliza para crear una plantilla de creación de repositorios para su registro privado.
**Crear una plantilla de creación de repositorios (AWS CLI)**
1. Utilice el AWS CLI para generar un esqueleto para el [create-repository-creation-template](https://docs.aws.amazon.com/cli/latest/reference/ecr/create-repository-creation-template.html)comando.
```
aws ecr create-repository-creation-template \
--generate-cli-skeleton
```
El resultado del comando mostrará la sintaxis completa de la plantilla de creación del repositorio.
```
{
"appliedFor":[""], // string array, but valid are PULL_THROUGH_CACHE, CREATE_ON_PUSH, and REPLICATION
"prefix": "string",
"description": "string",
"imageTagMutability": "MUTABLE"|"IMMUTABLE"|"IMMUTABLE_WITH_EXCLUSION"|"MUTABLE_WITH_EXCLUSION",
"imageTagMutabilityExclusionFilters": [
"filterType": "WILDCARD",
"filter": "string"
],
"repositoryPolicy": "string",
"lifecyclePolicy": "string"
"encryptionConfiguration": {
"encryptionType": "AES256"|"KMS",
"kmsKey": "string"
},
"resourceTags": [
{
"Key": "string",
"Value": "string"
}
],
"customRoleArn": "string", // must be a valid IAM Role ARN
}
```
1. Cree un archivo denominado `repository-creation-template.json` con el resultado del paso anterior. Esta plantilla establece una clave de cifrado de KMS para cualquier repositorio creado con el nombre `prod/*` con una política de repositorio que permita insertar y extraer imágenes de repositorios futuros, establece una política de ciclo de vida que caducará las imágenes con más de dos semanas de antigüedad y establece una función personalizada que permitirá a ECR acceder a la clave de KMS y asignar la etiqueta de recurso `examplekey` a repositorios futuros.
```
{
"prefix": "prod",
"description": "For repositories cached from my PTC rule and in my replication configuration that start with 'prod/'",
"appliedFor": ["PULL_THROUGH_CACHE", "CREATE_ON_PUSH", "REPLICATION"],
"encryptionConfiguration": {
"encryptionType": "KMS",
"kmsKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-example11111"
},
"resourceTags": [
{
"Key": "examplekey",
"Value": "examplevalue"
}
],
"imageTagMutability": "IMMUTABLE_WITH_EXCLUSION",
"imageTagMutabilityExclusionFilters": [
{
"filterType": "WILDCARD",
"filter": "latest"
},
{
"filterType": "WILDCARD",
"filter": "beta*"
}
]
"repositoryPolicy": "{\"Version\":\"2012-10-17\", \"Statement\":[{\"Sid\":\"AllowPushPullIAMRole\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::111122223333:user\/IAMusername\"},\"Action\":[\"ecr:BatchGetImage\",\"ecr:BatchCheckLayerAvailability\",\"ecr:CompleteLayerUpload\",\"ecr:GetDownloadUrlForLayer\",\"ecr:InitiateLayerUpload\",\"ecr:PutImage\",\"ecr:UploadLayerPart\"]}]}",
"lifecyclePolicy": "{\"rules\":[{\"rulePriority\":1,\"description\":\"Expire images older than 14 days\",\"selection\":{\"tagStatus\":\"any\",\"countType\":\"sinceImagePushed\",\"countUnit\":\"days\",\"countNumber\":14},\"action\":{\"type\":\"expire\"}}]}",
"customRoleArn": "arn:aws:iam::111122223333:role/myRole"
}
```
1. Para crear una plantilla de creación de repositorios, utilice el siguiente comando. Asegúrese de especificar el nombre del archivo de configuración que creó en el paso anterior en lugar del `repository-creation-template.json` en el ejemplo siguiente.
```
aws ecr create-repository-creation-template \
--cli-input-json file://repository-creation-template.json
```
------
# Actualizar una plantilla de creación de repositorios
Puede editar una plantilla de creación de repositorios en el caso de que necesite cambiar sus configuraciones. Una vez que edite la plantilla de creación de repositorios, las nuevas configuraciones se aplicarán a la plantilla existente.
**importante**
Esto no tiene ningún efecto en ningún repositorio creado anteriormente.
------
#### [ Consola de administración de AWS ]
**Editar una plantilla de creación de repositorios (Consola de administración de AWS)**
1. Abra la consola Amazon ECR en [https://console.aws.amazon.com/ecr/](https://console.aws.amazon.com/ecr/).
1. En la barra de navegación, elija la región en la que se encuentra la plantilla de creación del repositorio que desea editar.
1. En el panel de navegación, elija **Registro privado** y, a continuación, **Configuración**.
1. En la barra de navegación, elija las **Plantillas de creación de repositorios**.
1. En la página de **Plantillas de creación de repositorios**, seleccione la plantilla de creación de repositorios que desea editar.
1. Desde el menú desplegable **Acciones**, elija **Editar**.
1. Revise y actualice los ajustes de configuración.
1. Elija actualizar para aplicar las nuevas configuraciones de plantillas de creación.
------
#### [ AWS CLI ]
**Editar una plantilla de creación de repositorios (AWS CLI)**
+ Utilice el [update-repository-creation-template](https://docs.aws.amazon.com/cli/latest/reference/ecr/update-repository-creation-template.html)comando para actualizar una plantilla de creación de repositorios existente. Debe especificar el valor `prefix` de la plantilla. En el siguiente ejemplo, se actualiza una plantilla de creación de repositorios con el prefijo `prod`.
```
aws ecr update-repository-creation-template \
--prefix prod \
--image-tag-mutability="IMMUTABLE_WITH_EXCLUSION" \
--image-tag-mutability-exclusion-filters filterType=WILDCARD, filter=latest
```
El resultado del comando mostrará los detalles de la plantilla de creación de repositorios actualizada.
------
# Eliminar una plantilla de creación de repositorios en Amazon ECR
Puede eliminar una plantilla de creación de repositorios si ha terminado de utilizarla. Una vez eliminada una plantilla de creación de repositorios, los repositorios recién creados con el prefijo asociado durante una acción de extracción de caché o replicación heredarán la configuración predeterminada, a menos que se encuentre otra plantilla coincidente. Para obtener más información, consulte [Cómo funcionan las plantillas de creación de repositorios](repository-creation-templates.md#repository-creation-templates-works).
**importante**
Esto no tiene ningún efecto en ningún repositorio creado anteriormente.
------
#### [ Consola de administración de AWS ]
**Eliminar una plantilla de creación de repositorios (Consola de administración de AWS)**
1. Abra la consola Amazon ECR en [https://console.aws.amazon.com/ecr/](https://console.aws.amazon.com/ecr/).
1. En la barra de navegación, elija la región en la que se encuentra la plantilla de creación del repositorio que desea eliminar.
1. En el panel de navegación, elija **Registro privado**, **Plantillas de creación de repositorios**.
1. En la página de **plantillas de creación de repositorios**, seleccione la plantilla de creación de repositorios que desee eliminar.
1. En el menú desplegable **Acciones**, elija **Eliminar**.
------
#### [ AWS CLI ]
**Eliminar una plantilla de creación de repositorios (AWS CLI)**
+ Utilice el comando [delete-repository-creation-template.html](https://docs.aws.amazon.com/cli/latest/reference/ecr/delete-repository-creation-template.html) para eliminar una plantilla de creación de repositorios existente. Debe especificar el valor `prefix` de la plantilla. En el siguiente ejemplo, se elimina una plantilla de creación de repositorios con el prefijo `prod`.
```
aws ecr delete-repository-creation-template \
--prefix prod
```
El resultado del comando mostrará los detalles de la plantilla de creación de repositorios eliminada.
------