Microsoft.MachineLearningServices workspaces/data/versions 2023-06-01-preview

• Latest
• 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@2023-06-01-preview' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    autoDeleteSetting: {
      condition: 'string'
      value: 'string'
    }
    dataUri: 'string'
    description: 'string'
    intellectualProperty: {
      protectionLevel: 'string'
      publisher: 'string'
    }
    isAnonymous: bool
    isArchived: bool
    properties: {
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
    }
    stage: 'string'
    tags: {
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {customized property}: 'string'
      {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

workspaces/data/versions

Name	Description	Value
name	The resource name See how to set names and types for child resources in Bicep.	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: data
properties	[Required] Additional attributes of the entity.	DataVersionBaseProperties (required)

DataVersionBaseProperties

Name	Description	Value
autoDeleteSetting	Specifies the lifecycle setting of managed data asset.	AutoDeleteSetting
dataUri	[Required] Uri of the data. Example: https://go.microsoft.com/fwlink/?linkid=2202330	string (required) Constraints: Min length = 1 Pattern = [a-zA-Z0-9_]
description	The asset description text.	string
intellectualProperty	Intellectual Property details. Used if data is an Intellectual Property.	IntellectualProperty
isAnonymous	If the name version are system generated (anonymous registration). For types where Stage is defined, when Stage is provided it will be used to populate IsAnonymous	bool
isArchived	Is the asset archived? For types where Stage is defined, when Stage is provided it will be used to populate IsArchived	bool
properties	The asset property dictionary.	ResourceBaseProperties
stage	Stage in the data lifecycle assigned to this data asset	string
tags	Tag dictionary. Tags can be added, removed, and updated.	object
dataType	Set the object type	mltable uri_file uri_folder (required)

AutoDeleteSetting

Name	Description	Value
condition	When to check if an asset is expired	'CreatedGreaterThan' 'LastAccessedGreaterThan'
value	Expiration condition value.	string

IntellectualProperty

Name	Description	Value
protectionLevel	Protection level of the Intellectual Property.	'All' 'None'
publisher	[Required] Publisher of the Intellectual Property. Must be the same as Registry publisher name.	string (required) Constraints: Min length = 1 Pattern = [a-zA-Z0-9_]

ResourceBaseProperties

Name	Description	Value
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string

MLTableData

Name	Description	Value
dataType	[Required] Specifies the type of data.	'mltable' (required)
referencedUris	Uris referenced in the MLTable definition (required for lineage)	string[]

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.

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": "2023-06-01-preview",
  "name": "string",
  "properties": {
    "autoDeleteSetting": {
      "condition": "string",
      "value": "string"
    },
    "dataUri": "string",
    "description": "string",
    "intellectualProperty": {
      "protectionLevel": "string",
      "publisher": "string"
    },
    "isAnonymous": "bool",
    "isArchived": "bool",
    "properties": {
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string"
    },
    "stage": "string",
    "tags": {
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{customized property}": "string",
      "{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

workspaces/data/versions

Name	Description	Value
type	The resource type	'Microsoft.MachineLearningServices/workspaces/data/versions'
apiVersion	The resource api version	'2023-06-01-preview'
name	The resource name See how to set names and types for child resources in JSON ARM templates.	string (required)
properties	[Required] Additional attributes of the entity.	DataVersionBaseProperties (required)

DataVersionBaseProperties

Name	Description	Value
autoDeleteSetting	Specifies the lifecycle setting of managed data asset.	AutoDeleteSetting
dataUri	[Required] Uri of the data. Example: https://go.microsoft.com/fwlink/?linkid=2202330	string (required) Constraints: Min length = 1 Pattern = [a-zA-Z0-9_]
description	The asset description text.	string
intellectualProperty	Intellectual Property details. Used if data is an Intellectual Property.	IntellectualProperty
isAnonymous	If the name version are system generated (anonymous registration). For types where Stage is defined, when Stage is provided it will be used to populate IsAnonymous	bool
isArchived	Is the asset archived? For types where Stage is defined, when Stage is provided it will be used to populate IsArchived	bool
properties	The asset property dictionary.	ResourceBaseProperties
stage	Stage in the data lifecycle assigned to this data asset	string
tags	Tag dictionary. Tags can be added, removed, and updated.	object
dataType	Set the object type	mltable uri_file uri_folder (required)

AutoDeleteSetting

Name	Description	Value
condition	When to check if an asset is expired	'CreatedGreaterThan' 'LastAccessedGreaterThan'
value	Expiration condition value.	string

IntellectualProperty

Name	Description	Value
protectionLevel	Protection level of the Intellectual Property.	'All' 'None'
publisher	[Required] Publisher of the Intellectual Property. Must be the same as Registry publisher name.	string (required) Constraints: Min length = 1 Pattern = [a-zA-Z0-9_]

ResourceBaseProperties

Name	Description	Value
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string

MLTableData

Name	Description	Value
dataType	[Required] Specifies the type of data.	'mltable' (required)
referencedUris	Uris referenced in the MLTable definition (required for lineage)	string[]

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@2023-06-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      autoDeleteSetting = {
        condition = "string"
        value = "string"
      }
      dataUri = "string"
      description = "string"
      intellectualProperty = {
        protectionLevel = "string"
        publisher = "string"
      }
      isAnonymous = bool
      isArchived = bool
      properties = {
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
      }
      stage = "string"
      tags = {
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {customized property} = "string"
        {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

workspaces/data/versions

Name	Description	Value
type	The resource type	"Microsoft.MachineLearningServices/workspaces/data/versions@2023-06-01-preview"
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: data
properties	[Required] Additional attributes of the entity.	DataVersionBaseProperties (required)

DataVersionBaseProperties

Name	Description	Value
autoDeleteSetting	Specifies the lifecycle setting of managed data asset.	AutoDeleteSetting
dataUri	[Required] Uri of the data. Example: https://go.microsoft.com/fwlink/?linkid=2202330	string (required) Constraints: Min length = 1 Pattern = [a-zA-Z0-9_]
description	The asset description text.	string
intellectualProperty	Intellectual Property details. Used if data is an Intellectual Property.	IntellectualProperty
isAnonymous	If the name version are system generated (anonymous registration). For types where Stage is defined, when Stage is provided it will be used to populate IsAnonymous	bool
isArchived	Is the asset archived? For types where Stage is defined, when Stage is provided it will be used to populate IsArchived	bool
properties	The asset property dictionary.	ResourceBaseProperties
stage	Stage in the data lifecycle assigned to this data asset	string
tags	Tag dictionary. Tags can be added, removed, and updated.	object
dataType	Set the object type	mltable uri_file uri_folder (required)

AutoDeleteSetting

Name	Description	Value
condition	When to check if an asset is expired	"CreatedGreaterThan" "LastAccessedGreaterThan"
value	Expiration condition value.	string

IntellectualProperty

Name	Description	Value
protectionLevel	Protection level of the Intellectual Property.	"All" "None"
publisher	[Required] Publisher of the Intellectual Property. Must be the same as Registry publisher name.	string (required) Constraints: Min length = 1 Pattern = [a-zA-Z0-9_]

ResourceBaseProperties

Name	Description	Value
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string
{customized property}		string

MLTableData

Name	Description	Value
dataType	[Required] Specifies the type of data.	"mltable" (required)
referencedUris	Uris referenced in the MLTable definition (required for lineage)	string[]

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)