Struct FileCommand 

pub struct FileCommand { /* private fields */ }

Downloads binary image data. (Since Image API v2.0)

Starting with the 2026.1 (Gazpacho) release, a store preference feature is introduced to allow services to suggest which stores to try when downloading images. This enables services like Nova and Cinder to prefer stores that are close to them or have better performance characteristics.

An optional prefer query parameter may be added to the request. When present, it contains a comma-separated list of store identifiers suggesting the ordering of stores to try when downloading the image. Glance will try stores from the list in order. If the image is not found in any of the specified stores, the system will fall back to the default behavior (trying all stores).

Example call: curl -i -X GET -H "X-Auth-Token: $token" $image_url/v2/images/{image_id}/file

Example call with store preference: curl -i -X GET -H "X-Auth-Token: $token" $image_url/v2/images/{image_id}/file?prefer=local-store,backup-store

The response body contains the raw binary data that represents the actual virtual disk. The Content-Type header contains the application/octet-stream value. The Content-MD5 header contains an MD5 checksum of the image data. Use this checksum to verify the integrity of the image data.

Preconditions

Synchronous Postconditions

Normal response codes: 200, 204, 206

Error response codes: 400, 403, 404, 416

Error Responses

Implementations

impl FileCommand

pub async fn take_action<C: CliArgs>( &self, parsed_args: &C, client: &mut AsyncOpenStack, ) -> Result<(), OpenStackCliError>

Perform command action

Trait Implementations

impl Args for FileCommand

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl FromArgMatches for FileCommand

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.