Jobs - ImportJobs Cancel

Service:

Azure Digital Twins

API Version:

2023-10-31

현재 실행 중인 가져오기 작업을 취소합니다. 서비스는 진행 중인 현재 가져오기 작업에 의해 트리거되는 가져오기 작업을 중지하고 취소된 상태로 이동합니다. 롤백 작업이 없으면 instance 알 수 없는 상태로 남게 됩니다. 상태 코드:

• 200 요청 수락됨
• 400 잘못된 요청
  • ValidationFailed - 가져오기 작업 요청이 잘못되었습니다.

POST https://digitaltwins-hostname/jobs/imports/{id}/cancel?api-version=2023-10-31

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
id	path	True	string	가져오기 작업의 ID입니다. ID는 서비스 내에서 고유하며 대/소문자를 구분합니다.
api-version	query	True	string	요청된 API 버전입니다.

요청 헤더

Name	필수	형식	Description
traceparent		string	분산 추적 시스템에서 요청을 식별합니다.
tracestate		string	공급업체별 추적 식별 정보를 제공하며 추적 매개 변수의 도우미입니다.

응답

Name	형식	Description
200 OK	ImportJob	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

예제

Cancel a job

Sample Request

HTTP

POST https://digitaltwins-hostname/jobs/imports/importjob1/cancel?api-version=2023-10-31

Sample Response

Status code:

200

{
  "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",
  "purgeDateTime": "2022-01-31T00:01:00.0000000+00:00",
  "status": "cancelling"
}

정의

Name	Description
Error	오류 정의.
ErrorResponse	오류 응답입니다.
ImportJob	수행할 작업, 결과 및 실행 메타데이터에 대한 참조가 포함된 작업입니다.
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	작업의 상태.

InnerError

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

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

status

작업의 상태.

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