Todos os produtos
Search
Central de documentação

Resource Orchestration Service:DATASOURCE::ECS::Images

Última atualização: Jun 27, 2026

O DATASOURCE::ECS::Images consulta imagens disponíveis.

Sintaxe

{
  "Type": "DATASOURCE::ECS::Images",
  "Properties": {
    "Status": String,
    "ImageOwnerAlias": String,
    "Usage": String,
    "ActionType": String,
    "ResourceGroupId": String,
    "Architecture": String,
    "ImageFamily": String,
    "IsSupportIoOptimized": Boolean,
    "IsSupportCloudinit": Boolean,
    "ImageName": String,
    "SnapshotId": String,
    "IsPublic": Boolean,
    "OSType": String,
    "ImageId": String,
    "InstanceType": String,
    "Tags": List,
    "RefreshOptions": String
  }
}

Propriedades

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

Status

String

Não

Sim

Status da imagem.

Valores válidos:

  • Available (padrão): a imagem está disponível.

  • Creating: a imagem está sendo criada.

  • Waiting: a imagem aguarda processamento.

  • UnAvailable: a imagem não está disponível.

  • CreateFailed: falha na criação da imagem.

  • Deprecated: a imagem foi descontinuada.

Nota

É possível especificar vários valores para esta propriedade. Separe os valores com vírgulas (,).

ImageOwnerAlias

String

Não

Sim

Origem da imagem.

Valores válidos:

  • system: imagem pública fornecida pela Alibaba Cloud.

  • self: imagem personalizada criada por você.

  • others: imagem compartilhada de outra conta Alibaba Cloud.

  • marketplace: imagem do Alibaba Cloud Marketplace. Se uma imagem do Alibaba Cloud Marketplace for retornada, você poderá usá-la sem precisar assinar o serviço. No entanto, atente aos detalhes de faturamento das imagens do Alibaba Cloud Marketplace.

Nota

Se esta propriedade ficar em branco, os resultados correspondentes aos valores system, self e others serão retornados por padrão.

Usage

String

Não

Sim

Indica se a imagem é usada por uma instância do Elastic Compute Service (ECS).

Valores válidos:

  • instance: a imagem é usada por uma instância ECS.

  • none: a imagem não é usada por nenhuma instância ECS.

ActionType

String

Não

Sim

Cenário de uso pretendido para a imagem.

Valores válidos:

  • CreateEcs (padrão): uso da imagem para criar uma instância.

  • ChangeOS: uso da imagem para alterar o disco do sistema ou o sistema operacional.

ResourceGroupId

String

Não

Sim

ID do grupo de recursos ao qual a imagem personalizada pertence.

Ao usar esta propriedade para consultar recursos, até 1.000 recursos pertencentes ao grupo de recursos especificado são retornados.

Nota

Esta propriedade tem efeito quando ImageOwnerAlias está definido como self.

Architecture

String

Não

Sim

Arquitetura da imagem.

Valores válidos:

  • i386

  • x86_64

  • arm64

ImageFamily

String

Não

Sim

Nome da família de imagens. Use esta propriedade para consultar imagens pertencentes à família especificada.

Nenhuma.

IsSupportIoOptimized

Boolean

Não

Sim

Define se a imagem pode ser usada em uma instância otimizada para I/O.

Valores válidos:

  • true

  • false

IsSupportCloudinit

Boolean

Não

Sim

Indica se a imagem oferece suporte ao cloud-init.

Valores válidos:

  • true

  • false

ImageName

String

Não

Sim

Nome da imagem.

Há suporte para o caractere curinga (). Exemplo: centos_8_5.

SnapshotId

String

Não

Sim

ID do snapshot usado pela imagem personalizada.

Nenhuma.

IsPublic

Boolean

Não

Sim

Define se devem ser consultadas imagens de comunidade publicadas.

Valores válidos:

  • true: consulta imagens de comunidade publicadas. Ao definir esta propriedade como true, é obrigatório configurar ImageOwnerAlias como others.

  • false (padrão): consulta imagens que não sejam de comunidade publicadas. O tipo de imagem consultada varia conforme o valor de ImageOwnerAlias.

OSType

String

Não

Sim

Tipo de sistema operacional da imagem.

Valores válidos:

  • windows

  • linux

ImageId

String

Não

Sim

ID da imagem.

Nenhuma.

InstanceType

String

Não

Sim

Tipo da instância destinada ao uso da imagem.

Nenhuma.

Tags

List

Não

Sim

Tags da imagem.

É permitido adicionar até 20 tags.

Para mais informações, consulte Propriedades de Tags.

RefreshOptions

String

Não

Sim

Política de atualização dos recursos de source de dados durante a atualização da pilha.

Valores válidos:

  • Never (padrão): não atualiza os recursos de source de dados quando a pilha é atualizada.

  • Always: atualiza os recursos de source de dados sempre que a pilha for atualizada.

Sintaxe de Tags

"Tags": [
  {
    "Value": String,
    "Key": String
  }
]

