volcengine_rust_sdk/service/iam/api_create_policy_model.rs
1/*
2 * @Author: Jerry.Yang
3 * @Date: 2024-10-25 15:10:33
4 * @LastEditors: Jerry.Yang
5 * @LastEditTime: 2025-02-05 17:08:32
6 * @Description: Model for creating a policy in IAM (Identity and Access Management)
7 */
8use crate::volcengine::error::error;
9use crate::volcengine::request::request::RequestVolcengine;
10use crate::volcengine::request::{request, response};
11use std::collections::HashMap;
12use volcengine_sdk_protobuf::protobuf::iam_policy;
13
14// Implementation of the ApiRequest trait for the CreatePolicyReq struct.
15// This allows the struct to be used as a request object in API calls to create a new policy.
16impl request::ApiRequest for iam_policy::CreatePolicyReq {
17 /// Converts the request into a HashMap of key-value pairs for use in HTTP requests.
18 /// This method is typically used when sending the request to the API server to create a new policy.
19 fn to_hashmap(&self) -> HashMap<String, String> {
20 request::Request::format_request_to_hashmap(self)
21 }
22
23 /// Prepares the request body as a byte vector.
24 /// For this request, the body is an empty vector since it's a GET request.
25 fn to_body(&self) -> Vec<u8> {
26 Vec::new()
27 }
28}
29
30// Implementation of the ApiResponse trait for the CreatePolicyResp struct.
31// This allows the struct to parse HTTP responses and convert them into a structured object containing information about the created policy.
32impl response::ApiResponse for iam_policy::CreatePolicyResp {
33 /// Converts the HTTP response into a structured response object.
34 /// This method handles parsing the JSON response from the API server and updating the current object with the parsed data.
35 /// It also checks the HTTP status code to determine if the request was successful.
36 async fn to_struct(&mut self, http_response: reqwest::Response) -> Result<(), error::Error> {
37 // Obtain the HTTP status code
38 let http_status = http_response.status();
39
40 // Parse the JSON response from the HTTP response.
41 // The `json()` method deserializes the response body into the target type.
42 let parsed_response: volcengine_sdk_protobuf::protobuf::iam_policy::CreatePolicyResp =
43 http_response
44 .json()
45 .await
46 .map_err(|e| error::Error::ErrParseResponse(e))?; // Handle JSON parsing errors
47
48 // Update the current object with the parsed response.
49 *self = parsed_response;
50
51 // Check if the HTTP status is not successful.
52 if !http_status.is_success() {
53 // Ensure that the `response_metadata` is present.
54 if let Some(mut response_metadata) = self.response_metadata.take() {
55 // Ensure that the `error` field is present.
56 let response_metadata_error = response_metadata.error.get_or_insert_with(
57 volcengine_sdk_protobuf::protobuf::iam_policy::ResponseMetadataErr::default,
58 );
59
60 // Set the `code_n` field to the HTTP status code as a numeric value.
61 response_metadata_error.code_n = Some(http_status.as_u16().into());
62
63 // Update the `response_metadata` with the error information.
64 self.response_metadata = Some(response_metadata);
65 }
66 }
67
68 // Return Ok(()) to indicate successful parsing.
69 Ok(())
70 }
71}