File - List From Task

참조

Service:: Batch Service

API Version:: 2023-11-01.18.0

컴퓨팅 노드의 작업 디렉터리에 있는 파일을 나열합니다.

GET {batchUrl}/jobs/{jobId}/tasks/{taskId}/files?api-version=2023-11-01.18.0

With optional parameters:

GET {batchUrl}/jobs/{jobId}/tasks/{taskId}/files?$filter={$filter}&recursive={recursive}&maxresults={maxresults}&timeout={timeout}&api-version=2023-11-01.18.0

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
batchUrl	path	True	string	모든 Azure Batch 서비스 요청에 대한 기본 URL입니다.
jobId	path	True	string	작업이 포함된 작업의 ID입니다.
taskId	path	True	string	나열할 파일이 있는 작업의 ID입니다.
api-version	query	True	string	클라이언트 API 버전.
$filter	query		string	OData $filter 절입니다. 이 필터를 생성하는 방법에 대한 자세한 내용은 을 참조하세요 https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-task-files.
maxresults	query		integer int32	응답에서 반환할 최대 항목 수입니다. 최대 1,000 파일을 반환할 수 있습니다.
recursive	query		boolean	작업 디렉터리의 자식을 나열할지 여부입니다. 이 매개 변수는 필터 매개 변수와 함께 사용하여 특정 형식의 파일을 나열할 수 있습니다.
timeout	query		integer int32	서버가 요청을 처리하는 데 소요할 수 있는 최대 시간(초)입니다. 기본값은 30초입니다.

요청 헤더

Media Types: "application/json; odata=minimalmetadata"

Name	형식	Description
client-request-id	string uuid	9C4D50EE-2D56-4CD3-8152-34347DC9F2B0과 같은 장식이 없는 GUID 형식의 호출자 생성 요청 ID입니다.
return-client-request-id	boolean	서버가 응답에서 client-request-id를 반환해야 하는지 여부입니다.
ocp-date	string date-time-rfc1123	요청이 실행된 시간입니다. 클라이언트 라이브러리는 일반적으로 이를 현재 시스템 클록 시간으로 설정합니다. REST API를 직접 호출하는 경우 명시적으로 설정합니다.

응답

Name	형식	Description
200 OK	NodeFileListResult	파일 목록을 포함하는 응답입니다. Headers client-request-id: string request-id: string ETag: string Last-Modified: string
Other Status Codes	BatchError	Batch 서비스의 오류입니다.

Name

형식

Description

200 OK

NodeFileListResult

파일 목록을 포함하는 응답입니다.

Headers

client-request-id: string
request-id: string
ETag: string
Last-Modified: string

Other Status Codes

BatchError

Batch 서비스의 오류입니다.

보안

azure_auth

OAuth 2.0 인증 코드 흐름 Microsoft Entra

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	사용자 계정 가장

Authorization

Type: apiKey
In: header

예제

File list from task

Sample Request

HTTP

GET account.region.batch.azure.com/jobs/jobId/tasks/taskId/files?recursive=False&api-version=2023-11-01.18.0

Sample Response

Status code:: 200

{
  "value": [
    {
      "name": "startup\\ProcessEnv.cmd",
      "url": "https://account.region.batch.azure.com/jobs/jobId/tasks/taskId/files/startup\\ProcessEnv.cmd",
      "isDirectory": false,
      "properties": {
        "creationTime": "2014-09-19T21:56:17.679195Z",
        "lastModified": "2014-09-19T21:56:17.679195Z",
        "contentLength": 1813,
        "contentType": "application/octet-stream"
      }
    },
    {
      "name": "startup\\stderr.txt",
      "url": "https://account.region.batch.azure.com/jobs/jobId/tasks/taskId/files/startup\\stderr.txt",
      "isDirectory": false,
      "properties": {
        "creationTime": "2014-09-19T21:56:17.5590855Z",
        "lastModified": "2014-09-19T21:56:17.5590855Z",
        "contentLength": 0,
        "contentType": "application/octet-stream"
      }
    }
  ]
}

정의

Name	Description
BatchError	Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail	Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
ErrorMessage	Azure Batch 오류 응답에서 받은 오류 메시지입니다.
FileProperties	컴퓨팅 노드에 있는 파일의 속성입니다.
NodeFile	컴퓨팅 노드의 파일 또는 디렉터리에 대한 정보입니다.
NodeFileListResult	컴퓨팅 노드의 파일 또는 컴퓨팅 노드의 작업과 연결된 파일을 나열한 결과입니다.

BatchError

Azure Batch 서비스에서 받은 오류 응답입니다.

Name	형식	Description
code	string	오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다.
message	ErrorMessage	사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
values	BatchErrorDetail[]	오류에 대한 추가 세부 정보가 포함된 키-값 쌍의 컬렉션입니다.

BatchErrorDetail

Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.

Name	형식	Description
key	string	Value 속성의 의미를 지정하는 식별자입니다.
value	string	오류 응답에 포함된 추가 정보입니다.

ErrorMessage

Azure Batch 오류 응답에서 받은 오류 메시지입니다.

Name	형식	Description
lang	string	오류 메시지의 언어 코드
value	string	메시지의 텍스트입니다.

FileProperties

컴퓨팅 노드에 있는 파일의 속성입니다.

Name	형식	Description
contentLength	integer	파일의 길이입니다.
contentType	string	파일의 콘텐츠 유형.
creationTime	string	파일 생성 시간입니다. Linux 컴퓨팅 노드의 파일에 대해 생성 시간이 반환되지 않습니다.
fileMode	string	8진수 형식의 파일 모드 특성입니다. 파일 모드는 Linux 컴퓨팅 노드의 파일에 대해서만 반환됩니다.
lastModified	string	파일이 마지막으로 수정된 시간입니다.

NodeFile

컴퓨팅 노드의 파일 또는 디렉터리에 대한 정보입니다.

Name	형식	Description
isDirectory	boolean	개체가 디렉터리를 나타내는지 여부입니다.
name	string	파일 경로입니다.
properties	FileProperties	파일 속성입니다.
url	string	파일의 URL입니다.

NodeFileListResult

컴퓨팅 노드의 파일 또는 컴퓨팅 노드의 작업과 연결된 파일을 나열한 결과입니다.

Name	형식	Description
odata.nextLink	string	다음 결과 집합을 가져올 URL입니다.
value	NodeFile[]	파일 목록입니다.

File - List From Task

URI 매개 변수

요청 헤더

응답

보안

azure_auth

Scopes

Authorization

예제

File list from task

Sample Request

Sample Response

정의

BatchError

BatchErrorDetail

ErrorMessage

FileProperties

NodeFile

NodeFileListResult

추가 리소스