openstack_cli_compute/v2/server/
set_294.rs

1// Licensed under the Apache License, Version 2.0 (the "License");
2// you may not use this file except in compliance with the License.
3// You may obtain a copy of the License at
4//
5//     http://www.apache.org/licenses/LICENSE-2.0
6//
7// Unless required by applicable law or agreed to in writing, software
8// distributed under the License is distributed on an "AS IS" BASIS,
9// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
10// See the License for the specific language governing permissions and
11// limitations under the License.
12//
13// SPDX-License-Identifier: Apache-2.0
14//
15// WARNING: This file is automatically generated from OpenAPI schema using
16// `openstack-codegenerator`.
17
18//! Set Server command [microversion = 2.94]
19//!
20//! Wraps invoking of the `v2.1/servers/{id}` with `PUT` method
21
22use clap::Args;
23use eyre::WrapErr;
24use tracing::info;
25
26use openstack_cli_core::cli::CliArgs;
27use openstack_cli_core::error::OpenStackCliError;
28use openstack_cli_core::output::OutputProcessor;
29use openstack_sdk::AsyncOpenStack;
30
31use clap::ValueEnum;
32use openstack_sdk::api::QueryAsync;
33use openstack_sdk::api::compute::v2::server::find;
34use openstack_sdk::api::compute::v2::server::set_294;
35use openstack_sdk::api::find;
36use openstack_types::compute::v2::server::response;
37
38/// Updates the editable attributes of an existing server.
39///
40/// Normal response codes: 200
41///
42/// Error response codes: badRequest(400), unauthorized(401), forbidden(403),
43/// itemNotFound(404)
44#[derive(Args)]
45#[command(about = "Update Server (microversion = 2.94)")]
46pub struct ServerCommand {
47    /// Request Query parameters
48    #[command(flatten)]
49    query: QueryParameters,
50
51    /// Path parameters
52    #[command(flatten)]
53    path: PathParameters,
54
55    /// A `server` object.
56    #[command(flatten)]
57    server: Server,
58}
59
60/// Query parameters
61#[derive(Args)]
62struct QueryParameters {}
63
64/// Path parameters
65#[derive(Args)]
66struct PathParameters {
67    /// id parameter for /v2.1/servers/{id} API
68    #[arg(
69        help_heading = "Path parameters",
70        id = "path_param_id",
71        value_name = "ID"
72    )]
73    id: String,
74}
75
76#[derive(Clone, Eq, Ord, PartialEq, PartialOrd, ValueEnum)]
77enum OsDcfDiskConfig {
78    Auto,
79    Manual,
80}
81
82/// Server Body data
83#[derive(Args, Clone)]
84struct Server {
85    /// IPv4 address that should be used to access this server.
86    #[arg(help_heading = "Body parameters", long)]
87    access_ipv4: Option<String>,
88
89    /// IPv6 address that should be used to access this server.
90    #[arg(help_heading = "Body parameters", long)]
91    access_ipv6: Option<String>,
92
93    /// A free form description of the server. Limited to 255 characters in
94    /// length. Before microversion 2.19 this was set to the server name.
95    ///
96    /// **New in version 2.19**
97    #[arg(help_heading = "Body parameters", long)]
98    description: Option<String>,
99
100    /// Set explicit NULL for the description
101    #[arg(help_heading = "Body parameters", long, action = clap::ArgAction::SetTrue, conflicts_with = "description")]
102    no_description: bool,
103
104    /// The hostname to configure for the instance in the metadata service.
105    ///
106    /// Starting with microversion 2.94, this can be a Fully Qualified Domain
107    /// Name (FQDN) of up to 255 characters in length.
108    ///
109    /// Note
110    ///
111    /// This information is published via the metadata service and requires
112    /// application such as `cloud-init` to propagate it through to the
113    /// instance.
114    ///
115    /// **New in version 2.90**
116    #[arg(help_heading = "Body parameters", long)]
117    hostname: Option<String>,
118
119    /// The server name.
120    #[arg(help_heading = "Body parameters", long)]
121    name: Option<String>,
122
123    /// Controls how the API partitions the disk when you create, rebuild, or
124    /// resize servers. A server inherits the `OS-DCF:diskConfig` value from
125    /// the image from which it was created, and an image inherits the
126    /// `OS-DCF:diskConfig` value from the server from which it was created. To
127    /// override the inherited setting, you can include this attribute in the
128    /// request body of a server create, rebuild, or resize request. If the
129    /// `OS-DCF:diskConfig` value for an image is `MANUAL`, you cannot create a
130    /// server from that image and set its `OS-DCF:diskConfig` value to `AUTO`.
131    /// A valid value is:
132    ///
133    /// - `AUTO`. The API builds the server with a single partition the size of
134    ///   the target flavor disk. The API automatically adjusts the file system
135    ///   to fit the entire partition.
136    /// - `MANUAL`. The API builds the server by using whatever partition
137    ///   scheme and file system is in the source image. If the target flavor
138    ///   disk is larger, the API does not partition the remaining disk space.
139    #[arg(help_heading = "Body parameters", long)]
140    os_dcf_disk_config: Option<OsDcfDiskConfig>,
141}
142
143impl ServerCommand {
144    /// Perform command action
145    pub async fn take_action<C: CliArgs>(
146        &self,
147        parsed_args: &C,
148        client: &mut AsyncOpenStack,
149    ) -> Result<(), OpenStackCliError> {
150        info!("Set Server");
151
152        let op = OutputProcessor::from_args(parsed_args, Some("compute.server"), Some("set"));
153        op.validate_args(parsed_args)?;
154
155        let mut find_builder = find::Request::builder();
156
157        find_builder.id(&self.path.id);
158        find_builder.header(
159            http::header::HeaderName::from_static("openstack-api-version"),
160            http::header::HeaderValue::from_static("compute 2.94"),
161        );
162
163        let find_ep = find_builder
164            .build()
165            .map_err(|x| OpenStackCliError::EndpointBuild(x.to_string()))?;
166        let find_data: serde_json::Value = find(find_ep).query_async(client).await?;
167
168        let mut ep_builder = set_294::Request::builder();
169        ep_builder.header(
170            http::header::HeaderName::from_static("openstack-api-version"),
171            http::header::HeaderValue::from_static("compute 2.94"),
172        );
173
174        let resource_id = find_data["id"]
175            .as_str()
176            .ok_or_else(|| eyre::eyre!("resource ID must be a string"))?
177            .to_string();
178        ep_builder.id(resource_id.clone());
179
180        // Set body parameters
181        // Set Request.server data
182        let args = &self.server;
183        let mut server_builder = set_294::ServerBuilder::default();
184        if let Some(val) = &args.os_dcf_disk_config {
185            let tmp = match val {
186                OsDcfDiskConfig::Auto => set_294::OsDcfDiskConfig::Auto,
187                OsDcfDiskConfig::Manual => set_294::OsDcfDiskConfig::Manual,
188            };
189            server_builder.os_dcf_disk_config(tmp);
190        }
191
192        if let Some(val) = &args.access_ipv4 {
193            server_builder.access_ipv4(val);
194        }
195
196        if let Some(val) = &args.access_ipv6 {
197            server_builder.access_ipv6(val);
198        }
199
200        if let Some(val) = &args.description {
201            server_builder.description(Some(val.into()));
202        } else if args.no_description {
203            server_builder.description(None);
204        }
205
206        if let Some(val) = &args.hostname {
207            server_builder.hostname(val);
208        }
209
210        if let Some(val) = &args.name {
211            server_builder.name(val);
212        }
213
214        ep_builder.server(
215            server_builder
216                .build()
217                .wrap_err("error preparing the request data")?,
218        );
219
220        let ep = ep_builder
221            .build()
222            .map_err(|x| OpenStackCliError::EndpointBuild(x.to_string()))?;
223
224        let data: serde_json::Value = ep.query_async(client).await?;
225
226        op.output_single::<response::set_275::ServerResponse>(data.clone())?;
227        // Show command specific hints
228        op.show_command_hint()?;
229        Ok(())
230    }
231}
openstack_cli_compute/v2/server/set_294.rs

openstack_cli_compute/v2/server/
set_294.rs
