Todos os produtos
Search
Central de documentação

Elastic Compute Service:DescribeImagePipelines

Última atualização: Oct 27, 2026

Consulta os detalhes de um ou mais modelos de imagem.

Descrição da operação

Você pode definir o token de consulta NextToken como o valor NextToken retornado da chamada anterior do DescribeImagePipelines e usar MaxResults para especificar o número máximo de entradas por página para a consulta.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

O ID da região. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.

cn-hangzhou

ResourceGroupId

string

Não

O ID do grupo de recursos. Ao usar este parâmetro para filtrar recursos, a contagem de recursos não pode exceder 1.000.

Nota

A filtragem pelo grupo de recursos padrão não é suportada.

rg-bp67acfmxazb4p****

Tag

array<object>

Não

As tags.

object

Não

As tags.

Key

string

Não

A chave da tag. Valores válidos de N: 1 a 20.

TestKey

Value

string

Não

O valor da tag. Valores válidos de N: 1 a 20.

TestValue

Name

string

Não

O nome do modelo.

testImagePipeline

NextToken

string

Não

O token de consulta. Defina o valor como o valor NextToken retornado da chamada de API anterior. Você não precisa especificar este parâmetro na primeira chamada.

AAAAAdDWBF2****

MaxResults

integer

Não

O número máximo de entradas por página para paginação. Valores válidos: 1 a 500.

Valor padrão: 50.

50

ImagePipelineId

array

Não

O ID do modelo de imagem. Valores válidos de N: 1 a 20.

ip-2ze5tsl5bp6nf2b3****

string

Não

O ID do modelo de imagem. Valores válidos de N: 1 a 20.

ip-2ze5tsl5bp6nf2b3****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

ImagePipeline

object

ImagePipelineSet

array<object>

A lista de modelos de imagem.

array<object>

AddAccounts

object

AddAccount

array

O ID da conta Alibaba Cloud para compartilhamento da imagem de destino.

string

O ID da conta Alibaba Cloud para compartilhamento da imagem de destino.

["1234567890"]

AdvancedOptions

object

As configurações avançadas.

ImageNameSuffix

string

Especifica se deve ser desativada a adição automática de um sufixo ao nome da imagem de destino. Valores válidos:

  • disable: Desativado.

disable

RetainCloudAssistant

boolean

Especifica se o Cloud Assistant deve ser retido. Durante o processo de compilação, o sistema instala automaticamente o Cloud Assistant na instância intermediária para executar comandos. Você pode escolher se deseja retê-lo na imagem de destino compilada. Valores válidos:

  • true: Retido.

  • false: Não retido.

Nota

Esta configuração não afeta o Cloud Assistant que está pré-instalado na sua imagem.

true

BaseImage

string

A imagem de origem.

  • Se BaseImageType estiver definido como IMAGE, o valor deste parâmetro será o ID da imagem personalizada.

  • Se BaseImageType estiver definido como IMAGE_FAMILY, o valor deste parâmetro será o nome da família de imagens.

m-bp67acfmxazb4p****

BaseImageType

string

O tipo da imagem de origem. Valores válidos:

  • IMAGE: imagem personalizada.

  • IMAGE_FAMILY: família de imagens.

IMAGE

BuildContent

string

O conteúdo do modelo de imagem.

COMPONENT ic-bp12dvdzvr9k9***** COMPONENT acs:ecs:cn-hangzhou:18689161186*****:imagecomponent/ComponentName/1.*.*

CreationTime

string

A hora em que o modelo foi criado. A hora segue o padrão ISO 8601 e é exibida em UTC.

2020-11-24T06:00:00Z

DeleteInstanceOnFailure

boolean

Especifica se a instância intermediária deve ser liberada se a compilação da imagem falhar.

true

Description

string

A descrição.

This is description.

ImageFamily deprecated

string

A família de imagens da imagem de destino.

