Microsoft.DeviceRegistry namespaces/jobs

Bicep resource definition

The namespaces/jobs resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.DeviceRegistry/namespaces/jobs resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.DeviceRegistry/namespaces/jobs@2026-11-02-preview' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    description: 'string'
    displayName: 'string'
    jobType: 'string'
    // For remaining properties, see JobProperties objects
  }
  tags: {
    {customized property}: 'string'
  }
}

JobProperties objects

Set the jobType property to specify the type of object.

For OnboardingUpdate, use:

{
  definition: {
    schedulingType: 'string'
    updateResourceId: 'string'
  }
  jobType: 'OnboardingUpdate'
}

For SoftwareUpdate, use:

{
  definition: {
    schedulingType: 'string'
    updateResourceId: 'string'
  }
  jobType: 'SoftwareUpdate'
  target: {
    resourceId: 'string'
  }
}

Property Values

Microsoft.DeviceRegistry/namespaces/jobs

Name Description Value
location The geo-location where the resource lives string (required)
name The resource name string

Constraints:
Min length = 3
Max length = 63
Pattern = ^[0-9a-zA-Z][a-zA-Z0-9-]*$ (required)
parent In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource.

For more information, see Child resource outside parent resource.
Symbolic name for resource of type: namespaces
properties The resource-specific properties for this resource. JobProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates

JobProperties

Name Description Value
description Human-readable description of the resource. string

Constraints:
Max length = 1024
displayName Human-readable display name for the resource. string

Constraints:
Max length = 256
jobType Set to 'OnboardingUpdate' for type OnboardingUpdateJobProperties. Set to 'SoftwareUpdate' for type SoftwareUpdateJobProperties. 'OnboardingUpdate'
'SoftwareUpdate' (required)

JobTarget

Name Description Value
resourceId The Azure resource ID of the target group. Must reference a Microsoft.DeviceRegistry/namespaces/groups resource. string (required)

OnboardingUpdateJobDefinition

Name Description Value
schedulingType The scheduling type for the OnboardingUpdate job. OnboardingUpdate jobs are always continuous: ADU deployments target all compatible devices until superseded, canceled, or the parent job is deleted. 'Continuous' (required)
updateResourceId The update resource URI for the job. string (required)

OnboardingUpdateJobProperties

Name Description Value
definition The update definition for the onboarding job. Set at create time; immutable thereafter. OnboardingUpdateJobDefinition (required)
jobType The type of the job. Set at create time; immutable thereafter. 'OnboardingUpdate' (required)

SoftwareUpdateJobDefinition

Name Description Value
schedulingType The scheduling type for the SoftwareUpdate job. SoftwareUpdate jobs are always continuous: ADU deployments target the group until superseded, canceled, or the parent job is deleted. 'Continuous' (required)
updateResourceId The update resource URI for the job. string (required)

SoftwareUpdateJobProperties

Name Description Value
definition The update definition for the job. Set at create time; immutable thereafter. SoftwareUpdateJobDefinition (required)
jobType The type of the job. Set at create time; immutable thereafter. 'SoftwareUpdate' (required)
target The target of the job. Set at create time; immutable thereafter. JobTarget (required)

TrackedResourceTags

Name Description Value

ARM template resource definition

The namespaces/jobs resource type can be deployed with operations that target:

Usage Examples

Resource format

To create a Microsoft.DeviceRegistry/namespaces/jobs resource, add the following JSON to your template.

{
  "type": "Microsoft.DeviceRegistry/namespaces/jobs",
  "apiVersion": "2026-11-02-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "description": "string",
    "displayName": "string",
    "jobType": "string"
    // For remaining properties, see JobProperties objects
  },
  "tags": {
    "{customized property}": "string"
  }
}

JobProperties objects

Set the jobType property to specify the type of object.

For OnboardingUpdate, use:

{
  "definition": {
    "schedulingType": "string",
    "updateResourceId": "string"
  },
  "jobType": "OnboardingUpdate"
}

For SoftwareUpdate, use:

{
  "definition": {
    "schedulingType": "string",
    "updateResourceId": "string"
  },
  "jobType": "SoftwareUpdate",
  "target": {
    "resourceId": "string"
  }
}

Property Values

Microsoft.DeviceRegistry/namespaces/jobs

Name Description Value
apiVersion The api version '2026-11-02-preview'
location The geo-location where the resource lives string (required)
name The resource name string

Constraints:
Min length = 3
Max length = 63
Pattern = ^[0-9a-zA-Z][a-zA-Z0-9-]*$ (required)
properties The resource-specific properties for this resource. JobProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates
type The resource type 'Microsoft.DeviceRegistry/namespaces/jobs'

JobProperties

Name Description Value
description Human-readable description of the resource. string

Constraints:
Max length = 1024
displayName Human-readable display name for the resource. string

