Backup Instances - Validate For Backup

서비스:: Data Protection

API 버전:: 2025-09-01

임시 백업의 성공 여부 확인

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/validateForBackup?api-version=2025-09-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
vaultName	path	True	string	BackupVaultResource의 이름
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 본문

Name	필수	형식	Description
backupInstance	True	BackupInstance	Backup 인스턴스

응답

Name	형식	Description
200 OK	OperationJobExtendedInfo	Azure 작업이 성공적으로 완료되었습니다.
202 Accepted		자원 작업이 허용되었습니다. 헤더 Azure-AsyncOperation: string Location: string
Other Status Codes	CloudError	예기치 않은 오류 응답입니다.

Name

형식

Description

200 OK

OperationJobExtendedInfo

Azure 작업이 성공적으로 완료되었습니다.

202 Accepted

자원 작업이 허용되었습니다.

헤더

Azure-AsyncOperation: string
Location: string

Other Status Codes

CloudError

예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

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

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Validate For Backup

샘플 요청

HTTP

POST https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/validateForBackup?api-version=2025-09-01

{
  "backupInstance": {
    "dataSourceInfo": {
      "datasourceType": "OssDB",
      "objectType": "Datasource",
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
      "resourceLocation": "",
      "resourceName": "testdb",
      "resourceType": "Microsoft.DBforPostgreSQL/servers/databases",
      "resourceUri": ""
    },
    "dataSourceSetInfo": {
      "datasourceType": "OssDB",
      "objectType": "DatasourceSet",
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
      "resourceLocation": "",
      "resourceName": "viveksipgtest",
      "resourceType": "Microsoft.DBforPostgreSQL/servers",
      "resourceUri": ""
    },
    "datasourceAuthCredentials": {
      "objectType": "SecretStoreBasedAuthCredentials",
      "secretStoreResource": {
        "secretStoreType": "AzureKeyVault",
        "uri": "https://samplevault.vault.azure.net/secrets/credentials"
      }
    },
    "friendlyName": "harshitbi2",
    "identityDetails": {
      "useSystemAssignedIdentity": false,
      "userAssignedIdentityArmUrl": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourcegroups/rg-name/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testUami"
    },
    "objectType": "BackupInstance",
    "policyInfo": {
      "policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/Backupvaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1"
    }
  }
}

샘플 응답

상태 코드:: 200

{
  "jobId": "c60cb49-63e8-4b21-b9bd-26277b3fdfae",
  "objectType": "OperationJobExtendedInfo"
}

상태 코드:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2025-09-01
Location: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/operationResults/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2025-09-01
Retry-After: 60

정의

Name	Description
AdlsBlobBackupDatasourceParameters	Azure Data Lake Storage 계정 Blob의 백업을 구성하는 동안 사용할 매개 변수
AKSVolumeTypes
AzureOperationalStoreParameters	Operational-Tier DataStore에 대한 매개 변수
BackupInstance	Backup 인스턴스
BlobBackupDatasourceParameters	Blob 백업을 구성하는 동안 사용할 매개 변수
CloudError	Azure Backup의 오류 응답입니다.
CurrentProtectionState	리소스의 현재 보호 상태를 지정합니다.
Datasource	백업할 데이터 원본
DatasourceSet	백업할 데이터 원본의 DatasourceSet 세부 정보
DataStoreTypes	데이터 저장소의 형식; 운영/자격 증명 모음/보관
DefaultResourceProperties	기본 원본 속성
Error	리소스 관리 오류 응답입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
IdentityDetails
InnerError	내부 오류
KubernetesClusterBackupDatasourceParameters	Kubernetes 클러스터 백업 데이터 원본에 대한 매개 변수
NamespacedNameResource	네임스페이스와 이름이 포함된 리소스를 참조하는 클래스
OperationJobExtendedInfo	작업 확장 정보 작업
PolicyInfo	backupInstance의 정책 정보
PolicyParameters	정책의 매개 변수
ProtectionStatusDetails	보호 상태 세부 정보
ResourcePropertiesObjectType	역직렬화에 사용되는 특정 개체의 형식
SecretStoreBasedAuthCredentials	비밀 저장소 기반 인증 자격 증명.
SecretStoreResource	비밀 저장소 리소스를 나타내는 클래스입니다.
SecretStoreType	비밀 저장소의 유형을 가져오거나 설정합니다.
Status	리소스의 보호 상태를 지정합니다.
UserFacingError	지역화된 콘텐츠에 대한 액세스 권한이 있는 계층에서 사용되는 오류 개체이며 사용자에게 전파됩니다.
ValidateForBackupRequest	백업 요청 유효성 검사
ValidationType	유효성 검사 유형을 지정합니다. DeepValidation의 경우 /validateForBackup API의 모든 유효성 검사가 다시 실행됩니다.

