Microsoft.MachineLearningServices workspaces/batchEndpoints/deployments 2022-12-01-preview

Bicep resource definition

The workspaces/batchEndpoints/deployments 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.MachineLearningServices/workspaces/batchEndpoints/deployments resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.MachineLearningServices/workspaces/batchEndpoints/deployments@2022-12-01-preview' = {
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    codeConfiguration: {
      codeId: 'string'
      scoringScript: 'string'
    }
    compute: 'string'
    description: 'string'
    environmentId: 'string'
    environmentVariables: {
      {customized property}: 'string'
    }
    errorThreshold: int
    loggingLevel: 'string'
    maxConcurrencyPerInstance: int
    miniBatchSize: int
    model: {
      referenceType: 'string'
      // For remaining properties, see AssetReferenceBase objects
    }
    outputAction: 'string'
    outputFileName: 'string'
    properties: {
      {customized property}: 'string'
    }
    resources: {
      instanceCount: int
      instanceType: 'string'
      properties: {
        {customized property}: any(Azure.Bicep.Types.Concrete.AnyType)
      }
    }
    retrySettings: {
      maxRetries: int
      timeout: 'string'
    }
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

AssetReferenceBase objects

Set the referenceType property to specify the type of object.

For DataPath, use:

{
  datastoreId: 'string'
  path: 'string'
  referenceType: 'DataPath'
}

For Id, use:

{
  assetId: 'string'
  referenceType: 'Id'
}

For OutputPath, use:

{
  jobId: 'string'
  path: 'string'
  referenceType: 'OutputPath'
}

Property values

AssetReferenceBase

Name Description Value
referenceType Set to 'DataPath' for type DataPathAssetReference. Set to 'Id' for type IdAssetReference. Set to 'OutputPath' for type OutputPathAssetReference. 'DataPath'
'Id'
'OutputPath' (required)

BatchDeploymentProperties

Name Description Value
codeConfiguration Code configuration for the endpoint deployment. CodeConfiguration
compute Compute target for batch inference operation. string
description Description of the endpoint deployment. string
environmentId ARM resource ID of the environment specification for the endpoint deployment. string
environmentVariables Environment variables configuration for the deployment. EndpointDeploymentPropertiesBaseEnvironmentVariables
errorThreshold Error threshold, if the error count for the entire input goes above this value,
the batch inference will be aborted. Range is [-1, int.MaxValue].
For FileDataset, this value is the count of file failures.
For TabularDataset, this value is the count of record failures.
If set to -1 (the lower bound), all failures during batch inference will be ignored.
int
loggingLevel Logging level for batch inference operation. 'Debug'
'Info'
'Warning'
maxConcurrencyPerInstance Indicates maximum number of parallelism per instance. int
miniBatchSize Size of the mini-batch passed to each batch invocation.
For FileDataset, this is the number of files per mini-batch.
For TabularDataset, this is the size of the records in bytes, per mini-batch.
int
model Reference to the model asset for the endpoint deployment. AssetReferenceBase
outputAction Indicates how the output will be organized. 'AppendRow'
'SummaryOnly'
outputFileName Customized output file name for append_row output action. string
properties Property dictionary. Properties can be added, but not removed or altered. EndpointDeploymentPropertiesBaseProperties
resources Indicates compute configuration for the job.
If not provided, will default to the defaults defined in ResourceConfiguration.
DeploymentResourceConfiguration
retrySettings Retry Settings for the batch inference operation.
If not provided, will default to the defaults defined in BatchRetrySettings.
BatchRetrySettings

BatchRetrySettings

Name Description Value
maxRetries Maximum retry count for a mini-batch int
timeout Invocation timeout for a mini-batch, in ISO 8601 format. string

CodeConfiguration

Name Description Value
codeId ARM resource ID of the code asset. string
scoringScript [Required] The script to execute on startup. eg. "score.py" string

Constraints:
Min length = 1
Pattern = [a-zA-Z0-9_] (required)

DataPathAssetReference

Name Description Value
datastoreId ARM resource ID of the datastore where the asset is located. string
path The path of the file/directory in the datastore. string
referenceType [Required] Specifies the type of asset reference. 'DataPath' (required)

DeploymentResourceConfiguration

Name Description Value
instanceCount Optional number of instances or nodes used by the compute target. int
instanceType Optional type of VM used as supported by the compute target. string
properties Additional properties bag. ResourceConfigurationProperties

EndpointDeploymentPropertiesBaseEnvironmentVariables

Name Description Value

EndpointDeploymentPropertiesBaseProperties

Name Description Value

IdAssetReference

Name Description Value
assetId [Required] ARM resource ID of the asset. string

Constraints:
Pattern = [a-zA-Z0-9_] (required)
referenceType [Required] Specifies the type of asset reference. 'Id' (required)

