Microsoft.MachineLearningServices workspaces/data/versions 2022-10-01
- Latest
- 2024-10-01
- 2024-10-01-preview
- 2024-07-01-preview
- 2024-04-01
- 2024-04-01-preview
- 2024-01-01-preview
- 2023-10-01
- 2023-08-01-preview
- 2023-06-01-preview
- 2023-04-01
- 2023-04-01-preview
- 2023-02-01-preview
- 2022-12-01-preview
- 2022-10-01
- 2022-10-01-preview
- 2022-06-01-preview
- 2022-05-01
- 2022-02-01-preview
- 2021-03-01-preview
Bicep resource definition
The workspaces/data/versions 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.MachineLearningServices/workspaces/data/versions resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.MachineLearningServices/workspaces/data/versions@2022-10-01' = {
parent: resourceSymbolicName
name: 'string'
properties: {
dataUri: 'string'
description: 'string'
isAnonymous: bool
isArchived: bool
properties: {
{customized property}: 'string'
}
tags: {
{customized property}: 'string'
}
dataType: 'string'
// For remaining properties, see DataVersionBaseProperties objects
}
}
DataVersionBaseProperties objects
Set the dataType property to specify the type of object.
For mltable, use:
{
dataType: 'mltable'
referencedUris: [
'string'
]
}
For uri_file, use:
{
dataType: 'uri_file'
}
For uri_folder, use:
{
dataType: 'uri_folder'
}
Property values
DataVersionBaseProperties
| Name | Description | Value |
|---|---|---|
| dataType | Set to 'mltable' for type MLTableData. Set to 'uri_file' for type UriFileDataVersion. Set to 'uri_folder' for type UriFolderDataVersion. | 'mltable' 'uri_file' 'uri_folder' (required) |
| dataUri | [Required] Uri of the data. Usage/meaning depends on Microsoft.MachineLearning.ManagementFrontEnd.Contracts.V20221001.Assets.DataVersionBase.DataType | string Constraints: Pattern = [a-zA-Z0-9_] (required) |
| description | The asset description text. | string |
| isAnonymous | If the name version are system generated (anonymous registration). | bool |
| isArchived | Is the asset archived? | bool |
| properties | The asset property dictionary. | ResourceBaseProperties |
| tags | Tag dictionary. Tags can be added, removed, and updated. | ResourceBaseTags |
Microsoft.MachineLearningServices/workspaces/data/versions
| Name | Description | Value |
|---|---|---|
| name | The resource name | string (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/data |
| properties | [Required] Additional attributes of the entity. | DataVersionBaseProperties (required) |
MLTableData
| Name | Description | Value |
|---|---|---|
| dataType | [Required] Specifies the type of data. | 'mltable' (required) |
| referencedUris | Uris referenced in the MLTable definition (required for lineage) | string[] |
ResourceBaseProperties
| Name | Description | Value |
|---|
ResourceBaseTags
| Name | Description | Value |
|---|
UriFileDataVersion
| Name | Description | Value |
|---|---|---|
| dataType | [Required] Specifies the type of data. | 'uri_file' (required) |
UriFolderDataVersion
| Name | Description | Value |
|---|---|---|
| dataType | [Required] Specifies the type of data. | 'uri_folder' (required) |
Quickstart samples
The following quickstart samples deploy this resource type.
| Bicep File | Description |
|---|---|
| Create a Data Asset from File URI | This template creates a data asset/container from file URI in an Azure Machine Learning workspace. |
| Create a Data Version from File URI | This template creates a new data version from file URI in an Azure Machine Learning workspace. |
ARM template resource definition
The workspaces/data/versions 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.MachineLearningServices/workspaces/data/versions resource, add the following JSON to your template.
{
"type": "Microsoft.MachineLearningServices/workspaces/data/versions",
"apiVersion": "2022-10-01",
"name": "string",
"properties": {
"dataUri": "string",
"description": "string",
"isAnonymous": "bool",
"isArchived": "bool",
"properties": {
"{customized property}": "string"
},
"tags": {
"{customized property}": "string"
},
"dataType": "string"
// For remaining properties, see DataVersionBaseProperties objects
}
}
DataVersionBaseProperties objects
Set the dataType property to specify the type of object.
For mltable, use:
{
"dataType": "mltable",
"referencedUris": [ "string" ]
}
For uri_file, use:
{
"dataType": "uri_file"
}
For uri_folder, use:
{
"dataType": "uri_folder"
}
Property values
DataVersionBaseProperties
| Name | Description | Value |
|---|---|---|
| dataType | Set to 'mltable' for type MLTableData. Set to 'uri_file' for type UriFileDataVersion. Set to 'uri_folder' for type UriFolderDataVersion. | 'mltable' 'uri_file' 'uri_folder' (required) |
| dataUri | [Required] Uri of the data. Usage/meaning depends on Microsoft.MachineLearning.ManagementFrontEnd.Contracts.V20221001.Assets.DataVersionBase.DataType | string Constraints: Pattern = [a-zA-Z0-9_] (required) |
| description | The asset description text. | string |
| isAnonymous | If the name version are system generated (anonymous registration). | bool |
| isArchived | Is the asset archived? | bool |
| properties | The asset property dictionary. | ResourceBaseProperties |
| tags | Tag dictionary. Tags can be added, removed, and updated. | ResourceBaseTags |
Microsoft.MachineLearningServices/workspaces/data/versions
| Name | Description | Value |
|---|---|---|
| apiVersion | The api version | '2022-10-01' |
| name | The resource name | string (required) |
| properties | [Required] Additional attributes of the entity. | DataVersionBaseProperties (required) |
| type | The resource type | 'Microsoft.MachineLearningServices/workspaces/data/versions' |
MLTableData
| Name | Description | Value |
|---|---|---|
| dataType | [Required] Specifies the type of data. | 'mltable' (required) |
| referencedUris | Uris referenced in the MLTable definition (required for lineage) | string[] |
ResourceBaseProperties
| Name | Description | Value |
|---|
ResourceBaseTags
| Name | Description | Value |
|---|
UriFileDataVersion
| Name | Description | Value |
|---|---|---|
| dataType | [Required] Specifies the type of data. | 'uri_file' (required) |
UriFolderDataVersion
| Name | Description | Value |
|---|---|---|
| dataType | [Required] Specifies the type of data. | 'uri_folder' (required) |
Quickstart templates
The following quickstart templates deploy this resource type.
| Template | Description |
|---|---|
Create a Data Asset from File URI |
This template creates a data asset/container from file URI in an Azure Machine Learning workspace. |
| Create a Data Version from File URI |
This template creates a new data version from file URI in an Azure Machine Learning workspace. |
Terraform (AzAPI provider) resource definition
The workspaces/data/versions 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/data/versions resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.MachineLearningServices/workspaces/data/versions@2022-10-01"
name = "string"
body = jsonencode({
properties = {
dataUri = "string"
description = "string"
isAnonymous = bool
isArchived = bool
properties = {
{customized property} = "string"
}
tags = {
{customized property} = "string"
}
dataType = "string"
// For remaining properties, see DataVersionBaseProperties objects
}
})
}
DataVersionBaseProperties objects
Set the dataType property to specify the type of object.
For mltable, use:
{
dataType = "mltable"
referencedUris = [
"string"
]
}
For uri_file, use:
{
dataType = "uri_file"
}
For uri_folder, use:
{
dataType = "uri_folder"
}
Property values
DataVersionBaseProperties
| Name | Description | Value |
|---|---|---|
| dataType | Set to 'mltable' for type MLTableData. Set to 'uri_file' for type UriFileDataVersion. Set to 'uri_folder' for type UriFolderDataVersion. | 'mltable' 'uri_file' 'uri_folder' (required) |
| dataUri | [Required] Uri of the data. Usage/meaning depends on Microsoft.MachineLearning.ManagementFrontEnd.Contracts.V20221001.Assets.DataVersionBase.DataType | string Constraints: Pattern = [a-zA-Z0-9_] (required) |
| description | The asset description text. | string |
| isAnonymous | If the name version are system generated (anonymous registration). | bool |
| isArchived | Is the asset archived? | bool |
| properties | The asset property dictionary. | ResourceBaseProperties |
| tags | Tag dictionary. Tags can be added, removed, and updated. | ResourceBaseTags |
Microsoft.MachineLearningServices/workspaces/data/versions
| Name | Description | Value |
|---|---|---|
| name | The resource name | string (required) |
| parent_id | The ID of the resource that is the parent for this resource. | ID for resource of type: workspaces/data |
| properties | [Required] Additional attributes of the entity. | DataVersionBaseProperties (required) |
| type | The resource type | "Microsoft.MachineLearningServices/workspaces/data/versions@2022-10-01" |
MLTableData
| Name | Description | Value |
|---|---|---|
| dataType | [Required] Specifies the type of data. | 'mltable' (required) |
| referencedUris | Uris referenced in the MLTable definition (required for lineage) | string[] |
ResourceBaseProperties
| Name | Description | Value |
|---|
ResourceBaseTags
| Name | Description | Value |
|---|
UriFileDataVersion
| Name | Description | Value |
|---|---|---|
| dataType | [Required] Specifies the type of data. | 'uri_file' (required) |
UriFolderDataVersion
| Name | Description | Value |
|---|---|---|
| dataType | [Required] Specifies the type of data. | 'uri_folder' (required) |