AdlsBlobBackupDatasourceParameters

Object

Azure Data Lake Storage 계정 Blob의 백업을 구성하는 동안 사용할 매개 변수

Name	형식	Description
containersList	string[]	Blob 백업을 구성하는 동안 백업할 컨테이너 목록
objectType	string: AdlsBlobBackupDatasourceParameters	역직렬화에 사용되는 특정 개체의 형식

AKSVolumeTypes

열거형

값	Description
AzureDisk
AzureFileShareSMB

AzureOperationalStoreParameters

Object

Operational-Tier DataStore에 대한 매개 변수

Name	형식	Description
dataStoreType	DataStoreTypes	데이터 저장소의 형식; 운영/자격 증명 모음/보관
objectType	string: AzureOperationalStoreParameters	역직렬화에 사용되는 특정 개체의 형식
resourceGroupId	string	스냅샷 리소스 그룹 Uri를 가져오거나 설정합니다.

BackupInstance

Object

Backup 인스턴스

Name	형식	Description
currentProtectionState	CurrentProtectionState	리소스의 현재 보호 상태를 지정합니다.
dataSourceInfo	Datasource	데이터 원본 정보를 가져오거나 설정합니다.
dataSourceSetInfo	DatasourceSet	데이터 원본 집합 정보를 가져오거나 설정합니다.
datasourceAuthCredentials	AuthCredentials: SecretStoreBasedAuthCredentials	데이터 원본 공급자를 인증하는 데 사용할 자격 증명입니다.
friendlyName	string	Backup 인스턴스 이름을 가져오거나 설정합니다.
identityDetails	IdentityDetails	BI에 대한 ID 세부 정보의 정보를 포함합니다. null인 경우 기본값은 시스템 할당으로 간주됩니다.
objectType	string
policyInfo	PolicyInfo	정책 정보를 가져오거나 설정합니다.
protectionErrorDetails	UserFacingError	리소스의 보호 오류를 지정합니다.
protectionStatus	ProtectionStatusDetails	리소스의 보호 상태를 지정합니다.
provisioningState	string	리소스의 프로비전 상태(예: 프로비전/업데이트/성공/실패)를 지정합니다.
resourceGuardOperationRequests	string[]	LAC 검사를 수행할 ResourceGuardOperationRequests
validationType	ValidationType	유효성 검사 유형을 지정합니다. DeepValidation의 경우 /validateForBackup API의 모든 유효성 검사가 다시 실행됩니다.

BlobBackupDatasourceParameters

Object

Blob 백업을 구성하는 동안 사용할 매개 변수

Name	형식	Description
containersList	string[]	Blob 백업을 구성하는 동안 백업할 컨테이너 목록
objectType	string: BlobBackupDatasourceParameters	역직렬화에 사용되는 특정 개체의 형식

CloudError

Object

Azure Backup의 오류 응답입니다.

Name	형식	Description
error	Error	리소스 관리 오류 응답입니다.

CurrentProtectionState

열거형

리소스의 현재 보호 상태를 지정합니다.

값	Description
Invalid
NotProtected
ConfiguringProtection
ProtectionConfigured
BackupSchedulesSuspended
RetentionSchedulesSuspended
ProtectionStopped
ProtectionError
ConfiguringProtectionFailed
SoftDeleting
SoftDeleted
UpdatingProtection

Datasource

Object

백업할 데이터 원본

Name	형식	Description
datasourceType	string	리소스의 DatasourceType입니다.
objectType	string	오른쪽 상속된 형식을 초기화하는 데 사용되는 Datasource 개체의 형식
resourceID	string	리소스의 전체 ARM ID입니다. Azure 리소스의 경우 ARM ID입니다. 비 Azure 리소스의 경우 Fabric/Vault를 통해 백업 서비스에서 만든 ID입니다.
resourceLocation	string	데이터 원본의 위치입니다.
resourceName	string	부모 컨텍스트에서 리소스의 고유 식별자입니다.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	데이터 원본과 관련된 속성
resourceType	string	데이터 원본의 리소스 종류입니다.
resourceUri	string	리소스의 URI입니다.

