Skip to main content

workspaces

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

Overview

Nameworkspaces
TypeResource
Idazure.quantum.workspaces

Fields

NameDatatypeDescription
api_key_enabledtextfield from the properties object
endpoint_uritextfield from the properties object
identitytextManaged Identity information.
locationtextThe geo-location where the resource lives
providerstextfield from the properties object
provisioning_statetextfield from the properties object
resourceGroupNametextfield from the properties object
storage_accounttextfield from the properties object
subscriptionIdtextfield from the properties object
system_datatextfield from the properties object
tagstextResource tags.
usabletextfield from the properties object
workspaceNametextfield from the properties object

Methods

NameAccessible byRequired ParamsDescription
getSELECTresourceGroupName, subscriptionId, workspaceNameReturns the Workspace resource associated with the given name.
list_by_resource_groupSELECTresourceGroupName, subscriptionIdGets the list of Workspaces within a resource group.
list_by_subscriptionSELECTsubscriptionIdGets the list of Workspaces within a Subscription.
create_or_updateINSERTresourceGroupName, subscriptionId, workspaceNameCreates or updates a workspace resource.
deleteDELETEresourceGroupName, subscriptionId, workspaceNameDeletes a Workspace resource.
check_name_availabilityEXEClocationName, subscriptionIdCheck the availability of the resource name.
regenerate_keysEXECresourceGroupName, subscriptionId, workspaceNameRegenerate either the primary or secondary key for use with the Quantum APIs. The old key will stop working immediately.
update_tagsEXECresourceGroupName, subscriptionId, workspaceNameUpdates an existing workspace's tags.

SELECT examples

Gets the list of Workspaces within a Subscription.

SELECT
api_key_enabled,
endpoint_uri,
identity,
location,
providers,
provisioning_state,
resourceGroupName,
storage_account,
subscriptionId,
system_data,
tags,
usable,
workspaceName
FROM azure.quantum.vw_workspaces
WHERE subscriptionId = '{{ subscriptionId }}';

INSERT example

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

/*+ create */
INSERT INTO azure.quantum.workspaces (
resourceGroupName,
subscriptionId,
workspaceName,
properties,
identity,
tags,
location
)
SELECT
'{{ resourceGroupName }}',
'{{ subscriptionId }}',
'{{ workspaceName }}',
'{{ properties }}',
'{{ identity }}',
'{{ tags }}',
'{{ location }}'
;

DELETE example

Deletes the specified workspaces resource.

/*+ delete */
DELETE FROM azure.quantum.workspaces
WHERE resourceGroupName = '{{ resourceGroupName }}'
AND subscriptionId = '{{ subscriptionId }}'
AND workspaceName = '{{ workspaceName }}';