1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
// SPDX-License-Identifier: Apache-2.0
//
// WARNING: This file is automatically generated from OpenAPI schema using
// `openstack-codegenerator`.
//! Action Server command [microversion = 2.56]
//!
//! Wraps invoking of the `v2.1/servers/{id}/action` with `POST` method
use clap::Args;
use eyre::WrapErr;
use tracing::info;
use openstack_sdk::AsyncOpenStack;
use crate::Cli;
use crate::OpenStackCliError;
use crate::output::OutputProcessor;
use openstack_sdk::api::QueryAsync;
use openstack_sdk::api::compute::v2::server::migrate_256;
/// Migrates a server to a host.
///
/// Specify the `migrate` action in the request body.
///
/// Up to microversion 2.55, the scheduler chooses the host. Starting from
/// microversion 2.56, the `host` parameter is available to specify the
/// destination host. If you specify `null` or don’t specify this parameter,
/// the scheduler chooses a host.
///
/// **Asynchronous Postconditions**
///
/// A successfully migrated server shows a `VERIFY_RESIZE` status and
/// `finished` migration status. If the cloud has configured the
/// [resize_confirm_window](https://docs.openstack.org/nova/latest/configuration/config.html#DEFAULT.resize_confirm_window)
/// option of the Compute service to a positive value, the Compute service
/// automatically confirms the migrate operation after the configured interval.
///
/// There are two different policies for this action, depending on whether the
/// host parameter is set. Both defaults enable only users with the
/// administrative role to perform this operation. Cloud providers can change
/// these permissions through the `policy.yaml` file.
///
/// Normal response codes: 202
///
/// Error response codes: badRequest(400), unauthorized(401), forbidden(403)
/// itemNotFound(404), conflict(409)
#[derive(Args)]
#[command(about = "Migrate Server (migrate Action) (microversion = 2.56)")]
pub struct ServerCommand {
/// Request Query parameters
#[command(flatten)]
query: QueryParameters,
/// Path parameters
#[command(flatten)]
path: PathParameters,
/// The action to cold migrate a server. This parameter can be `null`. Up
/// to microversion 2.55, this parameter should be `null`.
#[command(flatten)]
migrate: Option<Migrate>,
}
/// Query parameters
#[derive(Args)]
struct QueryParameters {}
/// Path parameters
#[derive(Args)]
struct PathParameters {
/// id parameter for /v2.1/servers/{id}/action API
#[arg(
help_heading = "Path parameters",
id = "path_param_id",
value_name = "ID"
)]
id: String,
}
/// Migrate Body data
#[derive(Args, Clone)]
struct Migrate {
#[arg(help_heading = "Body parameters", long)]
host: Option<String>,
/// Set explicit NULL for the host
#[arg(help_heading = "Body parameters", long, action = clap::ArgAction::SetTrue, conflicts_with = "host")]
no_host: bool,
}
impl ServerCommand {
/// Perform command action
pub async fn take_action(
&self,
parsed_args: &Cli,
client: &mut AsyncOpenStack,
) -> Result<(), OpenStackCliError> {
info!("Action Server");
let op = OutputProcessor::from_args(parsed_args, Some("compute.server"), Some("migrate"));
op.validate_args(parsed_args)?;
let mut ep_builder = migrate_256::Request::builder();
ep_builder.header(
http::header::HeaderName::from_static("openstack-api-version"),
http::header::HeaderValue::from_static("compute 2.56"),
);
ep_builder.id(&self.path.id);
// Set body parameters
// Set Request.migrate data
if let Some(lmigrate) = &self.migrate {
let mut migrate_builder = migrate_256::MigrateBuilder::default();
if let Some(val) = &lmigrate.host {
migrate_builder.host(Some(val.into()));
}
ep_builder.migrate(
migrate_builder
.build()
.wrap_err("error preparing the request data")?,
);
}
let ep = ep_builder
.build()
.map_err(|x| OpenStackCliError::EndpointBuild(x.to_string()))?;
openstack_sdk::api::ignore(ep).query_async(client).await?;
// Show command specific hints
op.show_command_hint()?;
Ok(())
}
}