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. |
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
subscription
|
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. |
workspace
|
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 |
[Obrigatório] Atributos adicionais da entidade. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
A solicitação de criação ou atualização foi bem-sucedida. |
|
201 Created |
Criado Cabeçalhos
|
|
Other Status Codes |
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 |
---|---|
Asset |
Estado de provisionamento do ativo do Registro. |
Azure |
Detalhes do webhook específicos para o Azure DevOps |
created |
O tipo de identidade que criou o recurso. |
Email |
Enumerar para determinar o tipo de notificação por email. |
Error |
As informações adicionais do erro de gerenciamento de recursos. |
Error |
O detalhe do erro. |
Error |
Resposta de erro |
Featureset |
Objeto DTO que representa a especificação |
Featureset |
Objeto DTO que representa a versão do conjunto de recursos |
Featureset |
Envelope de recursos do Azure Resource Manager. |
Materialization |
Objeto DTO que representa o recurso de computação |
Materialization |
|
Materialization |
|
Notification |
Configuração para notificação. |
Recurrence |
Enumeração para descrever a frequência de um agendamento de recorrência |
Recurrence |
|
Recurrence |
|
system |
Metadados relativos à criação e última modificação do recurso. |
Trigger |
|
Webhook |
Enumerar para determinar o tipo de serviço de retorno de chamada de webhook. |
Week |
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:
Azure |
[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 |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
Nome | Tipo | Description |
---|---|---|
error |
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 |
Especifica as configurações de materialização |
||
properties |
object |
O dicionário de propriedades do ativo. |
|
provisioningState |
Estado de provisionamento para o contêiner de versão do conjunto de recursos. |
||
specification |
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 |
[Obrigatório] Atributos adicionais da entidade. |
|
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 |
Especifica os detalhes da notificação |
||
resource |
Especifica as configurações de recurso de computação |
||
schedule |
Especifica os detalhes da agenda |
||
sparkConfiguration |
object |
Especifica as configurações de computação do Spark |
|
storeType | 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 |
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 |
Week |
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 |
[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 |
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 |
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 |
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 |