doctl compute image-action transfer

Generated on 20 November 2024 from doctl v1.119.0 ( 5510cad )

Usage

doctl compute image-action transfer <image-id> [flags]

Transfers an image to a different datacenter region. Also outputs the following details:

The unique ID used to identify and reference an image action
The status of the image action. Possible values: in-progress, completed, errored.
When the action was initiated, in ISO8601 combined date and time format
When the action was completed, in ISO8601 combined date and time format
The ID of the resource that the action was taken on
The type of resource that the action was taken on
The region where the action occurred
The region’s slug

The following example transfers an image with the ID 386734086 to the region with the slug nyc3:

doctl compute image-action transfer 386734086 --region nyc3

Option	Description
`--format`	Columns for output in a comma-separated list. Possible values: `ID`, `Status`, `Type`, `StartedAt`, `CompletedAt`, `ResourceID`, `ResourceType`, `Region`.
`--help` , `-h`	Help for this command
`--no-header`	Return raw data with no headers Default: `false`
`--region`	The target region to transfer the image to (required)
`--wait`	Instructs the terminal to wait for the action to complete before returning access to the user Default: `false`

Command	Description
doctl compute image-action	Display commands to perform actions on images

Option	Description
`--access-token`, `-t`	API V2 access token
`--api-url`, `-u`	Override default API endpoint
`--config`, `-c`	Specify a custom config file Default: macOS: `${HOME}/Library/Application Support/doctl/config.yaml` Linux: `${XDG_CONFIG_HOME}/doctl/config.yaml` Windows: `%APPDATA%\doctl\config.yaml`
`--context`	Specify a custom authentication context name
`--http-retry-max`	Set maximum number of retries for requests that fail with a 429 or 500-level error Default: `5`
`--http-retry-wait-max`	Set the minimum number of seconds to wait before retrying a failed request Default: `30`
`--http-retry-wait-min`	Set the maximum number of seconds to wait before retrying a failed request Default: `1`
`--interactive`	Enable interactive behavior. Defaults to true if the terminal supports it (default false) Default: `false`
`--output`, `-o`	Desired output format [text\|json] Default: `text`
`--trace`	Show a log of network activity while performing a command Default: `false`
`--verbose`, `-v`	Enable verbose output Default: `false`