{"type":"api","title":"Verify Crosswork readiness for geo redundancy restore","meta":{"id":"/apps/pubhub/media/crosswork-network-controller-7-1/f445c17e25a1120e8fbde4bd413083d0fd88b2b3/6c49d803-9bf6-348b-b43b-bf553e163c6f","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.","version":"2.0.0","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"}},"x-parser-conf":{"overview":{"markdownPath":"reference/INFRA/BACKUP_RESTORE/backup-restore-v2-overview.md"}},"swagger":"2.0","basePath":"/crosswork/platform/v2","schemes":["http","https"],"securityDefinitions":{"bearerAuth":{"type":"apiKey","name":"Authorization","in":"header","description":"Security definitions details."}}},"spec":{"summary":"Verify Crosswork readiness for geo redundancy restore","description":"Performs pre-restore validation checks to ensure that Crosswork is ready for a geo redundancy restore operation. This includes verifying that the specified backup file exists at the remote location, checking system health, validating restore compatibility, and ensuring all required components are available.","operationId":"BackupServices_RequestVMGeoRedundancyRestoreVerify","responses":{"200":{"description":"A successful response.","schema":{"type":"object","description":"Result of a backup verification operation, containing any warnings encountered during the verification process","properties":{"warnings":{"type":"array","description":"List of warning messages encountered during the backup verification process","items":{"type":"string"}}},"example":{"warnings":["Insufficient disk space for backup operation","Network connectivity may be unstable"]},"$$ref":"#/definitions/backupBackupVerifyOpResult"},"examples":{"example":{"warnings":[]}}},"default":{"description":"An unexpected error response.","schema":{"type":"object","description":"Standard error response containing error details, status code, message, and additional context","properties":{"error":{"type":"string","description":"Error message"},"code":{"type":"integer","format":"int32","description":"gRPC status code indicating the type of error"},"message":{"type":"string","description":"Detailed error message with context"},"details":{"type":"array","description":"Additional error details in protocol buffer format","items":{"type":"object","description":"A generic message type that can hold any serialized protocol buffer message along with a URL that describes the type of the serialized message","properties":{"type_url":{"type":"string","description":"URL that describes the type of the serialized message"},"value":{"type":"string","format":"byte","description":"Serialized protocol buffer message content"}},"example":{"type_url":"type.googleapis.com/error.details","value":"CgVoZWxsbw=="},"$$ref":"#/definitions/protobufAny"}}},"example":{"error":"Internal server error","code":13,"message":"Failed to process backup request due to insufficient resources","details":[]},"$$ref":"#/definitions/runtimeError"},"examples":{"example":{"error":"","code":13,"message":"failed to marshal error message","details":[]}}}},"parameters":[{"name":"body","in":"body","description":"Verify if Crosswork is ready for a geo redundancy restore","required":true,"schema":{"type":"object","description":"Parameters required to verify if Crosswork is ready to perform a geo redundancy restore operation","properties":{"file_name":{"type":"string","description":"Name of the backup file to verify exists on the remote location before attempting restore"},"force":{"type":"boolean","description":"If true, skip file existence check and verify all other readiness checks. Note: file_name cannot be empty, use a placeholder string if force is true"}},"example":{"file_name":"geo_backup_prod_2024.tar.gz","force":false},"$$ref":"#/definitions/backupGeoRedundancyRestoreVerifyOpReq"}}],"tags":["BackupServices"],"__originalOperationId":"BackupServices_RequestVMGeoRedundancyRestoreVerify","consumes":["application/json"],"produces":["application/json"],"method":"post","path":"/platform/restore/verify/georedundancy"}}