pnap_bmc_api 1.2.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: c963cbc0d6e9a73b1d20d9fc4ebdae4f26841905700f25cd1d4194b3f5389622
4
- data.tar.gz: 2cdf867849e85e583276bc0403f3556eedc7bdc94d69fed2bbea52475d386a13
3
+ metadata.gz: aa4d1bec07d68b4f7508fa1745002c2d5fb9d2b4dbe18c27f6910bbfbec95777
4
+ data.tar.gz: 3ec5e3c0b99597bba369f7524ce2ab219b069bcdac66f6bddc440b22366f136a
5
5
  SHA512:
6
- metadata.gz: 39130877d89b21a46619f58fc59549a9ff56f7d4d2f93f078c6bf13cb6a36619aab4f4cd544fc977c3ab1d7f294fa051aacaa30c56f903e4d95db2b6a4ca7808
7
- data.tar.gz: ad7384db61dd6d4dd691b61b7f251c203dc106c92ffb75d95817c815e0113362a68486a6be92ccaa4ab7252c69ff9980559f5621e2ca215eea85fa8a5179f100
6
+ metadata.gz: b4ebda75738a7a72d220501bf3b3f897717c97e0d30f6292047a6b464308062681d2d79f601d16d205b71f7f5b16cdc269df939134c7570201630dbaa84f4f70
7
+ data.tar.gz: 7e6b1ba8cf1473638d269b5f15069bec6207b952197b258ee3dfdce4c5f4fb6809c647c887879d72cdd4dbf43395a80c83ddec444cd1067999c830cbf03ffe77
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.2.0
1
+ 1.3.0
@@ -4,7 +4,7 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
- | **gateway_address** | **String** | The address of the gateway assigned / to assign to the server. When used as part of request body, IP address has to be part of private/public network assigned to this server. | [optional] |
7
+ | **gateway_address** | **String** | The address of the gateway assigned / to assign to the server.<br> When used as part of request body, IP address has to be part of a private/public network or an IP block assigned to this server.<br> Gateway address also has to be assigned on an already deployed resource unless the address matches the BMC gateway address in a public network/IP block or the `force` query parameter is true. | [optional] |
8
8
  | **private_network_configuration** | [**PrivateNetworkConfiguration**](PrivateNetworkConfiguration.md) | | [optional] |
9
9
  | **ip_blocks_configuration** | [**IpBlocksConfiguration**](IpBlocksConfiguration.md) | | [optional] |
10
10
  | **public_network_configuration** | [**PublicNetworkConfiguration**](PublicNetworkConfiguration.md) | | [optional] |
@@ -8,7 +8,7 @@
8
8
  | **root_password** | **String** | Password set for user root on an ESXi server which will only be returned in response to provisioning a server. | [optional][readonly] |
9
9
  | **management_ui_url** | **String** | The URL of the management UI which will only be returned in response to provisioning a server. | [optional][readonly] |
10
10
  | **management_access_allowed_ips** | **Array<String>** | List of IPs allowed to access the Management UI. Supported in single IP, CIDR and range format. When undefined, Management UI is disabled. This will only be returned in response to provisioning a server. | [optional] |
11
- | **install_os_to_ram** | **Boolean** | If true, OS will be installed to and booted from the server's RAM. On restart RAM OS will be lost and the server will not be reachable unless a custom bootable OS has been deployed. Only supported for ubuntu/focal. | [optional][default to false] |
11
+ | **install_os_to_ram** | **Boolean** | If true, OS will be installed to and booted from the server's RAM. On restart RAM OS will be lost and the server will not be reachable unless a custom bootable OS has been deployed. Only supported for ubuntu/focal and ubuntu/jammy. | [optional][default to false] |
12
12
  | **cloud_init** | [**OsConfigurationCloudInit**](OsConfigurationCloudInit.md) | | [optional] |
13
13
 
14
14
  ## Example
@@ -4,7 +4,7 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
- | **user_data** | **String** | User data for the <a href='https://cloudinit.readthedocs.io/en/latest/' target='_blank'>cloud-init</a> configuration in base64 encoding. NoCloud format is supported. Follow the <a href='https://phoenixnap.com/kb/bmc-cloud-init' target='_blank'>instructions</a> on how to provision a server using cloud-init. Only ubuntu/bionic and ubuntu/focal are supported. User data will not be stored and cannot be retrieved once you deploy the server. Copy and save it for future reference. | [optional] |
7
+ | **user_data** | **String** | User data for the <a href='https://cloudinit.readthedocs.io/en/latest/' target='_blank'>cloud-init</a> configuration in base64 encoding. NoCloud format is supported. Follow the <a href='https://phoenixnap.com/kb/bmc-cloud-init' target='_blank'>instructions</a> on how to provision a server using cloud-init. Only ubuntu/bionic, ubuntu/focal and ubuntu/jammy are supported. User data will not be stored and cannot be retrieved once you deploy the server. Copy and save it for future reference. | [optional] |
8
8
 
9
9
  ## Example
10
10
 
