CreateImageCache - Elastic Container Instance - Centro de documentación de Alibaba Cloud

Crea una caché de imágenes para acelerar la descarga de imágenes y reducir el tiempo de inicio en la creación posterior de instancias de Elastic Container Instance (ECI).

Descripción de la operación

Precauciones

La creación de una caché de imágenes genera costos de recursos. Consulte la información de facturación con antelación. Para obtener más información, consulte Facturación de cachés de imágenes.
Antes de crear una caché de imágenes, evalúe el tamaño total de las imágenes que se almacenarán en caché. Si el tamaño total de las imágenes supera el tamaño configurado de la caché, la creación fallará.
Al crear una caché de imágenes, el sistema crea automáticamente una instancia de ECI y un disco en la nube ESSD PL1 para la creación automática intermedia de la imagen. No elimine la instancia de ECI ni el disco en la nube durante el proceso de creación. De lo contrario, la creación automática de la imagen fallará.
La creación de una caché de imágenes genera una instantánea correspondiente. No elimine la instantánea. De lo contrario, la caché de imágenes quedará invalidada.
Si utiliza un SDK, la versión requerida es Java 1.0.10 o posterior, o Python 1.0.7 o posterior.

Recomendaciones

Para las imágenes de Container Registry Enterprise Edition que utilizan nombres de dominio personalizados, especifique la instancia de Container Registry (mediante los parámetros AcrRegistryInfo) para configurar el acceso sin contraseña. Al configurar los parámetros AcrRegistryInfo, debe establecer AcrRegistryInfo.N.InstanceId.
Si la caché de imágenes se utilizará para crear un gran número de instancias de ECI (más de 1,000) en lotes, configure StandardCopyCount y FlashCopyCount para habilitar la función de instantáneas de múltiples copias. Las instantáneas de múltiples copias se facturan según los datos incrementales. Dado que los datos de las copias de instantáneas creadas al mismo tiempo son idénticos, la función de instantáneas de múltiples copias no genera costos adicionales.

Nota

Cuando llama a CreateImageCache para crear una caché de imágenes, el sistema crea automáticamente un rol vinculado al servicio llamado AliyunServiceRoleForECI para acceder a servicios en la nube relacionados como ECS y VPC. Para obtener más información, consulte Rol vinculado al servicio de Elastic Container Instance.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

eci:CreateImageCache

create

*ImageCache

