Partilhar via


Background Jobs - Run On Demand Apply Changes

Observação

Esta API está em pré-visualização.

Executar a instância de trabalho de alterações de aplicação sob demanda.

Escopos delegados necessários

Para APIs de fluxos de dados, use estes tipos de escopo:

  • Escopo específico: Dataflow.Execute.All

Para obter mais informações sobre escopos, consulte: Escopos Artigo.

Identidades suportadas pelo Entra da Microsoft

Esta API suporta as identidades do Microsoft listadas nesta secção.

Identidade Apoio
Utilizador Sim
Entidade de serviço e identidades geridas Não

Interfaz

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/dataflows/{dataflowId}/jobs/instances?jobType={jobType}

Parâmetros do URI

Name Em Necessário Tipo Description
dataflowId
path True

string (uuid)

O ID do fluxo de dados.

workspaceId
path True

string (uuid)

O ID do espaço de trabalho.

jobType
query True

string

Tipo de trabalho ApplyChanges.

Respostas

Name Tipo Description
202 Accepted

Pedido aceite, a execução do trabalho está em curso.

Cabeçalhos

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Códigos de erro comuns:

  • InsufficientPrivileges - O chamador não tem permissões suficientes para executar a instância de trabalho.

  • InvalidJobType - O tipo de trabalho solicitado é inválido.

  • TooManyRequestsForJobs - O chamador solicita muitas solicitações de trabalho sob demanda.

  • ItemNotFound - ID do item solicitado não encontrado.

Exemplos

Run dataflow ApplyChanges job instance example

Pedido de amostra

POST https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/dataflows/dddddddd-9999-0000-1111-eeeeeeeeeeee/jobs/instances?jobType=ApplyChanges

Resposta da amostra

Location: https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/items/dddddddd-9999-0000-1111-eeeeeeeeeeee/jobs/instances/bbbbbbbb-1111-2222-3333-cccccccccccc
Retry-After: 60

Definições

Name Description
ErrorRelatedResource

O objeto de detalhes do recurso relacionado ao erro.

ErrorResponse

A resposta de erro.

ErrorResponseDetails

Os detalhes da resposta de erro.

ErrorRelatedResource

O objeto de detalhes do recurso relacionado ao erro.

Name Tipo Description
resourceId

string

A ID do recurso envolvida no erro.

resourceType

string

O tipo de recurso envolvido no erro.

ErrorResponse

A resposta de erro.

Name Tipo Description
errorCode

string

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

message

string

Uma representação legível por humanos do erro.

moreDetails

ErrorResponseDetails[]

Lista de detalhes de erro adicionais.

relatedResource

ErrorRelatedResource

Os detalhes do recurso relacionados ao erro.

requestId

string

ID da solicitação associada ao erro.

ErrorResponseDetails

Os detalhes da resposta de erro.

Name Tipo Description
errorCode

string

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

message

string

Uma representação legível por humanos do erro.

relatedResource

ErrorRelatedResource

Os detalhes do recurso relacionados ao erro.