@@ -4,7 +4,7 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
- | **gateway_address** | **String** | The address of the gateway assigned / to assign to the server. When used as part of request body, it has to match one of the IP addresses used in the existing assigned private networks for the relevant location. Deprecated in favour of a common gateway address across all networks available under NetworkConfiguration. | [optional] |
7
+ | **gateway_address** | **String** | Deprecated in favour of a common gateway address across all networks available under NetworkConfiguration.<br> The address of the gateway assigned / to assign to the server.<br> When used as part of request body, IP address has to be part of private network assigned to this server.<br> Gateway address also has to be assigned on an already deployed resource unless the `force` query parameter is true. | [optional] |
8
8
  | **configuration_type** | **String** | Determines the approach for configuring private network(s) for the server being provisioned. Currently this field should be set to `USE_OR_CREATE_DEFAULT` or `USER_DEFINED`. | [optional][default to 'USE_OR_CREATE_DEFAULT'] |
9
9
  | **private_networks** | [**Array<ServerPrivateNetwork>**](ServerPrivateNetwork.md) | The list of private networks this server is member of. When this field is part of request body, it'll be used to specify the private networks to assign to this server upon provisioning. Used alongside the `USER_DEFINED` configurationType. | [optional] |
10
10
 
data/docs/Server.md CHANGED
@@ -8,7 +8,7 @@
8
8
  | **status** | **String** | The status of the server. | |
9
9
  | **hostname** | **String** | Hostname of server. | |
10
10
  | **description** | **String** | Description of server. | [optional] |
11
- | **os** | **String** | The server’s OS ID used when the server was created. Currently this field should be set to either `ubuntu/bionic`, `ubuntu/focal`, `centos/centos7`, `centos/centos8`, `windows/srv2019std`, `windows/srv2019dc`, `esxi/esxi70u2`, `debian/bullseye` or `proxmox/bullseye`. | |
11
+ | **os** | **String** | The server’s OS ID used when the server was created. Currently this field should be set to either `ubuntu/bionic`, `ubuntu/focal`, `ubuntu/jammy`, `centos/centos7`, `centos/centos8`, `windows/srv2019std`, `windows/srv2019dc`, `esxi/esxi70`, `debian/bullseye` or `proxmox/bullseye`. | |
12
12
  | **type** | **String** | Server type ID. Cannot be changed once a server is created. Currently this field should be set to either `s0.d1.small`, `s0.d1.medium`, `s1.c1.small`, `s1.c1.medium`, `s1.c2.medium`, `s1.c2.large`, `s1.e1.small`, `s1.e1.medium`, `s1.e1.large`, `s2.c1.small`, `s2.c1.medium`, `s2.c1.large`, `s2.c2.small`, `s2.c2.medium`, `s2.c2.large`, `d1.c1.small`, `d1.c2.small`, `d1.c3.small`, `d1.c4.small`, `d1.c1.medium`, `d1.c2.medium`, `d1.c3.medium`, `d1.c4.medium`, `d1.c1.large`, `d1.c2.large`, `d1.c3.large`, `d1.c4.large`, `d1.m1.medium`, `d1.m2.medium`, `d1.m3.medium`, `d1.m4.medium`, `d2.c1.medium`, `d2.c2.medium`, `d2.c3.medium`, `d2.c4.medium`, `d2.c5.medium`, `d2.c1.large`, `d2.c2.large`, `d2.c3.large`, `d2.c4.large`, `d2.c5.large`, `d2.m1.medium`, `d2.m1.large`, `d2.m2.medium`, `d2.m2.large`, `d2.m2.xlarge` or `d2.c4.storage.pliops1`. | |
13
13
  | **location** | **String** | Server location ID. Cannot be changed once a server is created. Currently this field should be set to `PHX`, `ASH`, `SGP`, `NLD`, `CHI`, `SEA` or `AUS`. | |
14
14
  | **cpu** | **String** | A description of the machine CPU. | |
data/docs/ServerCreate.md CHANGED
@@ -6,7 +6,7 @@
6
6
  | ---- | ---- | ----------- | ----- |
7
7
  | **hostname** | **String** | Hostname of server. | |
8
8
  | **description** | **String** | Description of server. | [optional] |
9
- | **os** | **String** | The server’s OS ID used when the server was created. Currently this field should be set to either `ubuntu/bionic`, `ubuntu/focal`, `centos/centos7`,`centos/centos8`, `windows/srv2019std`, `windows/srv2019dc`, `esxi/esxi70u2`, `debian/bullseye` or `proxmox/bullseye`. | |
9
+ | **os** | **String** | The server’s OS ID used when the server was created. Currently this field should be set to either `ubuntu/bionic`, `ubuntu/focal`, `ubuntu/jammy`, `centos/centos7`,`centos/centos8`, `windows/srv2019std`, `windows/srv2019dc`, `esxi/esxi70`, `debian/bullseye` or `proxmox/bullseye`. | |
10
10
  | **type** | **String** | Server type ID. Cannot be changed once a server is created. Currently this field should be set to either `s0.d1.small`, `s0.d1.medium`, `s1.c1.small`, `s1.c1.medium`, `s1.c2.medium`, `s1.c2.large`, `s1.e1.small`, `s1.e1.medium`, `s1.e1.large`, `s2.c1.small`, `s2.c1.medium`, `s2.c1.large`, `s2.c2.small`, `s2.c2.medium`, `s2.c2.large`, `d1.c1.small`, `d1.c2.small`, `d1.c3.small`, `d1.c4.small`, `d1.c1.medium`, `d1.c2.medium`, `d1.c3.medium`, `d1.c4.medium`, `d1.c1.large`, `d1.c2.large`, `d1.c3.large`, `d1.c4.large`, `d1.m1.medium`, `d1.m2.medium`, `d1.m3.medium`, `d1.m4.medium`, `d2.c1.medium`, `d2.c2.medium`, `d2.c3.medium`, `d2.c4.medium`, `d2.c5.medium`, `d2.c1.large`, `d2.c2.large`, `d2.c3.large`, `d2.c4.large`, `d2.c5.large`, `d2.m1.medium`, `d2.m1.large`, `d2.m2.medium`, `d2.m2.large`, `d2.m2.xlarge` or `d2.c4.storage.pliops1`. | |
