1package ram
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// ListGroups invokes the ram.ListGroups API synchronously
24// api document: https://help.aliyun.com/api/ram/listgroups.html
25func (client *Client) ListGroups(request *ListGroupsRequest) (response *ListGroupsResponse, err error) {
26	response = CreateListGroupsResponse()
27	err = client.DoAction(request, response)
28	return
29}
30
31// ListGroupsWithChan invokes the ram.ListGroups API asynchronously
32// api document: https://help.aliyun.com/api/ram/listgroups.html
33// asynchronous document: https://help.aliyun.com/document_detail/66220.html
34func (client *Client) ListGroupsWithChan(request *ListGroupsRequest) (<-chan *ListGroupsResponse, <-chan error) {
35	responseChan := make(chan *ListGroupsResponse, 1)
36	errChan := make(chan error, 1)
37	err := client.AddAsyncTask(func() {
38		defer close(responseChan)
39		defer close(errChan)
40		response, err := client.ListGroups(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// ListGroupsWithCallback invokes the ram.ListGroups API asynchronously
56// api document: https://help.aliyun.com/api/ram/listgroups.html
57// asynchronous document: https://help.aliyun.com/document_detail/66220.html
58func (client *Client) ListGroupsWithCallback(request *ListGroupsRequest, callback func(response *ListGroupsResponse, err error)) <-chan int {
59	result := make(chan int, 1)
60	err := client.AddAsyncTask(func() {
61		var response *ListGroupsResponse
62		var err error
63		defer close(result)
64		response, err = client.ListGroups(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// ListGroupsRequest is the request struct for api ListGroups
77type ListGroupsRequest struct {
78	*requests.RpcRequest
79	Marker   string           `position:"Query" name:"Marker"`
80	MaxItems requests.Integer `position:"Query" name:"MaxItems"`
81}
82
83// ListGroupsResponse is the response struct for api ListGroups
84type ListGroupsResponse struct {
85	*responses.BaseResponse
86	RequestId   string             `json:"RequestId" xml:"RequestId"`
87	IsTruncated bool               `json:"IsTruncated" xml:"IsTruncated"`
88	Marker      string             `json:"Marker" xml:"Marker"`
89	Groups      GroupsInListGroups `json:"Groups" xml:"Groups"`
90}
91
92// CreateListGroupsRequest creates a request to invoke ListGroups API
93func CreateListGroupsRequest() (request *ListGroupsRequest) {
94	request = &ListGroupsRequest{
95		RpcRequest: &requests.RpcRequest{},
96	}
97	request.InitWithApiInfo("Ram", "2015-05-01", "ListGroups", "", "")
98	return
99}
100
101// CreateListGroupsResponse creates a response to parse from ListGroups response
102func CreateListGroupsResponse() (response *ListGroupsResponse) {
103	response = &ListGroupsResponse{
104		BaseResponse: &responses.BaseResponse{},
105	}
106	return
107}
108