Elastic Compute Service:Create application-consistent snapshots

Sample code of Alibaba Cloud SDK for Go:

package main

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

func main() {
		// Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables are configured in the code runtime. 
    // If the project code is leaked, the AccessKey pair may be leaked and the security of all resources in your account is compromised. The following sample code shows how to use environment variables to obtain an AccessKey pair and use the AccessKey pair to call API operations. We recommend that you use STS tokens, which provide higher security. 
    client, err := ecs.NewClientWithAccessKey(
        "cn-hangzhou",    // Specify the region in which the instance resides.
        os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),     
        os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))

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

    request.Type = "RunShellScript"
    // Specify the command content used to create application-consistent snapshots. For more information, see the following description of the CommandContent parameter. 
    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****"} // 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)
}

Description of the CommandContent parameter:

• acs-plugin-manager --exec --plugin app-snapshot-plugin: runs the app-snapshot-plugin Cloud Assistant plug-in.

• --params=: the parameters of the plug-in. The following table describes the parameters.

  Parameter	Type	Required	Description
  ExcludeDiskId	String	No	The disks to exclude from the snapshots.
  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 information about the name of the RAM role, see the Step 1: Configure a RAM role and attach it to the ECS instance section of this topic.
  PreScriptPath	String	No	The path in which the prescript.sh script is stored. Example: /tmp/prescript.sh. The prescript.sh script must meet the following requirements: Only the root user is granted the read, write, and execute permissions (chmod 700) on the script as the owner. Compile the custom script content based on your business requirements. Important This parameter is required when you create application-consistent snapshots for Linux instances. If the script contains invalid settings, such as permissions, paths, or file names, file system-consistent snapshots instead of application-consistent snapshots are created.
  PostScriptPath	String	No	The path in which the postscript.sh script is stored. Example: /tmp/postscript.sh. The postscript.sh script must meet the following requirements: Only the root user is granted the read, write, and execute permissions (chmod 700) on the script as the owner. Compile the custom script based on your business requirements. Important This parameter is required when you create application-consistent snapshots for Linux instances. If the script contains invalid settings, such as permissions, paths, or file names, file system-consistent snapshots instead of application-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 timeout period for I/O operations. Default value: 30. Unit: seconds.
  ScriptTimeoutInSeconds	Integer	No	The timeout period for script execution. Default value: 1800. Unit: seconds.

A response similar to the following one is returned. For information about the parameters in the response, see RunCommand.

Sample code of Alibaba Cloud SDK for Go:

package main

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

func main() {
    // Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables are configured in the code runtime. 
    // If the project code is leaked, the AccessKey pair may be leaked and the security of all resources in your account is compromised. The following sample code provides an example on how to use environment variables to obtain an AccessKey pair and use the AccessKey pair to call API operations. We recommend that you use STS tokens, which provide higher security. 
    client, err := ecs.NewClientWithAccessKey(
        "cn-hangzhou",       // Specify the region in which the instance resides.
        os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),     
        os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))

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

    request.Type = "RunBatScript"
    // Specify the command content used to create application-consistent snapshots. For more information, see the following description of the CommandContent parameter. 
    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****"} // 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)
}