Backup Operation Statuses - Get

서비스:

Recovery Services - Backup

API 버전:

2025-08-01

백업 트리거, 복원과 같은 작업의 상태를 가져옵니다. 상태가 진행 중이거나 완료되었거나 실패할 수 있습니다. 작업의 가능한 모든 상태에 대해 OperationStatus 열거형을 참조할 수 있습니다. 일부 작업은 작업을 만듭니다. 이 메서드는 작업이 완료되면 작업 목록을 반환합니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupOperations/{operationId}?api-version=2025-08-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
operationId	path	True	string	작업을 나타내는 OperationID입니다.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
subscriptionId	path	True	string minLength: 1	대상 구독의 ID입니다.
vaultName	path	True	string	복구 서비스 자격 증명 모음의 이름입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	OperationStatus	Azure 작업이 성공적으로 완료되었습니다.
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Get Protected Item Delete Operation Status

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/PythonSDKBackupTestRg/providers/Microsoft.RecoveryServices/vaults/PySDKBackupTestRsVault/backupOperations/00000000-0000-0000-0000-000000000000?api-version=2025-08-01

샘플 응답

상태 코드:

200

{
  "name": "00000000-0000-0000-0000-000000000000",
  "endTime": "0001-01-01T00:00:00.00000Z",
  "id": "00000000-0000-0000-0000-000000000000",
  "startTime": "2017-08-03T06:52:53.886027Z",
  "status": "InProgress"
}

정의

Name	Description
ClientScriptForConnect	파일/폴더 복원에 대한 클라이언트 스크립트 세부 정보입니다.
ErrorDetail	코드, 메시지 및 권장 사항을 캡슐화하는 Error Detail 클래스입니다.
ErrorResponse	오류 응답
InstantItemRecoveryTarget	파일/폴더 복원에 대한 대상 세부 정보입니다.
OperationStatus	작업 상태입니다.
OperationStatusError	작업 상태 호출과 관련된 오류 정보입니다.
OperationStatusJobExtendedInfo	작업 상태 작업 확장 정보입니다.
OperationStatusJobsExtendedInfo	작업 목록에 대한 작업 상태 확장 정보입니다.
OperationStatusProvisionILRExtendedInfo	ILR 프로비전 작업에 대한 작업 상태 확장 정보입니다.
OperationStatusValidateOperationExtendedInfo	ValidateOperation 작업에 대한 작업 상태 확장 정보입니다.
OperationStatusValues	작업 상태입니다.
ValidateOperationResponse	작업 응답의 유효성을 검사하기 위한 기본 클래스입니다.

ClientScriptForConnect

Object

파일/폴더 복원에 대한 클라이언트 스크립트 세부 정보입니다.

Name	형식	Description
osType	string	OS 유형 - 이 파일/폴더 복원 클라이언트 스크립트가 작동하는 Windows, Linux 등
scriptContent	string	파일/폴더 복원을 위한 클라이언트 스크립트의 파일 콘텐츠입니다.
scriptExtension	string	파일/폴더 복원을 위한 클라이언트 스크립트의 파일 확장명은 .ps1, .sh 등입니다.
scriptNameSuffix	string	사용자에게 다운로드할 수 있도록 지정된 스크립트 이름에 추가해야 하는 필수 접미사입니다. null이거나 비어 있으면 무시합니다.
url	string	콘텐츠를 소스로 사용할 위치의 실행 파일 URL입니다. Null이 아닌 경우 ScriptContent를 사용하면 안 됩니다.

ErrorDetail

Object

코드, 메시지 및 권장 사항을 캡슐화하는 Error Detail 클래스입니다.

Name	형식	Description
code	string	오류 코드입니다.
message	string	코드와 관련된 오류 메시지입니다.
recommendations	string[]	권장 사항 문자열 목록입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

InstantItemRecoveryTarget

Object

파일/폴더 복원에 대한 대상 세부 정보입니다.

Name	형식	Description
clientScripts	ClientScriptForConnect[]	클라이언트 스크립트 목록입니다.

OperationStatus

Object

작업 상태입니다.

Name	형식	Description
endTime	string (date-time)	작업 종료 시간입니다. 형식: ISO-8601.
error	OperationStatusError	이 작업과 관련된 오류 정보입니다.
id	string	작업의 ID입니다.
name	string	작업의 이름입니다.
properties	OperationStatusExtendedInfo: OperationStatusJobExtendedInfo OperationStatusJobsExtendedInfo OperationStatusProvisionILRExtendedInfo OperationStatusValidateOperationExtendedInfo	이 작업과 관련된 추가 정보입니다.
startTime	string (date-time)	작업 시작 시간입니다. 형식: ISO-8601.
status	OperationStatusValues	작업 상태입니다.

OperationStatusError

Object

작업 상태 호출과 관련된 오류 정보입니다.

Name	형식	Description
code	string	작업 실패의 오류 코드입니다.
message	string	작업이 실패하면 오류 메시지가 표시됩니다.

OperationStatusJobExtendedInfo

Object

작업 상태 작업 확장 정보입니다.

Name	형식	Description
jobId	string	이 보호된 항목에 대해 만든 작업의 ID입니다.
objectType	string: OperationStatusJobExtendedInfo	이 속성 형식의 다형 체인에서 특정 형식을 결정 하는 판별자로 사용 됩니다.

OperationStatusJobsExtendedInfo

Object

작업 목록에 대한 작업 상태 확장 정보입니다.

Name	형식	Description
failedJobsError	object	실패한 모든 작업을 해당 오류 코드와 함께 저장합니다.
jobIds	string[]	보호된 항목에 대해 만든 작업의 ID입니다.
objectType	string: OperationStatusJobsExtendedInfo	이 속성 형식의 다형 체인에서 특정 형식을 결정 하는 판별자로 사용 됩니다.

OperationStatusProvisionILRExtendedInfo

Object

ILR 프로비전 작업에 대한 작업 상태 확장 정보입니다.

Name	형식	Description
objectType	string: OperationStatusProvisionILRExtendedInfo	이 속성 형식의 다형 체인에서 특정 형식을 결정 하는 판별자로 사용 됩니다.
recoveryTarget	InstantItemRecoveryTarget	파일/폴더 복원에 대한 대상 세부 정보입니다.

OperationStatusValidateOperationExtendedInfo

Object

ValidateOperation 작업에 대한 작업 상태 확장 정보입니다.

Name	형식	Description
objectType	string: OperationStatusValidateOperationExtendedInfo	이 속성 형식의 다형 체인에서 특정 형식을 결정 하는 판별자로 사용 됩니다.
validateOperationResponse	ValidateOperationResponse	유효성 검사 작업 응답을 가져옵니다.

OperationStatusValues

열거형

작업 상태입니다.

값	Description
Invalid
InProgress
Succeeded
Failed
Canceled

ValidateOperationResponse

Object

작업 응답의 유효성을 검사하기 위한 기본 클래스입니다.

Name	형식	Description
validationResults	ErrorDetail[]	유효성 검사 결과를 가져옵니다.