Create application-consistent snapshots by using ECS SDK for Go

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

func main() {
    client, err := ecs.NewClientWithAccessKey(
        "cn-hangzhou",       //Specify the region ID of the instance.
        "<accessKeyId>",     //Specify your AccessKey ID.
        "<accessKeySecret>") //Specify your AccessKey secret.

    //Call the AttachInstanceRamRole operation to attach the specified RAM role to the instance.
    request := ecs.CreateAttachInstanceRamRoleRequest()
    request.Scheme = "https"

    request.RamRoleName = "AppSnapshotRoleName"          //Specify the name of the RAM role.
    request.InstanceIds = "[\"i-bp17r83nppqf141v****\"]" //Specify the ID of the instance.

    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",    //Specify the region ID of the instance.
        "<accessKeyId>",  //Specify your AccessKey ID.
        "<accessKeySecret>") //Specify your AccessKey secret.

    //Call the RunCommand operation to create file system-consistent snapshots for the instance. 
    request := ecs.CreateRunCommandRequest()
    request.Scheme = "https"

    request.Type = "RunShellScript"
    //For information about the command used to create file system-consistent snapshots, see 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****"} //Specify the ID of the instance.

    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 indicates the app-snapshot-plugin plug-in used to run Cloud Assistant commands.
• --params= indicates the configuration parameters of the plug-in. The following table describes these parameters.

  Parameter	Type	Required	Description
  ExcludeDiskId	String	No	The disks to exclude from the snapshots.
  InstantAccess	Boolean	No	Specifies whether to enable the instant access feature. Valid values: true: enables the instant access feature. false: disables the instant access feature.
  InstantAccessRentationDays	Integer	No	The number of days for which the instant access feature remains enabled. The instant access feature is automatically disabled when the specified duration ends. Valid values: 1 to 65536. Default: 1.
  Name	String	Yes	The name of the snapshot-consistent group.
  Description	String	No	The description of the snapshot-consistent group.
  RamRoleName	String	Yes	The RAM role attached to the instance. For more information, see Step 1: Configure a RAM role for the ECS instance.
  PreScriptPath	String	No	The path of the application pre-freeze script (tmp/prescript.sh). The prescript.sh script must meet the following conditions: Only the root user is granted read, write, and execute permissions (chmod 700) on the script as the owner. You must customize the script based on your application. Note To create application-consistent snapshots for Linux instances, you must specify this parameter. If script configurations such as permissions, save path, or file name are invalid, file system-consistent snapshots are created.
  PostScriptPath	String	No	The path of the application post-thaw script (/tmp/postscript.sh). The postscript.sh script must meet the following conditions: Only the root user is granted read, write, and execute permissions (chmod 700) on the script as the owner. You must customize the script based on your application. Note To create application-consistent snapshots for Linux instances, you must specify this parameter. If script configurations such as permissions, save path, or file name are invalid, file system-consistent snapshots are created.
  EnableFsFreeze	Boolean	No	Specifies whether to enable Linux fsfreeze to put file systems into the read-only state before you create snapshots. Default value: True.
  TimeoutInSeconds	Integer	No	The I/O freeze timeout period. Default value: 30. Unit: seconds.
  ScriptTimeoutInSeconds	Integer	No	The timeout period for script execution. Default value: 1800. Unit: seconds.

package main

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

func main() {
    client, err := ecs.NewClientWithAccessKey(
        "cn-hangzhou",       //Specify the region ID of the instance.
        "<accessKeyId>",     //Specify your AccessKey ID.
        "<accessKeySecret>") //Specify your AccessKey secret.

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

    request.Type = "RunBatScript"
    //For information about the command used to create application-consistent snapshots, see 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****"} //Specify the ID of the instance.
    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 indicates the app-snapshot-plugin-win plug-in used to run Cloud Assistant commands.
• --params= indicates the configuration parameters of the plug-in. The following table describes these parameters.

  Parameter	Type	Required	Description
  ExcludeDiskId	String	No	The disks to exclude from the snapshots.
  InstantAccess	Boolean	No	Specifies whether to enable the instant access feature. Valid values: true: enables the instant access feature. false: disables the instant access feature.
  InstantAccessRentationDays	Integer	No	The number of days for which the instant access feature remains enabled. The instant access feature is automatically disabled when the specified duration ends. Valid values: 1 to 65536. Default: 1.
  Name	String	Yes	The name of the snapshot-consistent group.
  Description	String	No	The description of the snapshot-consistent group.
  RamRoleName	String	Yes	The RAM role attached to the instance. For more information, see Step 1: Configure a RAM role for the ECS instance.
  EnableWriters	Boolen	No	Specifies whether to create application-consistent snapshots. Valid values: true: creates application-consistent snapshots. false: creates file system-consistent snapshots. Default value: true.

package main

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

func main() {
    client, err := ecs.NewClientWithAccessKey(
        "cn-hangzhou",    //Specify the region ID of the instance.
        "<accessKeyId>",  //Specify your AccessKey ID.
        "<accessKeySecret>") //Specify your AccessKey secret.

    //Call the DescribeInvocationResults operation to check whether snapshots are created.
    request := ecs.CreateDescribeInvocationResultsRequest()
    request.Scheme = "https"

    request.InvokeId = "t-hz01qsegaxi****"        //The execution ID of the command. You can obtain the execution ID in the response in Step 2. 
    request.InstanceId = "i-bp17r83nppqf141v****" //The instance ID.
    request.CommandId = "c-hz01qsegaxd****"       //The command ID. You can obtain the command ID in the response in Step 2. 

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

• ExitCode indicates the error code. A value of 0 indicates that command was run in a proper manner. A numeric value other than 0 indicates that an error has occurred. Troubleshoot the error based on the returned error code. For more information, see Error codes.
• Output indicates the command output, which is Base64-encoded.
  If the command is run in a proper manner, the content of Output is Base64-encoded and contains the ID of the created snapshot-consistent group, as shown in the following example.

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