knife-ionoscloud 5.0.0.beta.1 → 5.0.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.
Files changed (93) hide show
  1. checksums.yaml +4 -4
  2. data/.github/workflows/build.yml +20 -0
  3. data/.github/workflows/publish.yml +25 -14
  4. data/README.md +81 -0
  5. data/docs/README.md +33 -18
  6. data/docs/changelog.md +2 -1
  7. data/docs/subcommands/backupunit_create.md +11 -8
  8. data/docs/subcommands/backupunit_delete.md +11 -8
  9. data/docs/subcommands/backupunit_list.md +11 -8
  10. data/docs/subcommands/backupunit_ssourl.md +13 -10
  11. data/docs/subcommands/composite_server_create.md +12 -9
  12. data/docs/subcommands/contract_list.md +11 -8
  13. data/docs/subcommands/datacenter_create.md +14 -10
  14. data/docs/subcommands/datacenter_delete.md +11 -8
  15. data/docs/subcommands/datacenter_list.md +11 -8
  16. data/docs/subcommands/firewall_create.md +14 -11
  17. data/docs/subcommands/firewall_delete.md +14 -11
  18. data/docs/subcommands/firewall_list.md +14 -11
  19. data/docs/subcommands/group_create.md +11 -8
  20. data/docs/subcommands/group_delete.md +11 -8
  21. data/docs/subcommands/group_get.md +12 -9
  22. data/docs/subcommands/group_list.md +11 -8
  23. data/docs/subcommands/group_user_add.md +12 -9
  24. data/docs/subcommands/group_user_remove.md +12 -9
  25. data/docs/subcommands/image_list.md +11 -8
  26. data/docs/subcommands/ipblock_create.md +12 -9
  27. data/docs/subcommands/ipblock_delete.md +11 -8
  28. data/docs/subcommands/ipblock_list.md +11 -8
  29. data/docs/subcommands/ipfailover_add.md +15 -12
  30. data/docs/subcommands/ipfailover_remove.md +14 -11
  31. data/docs/subcommands/k8s_create.md +11 -8
  32. data/docs/subcommands/k8s_delete.md +11 -8
  33. data/docs/subcommands/k8s_list.md +11 -8
  34. data/docs/subcommands/kubeconfig_get.md +12 -9
  35. data/docs/subcommands/label_add.md +12 -9
  36. data/docs/subcommands/label_list.md +11 -8
  37. data/docs/subcommands/label_remove.md +12 -9
  38. data/docs/subcommands/lan_create.md +12 -9
  39. data/docs/subcommands/lan_delete.md +12 -9
  40. data/docs/subcommands/lan_list.md +12 -9
  41. data/docs/subcommands/loadbalancer_create.md +12 -9
  42. data/docs/subcommands/loadbalancer_delete.md +12 -9
  43. data/docs/subcommands/loadbalancer_get.md +13 -10
  44. data/docs/subcommands/loadbalancer_list.md +12 -9
  45. data/docs/subcommands/loadbalancer_nic_add.md +13 -10
  46. data/docs/subcommands/loadbalancer_nic_remove.md +13 -10
  47. data/docs/subcommands/location_list.md +11 -8
  48. data/docs/subcommands/nic_create.md +14 -12
  49. data/docs/subcommands/nic_delete.md +13 -10
  50. data/docs/subcommands/nic_list.md +13 -10
  51. data/docs/subcommands/node_delete.md +13 -10
  52. data/docs/subcommands/node_list.md +13 -10
  53. data/docs/subcommands/node_replace.md +14 -11
  54. data/docs/subcommands/nodepool_create.md +19 -16
  55. data/docs/subcommands/nodepool_delete.md +12 -9
  56. data/docs/subcommands/nodepool_list.md +12 -9
  57. data/docs/subcommands/pcc_create.md +11 -8
  58. data/docs/subcommands/pcc_delete.md +11 -8
  59. data/docs/subcommands/pcc_list.md +11 -8
  60. data/docs/subcommands/request_list.md +12 -9
  61. data/docs/subcommands/request_status.md +12 -9
  62. data/docs/subcommands/request_wait.md +12 -9
  63. data/docs/subcommands/resource_list.md +11 -10
  64. data/docs/subcommands/s3key_create.md +12 -9
  65. data/docs/subcommands/s3key_delete.md +12 -9
  66. data/docs/subcommands/s3key_list.md +12 -9
  67. data/docs/subcommands/server_create.md +13 -10
  68. data/docs/subcommands/server_delete.md +13 -10
  69. data/docs/subcommands/server_list.md +12 -9
  70. data/docs/subcommands/server_reboot.md +12 -9
  71. data/docs/subcommands/server_start.md +13 -10
  72. data/docs/subcommands/server_stop.md +12 -9
  73. data/docs/subcommands/share_create.md +13 -10
  74. data/docs/subcommands/share_delete.md +12 -9
  75. data/docs/subcommands/share_list.md +12 -9
  76. data/docs/subcommands/snapshot_create.md +13 -10
  77. data/docs/subcommands/snapshot_delete.md +11 -8
  78. data/docs/subcommands/snapshot_list.md +11 -8
  79. data/docs/subcommands/snapshot_restore.md +14 -11
  80. data/docs/subcommands/user_create.md +12 -10
  81. data/docs/subcommands/user_delete.md +11 -8
  82. data/docs/subcommands/user_list.md +12 -9
  83. data/docs/subcommands/user_ssourl.md +12 -9
  84. data/docs/subcommands/volume_attach.md +13 -10
  85. data/docs/subcommands/volume_create.md +12 -9
  86. data/docs/subcommands/volume_delete.md +12 -9
  87. data/docs/subcommands/volume_detach.md +13 -10
  88. data/docs/subcommands/volume_list.md +12 -9
  89. data/docs/summary.md +1 -0
  90. data/git-versioning.sh +113 -0
  91. data/lib/knife-ionoscloud/version.rb +1 -1
  92. data/sonar-project.properties +12 -0
  93. metadata +8 -4
