Elastic Compute Service：建立應用一致性快照

以下為Go SDK程式碼範例：

package main

import (
    "fmt"
    "os"
    "github.com/aliyun/alibaba-cloud-sdk-go/services/ecs"
)

func main() {
		// 請確保代碼運行環境設定了環境變數ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。
    // 工程代碼泄露可能會導致AccessKey泄露，並威脅帳號下所有資源的安全性。以下程式碼範例使用環境變數擷取AccessKey的方式進行調用，建議使用更安全的STS方式。
    client, err := ecs.NewClientWithAccessKey(
        "cn-hangzhou",    //設定執行個體所在地區
        os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),     
        os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))

    //調用RunCommand為執行個體建立檔案系統一致性快照。
    request := ecs.CreateRunCommandRequest()
    request.Scheme = "https"

    request.Type = "RunShellScript"
    //建立檔案系統一致性快照的命令，具體資訊，請參見CommandContent內容說明。
    request.CommandContent = "acs-plugin-manager --exec --plugin app-snapshot-plugin --params=-RamRoleName=\"AppSnapshotRoleName\",-InstantAccess=true,-EnableFsFreeze=true,-TimeoutInSeconds=30,-PreScriptPath=\"/tmp/prescript.sh\",-PostScriptPath=\"/tmp/postscript.sh\",-InstantAccessRentationDays=1,-ExcludeDiskId=\"\",-Name=\"LinuxApp1\""
    request.InstanceId = &[]string{"i-bp17r83nppqf141v****"} //設定執行個體ID

    response, err := client.RunCommand(request)
    if err != nil {
        fmt.Print(err.Error())
    }
    fmt.Printf("response is %#v\n", response)
}

CommandContent參數中內容說明：

• acs-plugin-manager --exec --plugin app-snapshot-plugin：表示執行雲助手外掛程式app-snapshot-plugin。

• --params=表示外掛程式的配置參數，具體參數說明，如下表所示。

  參數	類型	是否必傳	描述
  ExcludeDiskId	String	否	ECS執行個體中不需要建立快照的雲端硬碟。
  InstantAccess	Boolean	否	是否開啟快照極速可用功能。取值如下： true：開啟 false：關閉 說明 自2023年10月12日11:00起，快照極速可用能力升級，ESSD PL0/1/2/3及ESSD AutoPL雲端硬碟建立的快照將預設為建立後極速可用，無需額外配置該參數。更多資訊，請參見開啟或關閉快照極速可用功能。
  InstantAccessRentationDays	Integer	否	快照極速可用功能保留天數，到期後自動關閉。 取值範圍：1~65536。預設值：1
  Name	String	是	快照一致性組名稱。
  Description	String	否	快照一致性組描述資訊。
  RamRoleName	String	是	ECS執行個體綁定的RAM角色，取值請參見步驟一：為ECS執行個體配置RAM角色。
  PreScriptPath	String	否	應用凍結指令碼路徑（/tmp/prescript.sh）。prescript.sh指令碼需要符合以下條件： 在許可權上，僅root作為owner使用者具有讀、寫、執行許可權，即700許可權。 在內容上，指令碼內容需要根據應用自己定製。 說明 Linux執行個體建立應用一致性快照時必須設定此參數。如果指令碼設定錯誤（例如許可權、儲存路徑或檔案名稱設定錯誤等），最終建立的快照為檔案系統一致性快照。
  PostScriptPath	String	否	應用解凍指令碼路徑（/tmp/postscript.sh）。postscript.sh指令碼需要符合以下條件： 在許可權上，僅root作為owner使用者具有讀、寫、執行許可權，即700許可權。 在內容上，指令碼內容需要根據應用自己定製。 說明 Linux執行個體建立應用一致性快照時必須設定此參數。如果指令碼設定錯誤（例如許可權、儲存路徑或檔案名稱設定錯誤等），最終建立的快照為檔案系統一致性快照。
  EnableFsFreeze	Boolean	否	是否在建立儲存快照前使用Linux的FsFreeze機制確保檔案系統處於唯讀一致性。 預設為True。
  TimeoutInSeconds	Integer	否	IO凍結逾時時間。 預設為30秒。
  ScriptTimeoutInSeconds	Integer	否	指令碼執行逾時時間。 預設值為1800秒。

調用結果樣本如下所示，返回參數說明，請參見RunCommand。

以下為Go SDK樣本：

package main

import (
    "fmt"
  	"os"
    "github.com/aliyun/alibaba-cloud-sdk-go/services/ecs"
)

func main() {
    // 請確保代碼運行環境設定了環境變數ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。
    // 工程代碼泄露可能會導致AccessKey泄露，並威脅帳號下所有資源的安全性。以下程式碼範例使用環境變數擷取AccessKey的方式進行調用，建議使用更安全的STS方式。
    client, err := ecs.NewClientWithAccessKey(
        "cn-hangzhou",       //設定執行個體所在地區
        os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),     
        os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))

    request := ecs.CreateRunCommandRequest()
    request.Scheme = "https"

    request.Type = "RunBatScript"
    //建立應用一致性快照的命令，具體資訊，請參見CommandContent內容說明。
    request.CommandContent = "acs-plugin-manager --exec --plugin app-snapshot-plugin-win --params=-RamRoleName=\"AppSnapshotRoleName\",-InstantAccess=true,-EnableWriters=true,-Description=\"AppSnapshot\",-InstantAccessRentationDays=1,-ExcludeDiskId=\"\",-Name=\"APPSnapshot-1\""
    request.InstanceId = &[]string{"i-bp11vqwgh574****"} //設定執行個體ID
    request.Timeout = "1800"

    response, err := client.RunCommand(request)
    if err != nil {
        fmt.Print(err.Error())
    }
    fmt.Printf("response is %#v\n", response)
}