云服务器 ECS：通过Go SDK创建应用一致性快照

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

func main() {
    client, err := ecs.NewClientWithAccessKey(
        "cn-hangzhou",       //设置实例所在地域
        "<accessKeyId>",     //设置AccessKey ID
        "<accessKeySecret>") //设置AccessKey Secret

    //调用AttachInstanceRamRole为实例绑定RAM角色
    request := ecs.CreateAttachInstanceRamRoleRequest()
    request.Scheme = "https"

    request.RamRoleName = "AppSnapshotRoleName"          //设置RAM角色名称
    request.InstanceIds = "[\"i-bp17r83nppqf141v****\"]" //设置实例ID

    response, err := client.AttachInstanceRamRole(request)
    if err != nil {
        fmt.Print(err.Error())
    }

    fmt.Println(response.String())
}

package main

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

func main() {
    client, err := ecs.NewClientWithAccessKey(
        "cn-hangzhou",    //设置实例所在地域
        "<accessKeyId>",  //设置AccessKey ID
        "<accessKeySecret>") //设置AccessKey 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)
}

• acs-plugin-manager --exec --plugin app-snapshot-plugin：表示执行云助手插件app-snapshot-plugin。
• --params=表示插件的配置参数，具体参数说明，如下表所示。

  参数	类型	是否必传	描述
  ExcludeDiskId	String	否	ECS实例中不需要创建快照的云盘。
  InstantAccess	Boolean	否	是否开启快照极速可用功能。取值如下： true：开启 false：关闭
  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秒。

package main

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

func main() {
    client, err := ecs.NewClientWithAccessKey(
        "cn-hangzhou",       //设置实例所在地域
        "<accessKeyId>",     //设置AccessKey ID
        "<accessKeySecret>") //设置AccessKey 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)
}

• acs-plugin-manager --exec --plugin app-snapshot-plugin-win：表示执行云助手插件app-snapshot-plugin-win。
• --params=表示插件的配置参数，具体参数说明，如下表所示。

  参数	类型	是否必传	描述
  ExcludeDiskId	String	否	ECS实例中不需要创建快照的云盘。
  InstantAccess	Boolean	否	是否开启快照极速可用功能。取值如下： true：开启 false：关闭
  InstantAccessRentationDays	Integer	否	快照极速可用功能保留天数，到期后自动关闭。 取值范围：1~65536。默认值：1
  Name	String	是	快照一致性组名称。
  Description	String	否	快照一致性组描述信息。
  RamRoleName	String	是	ECS实例绑定的RAM角色，取值请参见步骤一：为ECS实例配置RAM角色。
  EnableWriters	Boolen	否	是否设置应用一致性快照。取值如下： true：创建应用一致性快照 false：创建文件系统一致性快照 默认值为true。

package main

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

func main() {
    client, err := ecs.NewClientWithAccessKey(
        "cn-hangzhou",    //设置实例所在地域
        "<accessKeyId>",  //设置AccessKey ID
        "<accessKeySecret>") //设置AccessKey Secret

    //通过DescribeInvocationResults查询结果
    request := ecs.CreateDescribeInvocationResultsRequest()
    request.Scheme = "https"

    request.InvokeId = "t-hz01qsegaxi****"        //命令执行ID，可在上一步骤的执行结果中查看。
    request.InstanceId = "i-bp17r83nppqf141v****" //实例ID
    request.CommandId = "c-hz01qsegaxd****"       //命令ID，可在上一步骤的执行结果中查看。

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

• ExitCode返回错误码信息，取值为0表示执行成功；如果取值不为0，请根据错误码信息排查问题。更多信息，请参见错误码信息。
• Output为命令执行后的输出信息，内容通过Base64编码。
  如果执行成功，Output内容经过Base64解码后会包含创建的快照一致性组ID，如下所示。

  [snapshotgroup="ssg-bp170v57ca9j01jb****"][message="Finish whole Processes of Snapshot successfully"]