@@ -2,25 +2,28 @@
2
2
 
3
3
  Retrieve a list of snapshots.
4
4
 
5
- knife ionoscloud snapshot list
6
-
5
+ ```text
6
+ knife ionoscloud snapshot list
7
+ ```
7
8
 
8
9
  ## Available options:
9
- ---
10
10
 
11
11
  ### Required options:
12
- * ionoscloud_username
13
- * ionoscloud_password
14
12
 
15
- ```
13
+ * ionoscloud\_username
14
+ * ionoscloud\_password
15
+
16
+ ```text
16
17
  ionoscloud_username: --username USERNAME, -u USERNAME
17
18
  your Ionoscloud username (required)
18
19
 
19
20
  ionoscloud_password: --password PASSWORD, -p PASSWORD
20
21
  your Ionoscloud password (required)
21
-
22
22
  ```
23
23
 
24
24
  ## Example
25
25
 
26
- knife ionoscloud snapshot list--username USERNAME --password PASSWORD
26
+ ```text
27
+ knife ionoscloud snapshot list--username USERNAME --password PASSWORD
28
+ ```
29
+
@@ -2,20 +2,21 @@
2
2
 
3
3
  This will restore a snapshot onto a volume. A snapshot is created as just another image that can be used to create new volumes or to restore an existing volume.
4
4
 
5
- knife ionoscloud snapshot restore (options)
6
-
5
+ ```text
6
+ knife ionoscloud snapshot restore (options)
7
+ ```
7
8
 
8
9
  ## Available options:
9
- ---
10
10
 
11
11
  ### Required options:
12
- * datacenter_id
13
- * volume_id
14
- * snapshot_id
15
- * ionoscloud_username
16
- * ionoscloud_password
17
12
 
18
- ```
13
+ * datacenter\_id
14
+ * volume\_id
15
+ * snapshot\_id
16
+ * ionoscloud\_username
17
+ * ionoscloud\_password
18
+
19
+ ```text
19
20
  datacenter_id: --datacenter DATACENTER_ID, -D DATACENTER_ID
20
21
  iD of the Datacenter (required)
21
22
 
@@ -30,9 +31,11 @@ This will restore a snapshot onto a volume. A snapshot is created as just anothe
30
31
 
31
32
  ionoscloud_password: --password PASSWORD, -p PASSWORD
32
33
  your Ionoscloud password (required)
33
-
34
34
  ```
35
35
 
36
36
  ## Example
37
37
 
38
- knife ionoscloud snapshot restore --datacenter DATACENTER_ID --volume VOLUME_ID --snapshot SNAPSHOT_ID --username USERNAME --password PASSWORD
38
+ ```text
39
+ knife ionoscloud snapshot restore --datacenter DATACENTER_ID --volume VOLUME_ID --snapshot SNAPSHOT_ID --username USERNAME --password PASSWORD
40
+ ```
41
+
@@ -1,23 +1,23 @@
1
1
  # UserCreate
2
2
 
