Todos os produtos
Search

Este produto

    Elastic Container Instance:CreateImageCache

    Central de documentação

    Elastic Container Instance:CreateImageCache

    Última atualização: Aug 28, 2026

    Cria um cache de imagem para acelerar o pull de imagens e reduzir o tempo de inicialização na criação subsequente de instâncias do Elastic Container Instance (ECI).

    Descrição da operação

    Precauções

    • A criação de um cache de imagem incorre em taxas de recursos. Informe-se sobre as informações de cobrança antecipadamente. Para mais informações, consulte Cobrança de cache de imagem.

    • Antes de criar um cache de imagem, avalie o tamanho total das imagens a serem armazenadas em cache. Se o tamanho total das imagens exceder o tamanho configurado do cache, a criação falhará.

    • Ao criar um cache de imagem, o sistema cria automaticamente uma instância ECI e um disco em nuvem ESSD PL1 para a criação automática intermediária da imagem. Não exclua a instância ECI ou o disco em nuvem durante o processo de criação. Caso contrário, a criação automática da imagem falhará.

    • A criação de um cache de imagem gera um snapshot correspondente. Não exclua o snapshot. Caso contrário, o cache de imagem se tornará inválido.

    • Se você usar um SDK, a versão necessária é Java 1.0.10 ou posterior, ou Python 1.0.7 ou posterior.

    Recomendações

    • Para imagens do Container Registry Enterprise Edition que usam nomes de domínio personalizados, especifique a instância do Container Registry (definindo os parâmetros AcrRegistryInfo) para configurar o acesso sem senha. Ao definir os parâmetros AcrRegistryInfo, você deve definir AcrRegistryInfo.N.InstanceId.

    • Se o cache de imagem for usado para criar um grande número de instâncias ECI (mais de 1.000) em lotes, defina StandardCopyCount e FlashCopyCount para ativar o recurso de snapshot de múltiplas cópias. Snapshots de múltiplas cópias são cobrados com base em dados incrementais. Como os dados das cópias de snapshot criadas ao mesmo tempo são idênticos, o recurso de snapshot de múltiplas cópias não incorre em taxas adicionais.

    Nota

    Ao chamar CreateImageCache para criar um cache de imagem, o sistema cria automaticamente uma função vinculada ao serviço chamada AliyunServiceRoleForECI para acessar serviços de nuvem relacionados, como ECS e VPC. Para mais informações, consulte Função vinculada ao serviço do Elastic Container Instance.

    Experimente agora

    Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

    Testar

    Autorização RAM

    A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

    • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

    • API: A API que você pode chamar para executar a ação.

    • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

    • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

      • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

      • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

    • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

    • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

    Ação

    Nível de acesso

    Tipo de recurso

    Chave de condição

    Ação dependente

    eci:CreateImageCache

    create

    *ImageCache

    acs:eci:{#regionId}:{#accountId}:imagecache/*
    • eci:tag
    		 Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    RegionId

    string

    Sim

    O ID da região.

    cn-hangzhou
    RegionId

    string

    Sim

    A zona.

    cn-hangzhou-g
    ZoneId

    string

    Não

    O ID do grupo de segurança.

    sg-uf66jeqopgqa9hdn****
    SecurityGroupId

    string

    Não

    O ID do vSwitch. Você pode especificar vários IDs de vSwitch (até 10 por vez), separados por vírgulas (,). Exemplo: vsw-***,vsw-***.

    vsw-uf6h3rbwbm90urjwa****
    VSwitchId

    string

    Não

    O nome do cache de imagem.

    testcache
    ImageCacheName

    string

    Sim

    O Elastic IP Address (EIP). Se você precisar fazer pull de imagens da Internet, certifique-se de que a instância ECI possa acessar a Internet. Você pode configurar um EIP ou um gateway NAT para habilitar o acesso à rede pública.

    eip-2zedsm5mfl3uhdj2d****
    EipInstanceId

    string

    Não

    O ID do grupo de recursos.

    rg-aekzh43v*****
    ResourceGroupId

    string

    Não

    O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja único entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para mais informações, consulte Como garantir a idempotência.

    123e4567-xxx-xxx-xxxx-42665544xxxx
    ClientToken

    string

    Não

    O tamanho do cache de imagem. Valor padrão: 20 GiB.

    20
    ImageCacheSize

    integer

    Não

    O período de retenção do cache de imagem. O cache de imagem é excluído após expirar. Por padrão, o cache de imagem nunca expira.

    Nota

    Caches de imagem cuja criação falhou são retidos por apenas um dia.

    7
    RetentionDays

    integer

    Não

    Especifica se deve ativar a reutilização de cache de imagem. Se esse recurso estiver ativado, um cache de imagem recém-criado pode reutilizar camadas de imagem de caches de imagem existentes, o que acelera a criação do cache de imagem. Valores válidos:

    • true: Ativa a reutilização de cache de imagem.

    • false: Desativa a reutilização de cache de imagem.

    Valor padrão: false.

    true
    AutoMatchImageCache

    boolean

    Não

    As informações do repositório de imagens.

    true
    ImageRegistryCredential

    array<object>

    Não

    As imagens de contêiner usadas para criar o cache de imagem.

    registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl

    object

    Não

    As imagens de contêiner usadas para criar o cache de imagem.

    registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
    Password

    string

    Não

    A senha do repositório de imagens.

    password
    Server

    string

    Não

    O endereço do repositório de imagens. Não inclua o prefixo http:// ou https://.

    registry-vpc.cn-hangzhou.aliyuncs.com
    UserName

    string

    Não

    O nome de usuário do repositório de imagens.

    username
    Image

    array

    Sim

    As informações de tag do cache de imagem. Você pode especificar até 20 tags.

    registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl

    string

    Não

    As informações de tag do cache de imagem. Você pode especificar até 20 tags.

    registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
    Tag

    array<object>

    Não

    Especifica se deve ativar o recurso de cache de imagem instantâneo, que acelera a criação do cache de imagem. Valores válidos:

    • true: Ativa o recurso de cache de imagem instantâneo.

    • false: Desativa o recurso de cache de imagem instantâneo.

    Valor padrão: false.

    true

    object

    Não

    As tags do cache de imagem. Você pode especificar até 20 tags.

    Key

    string

    Não

    A chave da tag do cache de imagem.

    imc
    Value

    string

    Não

    O valor da tag do cache de imagem.

    test
    Flash

    boolean

    Não

    As informações da instância do Container Registry. Para mais informações, consulte Fazer pull de imagens do Container Registry sem usar senha.

    true
    AcrRegistryInfo

    array<object>

    Não

    As anotações. Este parâmetro não está disponível para uso público.

    hide

    object

    Não

    As informações sobre a instância ACR.

    Domain

    array

    Não

    Os nomes de domínio da instância ACR Enterprise. Por padrão, todos os nomes de domínio da instância são especificados. Você pode especificar um ou mais nomes de domínio. Separe vários nomes de domínio com vírgulas (,).

    test****-registry.cn-beijing.cr.aliyuncs.com

    string

    Não

    Os nomes de domínio da instância ACR Enterprise. Por padrão, todos os nomes de domínio da instância são especificados. Você pode especificar um ou mais nomes de domínio. Separe vários nomes de domínio com vírgulas (,).

    test****-registry.cn-beijing.cr.aliyuncs.com
    InstanceName

    string

    Não

    O nome da instância ACR Enterprise.

    test****
    InstanceId

    string

    Não

    O ID da instância ACR Enterprise.

    cri-nwj395hgf6f3****
    RegionId

    string

    Não

    A região onde a instância ACR Enterprise está localizada.

    cn-beijing
    ArnService

    string

    Não

    O Alibaba Cloud Resource Name (ARN) da função RAM que pertence à conta do recurso, como uma instância ECI.

    acs:ram::1609982529******:role/role-assume
    ArnUser

    string

    Não

    O ARN da função RAM que pertence à conta da instância ACR.

    acs:ram::1298452580******:role/role-acr
    Annotations

    string

    Não

    O endereço do repositório de imagens de pull próprio. Ao criar um cache de imagem usando imagens de um repositório de imagens de pull próprio que usa o protocolo HTTP, configure este parâmetro para que o ECI faça pull de imagens via HTTP, evitando falhas no pull de imagens causadas por incompatibilidade de protocolo.

    "harbor***.pre.com,192.168.XX.XX:5000,reg***.test.com:80"
    PlainHttpRegistry

    string

    Não

    O endereço do repositório de imagens autogerenciado.

    Ao criar um cache de imagem usando imagens de um repositório de imagens autogerenciado que usa um certificado autoassinado, configure este parâmetro para ignorar a autenticação de certificado, evitando falhas no pull de imagens causadas por falha na autenticação de certificado.

    "harbor***.pre.com,192.168.XX.XX:5000,reg***.test.com:80"
    InsecureRegistry

    string

    Não

    O número de cópias de snapshot regulares. Por padrão, um cache de imagem corresponde a um snapshot. Se o cache de imagem for usado para criar várias instâncias ECI em lotes, configure este parâmetro para ativar o recurso de snapshot de múltiplas cópias. Recomendamos adicionar uma cópia de snapshot para cada 1.000 instâncias ECI.

    Nota

    Quando o recurso de cache de imagem instantâneo está desativado (Flash definido como false), apenas snapshots regulares são gerados durante a criação do cache de imagem.

    7
    StandardCopyCount

    integer

    Não

    O número de cópias de snapshot locais. Por padrão, um cache de imagem corresponde a um snapshot. Se o cache de imagem for usado para criar várias instâncias ECI em lotes, configure este parâmetro para ativar o recurso de snapshot de múltiplas cópias. Recomendamos adicionar uma cópia de snapshot para cada 1.000 instâncias ECI.

    Nota

    Quando o recurso de cache de imagem instantâneo está ativado (Flash definido como true), snapshots locais são criados primeiro durante a criação do cache de imagem. Após a criação dos snapshots locais, os snapshots regulares começam a ser criados. Depois que os snapshots regulares são criados, os snapshots locais são excluídos automaticamente.

    7
    FlashCopyCount

    integer

    Não

    A estratégia de eliminação do cache de imagem. O valor padrão é vazio, o que indica que o cache de imagem é sempre retido.

    Você pode definir este parâmetro como LRU, o que indica que o cache de imagem pode ser excluído automaticamente. Quando o número de caches de imagem atinge o limite de cota, o sistema exclui automaticamente os caches de imagem menos recentemente usados cujo EliminationStrategy está definido como LRU.

    LRU
    EliminationStrategy

    string

    Não

    O sistema operacional das imagens de contêiner. Valores válidos:

    • Linux (padrão)

    • Windows

    Nota

    O Windows está em pré-visualização por convite. Para usá-lo, abra um ticket.

    Linux
    OsType

    string

    Não

    O sistema operacional da imagem de contêiner. Valores válidos:

    • Linux (padrão)

    • Windows

    Nota

    O Windows está em pré-visualização por convite. Para usar este recurso, envie um ticket.

    Linux

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    RequestId

    string

    O ID da solicitação, que é um identificador único.

    0E234675-3465-4CC3-9D0F-9A864BC391DD
    ImageCacheId

    string

    O ID do cache de imagem.

    imc-2zebxkiifuyzzlhl****
    ContainerGroupId

    string

    O ID da instância ECI usada para a criação intermediária do cache de imagem.

    eci-2zebxkiifuyzzlhl****

    Exemplos

    Resposta de sucesso

    JSON formato

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

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    400 Account.Arrearage Your account has an outstanding payment. A conta possui um pagamento em atraso.
    400 DryRunOperation Request validation has been passed with DryRun flag set. A solicitação de pré-verificação de dry run é válida.
    400 InvalidParameter.CPU.Memory The specified cpu and memory are not allowed
    400 IncorrectStatus %s O status da instância especificado é inválido.
    400 ServiceNotEnabled %s O serviço do qual esta solicitação depende não foi ativado. Ative o serviço e tente novamente.
    400 DiskVolume.NotSupport The disk volume is not supported. Volumes de disco em nuvem não são suportados. Entre em contato conosco se precisar desse recurso.
    400 RamRole.NotSupport The RAM role is not supported. A função de instância RAM não é suportada.
    400 ImageCache.IncorrectStatus %s O cache de imagem não está no estado correto.
    400 ImageCacheNotSupport Image cache is not available for all users. If you want to enable this function, contact us. O recurso de cache de imagem ainda não está disponível em todas as regiões. Entre em contato conosco se precisar desse recurso.
    400 EipAddressPoolIpNotEnough The ip address of specified PublicIpAddressPool is not enough. O pool de endereços públicos EIP especificado não possui recursos de endereço suficientes.
    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. A zona na qual você deseja criar a instância não está mais disponível para compra. Use uma zona diferente, ou o vSwitch da VPC especificada não pode ser utilizado nesta zona.
    403 Forbidden.RiskControl This operation has been identified as an abnormal operation and cannot be processed. Esta operação foi identificada como anormal e não pode ser processada.
    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. A operação é proibida porque a conta possui um pagamento em atraso. Recarregue sua conta e tente novamente.
    403 Forbidden.UserNotRealNameAuthentication This operation is not allowed, because you have not passed the real-name verification. A operação é proibida porque o usuário não concluiu a verificação de nome real.
    403 InvalidUser.PassRoleForbidden The RAM user is not authorized to assume a RAM role. O usuário RAM não tem permissão para usar a função de instância RAM.
    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. Um risco de segurança foi detectado no seu cartão de crédito ou débito padrão. Verifique seu cartão usando o link no e-mail.
    403 CreateServiceLinkedRole.Denied Please make sure the account has ram:CreateServiceLinkedRole permission. Certifique-se de que a conta tenha a permissão ram:CreateServiceLinkedRole.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.