Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::ECS::Snapshot

Última atualização: Jun 27, 2026

O recurso ALIYUN::ECS::Snapshot cria um snapshot de disco.

Sintaxe

{
  "Type": "ALIYUN::ECS::Snapshot",
  "Properties": {
    "SnapshotName": String,
    "Timeout": Integer,
    "Description": String,
    "DiskId": String,
    "Tags": List,
    "InstantAccess": Boolean,
    "InstantAccessRetentionDays": Integer,
    "ResourceGroupId": String,
    "RetentionDays": Integer
  }
}

Propriedades

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

DiskId

String

Sim

Não

ID do disco.

Nenhuma.

SnapshotName

String

Não

Não

Nome do snapshot.

De 2 a 128 caracteres. Deve começar com uma letra e não pode iniciar com http:// ou https://. Aceita letras, dígitos, dois pontos (:), sublinhados (_) e hifens (-).

Não pode começar com auto (reservado para snapshots automáticos).

Timeout

Integer

Não

Não

Tempo limite para criação do snapshot.

Estende o tempo limite de criação da stack. Se o snapshot não for criado nesse período, a criação da stack falhará. Defina este valor conforme o tamanho do disco e o volume de dados.

Valores válidos: 200 a 1440.

Valor padrão: 200.

Unidade: minutos.

Description

String

Não

Não

Descrição do snapshot.

De 2 a 256 caracteres. Não pode iniciar com http:// ou https://.

Vazia por padrão.

ResourceGroupId

String

Não

Sim

ID do grupo de recursos.

Nenhuma.

Tags

List

Não

Sim

As tags.

Adicione até 20 tags.

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

InstantAccess

Boolean

Não

Não

Indica se o acesso instantâneo deve ser ativado.

Valores válidos:

  • true: ative o acesso instantâneo. Compatível apenas com ESSDs.

  • false (padrão): cria um snapshot padrão.

InstantAccessRetentionDays

Integer

Não

Não

Período de retenção do acesso instantâneo. O snapshot é liberado ao término desse prazo.

Aplica-se apenas quando InstantAccess está definido como true.

Valores válidos: 1 a 65535.

Unidade: dias.

RetentionDays

Integer

Não

Não

Período de retenção do snapshot.

Unidade: dias. O snapshot é liberado ao término desse prazo.

Valores válidos: 1 a 65536.

Vazio por padrão; nesse caso, o snapshot não é liberado automaticamente.

Sintaxe de Tags

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

Propriedades de Tags

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

Key

String

Sim

Não

Chave da tag.

De 1 a 128 caracteres. Não pode conter http:// ou https://. Não pode iniciar com aliyun ou acs:.

Value

String

Não

Não

Valor da tag.

Até 128 caracteres. Não pode conter http:// ou https://. Não pode iniciar com aliyun ou acs:.

Valores de retorno

Fn::GetAtt

  • SnapshotId: ID do snapshot.

  • Arn: Alibaba Cloud Resource Name (ARN).

Exemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  DiskId:
    Type: String
    AssociationProperty: ALIYUN::ECS::Disk::DiskId
Resources:
  Snapshot:
    Type: ALIYUN::ECS::Snapshot
    Properties:
      Timeout: 300
      DiskId:
        Ref: DiskId
Outputs:
  SnapshotId:
    Description: The snapshot ID.
    Value:
      Fn::GetAtt:
        - Snapshot
        - SnapshotId
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "DiskId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::Disk::DiskId"
    }
  },
  "Resources": {
    "Snapshot": {
      "Type": "ALIYUN::ECS::Snapshot",
      "Properties": {
        "Timeout": 300,
        "DiskId": {
          "Ref": "DiskId"
        }
      }
    }
  },
  "Outputs": {
    "SnapshotId": {
      "Description": "The snapshot ID.",
      "Value": {
        "Fn::GetAtt": [
          "Snapshot",
          "SnapshotId"
        ]
      }
    }
  }
}

Exemplos adicionais usando ALIYUN::ECS::DiskAttachment e ALIYUN::ECS::Snapshot: auto-snapshot-policy.yml.