Compartilhar via


Featureset Versions - Create Or Update

Criar ou atualizar a versão.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/featuresets/{name}/versions/{version}?api-version=2025-04-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
name
path True

string

pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$

Nome do contêiner. Diferencia maiúsculas de minúsculas.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

subscriptionId
path True

string

minLength: 1

A ID da assinatura de destino.

version
path True

string

Identificador de versão. Diferencia maiúsculas de minúsculas.

workspaceName
path True

string

pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$

Nome do workspace do Azure Machine Learning.

api-version
query True

string

minLength: 1

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Obrigatório Tipo Description
properties True

FeaturesetVersion

[Obrigatório] Atributos adicionais da entidade.

Respostas

Nome Tipo Description
200 OK

FeaturesetVersionResource

A solicitação de criação ou atualização foi bem-sucedida.

201 Created

FeaturesetVersionResource

Criado

Cabeçalhos

  • x-ms-async-operation-timeout: string
  • Azure-AsyncOperation: string
Other Status Codes

ErrorResponse

Erro

Exemplos

CreateOrUpdate Workspace Featureset Version.

Solicitação de exemplo

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/featuresets/string/versions/string?api-version=2025-04-01

{
  "properties": {
    "description": "string",
    "tags": {
      "string": "string"
    },
    "properties": {
      "string": "string"
    },
    "isArchived": false,
    "isAnonymous": false,
    "specification": {
      "path": "string"
    },
    "materializationSettings": {
      "storeType": "Online",
      "schedule": {
        "endTime": "string",
        "startTime": "string",
        "timeZone": "string",
        "triggerType": "Recurrence",
        "frequency": "Day",
        "interval": 1,
        "schedule": {
          "hours": [
            1
          ],
          "minutes": [
            1
          ],
          "weekDays": [
            "Monday"
          ],
          "monthDays": [
            1
          ]
        }
      },
      "notification": {
        "emails": [
          "string"
        ],
        "emailOn": [
          "JobFailed"
        ]
      },
      "resource": {
        "instanceType": "string"
      },
      "sparkConfiguration": {
        "string": "string"
      }
    },
    "stage": "string",
    "entities": [
      "string"
    ]
  }
}

Resposta de exemplo

{
  "id": "string",
  "name": "string",
  "type": "string",
  "properties": {
    "description": "string",
    "tags": {
      "string": "string"
    },
    "properties": {
      "string": "string"
    },
    "isArchived": false,
    "isAnonymous": false,
    "specification": {
      "path": "string"
    },
    "materializationSettings": {
      "storeType": "OnlineAndOffline",
      "schedule": {
        "endTime": "string",
        "startTime": "string",
        "timeZone": "string",
        "triggerType": "Recurrence",
        "frequency": "Day",
        "interval": 1,
        "schedule": {
          "hours": [
            1
          ],
          "minutes": [
            1
          ],
          "weekDays": [
            "Wednesday"
          ],
          "monthDays": [
            1
          ]
        }
      },
      "notification": {
        "emails": [
          "string"
        ],
        "emailOn": [
          "JobFailed"
        ]
      },
      "resource": {
        "instanceType": "string"
      },
      "sparkConfiguration": {
        "string": "string"
      }
    },
    "stage": "string",
    "entities": [
      "string"
    ],
    "provisioningState": "Deleting"
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999+00:52",
    "createdBy": "string",
    "createdByType": "Application",
    "lastModifiedAt": "2020-01-01T12:34:56.999+00:52",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  }
}
{
  "id": "string",
  "name": "string",
  "type": "string",
  "properties": {
    "description": "string",
    "tags": {
      "string": "string"
    },
    "properties": {
      "string": "string"
    },
    "isArchived": false,
    "isAnonymous": false,
    "specification": {
      "path": "string"
    },
    "materializationSettings": {
      "storeType": "Offline",
      "schedule": {
        "endTime": "string",
        "startTime": "string",
        "timeZone": "string",
        "triggerType": "Recurrence",
        "frequency": "Hour",
        "interval": 1,
        "schedule": {
          "hours": [
            1
          ],
          "minutes": [
            1
          ],
          "weekDays": [
            "Wednesday"
          ],
          "monthDays": [
            1
          ]
        }
      },
      "notification": {
        "emails": [
          "string"
        ],
        "emailOn": [
          "JobCancelled"
        ]
      },
      "resource": {
        "instanceType": "string"
      },
      "sparkConfiguration": {
        "string": "string"
      }
    },
    "stage": "string",
    "entities": [
      "string"
    ],
    "provisioningState": "Failed"
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999+00:52",
    "createdBy": "string",
    "createdByType": "Application",
    "lastModifiedAt": "2020-01-01T12:34:56.999+00:52",
    "lastModifiedBy": "string",
    "lastModifiedByType": "Key"
  }
}

Definições

Nome Description
AssetProvisioningState

Estado de provisionamento do ativo do Registro.

AzureDevOpsWebhook

Detalhes do webhook específicos para o Azure DevOps

createdByType

O tipo de identidade que criou o recurso.

EmailNotificationEnableType

Enumerar para determinar o tipo de notificação por email.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

FeaturesetSpecification

Objeto DTO que representa a especificação

FeaturesetVersion

Objeto DTO que representa a versão do conjunto de recursos

FeaturesetVersionResource

Envelope de recursos do Azure Resource Manager.

MaterializationComputeResource

Objeto DTO que representa o recurso de computação

MaterializationSettings
MaterializationStoreType
NotificationSetting

Configuração para notificação.

RecurrenceFrequency

