workspaces

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

Overview

Name	workspaces
Type	Resource
Id	azure.api_center.workspaces

Fields

The following fields are returned by SELECT queries:

get

Azure operation completed successfully.

Name	Datatype	Description
properties	object	The resource-specific properties for this resource.

list

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		Returns details of the workspace.
list	select	subscriptionId, resourceGroupName, serviceName	$filter	Returns a collection of workspaces.
create_or_update	insert	subscriptionId, resourceGroupName, serviceName, workspaceName		Creates new or updates existing workspace.
delete	delete	subscriptionId, resourceGroupName, serviceName, workspaceName		Deletes specified workspace.

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
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

Returns details of the workspace.

SELECT
properties
FROM azure.api_center.workspaces
WHERE subscriptionId = '{{ subscriptionId }}' -- required
AND resourceGroupName = '{{ resourceGroupName }}' -- required
AND serviceName = '{{ serviceName }}' -- required
AND workspaceName = '{{ workspaceName }}' -- required
;

list

Returns a collection of workspaces.

SELECT
properties
FROM azure.api_center.workspaces
WHERE subscriptionId = '{{ subscriptionId }}' -- required
AND resourceGroupName = '{{ resourceGroupName }}' -- required
AND serviceName = '{{ serviceName }}' -- required
AND $filter = '{{ $filter }}'
;

INSERT examples

create_or_update

Creates new or updates existing workspace.

INSERT INTO azure.api_center.workspaces (
data__properties,
subscriptionId,
resourceGroupName,
serviceName,
workspaceName
)
SELECT 
'{{ properties }}',
'{{ subscriptionId }}',
'{{ resourceGroupName }}',
'{{ serviceName }}',
'{{ workspaceName }}'
RETURNING
properties
;

Manifest

# Description fields are for documentation purposes
- name: workspaces
  props:
    - name: subscriptionId
      value: string (uuid)
      description: Required parameter for the workspaces resource.
    - name: resourceGroupName
      value: string
      description: Required parameter for the workspaces resource.
    - name: serviceName
      value: string
      description: Required parameter for the workspaces resource.
    - name: workspaceName
      value: string
      description: Required parameter for the workspaces resource.
    - name: properties
      value: object
      description: |
        The resource-specific properties for this resource.

DELETE examples

delete

Deletes specified workspace.

DELETE FROM azure.api_center.workspaces
WHERE subscriptionId = '{{ subscriptionId }}' --required
AND resourceGroupName = '{{ resourceGroupName }}' --required
AND serviceName = '{{ serviceName }}' --required
AND workspaceName = '{{ workspaceName }}' --required
;