Skip to main content

workspace_groups

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

Overview

Nameworkspace_groups
TypeResource
Idazure.api_management.workspace_groups

Fields

NameDatatypeDescription
descriptiontextfield from the properties object
built_intextfield from the properties object
display_nametextfield from the properties object
external_idtextfield from the properties object
groupIdtextfield from the properties object
resourceGroupNametextfield from the properties object
serviceNametextfield from the properties object
subscriptionIdtextfield from the properties object
typetextfield from the properties object
workspaceIdtextfield from the properties object

Methods

NameAccessible byRequired ParamsDescription
getSELECTgroupId, resourceGroupName, serviceName, subscriptionId, workspaceIdGets the details of the group specified by its identifier.
list_by_serviceSELECTresourceGroupName, serviceName, subscriptionId, workspaceIdLists a collection of groups defined within a workspace in a service instance.
create_or_updateINSERTgroupId, resourceGroupName, serviceName, subscriptionId, workspaceIdCreates or Updates a group.
deleteDELETEIf-Match, groupId, resourceGroupName, serviceName, subscriptionId, workspaceIdDeletes specific group of the workspace in an API Management service instance.
updateUPDATEIf-Match, groupId, resourceGroupName, serviceName, subscriptionId, workspaceIdUpdates the details of the group specified by its identifier.

SELECT examples

Lists a collection of groups defined within a workspace in a service instance.

SELECT
description,
built_in,
display_name,
external_id,
groupId,
resourceGroupName,
serviceName,
subscriptionId,
type,
workspaceId
FROM azure.api_management.vw_workspace_groups
WHERE resourceGroupName = '{{ resourceGroupName }}'
AND serviceName = '{{ serviceName }}'
AND subscriptionId = '{{ subscriptionId }}'
AND workspaceId = '{{ workspaceId }}';

INSERT example

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

/*+ create */
INSERT INTO azure.api_management.workspace_groups (
groupId,
resourceGroupName,
serviceName,
subscriptionId,
workspaceId,
properties
)
SELECT
'{{ groupId }}',
'{{ resourceGroupName }}',
'{{ serviceName }}',
'{{ subscriptionId }}',
'{{ workspaceId }}',
'{{ properties }}'
;

UPDATE example

Updates a workspace_groups resource.

/*+ update */
UPDATE azure.api_management.workspace_groups
SET
properties = '{{ properties }}'
WHERE
If-Match = '{{ If-Match }}'
AND groupId = '{{ groupId }}'
AND resourceGroupName = '{{ resourceGroupName }}'
AND serviceName = '{{ serviceName }}'
AND subscriptionId = '{{ subscriptionId }}'
AND workspaceId = '{{ workspaceId }}';

DELETE example

Deletes the specified workspace_groups resource.

/*+ delete */
DELETE FROM azure.api_management.workspace_groups
WHERE If-Match = '{{ If-Match }}'
AND groupId = '{{ groupId }}'
AND resourceGroupName = '{{ resourceGroupName }}'
AND serviceName = '{{ serviceName }}'
AND subscriptionId = '{{ subscriptionId }}'
AND workspaceId = '{{ workspaceId }}';