3
- Creates a new user under a particular contract.
4
- **Please Note**: The password set here cannot be updated through the API currently. It is recommended that a new user log into the DCD and change their password.
5
-
6
- knife ionoscloud user create (options)
3
+ Creates a new user under a particular contract. **Please Note**: The password set here cannot be updated through the API currently. It is recommended that a new user log into the DCD and change their password.
7
4
 
5
+ ```text
6
+ knife ionoscloud user create (options)
7
+ ```
8
8
 
9
9
  ## Available options:
10
- ---
11
10
 
12
11
  ### Required options:
12
+
13
13
  * firstname
14
14
  * lastname
15
15
  * email
16
16
  * password
17
- * ionoscloud_username
18
- * ionoscloud_password
17
+ * ionoscloud\_username
18
+ * ionoscloud\_password
19
19
 
20
- ```
20
+ ```text
21
21
  firstname: --firstname FIRSTNAME, -f FIRSTNAME
22
22
  firstname of the user. (required)
23
23
 
@@ -41,9 +41,11 @@ Creates a new user under a particular contract.
41
41
 
42
42
  ionoscloud_password: --password PASSWORD, -p PASSWORD
43
43
  your Ionoscloud password (required)
44
-
45
44
  ```
46
45
 
47
46
  ## Example
48
47
 
49
- knife ionoscloud user create --firstname FIRSTNAME --lastname LASTNAME --email EMAIL --password PASSWORD --admin ADMIN --sec-auth SEC_AUTH --username USERNAME --password PASSWORD
48
+ ```text
49
+ knife ionoscloud user create --firstname FIRSTNAME --lastname LASTNAME --email EMAIL --password PASSWORD --admin ADMIN --sec-auth SEC_AUTH --username USERNAME --password PASSWORD
50
+ ```
51
+
@@ -2,25 +2,28 @@
2
2
 
3
3
  Blacklists the user, disabling them. The user is not completely purged, therefore if you anticipate needing to create a user with the same name in the future, we suggest renaming the user before you delete it.
4
4
 
5
- knife ionoscloud user delete USER_ID [USER_ID]
6
-
5
+ ```text
6
+ knife ionoscloud user delete USER_ID [USER_ID]
7
+ ```
7
8
 
8
9
  ## Available options:
9
- ---
10
10
 
11
11
  ### Required options:
12
- * ionoscloud_username
13
- * ionoscloud_password
14
12
 
15
- ```
13
+ * ionoscloud\_username
14
+ * ionoscloud\_password
15
+
16
+ ```text
16
17
  ionoscloud_username: --username USERNAME, -u USERNAME
17
18
  your Ionoscloud username (required)
18
19
 
19
20
  ionoscloud_password: --password PASSWORD, -p PASSWORD
20
21
  your Ionoscloud password (required)
21
-
22
22
  ```
23
23
 
24
24
  ## Example
25
25
 
26
- knife ionoscloud user delete USER_ID [USER_ID]--username USERNAME --password PASSWORD
26
+ ```text
27
+ knife ionoscloud user delete USER_ID [USER_ID]--username USERNAME --password PASSWORD
28
+ ```
29
+
@@ -1,18 +1,19 @@
1
1
  # UserList
2
2
 
3
- Retrieve a list of all the users that have been created under a contract. You can retrieve a list of users who are members of the group by passing the *group_id* option.
4
-
5
- knife ionoscloud user list (options)
3
+ Retrieve a list of all the users that have been created under a contract. You can retrieve a list of users who are members of the group by passing the _group\_id_ option.
6
4
 
5
+ ```text
6
+ knife ionoscloud user list (options)
7
+ ```
7
8
 
8
9
  ## Available options:
9
- ---
10
10
 
11
11
  ### Required options:
12
- * ionoscloud_username
13
- * ionoscloud_password
14
12
 
15
- ```
13
+ * ionoscloud\_username
14
+ * ionoscloud\_password
15
+
16
+ ```text
16
17
  group_id: --group-id GROUP_ID, -g GROUP_ID
17
18
  iD of the group.
18
19
 
@@ -21,9 +22,11 @@ Retrieve a list of all the users that have been created under a contract. You ca
21
22
 
22
23
  ionoscloud_password: --password PASSWORD, -p PASSWORD
23
24
  your Ionoscloud password (required)
