github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/network/armnetwork/v6@v6.2.0/subnets_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  // SubnetsClient contains the methods for the Subnets group.
    24  // Don't use this type directly, use NewSubnetsClient() instead.
    25  type SubnetsClient struct {
    26  	internal       *arm.Client
    27  	subscriptionID string
    28  }
    29  
    30  // NewSubnetsClient creates a new instance of SubnetsClient 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 NewSubnetsClient(subscriptionID string, credential azcore.TokenCredential, options *arm.ClientOptions) (*SubnetsClient, error) {
    36  	cl, err := arm.NewClient(moduleName, moduleVersion, credential, options)
    37  	if err != nil {
    38  		return nil, err
    39  	}
    40  	client := &SubnetsClient{
    41  		subscriptionID: subscriptionID,
    42  		internal:       cl,
    43  	}
    44  	return client, nil
    45  }
    46  
    47  // BeginCreateOrUpdate - Creates or updates a subnet in the specified virtual network.
    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  //   - virtualNetworkName - The name of the virtual network.
    53  //   - subnetName - The name of the subnet.
    54  //   - subnetParameters - Parameters supplied to the create or update subnet operation.
    55  //   - options - SubnetsClientBeginCreateOrUpdateOptions contains the optional parameters for the SubnetsClient.BeginCreateOrUpdate
    56  //     method.
    57  func (client *SubnetsClient) BeginCreateOrUpdate(ctx context.Context, resourceGroupName string, virtualNetworkName string, subnetName string, subnetParameters Subnet, options *SubnetsClientBeginCreateOrUpdateOptions) (*runtime.Poller[SubnetsClientCreateOrUpdateResponse], error) {
    58  	if options == nil || options.ResumeToken == "" {
    59  		resp, err := client.createOrUpdate(ctx, resourceGroupName, virtualNetworkName, subnetName, subnetParameters, options)
    60  		if err != nil {
    61  			return nil, err
    62  		}
    63  		poller, err := runtime.NewPoller(resp, client.internal.Pipeline(), &runtime.NewPollerOptions[SubnetsClientCreateOrUpdateResponse]{
    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[SubnetsClientCreateOrUpdateResponse]{
    70  			Tracer: client.internal.Tracer(),
    71  		})
    72  	}
    73  }
    74  
    75  // CreateOrUpdate - Creates or updates a subnet in the specified virtual network.
    76  // If the operation fails it returns an *azcore.ResponseError type.
    77  //
    78  // Generated from API version 2024-05-01
    79  func (client *SubnetsClient) createOrUpdate(ctx context.Context, resourceGroupName string, virtualNetworkName string, subnetName string, subnetParameters Subnet, options *SubnetsClientBeginCreateOrUpdateOptions) (*http.Response, error) {
    80  	var err error
    81  	const operationName = "SubnetsClient.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, virtualNetworkName, subnetName, subnetParameters, 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 *SubnetsClient) createOrUpdateCreateRequest(ctx context.Context, resourceGroupName string, virtualNetworkName string, subnetName string, subnetParameters Subnet, options *SubnetsClientBeginCreateOrUpdateOptions) (*policy.Request, error) {
   102  	urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}"
   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 virtualNetworkName == "" {
   108  		return nil, errors.New("parameter virtualNetworkName cannot be empty")
   109  	}
   110  	urlPath = strings.ReplaceAll(urlPath, "{virtualNetworkName}", url.PathEscape(virtualNetworkName))
   111  	if subnetName == "" {
   112  		return nil, errors.New("parameter subnetName cannot be empty")
   113  	}
   114  	urlPath = strings.ReplaceAll(urlPath, "{subnetName}", url.PathEscape(subnetName))
   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, subnetParameters); err != nil {
   128  		return nil, err
   129  	}
   130  	return req, nil
   131  }
   132  
   133  // BeginDelete - Deletes the specified subnet.
   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  //   - virtualNetworkName - The name of the virtual network.
   139  //   - subnetName - The name of the subnet.
   140  //   - options - SubnetsClientBeginDeleteOptions contains the optional parameters for the SubnetsClient.BeginDelete method.
   141  func (client *SubnetsClient) BeginDelete(ctx context.Context, resourceGroupName string, virtualNetworkName string, subnetName string, options *SubnetsClientBeginDeleteOptions) (*runtime.Poller[SubnetsClientDeleteResponse], error) {
   142  	if options == nil || options.ResumeToken == "" {
   143  		resp, err := client.deleteOperation(ctx, resourceGroupName, virtualNetworkName, subnetName, options)
   144  		if err != nil {
   145  			return nil, err
   146  		}
   147  		poller, err := runtime.NewPoller(resp, client.internal.Pipeline(), &runtime.NewPollerOptions[SubnetsClientDeleteResponse]{
   148  			FinalStateVia: runtime.FinalStateViaLocation,
   149  			Tracer:        client.internal.Tracer(),
   150  		})
   151  		return poller, err
   152  	} else {
   153  		return runtime.NewPollerFromResumeToken(options.ResumeToken, client.internal.Pipeline(), &runtime.NewPollerFromResumeTokenOptions[SubnetsClientDeleteResponse]{
   154  			Tracer: client.internal.Tracer(),
   155  		})
   156  	}
   157  }
   158  
   159  // Delete - Deletes the specified subnet.
   160  // If the operation fails it returns an *azcore.ResponseError type.
   161  //
   162  // Generated from API version 2024-05-01
   163  func (client *SubnetsClient) deleteOperation(ctx context.Context, resourceGroupName string, virtualNetworkName string, subnetName string, options *SubnetsClientBeginDeleteOptions) (*http.Response, error) {
   164  	var err error
   165  	const operationName = "SubnetsClient.BeginDelete"
   166  	ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, operationName)
   167  	ctx, endSpan := runtime.StartSpan(ctx, operationName, client.internal.Tracer(), nil)
   168  	defer func() { endSpan(err) }()
   169  	req, err := client.deleteCreateRequest(ctx, resourceGroupName, virtualNetworkName, subnetName, options)
   170  	if err != nil {
   171  		return nil, err
   172  	}
   173  	httpResp, err := client.internal.Pipeline().Do(req)
   174  	if err != nil {
   175  		return nil, err
   176  	}
   177  	if !runtime.HasStatusCode(httpResp, http.StatusOK, http.StatusAccepted, http.StatusNoContent) {
   178  		err = runtime.NewResponseError(httpResp)
   179  		return nil, err
   180  	}
   181  	return httpResp, nil
   182  }
   183  
   184  // deleteCreateRequest creates the Delete request.
   185  func (client *SubnetsClient) deleteCreateRequest(ctx context.Context, resourceGroupName string, virtualNetworkName string, subnetName string, options *SubnetsClientBeginDeleteOptions) (*policy.Request, error) {
   186  	urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}"
   187  	if resourceGroupName == "" {
   188  		return nil, errors.New("parameter resourceGroupName cannot be empty")
   189  	}
   190  	urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName))
   191  	if virtualNetworkName == "" {
   192  		return nil, errors.New("parameter virtualNetworkName cannot be empty")
   193  	}
   194  	urlPath = strings.ReplaceAll(urlPath, "{virtualNetworkName}", url.PathEscape(virtualNetworkName))
   195  	if subnetName == "" {
   196  		return nil, errors.New("parameter subnetName cannot be empty")
   197  	}
   198  	urlPath = strings.ReplaceAll(urlPath, "{subnetName}", url.PathEscape(subnetName))
   199  	if client.subscriptionID == "" {
   200  		return nil, errors.New("parameter client.subscriptionID cannot be empty")
   201  	}
   202  	urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID))
   203  	req, err := runtime.NewRequest(ctx, http.MethodDelete, runtime.JoinPaths(client.internal.Endpoint(), urlPath))
   204  	if err != nil {
   205  		return nil, err
   206  	}
   207  	reqQP := req.Raw().URL.Query()
   208  	reqQP.Set("api-version", "2024-05-01")
   209  	req.Raw().URL.RawQuery = reqQP.Encode()
   210  	req.Raw().Header["Accept"] = []string{"application/json"}
   211  	return req, nil
   212  }
   213  
   214  // Get - Gets the specified subnet by virtual network and resource group.
   215  // If the operation fails it returns an *azcore.ResponseError type.
   216  //
   217  // Generated from API version 2024-05-01
   218  //   - resourceGroupName - The name of the resource group.
   219  //   - virtualNetworkName - The name of the virtual network.
   220  //   - subnetName - The name of the subnet.
   221  //   - options - SubnetsClientGetOptions contains the optional parameters for the SubnetsClient.Get method.
   222  func (client *SubnetsClient) Get(ctx context.Context, resourceGroupName string, virtualNetworkName string, subnetName string, options *SubnetsClientGetOptions) (SubnetsClientGetResponse, error) {
   223  	var err error
   224  	const operationName = "SubnetsClient.Get"
   225  	ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, operationName)
   226  	ctx, endSpan := runtime.StartSpan(ctx, operationName, client.internal.Tracer(), nil)
   227  	defer func() { endSpan(err) }()
   228  	req, err := client.getCreateRequest(ctx, resourceGroupName, virtualNetworkName, subnetName, options)
   229  	if err != nil {
   230  		return SubnetsClientGetResponse{}, err
   231  	}
   232  	httpResp, err := client.internal.Pipeline().Do(req)
   233  	if err != nil {
   234  		return SubnetsClientGetResponse{}, err
   235  	}
   236  	if !runtime.HasStatusCode(httpResp, http.StatusOK) {
   237  		err = runtime.NewResponseError(httpResp)
   238  		return SubnetsClientGetResponse{}, err
   239  	}
   240  	resp, err := client.getHandleResponse(httpResp)
   241  	return resp, err
   242  }
   243  
   244  // getCreateRequest creates the Get request.
   245  func (client *SubnetsClient) getCreateRequest(ctx context.Context, resourceGroupName string, virtualNetworkName string, subnetName string, options *SubnetsClientGetOptions) (*policy.Request, error) {
   246  	urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}"
   247  	if resourceGroupName == "" {
   248  		return nil, errors.New("parameter resourceGroupName cannot be empty")
   249  	}
   250  	urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName))
   251  	if virtualNetworkName == "" {
   252  		return nil, errors.New("parameter virtualNetworkName cannot be empty")
   253  	}
   254  	urlPath = strings.ReplaceAll(urlPath, "{virtualNetworkName}", url.PathEscape(virtualNetworkName))
   255  	if subnetName == "" {
   256  		return nil, errors.New("parameter subnetName cannot be empty")
   257  	}
   258  	urlPath = strings.ReplaceAll(urlPath, "{subnetName}", url.PathEscape(subnetName))
   259  	if client.subscriptionID == "" {
   260  		return nil, errors.New("parameter client.subscriptionID cannot be empty")
   261  	}
   262  	urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID))
   263  	req, err := runtime.NewRequest(ctx, http.MethodGet, runtime.JoinPaths(client.internal.Endpoint(), urlPath))
   264  	if err != nil {
   265  		return nil, err
   266  	}
   267  	reqQP := req.Raw().URL.Query()
   268  	if options != nil && options.Expand != nil {
   269  		reqQP.Set("$expand", *options.Expand)
   270  	}
   271  	reqQP.Set("api-version", "2024-05-01")
   272  	req.Raw().URL.RawQuery = reqQP.Encode()
   273  	req.Raw().Header["Accept"] = []string{"application/json"}
   274  	return req, nil
   275  }
   276  
   277  // getHandleResponse handles the Get response.
   278  func (client *SubnetsClient) getHandleResponse(resp *http.Response) (SubnetsClientGetResponse, error) {
   279  	result := SubnetsClientGetResponse{}
   280  	if err := runtime.UnmarshalAsJSON(resp, &result.Subnet); err != nil {
   281  		return SubnetsClientGetResponse{}, err
   282  	}
   283  	return result, nil
   284  }
   285  
   286  // NewListPager - Gets all subnets in a virtual network.
   287  //
   288  // Generated from API version 2024-05-01
   289  //   - resourceGroupName - The name of the resource group.
   290  //   - virtualNetworkName - The name of the virtual network.
   291  //   - options - SubnetsClientListOptions contains the optional parameters for the SubnetsClient.NewListPager method.
   292  func (client *SubnetsClient) NewListPager(resourceGroupName string, virtualNetworkName string, options *SubnetsClientListOptions) *runtime.Pager[SubnetsClientListResponse] {
   293  	return runtime.NewPager(runtime.PagingHandler[SubnetsClientListResponse]{
   294  		More: func(page SubnetsClientListResponse) bool {
   295  			return page.NextLink != nil && len(*page.NextLink) > 0
   296  		},
   297  		Fetcher: func(ctx context.Context, page *SubnetsClientListResponse) (SubnetsClientListResponse, error) {
   298  			ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, "SubnetsClient.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, virtualNetworkName, options)
   305  			}, nil)
   306  			if err != nil {
   307  				return SubnetsClientListResponse{}, 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 *SubnetsClient) listCreateRequest(ctx context.Context, resourceGroupName string, virtualNetworkName string, options *SubnetsClientListOptions) (*policy.Request, error) {
   317  	urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets"
   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 virtualNetworkName == "" {
   323  		return nil, errors.New("parameter virtualNetworkName cannot be empty")
   324  	}
   325  	urlPath = strings.ReplaceAll(urlPath, "{virtualNetworkName}", url.PathEscape(virtualNetworkName))
   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 *SubnetsClient) listHandleResponse(resp *http.Response) (SubnetsClientListResponse, error) {
   343  	result := SubnetsClientListResponse{}
   344  	if err := runtime.UnmarshalAsJSON(resp, &result.SubnetListResult); err != nil {
   345  		return SubnetsClientListResponse{}, err
   346  	}
   347  	return result, nil
   348  }
   349  
   350  // BeginPrepareNetworkPolicies - Prepares a subnet by applying network intent policies.
   351  // If the operation fails it returns an *azcore.ResponseError type.
   352  //
   353  // Generated from API version 2024-05-01
   354  //   - resourceGroupName - The name of the resource group.
   355  //   - virtualNetworkName - The name of the virtual network.
   356  //   - subnetName - The name of the subnet.
   357  //   - prepareNetworkPoliciesRequestParameters - Parameters supplied to prepare subnet by applying network intent policies.
   358  //   - options - SubnetsClientBeginPrepareNetworkPoliciesOptions contains the optional parameters for the SubnetsClient.BeginPrepareNetworkPolicies
   359  //     method.
   360  func (client *SubnetsClient) BeginPrepareNetworkPolicies(ctx context.Context, resourceGroupName string, virtualNetworkName string, subnetName string, prepareNetworkPoliciesRequestParameters PrepareNetworkPoliciesRequest, options *SubnetsClientBeginPrepareNetworkPoliciesOptions) (*runtime.Poller[SubnetsClientPrepareNetworkPoliciesResponse], error) {
   361  	if options == nil || options.ResumeToken == "" {
   362  		resp, err := client.prepareNetworkPolicies(ctx, resourceGroupName, virtualNetworkName, subnetName, prepareNetworkPoliciesRequestParameters, options)
   363  		if err != nil {
   364  			return nil, err
   365  		}
   366  		poller, err := runtime.NewPoller(resp, client.internal.Pipeline(), &runtime.NewPollerOptions[SubnetsClientPrepareNetworkPoliciesResponse]{
   367  			FinalStateVia: runtime.FinalStateViaLocation,
   368  			Tracer:        client.internal.Tracer(),
   369  		})
   370  		return poller, err
   371  	} else {
   372  		return runtime.NewPollerFromResumeToken(options.ResumeToken, client.internal.Pipeline(), &runtime.NewPollerFromResumeTokenOptions[SubnetsClientPrepareNetworkPoliciesResponse]{
   373  			Tracer: client.internal.Tracer(),
   374  		})
   375  	}
   376  }
   377  
   378  // PrepareNetworkPolicies - Prepares a subnet by applying network intent policies.
   379  // If the operation fails it returns an *azcore.ResponseError type.
   380  //
   381  // Generated from API version 2024-05-01
   382  func (client *SubnetsClient) prepareNetworkPolicies(ctx context.Context, resourceGroupName string, virtualNetworkName string, subnetName string, prepareNetworkPoliciesRequestParameters PrepareNetworkPoliciesRequest, options *SubnetsClientBeginPrepareNetworkPoliciesOptions) (*http.Response, error) {
   383  	var err error
   384  	const operationName = "SubnetsClient.BeginPrepareNetworkPolicies"
   385  	ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, operationName)
   386  	ctx, endSpan := runtime.StartSpan(ctx, operationName, client.internal.Tracer(), nil)
   387  	defer func() { endSpan(err) }()
   388  	req, err := client.prepareNetworkPoliciesCreateRequest(ctx, resourceGroupName, virtualNetworkName, subnetName, prepareNetworkPoliciesRequestParameters, options)
   389  	if err != nil {
   390  		return nil, err
   391  	}
   392  	httpResp, err := client.internal.Pipeline().Do(req)
   393  	if err != nil {
   394  		return nil, err
   395  	}
   396  	if !runtime.HasStatusCode(httpResp, http.StatusOK, http.StatusAccepted) {
   397  		err = runtime.NewResponseError(httpResp)
   398  		return nil, err
   399  	}
   400  	return httpResp, nil
   401  }
   402  
   403  // prepareNetworkPoliciesCreateRequest creates the PrepareNetworkPolicies request.
   404  func (client *SubnetsClient) prepareNetworkPoliciesCreateRequest(ctx context.Context, resourceGroupName string, virtualNetworkName string, subnetName string, prepareNetworkPoliciesRequestParameters PrepareNetworkPoliciesRequest, options *SubnetsClientBeginPrepareNetworkPoliciesOptions) (*policy.Request, error) {
   405  	urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}/PrepareNetworkPolicies"
   406  	if resourceGroupName == "" {
   407  		return nil, errors.New("parameter resourceGroupName cannot be empty")
   408  	}
   409  	urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName))
   410  	if virtualNetworkName == "" {
   411  		return nil, errors.New("parameter virtualNetworkName cannot be empty")
   412  	}
   413  	urlPath = strings.ReplaceAll(urlPath, "{virtualNetworkName}", url.PathEscape(virtualNetworkName))
   414  	if subnetName == "" {
   415  		return nil, errors.New("parameter subnetName cannot be empty")
   416  	}
   417  	urlPath = strings.ReplaceAll(urlPath, "{subnetName}", url.PathEscape(subnetName))
   418  	if client.subscriptionID == "" {
   419  		return nil, errors.New("parameter client.subscriptionID cannot be empty")
   420  	}
   421  	urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID))
   422  	req, err := runtime.NewRequest(ctx, http.MethodPost, runtime.JoinPaths(client.internal.Endpoint(), urlPath))
   423  	if err != nil {
   424  		return nil, err
   425  	}
   426  	reqQP := req.Raw().URL.Query()
   427  	reqQP.Set("api-version", "2024-05-01")
   428  	req.Raw().URL.RawQuery = reqQP.Encode()
   429  	req.Raw().Header["Accept"] = []string{"application/json"}
   430  	if err := runtime.MarshalAsJSON(req, prepareNetworkPoliciesRequestParameters); err != nil {
   431  		return nil, err
   432  	}
   433  	return req, nil
   434  }
   435  
   436  // BeginUnprepareNetworkPolicies - Unprepares a subnet by removing network intent policies.
   437  // If the operation fails it returns an *azcore.ResponseError type.
   438  //
   439  // Generated from API version 2024-05-01
   440  //   - resourceGroupName - The name of the resource group.
   441  //   - virtualNetworkName - The name of the virtual network.
   442  //   - subnetName - The name of the subnet.
   443  //   - unprepareNetworkPoliciesRequestParameters - Parameters supplied to unprepare subnet to remove network intent policies.
   444  //   - options - SubnetsClientBeginUnprepareNetworkPoliciesOptions contains the optional parameters for the SubnetsClient.BeginUnprepareNetworkPolicies
   445  //     method.
   446  func (client *SubnetsClient) BeginUnprepareNetworkPolicies(ctx context.Context, resourceGroupName string, virtualNetworkName string, subnetName string, unprepareNetworkPoliciesRequestParameters UnprepareNetworkPoliciesRequest, options *SubnetsClientBeginUnprepareNetworkPoliciesOptions) (*runtime.Poller[SubnetsClientUnprepareNetworkPoliciesResponse], error) {
   447  	if options == nil || options.ResumeToken == "" {
   448  		resp, err := client.unprepareNetworkPolicies(ctx, resourceGroupName, virtualNetworkName, subnetName, unprepareNetworkPoliciesRequestParameters, options)
   449  		if err != nil {
   450  			return nil, err
   451  		}
   452  		poller, err := runtime.NewPoller(resp, client.internal.Pipeline(), &runtime.NewPollerOptions[SubnetsClientUnprepareNetworkPoliciesResponse]{
   453  			FinalStateVia: runtime.FinalStateViaLocation,
   454  			Tracer:        client.internal.Tracer(),
   455  		})
   456  		return poller, err
   457  	} else {
   458  		return runtime.NewPollerFromResumeToken(options.ResumeToken, client.internal.Pipeline(), &runtime.NewPollerFromResumeTokenOptions[SubnetsClientUnprepareNetworkPoliciesResponse]{
   459  			Tracer: client.internal.Tracer(),
   460  		})
   461  	}
   462  }
   463  
   464  // UnprepareNetworkPolicies - Unprepares a subnet by removing network intent policies.
   465  // If the operation fails it returns an *azcore.ResponseError type.
   466  //
   467  // Generated from API version 2024-05-01
   468  func (client *SubnetsClient) unprepareNetworkPolicies(ctx context.Context, resourceGroupName string, virtualNetworkName string, subnetName string, unprepareNetworkPoliciesRequestParameters UnprepareNetworkPoliciesRequest, options *SubnetsClientBeginUnprepareNetworkPoliciesOptions) (*http.Response, error) {
   469  	var err error
   470  	const operationName = "SubnetsClient.BeginUnprepareNetworkPolicies"
   471  	ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, operationName)
   472  	ctx, endSpan := runtime.StartSpan(ctx, operationName, client.internal.Tracer(), nil)
   473  	defer func() { endSpan(err) }()
   474  	req, err := client.unprepareNetworkPoliciesCreateRequest(ctx, resourceGroupName, virtualNetworkName, subnetName, unprepareNetworkPoliciesRequestParameters, options)
   475  	if err != nil {
   476  		return nil, err
   477  	}
   478  	httpResp, err := client.internal.Pipeline().Do(req)
   479  	if err != nil {
   480  		return nil, err
   481  	}
   482  	if !runtime.HasStatusCode(httpResp, http.StatusOK, http.StatusAccepted) {
   483  		err = runtime.NewResponseError(httpResp)
   484  		return nil, err
   485  	}
   486  	return httpResp, nil
   487  }
   488  
   489  // unprepareNetworkPoliciesCreateRequest creates the UnprepareNetworkPolicies request.
   490  func (client *SubnetsClient) unprepareNetworkPoliciesCreateRequest(ctx context.Context, resourceGroupName string, virtualNetworkName string, subnetName string, unprepareNetworkPoliciesRequestParameters UnprepareNetworkPoliciesRequest, options *SubnetsClientBeginUnprepareNetworkPoliciesOptions) (*policy.Request, error) {
   491  	urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}/UnprepareNetworkPolicies"
   492  	if resourceGroupName == "" {
   493  		return nil, errors.New("parameter resourceGroupName cannot be empty")
   494  	}
   495  	urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName))
   496  	if virtualNetworkName == "" {
   497  		return nil, errors.New("parameter virtualNetworkName cannot be empty")
   498  	}
   499  	urlPath = strings.ReplaceAll(urlPath, "{virtualNetworkName}", url.PathEscape(virtualNetworkName))
   500  	if subnetName == "" {
   501  		return nil, errors.New("parameter subnetName cannot be empty")
   502  	}
   503  	urlPath = strings.ReplaceAll(urlPath, "{subnetName}", url.PathEscape(subnetName))
   504  	if client.subscriptionID == "" {
   505  		return nil, errors.New("parameter client.subscriptionID cannot be empty")
   506  	}
   507  	urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID))
   508  	req, err := runtime.NewRequest(ctx, http.MethodPost, runtime.JoinPaths(client.internal.Endpoint(), urlPath))
   509  	if err != nil {
   510  		return nil, err
   511  	}
   512  	reqQP := req.Raw().URL.Query()
   513  	reqQP.Set("api-version", "2024-05-01")
   514  	req.Raw().URL.RawQuery = reqQP.Encode()
   515  	req.Raw().Header["Accept"] = []string{"application/json"}
   516  	if err := runtime.MarshalAsJSON(req, unprepareNetworkPoliciesRequestParameters); err != nil {
   517  		return nil, err
   518  	}
   519  	return req, nil
   520  }