ManagedServiceIdentity

Name Description Value
type Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (required)
userAssignedIdentities The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. UserAssignedIdentities

Microsoft.MachineLearningServices/workspaces/batchEndpoints/deployments

Name Description Value
identity Managed service identity (system assigned and/or user assigned identities) ManagedServiceIdentity
kind Metadata used by portal/tooling/etc to render different UX experiences for resources of the same type. string
location The geo-location where the resource lives string (required)
name The resource name string

Constraints:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$ (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: workspaces/batchEndpoints
properties [Required] Additional attributes of the entity. BatchDeploymentProperties (required)
sku Sku details required for ARM contract for Autoscaling. Sku
tags Resource tags Dictionary of tag names and values. See Tags in templates

OutputPathAssetReference

Name Description Value
jobId ARM resource ID of the job. string
path The path of the file/directory in the job output. string
referenceType [Required] Specifies the type of asset reference. 'OutputPath' (required)

ResourceConfigurationProperties

Name Description Value

Sku

Name Description Value
capacity If the SKU supports scale out/in then the capacity integer should be included. If scale out/in is not possible for the resource this may be omitted. int
family If the service has different generations of hardware, for the same SKU, then that can be captured here. string
name The name of the SKU. Ex - P3. It is typically a letter+number code string (required)
size The SKU size. When the name field is the combination of tier and some other value, this would be the standalone code. string
tier This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT. 'Basic'
'Free'
'Premium'
'Standard'

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

ARM template resource definition

The workspaces/batchEndpoints/deployments 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.MachineLearningServices/workspaces/batchEndpoints/deployments resource, add the following JSON to your template.

{
  "type": "Microsoft.MachineLearningServices/workspaces/batchEndpoints/deployments",
  "apiVersion": "2022-12-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "codeConfiguration": {
      "codeId": "string",
      "scoringScript": "string"
    },
    "compute": "string",
    "description": "string",
    "environmentId": "string",
    "environmentVariables": {
      "{customized property}": "string"
    },
    "errorThreshold": "int",
    "loggingLevel": "string",
    "maxConcurrencyPerInstance": "int",
    "miniBatchSize": "int",
    "model": {
      "referenceType": "string"
      // For remaining properties, see AssetReferenceBase objects
    },
    "outputAction": "string",
    "outputFileName": "string",
    "properties": {
      "{customized property}": "string"
    },
    "resources": {
      "instanceCount": "int",
      "instanceType": "string",
      "properties": {
        "{customized property}": {}
      }
    },
    "retrySettings": {
      "maxRetries": "int",
      "timeout": "string"
    }
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

AssetReferenceBase objects

Set the referenceType property to specify the type of object.

For DataPath, use:

{
  "datastoreId": "string",
  "path": "string",
  "referenceType": "DataPath"
}

For Id, use:

{
  "assetId": "string",
  "referenceType": "Id"
}

For OutputPath, use:

{
  "jobId": "string",
  "path": "string",
  "referenceType": "OutputPath"
}

Property values

AssetReferenceBase

Name Description Value
referenceType Set to 'DataPath' for type DataPathAssetReference. Set to 'Id' for type IdAssetReference. Set to 'OutputPath' for type OutputPathAssetReference. 'DataPath'
'Id'
'OutputPath' (required)

BatchDeploymentProperties

Name Description Value
codeConfiguration Code configuration for the endpoint deployment. CodeConfiguration
compute Compute target for batch inference operation. string
description Description of the endpoint deployment. string
environmentId ARM resource ID of the environment specification for the endpoint deployment. string
environmentVariables Environment variables configuration for the deployment. EndpointDeploymentPropertiesBaseEnvironmentVariables
errorThreshold Error threshold, if the error count for the entire input goes above this value,
the batch inference will be aborted. Range is [-1, int.MaxValue].
For FileDataset, this value is the count of file failures.
For TabularDataset, this value is the count of record failures.
If set to -1 (the lower bound), all failures during batch inference will be ignored.
int
loggingLevel Logging level for batch inference operation. 'Debug'
'Info'
'Warning'
maxConcurrencyPerInstance Indicates maximum number of parallelism per instance. int
miniBatchSize Size of the mini-batch passed to each batch invocation.
For FileDataset, this is the number of files per mini-batch.
For TabularDataset, this is the size of the records in bytes, per mini-batch.
int
model Reference to the model asset for the endpoint deployment. AssetReferenceBase
outputAction Indicates how the output will be organized. 'AppendRow'
'SummaryOnly'
outputFileName Customized output file name for append_row output action. string
properties Property dictionary. Properties can be added, but not removed or altered. EndpointDeploymentPropertiesBaseProperties
resources Indicates compute configuration for the job.
If not provided, will default to the defaults defined in ResourceConfiguration.
DeploymentResourceConfiguration
retrySettings Retry Settings for the batch inference operation.
If not provided, will default to the defaults defined in BatchRetrySettings.
BatchRetrySettings

BatchRetrySettings

Name Description Value
maxRetries Maximum retry count for a mini-batch int
timeout Invocation timeout for a mini-batch, in ISO 8601 format. string

CodeConfiguration

Name Description Value
codeId ARM resource ID of the code asset. string
scoringScript [Required] The script to execute on startup. eg. "score.py" string

Constraints:
Min length = 1
Pattern = [a-zA-Z0-9_] (required)

DataPathAssetReference

Name Description Value
datastoreId ARM resource ID of the datastore where the asset is located. string
path The path of the file/directory in the datastore. string
referenceType [Required] Specifies the type of asset reference. 'DataPath' (required)

DeploymentResourceConfiguration

Name Description Value
instanceCount Optional number of instances or nodes used by the compute target. int
instanceType Optional type of VM used as supported by the compute target. string
properties Additional properties bag. ResourceConfigurationProperties

EndpointDeploymentPropertiesBaseEnvironmentVariables

Name Description Value

EndpointDeploymentPropertiesBaseProperties

Name Description Value

IdAssetReference

Name Description Value
assetId [Required] ARM resource ID of the asset. string

Constraints:
Pattern = [a-zA-Z0-9_] (required)
referenceType [Required] Specifies the type of asset reference. 'Id' (required)

ManagedServiceIdentity

Name Description Value
type Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (required)
userAssignedIdentities The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. UserAssignedIdentities

Microsoft.MachineLearningServices/workspaces/batchEndpoints/deployments

Name Description Value
apiVersion The api version '2022-12-01-preview'
identity Managed service identity (system assigned and/or user assigned identities) ManagedServiceIdentity
kind Metadata used by portal/tooling/etc to render different UX experiences for resources of the same type. string
location The geo-location where the resource lives string (required)
name The resource name string

Constraints:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$ (required)
properties [Required] Additional attributes of the entity. BatchDeploymentProperties (required)
sku Sku details required for ARM contract for Autoscaling. Sku
tags Resource tags Dictionary of tag names and values. See Tags in templates
type The resource type 'Microsoft.MachineLearningServices/workspaces/batchEndpoints/deployments'

OutputPathAssetReference

Name Description Value
jobId ARM resource ID of the job. string
path The path of the file/directory in the job output. string
referenceType [Required] Specifies the type of asset reference. 'OutputPath' (required)

ResourceConfigurationProperties

Name Description Value

Sku

Name Description Value
capacity If the SKU supports scale out/in then the capacity integer should be included. If scale out/in is not possible for the resource this may be omitted. int
family If the service has different generations of hardware, for the same SKU, then that can be captured here. string
name The name of the SKU. Ex - P3. It is typically a letter+number code string (required)
size The SKU size. When the name field is the combination of tier and some other value, this would be the standalone code. string
tier This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT. 'Basic'
'Free'
'Premium'
'Standard'

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

Terraform (AzAPI provider) resource definition

The workspaces/batchEndpoints/deployments 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.MachineLearningServices/workspaces/batchEndpoints/deployments resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces/batchEndpoints/deployments@2022-12-01-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  kind = "string"
  location = "string"
  sku = {
    capacity = int
    family = "string"
    name = "string"
    size = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      codeConfiguration = {
        codeId = "string"
        scoringScript = "string"
      }
      compute = "string"
      description = "string"
      environmentId = "string"
      environmentVariables = {
        {customized property} = "string"
      }
      errorThreshold = int
      loggingLevel = "string"
      maxConcurrencyPerInstance = int
      miniBatchSize = int
      model = {
        referenceType = "string"
        // For remaining properties, see AssetReferenceBase objects
      }
      outputAction = "string"
      outputFileName = "string"
      properties = {
        {customized property} = "string"
      }
      resources = {
        instanceCount = int
        instanceType = "string"
        properties = {
          {customized property} = ?
        }
      }
      retrySettings = {
        maxRetries = int
        timeout = "string"
      }
    }
  })
}