Constraints:
Max length = 256
jobType Set to 'OnboardingUpdate' for type OnboardingUpdateJobProperties. Set to 'SoftwareUpdate' for type SoftwareUpdateJobProperties. 'OnboardingUpdate'
'SoftwareUpdate' (required)

JobTarget

Name Description Value
resourceId The Azure resource ID of the target group. Must reference a Microsoft.DeviceRegistry/namespaces/groups resource. string (required)

OnboardingUpdateJobDefinition

Name Description Value
schedulingType The scheduling type for the OnboardingUpdate job. OnboardingUpdate jobs are always continuous: ADU deployments target all compatible devices until superseded, canceled, or the parent job is deleted. 'Continuous' (required)
updateResourceId The update resource URI for the job. string (required)

OnboardingUpdateJobProperties

Name Description Value
definition The update definition for the onboarding job. Set at create time; immutable thereafter. OnboardingUpdateJobDefinition (required)
jobType The type of the job. Set at create time; immutable thereafter. 'OnboardingUpdate' (required)

SoftwareUpdateJobDefinition

Name Description Value
schedulingType The scheduling type for the SoftwareUpdate job. SoftwareUpdate jobs are always continuous: ADU deployments target the group until superseded, canceled, or the parent job is deleted. 'Continuous' (required)
updateResourceId The update resource URI for the job. string (required)

SoftwareUpdateJobProperties

Name Description Value
definition The update definition for the job. Set at create time; immutable thereafter. SoftwareUpdateJobDefinition (required)
jobType The type of the job. Set at create time; immutable thereafter. 'SoftwareUpdate' (required)
target The target of the job. Set at create time; immutable thereafter. JobTarget (required)

TrackedResourceTags

Name Description Value

Terraform (AzAPI provider) resource definition

The namespaces/jobs resource type can be deployed with operations that target:

  • Resource groups For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.DeviceRegistry/namespaces/jobs resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DeviceRegistry/namespaces/jobs@2026-11-02-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      description = "string"
      displayName = "string"
      jobType = "string"
      // For remaining properties, see JobProperties objects
    }
  }
}

JobProperties objects

Set the jobType property to specify the type of object.

For OnboardingUpdate, use:

{
  definition = {
    schedulingType = "string"
    updateResourceId = "string"
  }
  jobType = "OnboardingUpdate"
}

For SoftwareUpdate, use:

{
  definition = {
    schedulingType = "string"
    updateResourceId = "string"
  }
  jobType = "SoftwareUpdate"
  target = {
    resourceId = "string"
  }
}

Property Values

Microsoft.DeviceRegistry/namespaces/jobs

Name Description Value
location The geo-location where the resource lives string (required)
name The resource name string

Constraints:
Min length = 3
Max length = 63
Pattern = ^[0-9a-zA-Z][a-zA-Z0-9-]*$ (required)
parent_id The ID of the resource that is the parent for this resource. ID for resource of type: namespaces
properties The resource-specific properties for this resource. JobProperties
tags Resource tags Dictionary of tag names and values.
type The resource type "Microsoft.DeviceRegistry/namespaces/jobs@2026-11-02-preview"

JobProperties

Name Description Value
description Human-readable description of the resource. string

Constraints:
Max length = 1024
displayName Human-readable display name for the resource. string

Constraints:
Max length = 256
jobType Set to 'OnboardingUpdate' for type OnboardingUpdateJobProperties. Set to 'SoftwareUpdate' for type SoftwareUpdateJobProperties. 'OnboardingUpdate'
'SoftwareUpdate' (required)

JobTarget

Name Description Value
resourceId The Azure resource ID of the target group. Must reference a Microsoft.DeviceRegistry/namespaces/groups resource. string (required)

OnboardingUpdateJobDefinition

Name Description Value
schedulingType The scheduling type for the OnboardingUpdate job. OnboardingUpdate jobs are always continuous: ADU deployments target all compatible devices until superseded, canceled, or the parent job is deleted. 'Continuous' (required)
updateResourceId The update resource URI for the job. string (required)

OnboardingUpdateJobProperties

Name Description Value
definition The update definition for the onboarding job. Set at create time; immutable thereafter. OnboardingUpdateJobDefinition (required)
jobType The type of the job. Set at create time; immutable thereafter. 'OnboardingUpdate' (required)

SoftwareUpdateJobDefinition

Name Description Value
schedulingType The scheduling type for the SoftwareUpdate job. SoftwareUpdate jobs are always continuous: ADU deployments target the group until superseded, canceled, or the parent job is deleted. 'Continuous' (required)
updateResourceId The update resource URI for the job. string (required)

SoftwareUpdateJobProperties

Name Description Value
definition The update definition for the job. Set at create time; immutable thereafter. SoftwareUpdateJobDefinition (required)
jobType The type of the job. Set at create time; immutable thereafter. 'SoftwareUpdate' (required)
target The target of the job. Set at create time; immutable thereafter. JobTarget (required)

TrackedResourceTags

Name Description Value