11
11
  | **location** | **String** | Server location ID. Cannot be changed once a server is created. Currently this field should be set to `PHX`, `ASH`, `SGP`, `NLD`, `CHI`, `SEA` or `AUS`. | |
12
12
  | **install_default_ssh_keys** | **Boolean** | Whether or not to install SSH keys marked as default in addition to any SSH keys specified in this request. | [optional][default to true] |
@@ -5,8 +5,8 @@
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
7
  | **id** | **String** | The network identifier. | |
8
- | **ips** | **Array<String>** | IPs to configure/configured on the server. Should be null or empty list if DHCP is true. If the network contains a membership of type 'storage', the first twelve IPs are already reserved by BMC and not usable. These will return a Bad Request (400) if selected. | [optional] |
9
- | **dhcp** | **Boolean** | Determines whether DHCP is enabled for this server. Should be false if ips is not an empty list. Not supported for proxmox OS. | [optional][default to false] |
8
+ | **ips** | **Array<String>** | IPs to configure/configured on the server.<br> Should be null or empty list if DHCP is true. IPs must be within the network's range.<br> If field is undefined and DHCP is false, next available IP in network will be automatically allocated.<br> If the network contains a membership of type 'storage', the first twelve IPs are already reserved by BMC and not usable.<br> Setting the `force` query parameter to `true` allows you to:<ul> <li> Assign no specific IP addresses by designating an empty array of IPs. Note that at least one IP is required for the gateway address to be selected from this network. <li> Assign one or more IP addresses which are already configured on other resource(s) in network.</ul> | [optional] |
9
+ | **dhcp** | **Boolean** | Determines whether DHCP is enabled for this server. Should be false if any IPs are provided. Not supported for Proxmox OS and ESXi OS. | [optional][default to false] |
10
10
  | **status_description** | **String** | The status of the network. | [optional][readonly] |
11
11
 
12
12
  ## Example
@@ -5,7 +5,7 @@
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
7
  | **id** | **String** | The network identifier. | |
8
- | **ips** | **Array<String>** | IPs to configure/configured on the server. IPs must be within the network's range. | |
8
+ | **ips** | **Array<String>** | Configurable/configured IPs on the server.<br> At least 1 IP address is required. All IPs must be within the network's range.<br> Setting the `force` query parameter to `true` allows you to:<ul> <li> Assign no specific IP addresses by designating an empty array of IPs. Note that at least one IP is required for the gateway address to be selected from this network. <li> Assign one or more IP addresses which are already configured on other resource(s) in network.</ul> | [optional] |
9
9
  | **status_description** | **String** | The status of the assignment to the network. | [optional][readonly] |
10
10
 
11
11
  ## Example
data/docs/ServersApi.md CHANGED
@@ -188,6 +188,7 @@ end
188
188
 
189
189
  api_instance = BmcApi::ServersApi.new
190
190
  opts = {
191
+ force: true, # Boolean | Query parameter controlling advanced features availability. Currently applicable for networking. It is advised to use with caution since it might lead to unhealthy setups.
191
192
  server_create: BmcApi::ServerCreate.new({hostname: 'my-server-1', os: 'ubuntu/bionic', type: 's1.c1.small', location: 'PHX'}) # ServerCreate |
192
193
  }
193
194
 
@@ -222,6 +223,7 @@ end
222
223
 
223
224
  | Name | Type | Description | Notes |
224
225
  | ---- | ---- | ----------- | ----- |
226
+ | **force** | **Boolean** | Query parameter controlling advanced features availability. Currently applicable for networking. It is advised to use with caution since it might lead to unhealthy setups. | [optional][default to false] |
225
227
  | **server_create** | [**ServerCreate**](ServerCreate.md) | | [optional] |
226
228
 
227
229
  ### Return type
@@ -1098,7 +1100,7 @@ end
1098
1100
 
1099
1101
  Adds the server to a private network.
1100
1102
 
1101
- Adds the server to a private network. <b>No actual configuration is performed on the operating system.</b> BMC configures exclusively the networking devices in the datacenter infrastructure. Manual network configuration changes in the operating system of this server are required. If the network contains a membership of type 'storage', the first twelve IPs are already reserved by BMC and not usable. These will return a Bad Request (400) if selected. Knowledge base article to help you can be found <a href='https://phoenixnap.com/kb/configure-bmc-server-after-adding-to-network#ftoc-heading-3' target='_blank'>here</a>.
1103
+ Adds the server to a private network. <b>No actual configuration is performed on the operating system.</b> BMC configures exclusively the networking devices in the datacenter infrastructure. Manual network configuration changes in the operating system of this server are required. Knowledge base article to help you can be found <a href='https://phoenixnap.com/kb/configure-bmc-server-after-adding-to-network#ftoc-heading-3' target='_blank'>here</a>.
1102
1104
 
