Compartilhar via

Items - Create ML Experiment

Serviço:
MLExperiment
Versão da API:
v1

Cria um experimento de machine learning no workspace especificado.
Essa API dá suporte a LRO (operações de execução longa).

Essa API não dá suporte à criação de um experimento de machine learning com definição.

Permissões

O chamador deve ter uma função de workspace de colaborador .

Escopos delegados necessários

MLExperiment.ReadWrite.All ou Item.ReadWrite.All

Limitações

  • Para criar um experimento de machine learning, o workspace deve estar em uma capacidade do Fabric com suporte. Para obter mais informações, consulte: tipos de licença do Microsoft Fabric.

Identidades com suporte do Microsoft Entra

Esta API dá suporte às identidades do Microsoft listadas nesta seção.

Identidade Apoio
Utilizador Sim
entidade de serviço e identidades gerenciadas Não

Interfase

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mlExperiments

Parâmetros de URI

Nome Em Obrigatório Tipo Description
workspaceId
 path True

string (uuid)

A ID do workspace.

Corpo da solicitação

Nome Obrigatório Tipo Description
displayName True

string

O nome de exibição do experimento de machine learning. O nome de exibição deve seguir regras de nomenclatura de acordo com o tipo de item.
description

string

A descrição do experimento de machine learning. O comprimento máximo é de 256 caracteres.
folderId

string (uuid)

A ID da pasta. Se não for especificado ou nulo, o experimento de machine learning será criado com o workspace como sua pasta.

Respostas

Nome Tipo Description
201 Created

MLExperiment

Criado com êxito
202 Accepted

Solicitação aceita, provisionamento de experimentos de machine learning em andamento.

Cabeçalhos

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Códigos de erro comuns:

  • InvalidItemType – O tipo de item é inválido.

  • ItemDisplayNameAlreadyInUse – O nome de exibição do item já está sendo usado.

  • CorruptedPayload – O conteúdo fornecido está corrompido.

  • WorkspaceItemsLimitExceeded - Limite de itens do workspace excedido.

Exemplos

Create a machine learning experiment example

Solicitação de exemplo

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/mlExperiments

{
  "displayName": "MLExperiment_1",
  "description": "A machine learning experiment description"
}

Resposta de exemplo

