Updated on 2024-04-18 GMT+08:00

Querying Snapshot Details

Function

This API is used to query snapshot details using snapshot IDs.

Call Method

For details, see Calling APIs.

URI

GET /v1.0/{project_id}/snapshots/{snapshot_id}
Table 1 URI parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details about how to obtain the ID, see Obtaining Project ID.

snapshot_id

Yes

String

Snapshot ID.

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

snapshot

SnapshotDetail object

Snapshot detail parameters

Table 3 SnapshotDetail

Parameter

Type

Description

id

String

Snapshot ID

name

String

Snapshot name

description

String

Snapshot description

started

String

Time when a snapshot starts to be created. Format: ISO8601: YYYY-MM-DDThh:mm:ssZ

finished

String

Time when a snapshot is complete. Format: ISO8601: YYYY-MM-DDThh:mm:ssZ

size

Double

Snapshot size, in GB

status

String

Snapshot status:

  • CREATING

  • AVAILABLE

  • UNAVAILABLE

type

String

Snapshot type

  • MANUAL
  • AUTOMATED

cluster_id

String

ID of the cluster for which the snapshot is created

cluster_name

String

Name of the cluster for which the snapshot is created

backup_key

String

Key generated during backup.

prior_backup_key

String

Backup key of the previous snapshot used by the incremental backup The value FULL indicates a full snapshot.

base_backup_key

String

Backup key of a full snapshot

backup_device

String

Backup media

total_backup_size

Long

Accumulated size of a snapshot, from the full backup to the incremental backup. Unit: KB

base_backup_name

String

Name of a full snapshot

support_inplace_restore

Boolean

Whether data can be restored to the original cluster

fine_grained_backup

Boolean

Whether the backup is a fine-grained backup

fine_grained_backup_detail

FineGrainedSnapshotDetail object

Fine-grained backup information

guest_agent_version

String

GuestAgent version

cluster_status

String

Cluster status

  • AVAILABLE

  • UNAVAILABLE

  • FROZEN

bak_expected_start_time

String

Estimated snapshot start time

bak_keep_day

Integer

Backup retention days

bak_period

String

Cluster policy

db_user

String

Backup user

datastore

DataStore object

Database version

progress

String

Backup progress

backup_level

String

Backup level

  • cluster
  • schema
Table 4 FineGrainedSnapshotDetail

Parameter

Type

Description

database

String

Database backup

schema_list

Array of String

Backup schema set

table_list

Array of String

Backup table set

Table 5 DataStore

Parameter

Type

Description

type

String

Database type

version

String

Database version

Example Request

GET https://{Endpoint}/v1.0/89cd04f168b84af6be287f71730fdb4b/snapshots/b5c45780-1006-49e3-b2d5-b3229975bbc7

Example Response

Status code: 200

The snapshot details are queried successfully.

{
  "snapshot" : {
    "id" : "2a4d0f86-67cd-408a-8b66-017454fb7793",
    "name" : "snapshot-1",
    "description" : "snapshot description",
    "started" : "2016-08-23T03:59:23Z",
    "finished" : "2016-08-23T04:01:40Z",
    "size" : 500,
    "status" : "AVAILABLE",
    "type" : "MANUAL",
    "cluster_id" : "4f87d3c4-9e33-482f-b962-e23b30d1a18c"
  }
}

SDK Sample Code

The sample code is as follows:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.dws.v2.region.DwsRegion;
import com.huaweicloud.sdk.dws.v2.*;
import com.huaweicloud.sdk.dws.v2.model.*;


public class ListSnapshotDetailsSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");

        ICredential auth = new BasicCredentials()
                .withAk(ak)
                .withSk(sk);

        DwsClient client = DwsClient.newBuilder()
                .withCredential(auth)
                .withRegion(DwsRegion.valueOf("cn-north-4"))
                .build();
        ListSnapshotDetailsRequest request = new ListSnapshotDetailsRequest();
        try {
            ListSnapshotDetailsResponse response = client.listSnapshotDetails(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# coding: utf-8

from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkdws.v2.region.dws_region import DwsRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkdws.v2 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.getenv("CLOUD_SDK_AK")
    sk = os.getenv("CLOUD_SDK_SK")

    credentials = BasicCredentials(ak, sk) \

    client = DwsClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(DwsRegion.value_of("cn-north-4")) \
        .build()

    try:
        request = ListSnapshotDetailsRequest()
        response = client.list_snapshot_details(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    dws "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dws/v2"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dws/v2/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dws/v2/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        Build()

    client := dws.NewDwsClient(
        dws.DwsClientBuilder().
            WithRegion(region.ValueOf("cn-north-4")).
            WithCredential(auth).
            Build())

    request := &model.ListSnapshotDetailsRequest{}
	response, err := client.ListSnapshotDetails(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

For more SDK sample codes of programming languages, visit API Explorer and click the Sample Code tab. Example codes can be automatically generated.

Status Code

Status Code

Description

200

The snapshot details are queried successfully.

400

Request error.

401

Authentication failed.

403

You do not have required permissions.

404

No resources found.

500

Internal server error.

503

The service was unavailable.