Skip to main content

api_releases

Creates, updates, deletes, gets or lists a api_releases resource.

Overview

Nameapi_releases
TypeResource
Idazure.api_management.api_releases

Fields

NameDatatypeDescription
apiIdtextfield from the properties object
api_idtextfield from the properties object
created_date_timetextfield from the properties object
notestextfield from the properties object
releaseIdtextfield from the properties object
resourceGroupNametextfield from the properties object
serviceNametextfield from the properties object
subscriptionIdtextfield from the properties object
updated_date_timetextfield from the properties object

Methods

NameAccessible byRequired ParamsDescription
getSELECTapiId, releaseId, resourceGroupName, serviceName, subscriptionIdReturns the details of an API release.
list_by_serviceSELECTapiId, resourceGroupName, serviceName, subscriptionIdLists 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.
create_or_updateINSERTapiId, releaseId, resourceGroupName, serviceName, subscriptionIdCreates a new Release for the API.
deleteDELETEIf-Match, apiId, releaseId, resourceGroupName, serviceName, subscriptionIdDeletes the specified release in the API.
updateUPDATEIf-Match, apiId, releaseId, resourceGroupName, serviceName, subscriptionIdUpdates the details of the release of the API specified by its identifier.

SELECT examples

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.

SELECT
apiId,
api_id,
created_date_time,
notes,
releaseId,
resourceGroupName,
serviceName,
subscriptionId,
updated_date_time
FROM azure.api_management.vw_api_releases
WHERE apiId = '{{ apiId }}'
AND resourceGroupName = '{{ resourceGroupName }}'
AND serviceName = '{{ serviceName }}'
AND subscriptionId = '{{ subscriptionId }}';

INSERT example

Use the following StackQL query and manifest file to create a new api_releases resource.

/*+ create */
INSERT INTO azure.api_management.api_releases (
apiId,
releaseId,
resourceGroupName,
serviceName,
subscriptionId,
properties
)
SELECT
'{{ apiId }}',
'{{ releaseId }}',
'{{ resourceGroupName }}',
'{{ serviceName }}',
'{{ subscriptionId }}',
'{{ properties }}'
;

UPDATE example

Updates a api_releases resource.

/*+ update */
UPDATE azure.api_management.api_releases
SET
properties = '{{ properties }}'
WHERE
If-Match = '{{ If-Match }}'
AND apiId = '{{ apiId }}'
AND releaseId = '{{ releaseId }}'
AND resourceGroupName = '{{ resourceGroupName }}'
AND serviceName = '{{ serviceName }}'
AND subscriptionId = '{{ subscriptionId }}';

DELETE example

Deletes the specified api_releases resource.

/*+ delete */
DELETE FROM azure.api_management.api_releases
WHERE If-Match = '{{ If-Match }}'
AND apiId = '{{ apiId }}'
AND releaseId = '{{ releaseId }}'
AND resourceGroupName = '{{ resourceGroupName }}'
AND serviceName = '{{ serviceName }}'
AND subscriptionId = '{{ subscriptionId }}';