API
  1. Administration
  2. Service transfers

Get a service transfer request

get
https://api.linode.com//account/service-transfers/

Returns details for the service transfer for the provided token.

  • After a transfer has been accepted, it can only be viewed by users on the accounts that requested and accepted the transfer and have the corresponding permissions.

  • If canceled or expired, only users of the account that requested the transfer can view it and have the required permission.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

  • Identity and access permissions. Your user needs a role with these permissions. Learn more.

    • Permissions: view_service_transfer

  • OAuth scopes. Your user needs these scopes assigned. Learn more.

    • Scopes: account:read_only

CLI

linode-cli service-transfers \
  view 123E4567-E89B-12D3-A456-426614174000

Learn more

Path Params
string
enum
required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:
uuid
required

The UUID of the service transfer. This value is sent in an email to the originator of the service transfer request.

Responses

Response body
object
date-time

When this transfer was created.

entities
object

A collection of the services to include in this transfer request, separated by type.

linodes
array of integers

An array containing the IDs of each of the Linodes included in this transfer.

linodes
date-time

When this transfer expires. Transfers will automatically expire 24 hours after creation.

boolean

Filterable If the requesting account created this transfer.

string
enum

Filterable The status of the transfer request.

  • accepted: The transfer has been accepted by another user and is currently in progress. Transfers can take up to 3 hours to complete.

  • canceled. The transfer has been canceled by the sender.

  • completed. The transfer has completed successfully.

  • failed. The transfer has failed after initiation.

  • pending. The transfer is ready to be accepted.

  • stale. The transfer has exceeded its expiration date. It can no longer be accepted or
    canceled.

accepted canceled completed failed pending stale

uuid

The token used to identify and accept or cancel this transfer.

date-time

When this transfer was last updated.

Updated 27 days ago

Did this page help you?
Language
Credentials

Updated 27 days ago

Did this page help you?