sdk/resourcemanager/apimanagement/armapimanagement/workspaceapirelease_client.go (430 lines of code) (raw):
// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the MIT License. See License.txt in the project root for license information.
// Code generated by Microsoft (R) AutoRest Code Generator. DO NOT EDIT.
// Changes may cause incorrect behavior and will be lost if the code is regenerated.
package armapimanagement
import (
"context"
"errors"
"github.com/Azure/azure-sdk-for-go/sdk/azcore"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/arm"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/policy"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/runtime"
"net/http"
"net/url"
"strconv"
"strings"
)
// WorkspaceAPIReleaseClient contains the methods for the WorkspaceAPIRelease group.
// Don't use this type directly, use NewWorkspaceAPIReleaseClient() instead.
type WorkspaceAPIReleaseClient struct {
internal *arm.Client
subscriptionID string
}
// NewWorkspaceAPIReleaseClient creates a new instance of WorkspaceAPIReleaseClient with the specified values.
// - subscriptionID - The ID of the target subscription. The value must be an UUID.
// - credential - used to authorize requests. Usually a credential from azidentity.
// - options - pass nil to accept the default values.
func NewWorkspaceAPIReleaseClient(subscriptionID string, credential azcore.TokenCredential, options *arm.ClientOptions) (*WorkspaceAPIReleaseClient, error) {
cl, err := arm.NewClient(moduleName, moduleVersion, credential, options)
if err != nil {
return nil, err
}
client := &WorkspaceAPIReleaseClient{
subscriptionID: subscriptionID,
internal: cl,
}
return client, nil
}
// CreateOrUpdate - Creates a new Release for the API.
// If the operation fails it returns an *azcore.ResponseError type.
//
// Generated from API version 2024-05-01
// - resourceGroupName - The name of the resource group. The name is case insensitive.
// - serviceName - The name of the API Management service.
// - workspaceID - Workspace identifier. Must be unique in the current API Management service instance.
// - apiID - API identifier. Must be unique in the current API Management service instance.
// - releaseID - Release identifier within an API. Must be unique in the current API Management service instance.
// - parameters - Create parameters.
// - options - WorkspaceAPIReleaseClientCreateOrUpdateOptions contains the optional parameters for the WorkspaceAPIReleaseClient.CreateOrUpdate
// method.
func (client *WorkspaceAPIReleaseClient) CreateOrUpdate(ctx context.Context, resourceGroupName string, serviceName string, workspaceID string, apiID string, releaseID string, parameters APIReleaseContract, options *WorkspaceAPIReleaseClientCreateOrUpdateOptions) (WorkspaceAPIReleaseClientCreateOrUpdateResponse, error) {
var err error
const operationName = "WorkspaceAPIReleaseClient.CreateOrUpdate"
ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, operationName)
ctx, endSpan := runtime.StartSpan(ctx, operationName, client.internal.Tracer(), nil)
defer func() { endSpan(err) }()
req, err := client.createOrUpdateCreateRequest(ctx, resourceGroupName, serviceName, workspaceID, apiID, releaseID, parameters, options)
if err != nil {
return WorkspaceAPIReleaseClientCreateOrUpdateResponse{}, err
}
httpResp, err := client.internal.Pipeline().Do(req)
if err != nil {
return WorkspaceAPIReleaseClientCreateOrUpdateResponse{}, err
}
if !runtime.HasStatusCode(httpResp, http.StatusOK, http.StatusCreated) {
err = runtime.NewResponseError(httpResp)
return WorkspaceAPIReleaseClientCreateOrUpdateResponse{}, err
}
resp, err := client.createOrUpdateHandleResponse(httpResp)
return resp, err
}
// createOrUpdateCreateRequest creates the CreateOrUpdate request.
func (client *WorkspaceAPIReleaseClient) createOrUpdateCreateRequest(ctx context.Context, resourceGroupName string, serviceName string, workspaceID string, apiID string, releaseID string, parameters APIReleaseContract, options *WorkspaceAPIReleaseClientCreateOrUpdateOptions) (*policy.Request, error) {
urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/apis/{apiId}/releases/{releaseId}"
if resourceGroupName == "" {
return nil, errors.New("parameter resourceGroupName cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName))
if serviceName == "" {
return nil, errors.New("parameter serviceName cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{serviceName}", url.PathEscape(serviceName))
if workspaceID == "" {
return nil, errors.New("parameter workspaceID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{workspaceId}", url.PathEscape(workspaceID))
if apiID == "" {
return nil, errors.New("parameter apiID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{apiId}", url.PathEscape(apiID))
if releaseID == "" {
return nil, errors.New("parameter releaseID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{releaseId}", url.PathEscape(releaseID))
if client.subscriptionID == "" {
return nil, errors.New("parameter client.subscriptionID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID))
req, err := runtime.NewRequest(ctx, http.MethodPut, runtime.JoinPaths(client.internal.Endpoint(), urlPath))
if err != nil {
return nil, err
}
reqQP := req.Raw().URL.Query()
reqQP.Set("api-version", "2024-05-01")
req.Raw().URL.RawQuery = reqQP.Encode()
req.Raw().Header["Accept"] = []string{"application/json"}
if options != nil && options.IfMatch != nil {
req.Raw().Header["If-Match"] = []string{*options.IfMatch}
}
if err := runtime.MarshalAsJSON(req, parameters); err != nil {
return nil, err
}
return req, nil
}
// createOrUpdateHandleResponse handles the CreateOrUpdate response.
func (client *WorkspaceAPIReleaseClient) createOrUpdateHandleResponse(resp *http.Response) (WorkspaceAPIReleaseClientCreateOrUpdateResponse, error) {
result := WorkspaceAPIReleaseClientCreateOrUpdateResponse{}
if val := resp.Header.Get("ETag"); val != "" {
result.ETag = &val
}
if err := runtime.UnmarshalAsJSON(resp, &result.APIReleaseContract); err != nil {
return WorkspaceAPIReleaseClientCreateOrUpdateResponse{}, err
}
return result, nil
}
// Delete - Deletes the specified release in the API.
// If the operation fails it returns an *azcore.ResponseError type.
//
// Generated from API version 2024-05-01
// - resourceGroupName - The name of the resource group. The name is case insensitive.
// - serviceName - The name of the API Management service.
// - workspaceID - Workspace identifier. Must be unique in the current API Management service instance.
// - apiID - API identifier. Must be unique in the current API Management service instance.
// - releaseID - Release identifier within an API. Must be unique in the current API Management service instance.
// - ifMatch - ETag of the Entity. ETag should match the current entity state from the header response of the GET request or
// it should be * for unconditional update.
// - options - WorkspaceAPIReleaseClientDeleteOptions contains the optional parameters for the WorkspaceAPIReleaseClient.Delete
// method.
func (client *WorkspaceAPIReleaseClient) Delete(ctx context.Context, resourceGroupName string, serviceName string, workspaceID string, apiID string, releaseID string, ifMatch string, options *WorkspaceAPIReleaseClientDeleteOptions) (WorkspaceAPIReleaseClientDeleteResponse, error) {
var err error
const operationName = "WorkspaceAPIReleaseClient.Delete"
ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, operationName)
ctx, endSpan := runtime.StartSpan(ctx, operationName, client.internal.Tracer(), nil)
defer func() { endSpan(err) }()
req, err := client.deleteCreateRequest(ctx, resourceGroupName, serviceName, workspaceID, apiID, releaseID, ifMatch, options)
if err != nil {
return WorkspaceAPIReleaseClientDeleteResponse{}, err
}
httpResp, err := client.internal.Pipeline().Do(req)
if err != nil {
return WorkspaceAPIReleaseClientDeleteResponse{}, err
}
if !runtime.HasStatusCode(httpResp, http.StatusOK, http.StatusNoContent) {
err = runtime.NewResponseError(httpResp)
return WorkspaceAPIReleaseClientDeleteResponse{}, err
}
return WorkspaceAPIReleaseClientDeleteResponse{}, nil
}
// deleteCreateRequest creates the Delete request.
func (client *WorkspaceAPIReleaseClient) deleteCreateRequest(ctx context.Context, resourceGroupName string, serviceName string, workspaceID string, apiID string, releaseID string, ifMatch string, _ *WorkspaceAPIReleaseClientDeleteOptions) (*policy.Request, error) {
urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/apis/{apiId}/releases/{releaseId}"
if resourceGroupName == "" {
return nil, errors.New("parameter resourceGroupName cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName))
if serviceName == "" {
return nil, errors.New("parameter serviceName cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{serviceName}", url.PathEscape(serviceName))
if workspaceID == "" {
return nil, errors.New("parameter workspaceID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{workspaceId}", url.PathEscape(workspaceID))
if apiID == "" {
return nil, errors.New("parameter apiID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{apiId}", url.PathEscape(apiID))
if releaseID == "" {
return nil, errors.New("parameter releaseID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{releaseId}", url.PathEscape(releaseID))
if client.subscriptionID == "" {
return nil, errors.New("parameter client.subscriptionID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID))
req, err := runtime.NewRequest(ctx, http.MethodDelete, runtime.JoinPaths(client.internal.Endpoint(), urlPath))
if err != nil {
return nil, err
}
reqQP := req.Raw().URL.Query()
reqQP.Set("api-version", "2024-05-01")
req.Raw().URL.RawQuery = reqQP.Encode()
req.Raw().Header["Accept"] = []string{"application/json"}
req.Raw().Header["If-Match"] = []string{ifMatch}
return req, nil
}
// Get - Returns the details of an API release.
// If the operation fails it returns an *azcore.ResponseError type.
//
// Generated from API version 2024-05-01
// - resourceGroupName - The name of the resource group. The name is case insensitive.
// - serviceName - The name of the API Management service.
// - workspaceID - Workspace identifier. Must be unique in the current API Management service instance.
// - apiID - API identifier. Must be unique in the current API Management service instance.
// - releaseID - Release identifier within an API. Must be unique in the current API Management service instance.
// - options - WorkspaceAPIReleaseClientGetOptions contains the optional parameters for the WorkspaceAPIReleaseClient.Get method.
func (client *WorkspaceAPIReleaseClient) Get(ctx context.Context, resourceGroupName string, serviceName string, workspaceID string, apiID string, releaseID string, options *WorkspaceAPIReleaseClientGetOptions) (WorkspaceAPIReleaseClientGetResponse, error) {
var err error
const operationName = "WorkspaceAPIReleaseClient.Get"
ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, operationName)
ctx, endSpan := runtime.StartSpan(ctx, operationName, client.internal.Tracer(), nil)
defer func() { endSpan(err) }()
req, err := client.getCreateRequest(ctx, resourceGroupName, serviceName, workspaceID, apiID, releaseID, options)
if err != nil {
return WorkspaceAPIReleaseClientGetResponse{}, err
}
httpResp, err := client.internal.Pipeline().Do(req)
if err != nil {
return WorkspaceAPIReleaseClientGetResponse{}, err
}
if !runtime.HasStatusCode(httpResp, http.StatusOK) {
err = runtime.NewResponseError(httpResp)
return WorkspaceAPIReleaseClientGetResponse{}, err
}
resp, err := client.getHandleResponse(httpResp)
return resp, err
}
// getCreateRequest creates the Get request.
func (client *WorkspaceAPIReleaseClient) getCreateRequest(ctx context.Context, resourceGroupName string, serviceName string, workspaceID string, apiID string, releaseID string, _ *WorkspaceAPIReleaseClientGetOptions) (*policy.Request, error) {
urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/apis/{apiId}/releases/{releaseId}"
if resourceGroupName == "" {
return nil, errors.New("parameter resourceGroupName cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName))
if serviceName == "" {
return nil, errors.New("parameter serviceName cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{serviceName}", url.PathEscape(serviceName))
if workspaceID == "" {
return nil, errors.New("parameter workspaceID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{workspaceId}", url.PathEscape(workspaceID))
if apiID == "" {
return nil, errors.New("parameter apiID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{apiId}", url.PathEscape(apiID))
if releaseID == "" {
return nil, errors.New("parameter releaseID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{releaseId}", url.PathEscape(releaseID))
if client.subscriptionID == "" {
return nil, errors.New("parameter client.subscriptionID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID))
req, err := runtime.NewRequest(ctx, http.MethodGet, runtime.JoinPaths(client.internal.Endpoint(), urlPath))
if err != nil {
return nil, err
}
reqQP := req.Raw().URL.Query()
reqQP.Set("api-version", "2024-05-01")
req.Raw().URL.RawQuery = reqQP.Encode()
req.Raw().Header["Accept"] = []string{"application/json"}
return req, nil
}
// getHandleResponse handles the Get response.
func (client *WorkspaceAPIReleaseClient) getHandleResponse(resp *http.Response) (WorkspaceAPIReleaseClientGetResponse, error) {
result := WorkspaceAPIReleaseClientGetResponse{}
if val := resp.Header.Get("ETag"); val != "" {
result.ETag = &val
}
if err := runtime.UnmarshalAsJSON(resp, &result.APIReleaseContract); err != nil {
return WorkspaceAPIReleaseClientGetResponse{}, err
}
return result, nil
}
// GetEntityTag - Returns the etag of an API release.
//
// Generated from API version 2024-05-01
// - resourceGroupName - The name of the resource group. The name is case insensitive.
// - serviceName - The name of the API Management service.
// - workspaceID - Workspace identifier. Must be unique in the current API Management service instance.
// - apiID - API identifier. Must be unique in the current API Management service instance.
// - releaseID - Release identifier within an API. Must be unique in the current API Management service instance.
// - options - WorkspaceAPIReleaseClientGetEntityTagOptions contains the optional parameters for the WorkspaceAPIReleaseClient.GetEntityTag
// method.
func (client *WorkspaceAPIReleaseClient) GetEntityTag(ctx context.Context, resourceGroupName string, serviceName string, workspaceID string, apiID string, releaseID string, options *WorkspaceAPIReleaseClientGetEntityTagOptions) (WorkspaceAPIReleaseClientGetEntityTagResponse, error) {
var err error
const operationName = "WorkspaceAPIReleaseClient.GetEntityTag"
ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, operationName)
ctx, endSpan := runtime.StartSpan(ctx, operationName, client.internal.Tracer(), nil)
defer func() { endSpan(err) }()
req, err := client.getEntityTagCreateRequest(ctx, resourceGroupName, serviceName, workspaceID, apiID, releaseID, options)
if err != nil {
return WorkspaceAPIReleaseClientGetEntityTagResponse{}, err
}
httpResp, err := client.internal.Pipeline().Do(req)
if err != nil {
return WorkspaceAPIReleaseClientGetEntityTagResponse{}, err
}
if !runtime.HasStatusCode(httpResp, http.StatusOK) {
err = runtime.NewResponseError(httpResp)
return WorkspaceAPIReleaseClientGetEntityTagResponse{}, err
}
resp, err := client.getEntityTagHandleResponse(httpResp)
return resp, err
}
// getEntityTagCreateRequest creates the GetEntityTag request.
func (client *WorkspaceAPIReleaseClient) getEntityTagCreateRequest(ctx context.Context, resourceGroupName string, serviceName string, workspaceID string, apiID string, releaseID string, _ *WorkspaceAPIReleaseClientGetEntityTagOptions) (*policy.Request, error) {
urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/apis/{apiId}/releases/{releaseId}"
if resourceGroupName == "" {
return nil, errors.New("parameter resourceGroupName cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName))
if serviceName == "" {
return nil, errors.New("parameter serviceName cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{serviceName}", url.PathEscape(serviceName))
if workspaceID == "" {
return nil, errors.New("parameter workspaceID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{workspaceId}", url.PathEscape(workspaceID))
if apiID == "" {
return nil, errors.New("parameter apiID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{apiId}", url.PathEscape(apiID))
if releaseID == "" {
return nil, errors.New("parameter releaseID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{releaseId}", url.PathEscape(releaseID))
if client.subscriptionID == "" {
return nil, errors.New("parameter client.subscriptionID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID))
req, err := runtime.NewRequest(ctx, http.MethodHead, runtime.JoinPaths(client.internal.Endpoint(), urlPath))
if err != nil {
return nil, err
}
reqQP := req.Raw().URL.Query()
reqQP.Set("api-version", "2024-05-01")
req.Raw().URL.RawQuery = reqQP.Encode()
req.Raw().Header["Accept"] = []string{"application/json"}
return req, nil
}
// getEntityTagHandleResponse handles the GetEntityTag response.
func (client *WorkspaceAPIReleaseClient) getEntityTagHandleResponse(resp *http.Response) (WorkspaceAPIReleaseClientGetEntityTagResponse, error) {
result := WorkspaceAPIReleaseClientGetEntityTagResponse{Success: resp.StatusCode >= 200 && resp.StatusCode < 300}
if val := resp.Header.Get("ETag"); val != "" {
result.ETag = &val
}
return result, nil
}
// NewListByServicePager - Lists all releases of an API. An API release is created when making an API Revision current. Releases
// are also used to rollback to previous revisions. Results will be paged and can be constrained by
// the $top and $skip parameters.
//
// Generated from API version 2024-05-01
// - resourceGroupName - The name of the resource group. The name is case insensitive.
// - serviceName - The name of the API Management service.
// - workspaceID - Workspace identifier. Must be unique in the current API Management service instance.
// - apiID - API identifier. Must be unique in the current API Management service instance.
// - options - WorkspaceAPIReleaseClientListByServiceOptions contains the optional parameters for the WorkspaceAPIReleaseClient.NewListByServicePager
// method.
func (client *WorkspaceAPIReleaseClient) NewListByServicePager(resourceGroupName string, serviceName string, workspaceID string, apiID string, options *WorkspaceAPIReleaseClientListByServiceOptions) *runtime.Pager[WorkspaceAPIReleaseClientListByServiceResponse] {
return runtime.NewPager(runtime.PagingHandler[WorkspaceAPIReleaseClientListByServiceResponse]{
More: func(page WorkspaceAPIReleaseClientListByServiceResponse) bool {
return page.NextLink != nil && len(*page.NextLink) > 0
},
Fetcher: func(ctx context.Context, page *WorkspaceAPIReleaseClientListByServiceResponse) (WorkspaceAPIReleaseClientListByServiceResponse, error) {
ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, "WorkspaceAPIReleaseClient.NewListByServicePager")
nextLink := ""
if page != nil {
nextLink = *page.NextLink
}
resp, err := runtime.FetcherForNextLink(ctx, client.internal.Pipeline(), nextLink, func(ctx context.Context) (*policy.Request, error) {
return client.listByServiceCreateRequest(ctx, resourceGroupName, serviceName, workspaceID, apiID, options)
}, nil)
if err != nil {
return WorkspaceAPIReleaseClientListByServiceResponse{}, err
}
return client.listByServiceHandleResponse(resp)
},
Tracer: client.internal.Tracer(),
})
}
// listByServiceCreateRequest creates the ListByService request.
func (client *WorkspaceAPIReleaseClient) listByServiceCreateRequest(ctx context.Context, resourceGroupName string, serviceName string, workspaceID string, apiID string, options *WorkspaceAPIReleaseClientListByServiceOptions) (*policy.Request, error) {
urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/apis/{apiId}/releases"
if resourceGroupName == "" {
return nil, errors.New("parameter resourceGroupName cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName))
if serviceName == "" {
return nil, errors.New("parameter serviceName cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{serviceName}", url.PathEscape(serviceName))
if workspaceID == "" {
return nil, errors.New("parameter workspaceID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{workspaceId}", url.PathEscape(workspaceID))
if apiID == "" {
return nil, errors.New("parameter apiID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{apiId}", url.PathEscape(apiID))
if client.subscriptionID == "" {
return nil, errors.New("parameter client.subscriptionID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID))
req, err := runtime.NewRequest(ctx, http.MethodGet, runtime.JoinPaths(client.internal.Endpoint(), urlPath))
if err != nil {
return nil, err
}
reqQP := req.Raw().URL.Query()
if options != nil && options.Filter != nil {
reqQP.Set("$filter", *options.Filter)
}
if options != nil && options.Skip != nil {
reqQP.Set("$skip", strconv.FormatInt(int64(*options.Skip), 10))
}
if options != nil && options.Top != nil {
reqQP.Set("$top", strconv.FormatInt(int64(*options.Top), 10))
}
reqQP.Set("api-version", "2024-05-01")
req.Raw().URL.RawQuery = reqQP.Encode()
req.Raw().Header["Accept"] = []string{"application/json"}
return req, nil
}
// listByServiceHandleResponse handles the ListByService response.
func (client *WorkspaceAPIReleaseClient) listByServiceHandleResponse(resp *http.Response) (WorkspaceAPIReleaseClientListByServiceResponse, error) {
result := WorkspaceAPIReleaseClientListByServiceResponse{}
if err := runtime.UnmarshalAsJSON(resp, &result.APIReleaseCollection); err != nil {
return WorkspaceAPIReleaseClientListByServiceResponse{}, err
}
return result, nil
}
// Update - Updates the details of the release of the API specified by its identifier.
// If the operation fails it returns an *azcore.ResponseError type.
//
// Generated from API version 2024-05-01
// - resourceGroupName - The name of the resource group. The name is case insensitive.
// - serviceName - The name of the API Management service.
// - workspaceID - Workspace identifier. Must be unique in the current API Management service instance.
// - apiID - API identifier. Must be unique in the current API Management service instance.
// - releaseID - Release identifier within an API. Must be unique in the current API Management service instance.
// - ifMatch - ETag of the Entity. ETag should match the current entity state from the header response of the GET request or
// it should be * for unconditional update.
// - parameters - API Release Update parameters.
// - options - WorkspaceAPIReleaseClientUpdateOptions contains the optional parameters for the WorkspaceAPIReleaseClient.Update
// method.
func (client *WorkspaceAPIReleaseClient) Update(ctx context.Context, resourceGroupName string, serviceName string, workspaceID string, apiID string, releaseID string, ifMatch string, parameters APIReleaseContract, options *WorkspaceAPIReleaseClientUpdateOptions) (WorkspaceAPIReleaseClientUpdateResponse, error) {
var err error
const operationName = "WorkspaceAPIReleaseClient.Update"
ctx = context.WithValue(ctx, runtime.CtxAPINameKey{}, operationName)
ctx, endSpan := runtime.StartSpan(ctx, operationName, client.internal.Tracer(), nil)
defer func() { endSpan(err) }()
req, err := client.updateCreateRequest(ctx, resourceGroupName, serviceName, workspaceID, apiID, releaseID, ifMatch, parameters, options)
if err != nil {
return WorkspaceAPIReleaseClientUpdateResponse{}, err
}
httpResp, err := client.internal.Pipeline().Do(req)
if err != nil {
return WorkspaceAPIReleaseClientUpdateResponse{}, err
}
if !runtime.HasStatusCode(httpResp, http.StatusOK) {
err = runtime.NewResponseError(httpResp)
return WorkspaceAPIReleaseClientUpdateResponse{}, err
}
resp, err := client.updateHandleResponse(httpResp)
return resp, err
}
// updateCreateRequest creates the Update request.
func (client *WorkspaceAPIReleaseClient) updateCreateRequest(ctx context.Context, resourceGroupName string, serviceName string, workspaceID string, apiID string, releaseID string, ifMatch string, parameters APIReleaseContract, _ *WorkspaceAPIReleaseClientUpdateOptions) (*policy.Request, error) {
urlPath := "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/apis/{apiId}/releases/{releaseId}"
if resourceGroupName == "" {
return nil, errors.New("parameter resourceGroupName cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{resourceGroupName}", url.PathEscape(resourceGroupName))
if serviceName == "" {
return nil, errors.New("parameter serviceName cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{serviceName}", url.PathEscape(serviceName))
if workspaceID == "" {
return nil, errors.New("parameter workspaceID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{workspaceId}", url.PathEscape(workspaceID))
if apiID == "" {
return nil, errors.New("parameter apiID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{apiId}", url.PathEscape(apiID))
if releaseID == "" {
return nil, errors.New("parameter releaseID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{releaseId}", url.PathEscape(releaseID))
if client.subscriptionID == "" {
return nil, errors.New("parameter client.subscriptionID cannot be empty")
}
urlPath = strings.ReplaceAll(urlPath, "{subscriptionId}", url.PathEscape(client.subscriptionID))
req, err := runtime.NewRequest(ctx, http.MethodPatch, runtime.JoinPaths(client.internal.Endpoint(), urlPath))
if err != nil {
return nil, err
}
reqQP := req.Raw().URL.Query()
reqQP.Set("api-version", "2024-05-01")
req.Raw().URL.RawQuery = reqQP.Encode()
req.Raw().Header["Accept"] = []string{"application/json"}
req.Raw().Header["If-Match"] = []string{ifMatch}
if err := runtime.MarshalAsJSON(req, parameters); err != nil {
return nil, err
}
return req, nil
}
// updateHandleResponse handles the Update response.
func (client *WorkspaceAPIReleaseClient) updateHandleResponse(resp *http.Response) (WorkspaceAPIReleaseClientUpdateResponse, error) {
result := WorkspaceAPIReleaseClientUpdateResponse{}
if val := resp.Header.Get("ETag"); val != "" {
result.ETag = &val
}
if err := runtime.UnmarshalAsJSON(resp, &result.APIReleaseContract); err != nil {
return WorkspaceAPIReleaseClientUpdateResponse{}, err
}
return result, nil
}