Migration Endpoints

The migration endpoints manage tenant region and cluster migrations, including creation, approval, execution, rollback, and monitoring. Served by TenantMigrationController at /api/v1/tenants/:tenantId/migrations.

Endpoints

Method	Endpoint	Description
GET	`.../migrations`	List all migrations (paginated)
GET	`.../migrations/active`	Get the active migration
GET	`.../migrations/:migrationId`	Get specific migration
POST	`.../migrations`	Create a new migration
POST	`.../migrations/:migrationId/approve`	Approve pending migration
POST	`.../migrations/:migrationId/start`	Start approved migration
POST	`.../migrations/:migrationId/rollback`	Rollback migration
POST	`.../migrations/:migrationId/cancel`	Cancel pending migration
GET	`.../migrations/estimate`	Estimate migration duration
GET	`.../migrations/regions`	List available regions

POST .../migrations

Creates a new migration request. Only one active migration per tenant is allowed.

{
  "migrationName": "US East to EU West",
  "description": "GDPR compliance migration",
  "migrationType": "REGION",
  "sourceRegion": "us-east-1",
  "targetRegion": "eu-west-1",
  "migrateData": true,
  "migrateConfig": true,
  "migrateSecrets": true,
  "backupBeforeMigration": true,
  "rollbackEnabled": true,
  "autoRollbackOnFailure": true,
  "trafficStrategy": "GRADUAL",
  "trafficShiftStep": 10,
  "maxDowntimeMinutes": 30
}

Status	Description
201	Migration created
400	Invalid request
409	Tenant already has an active migration

Migration Lifecycle

PENDING --> APPROVED --> IN_PROGRESS --> COMPLETED
    |           |            |              |
    v           v            v              v
 CANCELLED   CANCELLED    FAILED      ROLLED_BACK
                            |
                            v
                       ROLLING_BACK

Migration Estimate

GET .../migrations/estimate?targetRegion=eu-west-1

Returns estimated duration, data transfer size, downtime window, and resource requirements for planning purposes.

Admin Statistics

Platform-wide migration statistics are available at:

GET /api/v1/admin/migrations/stats

Returns total migrations, success rate, average duration, and active migration count.

Provisioning Endpoints Branding & Domain Endpoints