你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Backup Crr Jobs - List

Service:

Recovery Services - Backup

API Version:

2023-01-15

Gets the list of CRR jobs from the target region.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.RecoveryServices/locations/{azureRegion}/backupCrrJobs?api-version=2023-01-15

With optional parameters:

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.RecoveryServices/locations/{azureRegion}/backupCrrJobs?api-version=2023-01-15&$filter={$filter}&$skipToken={$skipToken}

URI Parameters

Name	In	Required	Type	Description
azureRegion	path	True	string	Azure region to hit Api
subscriptionId	path	True	string	The subscription Id.
api-version	query	True	string	Client Api Version.
$filter	query		string	OData filter options.
$skipToken	query		string	skipToken Filter.

Request Body

Name	Type	Description
jobName	string	Job Name of the job to be fetched
resourceId	string	Entire ARM resource id of the resource

Responses

Name	Type	Description
200 OK	JobResourceList	OK
Other Status Codes	NewErrorResponse	Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name	Description
user_impersonation	impersonate your user account.

Examples

List Cross Region Restore Jobs in the secondary region

Sample Request

HTTP

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.RecoveryServices/locations/southeastasia/backupCrrJobs?api-version=2023-01-15

{
  "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRg/providers/Microsoft.Compute/VirtualMachines/testVm",
  "jobName": "02585cc9-d7f4-4b46-860c-14c048cce178"
}

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "/subscriptions/f2edfd5d-5496-4683-b94f-b3588c579009/providers/microsoft.recoveryservices/locations/eastus2euap/backupJobs/02585cc9-d7f4-4b46-860c-14c048cce178",
      "name": "02585cc9-d7f4-4b46-860c-14c048cce178",
      "type": "Microsoft.RecoveryServices/vaults/backupJobs",
      "properties": {
        "jobType": "AzureIaaSVMJob",
        "virtualMachineVersion": "Compute",
        "entityFriendlyName": "sriniccylinux",
        "backupManagementType": "AzureIaasVM",
        "operation": "CrossRegionRestore",
        "status": "InProgress",
        "startTime": "2019-10-12T10:22:43.9139656Z",
        "activityId": "6e503ee3-1093-4a83-a62a-3b666cc8c028-2019-10-12T10:22:43Z-Ibz"
      }
    }
  ]
}

Definitions

Name	Description
AzureIaaSVMErrorInfo	Azure IaaS VM workload-specific error information.
AzureIaaSVMJob	Azure IaaS VM workload-specific job object.
AzureIaaSVMJobExtendedInfo	Azure IaaS VM workload-specific additional information for job.
AzureIaaSVMJobTaskDetails	Azure IaaS VM workload-specific job task details.
AzureStorageErrorInfo	Azure storage specific error information
AzureStorageJob	Azure storage specific job.
AzureStorageJobExtendedInfo	Azure Storage workload-specific additional information for job.
AzureStorageJobTaskDetails	Azure storage workload specific job task details.
AzureWorkloadErrorInfo	Azure storage specific error information
AzureWorkloadJob	Azure storage specific job.
AzureWorkloadJobExtendedInfo	Azure VM workload-specific additional information for job.
AzureWorkloadJobTaskDetails	Azure VM workload specific job task details.
BackupManagementType	Type of backup management for the backed up item.
CrrJobRequest	Request object for fetching CRR jobs.
DpmErrorInfo	DPM workload-specific error information.
DpmJob	DPM workload-specific job object.
DpmJobExtendedInfo	Additional information on the DPM workload-specific job.
DpmJobTaskDetails	DPM workload-specific job task details.
Error	The error object.
ErrorAdditionalInfo	The resource management error additional info.
JobResource	Defines workload agnostic properties for a job.
JobResourceList	List of Job resources
JobSupportedAction	Gets or sets the state/actions applicable on this job like cancel/retry.
MabErrorInfo	MAB workload-specific error information.
MabJob	MAB workload-specific job.
MabJobExtendedInfo	Additional information for the MAB workload-specific job.
MabJobTaskDetails	MAB workload-specific job task details.
MabServerType	Server type of MAB container.
NewErrorResponse	The resource management error response.
WorkloadType	Workload type of backup item.

AzureIaaSVMErrorInfo

Azure IaaS VM workload-specific error information.

Name	Type	Description
errorCode	integer	Error code.
errorString	string	Localized error string.
errorTitle	string	Title: Typically, the entity that the error pertains to.
recommendations	string[]	List of localized recommendations for above error code.

AzureIaaSVMJob

Azure IaaS VM workload-specific job object.

Name	Type	Description
actionsInfo	JobSupportedAction[]	Gets or sets the state/actions applicable on this job like cancel/retry.
activityId	string	ActivityId of job.
backupManagementType	BackupManagementType	Backup management type to execute the current job.
duration	string	Time elapsed during the execution of this job.
endTime	string	The end time.
entityFriendlyName	string	Friendly name of the entity on which the current job is executing.
errorDetails	AzureIaaSVMErrorInfo[]	Error details on execution of this job.
extendedInfo	AzureIaaSVMJobExtendedInfo	Additional information for this job.
jobType	string: AzureIaaSVMJob	This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types.
operation	string	The operation name.
startTime	string	The start time.
status	string	Job status.
virtualMachineVersion	string	Specifies whether the backup item is a Classic or an Azure Resource Manager VM.

