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

Consulta los detalles de uno o más cachés de imagen.

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

get

ImageCache

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

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	No	El ID del caché de imagen.	imc-bp195erqe9o2pb09****
ImageCacheName	string	No	El nombre del caché de imagen.	testcache
SnapshotId	string	No	El ID de la instantánea que corresponde al caché de imagen.	s-2zec5oj8e1yhxijt****
Image	string	No	La imagen de contenedor.	nginx
ResourceGroupId	string	No	El ID del grupo de recursos al que pertenece el caché de imagen.	rg-2df3isufhi38****
Tag	array<object>	No	Las etiquetas asociadas al caché de imagen.
	object	No	Las etiquetas asociadas al caché de imagen. Puede especificar hasta 20 etiquetas.
Key	string	No	La clave de la etiqueta.	imc
Value	string	No	El valor de la etiqueta.	test
MatchImage	array	No	Las imágenes de contenedor que se utilizan para consultar los cachés de imagen coincidentes. Puede especificar hasta 100 imágenes.	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
	string	No	Las imágenes de contenedor que se utilizan para consultar los cachés de imagen coincidentes. Puede especificar hasta 100 imágenes.	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
Limit	integer	No	El número máximo de entradas a devolver.	20
NextToken	string	No	El token que se utiliza para la siguiente consulta. Puede obtener el token del parámetro `NextToken` en la respuesta de la llamada a la API anterior.	AAAAAdDWBF2****
ImageFullMatch	boolean	No	Especifica si se debe realizar una coincidencia exacta para las imágenes de contenedor. Este parámetro se utiliza para filtrar aún más los resultados de la consulta cuando se especifica `MatchImage`.	true
ImageMatchCountRequest	integer	No	El número de cachés de imagen que coinciden exactamente con las imágenes de contenedor. Este parámetro se utiliza para filtrar aún más los resultados de la consulta cuando se especifica `MatchImage`.	3

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	39FC2E43-3DD7-4CEF-9EF4-E4AD6E635301
ImageCaches	array<object>	La lista de cachés de imagen.
	array<object>	La lista de cachés de imagen.
Images	array	La lista de imágenes en el caché de imagen.
	string	La lista de imágenes en el caché de imagen.	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
CreationTime	string	La hora en que se creó el caché de imagen.	2021-02-09T02:24:07Z
Status	string	El estado del caché de imagen. Valores válidos: Preparing: El caché de imagen se está preparando. Creating: El caché de imagen se está creando. Ready: El caché de imagen está creado. Failed: No se pudo crear el caché de imagen. Updating: El caché de imagen se está actualizando. UpdateFailed: No se pudo actualizar el caché de imagen. El caché de imagen solo se puede utilizar cuando se encuentra en el estado Ready.	Ready
Progress	string	El progreso de creación de la instantánea para el caché de imagen. Nota Si la función de caché de imagen instantánea está habilitada, se crea una instantánea local temporal antes de crear una instantánea estándar. Este parámetro indica el progreso de creación de la instantánea estándar.	100%
ExpireDateTime	string	La hora de vencimiento.	2019-11-10T09:00:48Z
LastMatchedTime	string	La última vez que se encontró una coincidencia con el caché de imagen.	2021-08-18T03:48:10Z
ContainerGroupId	string	El ID del grupo de contenedores.	eci-bp18oq3m15prd9jb****
Tags	array<object>	La lista de etiquetas del caché de imagen.
	object	La lista de etiquetas del caché de imagen.
Key	string	La clave de la etiqueta.	imc
Value	string	El valor de la etiqueta.	test
Events	array<object>	Los eventos que se generan cuando se extrae la imagen para el caché de imagen.
	object	Los eventos que se generan cuando se extrae la imagen para el caché de imagen.
Type	string	El tipo de evento.	Normal
LastTimestamp	string	La hora en que finalizó el evento.	2021-02-09T02:24:48Z
Message	string	El mensaje del evento.	Successfully check image cache resource
Name	string	El nombre del evento.	imagetest.1661f31f851a****
Count	integer	El número de eventos.	1
FirstTimestamp	string	La hora en que comenzó el evento.	2021-02-09T02:24:48Z
Reason	string	El motivo del evento.	Started
ImageCacheId	string	El ID del caché de imagen.	imc-bp195erqe9o2pb09****
RegionId	string	El ID de la región.	cn-beijing
SnapshotId	string	El ID de la instantánea que corresponde al caché de imagen.	s-2zec5oj8e1yhxijt****
FlashSnapshotId	string	El ID de la instantánea local. Si la función de caché de imagen instantánea está habilitada, se crea una instantánea local temporal.	s-bp12w3v37sit96t6****
ResourceGroupId	string	El ID del grupo de recursos.	rg-2df3isufhi38****
ImageCacheSize	integer	El tamaño del caché de imagen. Unidad: GiB.	20
ImageCacheName	string	El nombre del caché de imagen.	imagetest
EliminationStrategy	string	La política para conservar el caché de imagen. Si deja este parámetro vacío, el caché de imagen se conserva siempre. Puede establecer este parámetro en LRU. Este valor indica que el caché de imagen se puede eliminar automáticamente. Cuando el número de cachés de imagen alcanza el límite de cuota, el sistema elimina automáticamente los cachés de imagen utilizados menos recientemente para los cuales `EliminationStrategy` está establecido en `LRU`.	LRU
NextToken	string	El token de paginación devuelto.	AAAAAdDWBF2****
TotalCount	integer	El número total de entradas devueltas.	15

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "39FC2E43-3DD7-4CEF-9EF4-E4AD6E635301",
  "ImageCaches": [
    {
      "Images": [
        "registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl"
      ],
      "CreationTime": "2021-02-09T02:24:07Z",
      "Status": "Ready",
      "Progress": "100%",
      "ExpireDateTime": "2019-11-10T09:00:48Z",
      "LastMatchedTime": "2021-08-18T03:48:10Z",
      "ContainerGroupId": "eci-bp18oq3m15prd9jb****",
      "Tags": [
        {
          "Key": "imc",
          "Value": "test"
        }
      ],
      "Events": [
        {
          "Type": "Normal",
          "LastTimestamp": "2021-02-09T02:24:48Z",
          "Message": "Successfully check image cache resource.",
          "Name": "imagetest.1661f31f851a****",
          "Count": 1,
          "FirstTimestamp": "2021-02-09T02:24:48Z",
          "Reason": "Started"
        }
      ],
      "ImageCacheId": "imc-bp195erqe9o2pb09****",
      "RegionId": "cn-beijing",
      "SnapshotId": "s-2zec5oj8e1yhxijt****",
      "FlashSnapshotId": "s-bp12w3v37sit96t6****",
      "ResourceGroupId": "rg-2df3isufhi38****",
      "ImageCacheSize": 20,
      "ImageCacheName": "imagetest",
      "EliminationStrategy": "LRU"
    }
  ],
  "NextToken": "AAAAAdDWBF2****",
  "TotalCount": 15
}

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	ServiceNotEnabled	%s
403	Forbidden.SubUser	The specified action is not available for you.
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	NoPermission	The RAM role does not belong to ECS.

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.