Udostępnij przez

Items - Create Apache Airflow Job

Usługa:
ApacheAirflowJob
Wersja API:
v1

Tworzy zadanie apache Airflow w określonym obszarze roboczym.
Ten interfejs API obsługuje długotrwałych operacji (LRO).

Aby utworzyć zadanie platformy Apache Airflow z publiczną definicją, zapoznaj się z artykułem.

Uprawnienia

Obiekt wywołujący musi mieć rolę obszaru roboczego współautora .

Wymagane zakresy delegowane

ApacheAirflowJob.ReadWrite.All lub Item.ReadWrite.All

Ograniczenia

  • Aby utworzyć zadanie apache Airflow, obszar roboczy musi znajdować się w obsługiwanej pojemności sieci szkieletowej. Aby uzyskać więcej informacji, zobacz: typy licencji usługi Microsoft Fabric.

Tożsamości obsługiwane przez Microsoft Entra

To API obsługuje tożsamości Microsoft wymienione w tej sekcji.

Tożsamość Wsparcie
Użytkownik Tak
Główne usługi i Tożsamości zarządzane Tak

Interfejs

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

Parametry URI

Nazwa W Wymagane Typ Opis
workspaceId
 path True

string (uuid)

Identyfikator przestrzeni roboczej.

Ciało żądania

Nazwa Wymagane Typ Opis
displayName True

string

Nazwa wyświetlana zadania Apache Airflow. Nazwa wyświetlana musi być zgodna z regułami nazewnictwa zgodnie z typem elementu.
definition

ApacheAirflowJobDefinition

Definicja publiczna zadania Apache Airflow.
description

string

Opis zadania Apache Airflow. Maksymalna długość to 256 znaków.
folderId

string (uuid)

Identyfikator folderu. Jeśli nie zostanie określony lub ma wartość null, przepływ apache Airflow zostanie utworzony z obszarem roboczym jako jego folderem.

Odpowiedzi

Nazwa Typ Opis
201 Created

ApacheAirflowJob

Pomyślnie utworzono
202 Accepted

Żądanie zaakceptowane, aprowizowanie w toku.

Nagłówki

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

ErrorResponse

Typowe kody błędów:

  • InvalidItemType — typ elementu jest nieprawidłowy

  • ItemDisplayNameAlreadyInUse — nazwa wyświetlana elementu jest już używana.

  • CorruptedPayload — podany ładunek jest uszkodzony.

Przykłady

Create an Apache Airflow job with public definition example

Przykładowa prośba

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

{
  "displayName": "ApacheAirflowJob1",
  "description": "An Apache Airflow job description."
}

Przykładowa odpowiedź