AzureIaaSVMJobExtendedInfo

Azure IaaS VM workload-specific additional information for job.

Name	Type	Description
dynamicErrorMessage	string	Non localized error message on job execution.
estimatedRemainingDuration	string	Time remaining for execution of this job.
internalPropertyBag	object	Job internal properties.
progressPercentage	number	Indicates progress of the job. Null if it has not started or completed.
propertyBag	object	Job properties.
tasksList	AzureIaaSVMJobTaskDetails[]	List of tasks associated with this job.

AzureIaaSVMJobTaskDetails

Azure IaaS VM workload-specific job task details.

Name	Type	Description
duration	string	Time elapsed for task.
endTime	string	The end time.
instanceId	string	The instanceId.
progressPercentage	number	Progress of the task.
startTime	string	The start time.
status	string	The status.
taskExecutionDetails	string	Details about execution of the task. eg: number of bytes transferred etc
taskId	string	The task display name.

AzureStorageErrorInfo

Azure storage specific error information

Name	Type	Description
errorCode	integer	Error code.
errorString	string	Localized error string.
recommendations	string[]	List of localized recommendations for above error code.

AzureStorageJob

Azure storage specific job.

Name	Type	Description
actionsInfo	JobSupportedAction[]	Gets or sets the state/actions applicable on this job like cancel/retry.
activityId	string	ActivityId of job.
backupManagementType	BackupManagementType	Backup management type to execute the current job.
duration	string	Time elapsed during the execution of this job.
endTime	string	The end time.
entityFriendlyName	string	Friendly name of the entity on which the current job is executing.
errorDetails	AzureStorageErrorInfo[]	Error details on execution of this job.
extendedInfo	AzureStorageJobExtendedInfo	Additional information about the job.
jobType	string: AzureStorageJob	This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types.
operation	string	The operation name.
startTime	string	The start time.
status	string	Job status.
storageAccountName	string	Specifies friendly name of the storage account.
storageAccountVersion	string	Specifies whether the Storage account is a Classic or an Azure Resource Manager Storage account.

AzureStorageJobExtendedInfo

Azure Storage workload-specific additional information for job.

Name	Type	Description
dynamicErrorMessage	string	Non localized error message on job execution.
propertyBag	object	Job properties.
tasksList	AzureStorageJobTaskDetails[]	List of tasks for this job

AzureStorageJobTaskDetails

Azure storage workload specific job task details.

Name	Type	Description
status	string	The status.
taskId	string	The task display name.

AzureWorkloadErrorInfo

Azure storage specific error information

Name	Type	Description
additionalDetails	string	Additional details for above error code.
errorCode	integer	Error code.
errorString	string	Localized error string.
errorTitle	string	Title: Typically, the entity that the error pertains to.
recommendations	string[]	List of localized recommendations for above error code.

AzureWorkloadJob

Azure storage specific job.

Name	Type	Description
actionsInfo	JobSupportedAction[]	Gets or sets the state/actions applicable on this job like cancel/retry.
activityId	string	ActivityId of job.
backupManagementType	BackupManagementType	Backup management type to execute the current job.
duration	string	Time elapsed during the execution of this job.
endTime	string	The end time.
entityFriendlyName	string	Friendly name of the entity on which the current job is executing.
errorDetails	AzureWorkloadErrorInfo[]	Error details on execution of this job.
extendedInfo	AzureWorkloadJobExtendedInfo	Additional information about the job.
jobType	string: AzureWorkloadJob	This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types.
operation	string	The operation name.
startTime	string	The start time.
status	string	Job status.
workloadType	string	Workload type of the job

AzureWorkloadJobExtendedInfo

Azure VM workload-specific additional information for job.

Name	Type	Description
dynamicErrorMessage	string	Non localized error message on job execution.
propertyBag	object	Job properties.
tasksList	AzureWorkloadJobTaskDetails[]	List of tasks for this job

AzureWorkloadJobTaskDetails

Azure VM workload specific job task details.

Name	Type	Description
status	string	The status.
taskId	string	The task display name.

BackupManagementType

Type of backup management for the backed up item.

Name	Type	Description
AzureBackupServer	string
AzureIaasVM	string
AzureSql	string
AzureStorage	string
AzureWorkload	string
DPM	string
DefaultBackup	string
Invalid	string
MAB	string

CrrJobRequest

Request object for fetching CRR jobs.

Name	Type	Description
jobName	string	Job Name of the job to be fetched
resourceId	string	Entire ARM resource id of the resource

DpmErrorInfo

DPM workload-specific error information.

