dicom_services

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

Overview

Name	dicom_services
Type	Resource
Id	azure_extras.health_data_services.dicom_services

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
id	string	Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}.
name	string	The name of the resource.
authenticationConfiguration	object	Dicom Service authentication configuration.
corsConfiguration	object	Dicom Service Cors configuration.
enableDataPartitions	boolean	If data partitions is enabled or not.
encryption	object	The encryption settings of the DICOM service.
etag	string	An etag associated with the resource, used for optimistic concurrency when editing it.
eventState	string	DICOM Service event support status. Known values are: "Disabled", "Enabled", and "Updating". (Disabled, Enabled, Updating)
identity	object	Setting indicating whether the service has a managed identity associated with it.
location	string	The common properties for any location based resource, tracked or proxy.
privateEndpointConnections	array	The list of private endpoint connections that are set up for this resource.
provisioningState	string	The provisioning state. Known values are: "Deleting", "Succeeded", "Creating", "Accepted", "Verifying", "Updating", "Failed", "Canceled", "Deprovisioned", "Moving", "Suspended", "Warned", and "SystemMaintenance". (Deleting, Succeeded, Creating, Accepted, Verifying, Updating, Failed, Canceled, Deprovisioned, Moving, Suspended, Warned, SystemMaintenance)
publicNetworkAccess	string	Control permission for data plane traffic coming from public networks while private endpoint is enabled. Known values are: "Enabled" and "Disabled". (Enabled, Disabled)
serviceUrl	string	The url of the Dicom Services.
storageConfiguration	object	The configuration of external storage account.
systemData	object	Azure Resource Manager metadata containing createdBy and modifiedBy information.
tags	object	The common properties of tracked resources in the service.
type	string	The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts".

list_by_workspace

Name	Datatype	Description
id	string	Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}.
name	string	The name of the resource.
authenticationConfiguration	object	Dicom Service authentication configuration.
corsConfiguration	object	Dicom Service Cors configuration.
enableDataPartitions	boolean	If data partitions is enabled or not.
encryption	object	The encryption settings of the DICOM service.
etag	string	An etag associated with the resource, used for optimistic concurrency when editing it.
eventState	string	DICOM Service event support status. Known values are: "Disabled", "Enabled", and "Updating". (Disabled, Enabled, Updating)
identity	object	Setting indicating whether the service has a managed identity associated with it.
location	string	The common properties for any location based resource, tracked or proxy.
privateEndpointConnections	array	The list of private endpoint connections that are set up for this resource.
provisioningState	string	The provisioning state. Known values are: "Deleting", "Succeeded", "Creating", "Accepted", "Verifying", "Updating", "Failed", "Canceled", "Deprovisioned", "Moving", "Suspended", "Warned", and "SystemMaintenance". (Deleting, Succeeded, Creating, Accepted, Verifying, Updating, Failed, Canceled, Deprovisioned, Moving, Suspended, Warned, SystemMaintenance)
publicNetworkAccess	string	Control permission for data plane traffic coming from public networks while private endpoint is enabled. Known values are: "Enabled" and "Disabled". (Enabled, Disabled)
serviceUrl	string	The url of the Dicom Services.
storageConfiguration	object	The configuration of external storage account.
systemData	object	Azure Resource Manager metadata containing createdBy and modifiedBy information.
tags	object	The common properties of tracked resources in the service.
type	string	The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts".

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	resource_group_name, workspace_name, dicom_service_name, subscription_id		Gets the properties of the specified DICOM Service.
list_by_workspace	select	resource_group_name, workspace_name, subscription_id		Lists all DICOM Services for the given workspace.
create_or_update	insert	resource_group_name, workspace_name, dicom_service_name, subscription_id		Creates or updates a DICOM Service resource with the specified parameters.
update	update	resource_group_name, dicom_service_name, workspace_name, subscription_id		Patch DICOM Service details.
create_or_update	replace	resource_group_name, workspace_name, dicom_service_name, subscription_id		Creates or updates a DICOM Service resource with the specified parameters.
delete	delete	resource_group_name, dicom_service_name, workspace_name, subscription_id		Deletes a DICOM Service.

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
dicom_service_name	string	The name of DICOM Service resource. Required.
resource_group_name	string	The name of the resource group. The name is case insensitive. Required.
subscription_id	string
workspace_name	string	The name of workspace resource. Required.

SELECT examples

get

Gets the properties of the specified DICOM Service.

SELECT
id,
name,
authenticationConfiguration,
corsConfiguration,
enableDataPartitions,
encryption,
etag,
eventState,
identity,
location,
privateEndpointConnections,
provisioningState,
publicNetworkAccess,
serviceUrl,
storageConfiguration,
systemData,
tags,
type
FROM azure_extras.health_data_services.dicom_services
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND workspace_name = '{{ workspace_name }}' -- required
AND dicom_service_name = '{{ dicom_service_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;

list_by_workspace

Lists all DICOM Services for the given workspace.

SELECT
id,
name,
authenticationConfiguration,
corsConfiguration,
enableDataPartitions,
encryption,
etag,
eventState,
identity,
location,
privateEndpointConnections,
provisioningState,
publicNetworkAccess,
serviceUrl,
storageConfiguration,
systemData,
tags,
type
FROM azure_extras.health_data_services.dicom_services
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND workspace_name = '{{ workspace_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;