1103
1105
  ### Examples
1104
1106
 
@@ -1114,6 +1116,7 @@ end
1114
1116
  api_instance = BmcApi::ServersApi.new
1115
1117
  server_id = 'e6afba51-7de8-4080-83ab-0f915570659c' # String | The server's ID.
1116
1118
  opts = {
1119
+ force: true, # Boolean | Query parameter controlling advanced features availability. Currently applicable for networking. It is advised to use with caution since it might lead to unhealthy setups.
1117
1120
  server_private_network: BmcApi::ServerPrivateNetwork.new({id: '603f3b2cfcaf050643b89a4b'}) # ServerPrivateNetwork |
1118
1121
  }
1119
1122
 
@@ -1149,6 +1152,7 @@ end
1149
1152
  | Name | Type | Description | Notes |
1150
1153
  | ---- | ---- | ----------- | ----- |
1151
1154
  | **server_id** | **String** | The server&#39;s ID. | |
1155
+ | **force** | **Boolean** | Query parameter controlling advanced features availability. Currently applicable for networking. It is advised to use with caution since it might lead to unhealthy setups. | [optional][default to false] |
1152
1156
  | **server_private_network** | [**ServerPrivateNetwork**](ServerPrivateNetwork.md) | | [optional] |
1153
1157
 
1154
1158
  ### Return type
@@ -1258,7 +1262,8 @@ end
1258
1262
  api_instance = BmcApi::ServersApi.new
1259
1263
  server_id = 'e6afba51-7de8-4080-83ab-0f915570659c' # String | The server's ID.
1260
1264
  opts = {
1261
- server_public_network: BmcApi::ServerPublicNetwork.new({id: '60473c2509268bc77fd06d29', ips: ["182.16.0.146", "182.16.0.147"]}) # ServerPublicNetwork |
1265
+ force: true, # Boolean | Query parameter controlling advanced features availability. Currently applicable for networking. It is advised to use with caution since it might lead to unhealthy setups.
1266
+ server_public_network: BmcApi::ServerPublicNetwork.new({id: '60473c2509268bc77fd06d29'}) # ServerPublicNetwork |
1262
1267
  }
1263
1268
 
1264
1269
  begin
@@ -1293,6 +1298,7 @@ end
1293
1298
  | Name | Type | Description | Notes |
1294
1299
  | ---- | ---- | ----------- | ----- |
1295
1300
  | **server_id** | **String** | The server&#39;s ID. | |
1301
+ | **force** | **Boolean** | Query parameter controlling advanced features availability. Currently applicable for networking. It is advised to use with caution since it might lead to unhealthy setups. | [optional][default to false] |
1296
1302
  | **server_public_network** | [**ServerPublicNetwork**](ServerPublicNetwork.md) | | [optional] |
1297
1303
 
1298
1304
  ### Return type
@@ -151,6 +151,7 @@ module BmcApi
151
151
  # Create new server.
152
152
  # Create (request) new server for account. Server DNS will be configured to access Google's public DNS at 8.8.8.8 .
153
153
  # @param [Hash] opts the optional parameters
154
+ # @option opts [Boolean] :force Query parameter controlling advanced features availability. Currently applicable for networking. It is advised to use with caution since it might lead to unhealthy setups. (default to false)
154
155
  # @option opts [ServerCreate] :server_create
155
156
  # @return [Server]
156
157
  def servers_post(opts = {})
@@ -161,6 +162,7 @@ module BmcApi
161
162
  # Create new server.
162
163
  # Create (request) new server for account. Server DNS will be configured to access Google&#39;s public DNS at 8.8.8.8 .
163
164
  # @param [Hash] opts the optional parameters
165
+ # @option opts [Boolean] :force Query parameter controlling advanced features availability. Currently applicable for networking. It is advised to use with caution since it might lead to unhealthy setups. (default to false)
164
166
  # @option opts [ServerCreate] :server_create
165
167
  # @return [Array<(Server, Integer, Hash)>] Server data, response status code and response headers
166
168
  def servers_post_with_http_info(opts = {})
@@ -172,6 +174,7 @@ module BmcApi
172
174
 
173
175
  # query parameters
174
176
  query_params = opts[:query_params] || {}
177
+ query_params[:'force'] = opts[:'force'] if !opts[:'force'].nil?
175
178
 
176
179
  # header parameters
177
180
  header_params = opts[:header_params] || {}
@@ -1017,9 +1020,10 @@ module BmcApi
1017
1020
  end
1018
1021
 
1019
1022
  # Adds the server to a private network.
1020
- # Adds the server to a private network. <b>No actual configuration is performed on the operating system.</b> BMC configures exclusively the networking devices in the datacenter infrastructure. Manual network configuration changes in the operating system of this server are required. If the network contains a membership of type 'storage', the first twelve IPs are already reserved by BMC and not usable. These will return a Bad Request (400) if selected. Knowledge base article to help you can be found <a href='https://phoenixnap.com/kb/configure-bmc-server-after-adding-to-network#ftoc-heading-3' target='_blank'>here</a>.
1023
+ # Adds the server to a private network. <b>No actual configuration is performed on the operating system.</b> BMC configures exclusively the networking devices in the datacenter infrastructure. Manual network configuration changes in the operating system of this server are required. Knowledge base article to help you can be found <a href='https://phoenixnap.com/kb/configure-bmc-server-after-adding-to-network#ftoc-heading-3' target='_blank'>here</a>.
1021
1024
  # @param server_id [String] The server&#39;s ID.
