UpdateImageCache - - Centre de documentation Alibaba Cloud

Met à jour un cache d'image.

Description de l'opération

Vous ne pouvez mettre à jour que les caches d'image à l'état Ready ou UpdateFailed.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

eci:UpdateImageCache

update

*ImageCache

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

eci:tag

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région.	cn-hangzhou
RegionId	string	Oui	L'identifiant de la région.	cn-hangzhou
ImageCacheId	string	Oui	L'identifiant du cache d'image.	imc-bp195erqe9o2pb09****
SecurityGroupId	string	Non	L'identifiant du groupe de sécurité.	sg-uf66jeqopgqa9hdn****
VSwitchId	string	Non	L'identifiant du vSwitch.	vsw-uf6h3rbwbm90urjwa****
ImageCacheName	string	Non	Le nom du cache d'image.	testcache
EipInstanceId	string	Non	L'adresse IP élastique (EIP). Pour récupérer des images depuis Internet, assurez-vous que l'instance ECI dispose d'un accès à Internet. Configurez une adresse IP élastique ou une passerelle NAT pour activer l'accès à Internet.	eip-2zedsm5mfl3uhdj2d****
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	rg-aekzh43v*****
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Générez une valeur unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII et sa longueur ne doit pas dépasser 64 caractères. Pour plus d'informations, consultez Comment garantir l'idempotence.	123e4567-xxx-xxx-xxxx-42665544xxxx
ImageCacheSize	integer	Non	La taille du cache d'image. La valeur par défaut est de 20 Gio.	20
RetentionDays	integer	Non	La période de rétention du cache d'image en jours. Le cache d'image expire et est supprimé à la fin de la période de rétention. Par défaut, le cache d'image n'expire jamais. Remarque Les caches d'image dont la création a échoué ne sont conservés que pendant une journée.	7
AutoMatchImageCache	boolean	Non	Indique si la réutilisation des couches de cache d'image doit être activée. Si vous activez cette fonctionnalité, le système réutilise les couches d'image des caches d'image existants pour accélérer la création des caches d'image. Valeurs valides : true false Valeur par défaut : false.	true
ImageRegistryCredential	array<object>	Non	Les informations d'identification du registre d'images.
	object	Non	Les informations d'identification du registre d'images.
Password	string	Non	Le mot de passe du registre d'images.	password
Server	string	Non	L'adresse du registre d'images. N'incluez pas le préfixe `http://` ou `https://`.	registry-vpc.cn-hangzhou.aliyuncs.com
UserName	string	Non	Le nom d'utilisateur du registre d'images.	username
Image	array	Non	La liste des images de conteneur utilisées pour créer le cache d'image. Remarque Si vous souhaitez déclencher une mise à niveau sur place du cache d'image sans mettre à jour la liste des images, vous devez tout de même transmettre la liste des images. Sinon, les données d'image ne sont pas mises à jour vers la dernière version. Seules les métadonnées sont actualisées.	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
	string	Non	L'image de conteneur utilisée pour créer le cache d'image.	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
Tag	array<object>	Non	Les balises à attacher au cache d'image. Vous pouvez attacher jusqu'à 20 balises.
	object	Non	Les balises à attacher au cache d'image. Vous pouvez attacher jusqu'à 20 balises.
Key	string	Non	La clé de la balise.	imc
Value	string	Non	La valeur de la balise.	test
Flash	boolean	Non	Indique si la fonctionnalité de cache d'image instantané doit être activée. Cette fonctionnalité accélère la création des caches d'image. Valeurs valides : true false Valeur par défaut : false.	true
AcrRegistryInfo	array<object>	Non	Les informations relatives à l'instance Container Registry (ACR) Enterprise Edition.
	object	Non	Les informations relatives à l'instance ACR Enterprise Edition.
Domain	array	Non	Les noms de domaine de l'instance ACR Enterprise Edition. Par défaut, tous les noms de domaine de l'instance sont utilisés. Vous pouvez spécifier un ou plusieurs noms de domaine. Séparez les noms de domaine multiples par des virgules (,).	test****-registry.cn-hangzhou.cr.aliyuncs.com
	string	Non	Les noms de domaine de l'instance ACR Enterprise Edition. Par défaut, tous les noms de domaine de l'instance sont utilisés. Vous pouvez spécifier un ou plusieurs noms de domaine. Séparez les noms de domaine multiples par des virgules (,).	test****-registry.cn-hangzhou.cr.aliyuncs.com
InstanceName	string	Non	Le nom de l'instance ACR Enterprise Edition.	test****
InstanceId	string	Non	L'identifiant de l'instance ACR Enterprise Edition.	cri-nwj395hgf6f3****
RegionId	string	Non	La région où se trouve l'instance ACR Enterprise Edition.	cn-hangzhou
StandardCopyCount	integer	Non	Le nombre de réplicas d'instantanés standard. Par défaut, un instantané est créé pour un cache d'image. Si le cache d'image est utilisé pour créer plusieurs instances ECI par lots, configurez ce paramètre pour créer plusieurs réplicas d'instantanés. Nous recommandons de créer un réplica d'instantané pour 1 000 instances ECI. Remarque Si la fonctionnalité de cache d'image instantané est désactivée (Flash défini sur false), seuls des instantanés standard sont créés lors de la création du cache d'image.	7
FlashCopyCount	integer	Non	Le nombre de réplicas d'instantanés locaux. Par défaut, un instantané est créé pour un cache d'image. Si le cache d'image est utilisé pour créer plusieurs instances ECI par lots, configurez ce paramètre pour créer plusieurs réplicas d'instantanés. Nous recommandons de créer un réplica d'instantané pour 1 000 instances ECI. Remarque Si la fonctionnalité de cache d'image instantané est activée (Flash défini sur true), le système crée d'abord des instantanés locaux. Une fois les instantanés locaux créés, le système commence à créer des instantanés standard. Après la création des instantanés standard, les instantanés locaux sont automatiquement supprimés.	7
EliminationStrategy	string	Non	La stratégie d'éviction pour le cache d'image. Par défaut, le cache d'image n'est jamais évincé. Définissez ce paramètre sur `LRU` pour autoriser la suppression automatique. Si vous définissez la stratégie sur `LRU`, lorsque le nombre de caches d'image atteint le quota, le système supprime automatiquement les caches les moins récemment utilisés.	LRU

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	0E234675-3465-4CC3-9D0F-9A864BC391DD

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	Account.Arrearage	Your account has an outstanding payment.	Your account has an outstanding payment.
400	DryRunOperation	Request validation has been passed with DryRun flag set.	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	The service on which this request depends has not been activated. Please activate and try again.
400	DiskVolume.NotSupport	The disk volume is not supported.	Disk volume does not support your structure. If you want to enable this function, contact us.
400	RamRole.NotSupport	The RAM role is not supported.	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.	Container image cache is currently not available to all users. Submit a ticket if you need to use the feature.
400	OperationConflict	Request was denied due to conflict with a previous request.	Request was denied due to conflict with a previous request.
400	NoNeedUpdate	There are no changes to be updated for current resource.	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.	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.	Please make sure the account has ram:CreateServiceLinkedRole permission.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.