Microsoft.MachineLearningServices workspaces/featuresets/versions 2023-08-01-preview

  • Article

Bicep resource definition

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

resource symbolicname 'Microsoft.MachineLearningServices/workspaces/featuresets/versions@2023-08-01-preview' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    autoDeleteSetting: {
      condition: 'string'
      value: 'string'
    }
    description: 'string'
    entities: [
      'string'
    ]
    isAnonymous: bool
    isArchived: bool
    materializationSettings: {
      notification: {
        emailOn: [
          'string'
        ]
        emails: [
          'string'
        ]
        webhooks: {
          {customized property}: {
            eventType: 'string'
            webhookType: 'string'
            // For remaining properties, see Webhook objects
          }
        }
      }
      resource: {
        instanceType: 'string'
      }
      schedule: {
        endTime: 'string'
        frequency: 'string'
        interval: int
        schedule: {
          hours: [
            int
          ]
          minutes: [
            int
          ]
          monthDays: [
            int
          ]
          weekDays: [
            'string'
          ]
        }
        startTime: 'string'
        timeZone: 'string'
        triggerType: 'string'
      }
      sparkConfiguration: {
        {customized property}: 'string'
      }
      storeType: 'string'
    }
    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'
    }
    specification: {
      path: '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'
    }
  }
}

Webhook objects

Set the webhookType property to specify the type of object.

For AzureDevOps, use:

  webhookType: 'AzureDevOps'

Property values

workspaces/featuresets/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: featuresets
properties [Required] Additional attributes of the entity. FeaturesetVersionProperties (required)

FeaturesetVersionProperties

Name Description Value
autoDeleteSetting Specifies the lifecycle setting of managed data asset. AutoDeleteSetting
description The asset description text. string
entities Specifies list of entities string[]
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
materializationSettings Specifies the materialization settings MaterializationSettings
properties The asset property dictionary. ResourceBaseProperties
specification Specifies the feature spec details FeaturesetSpecification
stage Specifies the asset stage string
tags Tag dictionary. Tags can be added, removed, and updated. object

AutoDeleteSetting

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

MaterializationSettings

Name Description Value
notification Specifies the notification details NotificationSetting
resource Specifies the compute resource settings MaterializationComputeResource
schedule Specifies the schedule details RecurrenceTrigger
sparkConfiguration Specifies the spark compute settings MaterializationSettingsSparkConfiguration
storeType Specifies the stores to which materialization should happen 'None'
'Offline'
'Online'
'OnlineAndOffline'

NotificationSetting

Name Description Value
emailOn Send email notification to user on specified notification type String array containing any of:
'JobCancelled'
'JobCompleted'
'JobFailed'
emails This is the email recipient list which has a limitation of 499 characters in total concat with comma separator string[]
webhooks Send webhook callback to a service. Key is a user-provided name for the webhook. NotificationSettingWebhooks

NotificationSettingWebhooks

Name Description Value
{customized property} Webhook

Webhook

Name Description Value
eventType Send callback on a specified notification event string
webhookType Set the object type AzureDevOps (required)

AzureDevOpsWebhook

Name Description Value
webhookType [Required] Specifies the type of service to send a callback 'AzureDevOps' (required)

MaterializationComputeResource

Name Description Value
instanceType Specifies the instance type string

RecurrenceTrigger

Name Description Value
endTime Specifies end time of schedule in ISO 8601, but without a UTC offset. Refer https://en.wikipedia.org/wiki/ISO_8601.
Recommented format would be "2022-06-01T00:00:01"
If not present, the schedule will run indefinitely		 string
frequency [Required] The frequency to trigger schedule. 'Day'
'Hour'
'Minute'
'Month'
'Week' (required)
interval [Required] Specifies schedule interval in conjunction with frequency int (required)
schedule The recurrence schedule. RecurrenceSchedule
startTime Specifies start time of schedule in ISO 8601 format, but without a UTC offset. string
timeZone Specifies time zone in which the schedule runs.
TimeZone should follow Windows time zone format. Refer: https://docs.microsoft.com/windows-hardware/manufacture/desktop/default-time-zones		 string
triggerType [Required] 'Cron'
'Recurrence' (required)

RecurrenceSchedule

Name Description Value
hours [Required] List of hours for the schedule. int[] (required)
minutes [Required] List of minutes for the schedule. int[] (required)
monthDays List of month days for the schedule int[]
weekDays List of days for the schedule. String array containing any of:
'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Wednesday'

MaterializationSettingsSparkConfiguration

Name Description Value
{customized property} string

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

FeaturesetSpecification