1022
1025
  # @param [Hash] opts the optional parameters
1026
+ # @option opts [Boolean] :force Query parameter controlling advanced features availability. Currently applicable for networking. It is advised to use with caution since it might lead to unhealthy setups. (default to false)
1023
1027
  # @option opts [ServerPrivateNetwork] :server_private_network
1024
1028
  # @return [ServerPrivateNetwork]
1025
1029
  def servers_server_id_private_networks_post(server_id, opts = {})
@@ -1028,9 +1032,10 @@ module BmcApi
1028
1032
  end
1029
1033
 
1030
1034
  # Adds the server to a private network.
1031
- # Adds the server to a private network. &lt;b&gt;No actual configuration is performed on the operating system.&lt;/b&gt; BMC configures exclusively the networking devices in the datacenter infrastructure. Manual network configuration changes in the operating system of this server are required. If the network contains a membership of type &#39;storage&#39;, the first twelve IPs are already reserved by BMC and not usable. These will return a Bad Request (400) if selected. Knowledge base article to help you can be found &lt;a href&#x3D;&#39;https://phoenixnap.com/kb/configure-bmc-server-after-adding-to-network#ftoc-heading-3&#39; target&#x3D;&#39;_blank&#39;&gt;here&lt;/a&gt;.
1035
+ # Adds the server to a private network. &lt;b&gt;No actual configuration is performed on the operating system.&lt;/b&gt; BMC configures exclusively the networking devices in the datacenter infrastructure. Manual network configuration changes in the operating system of this server are required. Knowledge base article to help you can be found &lt;a href&#x3D;&#39;https://phoenixnap.com/kb/configure-bmc-server-after-adding-to-network#ftoc-heading-3&#39; target&#x3D;&#39;_blank&#39;&gt;here&lt;/a&gt;.
1032
1036
  # @param server_id [String] The server&#39;s ID.
1033
1037
  # @param [Hash] opts the optional parameters
1038
+ # @option opts [Boolean] :force Query parameter controlling advanced features availability. Currently applicable for networking. It is advised to use with caution since it might lead to unhealthy setups. (default to false)
1034
1039
  # @option opts [ServerPrivateNetwork] :server_private_network
1035
1040
  # @return [Array<(ServerPrivateNetwork, Integer, Hash)>] ServerPrivateNetwork data, response status code and response headers
1036
1041
  def servers_server_id_private_networks_post_with_http_info(server_id, opts = {})
@@ -1046,6 +1051,7 @@ module BmcApi
1046
1051
 
1047
1052
  # query parameters
1048
1053
  query_params = opts[:query_params] || {}
1054
+ query_params[:'force'] = opts[:'force'] if !opts[:'force'].nil?
1049
1055
 
1050
1056
  # header parameters
1051
1057
  header_params = opts[:header_params] || {}
@@ -1159,6 +1165,7 @@ module BmcApi
1159
1165
  # Adds the server to a Public Network. <b>No actual configuration is performed on the operating system.</b> BMC configures exclusively the networking devices in the datacenter infrastructure. Manual network configuration changes in the operating system of this server are required. Knowledge base article to help you can be found <a href='https://phoenixnap.com/kb/configure-bmc-server-after-adding-to-network#ftoc-heading-3' target='_blank'>here</a>.
1160
1166
  # @param server_id [String] The server&#39;s ID.
1161
1167
  # @param [Hash] opts the optional parameters
1168
+ # @option opts [Boolean] :force Query parameter controlling advanced features availability. Currently applicable for networking. It is advised to use with caution since it might lead to unhealthy setups. (default to false)
1162
1169
  # @option opts [ServerPublicNetwork] :server_public_network
1163
1170
  # @return [ServerPublicNetwork]
1164
1171
  def servers_server_id_public_networks_post(server_id, opts = {})
@@ -1170,6 +1177,7 @@ module BmcApi
1170
1177
  # Adds the server to a Public Network. &lt;b&gt;No actual configuration is performed on the operating system.&lt;/b&gt; BMC configures exclusively the networking devices in the datacenter infrastructure. Manual network configuration changes in the operating system of this server are required. Knowledge base article to help you can be found &lt;a href&#x3D;&#39;https://phoenixnap.com/kb/configure-bmc-server-after-adding-to-network#ftoc-heading-3&#39; target&#x3D;&#39;_blank&#39;&gt;here&lt;/a&gt;.
1171
1178
  # @param server_id [String] The server&#39;s ID.
1172
1179
  # @param [Hash] opts the optional parameters
1180
+ # @option opts [Boolean] :force Query parameter controlling advanced features availability. Currently applicable for networking. It is advised to use with caution since it might lead to unhealthy setups. (default to false)
1173
1181
  # @option opts [ServerPublicNetwork] :server_public_network
