Elastic Compute Service:Create application-consistent snapshots

Sample code of 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 ID of the instance.
        os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),     
        os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))

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

    request.Type = "RunShellScript"
    // You can view the command used to create file system-consistent snapshots in the CommandContent value. 
    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)
}

Components of the CommandContent value:

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

• --params= indicates 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.
  InstantAccess	Boolean	No	Specifies whether to enable the instant access feature. Valid values: true false Note Starting 11:00 on October 12, 2023, the instant access feature is upgraded. New snapshots of ESSDs at performance levels 0, 1, 2, and 3 and ESSD AutoPL disks are immediately available after creation without the need for additional configurations. For more information, see Use 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 value: 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 the Step 1: Configure a RAM role for an ECS instance section of this topic.
  PreScriptPath	String	No	The path of the application pre-freeze script (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. The script is customized based on your application. Note To create application-consistent snapshots for Linux instances, specify this parameter. If script configurations such as the permissions, storage 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 requirements: Only the root user is granted the read, write, and execute permissions (chmod 700) on the script as the owner. The script is customized based on your application. Note To create application-consistent snapshots for Linux instances, specify this parameter. If script configurations such as the permissions, storage 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.

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

Sample code of 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 ID of the instance.
        os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),     
        os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))

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

    request.Type = "RunBatScript"
    // You can view the command used to create application-consistent snapshots in the CommandContent value. 
    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)
}