Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::ECS::SnapshotGroup

Última atualização: Jun 27, 2026

O recurso ALIYUN::ECS::SnapshotGroup cria um grupo consistente de snapshots para discos em nuvem anexados a uma instância do Elastic Compute Service (ECS). Um grupo consistente de snapshots contém snapshots de um ou mais discos em nuvem.

Sintaxe

{
  "Type": "ALIYUN::ECS::SnapshotGroup",
  "Properties": {
    "DiskIds": List,
    "Description": String,
    "ExcludeDiskIds": List,
    "InstanceId": String,
    "Name": String,
    "ResourceGroupId": String,
    "Tags": List
  }
}

Propriedades

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

DiskIds

List

Não

Não

IDs dos discos em nuvem para os quais você deseja criar um grupo consistente de snapshots.

Especifique IDs de discos em nuvem anexados a várias instâncias na mesma zona. Um grupo consistente de snapshots pode conter até 16 discos em nuvem, com tamanho total igual ou inferior a 32 TiB.

Nota
  • Não especifique esta propriedade e ExcludeDiskIds simultaneamente.

  • Se você especificar InstanceId, inclua apenas discos em nuvem anexados à instância indicada. Não é possível incluir discos de múltiplas instâncias.

Description

String

Não

Sim

Descrição do recurso.

A descrição deve ter entre 2 e 256 caracteres e não pode começar com http:// ou https://.

ExcludeDiskIds

List

Não

Não

IDs dos discos em nuvem que devem ser excluídos da criação de snapshots.

O grupo consistente de snapshots não inclui os snapshots dos discos especificados. Especifique até 16 IDs de discos em nuvem.

Por padrão, essa propriedade fica vazia e o sistema cria snapshots para todos os discos da instância.

Nota

Esta propriedade e DiskIds são mutuamente exclusivas.

InstanceId

String

Não

Não

ID da instância.

Nenhuma.

Name

String

Não

Sim

Nome do grupo consistente de snapshots.

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

ResourceGroupId

String

Não

Não

ID do grupo de recursos ao qual o grupo consistente de snapshots pertence.

Nenhuma.

Tags

List

Não

Sim

Tags do recurso.

Adicione até 20 tags.

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

Sintaxe de Tags

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

Propriedades de Tags

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Key

String

Sim

Não

Chave da tag.

Nenhuma.

Value

String

Não

Não

Valor da tag.

Nenhuma.

Valores de retorno

Fn::GetAtt

SnapshotGroupId: ID do grupo consistente de snapshots.

Exemplos

  • YAML formato

    ROSTemplateFormatVersion: '2015-09-01'
    Parameters:
      DiskIds:
        AssociationPropertyMetadata:
          Parameter:
            Type: String
            Description:
              en: The ID of cloud disk for which you want to create snapshots.
            Required: false
        AssociationProperty: List[Parameter]
        Type: Json
        Description:
          en: |-
            The IDs of cloud disk for which you want to create snapshots. You can specify multiple cloud disk IDs across instances within the same zone. The length of the list ranges from 1 to 16. A single snapshot-consistent group can contain snapshots of up to 16 cloud disks whose total disk size does not exceed 32 TiB.
            Take note of the following items:
            You cannot specify both DiskIds and ExcludeDiskIdin the same request.
            If InstanceId is set, you can use DiskIds to specify only cloud disks attached to the instance specified by InstanceId, and you cannot use DiskIds to specify cloud disks attached to multiple instances.
        Required: false
      InstanceId:
        Type: String
        AssociationProperty: ALIYUN::ECS::Instance::InstanceId
        Description:
          en: The instance ID.
        Required: false
      Name:
        Type: String
        Description:
          en: The name of the snapshot-consistent group. The name must be 2 to 128 characters in length. The name can contain letters, digits, periods (.), underscores (_), hyphens (-), and colons (:). It must start with a letter and cannot start with http:// or https://.
        Required: false
    Resources:
      SnapshotGroup:
        Type: ALIYUN::ECS::SnapshotGroup
        Properties:
          DiskIds:
            Ref: DiskIds
          InstanceId:
            Ref: InstanceId
          Name:
            Ref: Name
    Outputs:
      SnapshotGroupId:
        Description: The ID of the snapshot-consistent group.
        Value:
          Fn::GetAtt:
            - SnapshotGroup
            - SnapshotGroupId
    
  • JSON formato

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Parameters": {
        "DiskIds": {
          "AssociationPropertyMetadata": {
            "Parameter": {
              "Type": "String",
              "Description": {
                "en": "The ID of cloud disk for which you want to create snapshots."
              },
              "Required": false
            }
          },
          "AssociationProperty": "List[Parameter]",
          "Type": "Json",
          "Description": {
            "en": "The IDs of cloud disk for which you want to create snapshots. You can specify multiple cloud disk IDs across instances within the same zone. The length of the list ranges from 1 to 16. A single snapshot-consistent group can contain snapshots of up to 16 cloud disks whose total disk size does not exceed 32 TiB.\nTake note of the following items:\nYou cannot specify both DiskIds and ExcludeDiskIdin the same request.\nIf InstanceId is set, you can use DiskIds to specify only cloud disks attached to the instance specified by InstanceId, and you cannot use DiskIds to specify cloud disks attached to multiple instances."
          },
          "Required": false
        },
        "InstanceId": {
          "Type": "String",
          "AssociationProperty": "ALIYUN::ECS::Instance::InstanceId",
          "Description": {
            "en": "The instance ID."
          },
          "Required": false
        },
        "Name": {
          "Type": "String",
          "Description": {
            "en": "The name of the snapshot-consistent group. The name must be 2 to 128 characters in length. The name can contain letters, digits, periods (.), underscores (_), hyphens (-), and colons (:). It must start with a letter and cannot start with http:// or https://."
          },
          "Required": false
        }
      },
      "Resources": {
        "SnapshotGroup": {
          "Type": "ALIYUN::ECS::SnapshotGroup",
          "Properties": {
            "DiskIds": {
              "Ref": "DiskIds"
            },
            "InstanceId": {
              "Ref": "InstanceId"
            },
            "Name": {
              "Ref": "Name"
            }
          }
        }
      },
      "Outputs": {
        "SnapshotGroupId": {
          "Description": "The ID of the snapshot-consistent group.",
          "Value": {
            "Fn::GetAtt": [
              "SnapshotGroup",
              "SnapshotGroupId"
            ]
          }
        }
      }
    }