Name Description Value
path Specifies the spec path string

ARM template resource definition

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

{
  "type": "Microsoft.MachineLearningServices/workspaces/featuresets/versions",
  "apiVersion": "2023-08-01-preview",
  "name": "string",
  "properties": {
    "autoDeleteSetting": {
      "condition": "string",
      "value": "string"
    },
    "description": "string",
    "entities": [ "string" ],
    "isAnonymous": "bool",
    "isArchived": "bool",
    "materializationSettings": {
      "notification": {
        "emailOn": [ "string" ],
        "emails": [ "string" ],
        "webhooks": {
          "{customized property}": {
            "eventType": "string",
            "webhookType": "string"
            // For remaining properties, see Webhook objects
          }
        }
      },
      "resource": {
        "instanceType": "string"
      },
      "schedule": {
        "endTime": "string",
        "frequency": "string",
        "interval": "int",
        "schedule": {
          "hours": [ "int" ],
          "minutes": [ "int" ],
          "monthDays": [ "int" ],
          "weekDays": [ "string" ]
        },
        "startTime": "string",
        "timeZone": "string",
        "triggerType": "string"
      },
      "sparkConfiguration": {
        "{customized property}": "string"
      },
      "storeType": "string"
    },
    "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"
    },
    "specification": {
      "path": "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"
    }
  }
}

Webhook objects

Set the webhookType property to specify the type of object.

For AzureDevOps, use:

  "webhookType": "AzureDevOps"

Property values

workspaces/featuresets/versions

Name Description Value
type The resource type 'Microsoft.MachineLearningServices/workspaces/featuresets/versions'
apiVersion The resource api version '2023-08-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. FeaturesetVersionProperties (required)

FeaturesetVersionProperties

Name Description Value
autoDeleteSetting Specifies the lifecycle setting of managed data asset. AutoDeleteSetting
description The asset description text. string
entities Specifies list of entities string[]
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
materializationSettings Specifies the materialization settings MaterializationSettings
properties The asset property dictionary. ResourceBaseProperties
specification Specifies the feature spec details FeaturesetSpecification
stage Specifies the asset stage string
tags Tag dictionary. Tags can be added, removed, and updated. object

AutoDeleteSetting

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

MaterializationSettings

Name Description Value
notification Specifies the notification details NotificationSetting
resource Specifies the compute resource settings MaterializationComputeResource
schedule Specifies the schedule details RecurrenceTrigger
sparkConfiguration Specifies the spark compute settings MaterializationSettingsSparkConfiguration
storeType Specifies the stores to which materialization should happen 'None'
'Offline'
'Online'
'OnlineAndOffline'

NotificationSetting

Name Description Value
emailOn Send email notification to user on specified notification type String array containing any of:
'JobCancelled'
'JobCompleted'
'JobFailed'
emails This is the email recipient list which has a limitation of 499 characters in total concat with comma separator string[]
webhooks Send webhook callback to a service. Key is a user-provided name for the webhook. NotificationSettingWebhooks

NotificationSettingWebhooks

Name Description Value
{customized property} Webhook

Webhook

Name Description Value
eventType Send callback on a specified notification event string
webhookType Set the object type AzureDevOps (required)

AzureDevOpsWebhook

Name Description Value
webhookType [Required] Specifies the type of service to send a callback 'AzureDevOps' (required)

MaterializationComputeResource

Name Description Value
instanceType Specifies the instance type string

RecurrenceTrigger

Name Description Value
endTime Specifies end time of schedule in ISO 8601, but without a UTC offset. Refer https://en.wikipedia.org/wiki/ISO_8601.
Recommented format would be "2022-06-01T00:00:01"
If not present, the schedule will run indefinitely		 string
frequency [Required] The frequency to trigger schedule. 'Day'
'Hour'
'Minute'
'Month'
'Week' (required)
interval [Required] Specifies schedule interval in conjunction with frequency int (required)
schedule The recurrence schedule. RecurrenceSchedule
startTime Specifies start time of schedule in ISO 8601 format, but without a UTC offset. string
timeZone Specifies time zone in which the schedule runs.
TimeZone should follow Windows time zone format. Refer: https://docs.microsoft.com/windows-hardware/manufacture/desktop/default-time-zones		 string
triggerType [Required] 'Cron'
'Recurrence' (required)

RecurrenceSchedule

Name Description Value
hours [Required] List of hours for the schedule. int[] (required)
minutes [Required] List of minutes for the schedule. int[] (required)
monthDays List of month days for the schedule int[]
weekDays List of days for the schedule. String array containing any of:
'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Wednesday'

