github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/network/armnetwork/v6@v6.2.0/virtualrouters_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 // VirtualRoutersClient contains the methods for the VirtualRouters group. 24 // Don't use this type directly, use NewVirtualRoutersClient() instead. 25 type VirtualRoutersClient struct { 26 internal *arm.Client 27 subscriptionID string 28 } 29 30 // NewVirtualRoutersClient creates a new instance of VirtualRoutersClient 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 NewVirtualRoutersClient(subscriptionID string, credential azcore.TokenCredential, options *arm.ClientOptions) (*VirtualRoutersClient, error) { 36 cl, err := arm.NewClient(moduleName, moduleVersion, credential, options) 37 if err != nil { 38 return nil, err 39 } 40 client := &VirtualRoutersClient{ 41 subscriptionID: subscriptionID, 42 internal: cl, 43 } 44 return client, nil 45 } 46 47 // BeginCreateOrUpdate - Creates or updates the specified Virtual Router. 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 // - virtualRouterName - The name of the Virtual Router. 53 // - parameters - Parameters supplied to the create or update Virtual Router. 54 // - options - VirtualRoutersClientBeginCreateOrUpdateOptions contains the optional parameters for the VirtualRoutersClient.BeginCreateOrUpdate 55 // method. 56 func (client *VirtualRoutersClient) BeginCreateOrUpdate(ctx context.Context, resourceGroupName string, virtualRouterName string, parameters VirtualRouter, options *VirtualRoutersClientBeginCreateOrUpdateOptions) (*runtime.Poller[VirtualRoutersClientCreateOrUpdateResponse], error) { 57 if options == nil || options.ResumeToken == "" { 58 resp, err := client.createOrUpdate(ctx, resourceGroupName, virtualRouterName, parameters, options) 59 if err != nil { 60 return nil, err 61 } 62 poller, err := runtime.NewPoller(resp, client.internal.Pipeline(), &runtime.NewPollerOptions[VirtualRoutersClientCreateOrUpdateResponse]{ 63 FinalStateVia: runtime.FinalStateViaAzureAsyncOp, 64 Tracer: client.internal.Tracer(), 65 }) 66 return poller, err 67 } else { 68 return runtime.NewPollerFromResumeToken(options.ResumeToken, client.internal.Pipeline(), &runtime.NewPollerFromResumeTokenOptions[VirtualRoutersClientCreateOrUpdateResponse]{ 69 Tracer: client.internal.Tracer(), 70 }) 71 } 72 } 73 74 // CreateOrUpdate - Creates or updates the specified Virtual Router. 75 // If the operation fails it returns an *azcore.ResponseError type. 76 // 77 // Generated from API version 2024-05-01 78 func (client *VirtualRoutersClient) createOrUpdate(ctx context.Context, resourceGroupName string, virtualRouterName string, parameters VirtualRouter, options *VirtualRoutersClientBeginCreateOrUpdateOptions) (*http.Response, error) { 79 var err error 80 const operationName = "VirtualRoutersClient.BeginCreateOrUpdate" 81 ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, operationName) 82 ctx, endSpan := runtime.StartSpan(ctx, operationName, client.internal.Tracer(), nil) 83 defer func() { endSpan(err) }() 84 req, err := client.createOrUpdateCreateRequest(ctx, resourceGroupName, virtualRouterName, parameters, options) 85 if err != nil { 86 return nil, err 87 } 88 httpResp, err := client.internal.Pipeline().Do(req) 89 if err != nil { 90 return nil, err 91 } 92 if !runtime.HasStatusCode(httpResp, http.StatusOK, http.StatusCreated) { 93 err = runtime.NewResponseError(httpResp) 94 return nil, err 95 } 96 return httpResp, nil 97 } 98 99 // createOrUpdateCreateRequest creates the CreateOrUpdate request. 100 func (client *VirtualRoutersClient) createOrUpdateCreateRequest(ctx context.Context, resourceGroupName string, virtualRouterName string, parameters VirtualRouter, options *VirtualRoutersClientBeginCreateOrUpdateOptions) (*policy.Request, error) { 101 urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualRouters/{virtualRouterName}" 102 if resourceGroupName == "" { 103 return nil, errors.New("parameter resourceGroupName cannot be empty") 104 } 105 urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName)) 106 if virtualRouterName == "" { 107 return nil, errors.New("parameter virtualRouterName cannot be empty") 108 } 109 urlPath = strings.ReplaceAll(urlPath, "{virtualRouterName}", url.PathEscape(virtualRouterName)) 110 if client.subscriptionID == "" { 111 return nil, errors.New("parameter client.subscriptionID cannot be empty") 112 } 113 urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID)) 114 req, err := runtime.NewRequest(ctx, http.MethodPut, runtime.JoinPaths(client.internal.Endpoint(), urlPath)) 115 if err != nil { 116 return nil, err 117 } 118 reqQP := req.Raw().URL.Query() 119 reqQP.Set("api-version", "2024-05-01") 120 req.Raw().URL.RawQuery = reqQP.Encode() 121 req.Raw().Header["Accept"] = []string{"application/json"} 122 if err := runtime.MarshalAsJSON(req, parameters); err != nil { 123 return nil, err 124 } 125 return req, nil 126 } 127 128 // BeginDelete - Deletes the specified Virtual Router. 129 // If the operation fails it returns an *azcore.ResponseError type. 130 // 131 // Generated from API version 2024-05-01 132 // - resourceGroupName - The name of the resource group. 133 // - virtualRouterName - The name of the Virtual Router. 134 // - options - VirtualRoutersClientBeginDeleteOptions contains the optional parameters for the VirtualRoutersClient.BeginDelete 135 // method. 136 func (client *VirtualRoutersClient) BeginDelete(ctx context.Context, resourceGroupName string, virtualRouterName string, options *VirtualRoutersClientBeginDeleteOptions) (*runtime.Poller[VirtualRoutersClientDeleteResponse], error) { 137 if options == nil || options.ResumeToken == "" { 138 resp, err := client.deleteOperation(ctx, resourceGroupName, virtualRouterName, options) 139 if err != nil { 140 return nil, err 141 } 142 poller, err := runtime.NewPoller(resp, client.internal.Pipeline(), &runtime.NewPollerOptions[VirtualRoutersClientDeleteResponse]{ 143 FinalStateVia: runtime.FinalStateViaLocation, 144 Tracer: client.internal.Tracer(), 145 }) 146 return poller, err 147 } else { 148 return runtime.NewPollerFromResumeToken(options.ResumeToken, client.internal.Pipeline(), &runtime.NewPollerFromResumeTokenOptions[VirtualRoutersClientDeleteResponse]{ 149 Tracer: client.internal.Tracer(), 150 }) 151 } 152 } 153 154 // Delete - Deletes the specified Virtual Router. 155 // If the operation fails it returns an *azcore.ResponseError type. 156 // 157 // Generated from API version 2024-05-01 158 func (client *VirtualRoutersClient) deleteOperation(ctx context.Context, resourceGroupName string, virtualRouterName string, options *VirtualRoutersClientBeginDeleteOptions) (*http.Response, error) { 159 var err error 160 const operationName = "VirtualRoutersClient.BeginDelete" 161 ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, operationName) 162 ctx, endSpan := runtime.StartSpan(ctx, operationName, client.internal.Tracer(), nil) 163 defer func() { endSpan(err) }() 164 req, err := client.deleteCreateRequest(ctx, resourceGroupName, virtualRouterName, options) 165 if err != nil { 166 return nil, err 167 } 168 httpResp, err := client.internal.Pipeline().Do(req) 169 if err != nil { 170 return nil, err 171 } 172 if !runtime.HasStatusCode(httpResp, http.StatusOK, http.StatusAccepted, http.StatusNoContent) { 173 err = runtime.NewResponseError(httpResp) 174 return nil, err 175 } 176 return httpResp, nil 177 } 178 179 // deleteCreateRequest creates the Delete request. 180 func (client *VirtualRoutersClient) deleteCreateRequest(ctx context.Context, resourceGroupName string, virtualRouterName string, options *VirtualRoutersClientBeginDeleteOptions) (*policy.Request, error) { 181 urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualRouters/{virtualRouterName}" 182 if resourceGroupName == "" { 183 return nil, errors.New("parameter resourceGroupName cannot be empty") 184 } 185 urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName)) 186 if virtualRouterName == "" { 187 return nil, errors.New("parameter virtualRouterName cannot be empty") 188 } 189 urlPath = strings.ReplaceAll(urlPath, "{virtualRouterName}", url.PathEscape(virtualRouterName)) 190 if client.subscriptionID == "" { 191 return nil, errors.New("parameter client.subscriptionID cannot be empty") 192 } 193 urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID)) 194 req, err := runtime.NewRequest(ctx, http.MethodDelete, runtime.JoinPaths(client.internal.Endpoint(), urlPath)) 195 if err != nil { 196 return nil, err 197 } 198 reqQP := req.Raw().URL.Query() 199 reqQP.Set("api-version", "2024-05-01") 200 req.Raw().URL.RawQuery = reqQP.Encode() 201 req.Raw().Header["Accept"] = []string{"application/json"} 202 return req, nil 203 } 204 205 // Get - Gets the specified Virtual Router. 206 // If the operation fails it returns an *azcore.ResponseError type. 207 // 208 // Generated from API version 2024-05-01 209 // - resourceGroupName - The name of the resource group. 210 // - virtualRouterName - The name of the Virtual Router. 211 // - options - VirtualRoutersClientGetOptions contains the optional parameters for the VirtualRoutersClient.Get method. 212 func (client *VirtualRoutersClient) Get(ctx context.Context, resourceGroupName string, virtualRouterName string, options *VirtualRoutersClientGetOptions) (VirtualRoutersClientGetResponse, error) { 213 var err error 214 const operationName = "VirtualRoutersClient.Get" 215 ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, operationName) 216 ctx, endSpan := runtime.StartSpan(ctx, operationName, client.internal.Tracer(), nil) 217 defer func() { endSpan(err) }() 218 req, err := client.getCreateRequest(ctx, resourceGroupName, virtualRouterName, options) 219 if err != nil { 220 return VirtualRoutersClientGetResponse{}, err 221 } 222 httpResp, err := client.internal.Pipeline().Do(req) 223 if err != nil { 224 return VirtualRoutersClientGetResponse{}, err 225 } 226 if !runtime.HasStatusCode(httpResp, http.StatusOK) { 227 err = runtime.NewResponseError(httpResp) 228 return VirtualRoutersClientGetResponse{}, err 229 } 230 resp, err := client.getHandleResponse(httpResp) 231 return resp, err 232 } 233 234 // getCreateRequest creates the Get request. 235 func (client *VirtualRoutersClient) getCreateRequest(ctx context.Context, resourceGroupName string, virtualRouterName string, options *VirtualRoutersClientGetOptions) (*policy.Request, error) { 236 urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualRouters/{virtualRouterName}" 237 if resourceGroupName == "" { 238 return nil, errors.New("parameter resourceGroupName cannot be empty") 239 } 240 urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName)) 241 if virtualRouterName == "" { 242 return nil, errors.New("parameter virtualRouterName cannot be empty") 243 } 244 urlPath = strings.ReplaceAll(urlPath, "{virtualRouterName}", url.PathEscape(virtualRouterName)) 245 if client.subscriptionID == "" { 246 return nil, errors.New("parameter client.subscriptionID cannot be empty") 247 } 248 urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID)) 249 req, err := runtime.NewRequest(ctx, http.MethodGet, runtime.JoinPaths(client.internal.Endpoint(), urlPath)) 250 if err != nil { 251 return nil, err 252 } 253 reqQP := req.Raw().URL.Query() 254 if options != nil && options.Expand != nil { 255 reqQP.Set("$expand", *options.Expand) 256 } 257 reqQP.Set("api-version", "2024-05-01") 258 req.Raw().URL.RawQuery = reqQP.Encode() 259 req.Raw().Header["Accept"] = []string{"application/json"} 260 return req, nil 261 } 262 263 // getHandleResponse handles the Get response. 264 func (client *VirtualRoutersClient) getHandleResponse(resp *http.Response) (VirtualRoutersClientGetResponse, error) { 265 result := VirtualRoutersClientGetResponse{} 266 if err := runtime.UnmarshalAsJSON(resp, &result.VirtualRouter); err != nil { 267 return VirtualRoutersClientGetResponse{}, err 268 } 269 return result, nil 270 } 271 272 // NewListPager - Gets all the Virtual Routers in a subscription. 273 // 274 // Generated from API version 2024-05-01 275 // - options - VirtualRoutersClientListOptions contains the optional parameters for the VirtualRoutersClient.NewListPager method. 276 func (client *VirtualRoutersClient) NewListPager(options *VirtualRoutersClientListOptions) *runtime.Pager[VirtualRoutersClientListResponse] { 277 return runtime.NewPager(runtime.PagingHandler[VirtualRoutersClientListResponse]{ 278 More: func(page VirtualRoutersClientListResponse) bool { 279 return page.NextLink != nil && len(*page.NextLink) > 0 280 }, 281 Fetcher: func(ctx context.Context, page *VirtualRoutersClientListResponse) (VirtualRoutersClientListResponse, error) { 282 ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, "VirtualRoutersClient.NewListPager") 283 nextLink := "" 284 if page != nil { 285 nextLink = *page.NextLink 286 } 287 resp, err := runtime.FetcherForNextLink(ctx, client.internal.Pipeline(), nextLink, func(ctx context.Context) (*policy.Request, error) { 288 return client.listCreateRequest(ctx, options) 289 }, nil) 290 if err != nil { 291 return VirtualRoutersClientListResponse{}, err 292 } 293 return client.listHandleResponse(resp) 294 }, 295 Tracer: client.internal.Tracer(), 296 }) 297 } 298 299 // listCreateRequest creates the List request. 300 func (client *VirtualRoutersClient) listCreateRequest(ctx context.Context, options *VirtualRoutersClientListOptions) (*policy.Request, error) { 301 urlPath := "/subscriptions/{subscriptionId}/providers/Microsoft.Network/virtualRouters" 302 if client.subscriptionID == "" { 303 return nil, errors.New("parameter client.subscriptionID cannot be empty") 304 } 305 urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID)) 306 req, err := runtime.NewRequest(ctx, http.MethodGet, runtime.JoinPaths(client.internal.Endpoint(), urlPath)) 307 if err != nil { 308 return nil, err 309 } 310 reqQP := req.Raw().URL.Query() 311 reqQP.Set("api-version", "2024-05-01") 312 req.Raw().URL.RawQuery = reqQP.Encode() 313 req.Raw().Header["Accept"] = []string{"application/json"} 314 return req, nil 315 } 316 317 // listHandleResponse handles the List response. 318 func (client *VirtualRoutersClient) listHandleResponse(resp *http.Response) (VirtualRoutersClientListResponse, error) { 319 result := VirtualRoutersClientListResponse{} 320 if err := runtime.UnmarshalAsJSON(resp, &result.VirtualRouterListResult); err != nil { 321 return VirtualRoutersClientListResponse{}, err 322 } 323 return result, nil 324 } 325 326 // NewListByResourceGroupPager - Lists all Virtual Routers in a resource group. 327 // 328 // Generated from API version 2024-05-01 329 // - resourceGroupName - The name of the resource group. 330 // - options - VirtualRoutersClientListByResourceGroupOptions contains the optional parameters for the VirtualRoutersClient.NewListByResourceGroupPager 331 // method. 332 func (client *VirtualRoutersClient) NewListByResourceGroupPager(resourceGroupName string, options *VirtualRoutersClientListByResourceGroupOptions) *runtime.Pager[VirtualRoutersClientListByResourceGroupResponse] { 333 return runtime.NewPager(runtime.PagingHandler[VirtualRoutersClientListByResourceGroupResponse]{ 334 More: func(page VirtualRoutersClientListByResourceGroupResponse) bool { 335 return page.NextLink != nil && len(*page.NextLink) > 0 336 }, 337 Fetcher: func(ctx context.Context, page *VirtualRoutersClientListByResourceGroupResponse) (VirtualRoutersClientListByResourceGroupResponse, error) { 338 ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, "VirtualRoutersClient.NewListByResourceGroupPager") 339 nextLink := "" 340 if page != nil { 341 nextLink = *page.NextLink 342 } 343 resp, err := runtime.FetcherForNextLink(ctx, client.internal.Pipeline(), nextLink, func(ctx context.Context) (*policy.Request, error) { 344 return client.listByResourceGroupCreateRequest(ctx, resourceGroupName, options) 345 }, nil) 346 if err != nil { 347 return VirtualRoutersClientListByResourceGroupResponse{}, err 348 } 349 return client.listByResourceGroupHandleResponse(resp) 350 }, 351 Tracer: client.internal.Tracer(), 352 }) 353 } 354 355 // listByResourceGroupCreateRequest creates the ListByResourceGroup request. 356 func (client *VirtualRoutersClient) listByResourceGroupCreateRequest(ctx context.Context, resourceGroupName string, options *VirtualRoutersClientListByResourceGroupOptions) (*policy.Request, error) { 357 urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualRouters" 358 if resourceGroupName == "" { 359 return nil, errors.New("parameter resourceGroupName cannot be empty") 360 } 361 urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName)) 362 if client.subscriptionID == "" { 363 return nil, errors.New("parameter client.subscriptionID cannot be empty") 364 } 365 urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID)) 366 req, err := runtime.NewRequest(ctx, http.MethodGet, runtime.JoinPaths(client.internal.Endpoint(), urlPath)) 367 if err != nil { 368 return nil, err 369 } 370 reqQP := req.Raw().URL.Query() 371 reqQP.Set("api-version", "2024-05-01") 372 req.Raw().URL.RawQuery = reqQP.Encode() 373 req.Raw().Header["Accept"] = []string{"application/json"} 374 return req, nil 375 } 376 377 // listByResourceGroupHandleResponse handles the ListByResourceGroup response. 378 func (client *VirtualRoutersClient) listByResourceGroupHandleResponse(resp *http.Response) (VirtualRoutersClientListByResourceGroupResponse, error) { 379 result := VirtualRoutersClientListByResourceGroupResponse{} 380 if err := runtime.UnmarshalAsJSON(resp, &result.VirtualRouterListResult); err != nil { 381 return VirtualRoutersClientListByResourceGroupResponse{}, err 382 } 383 return result, nil 384 }