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

Actualiza una caché de imágenes.

Descripción de la operación

Solo puede actualizar las cachés de imágenes que se encuentran en estado Ready o UpdateFailed.

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:UpdateImageCache

update

*ImageCache

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

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í	El ID de la región.	cn-hangzhou
ImageCacheId	string	Sí	El ID de la caché de imágenes.	imc-bp195erqe9o2pb09****
SecurityGroupId	string	No	El ID del security group.	sg-uf66jeqopgqa9hdn****
VSwitchId	string	No	El ID del vSwitch.	vsw-uf6h3rbwbm90urjwa****
ImageCacheName	string	No	El nombre de la caché de imágenes.	testcache
EipInstanceId	string	No	La dirección elastic IP (EIP). Para descargar imágenes desde Internet, asegúrese de que la instancia ECI tenga acceso a Internet. Configure una EIP o un NAT Gateway para habilitar el acceso a Internet.	eip-2zedsm5mfl3uhdj2d****
ResourceGroupId	string	No	El ID del grupo de recursos.	rg-aekzh43v*****
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Genere un valor que sea único entre diferentes solicitudes. El token solo puede contener caracteres ASCII y no debe exceder los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia.	123e4567-xxx-xxx-xxxx-42665544xxxx
ImageCacheSize	integer	No	El tamaño de la caché de imágenes. El valor predeterminado es 20 GiB.	20
RetentionDays	integer	No	El período de retención de la caché de imágenes en días. La caché de imágenes caduca y se elimina una vez finalizado el período de retención. De forma predeterminada, la caché de imágenes nunca caduca. Nota Las cachés de imágenes cuya creación falló se conservan solo durante un día.	7
AutoMatchImageCache	boolean	No	Especifica si se debe habilitar la reutilización de capas de caché de imágenes. Si habilita esta función, el sistema reutiliza las capas de imagen de las cachés de imágenes existentes para acelerar la creación de cachés de imágenes. Valores válidos: true false Valor predeterminado: false.	true
ImageRegistryCredential	array<object>	No	Las credenciales del repositorio de imágenes.
	object	No	Las credenciales del repositorio de imágenes.
Password	string	No	La contraseña del repositorio de imágenes.	password
Server	string	No	La dirección del repositorio de imágenes. No incluya el prefijo `http://` ni `https://`.	registry-vpc.cn-hangzhou.aliyuncs.com
UserName	string	No	El nombre de usuario del repositorio de imágenes.	username
Image	array	No	La lista de imágenes de contenedor utilizadas para crear la caché de imágenes. Nota Si desea activar una actualización in situ de la caché de imágenes sin actualizar la lista de imágenes, debe pasar la lista de imágenes de todos modos. De lo contrario, los datos de la imagen no se actualizan a la versión más reciente. Solo se actualizan los metadatos.	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
	string	No	La imagen de contenedor utilizada para crear la caché de imágenes.	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
Tag	array<object>	No	Las etiquetas que se adjuntarán a la caché de imágenes. Puede adjuntar hasta 20 etiquetas.
	object	No	Las etiquetas que se adjuntarán a la caché de imágenes. Puede adjuntar hasta 20 etiquetas.
Key	string	No	La clave de la etiqueta.	imc
Value	string	No	El valor de la etiqueta.	test
Flash	boolean	No	Especifica si se debe habilitar la función de caché de imágenes instantánea. Esta función acelera la creación de cachés de imágenes. Valores válidos: true false Valor predeterminado: false.	true
AcrRegistryInfo	array<object>	No	La información sobre la instancia de Container Registry (ACR) Enterprise Edition.
	object	No	La información sobre la instancia de ACR Enterprise Edition.
Domain	array	No	Los nombres de dominio de la instancia de ACR Enterprise Edition. De forma predeterminada, se utilizan todos los nombres de dominio de la instancia. Puede especificar uno o más nombres de dominio. Separe varios nombres de dominio con comas (,).	test****-registry.cn-hangzhou.cr.aliyuncs.com
	string	No	Los nombres de dominio de la instancia de ACR Enterprise Edition. De forma predeterminada, se utilizan todos los nombres de dominio de la instancia. Puede especificar uno o más nombres de dominio. Separe varios nombres de dominio con comas (,).	test****-registry.cn-hangzhou.cr.aliyuncs.com
InstanceName	string	No	El nombre de la instancia de ACR Enterprise Edition.	test****
InstanceId	string	No	El ID de la instancia de ACR Enterprise Edition.	cri-nwj395hgf6f3****
RegionId	string	No	La región donde se encuentra la instancia de ACR Enterprise Edition.	cn-hangzhou
StandardCopyCount	integer	No	El número de réplicas de instantáneas estándar. De forma predeterminada, se crea una instantánea por cada caché de imágenes. Si la caché de imágenes se utiliza para crear varias instancias ECI en lotes, configure este parámetro para crear múltiples réplicas de instantáneas. Se recomienda crear una réplica de instantánea por cada 1,000 instancias ECI. Nota Si la función de caché de imágenes instantánea está deshabilitada (Flash establecido en false), solo se crean instantáneas estándar durante la creación de la caché de imágenes.	7
FlashCopyCount	integer	No	El número de réplicas de instantáneas locales. De forma predeterminada, se crea una instantánea por cada caché de imágenes. Si la caché de imágenes se utiliza para crear varias instancias ECI en lotes, configure este parámetro para crear múltiples réplicas de instantáneas. Se recomienda crear una réplica de instantánea por cada 1,000 instancias ECI. Nota Si la función de caché de imágenes instantánea está habilitada (Flash establecido en true), el sistema primero crea instantáneas locales. Una vez creadas las instantáneas locales, el sistema comienza a crear instantáneas estándar. Después de crear las instantáneas estándar, las instantáneas locales se eliminan automáticamente.	7
EliminationStrategy	string	No	La política de expulsión para la caché de imágenes. De forma predeterminada, la caché de imágenes nunca se expulsa. Establezca este parámetro en `LRU` para permitir la eliminación automática. Si establece la política en `LRU`, cuando el número de cachés de imágenes alcanza la cuota, el sistema elimina automáticamente las cachés utilizadas menos recientemente.	LRU

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	0E234675-3465-4CC3-9D0F-9A864BC391DD

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "0E234675-3465-4CC3-9D0F-9A864BC391DD"
}

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	OperationConflict	Request was denied due to conflict with a previous request.
400	NoNeedUpdate	There are no changes to be updated for current resource.
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.