1174
1182
  # @return [Array<(ServerPublicNetwork, Integer, Hash)>] ServerPublicNetwork data, response status code and response headers
1175
1183
  def servers_server_id_public_networks_post_with_http_info(server_id, opts = {})
@@ -1185,6 +1193,7 @@ module BmcApi
1185
1193
 
1186
1194
  # query parameters
1187
1195
  query_params = opts[:query_params] || {}
1196
+ query_params[:'force'] = opts[:'force'] if !opts[:'force'].nil?
1188
1197
 
1189
1198
  # header parameters
1190
1199
  header_params = opts[:header_params] || {}
@@ -16,7 +16,7 @@ require 'time'
16
16
  module BmcApi
17
17
  # Entire network details of bare metal server.
18
18
  class NetworkConfiguration
19
- # The address of the gateway assigned / to assign to the server. When used as part of request body, IP address has to be part of private/public network assigned to this server.
19
+ # The address of the gateway assigned / to assign to the server.<br> When used as part of request body, IP address has to be part of a private/public network or an IP block assigned to this server.<br> Gateway address also has to be assigned on an already deployed resource unless the address matches the BMC gateway address in a public network/IP block or the `force` query parameter is true.
20
20
  attr_accessor :gateway_address
21
21
 
22
22
  attr_accessor :private_network_configuration
@@ -27,7 +27,7 @@ module BmcApi
27
27
  # List of IPs allowed to access the Management UI. Supported in single IP, CIDR and range format. When undefined, Management UI is disabled. This will only be returned in response to provisioning a server.
28
28
  attr_accessor :management_access_allowed_ips
29
29
 
30
- # If true, OS will be installed to and booted from the server's RAM. On restart RAM OS will be lost and the server will not be reachable unless a custom bootable OS has been deployed. Only supported for ubuntu/focal.
30
+ # If true, OS will be installed to and booted from the server's RAM. On restart RAM OS will be lost and the server will not be reachable unless a custom bootable OS has been deployed. Only supported for ubuntu/focal and ubuntu/jammy.
31
31
  attr_accessor :install_os_to_ram
32
32
 
33
33
  attr_accessor :cloud_init
@@ -16,7 +16,7 @@ require 'time'
16
16
  module BmcApi
17
17
  # Cloud-init configuration details.
18
18
  class OsConfigurationCloudInit
19
- # User data for the <a href='https://cloudinit.readthedocs.io/en/latest/' target='_blank'>cloud-init</a> configuration in base64 encoding. NoCloud format is supported. Follow the <a href='https://phoenixnap.com/kb/bmc-cloud-init' target='_blank'>instructions</a> on how to provision a server using cloud-init. Only ubuntu/bionic and ubuntu/focal are supported. User data will not be stored and cannot be retrieved once you deploy the server. Copy and save it for future reference.
19
+ # User data for the <a href='https://cloudinit.readthedocs.io/en/latest/' target='_blank'>cloud-init</a> configuration in base64 encoding. NoCloud format is supported. Follow the <a href='https://phoenixnap.com/kb/bmc-cloud-init' target='_blank'>instructions</a> on how to provision a server using cloud-init. Only ubuntu/bionic, ubuntu/focal and ubuntu/jammy are supported. User data will not be stored and cannot be retrieved once you deploy the server. Copy and save it for future reference.
20
20
  attr_accessor :user_data
21
21
 
22
22
  # Attribute mapping from ruby-style variable name to JSON key.
@@ -16,7 +16,7 @@ require 'time'
16
16
  module BmcApi
17
17
  # Private network details of bare metal server.
18
18
  class PrivateNetworkConfiguration
19
- # The address of the gateway assigned / to assign to the server. When used as part of request body, it has to match one of the IP addresses used in the existing assigned private networks for the relevant location. Deprecated in favour of a common gateway address across all networks available under NetworkConfiguration.
19
+ # Deprecated in favour of a common gateway address across all networks available under NetworkConfiguration.<br> The address of the gateway assigned / to assign to the server.<br> When used as part of request body, IP address has to be part of private network assigned to this server.<br> Gateway address also has to be assigned on an already deployed resource unless the `force` query parameter is true.
20
20
  attr_accessor :gateway_address
21
21
 
22
22
  # Determines the approach for configuring private network(s) for the server being provisioned. Currently this field should be set to `USE_OR_CREATE_DEFAULT` or `USER_DEFINED`.
@@ -28,7 +28,7 @@ module BmcApi
28
28
  # Description of server.
29
29
  attr_accessor :description
30
30
 
31
- # The server’s OS ID used when the server was created. Currently this field should be set to either `ubuntu/bionic`, `ubuntu/focal`, `centos/centos7`, `centos/centos8`, `windows/srv2019std`, `windows/srv2019dc`, `esxi/esxi70u2`, `debian/bullseye` or `proxmox/bullseye`.
31
+ # The server’s OS ID used when the server was created. Currently this field should be set to either `ubuntu/bionic`, `ubuntu/focal`, `ubuntu/jammy`, `centos/centos7`, `centos/centos8`, `windows/srv2019std`, `windows/srv2019dc`, `esxi/esxi70`, `debian/bullseye` or `proxmox/bullseye`.
32
32
  attr_accessor :os
33
33
 
