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

Items - Update Spark Job Definition Definition

Служба:
SparkJobDefinition
Версия API:
v1

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

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

Разрешения

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

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

SparkJobDefinition.ReadWrite.All или Item.ReadWrite.All

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

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

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

Интерфейс

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sparkJobDefinitions/{sparkJobDefinitionId}/updateDefinition
С использованием необязательных параметров: 
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sparkJobDefinitions/{sparkJobDefinitionId}/updateDefinition?updateMetadata={updateMetadata}

Параметры URI

Имя В Обязательно Тип Описание
sparkJobDefinitionId
 path True

string (uuid)

Идентификатор определения задания Spark.
workspaceId
 path True

string (uuid)

Идентификатор рабочей области.
updateMetadata
 query

boolean

Если задано значение true и файл платформы предоставляется в рамках определения, метаданные элемента обновляются с помощью метаданных в файле платформы.

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

Имя Обязательно Тип Описание
definition True

SparkJobDefinitionPublicDefinition

Объект общедоступного определения задания Spark. Дополнительные сведения о создании общедоступного определения задания Spark см. в этой статье.

Ответы

Имя Тип Описание
200 OK

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

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

Заголовки

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

ErrorResponse

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

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

  • Поврежденный Payload — предоставленные полезные данные повреждены.

Примеры

Update a spark job definition public definition example

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

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

{
  "definition": {
    "parts": [
      {
        "path": "SparkJobDefinitionV1.json",
        "payload": "ew0KICAiZXhlY3V0YW..OWRmNDhhY2ZmZTgifQ==",
        "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

Определения

Имя Описание
ErrorRelatedResource

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

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

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

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

Объект общедоступного определения задания Spark. Дополнительные сведения о создании общедоступного определения задания Spark см. в этой статье.
SparkJobDefinitionPublicDefinitionPart

Объект части определения определения задания Spark.
UpdateSparkJobDefinitionDefinitionRequest

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

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.

SparkJobDefinitionPublicDefinition

Object

Объект общедоступного определения задания Spark. Дополнительные сведения о создании общедоступного определения задания Spark см. в этой статье.

Имя Тип Описание
format

string

Формат определения элемента. Поддерживаемый формат: SparkJobDefinitionV1.
parts

SparkJobDefinitionPublicDefinitionPart[]

Список частей определения.

SparkJobDefinitionPublicDefinitionPart

Object

Объект части определения определения задания Spark.

Имя Тип Описание
path

string

Путь к части определения задания Spark.
payload

string

Полезные данные общедоступного определения задания Spark.
payloadType

PayloadType

Тип полезных данных.

UpdateSparkJobDefinitionDefinitionRequest

Object

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

Имя Тип Описание
definition

SparkJobDefinitionPublicDefinition

Объект общедоступного определения задания Spark. Дополнительные сведения о создании общедоступного определения задания Spark см. в этой статье.