Todos os produtos
Search
Central de documentação

Resource Orchestration Service:DATASOURCE::ECS::Snapshots

Última atualização: Jun 27, 2026

Consulta todos os snapshots de uma instância do Elastic Compute Service (ECS) ou de um disco.

Sintaxe

{
  "Type": "DATASOURCE::ECS::Snapshots",
  "Properties": {
    "Status": String,
    "Usage": String,
    "Category": String,
    "KMSKeyId": String,
    "ResourceGroupId": String,
    "InstanceId": String,
    "Encrypted": Boolean,
    "SnapshotLinkId": String,
    "SnapshotIds": List,
    "SnapshotName": String,
    "Filters": List,
    "SnapshotType": String,
    "SourceDiskType": String,
    "Tags": List,
    "DiskId": String,
    "RefreshOptions": String
  }
}

Propriedades

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Status

String

Não

Sim

Status do snapshot.

Valores válidos:

  • progressing: o snapshot está sendo criado.

  • accomplished: o snapshot foi criado.

  • failed: falha na criação do snapshot.

  • all (padrão): todos os estados de snapshot.

Usage

String

Não

Sim

Indica se o snapshot é usado para criar imagens personalizadas ou discos.

Valores válidos:

  • image: o snapshot é usado para criar imagens personalizadas.

  • disk: o snapshot é usado para criar discos.

  • image_disk: o snapshot é usado para criar imagens personalizadas e discos de dados.

  • none: o snapshot não está em uso.

Category

String

Não

Sim

Tipo de snapshot.

Valores válidos:

  • Standard: snapshot padrão

  • Flash: snapshot local

KMSKeyId

String

Não

Sim

ID da chave do Key Management Service (KMS) usada no disco de dados.

Nenhuma.

ResourceGroupId

String

Não

Sim

ID do grupo de recursos.

Se você usar esta propriedade para filtrar recursos, até 1.000 recursos no grupo de recursos especificado poderão ser retornados.

InstanceId

String

Não

Sim

ID da instância.

Nenhuma.

Encrypted

Boolean

Não

Sim

Indica se o snapshot é criptografado.

Valores válidos:

  • true

  • false (padrão)

SnapshotLinkId

String

Não

Sim

ID da cadeia de snapshots.

Nenhuma.

SnapshotIds

List

Não

Sim

IDs dos snapshots.

Especifique até 100 IDs de snapshot. Separe vários IDs com vírgulas (,).

SnapshotName

String

Não

Sim

Nome do snapshot.

Nenhuma.

Filters

List

Não

Sim

Chaves e valores de filtro usados para consultar recursos.

Especifique até dois conjuntos de chaves e valores de filtro.

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

SnapshotType

String

Não

Sim

Tipo de criação do snapshot.

Valores válidos:

  • auto: criação automática

  • user: criação manual

  • all (padrão): todos os tipos de criação

SourceDiskType

String

Não

Sim

Tipo do disco de source.

Valores válidos:

  • system: disco do sistema

  • Data: disco de dados

Tags

List

Não

Sim

Tags do snapshot.

Adicione até 20 tags.

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

DiskId

String

Não

Sim

ID do disco.

Nenhuma.

RefreshOptions

String

Não

Sim

Política de atualização para recursos de fonte de dados quando a pilha é atualizada.

Valores válidos:

  • Never (padrão): não atualize os recursos de fonte de dados na atualização da pilha.

  • Always: atualize os recursos de fonte de dados na atualização da pilha.

Sintaxe de Filters

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

Propriedades de Filters

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Value

String

Não

Não

Valor do filtro usado para consultar recursos.

O valor deve ser um ponto no tempo em UTC+0.

Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mmZ.

Key

String

Sim

Não

Chave do filtro usada para consultar recursos.

Valores válidos:

  • CreationStartTime

  • CreationEndTime

Sintaxe de Tags

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

Propriedades de Tags

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Value

String

Não

Não

Valor da tag do snapshot.

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

Key

String

Sim

Não

Chave da tag do snapshot.

A chave da tag deve ter de 1 a 128 caracteres e não pode conter http:// ou https://. Não pode começar com aliyun ou acs:.

Valores de retorno (Fn::GetAtt)

  • SnapshotIds: IDs dos snapshots.

  • Snapshots: detalhes dos snapshots.

Propriedade

Tipo

Descrição

Restrição

SnapshotIds

List

IDs dos snapshots.

Exemplo: ["s-bp67acfmxazb4p**", "s-bp67acfmxazb5p", … "s-bp67acfmxazb6p**"].

Snapshots

List

Detalhes dos snapshots.

Nenhuma.

Status

String

Status do snapshot.

Valores válidos:

  • progressing: o snapshot está sendo criado.

  • accomplished: o snapshot foi criado.

  • failed: falha na criação do snapshot.

Progress

String

Progresso da criação do snapshot.

Unidade: porcentagem.

Exemplo: 100%.

Usage

String

Indica se o snapshot é usado para criar imagens personalizadas ou discos.

Valores válidos:

  • image: o snapshot é usado para criar imagens personalizadas.

  • disk: o snapshot é usado para criar discos.

  • image_disk: o snapshot é usado para criar imagens personalizadas e discos de dados.

  • none: o snapshot não está em uso.

Description

String

Descrição.

Nenhuma.

Category

String

Tipo de snapshot.

Valores válidos:

  • Standard: snapshot padrão

  • Flash: snapshot local

KMSKeyId

String

ID da chave KMS usada no disco de dados.

Nenhuma.

ProductCode

String

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

Nenhuma.

Encrypted

Boolean

Indica se o snapshot é criptografado.

Valores válidos:

  • true

  • false

SnapshotName

String

Nome do snapshot.

Nenhuma.

SourceDiskId

String

ID do disco de source.

Esta propriedade é mantida mesmo após a liberação do disco de source.

SourceStorageType

String

Tipo do disco de source.

Nenhuma.

SnapshotId

String

ID do snapshot.

Nenhuma.

SnapshotSN

String

Número de série do snapshot.

Nenhuma.

SourceDiskSize

String

Tamanho do disco de source.

Unidade: GiB.

SnapshotType

String

Tipo de criação do snapshot.

Valores válidos:

  • auto: criação automática

  • user: criação manual

SourceDiskType

String

Tipo do disco de source.

Valores válidos:

  • system: disco do sistema

  • Data: disco de dados

Tags

List

Tags.

Exemplo: [{'Value': 'value_test', 'Key': 'test123'}].

Exemplos

Formato JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "SnapshotName": {
      "Type": "String",
      "Description": "The name of the snapshot.",
      "Default": "auto_20150730_3"
    }
  },
  "Resources": {
    "ExtensionDataSource": {
      "Type": "DATASOURCE::ECS::Snapshots",
      "Properties": {
        "SnapshotName": {
          "Ref": "SnapshotName"
        }
      }
    }
  },
  "Outputs": {
    "SnapshotIds": {
      "Description": "the list of snapshot ids.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "SnapshotIds"
        ]
      }
    },
    "Snapshots": {
      "Description": "the list of snapshots.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "Snapshots"
        ]
      }
    }
  }
}