Propriedades de Tags

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

Value

String

Não

Não

Valor da tag da imagem.

O valor da tag pode ter até 128 caracteres e não deve conter http:// ou https://. Também não pode começar com aliyun ou acs:.

Key

String

Sim

Não

Chave da tag da imagem.

A chave da tag deve ter entre 1 e 128 caracteres e não pode conter http:// ou https://. Além disso, não pode iniciar com aliyun ou acs:.

Valores de retorno (Fn::GetAtt)

  • ImageIds: IDs das imagens.

  • Images: detalhes das imagens.

Propriedade

Tipo

Descrição

Restrição

ImageIds

List

IDs das imagens.

Exemplo: ['centos_8_5_x64_20G_alibase_20211228.vhd'].

Images

List

Detalhes das imagens.

Nenhuma.

Status

String

Status da imagem.

Valores válidos:

  • Available: a imagem está disponível.

  • Creating: a imagem está sendo criada.

  • Waiting: a imagem aguarda processamento.

  • UnAvailable: a imagem não está disponível.

  • CreateFailed: houve falha na criação da imagem.

  • Deprecated: a imagem foi descontinuada.

ImageFamily

String

Nome da família de imagens.

Nenhuma.

Progress

String

Progresso da operação na imagem.

Unidade: porcentagem.

IsCopied

Boolean

Indica se a imagem é uma cópia de outra imagem.

Valores válidos:

  • true

  • false

IsSupportIoOptimized

Boolean

Define se a imagem pode ser usada em uma instância otimizada para I/O.

Valores válidos:

  • true

  • false

ImageOwnerAlias

String

Origem da imagem.

Valores válidos:

  • system: imagem pública fornecida pela Alibaba Cloud.

  • self: imagem personalizada criada por você.

  • others: imagem compartilhada de outra conta Alibaba Cloud.

  • marketplace: imagem do Alibaba Cloud Marketplace. Se uma imagem do Alibaba Cloud Marketplace for retornada, será possível usá-la sem necessidade de assinatura. Contudo, observe os detalhes de faturamento específicos dessas imagens.

IsSupportCloudinit

Boolean

Indica se há suporte a cloud-init na imagem.

Valores válidos:

  • true

  • false

ImageVersion

String

Versão da imagem.

Nenhuma.

Usage

String

Indica se a imagem está sendo usada por uma instância ECS.

Valores válidos:

  • instance: a imagem é usada por uma instância ECS.

  • none: a imagem não é usada por nenhuma instância ECS.

IsSelfShared

String

Indica se a imagem personalizada foi compartilhada com outras contas Alibaba Cloud.

Valores válidos:

  • true

  • false

Description

String

Descrição.

Nenhuma.

Size

Integer

Tamanho da imagem.

Unidade: GiB.

ResourceGroupId

String

ID do grupo de recursos ao qual a imagem pertence.

Exemplo: rg-bp67acfmxazb4p****.

Platform

String

Plataforma do sistema operacional.

Exemplo: Windows Server 2016.

OSNameEn

String

Nome de exibição do sistema operacional em inglês.

Exemplo: Windows Server 2016 Data Center Edition 64bit Chinese Edition.

ImageName

String

Nome da imagem.

Nenhuma.

OSName

String

Nome de exibição do sistema operacional em chinês.

None.

ImageId

String

ID da imagem.

Exemplo: m-bp1g7004ksh0oeuc****.

OSType

String

Tipo de sistema operacional da imagem.

Valores válidos:

  • windows

  • linux

IsSubscribed

Boolean

Indica se os termos do serviço de imagem correspondentes ao código do produto foram aceitos.

Valores válidos:

  • true

  • false

ProductCode

String

Código do produto da imagem do Alibaba Cloud Marketplace.

Nenhuma.

Architecture

String

Arquitetura do sistema operacional da imagem.

Valores válidos:

  • i386

  • x86_64

  • arm64

DiskDeviceMappings

List

Mapeamentos entre discos e snapshots presentes na imagem.

Nenhuma.

Tags

List

Tags da imagem.

Nenhuma.

IsPublic

Boolean

Indica se a imagem consultada é uma imagem de comunidade publicada.

Valores válidos:

  • true

  • false

ImageOwnerId

String

ID da conta Alibaba Cloud proprietária da imagem.

Esta propriedade é retornada apenas na consulta de imagens compartilhadas.

Exemplos

Formato YAML

ROSTemplateFormatVersion: '2015-09-01'
Parameters: {}
Resources:
  Images:
    Type: DATASOURCE::ECS::Images
    Properties:
      ImageName: centos_8_5*
Outputs:
  ImageIds:
    Value:
      Ref: Images                    

Formato JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
  },
  "Resources": {
    "Images": {
      "Type": "DATASOURCE::ECS::Images",
      "Properties": {
        "ImageName": "centos_8_5*"
      }
    }
  },
  "Outputs": {
    "ImageIds": {
      "Value": {
        "Ref": "Images"
      }
    }
  }
}