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 +4 -4
- data/VERSION +1 -1
- data/docs/NetworkConfiguration.md +1 -1
- data/docs/OsConfiguration.md +1 -1
- data/docs/OsConfigurationCloudInit.md +1 -1
- data/docs/PrivateNetworkConfiguration.md +1 -1
- data/docs/Server.md +1 -1
- data/docs/ServerCreate.md +1 -1
- data/docs/ServerPrivateNetwork.md +2 -2
- data/docs/ServerPublicNetwork.md +1 -1
- data/docs/ServersApi.md +8 -2
- data/lib/pnap_bmc_api/api/servers_api.rb +11 -2
- data/lib/pnap_bmc_api/models/network_configuration.rb +1 -1
- data/lib/pnap_bmc_api/models/os_configuration.rb +1 -1
- data/lib/pnap_bmc_api/models/os_configuration_cloud_init.rb +1 -1
- data/lib/pnap_bmc_api/models/private_network_configuration.rb +1 -1
- data/lib/pnap_bmc_api/models/server.rb +1 -1
- data/lib/pnap_bmc_api/models/server_create.rb +1 -1
- data/lib/pnap_bmc_api/models/server_private_network.rb +2 -2
- data/lib/pnap_bmc_api/models/server_public_network.rb +1 -25
- metadata +24 -24
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: aa4d1bec07d68b4f7508fa1745002c2d5fb9d2b4dbe18c27f6910bbfbec95777
|
4
|
+
data.tar.gz: 3ec5e3c0b99597bba369f7524ce2ab219b069bcdac66f6bddc440b22366f136a
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: b4ebda75738a7a72d220501bf3b3f897717c97e0d30f6292047a6b464308062681d2d79f601d16d205b71f7f5b16cdc269df939134c7570201630dbaa84f4f70
|
7
|
+
data.tar.gz: 7e6b1ba8cf1473638d269b5f15069bec6207b952197b258ee3dfdce4c5f4fb6809c647c887879d72cdd4dbf43395a80c83ddec444cd1067999c830cbf03ffe77
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
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
|
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] |
|
data/docs/OsConfiguration.md
CHANGED
@@ -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/
|
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
|
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/
|
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/
|
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
|
9
|
-
| **dhcp** | **Boolean** | Determines whether DHCP is enabled for this server. Should be false if
|
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
|
data/docs/ServerPublicNetwork.md
CHANGED
@@ -5,7 +5,7 @@
|
|
5
5
|
| Name | Type | Description | Notes |
|
6
6
|
| ---- | ---- | ----------- | ----- |
|
7
7
|
| **id** | **String** | The network identifier. | |
|
8
|
-
| **ips** | **Array<String>** |
|
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.
|
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'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
|
-
|
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'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'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.
|
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'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. <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.
|
1035
|
+
# 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>.
|
1032
1036
|
# @param server_id [String] The server'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'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. <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>.
|
1171
1178
|
# @param server_id [String] The server'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
|
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/
|
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
|
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/
|
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/
|
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
|
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
|
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
|
-
#
|
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.
|
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:
|
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/
|
215
|
-
- spec/models/
|
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/
|
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/
|
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/
|
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/
|
240
|
-
- spec/models/
|
241
|
-
- spec/models/
|
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
|