services/ecs/create_snapshot.go

package ecs

//Licensed under the Apache License, Version 2.0 (the "License");
//you may not use this file except in compliance with the License.
//You may obtain a copy of the License at
//
//http://www.apache.org/licenses/LICENSE-2.0
//
//Unless required by applicable law or agreed to in writing, software
//distributed under the License is distributed on an "AS IS" BASIS,
//WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
//See the License for the specific language governing permissions and
//limitations under the License.
//
// Code generated by Alibaba Cloud SDK Code Generator.
// Changes may cause incorrect behavior and will be lost if the code is regenerated.

import (
	"github.com/aliyun/alibaba-cloud-sdk-go/sdk/requests"
	"github.com/aliyun/alibaba-cloud-sdk-go/sdk/responses"
)

// CreateSnapshot invokes the ecs.CreateSnapshot API synchronously
func (client *Client) CreateSnapshot(request *CreateSnapshotRequest) (response *CreateSnapshotResponse, err error) {
	response = CreateCreateSnapshotResponse()
	err = client.DoAction(request, response)
	return
}

// CreateSnapshotWithChan invokes the ecs.CreateSnapshot API asynchronously
func (client *Client) CreateSnapshotWithChan(request *CreateSnapshotRequest) (<-chan *CreateSnapshotResponse, <-chan error) {
	responseChan := make(chan *CreateSnapshotResponse, 1)
	errChan := make(chan error, 1)
	err := client.AddAsyncTask(func() {
		defer close(responseChan)
		defer close(errChan)
		response, err := client.CreateSnapshot(request)
		if err != nil {
			errChan <- err
		} else {
			responseChan <- response
		}
	})
	if err != nil {
		errChan <- err
		close(responseChan)
		close(errChan)
	}
	return responseChan, errChan
}

// CreateSnapshotWithCallback invokes the ecs.CreateSnapshot API asynchronously
func (client *Client) CreateSnapshotWithCallback(request *CreateSnapshotRequest, callback func(response *CreateSnapshotResponse, err error)) <-chan int {
	result := make(chan int, 1)
	err := client.AddAsyncTask(func() {
		var response *CreateSnapshotResponse
		var err error
		defer close(result)
		response, err = client.CreateSnapshot(request)
		callback(response, err)
		result <- 1
	})
	if err != nil {
		defer close(result)
		callback(nil, err)
		result <- 0
	}
	return result
}

// CreateSnapshotRequest is the request struct for api CreateSnapshot
type CreateSnapshotRequest struct {
	*requests.RpcRequest
	ResourceOwnerId            requests.Integer           `position:"Query" name:"ResourceOwnerId"`
	ClientToken                string                     `position:"Query" name:"ClientToken"`
	InstantAccess              requests.Boolean           `position:"Query" name:"InstantAccess"`
	SystemTag                  *[]CreateSnapshotSystemTag `position:"Query" name:"SystemTag"  type:"Repeated"`
	Description                string                     `position:"Query" name:"Description"`
	SnapshotName               string                     `position:"Query" name:"SnapshotName"`
	ResourceGroupId            string                     `position:"Query" name:"ResourceGroupId"`
	InstantAccessRetentionDays requests.Integer           `position:"Query" name:"InstantAccessRetentionDays"`
	StorageLocationArn         string                     `position:"Query" name:"StorageLocationArn"`
	DiskId                     string                     `position:"Query" name:"DiskId"`
	Tag                        *[]CreateSnapshotTag       `position:"Query" name:"Tag"  type:"Repeated"`
	ResourceOwnerAccount       string                     `position:"Query" name:"ResourceOwnerAccount"`
	OwnerAccount               string                     `position:"Query" name:"OwnerAccount"`
	OwnerId                    requests.Integer           `position:"Query" name:"OwnerId"`
	RetentionDays              requests.Integer           `position:"Query" name:"RetentionDays"`
	Category                   string                     `position:"Query" name:"Category"`
}

// CreateSnapshotSystemTag is a repeated param struct in CreateSnapshotRequest
type CreateSnapshotSystemTag struct {
	Scope string `name:"Scope"`
	Value string `name:"Value"`
	Key   string `name:"Key"`
}

// CreateSnapshotTag is a repeated param struct in CreateSnapshotRequest
type CreateSnapshotTag struct {
	Value string `name:"Value"`
	Key   string `name:"Key"`
}

// CreateSnapshotResponse is the response struct for api CreateSnapshot
type CreateSnapshotResponse struct {
	*responses.BaseResponse
	SnapshotId string `json:"SnapshotId" xml:"SnapshotId"`
	RequestId  string `json:"RequestId" xml:"RequestId"`
}

// CreateCreateSnapshotRequest creates a request to invoke CreateSnapshot API
func CreateCreateSnapshotRequest() (request *CreateSnapshotRequest) {
	request = &CreateSnapshotRequest{
		RpcRequest: &requests.RpcRequest{},
	}
	request.InitWithApiInfo("Ecs", "2014-05-26", "CreateSnapshot", "ecs", "openAPI")
	request.Method = requests.POST
	return
}

// CreateCreateSnapshotResponse creates a response to parse from CreateSnapshot response
func CreateCreateSnapshotResponse() (response *CreateSnapshotResponse) {
	response = &CreateSnapshotResponse{
		BaseResponse: &responses.BaseResponse{},
	}
	return
}