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 accounts/computes 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.CognitiveServices/accounts/computes resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.CognitiveServices/accounts/computes@2026-05-15-preview' = {
parent: resourceSymbolicName
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
kind: 'string'
location: 'string'
name: 'string'
properties: {
computeType: 'string'
// For remaining properties, see ComputeProperties objects
}
tags: {
{customized property}: 'string'
}
}
ComputeProperties objects
Set the computeType property to specify the type of object.
For Cluster, use:
{
computeType: 'Cluster'
pools: [
{
instanceType: 'string'
name: 'string'
nodeCount: int
vmPriority: 'string'
}
]
subnetArmId: 'string'
}
For ContainerInstance, use:
{
computeType: 'ContainerInstance'
idleTimeBeforeShutdown: 'string'
imageLink: 'string'
sshSettings: {
adminEnabled: bool
sshPublicKey: 'string'
}
targetClusterId: 'string'
}
Property Values
Microsoft.CognitiveServices/accounts/computes
| Name | Description | Value |
|---|---|---|
| identity | Identity for the resource. | Identity |
| kind | The kind (type) of compute resource. | string |
| location | The location of the compute resource. | string |
| name | The resource name | string Constraints: Min length = 1 Max length = 63 Pattern = ^[a-zA-Z0-9]([a-zA-Z0-9_-]*[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: accounts |
| properties | Polymorphic properties of the compute resource. Use computeType to select Cluster or ContainerInstance. | ComputeProperties (required) |
| tags | Resource tags | Dictionary of tag names and values. See Tags in templates |
ClusterComputeProperties
| Name | Description | Value |
|---|---|---|
| computeType | The type of compute resource. | 'Cluster' (required) |
| pools | Pools attached to this compute cluster. | Pool[] (required) |
| subnetArmId | ARM ID of the subnet used for compute. | string |
ComputeProperties
| Name | Description | Value |
|---|---|---|
| computeType | Set to 'Cluster' for type ClusterComputeProperties. Set to 'ContainerInstance' for type ContainerInstanceComputeProperties. | 'Cluster' 'ContainerInstance' (required) |
ComputeTags
| Name | Description | Value |
|---|
ContainerInstanceComputeProperties
| Name | Description | Value |
|---|---|---|
| computeType | The type of compute resource. | 'ContainerInstance' (required) |
| idleTimeBeforeShutdown | ISO 8601 duration before the idle instance is automatically shut down (e.g., 'PT30M'). | string |
| imageLink | Container image URI (e.g., MCR or ACR image path) for the container instance. | string (required) |
| sshSettings | SSH configuration for remote access to the container instance. | SshSettings |
| targetClusterId | ARM resource ID of the parent cluster that hosts this container instance. | string (required) |
Identity
| Name | Description | Value |
|---|---|---|
| type | The identity type. | 'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' |
| userAssignedIdentities | The list of user assigned identities associated with the resource. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Name | Description | Value |
|---|
Pool
| Name | Description | Value |
|---|---|---|
| instanceType | The instance type (VM SKU) used in the pool. | string (required) |
| name | The name of the pool. | string (required) |
| nodeCount | The number of nodes in the pool. | int (required) |
| vmPriority | The VM priority of the pool. | 'LowPriority' 'Regular' (required) |
SshSettings
| Name | Description | Value |
|---|---|---|
| adminEnabled | Whether SSH admin access is enabled. | bool |
| sshPublicKey | The SSH public key for authenticating to the compute instance. | string |
UserAssignedIdentity
| Name | Description | Value |
|---|
ARM template resource definition
The accounts/computes 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.CognitiveServices/accounts/computes resource, add the following JSON to your template.
{
"type": "Microsoft.CognitiveServices/accounts/computes",
"apiVersion": "2026-05-15-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"kind": "string",
"location": "string",
"properties": {
"computeType": "string"
// For remaining properties, see ComputeProperties objects
},
"tags": {
"{customized property}": "string"
}
}
ComputeProperties objects
Set the computeType property to specify the type of object.
For Cluster, use:
{
"computeType": "Cluster",
"pools": [
{
"instanceType": "string",
"name": "string",
"nodeCount": "int",
"vmPriority": "string"
}
],
"subnetArmId": "string"
}
For ContainerInstance, use:
{
"computeType": "ContainerInstance",
"idleTimeBeforeShutdown": "string",
"imageLink": "string",
"sshSettings": {
"adminEnabled": "bool",
"sshPublicKey": "string"
},
"targetClusterId": "string"
}
Property Values
Microsoft.CognitiveServices/accounts/computes
| Name | Description | Value |
|---|---|---|
| apiVersion | The api version | '2026-05-15-preview' |
| identity | Identity for the resource. | Identity |
| kind | The kind (type) of compute resource. | string |
| location | The location of the compute resource. | string |
| name | The resource name | string Constraints: Min length = 1 Max length = 63 Pattern = ^[a-zA-Z0-9]([a-zA-Z0-9_-]*[a-zA-Z0-9])?$ (required) |
| properties | Polymorphic properties of the compute resource. Use computeType to select Cluster or ContainerInstance. | ComputeProperties (required) |
| tags | Resource tags | Dictionary of tag names and values. See Tags in templates |
| type | The resource type | 'Microsoft.CognitiveServices/accounts/computes' |
ClusterComputeProperties
| Name | Description | Value |
|---|---|---|
| computeType | The type of compute resource. | 'Cluster' (required) |
| pools | Pools attached to this compute cluster. | Pool[] (required) |
| subnetArmId | ARM ID of the subnet used for compute. | string |
ComputeProperties
| Name | Description | Value |
|---|---|---|
| computeType | Set to 'Cluster' for type ClusterComputeProperties. Set to 'ContainerInstance' for type ContainerInstanceComputeProperties. | 'Cluster' 'ContainerInstance' (required) |
ComputeTags
| Name | Description | Value |
|---|
ContainerInstanceComputeProperties
| Name | Description | Value |
|---|---|---|
| computeType | The type of compute resource. | 'ContainerInstance' (required) |
| idleTimeBeforeShutdown | ISO 8601 duration before the idle instance is automatically shut down (e.g., 'PT30M'). | string |
| imageLink | Container image URI (e.g., MCR or ACR image path) for the container instance. | string (required) |
| sshSettings | SSH configuration for remote access to the container instance. | SshSettings |
| targetClusterId | ARM resource ID of the parent cluster that hosts this container instance. | string (required) |
Identity
| Name | Description | Value |
|---|---|---|
| type | The identity type. | 'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' |
| userAssignedIdentities | The list of user assigned identities associated with the resource. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Name | Description | Value |
|---|
Pool
| Name | Description | Value |
|---|---|---|
| instanceType | The instance type (VM SKU) used in the pool. | string (required) |
| name | The name of the pool. | string (required) |
| nodeCount | The number of nodes in the pool. | int (required) |
| vmPriority | The VM priority of the pool. | 'LowPriority' 'Regular' (required) |
SshSettings
| Name | Description | Value |
|---|---|---|
| adminEnabled | Whether SSH admin access is enabled. | bool |
| sshPublicKey | The SSH public key for authenticating to the compute instance. | string |
UserAssignedIdentity
| Name | Description | Value |
|---|
Usage Examples
Terraform (AzAPI provider) resource definition
The accounts/computes 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.CognitiveServices/accounts/computes resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.CognitiveServices/accounts/computes@2026-05-15-preview"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
kind = "string"
properties = {
computeType = "string"
// For remaining properties, see ComputeProperties objects
}
}
}
ComputeProperties objects
Set the computeType property to specify the type of object.
For Cluster, use:
{
computeType = "Cluster"
pools = [
{
instanceType = "string"
name = "string"
nodeCount = int
vmPriority = "string"
}
]
subnetArmId = "string"
}
For ContainerInstance, use:
{
computeType = "ContainerInstance"
idleTimeBeforeShutdown = "string"
imageLink = "string"
sshSettings = {
adminEnabled = bool
sshPublicKey = "string"
}
targetClusterId = "string"
}
Property Values
Microsoft.CognitiveServices/accounts/computes
| Name | Description | Value |
|---|---|---|
| identity | Identity for the resource. | Identity |
| kind | The kind (type) of compute resource. | string |
| location | The location of the compute resource. | string |
| name | The resource name | string Constraints: Min length = 1 Max length = 63 Pattern = ^[a-zA-Z0-9]([a-zA-Z0-9_-]*[a-zA-Z0-9])?$ (required) |
| parent_id | The ID of the resource that is the parent for this resource. | ID for resource of type: accounts |
| properties | Polymorphic properties of the compute resource. Use computeType to select Cluster or ContainerInstance. | ComputeProperties (required) |
| tags | Resource tags | Dictionary of tag names and values. |
| type | The resource type | "Microsoft.CognitiveServices/accounts/computes@2026-05-15-preview" |
ClusterComputeProperties
| Name | Description | Value |
|---|---|---|
| computeType | The type of compute resource. | 'Cluster' (required) |
| pools | Pools attached to this compute cluster. | Pool[] (required) |
| subnetArmId | ARM ID of the subnet used for compute. | string |
ComputeProperties
| Name | Description | Value |
|---|---|---|
| computeType | Set to 'Cluster' for type ClusterComputeProperties. Set to 'ContainerInstance' for type ContainerInstanceComputeProperties. | 'Cluster' 'ContainerInstance' (required) |
ComputeTags
| Name | Description | Value |
|---|
ContainerInstanceComputeProperties
| Name | Description | Value |
|---|---|---|
| computeType | The type of compute resource. | 'ContainerInstance' (required) |
| idleTimeBeforeShutdown | ISO 8601 duration before the idle instance is automatically shut down (e.g., 'PT30M'). | string |
| imageLink | Container image URI (e.g., MCR or ACR image path) for the container instance. | string (required) |
| sshSettings | SSH configuration for remote access to the container instance. | SshSettings |
| targetClusterId | ARM resource ID of the parent cluster that hosts this container instance. | string (required) |
Identity
| Name | Description | Value |
|---|---|---|
| type | The identity type. | 'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' |
| userAssignedIdentities | The list of user assigned identities associated with the resource. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Name | Description | Value |
|---|
Pool
| Name | Description | Value |
|---|---|---|
| instanceType | The instance type (VM SKU) used in the pool. | string (required) |
| name | The name of the pool. | string (required) |
| nodeCount | The number of nodes in the pool. | int (required) |
| vmPriority | The VM priority of the pool. | 'LowPriority' 'Regular' (required) |
SshSettings
| Name | Description | Value |
|---|---|---|
| adminEnabled | Whether SSH admin access is enabled. | bool |
| sshPublicKey | The SSH public key for authenticating to the compute instance. | string |
UserAssignedIdentity
| Name | Description | Value |
|---|