Importante [Deprecated] Use ImageOptions.ImageFamily.

family

ImageName deprecated

string

O prefixo do nome da imagem de destino.

Importante [Deprecated] Use ImageOptions.ImageName.

testImageName

ImageOptions

object

As propriedades da imagem de destino.

Description

string

A descrição da imagem de destino.

description.

ImageFamily

string

A família de imagens da imagem de destino.

family

ImageFeatures

object

As propriedades relacionadas a recursos da imagem de destino.

NvmeSupport

string

Especifica se a imagem de destino compilada oferece suporte a NVMe. Valores válidos:

  • supported: Com suporte. As instâncias criadas a partir desta imagem oferecem suporte ao protocolo NVMe.

  • unsupported: Sem suporte. As instâncias criadas a partir desta imagem não oferecem suporte ao protocolo NVMe.

  • auto: Detecção automática. O sistema detecta automaticamente se o driver NVMe está instalado na sua imagem antes da fase de compilação. Se você instalar ou desinstalar o driver NVMe durante a compilação, o resultado da detecção pode ser impreciso. Recomendamos que você defina este parâmetro como supported ou unsupported com base no conteúdo da compilação.

auto

ImageName

string

O prefixo do nome da imagem de destino.

imageName

ImageTags

object

ImageTag

array<object>

As tags da imagem de destino.

object

TagKey

string

A chave da tag.

testKey

TagValue

string

O valor da tag.

testValue

ImagePipelineId

string

O ID do modelo de imagem.

ip-2ze5tsl5bp6nf2b3****

ImageSecurityOptions

object

As propriedades e configurações relacionadas à segurança da imagem.

SecurityScanMode

string

O modo de verificação de segurança. Valores válidos:

  • agentless: Usa o modo de verificação sem agente do Security Center.

agentless

ImportImageOptions

object

As propriedades e configurações da imagem importada.

Architecture

string

A arquitetura do sistema. Valores válidos:

  • x86_64

  • arm64

x86_64

BootMode

string

O modo de inicialização da imagem importada. Valores válidos:

  • BIOS: modo de inicialização BIOS.

  • UEFI: modo de inicialização UEFI.

BIOS

Description

string

A descrição da imagem importada.

created by acc

DiskDeviceMappings

object

DiskDeviceMapping

array<object>

A lista de informações da imagem personalizada.

  • Se N estiver definido como 1, o disco é um disco de sistema.

  • Se N variar de 2 a 17, o disco é um disco de dados.

object

DiskImageSize

integer

O tamanho da imagem personalizada após a importação da imagem.

O espaço consiste no disco de sistema e nos discos de dados. Você deve garantir que o tamanho do disco de sistema seja maior ou igual ao tamanho do arquivo de imagem importado. Valores válidos:

  • Se N estiver definido como 1, o disco é um disco de sistema. Valores válidos: 1 a 2048. Unidade: GiB.

  • Se N variar de 2 a 17, o disco é um disco de dados. Valores válidos: 1 a 2048. Unidade: GiB.

Depois de fazer upload do arquivo de imagem de origem para o OSS, você pode visualizar o tamanho do arquivo de imagem no bucket do OSS.

40

Format

string

O formato da imagem. Valores válidos:

  • RAW

  • VHD

  • QCOW2

RAW

OSSBucket

string

O bucket do OSS onde o arquivo de imagem está armazenado.

ecsimageos

OSSObject

string

O nome (chave) do arquivo de imagem salvo no bucket do OSS após o upload da imagem.

CentOS_5.4_32.raw

Features

object

As propriedades relacionadas a recursos da imagem.

ImdsSupport

string

O modo de acesso aos metadados da imagem. Valores válidos:

  • v1: Ao criar uma instância ECS a partir desta imagem, você não pode definir o modo de acesso aos metadados como enforced.

  • v2: Ao criar uma instância ECS a partir desta imagem, você pode definir o modo de acesso aos metadados como enforced.

