Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Bicep resource definition
The namespaces/jobs resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
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:
- Resource groups - See resource group deployment commands For a list of changed properties in each API version, see change log.
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 |
|---|