{"type":"api","title":"Get details of a restore job","meta":{"id":"/apps/pubhub/media/crosswork-network-controller-7-1/e1ae91f25de62367ac175351487a12de3ae46a25/e48c8a9a-1f0a-35b4-9617-f132aa89f152","info":{"title":"Crosswork Backup Restore Manager API","description":"Backup Restore Manager provides API methods for backup and restore operations on Crosswork. This includes backup, data only backup, restore, data only restore and migration.","contact":{"name":"Crosswork Team, Cisco","email":"support@cisco.com"},"license":{"name":"Cisco Software License Agreement","url":"https://www.cisco.com/public/sw-license-agreement.html"},"version":"3.0.0"},"x-parser-conf":{"overview":{"markdownPath":"reference/INFRA/BACKUP_RESTORE/backup-restore-v1-overview.md"}},"openapi":"3.0.1","servers":[{"url":"https://{cw_ip}:30603/crosswork/platform/v1"}],"securitySchemes":{"api_key":{"type":"apiKey","description":"security definitions details","name":"Authorization","in":"header"}}},"spec":{"tags":["BackupServices"],"summary":"Get details of a restore job","description":"Retrieves comprehensive details about a specific restore job, including execution status, timing information, progress, error messages (if any), and related backup information. This endpoint is essential for monitoring restore operations and troubleshooting issues.","operationId":"BackupServices_RequestJobDetailsRestore","parameters":[{"name":"jobId","in":"path","description":"Get details of a restore job","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"type":"object","properties":{"jobId":{"type":"string","description":"Unique identifier for the job"},"jobName":{"type":"string","description":"Name of the job"},"jobType":{"type":"string","description":"Type of job (e.g., BACKUP, RESTORE, DATA BACKUP)"},"timeInitiated":{"type":"string","description":"Timestamp when the job was initiated"},"lastCompletedAction":{"type":"string","description":"Last action that was completed in the job"},"currentActionInProgress":{"type":"string","description":"Current action being performed (if job is running)"},"timeCompleted":{"type":"string","description":"Timestamp when the job was completed"},"status":{"type":"string","description":"Current status of the job"},"backupJobId":{"type":"string","description":"Related backup job ID (for restore operations)"},"backupJobName":{"type":"string","description":"Related backup job name (for restore operations)"},"error":{"type":"string","description":"Error message if the job failed"},"backup_job_start_time":{"title":"if this job is a geo redundancy restore, the corresponding backup operation started at this time. Empty otherwise","type":"string"},"backup_job_end_time":{"title":"if this job is a geo redundancy restore, the corresponding backup operation ended at this time. Empty otherwise","type":"string"},"backup_tar_name":{"type":"string","description":"if this job is a geo redundancy restore, this field corresponds to the backup tar file.\r\nif this job is a geo redundancy backup, this field corresponds to the tar file with the backed up content."},"progress":{"type":"integer","description":"job progress 0-100. Will not be set to 100 for a failed job.","format":"int32"}},"description":"Individual job information with execution details and status","example":{"jobId":"1a6a2734-6c6f-49b6-a7b2-bfe7adb3606c","jobName":"some-job","jobType":"DATA BACKUP","timeInitiated":"2025-05-16T10:32:41.000Z","lastCompletedAction":"","currentActionInProgress":"","timeCompleted":"2025-05-16T10:34:23.000Z","status":"Failed","backupJobId":"","backupJobName":"","error":"job failed in executing task backupNSOTask. Error: no NSO providers found","backup_job_start_time":"","backup_job_end_time":"","backup_tar_name":"","progress":100},"$$ref":"#/components/schemas/backupGetJobResult"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"},"code":{"type":"integer","description":"Error code","format":"int32"},"message":{"type":"string","description":"Detailed error message"},"details":{"type":"array","description":"Additional error details","items":{"type":"object","properties":{"type_url":{"type":"string","description":"Type URL that identifies the message type"},"value":{"pattern":"^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$","type":"string","description":"Serialized message value","format":"byte"}},"description":"Protocol Buffers Any message type for containing arbitrary serialized messages","example":{"type_url":"type.googleapis.com/error.details","value":"CgVoZWxsbw=="},"$$ref":"#/components/schemas/protobufAny"}}},"description":"Standard error response containing detailed error information","example":{"error":"","code":13,"message":"failed to marshal error message","details":[]},"$$ref":"#/components/schemas/runtimeError"}}}}},"__originalOperationId":"BackupServices_RequestJobDetailsRestore","method":"get","path":"/platform/restore/get/{jobId}"}}