すべてのプロダクト
Search
ドキュメントセンター

Resource Orchestration Service:スナップショット整合性グループ

最終更新日:Mar 17, 2025

ALIYUN::ECS::SnapshotGroup は、Elastic Compute Service (ECS) インスタンスに接続されているクラウドディスクのスナップショット整合性グループを作成するために使用されます。スナップショット整合性グループには、1 つ以上のクラウドディスクのスナップショットが含まれています。

構文

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

プロパティ

プロパティ

必須

編集可能

説明

制約

DiskIds

List

いいえ

いいえ

スナップショット整合性グループを作成するクラウドディスクの ID。

同じゾーン内の複数のインスタンスに接続されているクラウドディスクの ID を指定できます。スナップショット整合性グループには、合計サイズが 32 TiB 以下のクラウドディスクを最大 16 個まで含めることができます。

説明
  • このプロパティと ExcludeDiskIds の両方を指定することはできません。

  • InstanceId を指定する場合、指定したインスタンスにのみ接続されているクラウドディスクの ID を指定できます。複数のインスタンスに接続されているクラウドディスクの ID は指定できません。

Description

String

いいえ

はい

説明。

説明は 2 ~ 256 文字で、http:// または https:// で始めることはできません。

ExcludeDiskIds

List

いいえ

いいえ

スナップショットを作成しないクラウドディスクの ID。

クラウドディスクの ID を指定した後、作成するスナップショット整合性グループには、指定したクラウドディスクのスナップショットは含まれません。最大 16 個のクラウドディスク ID を指定できます。

このプロパティはデフォルトでは空で、インスタンスのすべてのクラウドディスクに対してスナップショットが作成されることを示します。

説明

このプロパティと DiskIds の両方を指定することはできません。

InstanceId

String

いいえ

いいえ

インスタンス ID。

なし。

Name

String

いいえ

はい

スナップショット整合性グループの名前。

名前は 2 ~ 128 文字でなければなりません。文字、数字、ピリオド(.)、アンダースコア(_)、ハイフン(-)、コロン(:) を使用できます。文字で始まり、http:// または https:// で始めることはできません。

ResourceGroupId

String

いいえ

いいえ

スナップショット整合性グループが属するリソースグループの ID。

なし。

Tags

List

いいえ

はい

タグ。

最大 20 個のタグを追加できます。

詳細については、このトピックの「タグのプロパティ」セクションをご参照ください。

タグの構文

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

タグのプロパティ

プロパティ

必須

編集可能

説明

制約

Key

String

はい

いいえ

タグキー。

なし。

Value

String

いいえ

いいえ

タグ値。

なし。

戻り値

Fn::GetAtt

SnapshotGroupId: スナップショット整合性グループの ID。

  • YAML フォーマット

    ROSTemplateFormatVersion: '2015-09-01'
    Parameters:
      DiskIds:
        AssociationPropertyMetadata:
          Parameter:
            Type: String
            Description:
              ja: スナップショットを作成するクラウドディスクの ID。
            Required: false
        AssociationProperty: List[Parameter]
        Type: Json
        Description:
          ja: |-
            スナップショットを作成するクラウドディスクの ID。同じゾーン内の複数のインスタンスにまたがって複数のクラウドディスク ID を指定できます。リストの長さは 1 ~ 16 です。1 つの整合性グループには、合計ディスクサイズが 32 TiB を超えない最大 16 個のクラウドディスクのスナップショットを含めることができます。
            次の項目に注意してください。
            同じリクエストで DiskIds と ExcludeDiskId の両方を指定することはできません。
            InstanceId が設定されている場合、DiskIds を使用して InstanceId で指定されたインスタンスに接続されているクラウドディスクのみを指定できます。DiskIds を使用して複数のインスタンスに接続されているクラウドディスクを指定することはできません。
        Required: false
      InstanceId:
        Type: String
        AssociationProperty: ALIYUN::ECS::Instance::InstanceId
        Description:
          ja: インスタンス ID。
        Required: false
      Name:
        Type: String
        Description:
          ja: スナップショット整合性グループの名前。名前は 2 ~ 128 文字である必要があります。名前に使用できる文字は、英字、数字、ピリオド(.)、アンダースコア(_)、ハイフン(-)、コロン(:) です。文字で始まり、http:// または https:// で始めることはできません。
        Required: false
    Resources:
      SnapshotGroup:
        Type: ALIYUN::ECS::SnapshotGroup
        Properties:
          DiskIds:
            Ref: DiskIds
          InstanceId:
            Ref: InstanceId
          Name:
            Ref: Name
    Outputs:
      SnapshotGroupId:
        Description: スナップショット整合性グループの ID。
        Value:
          Fn::GetAtt:
            - SnapshotGroup
            - SnapshotGroupId
    
  • JSON フォーマット

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Parameters": {
        "DiskIds": {
          "AssociationPropertyMetadata": {
            "Parameter": {
              "Type": "String",
              "Description": {
                "ja": "スナップショットを作成するクラウドディスクの ID。"
              },
              "Required": false
            }
          },
          "AssociationProperty": "List[Parameter]",
          "Type": "Json",
          "Description": {
            "ja": "スナップショットを作成するクラウドディスクの ID。同じゾーン内の複数のインスタンスにまたがって複数のクラウドディスク ID を指定できます。リストの長さは 1 ~ 16 です。1 つの整合性グループには、合計ディスクサイズが 32 TiB を超えない最大 16 個のクラウドディスクのスナップショットを含めることができます。\n次の項目に注意してください。\n同じリクエストで DiskIds と ExcludeDiskId の両方を指定することはできません。\nInstanceId が設定されている場合、DiskIds を使用して InstanceId で指定されたインスタンスに接続されているクラウドディスクのみを指定できます。DiskIds を使用して複数のインスタンスに接続されているクラウドディスクを指定することはできません。"
          },
          "Required": false
        },
        "InstanceId": {
          "Type": "String",
          "AssociationProperty": "ALIYUN::ECS::Instance::InstanceId",
          "Description": {
            "ja": "インスタンス ID。"
          },
          "Required": false
        },
        "Name": {
          "Type": "String",
          "Description": {
            "ja": "スナップショット整合性グループの名前。名前は 2 ~ 128 文字である必要があります。名前に使用できる文字は、英字、数字、ピリオド(.)、アンダースコア(_)、ハイフン(-)、コロン(:) です。文字で始まり、http:// または https:// で始めることはできません。"
          },
          "Required": false
        }
      },
      "Resources": {
        "SnapshotGroup": {
          "Type": "ALIYUN::ECS::SnapshotGroup",
          "Properties": {
            "DiskIds": {
              "Ref": "DiskIds"
            },
            "InstanceId": {
              "Ref": "InstanceId"
            },
            "Name": {
              "Ref": "Name"
            }
          }
        }
      },
      "Outputs": {
        "SnapshotGroupId": {
          "Description": "スナップショット整合性グループの ID。",
          "Value": {
            "Fn::GetAtt": [
              "SnapshotGroup",
              "SnapshotGroupId"
            ]
          }
        }
      }
    }