DATASOURCE::ECS::Snapshots类型用于查询一台ECS实例或一块云盘所有的快照列表。

语法

{
  "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
  }
}

属性

属性名称 类型 必须 允许更新 描述 约束
Status String 否 是 快照状态。 取值：
  • progressing：正在创建。
  • accomplished：创建成功。
  • failed：创建失败。
  • all（默认值）：所有快照状态。
Usage String 否 是 快照是否被用作创建镜像或云盘。 取值：
  • image：使用快照创建了自定义镜像。
  • disk：使用快照创建了云盘。
  • image_disk：使用快照创建了数据盘和自定义镜像。
  • none：暂未使用快照。
Category String 否 是 快照类型。 取值：
  • Standard：普通快照。
  • Flash：本地快照。
KMSKeyId String 否 是 数据盘对应的KMS密钥ID。 无
ResourceGroupId String 否 是 资源组ID。 使用该参数过滤资源时，资源数量不能超过1000个。
InstanceId String 否 是 实例ID。 无
Encrypted Boolean 否 是 是否过滤加密快照。 取值：
  • true：过滤加密快照。
  • false（默认值）：不过滤加密快照。
SnapshotLinkId String 否 是 快照链ID。 无
SnapshotIds List 否 是 快照ID列表。 最多支持100个快照ID，多个快照ID之间用半角逗号（,）分隔。
SnapshotName String 否 是 快照名称。 无
Filters List 否 是 查询资源时的筛选键值。 最多支持指定2个筛选键值。

更多信息，请参见Filters属性。

SnapshotType String 否 是 快照创建类型。 取值：
  • auto：自动创建快照。
  • user：手动创建快照。
  • all（默认值）：所有的快照创建类型。
SourceDiskType String 否 是 源云盘类型。 取值：
  • System：系统盘。
  • Data：数据盘。
Tags List 否 是 快照的标签。 最多支持指定20个标签。

更多信息，请参见Tags属性。

DiskId String 否 是 云盘设备ID。 无

Filters语法

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

Filters属性

属性名称 类型 必须 允许更新 描述 约束
Value String 否 否 查询资源时的筛选值。 采用UTC+0时区。

格式：yyyy-MM-ddTHH:mmZ。

Key String 是 否 查询资源时的筛选键。 取值：
  • CreationStartTime：创建开始时间。
  • CreationEndTime：创建结束时间。

Tags语法

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

Tags属性

属性名称 类型 必须 允许更新 描述 约束
Value String 否 否 快照的标签值。 长度为0~128个字符，不能以aliyun和acs:开头，不能包含http://或https:// 。
Key String 是 否 快照的标签键。 长度为1~128个字符，不能以aliyun和acs:开头，不能包含http://或https:// 。

返回数据（Fn::GetAtt）

  • SnapshotIds：快照ID列表。
  • Snapshots：快照列表详情。
属性名称 类型 描述 约束
SnapshotIds List 快照ID列表。 取值示例：["s-bp67acfmxazb4p****", "s-bp67acfmxazb5p****", … "s-bp67acfmxazb6p****"]。
Snapshots List 快照列表详情。 无
Status String 快照状态。 取值：
  • progressing：正在创建。
  • accomplished：创建成功。
  • failed：创建失败。
Progress String 快照创建进度。 单位：百分比。

取值示例：100%。

Usage String 快照是否被用作创建镜像或云盘。 取值：
  • image：使用快照创建了自定义镜像。
  • disk：使用快照创建了云盘。
  • image_disk：使用快照创建了数据盘和自定义镜像。
  • none：暂未使用快照。
Description String 描述信息。 无
Category String 快照类型。 取值：
  • Standard：普通快照。
  • Flash：本地快照。
KMSKeyId String 数据盘对应的KMS密钥ID。 无
ProductCode String 从镜像市场继承的产品编号。 无
Encrypted Boolean 该快照是否加密。 取值：
  • true：加密。
  • false：不加密。
SnapshotName String 快照名称。 无
SourceDiskId String 源云盘ID。 快照的源云盘被释放后，该字段仍旧保留。
SourceStorageType String 源云盘类型。 无
SnapshotId String 快照ID。 无
SnapshotSN String 快照的序列号。 无
SourceDiskSize String 源云盘容量。 单位：GiB。
SnapshotType String 快照创建类型。 取值：
  • auto：自动创建快照。
  • user：手动创建快照。
SourceDiskType String 源云盘类型。 取值：
  • System：系统盘。
  • Data：数据盘。
Tags List 标签。 取值示例：[{'Value': 'value_test', 'Key': 'test123'}]。

示例

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"
        ]
      }
    }
  }
}