Tasks - Delete Task File

Служба:: Batch Service

Версия API:: 2025-06-01

Удаляет указанный файл задачи из вычислительного узла, где выполнялась задача.

DELETE {endpoint}/jobs/{jobId}/tasks/{taskId}/files/{filePath}?api-version=2025-06-01

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

DELETE {endpoint}/jobs/{jobId}/tasks/{taskId}/files/{filePath}?api-version=2025-06-01&timeOut={timeOut}&recursive={recursive}

Параметры URI

Имя	В	Обязательно	Тип	Описание
endpoint	path	True	string (uri)	Конечная точка учетной записи пакетной службы (например, https://batchaccount.eastus2.batch.azure.com).
filePath	path	True	string	Путь к файлу задачи, содержимое которого вы хотите получить.
jobId	path	True	string	ID работы, содержащей задачу.
taskId	path	True	string	ID задачи, файл которого вы хотите получить.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.
recursive	query		boolean	Удалять ли дочерние чертки каталога. Если параметр filePath представляет каталог, а не файл, вы можете установить рекурсивное значение true, чтобы удалить каталог и все файлы и подкаталоги в нём. Если рекурсивность ложна, то каталог должен быть пуст, иначе удаление не состоится.
timeOut	query		integer (int32)	Максимальное время, которое сервер может тратить на обработку запроса в секундах. Значение по умолчанию — 30 секунд. Если значение превышает 30, вместо этого используется стандартное значение.".

Заголовок запроса

Имя	Тип	Описание
client-request-id	string	Удостоверение запроса, созданное вызывающим пользователем, в виде GUID без украшений, таких как фигурные скобки, например 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Должен ли сервер возвращать идентификатор client-request-id в ответе.
ocp-date	string (date-time-rfc7231)	Время выдачи запроса. Клиентские библиотеки обычно задают это в текущее время системных часов; задайте его явным образом, если вы вызываете REST API напрямую.

Ответы

Имя	Тип	Описание
200 OK		Запрос выполнен успешно. Заголовки client-request-id: string request-id: string
Other Status Codes	BatchError	Непредвиденное сообщение об ошибке.

Имя

Тип

Описание

200 OK

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

Заголовки

client-request-id: string
request-id: string

Other Status Codes

BatchError

Непредвиденное сообщение об ошибке.

Безопасность

OAuth2Auth

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Области

Имя	Описание
https://batch.core.windows.net//.default

Примеры

File delete from task

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

HTTP

DELETE {endpoint}/jobs/jobId/tasks/task1/files/wd\testFile.txt?api-version=2025-06-01&recursive=False

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

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

Определения

Имя	Описание
BatchError	Ответ об ошибке, полученный из пакетной службы Azure.
BatchErrorDetail	Элемент дополнительных сведений, включенных в ответ на ошибку пакетной службы Azure.
BatchErrorMessage	Сообщение об ошибке, полученное в ответе на ошибку пакетной службы Azure.

BatchError

Объект

Ответ об ошибке, полученный из пакетной службы Azure.

Имя	Тип	Описание
code	string	Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.
message	BatchErrorMessage	Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.
values	BatchErrorDetail[]	Коллекция пар "ключ-значение", содержащая дополнительные сведения об ошибке.

BatchErrorDetail

Объект

Элемент дополнительных сведений, включенных в ответ на ошибку пакетной службы Azure.

Имя	Тип	Описание
key	string	Идентификатор, указывающий значение свойства Value.
value	string	Дополнительные сведения, включенные в ответ на ошибку.

BatchErrorMessage

Объект

Сообщение об ошибке, полученное в ответе на ошибку пакетной службы Azure.

Имя	Тип	Описание
lang	string	Языковой код сообщения об ошибке.
value	string	Текст сообщения.