github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/network/armnetwork/v6@v6.2.0/privateendpoints_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 // PrivateEndpointsClient contains the methods for the PrivateEndpoints group. 24 // Don't use this type directly, use NewPrivateEndpointsClient() instead. 25 type PrivateEndpointsClient struct { 26 internal *arm.Client 27 subscriptionID string 28 } 29 30 // NewPrivateEndpointsClient creates a new instance of PrivateEndpointsClient 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 NewPrivateEndpointsClient(subscriptionID string, credential azcore.TokenCredential, options *arm.ClientOptions) (*PrivateEndpointsClient, error) { 36 cl, err := arm.NewClient(moduleName, moduleVersion, credential, options) 37 if err != nil { 38 return nil, err 39 } 40 client := &PrivateEndpointsClient{ 41 subscriptionID: subscriptionID, 42 internal: cl, 43 } 44 return client, nil 45 } 46 47 // BeginCreateOrUpdate - Creates or updates an private endpoint in the specified resource group. 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 // - privateEndpointName - The name of the private endpoint. 53 // - parameters - Parameters supplied to the create or update private endpoint operation. 54 // - options - PrivateEndpointsClientBeginCreateOrUpdateOptions contains the optional parameters for the PrivateEndpointsClient.BeginCreateOrUpdate 55 // method. 56 func (client *PrivateEndpointsClient) BeginCreateOrUpdate(ctx context.Context, resourceGroupName string, privateEndpointName string, parameters PrivateEndpoint, options *PrivateEndpointsClientBeginCreateOrUpdateOptions) (*runtime.Poller[PrivateEndpointsClientCreateOrUpdateResponse], error) { 57 if options == nil || options.ResumeToken == "" { 58 resp, err := client.createOrUpdate(ctx, resourceGroupName, privateEndpointName, parameters, options) 59 if err != nil { 60 return nil, err 61 } 62 poller, err := runtime.NewPoller(resp, client.internal.Pipeline(), &runtime.NewPollerOptions[PrivateEndpointsClientCreateOrUpdateResponse]{ 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[PrivateEndpointsClientCreateOrUpdateResponse]{ 69 Tracer: client.internal.Tracer(), 70 }) 71 } 72 } 73 74 // CreateOrUpdate - Creates or updates an private endpoint in the specified resource group. 75 // If the operation fails it returns an *azcore.ResponseError type. 76 // 77 // Generated from API version 2024-05-01 78 func (client *PrivateEndpointsClient) createOrUpdate(ctx context.Context, resourceGroupName string, privateEndpointName string, parameters PrivateEndpoint, options *PrivateEndpointsClientBeginCreateOrUpdateOptions) (*http.Response, error) { 79 var err error 80 const operationName = "PrivateEndpointsClient.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, privateEndpointName, 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 *PrivateEndpointsClient) createOrUpdateCreateRequest(ctx context.Context, resourceGroupName string, privateEndpointName string, parameters PrivateEndpoint, options *PrivateEndpointsClientBeginCreateOrUpdateOptions) (*policy.Request, error) { 101 urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateEndpoints/{privateEndpointName}" 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 privateEndpointName == "" { 107 return nil, errors.New("parameter privateEndpointName cannot be empty") 108 } 109 urlPath = strings.ReplaceAll(urlPath, "{privateEndpointName}", url.PathEscape(privateEndpointName)) 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 private endpoint. 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 // - privateEndpointName - The name of the private endpoint. 134 // - options - PrivateEndpointsClientBeginDeleteOptions contains the optional parameters for the PrivateEndpointsClient.BeginDelete 135 // method. 136 func (client *PrivateEndpointsClient) BeginDelete(ctx context.Context, resourceGroupName string, privateEndpointName string, options *PrivateEndpointsClientBeginDeleteOptions) (*runtime.Poller[PrivateEndpointsClientDeleteResponse], error) { 137 if options == nil || options.ResumeToken == "" { 138 resp, err := client.deleteOperation(ctx, resourceGroupName, privateEndpointName, options) 139 if err != nil { 140 return nil, err 141 } 142 poller, err := runtime.NewPoller(resp, client.internal.Pipeline(), &runtime.NewPollerOptions[PrivateEndpointsClientDeleteResponse]{ 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[PrivateEndpointsClientDeleteResponse]{ 149 Tracer: client.internal.Tracer(), 150 }) 151 } 152 } 153 154 // Delete - Deletes the specified private endpoint. 155 // If the operation fails it returns an *azcore.ResponseError type. 156 // 157 // Generated from API version 2024-05-01 158 func (client *PrivateEndpointsClient) deleteOperation(ctx context.Context, resourceGroupName string, privateEndpointName string, options *PrivateEndpointsClientBeginDeleteOptions) (*http.Response, error) { 159 var err error 160 const operationName = "PrivateEndpointsClient.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, privateEndpointName, 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 *PrivateEndpointsClient) deleteCreateRequest(ctx context.Context, resourceGroupName string, privateEndpointName string, options *PrivateEndpointsClientBeginDeleteOptions) (*policy.Request, error) { 181 urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateEndpoints/{privateEndpointName}" 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 privateEndpointName == "" { 187 return nil, errors.New("parameter privateEndpointName cannot be empty") 188 } 189 urlPath = strings.ReplaceAll(urlPath, "{privateEndpointName}", url.PathEscape(privateEndpointName)) 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 private endpoint by resource group. 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 // - privateEndpointName - The name of the private endpoint. 211 // - options - PrivateEndpointsClientGetOptions contains the optional parameters for the PrivateEndpointsClient.Get method. 212 func (client *PrivateEndpointsClient) Get(ctx context.Context, resourceGroupName string, privateEndpointName string, options *PrivateEndpointsClientGetOptions) (PrivateEndpointsClientGetResponse, error) { 213 var err error 214 const operationName = "PrivateEndpointsClient.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, privateEndpointName, options) 219 if err != nil { 220 return PrivateEndpointsClientGetResponse{}, err 221 } 222 httpResp, err := client.internal.Pipeline().Do(req) 223 if err != nil { 224 return PrivateEndpointsClientGetResponse{}, err 225 } 226 if !runtime.HasStatusCode(httpResp, http.StatusOK) { 227 err = runtime.NewResponseError(httpResp) 228 return PrivateEndpointsClientGetResponse{}, err 229 } 230 resp, err := client.getHandleResponse(httpResp) 231 return resp, err 232 } 233 234 // getCreateRequest creates the Get request. 235 func (client *PrivateEndpointsClient) getCreateRequest(ctx context.Context, resourceGroupName string, privateEndpointName string, options *PrivateEndpointsClientGetOptions) (*policy.Request, error) { 236 urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateEndpoints/{privateEndpointName}" 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 privateEndpointName == "" { 242 return nil, errors.New("parameter privateEndpointName cannot be empty") 243 } 244 urlPath = strings.ReplaceAll(urlPath, "{privateEndpointName}", url.PathEscape(privateEndpointName)) 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 *PrivateEndpointsClient) getHandleResponse(resp *http.Response) (PrivateEndpointsClientGetResponse, error) { 265 result := PrivateEndpointsClientGetResponse{} 266 if err := runtime.UnmarshalAsJSON(resp, &result.PrivateEndpoint); err != nil { 267 return PrivateEndpointsClientGetResponse{}, err 268 } 269 return result, nil 270 } 271 272 // NewListPager - Gets all private endpoints in a resource group. 273 // 274 // Generated from API version 2024-05-01 275 // - resourceGroupName - The name of the resource group. 276 // - options - PrivateEndpointsClientListOptions contains the optional parameters for the PrivateEndpointsClient.NewListPager 277 // method. 278 func (client *PrivateEndpointsClient) NewListPager(resourceGroupName string, options *PrivateEndpointsClientListOptions) *runtime.Pager[PrivateEndpointsClientListResponse] { 279 return runtime.NewPager(runtime.PagingHandler[PrivateEndpointsClientListResponse]{ 280 More: func(page PrivateEndpointsClientListResponse) bool { 281 return page.NextLink != nil && len(*page.NextLink) > 0 282 }, 283 Fetcher: func(ctx context.Context, page *PrivateEndpointsClientListResponse) (PrivateEndpointsClientListResponse, error) { 284 ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, "PrivateEndpointsClient.NewListPager") 285 nextLink := "" 286 if page != nil { 287 nextLink = *page.NextLink 288 } 289 resp, err := runtime.FetcherForNextLink(ctx, client.internal.Pipeline(), nextLink, func(ctx context.Context) (*policy.Request, error) { 290 return client.listCreateRequest(ctx, resourceGroupName, options) 291 }, nil) 292 if err != nil { 293 return PrivateEndpointsClientListResponse{}, err 294 } 295 return client.listHandleResponse(resp) 296 }, 297 Tracer: client.internal.Tracer(), 298 }) 299 } 300 301 // listCreateRequest creates the List request. 302 func (client *PrivateEndpointsClient) listCreateRequest(ctx context.Context, resourceGroupName string, options *PrivateEndpointsClientListOptions) (*policy.Request, error) { 303 urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateEndpoints" 304 if resourceGroupName == "" { 305 return nil, errors.New("parameter resourceGroupName cannot be empty") 306 } 307 urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName)) 308 if client.subscriptionID == "" { 309 return nil, errors.New("parameter client.subscriptionID cannot be empty") 310 } 311 urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID)) 312 req, err := runtime.NewRequest(ctx, http.MethodGet, runtime.JoinPaths(client.internal.Endpoint(), urlPath)) 313 if err != nil { 314 return nil, err 315 } 316 reqQP := req.Raw().URL.Query() 317 reqQP.Set("api-version", "2024-05-01") 318 req.Raw().URL.RawQuery = reqQP.Encode() 319 req.Raw().Header["Accept"] = []string{"application/json"} 320 return req, nil 321 } 322 323 // listHandleResponse handles the List response. 324 func (client *PrivateEndpointsClient) listHandleResponse(resp *http.Response) (PrivateEndpointsClientListResponse, error) { 325 result := PrivateEndpointsClientListResponse{} 326 if err := runtime.UnmarshalAsJSON(resp, &result.PrivateEndpointListResult); err != nil { 327 return PrivateEndpointsClientListResponse{}, err 328 } 329 return result, nil 330 } 331 332 // NewListBySubscriptionPager - Gets all private endpoints in a subscription. 333 // 334 // Generated from API version 2024-05-01 335 // - options - PrivateEndpointsClientListBySubscriptionOptions contains the optional parameters for the PrivateEndpointsClient.NewListBySubscriptionPager 336 // method. 337 func (client *PrivateEndpointsClient) NewListBySubscriptionPager(options *PrivateEndpointsClientListBySubscriptionOptions) *runtime.Pager[PrivateEndpointsClientListBySubscriptionResponse] { 338 return runtime.NewPager(runtime.PagingHandler[PrivateEndpointsClientListBySubscriptionResponse]{ 339 More: func(page PrivateEndpointsClientListBySubscriptionResponse) bool { 340 return page.NextLink != nil && len(*page.NextLink) > 0 341 }, 342 Fetcher: func(ctx context.Context, page *PrivateEndpointsClientListBySubscriptionResponse) (PrivateEndpointsClientListBySubscriptionResponse, error) { 343 ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, "PrivateEndpointsClient.NewListBySubscriptionPager") 344 nextLink := "" 345 if page != nil { 346 nextLink = *page.NextLink 347 } 348 resp, err := runtime.FetcherForNextLink(ctx, client.internal.Pipeline(), nextLink, func(ctx context.Context) (*policy.Request, error) { 349 return client.listBySubscriptionCreateRequest(ctx, options) 350 }, nil) 351 if err != nil { 352 return PrivateEndpointsClientListBySubscriptionResponse{}, err 353 } 354 return client.listBySubscriptionHandleResponse(resp) 355 }, 356 Tracer: client.internal.Tracer(), 357 }) 358 } 359 360 // listBySubscriptionCreateRequest creates the ListBySubscription request. 361 func (client *PrivateEndpointsClient) listBySubscriptionCreateRequest(ctx context.Context, options *PrivateEndpointsClientListBySubscriptionOptions) (*policy.Request, error) { 362 urlPath := "/subscriptions/{subscriptionId}/providers/Microsoft.Network/privateEndpoints" 363 if client.subscriptionID == "" { 364 return nil, errors.New("parameter client.subscriptionID cannot be empty") 365 } 366 urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID)) 367 req, err := runtime.NewRequest(ctx, http.MethodGet, runtime.JoinPaths(client.internal.Endpoint(), urlPath)) 368 if err != nil { 369 return nil, err 370 } 371 reqQP := req.Raw().URL.Query() 372 reqQP.Set("api-version", "2024-05-01") 373 req.Raw().URL.RawQuery = reqQP.Encode() 374 req.Raw().Header["Accept"] = []string{"application/json"} 375 return req, nil 376 } 377 378 // listBySubscriptionHandleResponse handles the ListBySubscription response. 379 func (client *PrivateEndpointsClient) listBySubscriptionHandleResponse(resp *http.Response) (PrivateEndpointsClientListBySubscriptionResponse, error) { 380 result := PrivateEndpointsClientListBySubscriptionResponse{} 381 if err := runtime.UnmarshalAsJSON(resp, &result.PrivateEndpointListResult); err != nil { 382 return PrivateEndpointsClientListBySubscriptionResponse{}, err 383 } 384 return result, nil 385 }