github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/network/armnetwork/v6@v6.2.0/expressroutecircuitpeerings_client.go (about) 1 //go:build go1.18 2 // +build go1.18 3 4 // Copyright (c) Microsoft Corporation. All rights reserved. 5 // Licensed under the MIT License. See License.txt in the project root for license information. 6 // Code generated by Microsoft (R) AutoRest Code Generator. DO NOT EDIT. 7 // Changes may cause incorrect behavior and will be lost if the code is regenerated. 8 9 package armnetwork 10 11 import ( 12 "context" 13 "errors" 14 "github.com/Azure/azure-sdk-for-go/sdk/azcore" 15 "github.com/Azure/azure-sdk-for-go/sdk/azcore/arm" 16 "github.com/Azure/azure-sdk-for-go/sdk/azcore/policy" 17 "github.com/Azure/azure-sdk-for-go/sdk/azcore/runtime" 18 "net/http" 19 "net/url" 20 "strings" 21 ) 22 23 // ExpressRouteCircuitPeeringsClient contains the methods for the ExpressRouteCircuitPeerings group. 24 // Don't use this type directly, use NewExpressRouteCircuitPeeringsClient() instead. 25 type ExpressRouteCircuitPeeringsClient struct { 26 internal *arm.Client 27 subscriptionID string 28 } 29 30 // NewExpressRouteCircuitPeeringsClient creates a new instance of ExpressRouteCircuitPeeringsClient with the specified values. 31 // - subscriptionID - The subscription credentials which uniquely identify the Microsoft Azure subscription. The subscription 32 // ID forms part of the URI for every service call. 33 // - credential - used to authorize requests. Usually a credential from azidentity. 34 // - options - pass nil to accept the default values. 35 func NewExpressRouteCircuitPeeringsClient(subscriptionID string, credential azcore.TokenCredential, options *arm.ClientOptions) (*ExpressRouteCircuitPeeringsClient, error) { 36 cl, err := arm.NewClient(moduleName, moduleVersion, credential, options) 37 if err != nil { 38 return nil, err 39 } 40 client := &ExpressRouteCircuitPeeringsClient{ 41 subscriptionID: subscriptionID, 42 internal: cl, 43 } 44 return client, nil 45 } 46 47 // BeginCreateOrUpdate - Creates or updates a peering in the specified express route circuits. 48 // If the operation fails it returns an *azcore.ResponseError type. 49 // 50 // Generated from API version 2024-05-01 51 // - resourceGroupName - The name of the resource group. 52 // - circuitName - The name of the express route circuit. 53 // - peeringName - The name of the peering. 54 // - peeringParameters - Parameters supplied to the create or update express route circuit peering operation. 55 // - options - ExpressRouteCircuitPeeringsClientBeginCreateOrUpdateOptions contains the optional parameters for the ExpressRouteCircuitPeeringsClient.BeginCreateOrUpdate 56 // method. 57 func (client *ExpressRouteCircuitPeeringsClient) BeginCreateOrUpdate(ctx context.Context, resourceGroupName string, circuitName string, peeringName string, peeringParameters ExpressRouteCircuitPeering, options *ExpressRouteCircuitPeeringsClientBeginCreateOrUpdateOptions) (*runtime.Poller[ExpressRouteCircuitPeeringsClientCreateOrUpdateResponse], error) { 58 if options == nil || options.ResumeToken == "" { 59 resp, err := client.createOrUpdate(ctx, resourceGroupName, circuitName, peeringName, peeringParameters, options) 60 if err != nil { 61 return nil, err 62 } 63 poller, err := runtime.NewPoller(resp, client.internal.Pipeline(), &runtime.NewPollerOptions[ExpressRouteCircuitPeeringsClientCreateOrUpdateResponse]{ 64 FinalStateVia: runtime.FinalStateViaAzureAsyncOp, 65 Tracer: client.internal.Tracer(), 66 }) 67 return poller, err 68 } else { 69 return runtime.NewPollerFromResumeToken(options.ResumeToken, client.internal.Pipeline(), &runtime.NewPollerFromResumeTokenOptions[ExpressRouteCircuitPeeringsClientCreateOrUpdateResponse]{ 70 Tracer: client.internal.Tracer(), 71 }) 72 } 73 } 74 75 // CreateOrUpdate - Creates or updates a peering in the specified express route circuits. 76 // If the operation fails it returns an *azcore.ResponseError type. 77 // 78 // Generated from API version 2024-05-01 79 func (client *ExpressRouteCircuitPeeringsClient) createOrUpdate(ctx context.Context, resourceGroupName string, circuitName string, peeringName string, peeringParameters ExpressRouteCircuitPeering, options *ExpressRouteCircuitPeeringsClientBeginCreateOrUpdateOptions) (*http.Response, error) { 80 var err error 81 const operationName = "ExpressRouteCircuitPeeringsClient.BeginCreateOrUpdate" 82 ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, operationName) 83 ctx, endSpan := runtime.StartSpan(ctx, operationName, client.internal.Tracer(), nil) 84 defer func() { endSpan(err) }() 85 req, err := client.createOrUpdateCreateRequest(ctx, resourceGroupName, circuitName, peeringName, peeringParameters, options) 86 if err != nil { 87 return nil, err 88 } 89 httpResp, err := client.internal.Pipeline().Do(req) 90 if err != nil { 91 return nil, err 92 } 93 if !runtime.HasStatusCode(httpResp, http.StatusOK, http.StatusCreated) { 94 err = runtime.NewResponseError(httpResp) 95 return nil, err 96 } 97 return httpResp, nil 98 } 99 100 // createOrUpdateCreateRequest creates the CreateOrUpdate request. 101 func (client *ExpressRouteCircuitPeeringsClient) createOrUpdateCreateRequest(ctx context.Context, resourceGroupName string, circuitName string, peeringName string, peeringParameters ExpressRouteCircuitPeering, options *ExpressRouteCircuitPeeringsClientBeginCreateOrUpdateOptions) (*policy.Request, error) { 102 urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits/{circuitName}/peerings/{peeringName}" 103 if resourceGroupName == "" { 104 return nil, errors.New("parameter resourceGroupName cannot be empty") 105 } 106 urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName)) 107 if circuitName == "" { 108 return nil, errors.New("parameter circuitName cannot be empty") 109 } 110 urlPath = strings.ReplaceAll(urlPath, "{circuitName}", url.PathEscape(circuitName)) 111 if peeringName == "" { 112 return nil, errors.New("parameter peeringName cannot be empty") 113 } 114 urlPath = strings.ReplaceAll(urlPath, "{peeringName}", url.PathEscape(peeringName)) 115 if client.subscriptionID == "" { 116 return nil, errors.New("parameter client.subscriptionID cannot be empty") 117 } 118 urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID)) 119 req, err := runtime.NewRequest(ctx, http.MethodPut, runtime.JoinPaths(client.internal.Endpoint(), urlPath)) 120 if err != nil { 121 return nil, err 122 } 123 reqQP := req.Raw().URL.Query() 124 reqQP.Set("api-version", "2024-05-01") 125 req.Raw().URL.RawQuery = reqQP.Encode() 126 req.Raw().Header["Accept"] = []string{"application/json"} 127 if err := runtime.MarshalAsJSON(req, peeringParameters); err != nil { 128 return nil, err 129 } 130 return req, nil 131 } 132 133 // BeginDelete - Deletes the specified peering from the specified express route circuit. 134 // If the operation fails it returns an *azcore.ResponseError type. 135 // 136 // Generated from API version 2024-05-01 137 // - resourceGroupName - The name of the resource group. 138 // - circuitName - The name of the express route circuit. 139 // - peeringName - The name of the peering. 140 // - options - ExpressRouteCircuitPeeringsClientBeginDeleteOptions contains the optional parameters for the ExpressRouteCircuitPeeringsClient.BeginDelete 141 // method. 142 func (client *ExpressRouteCircuitPeeringsClient) BeginDelete(ctx context.Context, resourceGroupName string, circuitName string, peeringName string, options *ExpressRouteCircuitPeeringsClientBeginDeleteOptions) (*runtime.Poller[ExpressRouteCircuitPeeringsClientDeleteResponse], error) { 143 if options == nil || options.ResumeToken == "" { 144 resp, err := client.deleteOperation(ctx, resourceGroupName, circuitName, peeringName, options) 145 if err != nil { 146 return nil, err 147 } 148 poller, err := runtime.NewPoller(resp, client.internal.Pipeline(), &runtime.NewPollerOptions[ExpressRouteCircuitPeeringsClientDeleteResponse]{ 149 FinalStateVia: runtime.FinalStateViaLocation, 150 Tracer: client.internal.Tracer(), 151 }) 152 return poller, err 153 } else { 154 return runtime.NewPollerFromResumeToken(options.ResumeToken, client.internal.Pipeline(), &runtime.NewPollerFromResumeTokenOptions[ExpressRouteCircuitPeeringsClientDeleteResponse]{ 155 Tracer: client.internal.Tracer(), 156 }) 157 } 158 } 159 160 // Delete - Deletes the specified peering from the specified express route circuit. 161 // If the operation fails it returns an *azcore.ResponseError type. 162 // 163 // Generated from API version 2024-05-01 164 func (client *ExpressRouteCircuitPeeringsClient) deleteOperation(ctx context.Context, resourceGroupName string, circuitName string, peeringName string, options *ExpressRouteCircuitPeeringsClientBeginDeleteOptions) (*http.Response, error) { 165 var err error 166 const operationName = "ExpressRouteCircuitPeeringsClient.BeginDelete" 167 ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, operationName) 168 ctx, endSpan := runtime.StartSpan(ctx, operationName, client.internal.Tracer(), nil) 169 defer func() { endSpan(err) }() 170 req, err := client.deleteCreateRequest(ctx, resourceGroupName, circuitName, peeringName, options) 171 if err != nil { 172 return nil, err 173 } 174 httpResp, err := client.internal.Pipeline().Do(req) 175 if err != nil { 176 return nil, err 177 } 178 if !runtime.HasStatusCode(httpResp, http.StatusOK, http.StatusAccepted, http.StatusNoContent) { 179 err = runtime.NewResponseError(httpResp) 180 return nil, err 181 } 182 return httpResp, nil 183 } 184 185 // deleteCreateRequest creates the Delete request. 186 func (client *ExpressRouteCircuitPeeringsClient) deleteCreateRequest(ctx context.Context, resourceGroupName string, circuitName string, peeringName string, options *ExpressRouteCircuitPeeringsClientBeginDeleteOptions) (*policy.Request, error) { 187 urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits/{circuitName}/peerings/{peeringName}" 188 if resourceGroupName == "" { 189 return nil, errors.New("parameter resourceGroupName cannot be empty") 190 } 191 urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName)) 192 if circuitName == "" { 193 return nil, errors.New("parameter circuitName cannot be empty") 194 } 195 urlPath = strings.ReplaceAll(urlPath, "{circuitName}", url.PathEscape(circuitName)) 196 if peeringName == "" { 197 return nil, errors.New("parameter peeringName cannot be empty") 198 } 199 urlPath = strings.ReplaceAll(urlPath, "{peeringName}", url.PathEscape(peeringName)) 200 if client.subscriptionID == "" { 201 return nil, errors.New("parameter client.subscriptionID cannot be empty") 202 } 203 urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID)) 204 req, err := runtime.NewRequest(ctx, http.MethodDelete, runtime.JoinPaths(client.internal.Endpoint(), urlPath)) 205 if err != nil { 206 return nil, err 207 } 208 reqQP := req.Raw().URL.Query() 209 reqQP.Set("api-version", "2024-05-01") 210 req.Raw().URL.RawQuery = reqQP.Encode() 211 req.Raw().Header["Accept"] = []string{"application/json"} 212 return req, nil 213 } 214 215 // Get - Gets the specified peering for the express route circuit. 216 // If the operation fails it returns an *azcore.ResponseError type. 217 // 218 // Generated from API version 2024-05-01 219 // - resourceGroupName - The name of the resource group. 220 // - circuitName - The name of the express route circuit. 221 // - peeringName - The name of the peering. 222 // - options - ExpressRouteCircuitPeeringsClientGetOptions contains the optional parameters for the ExpressRouteCircuitPeeringsClient.Get 223 // method. 224 func (client *ExpressRouteCircuitPeeringsClient) Get(ctx context.Context, resourceGroupName string, circuitName string, peeringName string, options *ExpressRouteCircuitPeeringsClientGetOptions) (ExpressRouteCircuitPeeringsClientGetResponse, error) { 225 var err error 226 const operationName = "ExpressRouteCircuitPeeringsClient.Get" 227 ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, operationName) 228 ctx, endSpan := runtime.StartSpan(ctx, operationName, client.internal.Tracer(), nil) 229 defer func() { endSpan(err) }() 230 req, err := client.getCreateRequest(ctx, resourceGroupName, circuitName, peeringName, options) 231 if err != nil { 232 return ExpressRouteCircuitPeeringsClientGetResponse{}, err 233 } 234 httpResp, err := client.internal.Pipeline().Do(req) 235 if err != nil { 236 return ExpressRouteCircuitPeeringsClientGetResponse{}, err 237 } 238 if !runtime.HasStatusCode(httpResp, http.StatusOK) { 239 err = runtime.NewResponseError(httpResp) 240 return ExpressRouteCircuitPeeringsClientGetResponse{}, err 241 } 242 resp, err := client.getHandleResponse(httpResp) 243 return resp, err 244 } 245 246 // getCreateRequest creates the Get request. 247 func (client *ExpressRouteCircuitPeeringsClient) getCreateRequest(ctx context.Context, resourceGroupName string, circuitName string, peeringName string, options *ExpressRouteCircuitPeeringsClientGetOptions) (*policy.Request, error) { 248 urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits/{circuitName}/peerings/{peeringName}" 249 if resourceGroupName == "" { 250 return nil, errors.New("parameter resourceGroupName cannot be empty") 251 } 252 urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName)) 253 if circuitName == "" { 254 return nil, errors.New("parameter circuitName cannot be empty") 255 } 256 urlPath = strings.ReplaceAll(urlPath, "{circuitName}", url.PathEscape(circuitName)) 257 if peeringName == "" { 258 return nil, errors.New("parameter peeringName cannot be empty") 259 } 260 urlPath = strings.ReplaceAll(urlPath, "{peeringName}", url.PathEscape(peeringName)) 261 if client.subscriptionID == "" { 262 return nil, errors.New("parameter client.subscriptionID cannot be empty") 263 } 264 urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID)) 265 req, err := runtime.NewRequest(ctx, http.MethodGet, runtime.JoinPaths(client.internal.Endpoint(), urlPath)) 266 if err != nil { 267 return nil, err 268 } 269 reqQP := req.Raw().URL.Query() 270 reqQP.Set("api-version", "2024-05-01") 271 req.Raw().URL.RawQuery = reqQP.Encode() 272 req.Raw().Header["Accept"] = []string{"application/json"} 273 return req, nil 274 } 275 276 // getHandleResponse handles the Get response. 277 func (client *ExpressRouteCircuitPeeringsClient) getHandleResponse(resp *http.Response) (ExpressRouteCircuitPeeringsClientGetResponse, error) { 278 result := ExpressRouteCircuitPeeringsClientGetResponse{} 279 if err := runtime.UnmarshalAsJSON(resp, &result.ExpressRouteCircuitPeering); err != nil { 280 return ExpressRouteCircuitPeeringsClientGetResponse{}, err 281 } 282 return result, nil 283 } 284 285 // NewListPager - Gets all peerings in a specified express route circuit. 286 // 287 // Generated from API version 2024-05-01 288 // - resourceGroupName - The name of the resource group. 289 // - circuitName - The name of the express route circuit. 290 // - options - ExpressRouteCircuitPeeringsClientListOptions contains the optional parameters for the ExpressRouteCircuitPeeringsClient.NewListPager 291 // method. 292 func (client *ExpressRouteCircuitPeeringsClient) NewListPager(resourceGroupName string, circuitName string, options *ExpressRouteCircuitPeeringsClientListOptions) *runtime.Pager[ExpressRouteCircuitPeeringsClientListResponse] { 293 return runtime.NewPager(runtime.PagingHandler[ExpressRouteCircuitPeeringsClientListResponse]{ 294 More: func(page ExpressRouteCircuitPeeringsClientListResponse) bool { 295 return page.NextLink != nil && len(*page.NextLink) > 0 296 }, 297 Fetcher: func(ctx context.Context, page *ExpressRouteCircuitPeeringsClientListResponse) (ExpressRouteCircuitPeeringsClientListResponse, error) { 298 ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, "ExpressRouteCircuitPeeringsClient.NewListPager") 299 nextLink := "" 300 if page != nil { 301 nextLink = *page.NextLink 302 } 303 resp, err := runtime.FetcherForNextLink(ctx, client.internal.Pipeline(), nextLink, func(ctx context.Context) (*policy.Request, error) { 304 return client.listCreateRequest(ctx, resourceGroupName, circuitName, options) 305 }, nil) 306 if err != nil { 307 return ExpressRouteCircuitPeeringsClientListResponse{}, err 308 } 309 return client.listHandleResponse(resp) 310 }, 311 Tracer: client.internal.Tracer(), 312 }) 313 } 314 315 // listCreateRequest creates the List request. 316 func (client *ExpressRouteCircuitPeeringsClient) listCreateRequest(ctx context.Context, resourceGroupName string, circuitName string, options *ExpressRouteCircuitPeeringsClientListOptions) (*policy.Request, error) { 317 urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits/{circuitName}/peerings" 318 if resourceGroupName == "" { 319 return nil, errors.New("parameter resourceGroupName cannot be empty") 320 } 321 urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName)) 322 if circuitName == "" { 323 return nil, errors.New("parameter circuitName cannot be empty") 324 } 325 urlPath = strings.ReplaceAll(urlPath, "{circuitName}", url.PathEscape(circuitName)) 326 if client.subscriptionID == "" { 327 return nil, errors.New("parameter client.subscriptionID cannot be empty") 328 } 329 urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID)) 330 req, err := runtime.NewRequest(ctx, http.MethodGet, runtime.JoinPaths(client.internal.Endpoint(), urlPath)) 331 if err != nil { 332 return nil, err 333 } 334 reqQP := req.Raw().URL.Query() 335 reqQP.Set("api-version", "2024-05-01") 336 req.Raw().URL.RawQuery = reqQP.Encode() 337 req.Raw().Header["Accept"] = []string{"application/json"} 338 return req, nil 339 } 340 341 // listHandleResponse handles the List response. 342 func (client *ExpressRouteCircuitPeeringsClient) listHandleResponse(resp *http.Response) (ExpressRouteCircuitPeeringsClientListResponse, error) { 343 result := ExpressRouteCircuitPeeringsClientListResponse{} 344 if err := runtime.UnmarshalAsJSON(resp, &result.ExpressRouteCircuitPeeringListResult); err != nil { 345 return ExpressRouteCircuitPeeringsClientListResponse{}, err 346 } 347 return result, nil 348 }