Valor padrão: v1.

v2

NvmeSupport

string

Especifica se a imagem importada oferece suporte a NVMe. Valores válidos:

  • supported: Com suporte. As instâncias criadas a partir desta imagem oferecem suporte ao protocolo NVMe.

  • unsupported: Sem suporte. As instâncias criadas a partir desta imagem não oferecem suporte ao protocolo NVMe.

supported

ImageName

string

O nome da imagem importada.

fvt-ecs-imported-image-1812b2d7

ImportImageTags

object

ImportImageTag

array<object>

A lista de tags usadas quando a imagem é importada.

object

O par chave-valor da tag da imagem importada.

Key

string

A chave da tag da imagem.

testKey

Value

string

O valor da tag da imagem.

testValue

LicenseType

string

O tipo de licença usado para ativar o sistema operacional após a importação da imagem. Valores válidos:

  • Auto: O Alibaba Cloud detecta o sistema operacional de origem e atribui uma licença. No modo automático, o sistema verifica primeiro se o sistema operacional especificado por Platform possui uma licença dos canais oficiais do Alibaba Cloud e a atribui à imagem importada. Se nenhuma licença desse tipo estiver disponível, o sistema alternará para o modo Bring Your Own License (BYOL).

  • Aliyun: Usa uma licença dos canais oficiais do Alibaba Cloud com base no sistema operacional especificado por Platform.

  • BYOL: Usa a licença fornecida pelo sistema operacional de origem. Se você usar BYOL, deverá garantir que sua chave de licença seja suportada no Alibaba Cloud.

Auto

OSType

string

O tipo de sistema operacional. Valores válidos:

  • windows

  • linux

linux

Platform

string

A versão do sistema operacional. Valores válidos:

  • Aliyun

  • Anolis

  • CentOS

  • Ubuntu

  • CoreOS

  • SUSE

  • Debian

  • OpenSUSE

  • FreeBSD

  • RedHat

  • Kylin

  • UOS

  • Fedora

  • Fedora CoreOS

  • CentOS Stream

  • AlmaLinux

  • Rocky Linux

  • Gentoo

  • Customized Linux

  • Others Linux

  • Windows Server 2022

  • Windows Server 2019

  • Windows Server 2016

  • Windows Server 2012

  • Windows Server 2008

  • Windows Server 2003

  • Other Windows

Aliyun

RetainImportedImage

boolean

Importante **[Deprecated]** Use ImportImageOptions.RetentionStrategy.

false

RetentionStrategy

string

A política de retenção de dados para a imagem importada. Valores válidos:

  • RetainOnlySuccessful: Retém a imagem apenas se a compilação for bem-sucedida.

  • RetainOnlyFailed: Retém a imagem apenas se a compilação falhar.

  • RetainAlways: Sempre retém a imagem, independentemente do resultado da compilação.

  • RetainNever: Nunca retém a imagem, independentemente do resultado da compilação.

Valor padrão: RetainNever.

RetainAlways

RoleName

string

O nome da função RAM usada quando a imagem é importada.

AliyunECSImageImportDefaultRole

InstanceType

string

O tipo de instância.

ecs.g6.large

InternetMaxBandwidthOut

integer

A largura de banda pública de saída da instância intermediária. Unidade: Mbit/s.

0

Name

string

O nome do modelo.

testImagePipeline

NvmeSupport deprecated

string

Especifica se a imagem de destino compilada oferece suporte a NVMe.

Importante [Deprecated] Use ImageOptions.ImageFeatures.NvmeSupport.

auto

RepairItems

object

RepairItem

array