acs:eci:{#regionId}:{#accountId}:imagecache/*

eci:tag

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región.	cn-hangzhou
RegionId	string	Sí	La zona.	cn-hangzhou-g
ZoneId	string	No	El ID del security group.	sg-uf66jeqopgqa9hdn****
SecurityGroupId	string	No	El ID del vSwitch. Puede especificar varios ID de vSwitch (hasta 10 a la vez), separados por comas (,). Ejemplo: `vsw-*,vsw-*`.	vsw-uf6h3rbwbm90urjwa****
VSwitchId	string	No	El nombre de la caché de imágenes.	testcache
ImageCacheName	string	Sí	La dirección IP elástica (EIP). Si necesita descargar imágenes desde Internet, asegúrese de que la instancia de ECI pueda acceder a Internet. Puede configurar una EIP o una puerta de enlace NAT para habilitar el acceso a la red pública.	eip-2zedsm5mfl3uhdj2d****
EipInstanceId	string	No	El ID del grupo de recursos.	rg-aekzh43v*****
ResourceGroupId	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el token, pero debe asegurarse de que el token sea único entre diferentes solicitudes. El token solo puede contener caracteres ASCII y no puede superar los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia.	123e4567-xxx-xxx-xxxx-42665544xxxx
ClientToken	string	No	El tamaño de la caché de imágenes. Valor predeterminado: 20 GiB.	20
ImageCacheSize	integer	No	El período de retención de la caché de imágenes. La caché de imágenes se elimina después de que caduca. De forma predeterminada, la caché de imágenes nunca caduca. Nota Las cachés de imágenes cuya creación falla se conservan solo durante un día.	7
RetentionDays	integer	No	Especifica si se debe habilitar la reutilización de cachés de imágenes. Si esta función está habilitada, una caché de imágenes recién creada puede reutilizar capas de imágenes de cachés existentes, lo que acelera la creación de la caché de imágenes. Valores válidos: true: Habilita la reutilización de cachés de imágenes. false: Deshabilita la reutilización de cachés de imágenes. Valor predeterminado: false.	true
AutoMatchImageCache	boolean	No	La información del repositorio de imágenes.	true
ImageRegistryCredential	array<object>	No	Las imágenes de contenedor utilizadas para crear la caché de imágenes.	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
	object	No	Las imágenes de contenedor utilizadas para crear la caché de imágenes.	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
Password	string	No	The password for the image repository.	password
Server	string	No	The address of the image repository. Do not include the `http://` or `https://` prefix.	registry-vpc.cn-hangzhou.aliyuncs.com
UserName	string	No	The username for the image repository.	username
Image	array	Sí	La información de etiquetas de la caché de imágenes. Puede especificar hasta 20 etiquetas.	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
	string	No	La información de etiquetas de la caché de imágenes. Puede especificar hasta 20 etiquetas.	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
Tag	array<object>	No	Especifica si se debe habilitar la función de caché de imágenes instantánea, que acelera la creación de la caché de imágenes. Valores válidos: true: Habilita la función de caché de imágenes instantánea. false: Deshabilita la función de caché de imágenes instantánea. Valor predeterminado: false.	true
	object	No	The tags of the image cache. You can specify up to 20 tags.
Key	string	No	The key of the image cache tag.	imc
Value	string	No	The value of the image cache tag.	test
Flash	boolean	No	La información de la instancia de Container Registry. Para obtener más información, consulte Descargar imágenes de Container Registry sin usar contraseña.	true
AcrRegistryInfo	array<object>	No	Las anotaciones. Este parámetro no está disponible para uso público.	hide
	object	No	The information about the ACR instance.
Domain	array	No	The domain names of the ACR Enterprise instance. By default, all domain names of the instance are specified. You can specify one or more domain names. Separate multiple domain names with commas (,).	test****-registry.cn-beijing.cr.aliyuncs.com
	string	No	The domain names of the ACR Enterprise instance. By default, all domain names of the instance are specified. You can specify one or more domain names. Separate multiple domain names with commas (,).	test****-registry.cn-beijing.cr.aliyuncs.com
InstanceName	string	No	The name of the ACR Enterprise instance.	test****
InstanceId	string	No	The ID of the ACR Enterprise instance.	cri-nwj395hgf6f3****
RegionId	string	No	The region where the ACR Enterprise instance resides.	cn-beijing
ArnService	string	No	The Alibaba Cloud Resource Name (ARN) of the RAM role that belongs to the account of the resource, such as an ECI instance.	acs:ram::1609982529******:role/role-assume
ArnUser	string	No	The ARN of the RAM role that belongs to the account of the ACR instance.	acs:ram::1298452580******:role/role-acr
Annotations	string	No	La dirección del repositorio de imágenes de descarga directa. Cuando crea una caché de imágenes utilizando imágenes de un repositorio de descarga directa que utiliza el protocolo HTTP, configure este parámetro para que ECI descargue las imágenes mediante HTTP, evitando fallos en la descarga causados por incompatibilidad de protocolos.	"harbor*.pre.com,192.168.XX.XX:5000,reg*.test.com:80"
PlainHttpRegistry	string	No	La dirección del repositorio de imágenes autoadministrado. Cuando crea una caché de imágenes utilizando imágenes de un repositorio de imágenes autoadministrado que utiliza un certificado autofirmado, configure este parámetro para omitir la autenticación de certificados, evitando fallos en la descarga de imágenes causados por errores en la autenticación de certificados.	"harbor*.pre.com,192.168.XX.XX:5000,reg*.test.com:80"
InsecureRegistry	string	No	El número de copias de instantáneas regulares. De forma predeterminada, una caché de imágenes corresponde a una instantánea. Si la caché de imágenes se utilizará para crear múltiples instancias de ECI en lotes, configure este parámetro para habilitar la función de instantáneas de múltiples copias. Se recomienda agregar una copia de instantánea por cada 1,000 instancias de ECI. Nota Cuando la función de caché de imágenes instantánea está deshabilitada (Flash establecido en false), solo se generan instantáneas regulares durante la creación de la caché de imágenes.	7
StandardCopyCount	integer	No	El número de copias de instantáneas locales. De forma predeterminada, una caché de imágenes corresponde a una instantánea. Si la caché de imágenes se utilizará para crear múltiples instancias de ECI en lotes, configure este parámetro para habilitar la función de instantáneas de múltiples copias. Se recomienda agregar una copia de instantánea por cada 1,000 instancias de ECI. Nota Cuando la función de caché de imágenes instantánea está habilitada (Flash establecido en true), primero se crean instantáneas locales durante la creación de la caché de imágenes. Después de crear las instantáneas locales, comienza la creación de instantáneas regulares. Una vez creadas las instantáneas regulares, las instantáneas locales se eliminan automáticamente.	7
FlashCopyCount	integer	No	La estrategia de eliminación de la caché de imágenes. El valor predeterminado está vacío, lo que indica que la caché de imágenes siempre se conserva. Puede establecer este parámetro en LRU, lo que indica que la caché de imágenes se puede eliminar automáticamente. Cuando el número de cachés de imágenes alcanza el límite de cuota, el sistema elimina automáticamente las cachés de imágenes menos utilizadas recientemente cuya EliminationStrategy esté configurada como LRU.	LRU
EliminationStrategy	string	No	El sistema operativo de las imágenes de contenedor. Valores válidos: Linux (predeterminado) Windows Nota Windows se encuentra en vista previa por invitación. Para utilizarlo, envíe un ticket.	Linux
OsType	string	No	The operating system of the container image. Valid values: Linux (default) Windows Nota Windows is in invitational preview. To use this feature, submit a ticket.	Linux

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud, que es un identificador único.	0E234675-3465-4CC3-9D0F-9A864BC391DD
ImageCacheId	string	El ID de la caché de imágenes.	imc-2zebxkiifuyzzlhl****
ContainerGroupId	string	El ID de la instancia de ECI utilizada para la creación intermedia de la caché de imágenes.	eci-2zebxkiifuyzzlhl****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "0E234675-3465-4CC3-9D0F-9A864BC391DD",
  "ImageCacheId": "imc-2zebxkiifuyzzlhl****",
  "ContainerGroupId": "eci-2zebxkiifuyzzlhl****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error
400	Account.Arrearage	Your account has an outstanding payment.
400	DryRunOperation	Request validation has been passed with DryRun flag set.
400	InvalidParameter.CPU.Memory	The specified cpu and memory are not allowed
400	IncorrectStatus	%s
400	ServiceNotEnabled	%s
400	DiskVolume.NotSupport	The disk volume is not supported.
400	RamRole.NotSupport	The RAM role is not supported.
400	ImageCache.IncorrectStatus	%s
400	ImageCacheNotSupport	Image cache is not available for all users. If you want to enable this function, contact us.
400	EipAddressPoolIpNotEnough	The ip address of specified PublicIpAddressPool is not enough.
400	OperationConflict	The request was denied. It conflicts with a previous request.
403	OperationDenied.VswZoneMisMatch	The specified VSwitchId is not in the specified Zone.
403	QuotaExceeded	%s quota exceeded.
403	Zone.NotOnSale	The specified zone is not available for purchase.
403	Forbidden.RiskControl	This operation has been identified as an abnormal operation and cannot be processed.
403	Forbidden.SubUser	The specified action is not available for you.
403	Forbidden.OnlyForInvitedTest	Eci create action is only open to invited users during public beta.
403	OperationDenied.SecurityGroupMisMatch	The specified VSwitchId and SecurityGroupId are not in the same VPC.
403	InvalidVSwitchId.IpNotEnough	The specified VSwitch does not have enough IP addresses.
403	Forbidden.UserBussinessStatus	This operation is not allowed, because you have overdue bills. Pay the overdue bill and try again.
403	Forbidden.UserNotRealNameAuthentication	This operation is not allowed, because you have not passed the real-name verification.
403	InvalidUser.PassRoleForbidden	The RAM user is not authorized to assume a RAM role.
403	OperationDenied.NoStock	Sales of this resource are temporarily suspended in the specified zone. We recommend that you use the multi-zone creation function to avoid the risk of insufficient resource. For more information, see https://www.alibabacloud.com/help/document_detail/157290.html
403	NoPermission	The RAM role AliyunECIContainerGroupRole does not belong to eci.aliyuncs.com. Please check and try again.
403	SecurityRisk.3DVerification	We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email.
403	CreateServiceLinkedRole.Denied	Please make sure the account has ram:CreateServiceLinkedRole permission.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.