全部產品
Search
文件中心

:DATASOURCE::ECS::Snapshots

更新時間:Oct 24, 2024

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,
    "RefreshOptions": 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。

RefreshOptions

String

當資源棧更新時,資料來源資源的重新整理策略。

有效值:

  • Never(預設值):更新堆棧時,從不重新整理資料來源資源。

  • Always:更新堆棧時,始終重新整理資料來源資源。

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個字元,不能以aliyunacs:開頭,不能包含http://https://

Key

String

快照的標籤鍵。

長度為1~128個字元,不能以aliyunacs:開頭,不能包含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"
        ]
      }
    }
  }
}