Kod statusu:
201 
{
  "displayName": "ApacheAirflowJob1",
  "description": "An Apache Airflow job description.",
  "type": "ApacheAirflowJob",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Kod statusu:
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

Definicje

Nazwa Opis
ApacheAirflowJob

Obiekt zadania Apache Airflow.
ApacheAirflowJobDefinition

Obiekt definicji publicznej zadania Apache Airflow.
ApacheAirflowJobDefinitionPart

Obiekt części definicji publicznej zadania Apache Airflow.
CreateApacheAirflowJobRequest

Utwórz ładunek żądania.
ErrorRelatedResource

Obiekt szczegółów zasobu powiązanego z błędem.
ErrorResponse

Odpowiedź na błąd.
ErrorResponseDetails

Szczegóły odpowiedzi na błąd.
ItemTag

Reprezentuje tag zastosowany w elemencie.
ItemType

Typ elementu. Dodatkowe typy elementów można dodawać w czasie.
PayloadType

Typ ładunku części definicji. Dodatkowe typy ładunków mogą być dodawane w czasie.

ApacheAirflowJob

Sprzeciwiać się

Obiekt zadania Apache Airflow.

Nazwa Typ Opis
description

string

Opis elementu.
displayName

string

Nazwa wyświetlana elementu.
folderId

string (uuid)

Identyfikator folderu.
id

string (uuid)

Identyfikator elementu.
tags

ItemTag[]

Lista zastosowanych tagów.
type

ItemType

Typ elementu.
workspaceId

string (uuid)

Identyfikator przestrzeni roboczej.

ApacheAirflowJobDefinition

Sprzeciwiać się

Obiekt definicji publicznej zadania Apache Airflow.

Nazwa Typ Opis
parts

ApacheAirflowJobDefinitionPart[]

Lista części definicji.

ApacheAirflowJobDefinitionPart

Sprzeciwiać się

Obiekt części definicji publicznej zadania Apache Airflow.

Nazwa Typ Opis
path

string

Ścieżka części definicji publicznej.
payload

string

Ładunek części definicji publicznej.
payloadType

PayloadType

Typ ładunku.

CreateApacheAirflowJobRequest

Sprzeciwiać się

Utwórz ładunek żądania.

Nazwa Typ Opis
definition

ApacheAirflowJobDefinition

Definicja publiczna zadania Apache Airflow.
description

string

Opis zadania Apache Airflow. Maksymalna długość to 256 znaków.
displayName

string

Nazwa wyświetlana zadania Apache Airflow. Nazwa wyświetlana musi być zgodna z regułami nazewnictwa zgodnie z typem elementu.
folderId

string (uuid)

Identyfikator folderu. Jeśli nie zostanie określony lub ma wartość null, przepływ apache Airflow zostanie utworzony z obszarem roboczym jako jego folderem.

ErrorRelatedResource

Sprzeciwiać się

Obiekt szczegółów zasobu powiązanego z błędem.

Nazwa Typ Opis
resourceId

string

Identyfikator zasobu, który jest zaangażowany w błąd.
resourceType

string

Typ zasobu, który jest zaangażowany w błąd.

ErrorResponse

Sprzeciwiać się

Odpowiedź na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
moreDetails

ErrorResponseDetails[]

Lista dodatkowych szczegółów błędu.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.
requestId

string

Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Sprzeciwiać się

Szczegóły odpowiedzi na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.

ItemTag

Sprzeciwiać się

Reprezentuje tag zastosowany w elemencie.

Nazwa Typ Opis
displayName

string

Nazwa znacznika.
id

string (uuid)

Identyfikator tagu.

ItemType

Wyliczenie

Typ elementu. Dodatkowe typy elementów można dodawać w czasie.

Wartość Opis
Dashboard

Pulpit nawigacyjny usługi Power BI.
Report

Raport usługi Power BI.
SemanticModel

Model semantyczny usługi PowerBI.
PaginatedReport

Raport podzielony na strony usługi PowerBI.
Datamart

Datamart usługi Power BI.
Lakehouse

Jezioro.
Eventhouse

Magazyn zdarzeń.
Environment

Środowisko.
KQLDatabase

Baza danych KQL.
KQLQueryset

Zestaw zapytań KQL.
KQLDashboard

Pulpit nawigacyjny KQL.
DataPipeline

Potok danych.
Notebook

Zeszyt.
SparkJobDefinition

Definicja zadania platformy Spark.
MLExperiment

Eksperyment uczenia maszynowego.
MLModel

Model uczenia maszynowego.
Warehouse

Magazyn.
Eventstream

Strumień zdarzeń.
SQLEndpoint

Punkt końcowy SQL.
MirroredWarehouse

Dublowany magazyn.
MirroredDatabase

Dublowana baza danych.
Reflex

Refleks.
GraphQLApi

Interfejs API dla elementu GraphQL.
MountedDataFactory

A MountedDataFactory.
SQLDatabase

Baza danych SQLDatabase.
CopyJob

Zadanie kopiowania.
VariableLibrary

ZmiennaLibrary.
Dataflow

Przepływ danych.
ApacheAirflowJob

Zadanie ApacheAirflowJob.
WarehouseSnapshot

Migawka magazynu.
DigitalTwinBuilder

A DigitalTwinBuilder.
DigitalTwinBuilderFlow

Przepływ usługi Digital Twin Builder.
MirroredAzureDatabricksCatalog

Dublowany wykaz usługi Azure Databricks.
Map

Mapa.
AnomalyDetector

Wykrywacz anomalii.
UserDataFunction

Funkcja danych użytkownika.
GraphModel

Model programu Graph.
GraphQuerySet

Zestaw zapytań programu Graph.
SnowflakeDatabase

Baza danych Snowflake do przechowywania tabel góry lodowej utworzonych na podstawie konta Snowflake.
OperationsAgent

A OperationsAgent.
CosmosDBDatabase

Baza danych usługi Cosmos DB.
Ontology

Ontologia.
EventSchemaSet

An EventSchemaSet.

PayloadType

Wyliczenie

Typ ładunku części definicji. Dodatkowe typy ładunków mogą być dodawane w czasie.

Wartość Opis
InlineBase64

Śródliniowa baza 64.