MaterializationSettingsSparkConfiguration

Name Description Value
{customized property} string

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

FeaturesetSpecification

Name Description Value
path Specifies the spec path string

Terraform (AzAPI provider) resource definition

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces/featuresets/versions@2023-08-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      autoDeleteSetting = {
        condition = "string"
        value = "string"
      }
      description = "string"
      entities = [
        "string"
      ]
      isAnonymous = bool
      isArchived = bool
      materializationSettings = {
        notification = {
          emailOn = [
            "string"
          ]
          emails = [
            "string"
          ]
          webhooks = {
            {customized property} = {
              eventType = "string"
              webhookType = "string"
              // For remaining properties, see Webhook objects
            }
          }
        }
        resource = {
          instanceType = "string"
        }
        schedule = {
          endTime = "string"
          frequency = "string"
          interval = int
          schedule = {
            hours = [
              int
            ]
            minutes = [
              int
            ]
            monthDays = [
              int
            ]
            weekDays = [
              "string"
            ]
          }
          startTime = "string"
          timeZone = "string"
          triggerType = "string"
        }
        sparkConfiguration = {
          {customized property} = "string"
        }
        storeType = "string"
      }
      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"
      }
      specification = {
        path = "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"
      }
    }
  })
}

Webhook objects

Set the webhookType property to specify the type of object.

For AzureDevOps, use:

  webhookType = "AzureDevOps"

Property values

workspaces/featuresets/versions

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

FeaturesetVersionProperties

Name Description Value
autoDeleteSetting Specifies the lifecycle setting of managed data asset. AutoDeleteSetting
description The asset description text. string
entities Specifies list of entities string[]
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
materializationSettings Specifies the materialization settings MaterializationSettings
properties The asset property dictionary. ResourceBaseProperties
specification Specifies the feature spec details FeaturesetSpecification
stage Specifies the asset stage string
tags Tag dictionary. Tags can be added, removed, and updated. object

AutoDeleteSetting

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

MaterializationSettings

Name Description Value
notification Specifies the notification details NotificationSetting
resource Specifies the compute resource settings MaterializationComputeResource
schedule Specifies the schedule details RecurrenceTrigger
sparkConfiguration Specifies the spark compute settings MaterializationSettingsSparkConfiguration
storeType Specifies the stores to which materialization should happen "None"
"Offline"
"Online"
"OnlineAndOffline"

NotificationSetting

Name Description Value
emailOn Send email notification to user on specified notification type String array containing any of:
"JobCancelled"
"JobCompleted"
"JobFailed"
emails This is the email recipient list which has a limitation of 499 characters in total concat with comma separator string[]
webhooks Send webhook callback to a service. Key is a user-provided name for the webhook. NotificationSettingWebhooks

NotificationSettingWebhooks

Name Description Value
{customized property} Webhook

Webhook

Name Description Value
eventType Send callback on a specified notification event string
webhookType Set the object type AzureDevOps (required)

AzureDevOpsWebhook

Name Description Value
webhookType [Required] Specifies the type of service to send a callback "AzureDevOps" (required)

MaterializationComputeResource

Name Description Value
instanceType Specifies the instance type string

RecurrenceTrigger

Name Description Value
endTime Specifies end time of schedule in ISO 8601, but without a UTC offset. Refer https://en.wikipedia.org/wiki/ISO_8601.
Recommented format would be "2022-06-01T00:00:01"
If not present, the schedule will run indefinitely		 string
frequency [Required] The frequency to trigger schedule. "Day"
"Hour"
"Minute"
"Month"
"Week" (required)
interval [Required] Specifies schedule interval in conjunction with frequency int (required)
schedule The recurrence schedule. RecurrenceSchedule
startTime Specifies start time of schedule in ISO 8601 format, but without a UTC offset. string
timeZone Specifies time zone in which the schedule runs.
TimeZone should follow Windows time zone format. Refer: https://docs.microsoft.com/windows-hardware/manufacture/desktop/default-time-zones		 string
triggerType [Required] "Cron"
"Recurrence" (required)

RecurrenceSchedule

Name Description Value
hours [Required] List of hours for the schedule. int[] (required)
minutes [Required] List of minutes for the schedule. int[] (required)
monthDays List of month days for the schedule int[]
weekDays List of days for the schedule. String array containing any of:
"Friday"
"Monday"
"Saturday"
"Sunday"
"Thursday"
"Tuesday"
"Wednesday"

MaterializationSettingsSparkConfiguration

Name Description Value
{customized property} string

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

FeaturesetSpecification

Name Description Value
path Specifies the spec path string