Os itens de reparo da imagem.

  • Itens de reparo suportados pelo Linux:
    • fstab: Corrige problemas de configuração de anexação de disco.

    • grub: Corrige problemas de configuração de inicialização do GRUB.

    • dhcp: Corrige problemas de DHCP de rede.

    • selinux: Corrige problemas do Security-Enhanced Linux (SELinux).

    • growpart: Corrige problemas de expansão automática online da partição raiz.

    • cloudinit: Instala o serviço de inicialização cloud-init.

    • aegis: Instala o agente do Security Center.

    • nvme: Corrige problemas do driver NVMe.

    • virtio: Corrige problemas do driver virtio.

    • standardizedtimezone: Corrige problemas de fuso horário padrão.

  • Itens de reparo suportados pelo Windows:
    • bcd: Corrige problemas no arquivo de dados de configuração de inicialização.

    • hotfix: Corrige problemas de patch do Windows.

    • disk: Corrige problemas de configurações de disco.

    • update: Corrige problemas no processo do Windows Update.

    • server: Corrige problemas de configuração de serviço.

    • bootmgr: Corrige problemas do Windows Boot Manager.

    • vminit: Corrige problemas do agente de inicialização do Windows.

    • osloader: Corrige problemas do Windows OS Loader.

    • virtio: Corrige problemas do driver virtio.

    • standardizedtimezone: Corrige problemas de fuso horário padrão.

string

O item de reparo da imagem.

fstab

RepairMode

string

A opção de reparo no modelo de imagem.

Valores válidos:

  • Standard: Modo de reparo padrão.

    O pacote de reparo padrão para Linux inclui:

    • GUESTOS.CloudInit

    • GUESTOS.Dhcp

    • GUESTOS.Virtio

    • GUESTOS.OnlineResizeFS

    • GUESTOS.Grub

    • GUESTOS.Fstab

    • GUESTOS.Nvme

    O pacote de reparo padrão para Windows inclui:

    • GUESTOS.Virtio

    • GUESTOS.Update

    • GUESTOS.Hotfix

    • GUESTOS.Server

    • GUESTOS.Bcd

    • GUESTOS.Disk

    • GUESTOS.Bootmgr

    • GUESTOS.OSLoader

    • GUESTOS.Vminit

  • All: Modo de reparo completo.

    O pacote de reparo completo para Linux inclui os seguintes itens, além daqueles no pacote de reparo padrão:

    • GUESTOS.Selinux

    • GUESTOS.SecurityCenterAgent

    O pacote de reparo completo para Windows inclui os seguintes itens, além daqueles no pacote de reparo padrão:

    • GUESTOS.Server

  • Customized: Modo de reparo personalizado. Neste modo, os itens de reparo no pacote de reparo são especificados pelo parâmetro RepairItem.

Nota

À medida que os recursos de detecção e reparo continuam a melhorar, os itens de reparo incluídos podem aumentar. Para obter mais informações sobre os significados específicos dos itens de reparo, consulte Visão geral da inspeção de imagem.

Standard

ResourceGroupId

string

O ID do grupo de recursos.

rg-bp67acfmxazb4p****

SystemDiskSize

integer

O tamanho do disco de sistema da instância intermediária. Unidade: GiB.

40

Tags

object

Tag

array<object>

A lista de pares chave-valor de tag.

object

TagKey

string

A chave da tag.

TestKey

TagValue

string

O valor da tag.

TestValue

TestContent

string

O conteúdo do modelo de teste de imagem.

COMPONENT ic-bp12dvdzvr9k9***** COMPONENT acs:ecs:cn-hangzhou:18689161186*****:imagecomponent/ComponentName/1.*.*

ToRegionIds

object

ToRegionId

array

A lista de regiões para as quais a imagem de destino será distribuída.

string

A lista de regiões para as quais a imagem de destino será distribuída.

["cn-hangzhou"]

VSwitchId

string

O ID do vSwitch na VPC.

vsw-bp67acfmxazb4p****

MaxResults

integer

O número de entradas por página em uma consulta paginada.

50

NextToken

string

O token de consulta retornado por esta chamada. Para obter mais informações sobre como usar o token, consulte a descrição da operação.