24
-
25
25
  ```
26
26
 
27
27
  ## Example
28
28
 
29
- knife ionoscloud user list --group-id GROUP_ID --username USERNAME --password PASSWORD
29
+ ```text
30
+ knife ionoscloud user list --group-id GROUP_ID --username USERNAME --password PASSWORD
31
+ ```
32
+
@@ -2,18 +2,19 @@
2
2
 
3
3
  Retrieve S3 object storage single signon URL for the given user.
4
4
 
5
- knife ionoscloud user ssourl (options)
6
-
5
+ ```text
6
+ knife ionoscloud user ssourl (options)
7
+ ```
7
8
 
8
9
  ## Available options:
9
- ---
10
10
 
11
11
  ### Required options:
12
- * user_id
13
- * ionoscloud_username
14
- * ionoscloud_password
15
12
 
16
- ```
13
+ * user\_id
14
+ * ionoscloud\_username
15
+ * ionoscloud\_password
16
+
17
+ ```text
17
18
  user_id: --user-id USER_ID, -U USER_ID
18
19
  the ID of the Backup unit. (required)
19
20
 
@@ -22,9 +23,11 @@ Retrieve S3 object storage single signon URL for the given user.
22
23
 
23
24
  ionoscloud_password: --password PASSWORD, -p PASSWORD
24
25
  your Ionoscloud password (required)
25
-
26
26
  ```
27
27
 
28
28
  ## Example
29
29
 
30
- knife ionoscloud user ssourl --user-id USER_ID --username USERNAME --password PASSWORD
30
+ ```text
31
+ knife ionoscloud user ssourl --user-id USER_ID --username USERNAME --password PASSWORD
32
+ ```
33
+
@@ -2,19 +2,20 @@
2
2
 
3
3
  This will attach a pre-existing storage volume to the server.
4
4
 
5
- knife ionoscloud volume attach VOLUME_ID [VOLUME_ID] (options)
6
-
5
+ ```text
6
+ knife ionoscloud volume attach VOLUME_ID [VOLUME_ID] (options)
7
+ ```
7
8
 
8
9
  ## Available options:
9
- ---
10
10
 
11
11
  ### Required options:
12
- * datacenter_id
13
- * server_id
14
- * ionoscloud_username
15
- * ionoscloud_password
16
12
 
17
- ```
13
+ * datacenter\_id
14
+ * server\_id
15
+ * ionoscloud\_username
16
+ * ionoscloud\_password
17
+
18
+ ```text
18
19
  datacenter_id: --datacenter-id DATACENTER_ID, -D DATACENTER_ID
19
20
  the ID of the data center (required)
20
21
 
@@ -26,9 +27,11 @@ This will attach a pre-existing storage volume to the server.
26
27
 
27
28
  ionoscloud_password: --password PASSWORD, -p PASSWORD
28
29
  your Ionoscloud password (required)
29
-
30
30
  ```
31
31
 
32
32
  ## Example
33
33
 
34
- knife ionoscloud volume attach VOLUME_ID
34
+ ```text
35
+ knife ionoscloud volume attach VOLUME_ID
36
+ ```
37
+
@@ -2,21 +2,22 @@
2
2
 
3
3
  Creates a volume within the data center. This will NOT attach the volume to a server. Please see the Servers section for details on how to attach storage volumes.
4
4
 
5
- knife ionoscloud volume create (options)
6
-
5
+ ```text
6
+ knife ionoscloud volume create (options)
7
+ ```
7
8
 
8
9
  ## Available options:
9
- ---
10
10
 
11
11
  ### Required options:
12
- * datacenter_id
12
+
13
+ * datacenter\_id
13
14
  * name
14
15
  * type
15
16
  * size
16
- * ionoscloud_username
17
- * ionoscloud_password
17
+ * ionoscloud\_username
18
+ * ionoscloud\_password
18
19
 
19
- ```
20
+ ```text
20
21
  datacenter_id: --datacenter-id DATACENTER_ID, -D DATACENTER_ID
21
22
  name of the data center (required)
22
23
 
@@ -55,9 +56,11 @@ Creates a volume within the data center. This will NOT attach the volume to a se
55
56
 
56
57
  ionoscloud_password: --password PASSWORD, -p PASSWORD
57
58
  your Ionoscloud password (required)
58
-
59
59
  ```
60
60
 
61
61
  ## Example
62
62
 
63
- knife ionoscloud volume create --datacenter-id DATACENTER_ID --name NAME --size SIZE --bus BUS --image ID --image-alias IMAGE_ALIAS --image-password PASSWORD --type TYPE --licence-type LICENCE --ssh-keys SSHKEY1,SSHKEY2,... --availability-zone AVAILABILITY_ZONE --username USERNAME --password PASSWORD
63
+ ```text
64
+ knife ionoscloud volume create --datacenter-id DATACENTER_ID --name NAME --size SIZE --bus BUS --image ID --image-alias IMAGE_ALIAS --image-password PASSWORD --type TYPE --licence-type LICENCE --ssh-keys SSHKEY1,SSHKEY2,... --availability-zone AVAILABILITY_ZONE --username USERNAME --password PASSWORD
65
+ ```
66
+
@@ -2,18 +2,19 @@
2
2
 