34
34
  # Server type ID. Cannot be changed once a server is created. Currently this field should be set to either `s0.d1.small`, `s0.d1.medium`, `s1.c1.small`, `s1.c1.medium`, `s1.c2.medium`, `s1.c2.large`, `s1.e1.small`, `s1.e1.medium`, `s1.e1.large`, `s2.c1.small`, `s2.c1.medium`, `s2.c1.large`, `s2.c2.small`, `s2.c2.medium`, `s2.c2.large`, `d1.c1.small`, `d1.c2.small`, `d1.c3.small`, `d1.c4.small`, `d1.c1.medium`, `d1.c2.medium`, `d1.c3.medium`, `d1.c4.medium`, `d1.c1.large`, `d1.c2.large`, `d1.c3.large`, `d1.c4.large`, `d1.m1.medium`, `d1.m2.medium`, `d1.m3.medium`, `d1.m4.medium`, `d2.c1.medium`, `d2.c2.medium`, `d2.c3.medium`, `d2.c4.medium`, `d2.c5.medium`, `d2.c1.large`, `d2.c2.large`, `d2.c3.large`, `d2.c4.large`, `d2.c5.large`, `d2.m1.medium`, `d2.m1.large`, `d2.m2.medium`, `d2.m2.large`, `d2.m2.xlarge` or `d2.c4.storage.pliops1`.
@@ -22,7 +22,7 @@ module BmcApi
22
22
  # Description of server.
23
23
  attr_accessor :description
24
24
 
25
- # The server’s OS ID used when the server was created. Currently this field should be set to either `ubuntu/bionic`, `ubuntu/focal`, `centos/centos7`,`centos/centos8`, `windows/srv2019std`, `windows/srv2019dc`, `esxi/esxi70u2`, `debian/bullseye` or `proxmox/bullseye`.
25
+ # The server’s OS ID used when the server was created. Currently this field should be set to either `ubuntu/bionic`, `ubuntu/focal`, `ubuntu/jammy`, `centos/centos7`,`centos/centos8`, `windows/srv2019std`, `windows/srv2019dc`, `esxi/esxi70`, `debian/bullseye` or `proxmox/bullseye`.
26
26
  attr_accessor :os
27
27
 
28
28
  # Server type ID. Cannot be changed once a server is created. Currently this field should be set to either `s0.d1.small`, `s0.d1.medium`, `s1.c1.small`, `s1.c1.medium`, `s1.c2.medium`, `s1.c2.large`, `s1.e1.small`, `s1.e1.medium`, `s1.e1.large`, `s2.c1.small`, `s2.c1.medium`, `s2.c1.large`, `s2.c2.small`, `s2.c2.medium`, `s2.c2.large`, `d1.c1.small`, `d1.c2.small`, `d1.c3.small`, `d1.c4.small`, `d1.c1.medium`, `d1.c2.medium`, `d1.c3.medium`, `d1.c4.medium`, `d1.c1.large`, `d1.c2.large`, `d1.c3.large`, `d1.c4.large`, `d1.m1.medium`, `d1.m2.medium`, `d1.m3.medium`, `d1.m4.medium`, `d2.c1.medium`, `d2.c2.medium`, `d2.c3.medium`, `d2.c4.medium`, `d2.c5.medium`, `d2.c1.large`, `d2.c2.large`, `d2.c3.large`, `d2.c4.large`, `d2.c5.large`, `d2.m1.medium`, `d2.m1.large`, `d2.m2.medium`, `d2.m2.large`, `d2.m2.xlarge` or `d2.c4.storage.pliops1`.
@@ -19,10 +19,10 @@ module BmcApi
19
19
  # The network identifier.
20
20
  attr_accessor :id
21
21
 
22
- # IPs to configure/configured on the server. Should be null or empty list if DHCP is true. If the network contains a membership of type 'storage', the first twelve IPs are already reserved by BMC and not usable. These will return a Bad Request (400) if selected.
22
+ # IPs to configure/configured on the server.<br> Should be null or empty list if DHCP is true. IPs must be within the network's range.<br> If field is undefined and DHCP is false, next available IP in network will be automatically allocated.<br> If the network contains a membership of type 'storage', the first twelve IPs are already reserved by BMC and not usable.<br> Setting the `force` query parameter to `true` allows you to:<ul> <li> Assign no specific IP addresses by designating an empty array of IPs. Note that at least one IP is required for the gateway address to be selected from this network. <li> Assign one or more IP addresses which are already configured on other resource(s) in network.</ul>
23
23
  attr_accessor :ips
24
24
 
25
- # Determines whether DHCP is enabled for this server. Should be false if ips is not an empty list. Not supported for proxmox OS.
25
+ # Determines whether DHCP is enabled for this server. Should be false if any IPs are provided. Not supported for Proxmox OS and ESXi OS.
26
26
  attr_accessor :dhcp
27
27
 
28
28
  # The status of the network.
@@ -19,7 +19,7 @@ module BmcApi
19
19
  # The network identifier.
20
20
  attr_accessor :id
21
21
 
22
- # IPs to configure/configured on the server. IPs must be within the network's range.
22
+ # Configurable/configured IPs on the server.<br> At least 1 IP address is required. All IPs must be within the network's range.<br> Setting the `force` query parameter to `true` allows you to:<ul> <li> Assign no specific IP addresses by designating an empty array of IPs. Note that at least one IP is required for the gateway address to be selected from this network. <li> Assign one or more IP addresses which are already configured on other resource(s) in network.</ul>
23
23
  attr_accessor :ips