AssetReferenceBase objects

Set the referenceType property to specify the type of object.

For DataPath, use:

{
  datastoreId = "string"
  path = "string"
  referenceType = "DataPath"
}

For Id, use:

{
  assetId = "string"
  referenceType = "Id"
}

For OutputPath, use:

{
  jobId = "string"
  path = "string"
  referenceType = "OutputPath"
}

Property values

AssetReferenceBase

Name Description Value
referenceType Set to 'DataPath' for type DataPathAssetReference. Set to 'Id' for type IdAssetReference. Set to 'OutputPath' for type OutputPathAssetReference. 'DataPath'
'Id'
'OutputPath' (required)

BatchDeploymentProperties

Name Description Value
codeConfiguration Code configuration for the endpoint deployment. CodeConfiguration
compute Compute target for batch inference operation. string
description Description of the endpoint deployment. string
environmentId ARM resource ID of the environment specification for the endpoint deployment. string
environmentVariables Environment variables configuration for the deployment. EndpointDeploymentPropertiesBaseEnvironmentVariables
errorThreshold Error threshold, if the error count for the entire input goes above this value,
the batch inference will be aborted. Range is [-1, int.MaxValue].
For FileDataset, this value is the count of file failures.
For TabularDataset, this value is the count of record failures.
If set to -1 (the lower bound), all failures during batch inference will be ignored.
int
loggingLevel Logging level for batch inference operation. 'Debug'
'Info'
'Warning'
maxConcurrencyPerInstance Indicates maximum number of parallelism per instance. int
miniBatchSize Size of the mini-batch passed to each batch invocation.
For FileDataset, this is the number of files per mini-batch.
For TabularDataset, this is the size of the records in bytes, per mini-batch.
int
model Reference to the model asset for the endpoint deployment. AssetReferenceBase
outputAction Indicates how the output will be organized. 'AppendRow'
'SummaryOnly'
outputFileName Customized output file name for append_row output action. string
properties Property dictionary. Properties can be added, but not removed or altered. EndpointDeploymentPropertiesBaseProperties
resources Indicates compute configuration for the job.
If not provided, will default to the defaults defined in ResourceConfiguration.
DeploymentResourceConfiguration
retrySettings Retry Settings for the batch inference operation.
If not provided, will default to the defaults defined in BatchRetrySettings.
BatchRetrySettings

