Move a workload link to another managed object storage cluster

POST

/api/managed-storage/{id}/bindings/{bindingId}/move

curl --request POST \
  --url https://gateway.example.com/api/managed-storage/550e8400-e29b-41d4-a716-446655440000/bindings/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/move \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "targetStorageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'

• Your Gateway instance

Points the link at targetStorageId without recreating the workload: the link keeps its alias, network and environment, and its key keeps the same access key id and secret, recreated on the target. Only the relay route moves (the connector is recreated when the clusters differ in TLS). Needs storage:iam on both clusters and permission to change the linked workload. A failure rolls the route, connector and target key back; the source key is revoked afterwards, best effort.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string

>= 1 characters

Example

550e8400-e29b-41d4-a716-446655440000

bindingId

required

string format: uuid

Request Body^required

JSON request body

Media typeapplication/json

object

targetStorageId

required

string format: uuid

Example^generated

{
  "targetStorageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

Responses

200

Successful response

Media typeapplication/json

object

data

required

Resource object. Exact fields depend on the endpoint.

object

id

string

name

string

key

additional properties

Example

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Example resource",
    "createdAt": "2024-01-01T12:00:00.000Z",
    "updatedAt": "2024-01-01T12:30:00.000Z"
  }
}

400

Bad request

Media typeapplication/json

object

code

required

Error code

string

message

required

Human-readable error message

string

details

Additional error details

Example

{
  "code": "VALIDATION_ERROR",
  "message": "Request validation failed",
  "details": [
    {
      "path": [
        "name"
      ],
      "message": "Required"
    }
  ]
}

401

Authentication required

Media typeapplication/json

object

code

required

Error code

string

message

required

Human-readable error message

string

details

Additional error details

Example

{
  "code": "UNAUTHORIZED",
  "message": "Authentication required"
}

403

Forbidden

Media typeapplication/json

object

code

required

Error code

string

message

required

Human-readable error message

string

details

Additional error details

Example

{
  "code": "FORBIDDEN",
  "message": "Insufficient permissions"
}

404

Not found

Media typeapplication/json

object

code

required

Error code

string

message

required

Human-readable error message

string

details

Additional error details

Example

{
  "code": "NOT_FOUND",
  "message": "Resource not found"
}

409

Conflict

Media typeapplication/json

object

code

required

Error code

string

message

required

Human-readable error message

string

details

Additional error details

Example

{
  "code": "CONFLICT",
  "message": "Resource already exists"
}

422

Unprocessable entity

Media typeapplication/json

object

code

required

Error code

string

message

required

Human-readable error message

string

details

Additional error details

Example

{
  "code": "UNPROCESSABLE_ENTITY",
  "message": "Request could not be processed"
}

500

Internal server error

Media typeapplication/json

object

code

required

Error code

string

message

required

Human-readable error message

string

details

Additional error details

Example

{
  "code": "INTERNAL_ERROR",
  "message": "Internal server error"
}