24
24
 
25
25
  # The status of the assignment to the network.
@@ -92,14 +92,6 @@ module BmcApi
92
92
  invalid_properties.push('invalid value for "id", id cannot be nil.')
93
93
  end
94
94
 
95
- if @ips.nil?
96
- invalid_properties.push('invalid value for "ips", ips cannot be nil.')
97
- end
98
-
99
- if @ips.length < 1
100
- invalid_properties.push('invalid value for "ips", number of items must be greater than or equal to 1.')
101
- end
102
-
103
95
  invalid_properties
104
96
  end
105
97
 
@@ -107,25 +99,9 @@ module BmcApi
107
99
  # @return true if the model is valid
108
100
  def valid?
109
101
  return false if @id.nil?
110
- return false if @ips.nil?
111
- return false if @ips.length < 1
112
102
  true
113
103
  end
114
104
 
115
- # Custom attribute writer method with validation
116
- # @param [Object] ips Value to be assigned
117
- def ips=(ips)
118
- if ips.nil?
119
- fail ArgumentError, 'ips cannot be nil'
120
- end
121
-
122
- if ips.length < 1
123
- fail ArgumentError, 'invalid value for "ips", number of items must be greater than or equal to 1.'
124
- end
125
-
126
- @ips = ips
127
- end
128
-
129
105
  # Checks equality by comparing each attribute.
130
106
  # @param [Object] Object to be compared
131
107
  def ==(o)
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: pnap_bmc_api
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.2.0
4
+ version: 1.3.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - PhoenixNAP
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-12-07 00:00:00.000000000 Z
11
+ date: 2023-03-08 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: typhoeus
@@ -208,37 +208,37 @@ test_files:
208
208
  - spec/api/quotas_api_spec.rb
209
209
  - spec/api_client_spec.rb
210
210
  - spec/configuration_spec.rb
211
+ - spec/models/os_configuration_map_esxi_spec.rb
211
212
  - spec/models/quota_edit_limit_request_details_all_of_spec.rb
212
- - spec/models/delete_result_spec.rb
213
213
  - spec/models/os_configuration_map_proxmox_spec.rb
214
- - spec/models/server_reset_spec.rb
215
- - spec/models/server_create_spec.rb
216
- - spec/models/public_network_configuration_spec.rb
217
- - spec/models/ssh_key_create_spec.rb
218
- - spec/models/os_configuration_windows_spec.rb
219
- - spec/models/tag_assignment_request_spec.rb
220
- - spec/models/quota_edit_limit_request_details_spec.rb
214
+ - spec/models/server_private_network_spec.rb
215
+ - spec/models/delete_result_spec.rb
221
216
  - spec/models/quota_spec.rb
222
- - spec/models/relinquish_ip_block_spec.rb
217
+ - spec/models/os_configuration_windows_spec.rb
218
+ - spec/models/ssh_key_create_spec.rb
219
+ - spec/models/ssh_key_update_spec.rb
220
+ - spec/models/server_ip_block_spec.rb
221
+ - spec/models/server_reset_spec.rb
223
222
  - spec/models/ssh_key_spec.rb
224
- - spec/models/os_configuration_spec.rb
225
- - spec/models/quota_edit_limit_request_spec.rb
226
- - spec/models/server_private_network_spec.rb
227
- - spec/models/os_configuration_map_spec.rb
228
223
  - spec/models/error_spec.rb
229
- - spec/models/os_configuration_map_esxi_spec.rb
230
- - spec/models/ssh_key_update_spec.rb
231
- - spec/models/server_reserve_spec.rb
232
- - spec/models/os_configuration_cloud_init_spec.rb
233
224
  - spec/models/tag_assignment_spec.rb
234
- - spec/models/server_spec.rb
225
+ - spec/models/quota_edit_limit_request_details_spec.rb
226
+ - spec/models/os_configuration_map_spec.rb
227
+ - spec/models/server_create_spec.rb
235
228
  - spec/models/action_result_spec.rb
236
- - spec/models/server_patch_spec.rb
229
+ - spec/models/server_reserve_spec.rb
230
+ - spec/models/private_network_configuration_spec.rb
231
+ - spec/models/tag_assignment_request_spec.rb
232
+ - spec/models/public_network_configuration_spec.rb
237
233
  - spec/models/network_configuration_spec.rb
238
234
  - spec/models/ip_blocks_configuration_spec.rb
239
- - spec/models/server_public_network_spec.rb
240
- - spec/models/server_ip_block_spec.rb
241
- - spec/models/private_network_configuration_spec.rb
235
+ - spec/models/relinquish_ip_block_spec.rb
236
+ - spec/models/os_configuration_cloud_init_spec.rb
237
+ - spec/models/server_patch_spec.rb
242
238
  - spec/models/delete_ssh_key_result_spec.rb
239
+ - spec/models/os_configuration_spec.rb
240
+ - spec/models/server_public_network_spec.rb
241
+ - spec/models/server_spec.rb
243
242
  - spec/models/reset_result_spec.rb
243
+ - spec/models/quota_edit_limit_request_spec.rb
244
244
  - spec/spec_helper.rb