Name	Type	Description
errorString	string	Localized error string.
recommendations	string[]	List of localized recommendations for above error code.

DpmJob

DPM workload-specific job object.

Name	Type	Description
actionsInfo	JobSupportedAction[]	The state/actions applicable on this job like cancel/retry.
activityId	string	ActivityId of job.
backupManagementType	BackupManagementType	Backup management type to execute the current job.
containerName	string	Name of cluster/server protecting current backup item, if any.
containerType	string	Type of container.
dpmServerName	string	DPM server name managing the backup item or backup job.
duration	string	Time elapsed for job.
endTime	string	The end time.
entityFriendlyName	string	Friendly name of the entity on which the current job is executing.
errorDetails	DpmErrorInfo[]	The errors.
extendedInfo	DpmJobExtendedInfo	Additional information for this job.
jobType	string: DpmJob	This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types.
operation	string	The operation name.
startTime	string	The start time.
status	string	Job status.
workloadType	string	Type of backup item.

DpmJobExtendedInfo

Additional information on the DPM workload-specific job.

Name	Type	Description
dynamicErrorMessage	string	Non localized error message on job execution.
propertyBag	object	The job properties.
tasksList	DpmJobTaskDetails[]	List of tasks associated with this job.

DpmJobTaskDetails

DPM workload-specific job task details.

Name	Type	Description
duration	string	Time elapsed for task.
endTime	string	The end time.
startTime	string	The start time.
status	string	The status.
taskId	string	The task display name.

Error

The error object.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	The error additional info.
code	string	The error code.
details	NewErrorResponse[]	The error details.
message	string	The error message.
target	string	The error target.

ErrorAdditionalInfo

The resource management error additional info.

Name	Type	Description
info	object	The additional info.
type	string	The additional info type.

JobResource

Defines workload agnostic properties for a job.

Name	Type	Description
eTag	string	Optional ETag.
id	string	Resource Id represents the complete path to the resource.
location	string	Resource location.
name	string	Resource name associated with the resource.
properties	Job: AzureIaaSVMJob AzureStorageJob AzureWorkloadJob DpmJob MabJob	JobResource properties
tags	object	Resource tags.
type	string	Resource type represents the complete path of the form Namespace/ResourceType/ResourceType/...

JobResourceList

List of Job resources

Name	Type	Description
nextLink	string	The uri to fetch the next page of resources. Call ListNext() fetches next page of resources.
value	JobResource[]	List of resources.

JobSupportedAction

Gets or sets the state/actions applicable on this job like cancel/retry.

Name	Type	Description
Cancellable	string
Invalid	string
Retriable	string

MabErrorInfo

MAB workload-specific error information.

Name	Type	Description
errorString	string	Localized error string.
recommendations	string[]	List of localized recommendations.

MabJob

MAB workload-specific job.

Name	Type	Description
actionsInfo	JobSupportedAction[]	The state/actions applicable on jobs like cancel/retry.
activityId	string	ActivityId of job.
backupManagementType	BackupManagementType	Backup management type to execute the current job.
duration	string	Time taken by job to run.
endTime	string	The end time.
entityFriendlyName	string	Friendly name of the entity on which the current job is executing.
errorDetails	MabErrorInfo[]	The errors.
extendedInfo	MabJobExtendedInfo	Additional information on the job.
jobType	string: MabJob	This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types.
mabServerName	string	Name of server protecting the DS.
mabServerType	MabServerType	Server type of MAB container.
operation	string	The operation name.
startTime	string	The start time.
status	string	Job status.
workloadType	WorkloadType	Workload type of backup item.

MabJobExtendedInfo

Additional information for the MAB workload-specific job.

Name	Type	Description
dynamicErrorMessage	string	Non localized error message specific to this job.
propertyBag	object	The job properties.
tasksList	MabJobTaskDetails[]	List of tasks for this job.

MabJobTaskDetails

MAB workload-specific job task details.

Name	Type	Description
duration	string	Time elapsed for task.
endTime	string	The end time.
startTime	string	The start time.
status	string	The status.
taskId	string	The task display name.

MabServerType

Server type of MAB container.

Name	Type	Description
AzureBackupServerContainer	string
AzureSqlContainer	string
Cluster	string
DPMContainer	string
GenericContainer	string
IaasVMContainer	string
IaasVMServiceContainer	string
Invalid	string
MABContainer	string
SQLAGWorkLoadContainer	string
StorageContainer	string
Unknown	string
VCenter	string
VMAppContainer	string
Windows	string

NewErrorResponse

The resource management error response.

Name	Type	Description
error	Error	The error object.

WorkloadType

Workload type of backup item.

Name	Type	Description
AzureFileShare	string
AzureSqlDb	string
Client	string
Exchange	string
FileFolder	string
GenericDataSource	string
Invalid	string
SAPAseDatabase	string
SAPHanaDatabase	string
SQLDB	string
SQLDataBase	string
Sharepoint	string
SystemState	string
VM	string
VMwareVM	string