INSERT examples

create_or_update

Creates or updates a DICOM Service resource with the specified parameters.

INSERT INTO azure_extras.health_data_services.dicom_services (
properties,
tags,
location,
etag,
identity,
resource_group_name,
workspace_name,
dicom_service_name,
subscription_id
)
SELECT 
'{{ properties }}',
'{{ tags }}',
'{{ location }}',
'{{ etag }}',
'{{ identity }}',
'{{ resource_group_name }}',
'{{ workspace_name }}',
'{{ dicom_service_name }}',
'{{ subscription_id }}'
RETURNING
id,
name,
etag,
identity,
location,
properties,
systemData,
tags,
type
;

Manifest

# Description fields are for documentation purposes
- name: dicom_services
props:
  - name: resource_group_name
    value: "{{ resource_group_name }}"
    description: Required parameter for the dicom_services resource.
  - name: workspace_name
    value: "{{ workspace_name }}"
    description: Required parameter for the dicom_services resource.
  - name: dicom_service_name
    value: "{{ dicom_service_name }}"
    description: Required parameter for the dicom_services resource.
  - name: subscription_id
    value: "{{ subscription_id }}"
    description: Required parameter for the dicom_services resource.
  - name: properties
    description: |
      Dicom Service configuration.
    value:
      provisioningState: "{{ provisioningState }}"
      authenticationConfiguration:
        authority: "{{ authority }}"
        audiences:
          - "{{ audiences }}"
      corsConfiguration:
        origins:
          - "{{ origins }}"
        headers:
          - "{{ headers }}"
        methods:
          - "{{ methods }}"
        maxAge: {{ maxAge }}
        allowCredentials: {{ allowCredentials }}
      serviceUrl: "{{ serviceUrl }}"
      privateEndpointConnections:
        - id: "{{ id }}"
          name: "{{ name }}"
          type: "{{ type }}"
          systemData:
            createdBy: "{{ createdBy }}"
            createdByType: "{{ createdByType }}"
            createdAt: "{{ createdAt }}"
            lastModifiedBy: "{{ lastModifiedBy }}"
            lastModifiedByType: "{{ lastModifiedByType }}"
            lastModifiedAt: "{{ lastModifiedAt }}"
          properties:
            privateEndpoint:
              id: "{{ id }}"
            privateLinkServiceConnectionState:
              status: "{{ status }}"
              description: "{{ description }}"
              actionsRequired: "{{ actionsRequired }}"
            provisioningState: "{{ provisioningState }}"
      publicNetworkAccess: "{{ publicNetworkAccess }}"
      eventState: "{{ eventState }}"
      encryption:
        customerManagedKeyEncryption:
          keyEncryptionKeyUrl: "{{ keyEncryptionKeyUrl }}"
      storageConfiguration:
        storageResourceId: "{{ storageResourceId }}"
        fileSystemName: "{{ fileSystemName }}"
        storageIndexingConfiguration:
          storageEventQueueName: "{{ storageEventQueueName }}"
      enableDataPartitions: {{ enableDataPartitions }}
  - name: tags
    value: "{{ tags }}"
    description: |
      The common properties of tracked resources in the service.
  - name: location
    value: "{{ location }}"
    description: |
      The common properties for any location based resource, tracked or proxy.
  - name: etag
    value: "{{ etag }}"
    description: |
      An etag associated with the resource, used for optimistic concurrency when editing it.
  - name: identity
    description: |
      Setting indicating whether the service has a managed identity associated with it.
    value:
      type: "{{ type }}"
      principalId: "{{ principalId }}"
      tenantId: "{{ tenantId }}"
      userAssignedIdentities: "{{ userAssignedIdentities }}"

UPDATE examples

update

Patch DICOM Service details.

UPDATE azure_extras.health_data_services.dicom_services
SET 
tags = '{{ tags }}',
identity = '{{ identity }}'
WHERE 
resource_group_name = '{{ resource_group_name }}' --required
AND dicom_service_name = '{{ dicom_service_name }}' --required
AND workspace_name = '{{ workspace_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
RETURNING
id,
name,
etag,
identity,
location,
properties,
systemData,
tags,
type;

REPLACE examples

create_or_update

Creates or updates a DICOM Service resource with the specified parameters.

REPLACE azure_extras.health_data_services.dicom_services
SET 
properties = '{{ properties }}',
tags = '{{ tags }}',
location = '{{ location }}',
etag = '{{ etag }}',
identity = '{{ identity }}'
WHERE 
resource_group_name = '{{ resource_group_name }}' --required
AND workspace_name = '{{ workspace_name }}' --required
AND dicom_service_name = '{{ dicom_service_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
RETURNING
id,
name,
etag,
identity,
location,
properties,
systemData,
tags,
type;

DELETE examples

delete

Deletes a DICOM Service.

DELETE FROM azure_extras.health_data_services.dicom_services
WHERE resource_group_name = '{{ resource_group_name }}' --required
AND dicom_service_name = '{{ dicom_service_name }}' --required
AND workspace_name = '{{ workspace_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
;