knife-ionoscloud 5.0.0.beta.1 → 5.0.0

Sign up to get free protection for your applications and to get access to all the features.
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
+