deployments
Creates, updates, deletes, gets or lists a deployments resource.
Overview
| Name | deployments |
| Type | Resource |
| Id | azure.api_center.deployments |
Fields
The following fields are returned by SELECT queries:
- get
- list
Azure operation completed successfully.
| Name | Datatype | Description |
|---|---|---|
properties | object | The resource-specific properties for this resource. |
Azure operation completed successfully.
| Name | Datatype | Description |
|---|---|---|
properties | object | The resource-specific properties for this resource. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | subscriptionId, resourceGroupName, serviceName, workspaceName, apiName, deploymentName | Returns details of the API deployment. | |
list | select | subscriptionId, resourceGroupName, serviceName, workspaceName, apiName | $filter | Returns a collection of API deployments. |
create_or_update | insert | subscriptionId, resourceGroupName, serviceName, workspaceName, apiName, deploymentName | Creates new or updates existing API deployment. | |
delete | delete | subscriptionId, resourceGroupName, serviceName, workspaceName, apiName, deploymentName | Deletes API deployment. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
apiName | string | The name of the API. |
deploymentName | string | The name of the API deployment. |
resourceGroupName | string | The name of the resource group. The name is case insensitive. |
serviceName | string | The name of Azure API Center service. |
subscriptionId | string (uuid) | The ID of the target subscription. The value must be an UUID. |
workspaceName | string | The name of the workspace. |
$filter | string | OData filter parameter. |
SELECT examples
- get
- list
Returns details of the API deployment.
SELECT
properties
FROM azure.api_center.deployments
WHERE subscriptionId = '{{ subscriptionId }}' -- required
AND resourceGroupName = '{{ resourceGroupName }}' -- required
AND serviceName = '{{ serviceName }}' -- required
AND workspaceName = '{{ workspaceName }}' -- required
AND apiName = '{{ apiName }}' -- required
AND deploymentName = '{{ deploymentName }}' -- required
;
Returns a collection of API deployments.
SELECT
properties
FROM azure.api_center.deployments
WHERE subscriptionId = '{{ subscriptionId }}' -- required
AND resourceGroupName = '{{ resourceGroupName }}' -- required
AND serviceName = '{{ serviceName }}' -- required
AND workspaceName = '{{ workspaceName }}' -- required
AND apiName = '{{ apiName }}' -- required
AND $filter = '{{ $filter }}'
;
INSERT examples
- create_or_update
- Manifest
Creates new or updates existing API deployment.
INSERT INTO azure.api_center.deployments (
data__properties,
subscriptionId,
resourceGroupName,
serviceName,
workspaceName,
apiName,
deploymentName
)
SELECT
'{{ properties }}',
'{{ subscriptionId }}',
'{{ resourceGroupName }}',
'{{ serviceName }}',
'{{ workspaceName }}',
'{{ apiName }}',
'{{ deploymentName }}'
RETURNING
properties
;
# Description fields are for documentation purposes
- name: deployments
props:
- name: subscriptionId
value: string (uuid)
description: Required parameter for the deployments resource.
- name: resourceGroupName
value: string
description: Required parameter for the deployments resource.
- name: serviceName
value: string
description: Required parameter for the deployments resource.
- name: workspaceName
value: string
description: Required parameter for the deployments resource.
- name: apiName
value: string
description: Required parameter for the deployments resource.
- name: deploymentName
value: string
description: Required parameter for the deployments resource.
- name: properties
value: object
description: |
The resource-specific properties for this resource.
DELETE examples
- delete
Deletes API deployment.
DELETE FROM azure.api_center.deployments
WHERE subscriptionId = '{{ subscriptionId }}' --required
AND resourceGroupName = '{{ resourceGroupName }}' --required
AND serviceName = '{{ serviceName }}' --required
AND workspaceName = '{{ workspaceName }}' --required
AND apiName = '{{ apiName }}' --required
AND deploymentName = '{{ deploymentName }}' --required
;