云服务器 ECS：创建应用一致性快照

以下为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\",-EnableFsFreeze=true,-TimeoutInSeconds=30,-PreScriptPath=\"/tmp/prescript.sh\",-PostScriptPath=\"/tmp/postscript.sh\",-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实例中不需要创建快照的云盘。
  Name	String	是	快照一致性组名称。
  Description	String	否	快照一致性组描述信息。
  RamRoleName	String	是	ECS实例绑定的RAM角色，取值请参见步骤一：为ECS实例配置RAM角色。
  PreScriptPath	String	否	prescript.sh脚本路径（/tmp/prescript.sh）。prescript.sh脚本需要符合以下条件： 在权限上，仅root作为owner用户具有读、写、执行权限，即700权限。 在内容上，脚本内容需要根据应用自行定制。 重要 Linux实例创建应用一致性快照时必须设置此参数。如果脚本设置错误（例如权限、保存路径或文件名设置错误等），最终创建的快照将是文件系统一致性快照。
  PostScriptPath	String	否	postscript.sh脚本路径（/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\",-EnableWriters=true,-Description=\"AppSnapshot\",-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)
}