1package mysql
2
3// Copyright (c) Microsoft and contributors.  All rights reserved.
4//
5// Licensed under the Apache License, Version 2.0 (the "License");
6// you may not use this file except in compliance with the License.
7// You may obtain a copy of the License at
8// http://www.apache.org/licenses/LICENSE-2.0
9//
10// Unless required by applicable law or agreed to in writing, software
11// distributed under the License is distributed on an "AS IS" BASIS,
12// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13//
14// See the License for the specific language governing permissions and
15// limitations under the License.
16//
17// Code generated by Microsoft (R) AutoRest Code Generator.
18// Changes may cause incorrect behavior and will be lost if the code is regenerated.
19
20import (
21	"context"
22	"github.com/Azure/go-autorest/autorest"
23	"github.com/Azure/go-autorest/autorest/azure"
24	"github.com/Azure/go-autorest/autorest/validation"
25	"github.com/Azure/go-autorest/tracing"
26	"net/http"
27)
28
29// AdvisorsClient is the the Microsoft Azure management API provides create, read, update, and delete functionality for
30// Azure MySQL resources including servers, databases, firewall rules, VNET rules, log files and configurations with
31// new business model.
32type AdvisorsClient struct {
33	BaseClient
34}
35
36// NewAdvisorsClient creates an instance of the AdvisorsClient client.
37func NewAdvisorsClient(subscriptionID string) AdvisorsClient {
38	return NewAdvisorsClientWithBaseURI(DefaultBaseURI, subscriptionID)
39}
40
41// NewAdvisorsClientWithBaseURI creates an instance of the AdvisorsClient client using a custom endpoint.  Use this
42// when interacting with an Azure cloud that uses a non-standard base URI (sovereign clouds, Azure stack).
43func NewAdvisorsClientWithBaseURI(baseURI string, subscriptionID string) AdvisorsClient {
44	return AdvisorsClient{NewWithBaseURI(baseURI, subscriptionID)}
45}
46
47// Get get a recommendation action advisor.
48// Parameters:
49// resourceGroupName - the name of the resource group. The name is case insensitive.
50// serverName - the name of the server.
51// advisorName - the advisor name for recommendation action.
52func (client AdvisorsClient) Get(ctx context.Context, resourceGroupName string, serverName string, advisorName string) (result Advisor, err error) {
53	if tracing.IsEnabled() {
54		ctx = tracing.StartSpan(ctx, fqdn+"/AdvisorsClient.Get")
55		defer func() {
56			sc := -1
57			if result.Response.Response != nil {
58				sc = result.Response.Response.StatusCode
59			}
60			tracing.EndSpan(ctx, sc, err)
61		}()
62	}
63	if err := validation.Validate([]validation.Validation{
64		{TargetValue: client.SubscriptionID,
65			Constraints: []validation.Constraint{{Target: "client.SubscriptionID", Name: validation.MinLength, Rule: 1, Chain: nil}}},
66		{TargetValue: resourceGroupName,
67			Constraints: []validation.Constraint{{Target: "resourceGroupName", Name: validation.MaxLength, Rule: 90, Chain: nil},
68				{Target: "resourceGroupName", Name: validation.MinLength, Rule: 1, Chain: nil},
69				{Target: "resourceGroupName", Name: validation.Pattern, Rule: `^[-\w\._\(\)]+$`, Chain: nil}}}}); err != nil {
70		return result, validation.NewError("mysql.AdvisorsClient", "Get", err.Error())
71	}
72
73	req, err := client.GetPreparer(ctx, resourceGroupName, serverName, advisorName)
74	if err != nil {
75		err = autorest.NewErrorWithError(err, "mysql.AdvisorsClient", "Get", nil, "Failure preparing request")
76		return
77	}
78
79	resp, err := client.GetSender(req)
80	if err != nil {
81		result.Response = autorest.Response{Response: resp}
82		err = autorest.NewErrorWithError(err, "mysql.AdvisorsClient", "Get", resp, "Failure sending request")
83		return
84	}
85
86	result, err = client.GetResponder(resp)
87	if err != nil {
88		err = autorest.NewErrorWithError(err, "mysql.AdvisorsClient", "Get", resp, "Failure responding to request")
89		return
90	}
91
92	return
93}
94
95// GetPreparer prepares the Get request.
96func (client AdvisorsClient) GetPreparer(ctx context.Context, resourceGroupName string, serverName string, advisorName string) (*http.Request, error) {
97	pathParameters := map[string]interface{}{
98		"advisorName":       autorest.Encode("path", advisorName),
99		"resourceGroupName": autorest.Encode("path", resourceGroupName),
100		"serverName":        autorest.Encode("path", serverName),
101		"subscriptionId":    autorest.Encode("path", client.SubscriptionID),
102	}
103
104	const APIVersion = "2018-06-01"
105	queryParameters := map[string]interface{}{
106		"api-version": APIVersion,
107	}
108
109	preparer := autorest.CreatePreparer(
110		autorest.AsGet(),
111		autorest.WithBaseURL(client.BaseURI),
112		autorest.WithPathParameters("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMySQL/servers/{serverName}/advisors/{advisorName}", pathParameters),
113		autorest.WithQueryParameters(queryParameters))
114	return preparer.Prepare((&http.Request{}).WithContext(ctx))
115}
116
117// GetSender sends the Get request. The method will close the
118// http.Response Body if it receives an error.
119func (client AdvisorsClient) GetSender(req *http.Request) (*http.Response, error) {
120	return client.Send(req, azure.DoRetryWithRegistration(client.Client))
121}
122
123// GetResponder handles the response to the Get request. The method always
124// closes the http.Response Body.
125func (client AdvisorsClient) GetResponder(resp *http.Response) (result Advisor, err error) {
126	err = autorest.Respond(
127		resp,
128		azure.WithErrorUnlessStatusCode(http.StatusOK),
129		autorest.ByUnmarshallingJSON(&result),
130		autorest.ByClosing())
131	result.Response = autorest.Response{Response: resp}
132	return
133}
134
135// ListByServer list recommendation action advisors.
136// Parameters:
137// resourceGroupName - the name of the resource group. The name is case insensitive.
138// serverName - the name of the server.
139func (client AdvisorsClient) ListByServer(ctx context.Context, resourceGroupName string, serverName string) (result AdvisorsResultListPage, err error) {
140	if tracing.IsEnabled() {
141		ctx = tracing.StartSpan(ctx, fqdn+"/AdvisorsClient.ListByServer")
142		defer func() {
143			sc := -1
144			if result.arl.Response.Response != nil {
145				sc = result.arl.Response.Response.StatusCode
146			}
147			tracing.EndSpan(ctx, sc, err)
148		}()
149	}
150	if err := validation.Validate([]validation.Validation{
151		{TargetValue: client.SubscriptionID,
152			Constraints: []validation.Constraint{{Target: "client.SubscriptionID", Name: validation.MinLength, Rule: 1, Chain: nil}}},
153		{TargetValue: resourceGroupName,
154			Constraints: []validation.Constraint{{Target: "resourceGroupName", Name: validation.MaxLength, Rule: 90, Chain: nil},
155				{Target: "resourceGroupName", Name: validation.MinLength, Rule: 1, Chain: nil},
156				{Target: "resourceGroupName", Name: validation.Pattern, Rule: `^[-\w\._\(\)]+$`, Chain: nil}}}}); err != nil {
157		return result, validation.NewError("mysql.AdvisorsClient", "ListByServer", err.Error())
158	}
159
160	result.fn = client.listByServerNextResults
161	req, err := client.ListByServerPreparer(ctx, resourceGroupName, serverName)
162	if err != nil {
163		err = autorest.NewErrorWithError(err, "mysql.AdvisorsClient", "ListByServer", nil, "Failure preparing request")
164		return
165	}
166
167	resp, err := client.ListByServerSender(req)
168	if err != nil {
169		result.arl.Response = autorest.Response{Response: resp}
170		err = autorest.NewErrorWithError(err, "mysql.AdvisorsClient", "ListByServer", resp, "Failure sending request")
171		return
172	}
173
174	result.arl, err = client.ListByServerResponder(resp)
175	if err != nil {
176		err = autorest.NewErrorWithError(err, "mysql.AdvisorsClient", "ListByServer", resp, "Failure responding to request")
177		return
178	}
179	if result.arl.hasNextLink() && result.arl.IsEmpty() {
180		err = result.NextWithContext(ctx)
181		return
182	}
183
184	return
185}
186
187// ListByServerPreparer prepares the ListByServer request.
188func (client AdvisorsClient) ListByServerPreparer(ctx context.Context, resourceGroupName string, serverName string) (*http.Request, error) {
189	pathParameters := map[string]interface{}{
190		"resourceGroupName": autorest.Encode("path", resourceGroupName),
191		"serverName":        autorest.Encode("path", serverName),
192		"subscriptionId":    autorest.Encode("path", client.SubscriptionID),
193	}
194
195	const APIVersion = "2018-06-01"
196	queryParameters := map[string]interface{}{
197		"api-version": APIVersion,
198	}
199
200	preparer := autorest.CreatePreparer(
201		autorest.AsGet(),
202		autorest.WithBaseURL(client.BaseURI),
203		autorest.WithPathParameters("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMySQL/servers/{serverName}/advisors", pathParameters),
204		autorest.WithQueryParameters(queryParameters))
205	return preparer.Prepare((&http.Request{}).WithContext(ctx))
206}
207
208// ListByServerSender sends the ListByServer request. The method will close the
209// http.Response Body if it receives an error.
210func (client AdvisorsClient) ListByServerSender(req *http.Request) (*http.Response, error) {
211	return client.Send(req, azure.DoRetryWithRegistration(client.Client))
212}
213
214// ListByServerResponder handles the response to the ListByServer request. The method always
215// closes the http.Response Body.
216func (client AdvisorsClient) ListByServerResponder(resp *http.Response) (result AdvisorsResultList, err error) {
217	err = autorest.Respond(
218		resp,
219		azure.WithErrorUnlessStatusCode(http.StatusOK),
220		autorest.ByUnmarshallingJSON(&result),
221		autorest.ByClosing())
222	result.Response = autorest.Response{Response: resp}
223	return
224}
225
226// listByServerNextResults retrieves the next set of results, if any.
227func (client AdvisorsClient) listByServerNextResults(ctx context.Context, lastResults AdvisorsResultList) (result AdvisorsResultList, err error) {
228	req, err := lastResults.advisorsResultListPreparer(ctx)
229	if err != nil {
230		return result, autorest.NewErrorWithError(err, "mysql.AdvisorsClient", "listByServerNextResults", nil, "Failure preparing next results request")
231	}
232	if req == nil {
233		return
234	}
235	resp, err := client.ListByServerSender(req)
236	if err != nil {
237		result.Response = autorest.Response{Response: resp}
238		return result, autorest.NewErrorWithError(err, "mysql.AdvisorsClient", "listByServerNextResults", resp, "Failure sending next results request")
239	}
240	result, err = client.ListByServerResponder(resp)
241	if err != nil {
242		err = autorest.NewErrorWithError(err, "mysql.AdvisorsClient", "listByServerNextResults", resp, "Failure responding to next results request")
243	}
244	return
245}
246
247// ListByServerComplete enumerates all values, automatically crossing page boundaries as required.
248func (client AdvisorsClient) ListByServerComplete(ctx context.Context, resourceGroupName string, serverName string) (result AdvisorsResultListIterator, err error) {
249	if tracing.IsEnabled() {
250		ctx = tracing.StartSpan(ctx, fqdn+"/AdvisorsClient.ListByServer")
251		defer func() {
252			sc := -1
253			if result.Response().Response.Response != nil {
254				sc = result.page.Response().Response.Response.StatusCode
255			}
256			tracing.EndSpan(ctx, sc, err)
257		}()
258	}
259	result.page, err = client.ListByServer(ctx, resourceGroupName, serverName)
260	return
261}
262