1package ecs
2
3//Licensed under the Apache License, Version 2.0 (the "License");
4//you may not use this file except in compliance with the License.
5//You may obtain a copy of the License at
6//
7//http://www.apache.org/licenses/LICENSE-2.0
8//
9//Unless required by applicable law or agreed to in writing, software
10//distributed under the License is distributed on an "AS IS" BASIS,
11//WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12//See the License for the specific language governing permissions and
13//limitations under the License.
14//
15// Code generated by Alibaba Cloud SDK Code Generator.
16// Changes may cause incorrect behavior and will be lost if the code is regenerated.
17
18import (
19	"github.com/aliyun/alibaba-cloud-sdk-go/sdk/requests"
20	"github.com/aliyun/alibaba-cloud-sdk-go/sdk/responses"
21)
22
23// DescribeSnapshots invokes the ecs.DescribeSnapshots API synchronously
24// api document: https://help.aliyun.com/api/ecs/describesnapshots.html
25func (client *Client) DescribeSnapshots(request *DescribeSnapshotsRequest) (response *DescribeSnapshotsResponse, err error) {
26	response = CreateDescribeSnapshotsResponse()
27	err = client.DoAction(request, response)
28	return
29}
30
31// DescribeSnapshotsWithChan invokes the ecs.DescribeSnapshots API asynchronously
32// api document: https://help.aliyun.com/api/ecs/describesnapshots.html
33// asynchronous document: https://help.aliyun.com/document_detail/66220.html
34func (client *Client) DescribeSnapshotsWithChan(request *DescribeSnapshotsRequest) (<-chan *DescribeSnapshotsResponse, <-chan error) {
35	responseChan := make(chan *DescribeSnapshotsResponse, 1)
36	errChan := make(chan error, 1)
37	err := client.AddAsyncTask(func() {
38		defer close(responseChan)
39		defer close(errChan)
40		response, err := client.DescribeSnapshots(request)
41		if err != nil {
42			errChan <- err
43		} else {
44			responseChan <- response
45		}
46	})
47	if err != nil {
48		errChan <- err
49		close(responseChan)
50		close(errChan)
51	}
52	return responseChan, errChan
53}
54
55// DescribeSnapshotsWithCallback invokes the ecs.DescribeSnapshots API asynchronously
56// api document: https://help.aliyun.com/api/ecs/describesnapshots.html
57// asynchronous document: https://help.aliyun.com/document_detail/66220.html
58func (client *Client) DescribeSnapshotsWithCallback(request *DescribeSnapshotsRequest, callback func(response *DescribeSnapshotsResponse, err error)) <-chan int {
59	result := make(chan int, 1)
60	err := client.AddAsyncTask(func() {
61		var response *DescribeSnapshotsResponse
62		var err error
63		defer close(result)
64		response, err = client.DescribeSnapshots(request)
65		callback(response, err)
66		result <- 1
67	})
68	if err != nil {
69		defer close(result)
70		callback(nil, err)
71		result <- 0
72	}
73	return result
74}
75
76// DescribeSnapshotsRequest is the request struct for api DescribeSnapshots
77type DescribeSnapshotsRequest struct {
78	*requests.RpcRequest
79	ResourceOwnerId      requests.Integer        `position:"Query" name:"ResourceOwnerId"`
80	Filter2Value         string                  `position:"Query" name:"Filter.2.Value"`
81	SnapshotIds          string                  `position:"Query" name:"SnapshotIds"`
82	Usage                string                  `position:"Query" name:"Usage"`
83	SnapshotLinkId       string                  `position:"Query" name:"SnapshotLinkId"`
84	SnapshotName         string                  `position:"Query" name:"SnapshotName"`
85	PageNumber           requests.Integer        `position:"Query" name:"PageNumber"`
86	ResourceGroupId      string                  `position:"Query" name:"ResourceGroupId"`
87	Filter1Key           string                  `position:"Query" name:"Filter.1.Key"`
88	PageSize             requests.Integer        `position:"Query" name:"PageSize"`
89	DiskId               string                  `position:"Query" name:"DiskId"`
90	Tag                  *[]DescribeSnapshotsTag `position:"Query" name:"Tag"  type:"Repeated"`
91	DryRun               requests.Boolean        `position:"Query" name:"DryRun"`
92	ResourceOwnerAccount string                  `position:"Query" name:"ResourceOwnerAccount"`
93	OwnerAccount         string                  `position:"Query" name:"OwnerAccount"`
94	SourceDiskType       string                  `position:"Query" name:"SourceDiskType"`
95	Filter1Value         string                  `position:"Query" name:"Filter.1.Value"`
96	Filter2Key           string                  `position:"Query" name:"Filter.2.Key"`
97	OwnerId              requests.Integer        `position:"Query" name:"OwnerId"`
98	InstanceId           string                  `position:"Query" name:"InstanceId"`
99	Encrypted            requests.Boolean        `position:"Query" name:"Encrypted"`
100	SnapshotType         string                  `position:"Query" name:"SnapshotType"`
101	KMSKeyId             string                  `position:"Query" name:"KMSKeyId"`
102	Status               string                  `position:"Query" name:"Status"`
103}
104
105// DescribeSnapshotsTag is a repeated param struct in DescribeSnapshotsRequest
106type DescribeSnapshotsTag struct {
107	Value string `name:"Value"`
108	Key   string `name:"Key"`
109}
110
111// DescribeSnapshotsResponse is the response struct for api DescribeSnapshots
112type DescribeSnapshotsResponse struct {
113	*responses.BaseResponse
114	RequestId  string    `json:"RequestId" xml:"RequestId"`
115	TotalCount int       `json:"TotalCount" xml:"TotalCount"`
116	PageNumber int       `json:"PageNumber" xml:"PageNumber"`
117	PageSize   int       `json:"PageSize" xml:"PageSize"`
118	Snapshots  Snapshots `json:"Snapshots" xml:"Snapshots"`
119}
120
121// CreateDescribeSnapshotsRequest creates a request to invoke DescribeSnapshots API
122func CreateDescribeSnapshotsRequest() (request *DescribeSnapshotsRequest) {
123	request = &DescribeSnapshotsRequest{
124		RpcRequest: &requests.RpcRequest{},
125	}
126	request.InitWithApiInfo("Ecs", "2014-05-26", "DescribeSnapshots", "ecs", "openAPI")
127	return
128}
129
130// CreateDescribeSnapshotsResponse creates a response to parse from DescribeSnapshots response
131func CreateDescribeSnapshotsResponse() (response *DescribeSnapshotsResponse) {
132	response = &DescribeSnapshotsResponse{
133		BaseResponse: &responses.BaseResponse{},
134	}
135	return
136}
137