AAAAAdDWBF2****

RequestId

string

O ID da solicitação.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

TotalCount

integer

O número total de modelos de imagem retornados.

1

Exemplos

Resposta de sucesso

JSON formato

{
  "ImagePipeline": {
    "ImagePipelineSet": [
      {
        "AddAccounts": {
          "AddAccount": [
            "[\"1234567890\"]"
          ]
        },
        "AdvancedOptions": {
          "ImageNameSuffix": "disable",
          "RetainCloudAssistant": true
        },
        "BaseImage": "m-bp67acfmxazb4p****",
        "BaseImageType": "IMAGE",
        "BuildContent": "COMPONENT ic-bp12dvdzvr9k9*****\nCOMPONENT acs:ecs:cn-hangzhou:18689161186*****:imagecomponent/ComponentName/1.*.*",
        "CreationTime": "2020-11-24T06:00:00Z",
        "DeleteInstanceOnFailure": true,
        "Description": "This is description.",
        "ImageFamily": "family",
        "ImageName": "testImageName",
        "ImageOptions": {
          "Description": "description.",
          "ImageFamily": "family",
          "ImageFeatures": {
            "NvmeSupport": "auto"
          },
          "ImageName": "imageName",
          "ImageTags": {
            "ImageTag": [
              {
                "TagKey": "testKey",
                "TagValue": "testValue"
              }
            ]
          }
        },
        "ImagePipelineId": "ip-2ze5tsl5bp6nf2b3****",
        "ImageSecurityOptions": {
          "SecurityScanMode": "agentless"
        },
        "ImportImageOptions": {
          "Architecture": "x86_64",
          "BootMode": "BIOS",
          "Description": "created by acc",
          "DiskDeviceMappings": {
            "DiskDeviceMapping": [
              {
                "DiskImageSize": 40,
                "Format": "RAW",
                "OSSBucket": "ecsimageos",
                "OSSObject": "CentOS_5.4_32.raw"
              }
            ]
          },
          "Features": {
            "ImdsSupport": "v2",
            "NvmeSupport": "supported"
          },
          "ImageName": "fvt-ecs-imported-image-1812b2d7",
          "ImportImageTags": {
            "ImportImageTag": [
              {
                "Key": "testKey",
                "Value": "testValue"
              }
            ]
          },
          "LicenseType": "Auto",
          "OSType": "linux",
          "Platform": "Aliyun",
          "RetainImportedImage": false,
          "RetentionStrategy": "RetainAlways",
          "RoleName": "AliyunECSImageImportDefaultRole"
        },
        "InstanceType": "ecs.g6.large",
        "InternetMaxBandwidthOut": 0,
        "Name": "testImagePipeline",
        "NvmeSupport": "auto",
        "RepairItems": {
          "RepairItem": [
            "fstab"
          ]
        },
        "RepairMode": "Standard",
        "ResourceGroupId": "rg-bp67acfmxazb4p****",
        "SystemDiskSize": 40,
        "Tags": {
          "Tag": [
            {
              "TagKey": "TestKey",
              "TagValue": "TestValue"
            }
          ]
        },
        "TestContent": "COMPONENT ic-bp12dvdzvr9k9*****\nCOMPONENT acs:ecs:cn-hangzhou:18689161186*****:imagecomponent/ComponentName/1.*.*",
        "ToRegionIds": {
          "ToRegionId": [
            "[\"cn-hangzhou\"]"
          ]
        },
        "VSwitchId": "vsw-bp67acfmxazb4p****"
      }
    ]
  },
  "MaxResults": 50,
  "NextToken": "AAAAAdDWBF2****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TotalCount": 1
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidImagePipelineIdSize.ExceededMaxNumber %s O número de parâmetros ImagePipelineId.N excede o limite superior. Valores válidos para N: 1 a 20.
400 InvalidName.Malformed %s
403 Invalid.NextToken The specified NextToken is not valid.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.