DatasourceSet

Object

백업할 데이터 원본의 DatasourceSet 세부 정보

Name	형식	Description
datasourceType	string	리소스의 DatasourceType입니다.
objectType	string	오른쪽 상속된 형식을 초기화하는 데 사용되는 Datasource 개체의 형식
resourceID	string	리소스의 전체 ARM ID입니다. Azure 리소스의 경우 ARM ID입니다. 비 Azure 리소스의 경우 Fabric/Vault를 통해 백업 서비스에서 만든 ID입니다.
resourceLocation	string	데이터 원본의 위치입니다.
resourceName	string	부모 컨텍스트에서 리소스의 고유 식별자입니다.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	데이터 원본 집합과 관련된 속성
resourceType	string	데이터 원본의 리소스 종류입니다.
resourceUri	string	리소스의 URI입니다.

DataStoreTypes

열거형

데이터 저장소의 형식; 운영/자격 증명 모음/보관

값	Description
OperationalStore
VaultStore
ArchiveStore

DefaultResourceProperties

Object

기본 원본 속성

Name	형식	Description
objectType	string: DefaultResourceProperties	역직렬화에 사용되는 특정 개체의 형식

Error

Object

리소스 관리 오류 응답입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	Error[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

IdentityDetails

Object

Name	형식	Description
useSystemAssignedIdentity	boolean	BI가 시스템 ID로 보호되는지를 지정합니다.
userAssignedIdentityArmUrl	string	사용자 할당 ID에 대한 ARM URL입니다.

InnerError

Object

내부 오류

Name	형식	Description
additionalInfo	object	추가 자세한 정보를 위해 클라이언트에 제공할 수 있는 모든 키 값 쌍입니다.
code	string	이 오류에 대한 고유 코드
embeddedInnerError	InnerError	중첩을 허용하는 자식 내부 오류입니다.

KubernetesClusterBackupDatasourceParameters

Object

Kubernetes 클러스터 백업 데이터 원본에 대한 매개 변수

Name	형식	Description
backupHookReferences	NamespacedNameResource[]	백업 후크 참조를 가져오거나 설정합니다. 이 속성은 백업 중에 실행할 후크 참조를 설정합니다.
excludedNamespaces	string[]	제외 네임스페이스 속성을 가져오거나 설정합니다. 이 속성은 백업 중에 제외할 네임스페이스를 설정합니다.
excludedResourceTypes	string[]	제외 리소스 종류 속성을 가져오거나 설정합니다. 이 속성은 백업 중에 제외할 리소스 유형을 설정합니다.
includeClusterScopeResources	boolean	include 클러스터 리소스 속성을 가져오거나 설정합니다. 사용하도록 설정된 경우 이 속성에는 백업 중에 클러스터 범위 리소스가 포함됩니다.
includedNamespaces	string[]	include 네임스페이스 속성을 가져오거나 설정합니다. 이 속성은 백업 중에 포함할 네임스페이스를 설정합니다.
includedResourceTypes	string[]	include 리소스 종류 속성을 가져오거나 설정합니다. 이 속성은 백업 중에 포함할 리소스 유형을 설정합니다.
includedVolumeTypes	AKSVolumeTypes[]	include 볼륨 형식 속성을 가져오거나 설정합니다. 이 속성은 백업 중에 포함할 볼륨 유형을 설정합니다.
labelSelectors	string[]	LabelSelectors 속성을 가져오거나 설정합니다. 이 속성은 백업 중에 이러한 레이블 선택기가 포함된 리소스를 포함하도록 설정합니다.
objectType	string: KubernetesClusterBackupDatasourceParameters	역직렬화에 사용되는 특정 개체의 형식
snapshotVolumes	boolean	볼륨 스냅샷 속성을 가져오거나 설정합니다. 사용하도록 설정된 경우 이 속성은 백업 중에 볼륨 스냅샷을 만듭니다.

NamespacedNameResource

Object

네임스페이스와 이름이 포함된 리소스를 참조하는 클래스

Name	형식	Description
name	string	리소스 이름
namespace	string	리소스가 있는 네임스페이스

OperationJobExtendedInfo

Object

작업 확장 정보 작업

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

PolicyInfo

Object

backupInstance의 정책 정보

Name	형식	Description
policyId	string
policyParameters	PolicyParameters	백업 인스턴스에 대한 정책 매개 변수
policyVersion	string

PolicyParameters

Object

정책의 매개 변수

Name	형식	Description
backupDatasourceParametersList	BackupDatasourceParameters[]: AdlsBlobBackupDatasourceParameters[] BlobBackupDatasourceParameters[] KubernetesClusterBackupDatasourceParameters[]	Backup 데이터 원본 매개 변수를 가져오거나 설정합니다.
dataStoreParametersList	DataStoreParameters[]: AzureOperationalStoreParameters[]	DataStore 매개 변수를 가져오거나 설정합니다.

ProtectionStatusDetails

Object

보호 상태 세부 정보

Name	형식	Description
errorDetails	UserFacingError	리소스의 보호 상태 오류를 지정합니다.
status	Status	리소스의 보호 상태를 지정합니다.

ResourcePropertiesObjectType

열거형

역직렬화에 사용되는 특정 개체의 형식

값	Description
DefaultResourceProperties

SecretStoreBasedAuthCredentials

Object

비밀 저장소 기반 인증 자격 증명.

Name	형식	Description
objectType	string: SecretStoreBasedAuthCredentials	역직렬화에 사용되는 특정 개체의 형식
secretStoreResource	SecretStoreResource	비밀 저장소 리소스

SecretStoreResource

Object

비밀 저장소 리소스를 나타내는 클래스입니다.

Name	형식	Description
secretStoreType	SecretStoreType	비밀 저장소의 유형을 가져오거나 설정합니다.
uri	string	리소스에 대한 URI
value	string	비밀 저장소 리소스에 저장된 값을 가져오거나 설정합니다.

SecretStoreType

열거형

비밀 저장소의 유형을 가져오거나 설정합니다.

값	Description
Invalid
AzureKeyVault

Status

열거형

리소스의 보호 상태를 지정합니다.

값	Description
ConfiguringProtection
ConfiguringProtectionFailed
ProtectionConfigured
ProtectionStopped
SoftDeleted
SoftDeleting

UserFacingError

Object

지역화된 콘텐츠에 대한 액세스 권한이 있는 계층에서 사용되는 오류 개체이며 사용자에게 전파됩니다.

Name	형식	Description
code	string	이 오류에 대한 고유 코드
details	UserFacingError[]	추가 관련 오류
innerError	InnerError	내부 오류
isRetryable	boolean	작업을 다시 시도할 수 있는지 여부
isUserError	boolean	작업이 사용자 오류 또는 서비스 오류로 인한 것인지 여부
message	string
properties	object	오류 개체 내부에 삽입할 수 있는 키 값 쌍
recommendedAction	string[]	RecommendedAction을 지역화했습니다.
target	string	오류의 대상입니다.

ValidateForBackupRequest

Object

백업 요청 유효성 검사

Name	형식	Description
backupInstance	BackupInstance	Backup 인스턴스

ValidationType

열거형

유효성 검사 유형을 지정합니다. DeepValidation의 경우 /validateForBackup API의 모든 유효성 검사가 다시 실행됩니다.

값	Description
ShallowValidation
DeepValidation

다음을 통해 공유

Backup Instances - Validate For Backup

URI 매개 변수

요청 본문

응답

보안

azure_auth

범위

예제

Validate For Backup

샘플 요청

샘플 응답

정의

AdlsBlobBackupDatasourceParameters

AKSVolumeTypes

AzureOperationalStoreParameters

BackupInstance

BlobBackupDatasourceParameters

CloudError

CurrentProtectionState

Datasource

DatasourceSet

DataStoreTypes

DefaultResourceProperties

Error

ErrorAdditionalInfo

IdentityDetails

InnerError

KubernetesClusterBackupDatasourceParameters

NamespacedNameResource

OperationJobExtendedInfo

PolicyInfo

PolicyParameters

ProtectionStatusDetails

ResourcePropertiesObjectType

SecretStoreBasedAuthCredentials

SecretStoreResource

SecretStoreType

Status

UserFacingError

ValidateForBackupRequest

ValidationType