Items - Update Apache Airflow Job Definition

Служба:: ApacheAirflowJob

Версия API:: v1

Переопределяет определение для указанного задания Apache Airflow.
Этот API поддерживает длительные операции (LRO).

Обновление определения не влияет на метку конфиденциальности.

Разрешения

Вызывающий объект должен иметь разрешения на чтение и запись для задания apache airflow.

Обязательные делегированные области

ApacheAirflowJob.ReadWrite.All или Item.ReadWrite.All

Идентификаторы, поддерживаемые Microsoft Entra

Этот API поддерживает идентичности Microsoft, перечисленные в этом разделе.

Идентичность	Поддержка
Пользователь	Да
Представитель службы и управляемые удостоверения	Да

Интерфейс

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

С использованием необязательных параметров:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/ApacheAirflowJobs/{ApacheAirflowJobId}/updateDefinition?updateMetadata={updateMetadata}

Параметры URI

Имя	В	Обязательно	Тип	Описание
ApacheAirflowJobId	path	True	string (uuid)	Идентификатор задания Apache Airflow.
workspaceId	path	True	string (uuid)	Идентификатор рабочей области.
updateMetadata	query		boolean	Если задано значение true и файл платформы предоставляется в рамках определения, метаданные элемента обновляются с помощью метаданных в файле платформы.

Текст запроса

Имя	Обязательно	Тип	Описание
definition	True	ApacheAirflowJobDefinition	Объект общедоступного определения задания Apache Airflow.

Ответы

Имя	Тип	Описание
200 OK		Запрос успешно завершен.
202 Accepted		Запрос принят. Определение обновления выполняется. Заголовки Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Распространенные коды ошибок: OperationNotSupportedForItem — операция не поддерживается для запрошенного элемента. Поврежденный Payload — предоставленные полезные данные повреждены.

Имя

Тип

Описание

200 OK

Запрос успешно завершен.

202 Accepted

Запрос принят. Определение обновления выполняется.

Заголовки

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

Распространенные коды ошибок:

OperationNotSupportedForItem — операция не поддерживается для запрошенного элемента.
Поврежденный Payload — предоставленные полезные данные повреждены.

Примеры

Update an Apache Airflow job public definition example

Образец запроса

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/ApacheAirflowJobs/5b218778-e7a5-4d73-8187-f10824047715/updateDefinition?updateMetadata=True