BatchRetrySettings

Name Description Value
maxRetries Maximum retry count for a mini-batch int
timeout Invocation timeout for a mini-batch, in ISO 8601 format. string

CodeConfiguration

Name Description Value
codeId ARM resource ID of the code asset. string
scoringScript [Required] The script to execute on startup. eg. "score.py" string

Constraints:
Min length = 1
Pattern = [a-zA-Z0-9_] (required)

DataPathAssetReference

Name Description Value
datastoreId ARM resource ID of the datastore where the asset is located. string
path The path of the file/directory in the datastore. string
referenceType [Required] Specifies the type of asset reference. 'DataPath' (required)

DeploymentResourceConfiguration

Name Description Value
instanceCount Optional number of instances or nodes used by the compute target. int
instanceType Optional type of VM used as supported by the compute target. string
properties Additional properties bag. ResourceConfigurationProperties

EndpointDeploymentPropertiesBaseEnvironmentVariables

Name Description Value

EndpointDeploymentPropertiesBaseProperties

Name Description Value

IdAssetReference

Name Description Value
assetId [Required] ARM resource ID of the asset. string

Constraints:
Pattern = [a-zA-Z0-9_] (required)
referenceType [Required] Specifies the type of asset reference. 'Id' (required)

ManagedServiceIdentity

Name Description Value
type Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (required)
userAssignedIdentities The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. UserAssignedIdentities

Microsoft.MachineLearningServices/workspaces/batchEndpoints/deployments

Name Description Value
identity Managed service identity (system assigned and/or user assigned identities) ManagedServiceIdentity
kind Metadata used by portal/tooling/etc to render different UX experiences for resources of the same type. string
location The geo-location where the resource lives string (required)
name The resource name string

Constraints:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$ (required)
parent_id The ID of the resource that is the parent for this resource. ID for resource of type: workspaces/batchEndpoints
properties [Required] Additional attributes of the entity. BatchDeploymentProperties (required)
sku Sku details required for ARM contract for Autoscaling. Sku
tags Resource tags Dictionary of tag names and values.
type The resource type "Microsoft.MachineLearningServices/workspaces/batchEndpoints/deployments@2022-12-01-preview"

OutputPathAssetReference

Name Description Value
jobId ARM resource ID of the job. string
path The path of the file/directory in the job output. string
referenceType [Required] Specifies the type of asset reference. 'OutputPath' (required)

ResourceConfigurationProperties

Name Description Value

Sku

Name Description Value
capacity If the SKU supports scale out/in then the capacity integer should be included. If scale out/in is not possible for the resource this may be omitted. int
family If the service has different generations of hardware, for the same SKU, then that can be captured here. string
name The name of the SKU. Ex - P3. It is typically a letter+number code string (required)
size The SKU size. When the name field is the combination of tier and some other value, this would be the standalone code. string
tier This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT. 'Basic'
'Free'
'Premium'
'Standard'

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value