Service Transfers
This section details Service Transfer-related Linode CLI commands.
list
Aliases: ls
Returns a collection of all created and accepted Service Transfers for this account, regardless of the user that created or accepted the transfer.
Usage
The format accepted by this command.
linode-cli service-transfers list [-h] [--status status]
[--is_sender is_sender] [--order-by {status,is_sender}]
[--order {asc,desc}]
Sample
Examples of how this command might be used.
linode-cli service-transfers \
list
Filterable Attributes
Arguments used to define a filter for response entries.
Name |
Type |
Description |
|---|---|---|
--is_sender |
bool |
If the requesting account created this transfer. |
--status |
str |
The status of the transfer request. |
Result Attributes
The attributes returned by this command.
Name |
Type |
Example |
Description |
|---|---|---|---|
created |
str |
2021-02-11T16:37:03 |
When this transfer was created. |
expiry |
str |
2021-02-12T16:37:03 |
When this transfer expires. |
is_sender |
bool |
true |
If the requesting account created this transfer. |
status |
str |
pending |
The status of the transfer request. |
token |
str |
123E4567-E89…426614174000 |
The token used to identify and accept or cancel this transfer. |
updated |
str |
2021-02-11T16:37:03 |
When this transfer was last updated. |
entities
Name |
Type |
Example |
Description |
|---|---|---|---|
entities.linodes |
[]int |
[111, 222] |
An array containing the IDs of each of the Linodes included in this transfer. |
view
Returns the details of the Service Transfer for the provided token.
Usage
The format accepted by this command.
linode-cli service-transfers view [-h] [--status status]
[--is_sender is_sender] [--order-by {status,is_sender}]
[--order {asc,desc}] token
Sample
Examples of how this command might be used.
linode-cli service-transfers \
view 123E4567-E89B-12D3-A456-426614174000
Parameters
Positional parameters used to define the resource this command should target.
Name |
Type |
Description |
|---|---|---|
token |
str |
The UUID of the Service Transfer. |
Result Attributes
The attributes returned by this command.
Name |
Type |
Example |
Description |
|---|---|---|---|
created |
str |
2021-02-11T16:37:03 |
When this transfer was created. |
expiry |
str |
2021-02-12T16:37:03 |
When this transfer expires. |
is_sender |
bool |
true |
If the requesting account created this transfer. |
status |
str |
pending |
The status of the transfer request. |
token |
str |
123E4567-E89…426614174000 |
The token used to identify and accept or cancel this transfer. |
updated |
str |
2021-02-11T16:37:03 |
When this transfer was last updated. |
entities
Name |
Type |
Example |
Description |
|---|---|---|---|
entities.linodes |
[]int |
[111, 222] |
An array containing the IDs of each of the Linodes included in this transfer. |
create
Creates a transfer request for the specified services.
Usage
The format accepted by this command.
linode-cli service-transfers create [-h]
[--entities.linodes linodes]
Sample
Examples of how this command might be used.
linode-cli service-transfers \
create \
--entities.linodes 111 \
--entities.linodes 222
Arguments
Additional fields used to execute this request.
Name |
Type |
Example |
Description |
|---|---|---|---|
--entities.linodes |
[]int |
111 |
An array containing the IDs of each of the Linodes included in this transfer. |
Result Attributes
The attributes returned by this command.
Name |
Type |
Example |
Description |
|---|---|---|---|
created |
str |
2021-02-11T16:37:03 |
When this transfer was created. |
expiry |
str |
2021-02-12T16:37:03 |
When this transfer expires. |
is_sender |
bool |
true |
If the requesting account created this transfer. |
status |
str |
pending |
The status of the transfer request. |
token |
str |
123E4567-E89…426614174000 |
The token used to identify and accept or cancel this transfer. |
updated |
str |
2021-02-11T16:37:03 |
When this transfer was last updated. |
entities
Name |
Type |
Example |
Description |
|---|---|---|---|
entities.linodes |
[]int |
[111, 222] |
An array containing the IDs of each of the Linodes included in this transfer. |
accept
Accept a Service Transfer for the provided token to receive the services included in the transfer to your account.
Usage
The format accepted by this command.
linode-cli service-transfers accept [-h] token
Sample
Examples of how this command might be used.
linode-cli service-transfers \
accept 123E4567-E89B-12D3-A456-426614174000
Parameters
Positional parameters used to define the resource this command should target.
Name |
Type |
Description |
|---|---|---|
token |
str |
The UUID of the Service Transfer. |
cancel
Cancels the Service Transfer for the provided token.
Usage
The format accepted by this command.
linode-cli service-transfers cancel [-h] token
Sample
Examples of how this command might be used.
linode-cli service-transfers \
cancel 123E4567-E89B-12D3-A456-426614174000
Parameters
Positional parameters used to define the resource this command should target.
Name |
Type |
Description |
|---|---|---|
token |
str |
The UUID of the Service Transfer. |