3
3
  Deletes the specified volume. This will result in the volume being removed from your virtual data center. Please use this with caution!
4
4
 
5
- knife ionoscloud volume delete SERVER_ID [SERVER_ID] (options)
6
-
5
+ ```text
6
+ knife ionoscloud volume delete SERVER_ID [SERVER_ID] (options)
7
+ ```
7
8
 
8
9
  ## Available options:
9
- ---
10
10
 
11
11
  ### Required options:
12
- * datacenter_id
13
- * ionoscloud_username
14
- * ionoscloud_password
15
12
 
16
- ```
13
+ * datacenter\_id
14
+ * ionoscloud\_username
15
+ * ionoscloud\_password
16
+
17
+ ```text
17
18
  datacenter_id: --datacenter-id DATACENTER_ID, -D DATACENTER_ID
18
19
  name of the data center (required)
19
20
 
@@ -22,9 +23,11 @@ Deletes the specified volume. This will result in the volume being removed from
22
23
 
23
24
  ionoscloud_password: --password PASSWORD, -p PASSWORD
24
25
  your Ionoscloud password (required)
25
-
26
26
  ```
27
27
 
28
28
  ## Example
29
29
 
30
- knife ionoscloud volume delete SERVER_ID
30
+ ```text
31
+ knife ionoscloud volume delete SERVER_ID
32
+ ```
33
+
@@ -4,19 +4,20 @@ This will detach the volume from the server. Depending on the volume HotUnplug s
4
4
 
5
5
  This will NOT delete the volume from your virtual data center. You will need to make a separate request to delete a volume.
6
6
 
7
- knife ionoscloud volume detach VOLUME_ID [VOLUME_ID] (options)
8
-
7
+ ```text
8
+ knife ionoscloud volume detach VOLUME_ID [VOLUME_ID] (options)
9
+ ```
9
10
 
10
11
  ## Available options:
11
- ---
12
12
 
13
13
  ### Required options:
14
- * datacenter_id
15
- * server_id
16
- * ionoscloud_username
17
- * ionoscloud_password
18
14
 
19
- ```
15
+ * datacenter\_id
16
+ * server\_id
17
+ * ionoscloud\_username
18
+ * ionoscloud\_password
19
+
20
+ ```text
20
21
  datacenter_id: --datacenter-id DATACENTER_ID, -D DATACENTER_ID
21
22
  the ID of the data center (required)
22
23
 
@@ -28,9 +29,11 @@ This will NOT delete the volume from your virtual data center. You will need to
28
29
 
29
30
  ionoscloud_password: --password PASSWORD, -p PASSWORD
30
31
  your Ionoscloud password (required)
31
-
32
32
  ```
33
33
 
34
34
  ## Example
35
35
 
36
- knife ionoscloud volume detach VOLUME_ID
36
+ ```text
37
+ knife ionoscloud volume detach VOLUME_ID
38
+ ```
39
+
@@ -2,18 +2,19 @@
2
2
 
3
3
  List all available volumes under a data center. You can also list all volumes attached to a specific server.
4
4
 
5
- knife ionoscloud volume list (options)
6
-
5
+ ```text
6
+ knife ionoscloud volume list (options)
7
+ ```
7
8
 
8
9
  ## Available options:
9
- ---
10
10
 
11
11
  ### Required options:
12
- * datacenter_id
13
- * ionoscloud_username
14
- * ionoscloud_password
15
12
 
16
- ```
13
+ * datacenter\_id
14
+ * ionoscloud\_username
15
+ * ionoscloud\_password
16
+
17
+ ```text
17
18
  datacenter_id: --datacenter-id DATACENTER_ID, -D DATACENTER_ID
18
19
  the ID of the virtul data center containing the volume (required)
19
20
 
@@ -25,9 +26,11 @@ List all available volumes under a data center. You can also list all volumes at
25
26
 
26
27
  ionoscloud_password: --password PASSWORD, -p PASSWORD
27
28
  your Ionoscloud password (required)
28
-
29
29
  ```
30
30
 
31
31
  ## Example
32
32
 
33
- knife ionoscloud volume list --datacenter-id DATACENTER_ID --server-id SERVER_ID --username USERNAME --password PASSWORD
33
+ ```text
34
+ knife ionoscloud volume list --datacenter-id DATACENTER_ID --server-id SERVER_ID --username USERNAME --password PASSWORD
35
+ ```
36
+