Jobs - ImportJobs List

Service:

Azure Digital Twins

API Version:

2023-10-31

모든 가져오기 작업을 검색합니다. 상태 코드:

• 200 정상

GET https://digitaltwins-hostname/jobs/imports?api-version=2023-10-31

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
api-version	query	True	string	요청된 API 버전입니다.

요청 헤더

Name	필수	형식	Description
max-items-per-page		integer	요청당 검색할 최대 항목 수입니다. 서버는 요청된 번호보다 적게 반환하도록 선택할 수 있습니다.
traceparent		string	분산 추적 시스템에서 요청을 식별합니다.
tracestate		string	공급업체별 추적 식별 정보를 제공하며 추적 매개 변수의 도우미입니다.

응답

Name	형식	Description
200 OK	ImportJobCollection	Success
Other Status Codes	ErrorResponse	기본 응답입니다. Headers x-ms-error-code: string

보안

oauth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize?resource=0b07f429-9f4b-4714-9392-cc5e8e80c8b0

예제

Get all import jobs

Sample Request

HTTP

GET https://digitaltwins-hostname/jobs/imports?api-version=2023-10-31

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "importjob1",
      "inputBlobUri": "path to input blob",
      "outputBlobUri": "path to output blob",
      "createdDateTime": "2022-01-01T00:00:00.0000000+00:00",
      "lastActionDateTime": "2022-01-01T00:01:00.0000000+00:00",
      "finishedDateTime": "2022-01-01T00:01:00.0000000+00:00",
      "purgeDateTime": "2022-01-31T00:01:00.0000000+00:00",
      "status": "succeeded"
    },
    {
      "id": "importjob2",
      "inputBlobUri": "path to input blob",
      "outputBlobUri": "path to output blob",
      "createdDateTime": "2022-01-01T00:00:00.0000000+00:00",
      "lastActionDateTime": "2022-01-01T00:01:00.0000000+00:00",
      "finishedDateTime": "2022-01-01T00:01:00.0000000+00:00",
      "purgeDateTime": "2022-01-31T00:01:00.0000000+00:00",
      "status": "succeeded"
    }
  ],
  "nextLink": "url-to-next-page"
}

정의

Name	Description
Error	오류 정의입니다.
ErrorResponse	오류 응답입니다.
ImportJob	수행할 작업, 결과 및 실행 메타데이터에 대한 참조를 포함하는 작업입니다.
ImportJobCollection	가져오기 작업 개체의 컬렉션입니다.
InnerError	포함된 오류에서 제공한 것보다 더 구체적인 오류 설명입니다.
status	작업의 상태.

Error

오류 정의입니다.

Name	형식	Description
code	string	HTTP 오류 코드의 하위 상태 역할을 하는 서비스별 오류 코드입니다.
details	Error[]	내부 오류 세부 정보입니다.
innererror	InnerError	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.

ErrorResponse

오류 응답입니다.

Name	형식	Description
error	Error	오류 세부 정보입니다.

ImportJob

수행할 작업, 결과 및 실행 메타데이터에 대한 참조를 포함하는 작업입니다.

Name	형식	Description
createdDateTime	string	작업의 시작 시간입니다. 타임스탬프는 RFC3339 형식입니다 yyyy-MM-ddTHH:mm:ssZ.
error	Error	가져오기 작업을 실행하여 발생한 오류에 대한 세부 정보입니다.
finishedDateTime	string	작업의 종료 시간입니다. 타임스탬프는 RFC3339 형식입니다 yyyy-MM-ddTHH:mm:ssZ.
id	string	가져오기 작업의 식별자입니다.
inputBlobUri	string	작업에서 수행할 작업을 설명하는 파일이 포함된 입력 Azure Storage Blob의 경로입니다.
lastActionDateTime	string	마지막으로 서비스가 작업에서 모든 작업을 수행했습니다. 타임스탬프는 RFC3339 형식입니다 yyyy-MM-ddTHH:mm:ssZ.
outputBlobUri	string	가져오기 작업의 오류 및 진행률 로그를 포함하는 출력 Azure Storage Blob의 경로입니다.
purgeDateTime	string	시스템에서 서비스에서 작업이 제거되는 시간입니다. 타임스탬프는 RFC3339 형식입니다 yyyy-MM-ddTHH:mm:ssZ.
status	status	작업의 상태.

ImportJobCollection

가져오기 작업 개체의 컬렉션입니다.

Name	형식	Description
nextLink	string	결과의 다음 페이지를 검색하는 URI입니다.
value	ImportJob[]	가져오기 작업 개체의 목록입니다.

InnerError

포함된 오류에서 제공한 것보다 더 구체적인 오류 설명입니다.

Name	형식	Description
code	string	포함하는 오류에서 제공한 것보다 더 구체적인 오류 코드입니다.
innererror	InnerError	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.

status

작업의 상태.

Name	형식	Description
cancelled	string
cancelling	string
failed	string
notstarted	string
running	string
succeeded	string