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/arcDeployments 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/arcDeployments resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.CognitiveServices/accounts/arcDeployments@2026-07-15-preview' = {
parent: resourceSymbolicName
name: 'string'
properties: {
compute: 'string'
deploymentState: 'string'
deploymentTemplate: 'string'
extensionId: 'string'
model: {
format: 'string'
name: 'string'
}
nodeSelector: {
{customized property}: 'string'
}
raiPolicyName: 'string'
replicas: int
resources: {
limits: {
cpu: 'string'
gpu: int
memory: 'string'
}
requests: {
cpu: 'string'
memory: 'string'
}
}
runtime: 'string'
}
sku: {
name: 'string'
}
}
Property Values
Microsoft.CognitiveServices/accounts/arcDeployments
| Name | Description | Value |
|---|---|---|
| name | The resource name | string Constraints: Pattern = ^[a-z0-9]([-a-z0-9]{0,61}[a-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 | Properties of the Cognitive Services Arc deployment. | ArcDeploymentProperties (required) |
| sku | The Arc deployment SKU. Only the SKU name is required for Arc deployments. | ArcDeploymentSku (required) |
ArcDeploymentCpuMemoryResourceRequirements
| Name | Description | Value |
|---|---|---|
| cpu | Kubernetes CPU quantity string, for example 500m, 2, 4, or 8. | string (required) |
| memory | Kubernetes memory quantity string, for example 512Mi, 2Gi, or 16Gi. | string (required) |
ArcDeploymentKubernetesResources
| Name | Description | Value |
|---|---|---|
| limits | Kubernetes resource limits for each deployment replica. | ArcDeploymentResourceRequirements |
| requests | Kubernetes CPU and memory resource requests for each deployment replica. | ArcDeploymentCpuMemoryResourceRequirements |
ArcDeploymentModel
| Name | Description | Value |
|---|---|---|
| format | Deployment model format. | string (required) |
| name | Deployment model name. | string (required) |
ArcDeploymentProperties
| Name | Description | Value |
|---|---|---|
| compute | Compute type for the deployment. Required on creation and immutable after creation. | 'cpu' 'gpu' (required) |
| deploymentState | The deployment state. | 'Paused' 'Running' |
| deploymentTemplate | Optional deployment template identifier for advanced vLLM tuning. Allowed only when runtime is vllm. Example: azureml://registries/{registry}/deploymenttemplates/{template}/versions/{version} |
string |
| extensionId | Full Azure resource ID of the Foundry inference extension on the target Arc-enabled Kubernetes cluster. Required on creation and immutable after creation. | string (required) |
| model | Model reference. Required on creation and immutable after creation. | ArcDeploymentModel (required) |
| nodeSelector | Kubernetes node selector key-value map used to schedule pods onto nodes with matching labels. | ArcDeploymentPropertiesNodeSelector |
| raiPolicyName | The name of RAI policy. | string |
| replicas | Physical replica count on the Arc cluster. | int Constraints: Min value = 1 Max value = 100 (required) |
| resources | Per-replica Kubernetes resource requests and limits. | ArcDeploymentKubernetesResources (required) |
| runtime | Inference runtime. Required on creation and immutable after creation. | 'onnx-genai' 'vllm' (required) |
ArcDeploymentPropertiesNodeSelector
| Name | Description | Value |
|---|
ArcDeploymentResourceRequirements
| Name | Description | Value |
|---|---|---|
| cpu | Kubernetes CPU quantity string, for example 500m, 2, 4, or 8. Required with memory when specifying CPU and memory limits. Do not specify with gpu. |
string |
| gpu | Kubernetes GPU quantity, for example 1, 2, or 5. Required when specifying GPU limits. Do not specify with cpu or memory. |
int Constraints: Min value = 1 |
| memory | Kubernetes memory quantity string, for example 512Mi, 2Gi, or 16Gi. Required with cpu when specifying CPU and memory limits. Do not specify with gpu. |
string |
ArcDeploymentSku
| Name | Description | Value |
|---|---|---|
| name | The name of the Arc deployment SKU. Must be Arc. | 'Arc' (required) |
ARM template resource definition
The accounts/arcDeployments 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.CognitiveServices/accounts/arcDeployments resource, add the following JSON to your template.
{
"type": "Microsoft.CognitiveServices/accounts/arcDeployments",
"apiVersion": "2026-07-15-preview",
"name": "string",
"properties": {
"compute": "string",
"deploymentState": "string",
"deploymentTemplate": "string",
"extensionId": "string",
"model": {
"format": "string",
"name": "string"
},
"nodeSelector": {
"{customized property}": "string"
},
"raiPolicyName": "string",
"replicas": "int",
"resources": {
"limits": {
"cpu": "string",
"gpu": "int",
"memory": "string"
},
"requests": {
"cpu": "string",
"memory": "string"
}
},
"runtime": "string"
},
"sku": {
"name": "string"
}
}
Property Values
Microsoft.CognitiveServices/accounts/arcDeployments
| Name | Description | Value |
|---|---|---|
| apiVersion | The api version | '2026-07-15-preview' |
| name | The resource name | string Constraints: Pattern = ^[a-z0-9]([-a-z0-9]{0,61}[a-z0-9])?$ (required) |
| properties | Properties of the Cognitive Services Arc deployment. | ArcDeploymentProperties (required) |
| sku | The Arc deployment SKU. Only the SKU name is required for Arc deployments. | ArcDeploymentSku (required) |
| type | The resource type | 'Microsoft.CognitiveServices/accounts/arcDeployments' |
ArcDeploymentCpuMemoryResourceRequirements
| Name | Description | Value |
|---|---|---|
| cpu | Kubernetes CPU quantity string, for example 500m, 2, 4, or 8. | string (required) |
| memory | Kubernetes memory quantity string, for example 512Mi, 2Gi, or 16Gi. | string (required) |
ArcDeploymentKubernetesResources
| Name | Description | Value |
|---|---|---|
| limits | Kubernetes resource limits for each deployment replica. | ArcDeploymentResourceRequirements |
| requests | Kubernetes CPU and memory resource requests for each deployment replica. | ArcDeploymentCpuMemoryResourceRequirements |
ArcDeploymentModel
| Name | Description | Value |
|---|---|---|
| format | Deployment model format. | string (required) |
| name | Deployment model name. | string (required) |
ArcDeploymentProperties
| Name | Description | Value |
|---|---|---|
| compute | Compute type for the deployment. Required on creation and immutable after creation. | 'cpu' 'gpu' (required) |
| deploymentState | The deployment state. | 'Paused' 'Running' |
| deploymentTemplate | Optional deployment template identifier for advanced vLLM tuning. Allowed only when runtime is vllm. Example: azureml://registries/{registry}/deploymenttemplates/{template}/versions/{version} |
string |
| extensionId | Full Azure resource ID of the Foundry inference extension on the target Arc-enabled Kubernetes cluster. Required on creation and immutable after creation. | string (required) |
| model | Model reference. Required on creation and immutable after creation. | ArcDeploymentModel (required) |
| nodeSelector | Kubernetes node selector key-value map used to schedule pods onto nodes with matching labels. | ArcDeploymentPropertiesNodeSelector |
| raiPolicyName | The name of RAI policy. | string |
| replicas | Physical replica count on the Arc cluster. | int Constraints: Min value = 1 Max value = 100 (required) |
| resources | Per-replica Kubernetes resource requests and limits. | ArcDeploymentKubernetesResources (required) |
| runtime | Inference runtime. Required on creation and immutable after creation. | 'onnx-genai' 'vllm' (required) |
ArcDeploymentPropertiesNodeSelector
| Name | Description | Value |
|---|
ArcDeploymentResourceRequirements
| Name | Description | Value |
|---|---|---|
| cpu | Kubernetes CPU quantity string, for example 500m, 2, 4, or 8. Required with memory when specifying CPU and memory limits. Do not specify with gpu. |
string |
| gpu | Kubernetes GPU quantity, for example 1, 2, or 5. Required when specifying GPU limits. Do not specify with cpu or memory. |
int Constraints: Min value = 1 |
| memory | Kubernetes memory quantity string, for example 512Mi, 2Gi, or 16Gi. Required with cpu when specifying CPU and memory limits. Do not specify with gpu. |
string |
ArcDeploymentSku
| Name | Description | Value |
|---|---|---|
| name | The name of the Arc deployment SKU. Must be Arc. | 'Arc' (required) |
Terraform (AzAPI provider) resource definition
The accounts/arcDeployments 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/arcDeployments resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.CognitiveServices/accounts/arcDeployments@2026-07-15-preview"
name = "string"
parent_id = "string"
body = {
properties = {
compute = "string"
deploymentState = "string"
deploymentTemplate = "string"
extensionId = "string"
model = {
format = "string"
name = "string"
}
nodeSelector = {
{customized property} = "string"
}
raiPolicyName = "string"
replicas = int
resources = {
limits = {
cpu = "string"
gpu = int
memory = "string"
}
requests = {
cpu = "string"
memory = "string"
}
}
runtime = "string"
}
sku = {
name = "string"
}
}
}
Property Values
Microsoft.CognitiveServices/accounts/arcDeployments
| Name | Description | Value |
|---|---|---|
| name | The resource name | string Constraints: Pattern = ^[a-z0-9]([-a-z0-9]{0,61}[a-z0-9])?$ (required) |
| parent_id | The ID of the resource that is the parent for this resource. | ID for resource of type: accounts |
| properties | Properties of the Cognitive Services Arc deployment. | ArcDeploymentProperties (required) |
| sku | The Arc deployment SKU. Only the SKU name is required for Arc deployments. | ArcDeploymentSku (required) |
| type | The resource type | "Microsoft.CognitiveServices/accounts/arcDeployments@2026-07-15-preview" |
ArcDeploymentCpuMemoryResourceRequirements
| Name | Description | Value |
|---|---|---|
| cpu | Kubernetes CPU quantity string, for example 500m, 2, 4, or 8. | string (required) |
| memory | Kubernetes memory quantity string, for example 512Mi, 2Gi, or 16Gi. | string (required) |
ArcDeploymentKubernetesResources
| Name | Description | Value |
|---|---|---|
| limits | Kubernetes resource limits for each deployment replica. | ArcDeploymentResourceRequirements |
| requests | Kubernetes CPU and memory resource requests for each deployment replica. | ArcDeploymentCpuMemoryResourceRequirements |
ArcDeploymentModel
| Name | Description | Value |
|---|---|---|
| format | Deployment model format. | string (required) |
| name | Deployment model name. | string (required) |
ArcDeploymentProperties
| Name | Description | Value |
|---|---|---|
| compute | Compute type for the deployment. Required on creation and immutable after creation. | 'cpu' 'gpu' (required) |
| deploymentState | The deployment state. | 'Paused' 'Running' |
| deploymentTemplate | Optional deployment template identifier for advanced vLLM tuning. Allowed only when runtime is vllm. Example: azureml://registries/{registry}/deploymenttemplates/{template}/versions/{version} |
string |
| extensionId | Full Azure resource ID of the Foundry inference extension on the target Arc-enabled Kubernetes cluster. Required on creation and immutable after creation. | string (required) |
| model | Model reference. Required on creation and immutable after creation. | ArcDeploymentModel (required) |
| nodeSelector | Kubernetes node selector key-value map used to schedule pods onto nodes with matching labels. | ArcDeploymentPropertiesNodeSelector |
| raiPolicyName | The name of RAI policy. | string |
| replicas | Physical replica count on the Arc cluster. | int Constraints: Min value = 1 Max value = 100 (required) |
| resources | Per-replica Kubernetes resource requests and limits. | ArcDeploymentKubernetesResources (required) |
| runtime | Inference runtime. Required on creation and immutable after creation. | 'onnx-genai' 'vllm' (required) |
ArcDeploymentPropertiesNodeSelector
| Name | Description | Value |
|---|
ArcDeploymentResourceRequirements
| Name | Description | Value |
|---|---|---|
| cpu | Kubernetes CPU quantity string, for example 500m, 2, 4, or 8. Required with memory when specifying CPU and memory limits. Do not specify with gpu. |
string |
| gpu | Kubernetes GPU quantity, for example 1, 2, or 5. Required when specifying GPU limits. Do not specify with cpu or memory. |
int Constraints: Min value = 1 |
| memory | Kubernetes memory quantity string, for example 512Mi, 2Gi, or 16Gi. Required with cpu when specifying CPU and memory limits. Do not specify with gpu. |
string |
ArcDeploymentSku
| Name | Description | Value |
|---|---|---|
| name | The name of the Arc deployment SKU. Must be Arc. | 'Arc' (required) |