Enumeração para descrever a frequência de um agendamento de recorrência

RecurrenceSchedule
RecurrenceTrigger
systemData

Metadados relativos à criação e última modificação do recurso.

TriggerType
WebhookType

Enumerar para determinar o tipo de serviço de retorno de chamada de webhook.

WeekDay

Enumeração de dias da semana

AssetProvisioningState

Estado de provisionamento do ativo do Registro.

Valor Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

AzureDevOpsWebhook

Detalhes do webhook específicos para o Azure DevOps

Nome Tipo Description
eventType

string

Enviar retorno de chamada em um evento de notificação especificado

webhookType string:

AzureDevOps

[Obrigatório] Especifica o tipo de serviço para enviar um retorno de chamada

createdByType

O tipo de identidade que criou o recurso.

Valor Description
Application
Key
ManagedIdentity
User

EmailNotificationEnableType

Enumerar para determinar o tipo de notificação por email.

Valor Description
JobCancelled
JobCompleted
JobFailed

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

FeaturesetSpecification

Objeto DTO que representa a especificação

Nome Tipo Description
path

string

Especifica o caminho da especificação

FeaturesetVersion

Objeto DTO que representa a versão do conjunto de recursos

Nome Tipo Valor padrão Description
description

string

O texto de descrição do ativo.

entities

string[]

Especifica a lista de entidades

isAnonymous

boolean

False

Se a versão do nome for gerada pelo sistema (registro anônimo).

isArchived

boolean

False

O ativo está arquivado?

materializationSettings

MaterializationSettings

Especifica as configurações de materialização

properties

object

O dicionário de propriedades do ativo.

provisioningState

AssetProvisioningState

Estado de provisionamento para o contêiner de versão do conjunto de recursos.

specification

FeaturesetSpecification

Especifica os detalhes da especificação do recurso

stage

string

Especifica o estágio do ativo

tags

object

Dicionário de marcas. As marcas podem ser adicionadas, removidas e atualizadas.

FeaturesetVersionResource

Envelope de recursos do Azure Resource Manager.

Nome Tipo Description
id

string

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

O nome do recurso

properties

FeaturesetVersion

[Obrigatório] Atributos adicionais da entidade.

systemData

systemData

Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

MaterializationComputeResource

Objeto DTO que representa o recurso de computação

Nome Tipo Description
instanceType

string

Especifica o tipo de instância

MaterializationSettings

Nome Tipo Valor padrão Description
notification

NotificationSetting

Especifica os detalhes da notificação

resource

MaterializationComputeResource

Especifica as configurações de recurso de computação

schedule

RecurrenceTrigger

Especifica os detalhes da agenda

sparkConfiguration

object

Especifica as configurações de computação do Spark

storeType

MaterializationStoreType

None

Especifica os repositórios para os quais a materialização deve acontecer

MaterializationStoreType

Valor Description
None
Offline
Online
OnlineAndOffline

NotificationSetting

Configuração para notificação.

Nome Tipo Description
emailOn

EmailNotificationEnableType[]

Enviar notificação por email ao usuário no tipo de notificação especificado

emails

string[]

Esta é a lista de destinatários de email que tem uma limitação de 499 caracteres no total concat com separador de vírgula

webhooks

object

Envie o retorno de chamada do webhook para um serviço. A chave é um nome fornecido pelo usuário para o webhook.

RecurrenceFrequency

Enumeração para descrever a frequência de um agendamento de recorrência

Valor Description
Day

Frequência diária

Hour

Frequência de hora

Minute

Frequência de minutos

Month

Frequência de mês

Week

Frequência da semana

RecurrenceSchedule

Nome Tipo Description
hours

integer[] (int32)

[Obrigatório] Lista de horas para o agendamento.

minutes

integer[] (int32)

[Obrigatório] Lista de minutos para o agendamento.

monthDays

integer[] (int32)

Lista de dias do mês para o agendamento

weekDays

WeekDay[]

Lista de dias para a agenda.

RecurrenceTrigger

Nome Tipo Valor padrão Description
endTime

string

Especifica a hora de término do agendamento no ISO 8601, mas sem um deslocamento UTC. Consulte https://en.wikipedia.org/wiki/ISO_8601. O formato recomissado seria "2022-06-01T00:00:01" Se não estiver presente, o agendamento será executado indefinidamente

frequency

RecurrenceFrequency

[Obrigatório] A frequência para disparar o agendamento.

interval

integer (int32)

[Obrigatório] Especifica o intervalo de agendamento em conjunto com a frequência

schedule

RecurrenceSchedule

O agendamento de recorrência.

startTime

string

Especifica a hora de início do agendamento no formato ISO 8601, mas sem um deslocamento UTC.

timeZone

string

UTC

Especifica o fuso horário no qual o agendamento é executado. O TimeZone deve seguir o formato de fuso horário do Windows. Veja: https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/default-time-zones?view=windows-11

triggerType string:

Recurrence

[Obrigatório]

systemData

Metadados relativos à criação e última modificação do recurso.

Nome Tipo Description
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.

TriggerType

Valor Description
Cron
Recurrence

WebhookType

Enumerar para determinar o tipo de serviço de retorno de chamada de webhook.

Valor Description
AzureDevOps

WeekDay

Enumeração de dias da semana

Valor Description
Friday

Sexta-feira dia da semana

Monday

Dia da semana de segunda-feira

Saturday

Sábado dia da semana

Sunday

Dia da semana de domingo

Thursday

Quinta-feira dia da semana

Tuesday

Terça-feira dia da semana

Wednesday

Quarta-feira dia da semana