{"type":"api","title":"Set maintenance mode state of Crosswork","meta":{"id":"/apps/pubhub/media/crosswork-network-controller-7-1/f445c17e25a1120e8fbde4bd413083d0fd88b2b3/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.","version":"3.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-v1-overview.md"}},"swagger":"2.0","basePath":"/crosswork/platform/v1","securityDefinitions":{"api_key":{"description":"security definitions details","type":"apiKey","name":"Authorization","in":"header"}}},"spec":{"summary":"Set maintenance mode state of Crosswork","description":"Enables or disables maintenance mode for Crosswork, which temporarily suspends normal operations to allow for safe backup, restore, or maintenance activities. When enabled, this mode ensures data consistency during critical operations.","operationId":"BackupServices_RequestMaintenanceMode","responses":{"200":{"description":"A successful response.","schema":{"type":"object","description":"Response from a maintenance mode operation request containing status and result information","properties":{"message":{"type":"string","description":"Descriptive message about the maintenance mode operation"},"requestStatus":{"description":"Status of the maintenance mode request","type":"string","enum":["Maintenance_Mode_Request_Status_Success","Maintenance_Mode_Request_Status_Failed"],"default":"Maintenance_Mode_Request_Status_Success","$$ref":"#/definitions/backupMaintenanceModeRequestStatusType"},"modeStatus":{"description":"Current maintenance mode status","type":"string","enum":["Maintenance_Mode_Off","Maintenance_Mode_On","Maintenance_Mode_On_In_Progress","Maintenance_Mode_Off_In_Progress"],"default":"Maintenance_Mode_Off","$$ref":"#/definitions/backupMaintenanceModeStatusType"}},"example":{"message":"Processing ON request.","requestStatus":"Maintenance_Mode_Request_Status_Success","modeStatus":"Maintenance_Mode_Off"},"$$ref":"#/definitions/backupResponseMaintenanceModeOp"},"examples":{"example":{"message":"Processing ON request.","requestStatus":"Maintenance_Mode_Request_Status_Success","modeStatus":"Maintenance_Mode_Off"}}},"default":{"description":"An unexpected error response.","schema":{"type":"object","description":"Standard error response containing detailed error information","properties":{"error":{"type":"string","description":"Error message"},"code":{"type":"integer","format":"int32","description":"Error code"},"message":{"type":"string","description":"Detailed error message"},"details":{"type":"array","description":"Additional error details","items":{"type":"object","description":"Protocol Buffers Any message type for containing arbitrary serialized messages","properties":{"type_url":{"type":"string","description":"Type URL that identifies the message type"},"value":{"type":"string","format":"byte","description":"Serialized message value"}},"example":{"type_url":"type.googleapis.com/error.details","value":"CgVoZWxsbw=="},"$$ref":"#/definitions/protobufAny"}}},"example":{"error":"","code":13,"message":"failed to marshal error message","details":[]},"$$ref":"#/definitions/runtimeError"}}},"parameters":[{"description":"Set maintenance mode state of Crosswork","name":"body","in":"body","required":true,"schema":{"type":"object","description":"Request to set the maintenance mode state of Crosswork","properties":{"isSetMaintenance":{"type":"boolean","description":"If true, enable maintenance mode; if false, disable maintenance mode"}},"example":{"isSetMaintenance":true},"$$ref":"#/definitions/backupRequestMaintenanceModeOp"}}],"tags":["BackupServices"],"__originalOperationId":"BackupServices_RequestMaintenanceMode","consumes":["application/json"],"produces":["application/json"],"method":"post","path":"/platform/maintenance/set"}}