Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::ECS::AutoSnapshotPolicy

Última atualização: Jun 27, 2026

O recurso ALIYUN::ECS::AutoSnapshotPolicy cria uma política de snapshot automático.

Sintaxe

{
  "Type" : "ALIYUN::ECS::AutoSnapshotPolicy",
  "Properties" : {
    "TimePoints" : String,
    "RepeatWeekdays" : String,
    "RetentionDays" : Integer,
    "DiskIds" : List,
    "Tags": List,
    "AutoSnapshotPolicyName" : String,
    "ResourceGroupId": String
    "CopyEncryptionConfiguration": Map,
    "EnableCrossRegionCopy": Boolean,
    "CopiedSnapshotsRetentionDays": Integer,
    "TargetCopyRegions": List
  }
}

Propriedades

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

TimePoints

List

Sim

Sim

Horários do dia para criação dos snapshots automáticos.

Valores válidos: 0 a 23. Os valores de 0 a 23 representam as 24 horas do dia, das 00:00 às 23:00. Por exemplo, 1 indica 01:00.

Unidade: hora.

Para agendar vários snapshots automáticos no mesmo dia, especifique múltiplos horários em formato de lista, separados por vírgulas (,). Exemplo: [0, 1, ... 23]. Limite de 24 horários.

RepeatWeekdays

List

Sim

Sim

Dias da semana para criação dos snapshots automáticos.

Valores válidos: 1 a 7. Os valores de 1 a 7 correspondem aos dias da semana, de segunda a domingo.

Ciclo: semana.

Para agendar vários snapshots automáticos durante a semana, especifique múltiplos dias em formato de lista, separados por vírgulas (,). Exemplo: [1, 2, ... 7]. Limite de sete dias.

RetentionDays

Integer

Sim

Sim

Período de retenção dos snapshots automáticos.

Valores válidos:

  • -1 (padrão): retenção permanente dos snapshots automáticos.

  • 1 a 65535: retenção dos snapshots automáticos pelo número especificado de dias.

Unidade: dia.

DiskIds

List

Não

Sim

IDs dos discos para aplicação da política de snapshot automático.

Para aplicar a política a vários discos, especifique os IDs como uma lista no formato ["d-xxxxxxxxx", "d-yyyyyyyyy", … "d-zzzzzzzzz"]. Separe os IDs com vírgulas (,).

ResourceGroupId

String

Não

Sim

ID do grupo de recursos.

Nenhuma.

Tags

List

Não

Sim

Tags do recurso.

Limite de 20 tags.

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

AutoSnapshotPolicyName

String

Não

Sim

Nome da política de snapshot automático.

O nome deve ter de 2 a 128 caracteres, começar com uma letra e não pode iniciar com http:// ou https://. Pode conter letras, dígitos, dois pontos (:), sublinhados (_) e hifens (-).

Esta propriedade está vazia por padrão.

CopyEncryptionConfiguration

Map

Não

Não

Configurações de criptografia para replicação de snapshots entre regiões.

Para mais detalhes, consulte a seção "Propriedades de CopyEncryptionConfiguration" neste tópico.

EnableCrossRegionCopy

Boolean

Não

Não

Indica se a replicação de snapshots entre regiões está ativada.

Valores válidos:

  • true

  • false

CopiedSnapshotsRetentionDays

Integer

Não

Não

Período de retenção da cópia do snapshot na região de destino.

Unidade: dia. Valores válidos:

  • -1: retenção permanente da cópia do snapshot.

  • 1 a 65535: retenção da cópia do snapshot pelo número especificado de dias.

Valor padrão: -1.

TargetCopyRegions

List

Não

Não

Região de destino para replicação de snapshots entre regiões.

Especifique apenas uma região de destino.

Sintaxe de Tags

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

Propriedades de Tags

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Key

String

Sim

Não

Chave da tag.

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

Value

String

Não

Não

Valor da tag.

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

Sintaxe de CopyEncryptionConfiguration

"CopyEncryptionConfiguration": 
  {
    "KMSKeyId": String,
    "Encrypted": Boolean
  } 

Propriedades de CopyEncryptionConfiguration

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

KMSKeyId

String

Não

Não

ID da chave do Key Management Service (KMS) usada na replicação e criptografia de snapshots entre regiões.

Nenhuma.

Encrypted

Boolean

Não

Não

Indica se a replicação e a criptografia de snapshots entre regiões estão ativadas.

Valores válidos:

  • true

  • false

Valor padrão: false.

Valores de retorno

Fn::GetAtt

  • AutoSnapshotPolicyId: ID da política de snapshot automático.

  • Arn: Alibaba Cloud Resource Name (ARN).

Exemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  DiskIds:
    Type: CommaDelimitedList
    AssociationProperty: ALIYUN::ECS::Disk::DiskId
    Description: The disk ID. When you want to apply the automatic snapshot policy to multiple disks, you can set the DiskIds to an array. The format is list of ["d-xxxxxxxxx", "d-yyyyyyyyy", ..., "d-zzzzzzzzz"] and the IDs are separated by commas (,).
Resources:
  AutoSnapshotPolicy:
    Type: ALIYUN::ECS::AutoSnapshotPolicy
    Properties:
      TimePoints:
        - 20
        - 23
      DiskIds:
        Ref: DiskIds
      RetentionDays: 1
      RepeatWeekdays:
        - 1
        - 2
Outputs:
  AutoSnapshotPolicyId:
    Description: The automatic snapshot policy ID.
    Value:
      Fn::GetAtt:
        - AutoSnapshotPolicy
        - AutoSnapshotPolicyId
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "DiskIds": {
      "Type": "CommaDelimitedList",
      "AssociationProperty": "ALIYUN::ECS::Disk::DiskId",
      "Description": "The disk ID. When you want to apply the automatic snapshot policy to multiple disks, you can set the DiskIds to an array. The format is list of [\"d-xxxxxxxxx\", \"d-yyyyyyyyy\", ..., \"d-zzzzzzzzz\"] and the IDs are separated by commas (,)."
    }
  },
  "Resources": {
    "AutoSnapshotPolicy": {
      "Type": "ALIYUN::ECS::AutoSnapshotPolicy",
      "Properties": {
        "TimePoints": [
          20,
          23
        ],
        "DiskIds": {
          "Ref": "DiskIds"
        },
        "RetentionDays": 1,
        "RepeatWeekdays": [
          1,
          2
        ]
      }
    }
  },
  "Outputs": {
    "AutoSnapshotPolicyId": {
      "Description": "The automatic snapshot policy ID.",
      "Value": {
        "Fn::GetAtt": [
          "AutoSnapshotPolicy",
          "AutoSnapshotPolicyId"
        ]
      }
    }
  }
}

Para mais exemplos, visite auto-snapshot-policy.yml.