{
  "definition": {
    "parts": [
      {
        "path": "ApacheAirflowJobV1.json",
        "payload": "ewogICJwcm9wZXJ0aWVzIjogewogICAgInR5cGUiOiAiQXBhY2hlQWlyZmxvd0pvYiIsCiAgICAidHlwZVByb3BlcnRpZXMiOiB7CiAgICAgICJhaXJmbG93UHJvcGVydGllcyI6IHsKICAgICAgICAiYWlyZmxvd1ZlcnNpb24iOiAiMi42LjMiLAogICAgICAgICJweXRob25WZXJzaW9uIjogIjMuOCIsCiAgICAgICAgImVudmlyb25tZW50VmFyaWFibGVzIjoge30sCiAgICAgICAgImFpcmZsb3dDb25maWd1cmF0aW9uT3ZlcnJpZGVzIjoge30sCiAgICAgICAgImFpcmZsb3dSZXF1aXJlbWVudHMiOiBbCiAgICAgICAgICAiZmxhc2stYmNyeXB0PT0wLjcuMSIKICAgICAgICBdLAogICAgICAgICJwYWNrYWdlUHJvdmlkZXJQYXRoIjogInBsdWdpbnMiLAogICAgICAgICJlbmFibGVBQURJbnRlZ3JhdGlvbiI6IHRydWUsCiAgICAgICAgImVuYWJsZVRyaWdnZXJlcnMiOiBmYWxzZSwKICAgICAgICAic2VjcmV0cyI6IFtdCiAgICAgIH0sCiAgICAgICJjb21wdXRlUHJvcGVydGllcyI6IHsKICAgICAgICAiY29tcHV0ZVBvb2wiOiAiU3RhcnRlclBvb2wiLAogICAgICAgICJsb2NhdGlvbiI6ICJDZW50cmFsIFVTIiwKICAgICAgICAiY29tcHV0ZVNpemUiOiAiU21hbGwiLAogICAgICAgICJleHRyYU5vZGVzIjogMCwKICAgICAgICAiZW5hYmxlQXZhaWxhYmlsaXR5Wm9uZXMiOiBmYWxzZSwKICAgICAgICAiZW5hYmxlQXV0b3NjYWxlIjogZmFsc2UKICAgICAgfQogICAgfQogIH0KfQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Пример ответа

Код состояния:: 200

Код состояния:: 202

Location: https://api.fabric.microsoft.com/v1/operations/427f6c34-b64e-4ee4-8ea5-b533c0e203ef
x-ms-operation-id: 427f6c34-b64e-4ee4-8ea5-b533c0e203ef
Retry-After: 30

Определения

Имя	Описание
ApacheAirflowJobDefinition	Объект общедоступного определения задания Apache Airflow.
ApacheAirflowJobDefinitionPart	Объект общедоступного определения задания Apache Airflow.
ErrorRelatedResource	Объект сведений об ошибках, связанных с ресурсом.
ErrorResponse	Ответ на ошибку.
ErrorResponseDetails	Сведения об ответе на ошибку.
PayloadType	Тип полезных данных части определения. С течением времени могут добавляться дополнительные типы полезных данных.
UpdateApacheAirflowJobDefinitionRequest	Обновление полезных данных запроса на общедоступное определение.

ApacheAirflowJobDefinition

Object

Объект общедоступного определения задания Apache Airflow.

Имя	Тип	Описание
parts	ApacheAirflowJobDefinitionPart[]	Список частей определения.

ApacheAirflowJobDefinitionPart

Object

Объект общедоступного определения задания Apache Airflow.

Имя	Тип	Описание
path	string	Путь к части общедоступного определения.
payload	string	Полезные данные части общедоступного определения.
payloadType	PayloadType	Тип полезных данных.

ErrorRelatedResource

Object

Объект сведений об ошибках, связанных с ресурсом.

Имя	Тип	Описание
resourceId	string	Идентификатор ресурса, участвующий в ошибке.
resourceType	string	Тип ресурса, который участвует в ошибке.

ErrorResponse

Object

Ответ на ошибку.

Имя	Тип	Описание
errorCode	string	Определенный идентификатор, предоставляющий сведения об условии ошибки, что позволяет стандартизировать обмен данными между службой и ее пользователями.
message	string	Удобочитаемое представление ошибки.
moreDetails	ErrorResponseDetails[]	Список дополнительных сведений об ошибке.
relatedResource	ErrorRelatedResource	Сведения об ошибках, связанных с ресурсом.
requestId	string	Идентификатор запроса, связанного с ошибкой.

ErrorResponseDetails

Object

Сведения об ответе на ошибку.

Имя	Тип	Описание
errorCode	string	Определенный идентификатор, предоставляющий сведения об условии ошибки, что позволяет стандартизировать обмен данными между службой и ее пользователями.
message	string	Удобочитаемое представление ошибки.
relatedResource	ErrorRelatedResource	Сведения об ошибках, связанных с ресурсом.

PayloadType

Перечисление

Тип полезных данных части определения. С течением времени могут добавляться дополнительные типы полезных данных.

Значение	Описание
InlineBase64	Встроенная база 64.

UpdateApacheAirflowJobDefinitionRequest

Object

Обновление полезных данных запроса на общедоступное определение.

Имя	Тип	Описание
definition	ApacheAirflowJobDefinition	Объект общедоступного определения задания Apache Airflow.

Поделиться через

Items - Update Apache Airflow Job Definition

Разрешения

Обязательные делегированные области

Идентификаторы, поддерживаемые Microsoft Entra

Интерфейс

Параметры URI

Текст запроса

Ответы

Примеры

Update an Apache Airflow job public definition example

Образец запроса

Пример ответа

Определения

ApacheAirflowJobDefinition

ApacheAirflowJobDefinitionPart

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

PayloadType

UpdateApacheAirflowJobDefinitionRequest