Código de status:
201 
{
  "displayName": "MLExperiment_1",
  "description": "A machine learning experiment description",
  "type": "MLExperiment",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Código de status:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Definições

Nome Description
CreateMLExperimentRequest

Criar conteúdo de solicitação de experimento de machine learning.
ErrorRelatedResource

O objeto de detalhes do recurso relacionado ao erro.
ErrorResponse

A resposta de erro.
ErrorResponseDetails

Os detalhes da resposta de erro.
ItemTag

Representa uma marca aplicada em um item.
ItemType

O tipo do item. Tipos de item adicionais podem ser adicionados ao longo do tempo.
MLExperiment

Um objeto de experimento de machine learning.
MLExperimentProperties

As propriedades do experimento de machine learning.

CreateMLExperimentRequest

Objeto

Criar conteúdo de solicitação de experimento de machine learning.

Nome Tipo Description
description

string

A descrição do experimento de machine learning. O comprimento máximo é de 256 caracteres.
displayName

string

O nome de exibição do experimento de machine learning. O nome de exibição deve seguir regras de nomenclatura de acordo com o tipo de item.
folderId

string (uuid)

A ID da pasta. Se não for especificado ou nulo, o experimento de machine learning será criado com o workspace como sua pasta.

ErrorRelatedResource

Objeto

O objeto de detalhes do recurso relacionado ao erro.

Nome Tipo Description
resourceId

string

A ID do recurso envolvida no erro.
resourceType

string

O tipo do recurso envolvido no erro.

ErrorResponse

Objeto

A resposta de erro.

Nome Tipo Description
errorCode

string

Um identificador específico que fornece informações sobre uma condição de erro, permitindo a comunicação padronizada entre nosso serviço e seus usuários.
message

string

Uma representação legível humana do erro.
moreDetails

ErrorResponseDetails[]

Lista de detalhes de erro adicionais.
relatedResource

ErrorRelatedResource

Os detalhes do recurso relacionado ao erro.
requestId

string

ID da solicitação associada ao erro.

ErrorResponseDetails

Objeto

Os detalhes da resposta de erro.

Nome Tipo Description
errorCode

string

Um identificador específico que fornece informações sobre uma condição de erro, permitindo a comunicação padronizada entre nosso serviço e seus usuários.
message

string

Uma representação legível humana do erro.
relatedResource

ErrorRelatedResource

Os detalhes do recurso relacionado ao erro.

ItemTag

Objeto

Representa uma marca aplicada em um item.

Nome Tipo Description
displayName

string

O nome da marca.
id

string (uuid)

A ID da marca.

ItemType

Enumeração

O tipo do item. Tipos de item adicionais podem ser adicionados ao longo do tempo.

Valor Description
Dashboard

Painel do PowerBI.
Report

Relatório do PowerBI.
SemanticModel

Modelo semântico do PowerBI.
PaginatedReport

Relatório paginado do PowerBI.
Datamart

Datamart do PowerBI.
Lakehouse

Uma casa no lago.
Eventhouse

Uma casa de eventos.
Environment

Um ambiente.
KQLDatabase

Um banco de dados KQL.
KQLQueryset

Um conjunto de consultas KQL.
KQLDashboard

Um painel KQL.
DataPipeline

Um pipeline de dados.
Notebook

Um bloco de anotações.
SparkJobDefinition

Uma definição de trabalho do Spark.
MLExperiment

Um experimento de aprendizado de máquina.
MLModel

Um modelo de machine learning.
Warehouse

Um armazém.
Eventstream

Um fluxo de eventos.
SQLEndpoint

Um ponto de extremidade SQL.
MirroredWarehouse

Um armazém espelhado.
MirroredDatabase

Um banco de dados espelhado.
Reflex

Um Reflexo.
GraphQLApi

Um item de API para GraphQL.
MountedDataFactory

Um MountedDataFactory.
SQLDatabase

Um SQLDatabase.
CopyJob

Um trabalho de cópia.
VariableLibrary

Um VariableLibrary.
Dataflow

Um fluxo de dados.
ApacheAirflowJob

Um ApacheAirflowJob.
WarehouseSnapshot

Um instantâneo do Warehouse.
DigitalTwinBuilder

Um DigitalTwinBuilder.
DigitalTwinBuilderFlow

Um fluxo do Construtor de Gêmeos Digitais.
MirroredAzureDatabricksCatalog

Um catálogo espelhado do Azure Databricks.
Map

Um mapa.
AnomalyDetector

Um Detector de Anomalias.
UserDataFunction

Uma função de dados do usuário.
GraphModel

Um GraphModel.
GraphQuerySet

Um Graph QuerySet.
SnowflakeDatabase

Um Banco de Dados Snowflake para armazenar tabelas iceberg criadas a partir da conta snowflake.
OperationsAgent

Um OperationsAgent.
CosmosDBDatabase

Um banco de dados do Cosmos DB.
Ontology

Uma ontologia.
EventSchemaSet

Um EventSchemaSet.

MLExperiment

Objeto

Um objeto de experimento de machine learning.

Nome Tipo Description
description

string

A descrição do item.
displayName

string

O nome de exibição do item.
folderId

string (uuid)

A ID da pasta.
id

string (uuid)

A ID do item.
properties

MLExperimentProperties

As propriedades do experimento de machine learning.
tags

ItemTag[]

Lista de marcas aplicadas.
type

ItemType

O tipo de item.
workspaceId

string (uuid)

A ID do workspace.

MLExperimentProperties

Objeto

As propriedades do experimento de machine learning.

Nome Tipo Description
mlFlowExperimentId

string (uuid)

A ID do experimento de fluxo de machine learning interno.