diff --git a/cmd/scw/testdata/test-all-usage-account-project-create-usage.golden b/cmd/scw/testdata/test-all-usage-account-project-create-usage.golden index d000ed69d2..33ca4fd3c9 100644 --- a/cmd/scw/testdata/test-all-usage-account-project-create-usage.golden +++ b/cmd/scw/testdata/test-all-usage-account-project-create-usage.golden @@ -1,13 +1,13 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Create project. +Generate a new Project for an Organization, specifying its configuration including name and description. USAGE: scw account project create [arg=value ...] ARGS: - [name] The name of the project - [description] The description of the project + [name] Name of the Project + [description] Description of the Project [organization-id] Organization ID to use. If none is passed the default organization ID will be used FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-account-project-delete-usage.golden b/cmd/scw/testdata/test-all-usage-account-project-delete-usage.golden index 13bffbff9e..60ba230c6d 100644 --- a/cmd/scw/testdata/test-all-usage-account-project-delete-usage.golden +++ b/cmd/scw/testdata/test-all-usage-account-project-delete-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Delete project. +Delete an existing Project, specified by its Project ID. The Project needs to be empty (meaning there are no resources left in it) to be deleted effectively. Note that deleting a Project is permanent, and cannot be undone. USAGE: scw account project delete [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-account-project-get-usage.golden b/cmd/scw/testdata/test-all-usage-account-project-get-usage.golden index c63e207218..e32a50be2a 100644 --- a/cmd/scw/testdata/test-all-usage-account-project-get-usage.golden +++ b/cmd/scw/testdata/test-all-usage-account-project-get-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Get project. +Retrieve information about an existing Project, specified by its Project ID. Its full details, including ID, name and description, are returned in the response object. USAGE: scw account project get [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-account-project-list-usage.golden b/cmd/scw/testdata/test-all-usage-account-project-list-usage.golden index 0dd6617b70..caeb4ed68d 100644 --- a/cmd/scw/testdata/test-all-usage-account-project-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-account-project-list-usage.golden @@ -1,14 +1,14 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -List projects. +List all Projects of an Organization. The response will include the total number of Projects as well as their associated Organizations, names and IDs. Other information include the creation and update date of the Project. USAGE: scw account project list [arg=value ...] ARGS: - [name] The name of the project - [order-by] The sort order of the returned projects (created_at_asc | created_at_desc | name_asc | name_desc) - [project-ids.{index}] Filter out by a list of project ID + [name] Name of the Project + [order-by] Sort order of the returned Projects (created_at_asc | created_at_desc | name_asc | name_desc) + [project-ids.{index}] Project IDs to filter for. The results will be limited to any Projects with an ID in this array [organization-id] Organization ID to use. If none is passed the default organization ID will be used FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-account-project-update-usage.golden b/cmd/scw/testdata/test-all-usage-account-project-update-usage.golden index 1c279bac6e..c3a6acdd0a 100644 --- a/cmd/scw/testdata/test-all-usage-account-project-update-usage.golden +++ b/cmd/scw/testdata/test-all-usage-account-project-update-usage.golden @@ -1,14 +1,14 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Update project. +Update the parameters of an existing Project, specified by its Project ID. These parameters include the name and description. USAGE: scw account project update [arg=value ...] ARGS: [project-id] Project ID to use. If none is passed the default project ID will be used - [name] The name of the project - [description] The description of the project + [name] Name of the Project + [description] Description of the Project FLAGS: -h, --help help for update diff --git a/cmd/scw/testdata/test-all-usage-account-project-usage.golden b/cmd/scw/testdata/test-all-usage-account-project-usage.golden index 2f0d6a2a41..fb5cde849a 100644 --- a/cmd/scw/testdata/test-all-usage-account-project-usage.golden +++ b/cmd/scw/testdata/test-all-usage-account-project-usage.golden @@ -6,11 +6,11 @@ USAGE: scw account project AVAILABLE COMMANDS: - create Create project - delete Delete project - get Get project - list List projects - update Update project + create Create a new Project for an Organization + delete Delete an existing Project + get Get an existing Project + list List all Projects of an Organization + update Update Project FLAGS: -h, --help help for project diff --git a/cmd/scw/testdata/test-all-usage-apple-silicon-os-get-usage.golden b/cmd/scw/testdata/test-all-usage-apple-silicon-os-get-usage.golden index cbddc61009..070b906ef3 100644 --- a/cmd/scw/testdata/test-all-usage-apple-silicon-os-get-usage.golden +++ b/cmd/scw/testdata/test-all-usage-apple-silicon-os-get-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Get an Operating System (OS). +Get an Operating System (OS). The response will include the OS's unique ID as well as its name and label. USAGE: scw apple-silicon os get [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-apple-silicon-os-list-usage.golden b/cmd/scw/testdata/test-all-usage-apple-silicon-os-list-usage.golden index 20e2805df8..782891f300 100644 --- a/cmd/scw/testdata/test-all-usage-apple-silicon-os-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-apple-silicon-os-list-usage.golden @@ -1,13 +1,13 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -List all Operating System (OS). +List all Operating System (OS). The response will include the total number of OS as well as their associated IDs, names and labels. USAGE: scw apple-silicon os list [arg=value ...] ARGS: - [server-type] List of compatible server type - [name] Filter os by name (for eg. "11.1" will return "11.1.2" and "11.1" but not "12") + [server-type] List of compatible server types + [name] Filter OS by name (note that "11.1" will return "11.1.2" and "11.1" but not "12")) [zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-3 | all) FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-apple-silicon-server-create-usage.golden b/cmd/scw/testdata/test-all-usage-apple-silicon-server-create-usage.golden index f22d5bbcea..87750a3378 100644 --- a/cmd/scw/testdata/test-all-usage-apple-silicon-server-create-usage.golden +++ b/cmd/scw/testdata/test-all-usage-apple-silicon-server-create-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Create a server. +Create a new server in the targeted zone, specifying its configuration including name and type. USAGE: scw apple-silicon server create [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-apple-silicon-server-delete-usage.golden b/cmd/scw/testdata/test-all-usage-apple-silicon-server-delete-usage.golden index 4f4fef3ac8..3fc28af370 100644 --- a/cmd/scw/testdata/test-all-usage-apple-silicon-server-delete-usage.golden +++ b/cmd/scw/testdata/test-all-usage-apple-silicon-server-delete-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Delete a server. +Delete an existing Apple silicon server, specified by its server ID. Deleting a server is permanent, and cannot be undone. Note that the minimum allocation period for Apple silicon-as-a-service is 24 hours, meaning you cannot delete your server prior to that. USAGE: scw apple-silicon server delete [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-apple-silicon-server-get-usage.golden b/cmd/scw/testdata/test-all-usage-apple-silicon-server-get-usage.golden index 31f2f5b0d6..bc8866dfa5 100644 --- a/cmd/scw/testdata/test-all-usage-apple-silicon-server-get-usage.golden +++ b/cmd/scw/testdata/test-all-usage-apple-silicon-server-get-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Get a server. +Retrieve information about an existing Apple silicon server, specified by its server ID. Its full details, including name, status and IP address, are returned in the response object. USAGE: scw apple-silicon server get [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-apple-silicon-server-list-usage.golden b/cmd/scw/testdata/test-all-usage-apple-silicon-server-list-usage.golden index 39d3fed8b1..fcbf0fccd7 100644 --- a/cmd/scw/testdata/test-all-usage-apple-silicon-server-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-apple-silicon-server-list-usage.golden @@ -1,14 +1,14 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -List all servers. +List all servers in the specified zone. By default, returned servers in the list are ordered by creation date in ascending order, though this can be modified via the `order_by` field. USAGE: scw apple-silicon server list [arg=value ...] ARGS: - [order-by] The sort order of the returned servers (created_at_asc | created_at_desc) - [project-id] List only servers of this project ID - [organization-id] List only servers of this organization ID + [order-by] Sort order of the returned servers (created_at_asc | created_at_desc) + [project-id] Only list servers of this project ID + [organization-id] Only list servers of this Organization ID [zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-3 | all) FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-apple-silicon-server-reboot-usage.golden b/cmd/scw/testdata/test-all-usage-apple-silicon-server-reboot-usage.golden index 89077f2231..eb2a99bec0 100644 --- a/cmd/scw/testdata/test-all-usage-apple-silicon-server-reboot-usage.golden +++ b/cmd/scw/testdata/test-all-usage-apple-silicon-server-reboot-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Reboot a server. +Reboot an existing Apple silicon server, specified by its server ID. USAGE: scw apple-silicon server reboot [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-apple-silicon-server-reinstall-usage.golden b/cmd/scw/testdata/test-all-usage-apple-silicon-server-reinstall-usage.golden index 7ada701b1f..d10b268554 100644 --- a/cmd/scw/testdata/test-all-usage-apple-silicon-server-reinstall-usage.golden +++ b/cmd/scw/testdata/test-all-usage-apple-silicon-server-reinstall-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Reinstall a server. +Reinstall an existing Apple silicon server (specified by its server ID) from a new image (OS). All the data on the disk is deleted and all configuration is reset to the defailt configuration values of the image (OS). USAGE: scw apple-silicon server reinstall [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-apple-silicon-server-type-list-usage.golden b/cmd/scw/testdata/test-all-usage-apple-silicon-server-type-list-usage.golden index 8e52343351..37fbe942a2 100644 --- a/cmd/scw/testdata/test-all-usage-apple-silicon-server-type-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-apple-silicon-server-type-list-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -List all server types technical details. +List all technical details about Apple silicon server types available in the specified zone. Since there is only one Availability Zone for Apple silicon servers, the targeted value is `fr-par-3`. USAGE: scw apple-silicon server-type list [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-apple-silicon-server-update-usage.golden b/cmd/scw/testdata/test-all-usage-apple-silicon-server-update-usage.golden index d56f83bcde..752bcc9873 100644 --- a/cmd/scw/testdata/test-all-usage-apple-silicon-server-update-usage.golden +++ b/cmd/scw/testdata/test-all-usage-apple-silicon-server-update-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Update a server. +Update the parameters of an existing Apple silicon server, specified by its server ID. USAGE: scw apple-silicon server update [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-apple-silicon-usage.golden b/cmd/scw/testdata/test-all-usage-apple-silicon-usage.golden index 7a2fc8ac4e..827c4d0661 100644 --- a/cmd/scw/testdata/test-all-usage-apple-silicon-usage.golden +++ b/cmd/scw/testdata/test-all-usage-apple-silicon-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Scaleway Apple silicon M1 as-a-Service is built using the latest generation of Apple Mac mini hardware (fifth generation). +Scaleway Apple silicon as-a-Service is built using the latest generation of Apple Mac mini hardware (fifth generation). These dedicated Mac mini M1s are designed for developing, building, testing, and signing applications for Apple devices, including iPhones, iPads, Mac computers and much more. diff --git a/cmd/scw/testdata/test-all-usage-baremetal-bmc-get-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-bmc-get-usage.golden index 5de14e8cc1..488632dc95 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-bmc-get-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-bmc-get-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Get the BMC (Baseboard Management Controller) access associated with the given ID. +Get the BMC (Baseboard Management Controller) access associated with the ID, including the URL and login information needed to connect. USAGE: scw baremetal bmc get [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-baremetal-bmc-start-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-bmc-start-usage.golden index 8d8e2fb0e5..5f72b5319f 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-bmc-start-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-bmc-start-usage.golden @@ -1,16 +1,16 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Start BMC (Baseboard Management Controller) access associated with the given ID. +Start BMC (Baseboard Management Controller) access associated with the ID. The BMC (Baseboard Management Controller) access is available one hour after the installation of the server. -You need first to create an option Remote Access. You will find the ID and the price with a call to listOffers (https://developers.scaleway.com/en/products/baremetal/api/#get-78db92). Then you can add the option https://developers.scaleway.com/en/products/baremetal/api/#post-b14abd. Do not forget to delete the Option. - After start BMC, you need to Get Remote Access to get the login/password https://developers.scaleway.com/en/products/baremetal/api/#get-cefc0f. +You need first to create an option Remote Access. You will find the ID and the price with a call to listOffers (https://developers.scaleway.com/en/products/baremetal/api/#get-78db92). Then add the option https://developers.scaleway.com/en/products/baremetal/api/#post-b14abd. +After adding the BMC option, you need to Get Remote Access to get the login/password https://developers.scaleway.com/en/products/baremetal/api/#get-cefc0f. Do not forget to delete the Option after use. USAGE: scw baremetal bmc start [arg=value ...] ARGS: server-id ID of the server - ip The IP authorized to connect to the given server + ip The IP authorized to connect to the server [zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1) FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-bmc-stop-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-bmc-stop-usage.golden index 5b80504107..657b5713b1 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-bmc-stop-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-bmc-stop-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Stop BMC (Baseboard Management Controller) access associated with the given ID. +Stop BMC (Baseboard Management Controller) access associated with the ID. USAGE: scw baremetal bmc stop [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-baremetal-bmc-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-bmc-usage.golden index 3b614fbe49..0cfd22824d 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-bmc-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-bmc-usage.golden @@ -1,8 +1,8 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Baseboard Management Controller (BMC) allows you to remotely access the low-level parameters of your dedicated server. +A Baseboard Management Controller (BMC) allows you to remotely access the low-level parameters of your dedicated server. For instance, your KVM-IP management console could be accessed with it. -You need first to create an option Remote Access. You will find the ID and the price with a call to listOffers (https://developers.scaleway.com/en/products/baremetal/api/#get-78db92). Then you can add the option https://developers.scaleway.com/en/products/baremetal/api/#post-b14abd. Do not forget to delete the Option. +You need first to create an Remote Access option. You will find the ID and the price with a call to listOffers (https://developers.scaleway.com/en/products/baremetal/api/#get-78db92). Then you can add the option https://developers.scaleway.com/en/products/baremetal/api/#post-b14abd. Do not forget to delete the Option. Then you need to create Remote Access https://developers.scaleway.com/en/products/baremetal/api/#post-1af723. And finally Get Remote Access to get the login/password https://developers.scaleway.com/en/products/baremetal/api/#get-cefc0f. @@ -10,9 +10,9 @@ USAGE: scw baremetal bmc AVAILABLE COMMANDS: - get Get BMC (Baseboard Management Controller) access for a given elastic metal server - start Start BMC (Baseboard Management Controller) access for a given elastic metal server - stop Stop BMC (Baseboard Management Controller) access for a given elastic metal server + get Get BMC access + start Start BMC access + stop Stop BMC access FLAGS: -h, --help help for bmc diff --git a/cmd/scw/testdata/test-all-usage-baremetal-offer-get-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-offer-get-usage.golden index b50bdd686f..138ed2b327 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-offer-get-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-offer-get-usage.golden @@ -1,12 +1,12 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Return specific offer for the given ID. +Get details of an offer identified by its offer ID. USAGE: scw baremetal offer get [arg=value ...] EXAMPLES: - Get a server offer with the given ID + Get a server offer with the ID scw baremetal offer get zone=fr-par-1 offer-id=11111111-1111-1111-1111-111111111111 ARGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-offer-list-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-offer-list-usage.golden index 1b006bea7f..d2d5b79d91 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-offer-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-offer-list-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -List all available server offers. +List all available Elastic Metal server configurations. USAGE: scw baremetal offer list [arg=value ...] @@ -13,7 +13,7 @@ EXAMPLES: scw baremetal offer list zone=fr-par-1 ARGS: - [subscription-period] Period of subscription to filter offers (unknown_subscription_period | hourly | monthly) + [subscription-period] Subscription period type to filter offers by (unknown_subscription_period | hourly | monthly) [zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | all) FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-offer-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-offer-usage.golden index eebfb497ad..91cda9b120 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-offer-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-offer-usage.golden @@ -1,7 +1,7 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Server offers will answer with all different elastic metal server ranges available in a given zone. -Each of them will contain all the features of the server (cpus, memories, disks) with their associated pricing. +Server offers will answer with all different Elastic Metal server ranges available in a zone. +Each of them will contain all the features of the server (CPUs, memory, disks) with their associated pricing. USAGE: scw baremetal offer diff --git a/cmd/scw/testdata/test-all-usage-baremetal-options-add-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-options-add-usage.golden index 9dcbcdeef9..d9d23da3d8 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-options-add-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-options-add-usage.golden @@ -1,12 +1,12 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Add an option to a specific server. +Add an option, such as Private Networks, to a specific server. USAGE: scw baremetal options add [arg=value ...] EXAMPLES: - Add a given option to a server + Add an option, such as Private Networks, to a server scw baremetal options add server-id=11111111-1111-1111-1111-111111111111 option-id=11111111-1111-1111-1111-111111111111 ARGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-options-delete-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-options-delete-usage.golden index 08ac84e850..011caccdb4 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-options-delete-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-options-delete-usage.golden @@ -6,7 +6,7 @@ USAGE: scw baremetal options delete [arg=value ...] EXAMPLES: - Delete a given option from a server + Delete an option from a server scw baremetal options delete server-id=11111111-1111-1111-1111-111111111111 option-id=11111111-1111-1111-1111-111111111111 ARGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-options-get-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-options-get-usage.golden index c15a463a18..cadabeda2c 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-options-get-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-options-get-usage.golden @@ -1,12 +1,12 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Return specific option for the given ID. +Return specific option for the ID. USAGE: scw baremetal options get [arg=value ...] EXAMPLES: - Get a server option with the given ID + Get a server option with the ID scw baremetal options get zone=fr-par-1 option-id=11111111-1111-1111-1111-111111111111 ARGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-options-list-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-options-list-usage.golden index fe2a2490d2..73ddd5783b 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-options-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-options-list-usage.golden @@ -13,8 +13,8 @@ EXAMPLES: scw baremetal options list zone=fr-par-1 ARGS: - [offer-id] Filter options by offer_id - [name] Filter options by name + [offer-id] Offer ID to filter options for + [name] Name to filter options for [zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | all) FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-os-get-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-os-get-usage.golden index 18e165d64d..819418d6f3 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-os-get-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-os-get-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Return specific OS for the given ID. +Return specific OS for the ID. USAGE: scw baremetal os get [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-baremetal-os-list-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-os-list-usage.golden index 893e8ca90d..28475daab4 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-os-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-os-list-usage.golden @@ -1,12 +1,12 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -List all available OS that can be install on an elastic metal server. +List all OSes that are available for installation on Elastic Metal servers. USAGE: scw baremetal os list [arg=value ...] ARGS: - [offer-id] Filter OS by offer ID + [offer-id] Offer IDs to filter OSes for [zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | all) FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-os-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-os-usage.golden index 2aa107b545..0ddace3b44 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-os-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-os-usage.golden @@ -6,8 +6,8 @@ USAGE: scw baremetal os AVAILABLE COMMANDS: - get Get an OS with a given ID - list List all available OS that can be install on an elastic metal server + get Get an OS with an ID + list List available OSes FLAGS: -h, --help help for os diff --git a/cmd/scw/testdata/test-all-usage-baremetal-private-network-add-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-private-network-add-usage.golden index ab5aff89b1..53843dc7d4 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-private-network-add-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-private-network-add-usage.golden @@ -1,13 +1,13 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Add a server to a private network. +Add a server to a Private Network. USAGE: scw baremetal private-network add [arg=value ...] ARGS: server-id The ID of the server - private-network-id The ID of the private network + private-network-id The ID of the Private Network [zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-2) FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-private-network-delete-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-private-network-delete-usage.golden index dff147520d..5e22593518 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-private-network-delete-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-private-network-delete-usage.golden @@ -1,13 +1,13 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Delete a private network. +Delete a Private Network. USAGE: scw baremetal private-network delete [arg=value ...] ARGS: server-id The ID of the server - private-network-id The ID of the private network + private-network-id The ID of the Private Network [zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-2) FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-private-network-list-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-private-network-list-usage.golden index fa4c1eb32a..86244d0be9 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-private-network-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-private-network-list-usage.golden @@ -1,16 +1,16 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -List the private networks of a server. +List the Private Networks of a server. USAGE: scw baremetal private-network list [arg=value ...] ARGS: - [order-by] The sort order for the returned private networks (created_at_asc | created_at_desc | updated_at_asc | updated_at_desc) - [server-id] Filter private networks by server ID - [private-network-id] Filter private networks by private network ID - [project-id] Filter private networks by project ID - [organization-id] Filter private networks by organization ID + [order-by] The sort order for the returned Private Networks (created_at_asc | created_at_desc | updated_at_asc | updated_at_desc) + [server-id] Filter Private Networks by server ID + [private-network-id] Filter Private Networks by Private Network ID + [project-id] Filter Private Networks by Project ID + [organization-id] Filter Private Networks by Organization ID [zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-2 | all) FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-private-network-set-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-private-network-set-usage.golden index 3eed231053..798f2943c6 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-private-network-set-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-private-network-set-usage.golden @@ -1,13 +1,13 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Set multiple private networks on a server. +Set multiple Private Networks on a server. USAGE: scw baremetal private-network set [arg=value ...] ARGS: server-id The ID of the server - private-network-ids.{index} The IDs of the private networks + private-network-ids.{index} The IDs of the Private Networks [zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-2) FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-private-network-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-private-network-usage.golden index f6b5935b72..bc00da6321 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-private-network-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-private-network-usage.golden @@ -1,22 +1,22 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -A private network allows interconnecting your resources +A Private Network allows you to interconnect your resources (servers, instances, ...) in an isolated and private network. The network reachability is limited to the -resources that are on the same private network. A VLAN +resources that are on the same Private Network . A VLAN interface is available on the server and can be freely managed (adding IP addresses, shutdown interface...). -Note that a resource can be a part of multiple private networks. +Note that a resource can be a part of multiple Private Networks. USAGE: scw baremetal private-network AVAILABLE COMMANDS: - add Add a server to a private network - delete Delete a private network - list List the private networks of a server - set Set multiple private networks on a server + add Add a server to a Private Network + delete Delete a Private Network + list List the Private Networks of a server + set Set multiple Private Networks on a server FLAGS: -h, --help help for private-network diff --git a/cmd/scw/testdata/test-all-usage-baremetal-server-create-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-server-create-usage.golden index 0a4fb87b78..48d9024663 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-server-create-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-server-create-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Create a new elastic metal server. Once the server is created, you probably want to install an OS. +Create a new Elastic Metal server. Once the server is created, proceed with the [installation of an OS](#post-3e949e). USAGE: scw baremetal server create [arg=value ...] @@ -12,15 +12,15 @@ EXAMPLES: ARGS: [project-id] Project ID to use. If none is passed the default project ID will be used name= Name of the server (β‰ hostname) - [description] Description associated to the server, max 255 characters + [description] Description associated with the server, max 255 characters [type] Server commercial type [tags.{index}] Tags to associate to the server - [install.os-id] ID of the OS to install on the server + [install.os-id] ID of the OS to installation on the server [install.hostname] Hostname of the server [install.ssh-key-ids.{index}] SSH key IDs authorized on the server - [install.user] User used for the installation - [install.password] Password used for the installation - [install.service-user] User used for the service to install + [install.user] User for the installation + [install.password] Password for the installation + [install.service-user] Regular user that runs the service to be installed on the server [install.service-password] Password used for the service to install [option-ids.{index}] IDs of options to enable on server [organization-id] Organization ID to use. If none is passed the default organization ID will be used diff --git a/cmd/scw/testdata/test-all-usage-baremetal-server-delete-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-server-delete-usage.golden index b362e3572b..67d7edbdb8 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-server-delete-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-server-delete-usage.golden @@ -1,12 +1,12 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Delete the server associated with the given ID. +Delete the server associated with the ID. USAGE: scw baremetal server delete [arg=value ...] EXAMPLES: - Delete an elastic metal server + Delete an Elastic Metal server scw baremetal server delete 11111111-1111-1111-1111-111111111111 ARGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-server-get-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-server-get-usage.golden index e13f2e8b57..172eefff98 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-server-get-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-server-get-usage.golden @@ -1,12 +1,12 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Get the server associated with the given ID. +Get full details of an existing Elastic Metal server associated with the ID. USAGE: scw baremetal server get [arg=value ...] EXAMPLES: - Get a given server + Get a specific server scw baremetal server get 11111111-1111-1111-1111-111111111111 ARGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-server-install-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-server-install-usage.golden index 47e60ab285..2696472720 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-server-install-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-server-install-usage.golden @@ -1,17 +1,17 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Install an OS on the server associated with the given ID. +Install an Operating System (OS) on the Elastic Metal server with a specific ID. USAGE: scw baremetal server install [arg=value ...] EXAMPLES: - Install an OS on a given server with a particular SSH key ID + Install an OS on a server with a particular SSH key ID scw baremetal server install 11111111-1111-1111-1111-111111111111 os-id=11111111-1111-1111-1111-111111111111 ssh-key-ids.0=11111111-1111-1111-1111-111111111111 ARGS: server-id Server ID to install - os-id ID of the OS to install on the server + os-id ID of the OS to installation on the server hostname Hostname of the server [all-ssh-keys] Add all SSH keys on your baremetal instance (cannot be used with ssh-key-ids) ssh-key-ids.{index} SSH key IDs authorized on the server (cannot be used with all-ssh-keys) @@ -38,5 +38,5 @@ SEE ALSO: # List OS (useful to get all OS IDs) scw baremetal os list - # Create an elastic metal server + # Create an Elastic Metal server scw baremetal server create diff --git a/cmd/scw/testdata/test-all-usage-baremetal-server-list-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-server-list-usage.golden index 01b8fb856a..5830929aed 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-server-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-server-list-usage.golden @@ -1,22 +1,22 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -List elastic metal servers for organization. +List Elastic Metal servers for a specific organization. USAGE: scw baremetal server list [arg=value ...] EXAMPLES: - List all servers on your default zone + List all servers in your default zone scw baremetal server list ARGS: [order-by] Order of the servers (created_at_asc | created_at_desc) - [tags.{index}] Filter by tags - [status.{index}] Filter by status - [name] Filter by name - [project-id] Filter by project ID - [option-id] Filter by option ID - [organization-id] Filter by organization ID + [tags.{index}] Tags to filter for + [status.{index}] Status to filter for + [name] Names to filter for + [project-id] Project ID to filter for + [option-id] Option ID to filter for + [organization-id] Organization ID to filter for [zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | all) FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-server-reboot-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-server-reboot-usage.golden index b1db450bf9..35f7fb2738 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-server-reboot-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-server-reboot-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Reboot the server associated with the given ID, use boot param to reboot in rescue. +Reboot the Elastic Metal server associated with the ID, use the `boot_type` `rescue` to reboot the server in rescue mode. USAGE: scw baremetal server reboot [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-baremetal-server-start-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-server-start-usage.golden index 7c8c156c49..3792c4bc4e 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-server-start-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-server-start-usage.golden @@ -1,12 +1,12 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Start the server associated with the given ID. +Start the server associated with the ID. USAGE: scw baremetal server start [arg=value ...] EXAMPLES: - Start an elastic metal server + Start an Elastic Metalx server scw baremetal server start 11111111-1111-1111-1111-111111111111 Start a server in rescue mode diff --git a/cmd/scw/testdata/test-all-usage-baremetal-server-stop-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-server-stop-usage.golden index 3b56d5121b..bebab979b1 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-server-stop-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-server-stop-usage.golden @@ -1,12 +1,12 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Stop the server associated with the given ID. +Stop the server associated with the ID. The server remains allocated to your account and all data remains on the local storage of the server. USAGE: scw baremetal server stop [arg=value ...] EXAMPLES: - Stop an elastic metal server + Stop an Elastic Metal server scw baremetal server stop 11111111-1111-1111-1111-111111111111 ARGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-server-update-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-server-update-usage.golden index 67575dd5ff..219cbfa544 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-server-update-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-server-update-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Update the server associated with the given ID. +Update the server associated with the ID. You can update parameters such as the server's name, tags and description. Any parameters left null in the request body are not updated. USAGE: scw baremetal server update [arg=value ...] @@ -8,8 +8,8 @@ USAGE: ARGS: server-id ID of the server to update [name] Name of the server (β‰ hostname), not updated if null - [description] Description associated to the server, max 255 characters, not updated if null - [tags.{index}] Tags associated to the server, not updated if null + [description] Description associated with the server, max 255 characters, not updated if null + [tags.{index}] Tags associated with the server, not updated if null [zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1) FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-server-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-server-usage.golden index fb85035899..0283e2af72 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-server-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-server-usage.golden @@ -6,15 +6,15 @@ USAGE: scw baremetal server AVAILABLE COMMANDS: - create Create an elastic metal server - delete Delete an elastic metal server - get Get a specific elastic metal server - install Install an elastic metal server - list List elastic metal servers for organization - reboot Reboot an elastic metal server - start Start an elastic metal server - stop Stop an elastic metal server - update Update an elastic metal server + create Create an Elastic Metal server + delete Delete an Elastic Metal server + get Get a specific Elastic Metal server + install Install an Elastic Metal server + list List Elastic Metal servers for an organization + reboot Reboot an Elastic Metal server + start Start an Elastic Metal server + stop Stop an Elastic Metal server + update Update an Elastic Metal server WORKFLOW COMMANDS: wait Wait for a server to reach a stable state (delivery and installation) diff --git a/cmd/scw/testdata/test-all-usage-baremetal-settings-list-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-settings-list-usage.golden index ab21d0a4ed..446f6fe1ff 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-settings-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-settings-list-usage.golden @@ -6,7 +6,7 @@ USAGE: scw baremetal settings list [arg=value ...] ARGS: - [order-by] Order the response (created_at_asc | created_at_desc) + [order-by] Sort order for items in the response (created_at_asc | created_at_desc) project-id ID of the project [zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1 | all) diff --git a/cmd/scw/testdata/test-all-usage-baremetal-settings-update-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-settings-update-usage.golden index eef90512c8..ddc0b888a9 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-settings-update-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-settings-update-usage.golden @@ -7,7 +7,7 @@ USAGE: ARGS: setting-id ID of the setting - [enabled] Enable/Disable the setting + [enabled] Defines whether the setting is enabled [zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | nl-ams-1) FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-baremetal-settings-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-settings-usage.golden index 9c615d666e..dd50124c81 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-settings-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-settings-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Allows to configure the general settings for your elastic metal server. +Allows to configure the general settings for your Elastic Metal server. USAGE: scw baremetal settings diff --git a/cmd/scw/testdata/test-all-usage-baremetal-usage.golden b/cmd/scw/testdata/test-all-usage-baremetal-usage.golden index d052421709..5dc1b1e6b8 100644 --- a/cmd/scw/testdata/test-all-usage-baremetal-usage.golden +++ b/cmd/scw/testdata/test-all-usage-baremetal-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -This API allows to manage your Bare metal server. +This API allows to manage your Elastic Metal server. USAGE: scw baremetal @@ -10,7 +10,7 @@ AVAILABLE COMMANDS: offer Server offer management commands options Server options management commands os Operating System (OS) management commands - private-network Private network management command + private-network Private Network management command server Server management commands settings Settings management commands diff --git a/cmd/scw/testdata/test-all-usage-iam-api-key-create-usage.golden b/cmd/scw/testdata/test-all-usage-iam-api-key-create-usage.golden index 2f8b1d87fe..f9ca79e01a 100644 --- a/cmd/scw/testdata/test-all-usage-iam-api-key-create-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-api-key-create-usage.golden @@ -1,16 +1,16 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Create an API key. +Create an API key. You must specify the `application_id` or the `user_id` and the description. You can also specify the `default_project_id` which is the Project ID of your preferred Project, to use with Object Storage. The `access_key` and `secret_key` values are returned in the response. Note that he secret key is only showed once. Make sure that you copy and store both keys somewhere safe. USAGE: scw iam api-key create [arg=value ...] ARGS: - [application-id] ID of application principal - [user-id] ID of user principal + [application-id] ID of the application + [user-id] ID of the user [expires-at] Expiration date of the API key - [default-project-id] The default project ID to use with object storage - [description] The description of the API key (max length is 200 chars) + [default-project-id] The default Project ID to use with Object Storage + [description] The description of the API key (max length is 200 characters) FLAGS: -h, --help help for create diff --git a/cmd/scw/testdata/test-all-usage-iam-api-key-delete-usage.golden b/cmd/scw/testdata/test-all-usage-iam-api-key-delete-usage.golden index 80bc936b66..a4b84d1dac 100644 --- a/cmd/scw/testdata/test-all-usage-iam-api-key-delete-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-api-key-delete-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Delete an API key. +Delete an API key. Note that this action is irreversible and cannot be undone. Make sure you update any configurations using the API keys you delete. USAGE: scw iam api-key delete [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-iam-api-key-get-usage.golden b/cmd/scw/testdata/test-all-usage-iam-api-key-get-usage.golden index e4e199542f..94eb577609 100644 --- a/cmd/scw/testdata/test-all-usage-iam-api-key-get-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-api-key-get-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Get an API key. +Retrive information about an API key, specified by the `access_key` parameter. The API key's details, including either the `user_id` or `application_id` of its bearer are returned in the response. Note that the string value for the `secret_key` is nullable, and therefore is not displayed in the response. The `secret_key` value is only displayed upon API key creation. USAGE: scw iam api-key get [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-iam-api-key-list-usage.golden b/cmd/scw/testdata/test-all-usage-iam-api-key-list-usage.golden index d36d04675a..da76760858 100644 --- a/cmd/scw/testdata/test-all-usage-iam-api-key-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-api-key-list-usage.golden @@ -1,23 +1,23 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -List API keys. +List API keys. By default, the API keys listed are ordered by creation date in ascending order. This can be modified via the `order_by` field. You can define additional parameters for your query such as `editable`, `expired`, `access_key` and `bearer_id`. USAGE: scw iam api-key list [arg=value ...] ARGS: [order-by=created_at_asc] Criteria for sorting results (created_at_asc | created_at_desc | updated_at_asc | updated_at_desc | expires_at_asc | expires_at_desc | access_key_asc | access_key_desc) - [editable] Filter out editable API keys or not - [expired] Filter out expired API keys or not - [access-key] Filter out by access key - [description] Filter out by description - [bearer-id] Filter out by bearer ID - [bearer-type] Filter out by type of bearer (unknown_bearer_type | user | application) - organization-id= ID of organization + [editable] Whether to filter out editable API keys or not + [expired] Whether to filter out expired API keys or not + [access-key] Filter by access key + [description] Filter by description + [bearer-id] Filter by bearer ID + [bearer-type] Filter by type of bearer (unknown_bearer_type | user | application) + organization-id= ID of Organization DEPRECATED ARGS: - [application-id] ID of an application bearer - [user-id] ID of a user bearer + [application-id] ID of application that bears the API key + [user-id] ID of user that bears the API key FLAGS: -h, --help help for list diff --git a/cmd/scw/testdata/test-all-usage-iam-api-key-update-usage.golden b/cmd/scw/testdata/test-all-usage-iam-api-key-update-usage.golden index b4a1a9a6a1..96ad5e7d0c 100644 --- a/cmd/scw/testdata/test-all-usage-iam-api-key-update-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-api-key-update-usage.golden @@ -1,13 +1,13 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Update an API key. +Update the parameters of an API key, including `default_project_id` and `description`. USAGE: scw iam api-key update [arg=value ...] ARGS: access-key Access key to update - [default-project-id] The new default project ID to set + [default-project-id] The new default Project ID to set [description] The new description to update FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-iam-application-create-usage.golden b/cmd/scw/testdata/test-all-usage-iam-application-create-usage.golden index ac80669596..5c179c758c 100644 --- a/cmd/scw/testdata/test-all-usage-iam-application-create-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-application-create-usage.golden @@ -1,13 +1,13 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Create a new application. +Create a new application. You must define the `name` parameter in the request. USAGE: scw iam application create [arg=value ...] ARGS: - name= Name of application to create (max length is 64 chars) - [description] Description of application (max length is 200 chars) + name= Name of the application to create (max length is 64 characters) + [description] Description of the application (max length is 200 characters) [organization-id] Organization ID to use. If none is passed the default organization ID will be used FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-iam-application-delete-usage.golden b/cmd/scw/testdata/test-all-usage-iam-application-delete-usage.golden index 6200aecf94..9990c0248d 100644 --- a/cmd/scw/testdata/test-all-usage-iam-application-delete-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-application-delete-usage.golden @@ -1,12 +1,12 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Delete an application. +Delete an application. Note that this action is irreversible and will automatically delete the application's API keys. Policies attached to users and applications via this group will no longer apply. USAGE: scw iam application delete [arg=value ...] ARGS: - application-id ID of application to delete + application-id ID of the application to delete FLAGS: -h, --help help for delete diff --git a/cmd/scw/testdata/test-all-usage-iam-application-get-usage.golden b/cmd/scw/testdata/test-all-usage-iam-application-get-usage.golden index d37c2a9fdb..8d23933f3e 100644 --- a/cmd/scw/testdata/test-all-usage-iam-application-get-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-application-get-usage.golden @@ -1,12 +1,12 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Get an existing application. +Retrieve information about an application, specified by the `application_id` parameter. The application's full details, including `id`, `email`, `organization_id`, `status` and `two_factor_enabled` are returned in the response. USAGE: scw iam application get [arg=value ...] ARGS: - application-id ID of application to find + application-id ID of the application to find FLAGS: -h, --help help for get diff --git a/cmd/scw/testdata/test-all-usage-iam-application-list-usage.golden b/cmd/scw/testdata/test-all-usage-iam-application-list-usage.golden index 2d49c02457..c1dc73f72d 100644 --- a/cmd/scw/testdata/test-all-usage-iam-application-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-application-list-usage.golden @@ -1,16 +1,16 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -List applications of an organization. +List the applications of an Organization. By default, the applications listed are ordered by creation date in ascending order. This can be modified via the `order_by` field. You must define the `organization_id` in the query path of your request. You can also define additional parameters for your query such as `application_ids`. USAGE: scw iam application list [arg=value ...] ARGS: [order-by=created_at_asc] Criteria for sorting results (created_at_asc | created_at_desc | updated_at_asc | updated_at_desc | name_asc | name_desc) - [name] Name of application to filter - [editable] Filter out editable applications or not - [application-ids.{index}] Filter out by a list of ID - organization-id= ID of organization to filter + [name] Name of the application to filter + [editable] Whether to filter out editable applications or not + [application-ids.{index}] Filter by list of IDs + organization-id= ID of the Organization to filter FLAGS: -h, --help help for list diff --git a/cmd/scw/testdata/test-all-usage-iam-application-update-usage.golden b/cmd/scw/testdata/test-all-usage-iam-application-update-usage.golden index 75557e4ec7..56a129cc95 100644 --- a/cmd/scw/testdata/test-all-usage-iam-application-update-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-application-update-usage.golden @@ -1,14 +1,14 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Update an existing application. +Update the parameters of an application, including `name` and `description`. USAGE: scw iam application update [arg=value ...] ARGS: - application-id ID of application to update - [name] New name of application (max length is 64 chars) - [description] New description of application (max length is 200 chars) + application-id ID of the application to update + [name] New name for the application (max length is 64 chars) + [description] New description for the application (max length is 200 chars) FLAGS: -h, --help help for update diff --git a/cmd/scw/testdata/test-all-usage-iam-application-usage.golden b/cmd/scw/testdata/test-all-usage-iam-application-usage.golden index cfdf6cf489..ad25a55e3e 100644 --- a/cmd/scw/testdata/test-all-usage-iam-application-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-application-usage.golden @@ -8,9 +8,9 @@ USAGE: AVAILABLE COMMANDS: create Create a new application delete Delete an application - get Get an existing application - list List applications of an organization - update Update an existing application + get Get a given application + list List applications of an Organization + update Update an application FLAGS: -h, --help help for application diff --git a/cmd/scw/testdata/test-all-usage-iam-group-add-member-usage.golden b/cmd/scw/testdata/test-all-usage-iam-group-add-member-usage.golden index 3fd069bb52..4371d1dc8d 100644 --- a/cmd/scw/testdata/test-all-usage-iam-group-add-member-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-group-add-member-usage.golden @@ -1,12 +1,12 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Add a user of an application to a group. +Add a user or an application to a group. You can specify a `user_id` and and `application_id` in the body of your request. Note that you can only add one of each per request. USAGE: scw iam group add-member [arg=value ...] ARGS: - group-id ID of group + group-id ID of the group [user-id] ID of the user to add [application-id] ID of the application to add diff --git a/cmd/scw/testdata/test-all-usage-iam-group-create-usage.golden b/cmd/scw/testdata/test-all-usage-iam-group-create-usage.golden index ebb41d8d55..64c9e993c3 100644 --- a/cmd/scw/testdata/test-all-usage-iam-group-create-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-group-create-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Create a new group. +Create a new group. You must define the `name` and `organization_id` parameters in the request. USAGE: scw iam group create [arg=value ...] @@ -10,7 +10,7 @@ EXAMPLES: scw iam group create name=foobar ARGS: - name= Name of the group to create (max length is 64 chars). MUST be unique inside an organization + name= Name of the group to create (max length is 64 chars). MUST be unique inside an Organization [description] Description of the group to create (max length is 200 chars) [organization-id] Organization ID to use. If none is passed the default organization ID will be used diff --git a/cmd/scw/testdata/test-all-usage-iam-group-delete-usage.golden b/cmd/scw/testdata/test-all-usage-iam-group-delete-usage.golden index fe2f32c785..0ba7042221 100644 --- a/cmd/scw/testdata/test-all-usage-iam-group-delete-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-group-delete-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Delete a group. +Delete a group. Note that this action is irreversible and could delete permissions for group members. Policies attached to users and applications via this group will no longer apply. USAGE: scw iam group delete [arg=value ...] @@ -10,7 +10,7 @@ EXAMPLES: scw iam group delete 11111111-1111-1111-1111-111111111111 ARGS: - group-id ID of group to delete + group-id ID of the group to delete FLAGS: -h, --help help for delete diff --git a/cmd/scw/testdata/test-all-usage-iam-group-get-usage.golden b/cmd/scw/testdata/test-all-usage-iam-group-get-usage.golden index dd9964eb40..626a3455b4 100644 --- a/cmd/scw/testdata/test-all-usage-iam-group-get-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-group-get-usage.golden @@ -1,12 +1,12 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Get a group. +Retrive information about a given group, specified by the `group_id` parameter. The group's full details, including `user_ids` and `application_ids` are returned in the response. USAGE: scw iam group get [arg=value ...] ARGS: - group-id ID of group + group-id ID of the group FLAGS: -h, --help help for get diff --git a/cmd/scw/testdata/test-all-usage-iam-group-list-usage.golden b/cmd/scw/testdata/test-all-usage-iam-group-list-usage.golden index 448cc44b55..9acd546555 100644 --- a/cmd/scw/testdata/test-all-usage-iam-group-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-group-list-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -List groups. +List groups. By default, the groups listed are ordered by creation date in ascending order. This can be modified via the `order_by` field. You can define additional parameters to filter your query. Use `user_ids` or `application_ids` to list all groups certain users or applications belong to. USAGE: scw iam group list [arg=value ...] @@ -8,10 +8,10 @@ USAGE: ARGS: [order-by=created_at_asc] Sort order of groups (created_at_asc | created_at_desc | updated_at_asc | updated_at_desc | name_asc | name_desc) [name] Name of group to find - [application-ids.{index}] Filter out by a list of application ID - [user-ids.{index}] Filter out by a list of user ID - [group-ids.{index}] Filter out by a list of group ID - [organization-id=] Filter by organization ID + [application-ids.{index}] Filter by a list of application IDs + [user-ids.{index}] Filter by a list of user IDs + [group-ids.{index}] Filter by a list of group IDs + [organization-id=] Filter by Organization ID FLAGS: -h, --help help for list diff --git a/cmd/scw/testdata/test-all-usage-iam-group-remove-member-usage.golden b/cmd/scw/testdata/test-all-usage-iam-group-remove-member-usage.golden index 3c6e4b4306..151c05c46a 100644 --- a/cmd/scw/testdata/test-all-usage-iam-group-remove-member-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-group-remove-member-usage.golden @@ -1,12 +1,12 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Remove a user or an application from a group. +Remove a user or an application from a group. You can specify a `user_id` and and `application_id` in the body of your request. Note that you can only remove one of each per request. Removing a user from a group means that any permissions given to them via the group (i.e. from an attached policy) will no longer apply. Be sure you want to remove these permissions from the user before proceeding. USAGE: scw iam group remove-member [arg=value ...] ARGS: - group-id ID of group + group-id ID of the group [user-id] ID of the user to remove [application-id] ID of the application to remove diff --git a/cmd/scw/testdata/test-all-usage-iam-group-update-usage.golden b/cmd/scw/testdata/test-all-usage-iam-group-update-usage.golden index d5f910787a..e198f86c11 100644 --- a/cmd/scw/testdata/test-all-usage-iam-group-update-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-group-update-usage.golden @@ -1,13 +1,13 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Update a group. +Update the parameters of group, including `name` and `description`. USAGE: scw iam group update [arg=value ...] ARGS: - group-id ID of group to update - [name] New name for the group (max length is 64 chars). MUST be unique inside an organization + group-id ID of the group to update + [name] New name for the group (max length is 64 chars). MUST be unique inside an Organization [description] New description for the group (max length is 200 chars) FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-iam-group-usage.golden b/cmd/scw/testdata/test-all-usage-iam-group-usage.golden index e694ef5c71..76279215b1 100644 --- a/cmd/scw/testdata/test-all-usage-iam-group-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-group-usage.golden @@ -6,8 +6,8 @@ USAGE: scw iam group AVAILABLE COMMANDS: - add-member Add a user of an application to a group - create Create a new group + add-member Add a user or an application to a group + create Create a group delete Delete a group get Get a group list List groups diff --git a/cmd/scw/testdata/test-all-usage-iam-permission-set-list-usage.golden b/cmd/scw/testdata/test-all-usage-iam-permission-set-list-usage.golden index a433300654..61966e7efb 100644 --- a/cmd/scw/testdata/test-all-usage-iam-permission-set-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-permission-set-list-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -List permission sets. +List permission sets available for given Organization. You must define the `organization_id` in the query path of your request. USAGE: scw iam permission-set list [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-iam-policy-create-usage.golden b/cmd/scw/testdata/test-all-usage-iam-policy-create-usage.golden index 3bdd14acc9..6e4068af22 100644 --- a/cmd/scw/testdata/test-all-usage-iam-policy-create-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-policy-create-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Create a new policy. +Create a new application. You must define the `name` parameter in the request. You can specify parameters such as `user_id`, `groups_id`, `application_id`, `no_principal`, `rules` and its child attributes. USAGE: scw iam policy create [arg=value ...] @@ -10,15 +10,15 @@ EXAMPLES: scw iam policy create group-id=11111111-1111-1111-1111-111111111111 rules.0.organization-id=11111111-1111-1111-1111-111111111111 rules.0.permission-set-names.0=InstanceFullAccess ARGS: - name= Name of policy to create (max length is 64 chars) - [description] Description of policy to create (max length is 200 chars) + name= Name of the policy to create (max length is 64 characters) + [description] Description of the policy to create (max length is 200 characters) [rules.{index}.permission-set-names.{index}] Names of permission sets bound to the rule - [rules.{index}.project-ids.{index}] List of project IDs scoped to the rule - [rules.{index}.organization-id] ID of organization scoped to the rule - [user-id] ID of user, owner of the policy - [group-id] ID of group, owner of the policy - [application-id] ID of application, owner of the policy - [no-principal] True when the policy do not belong to any principal + [rules.{index}.project-ids.{index}] List of Project IDs the rule is scoped to + [rules.{index}.organization-id] ID of Organization the rule is scoped to + [user-id] ID of user attributed to the policy + [group-id] ID of group attributed to the policy + [application-id] ID of application attributed to the policy + [no-principal] Whether or not a policy is attributed to a principal [organization-id] Organization ID to use. If none is passed the default organization ID will be used FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-iam-policy-delete-usage.golden b/cmd/scw/testdata/test-all-usage-iam-policy-delete-usage.golden index 5cbea3a638..c24ab57904 100644 --- a/cmd/scw/testdata/test-all-usage-iam-policy-delete-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-policy-delete-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Delete a policy. +Delete a policy. You must define specify the `policy_id` parameter in your request. Note that when deleting a policy, all permissions it gives to its principal (user, group or application) will be revoked. USAGE: scw iam policy delete [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-iam-policy-get-usage.golden b/cmd/scw/testdata/test-all-usage-iam-policy-get-usage.golden index a7e44927ed..2a929574fb 100644 --- a/cmd/scw/testdata/test-all-usage-iam-policy-get-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-policy-get-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Get an existing policy. +Retrieve information about a policy, speficified by the `policy_id` parameter. The policy's full details, including `id`, `name`, `organization_id`, `nb_rules` and `nb_scopes`, `nb_permission_sets` are returned in the response. USAGE: scw iam policy get [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-iam-policy-list-usage.golden b/cmd/scw/testdata/test-all-usage-iam-policy-list-usage.golden index 2ca71ee787..51ce1b1138 100644 --- a/cmd/scw/testdata/test-all-usage-iam-policy-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-policy-list-usage.golden @@ -1,19 +1,19 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -List policies of an organization. +List the policies of an Organization. By default, the policies listed are ordered by creation date in ascending order. This can be modified via the `order_by` field. You must define the `organization_id` in the query path of your request. You can also define additional parameters to filter your query, such as `user_ids`, `groups_ids`, `application_ids`, and `policy_name`. USAGE: scw iam policy list [arg=value ...] ARGS: [order-by=created_at_asc] Criteria for sorting results (policy_name_asc | policy_name_desc | created_at_asc | created_at_desc) - [editable] Filter out editable policies or not - [user-ids.{index}] Filter out by a list of user ID - [group-ids.{index}] Filter out by a list of group ID - [application-ids.{index}] Filter out by a list of application ID - [no-principal] True when the policy do not belong to any principal - [policy-name] Name of policy to fetch - organization-id= ID of organization to filter + [editable] Whether or not filter out editable policies + [user-ids.{index}] Whether or not to filter by list of user IDs + [group-ids.{index}] Whether or not to filter by list of group IDs + [application-ids.{index}] Filter by a list of application IDs + [no-principal] Whether or not the policy is attributed to a principal + [policy-name] Name of the policy to fetch + organization-id= ID of the Organization to filter FLAGS: -h, --help help for list diff --git a/cmd/scw/testdata/test-all-usage-iam-policy-update-usage.golden b/cmd/scw/testdata/test-all-usage-iam-policy-update-usage.golden index 0fc1704a8e..01981cac02 100644 --- a/cmd/scw/testdata/test-all-usage-iam-policy-update-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-policy-update-usage.golden @@ -1,18 +1,18 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Update an existing policy. +Update the parameters of a policy, including `name`, `description`, `user_id`, `group_id`, `application_id` and `no_principal`. USAGE: scw iam policy update [arg=value ...] ARGS: policy-id Id of policy to update - [name] New name of policy (max length is 64 chars) - [description] New description of policy (max length is 200 chars) - [user-id] New ID of user, owner of the policy - [group-id] New ID of group, owner of the policy - [application-id] New ID of application, owner of the policy - [no-principal] True when the policy do not belong to any principal + [name] New name for the policy (max length is 64 characters) + [description] New description of policy (max length is 200 characters) + [user-id] New ID of user attributed to the policy + [group-id] New ID of group attributed to the policy + [application-id] New ID of application attributed to the policy + [no-principal] Whether or not the policy is attributed to a principal FLAGS: -h, --help help for update diff --git a/cmd/scw/testdata/test-all-usage-iam-policy-usage.golden b/cmd/scw/testdata/test-all-usage-iam-policy-usage.golden index 8f2ab22203..fd96596526 100644 --- a/cmd/scw/testdata/test-all-usage-iam-policy-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-policy-usage.golden @@ -9,7 +9,7 @@ AVAILABLE COMMANDS: create Create a new policy delete Delete a policy get Get an existing policy - list List policies of an organization + list List policies of an Organization update Update an existing policy FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-iam-rule-list-usage.golden b/cmd/scw/testdata/test-all-usage-iam-rule-list-usage.golden index cfbbfd9705..ec8ea1f1fe 100644 --- a/cmd/scw/testdata/test-all-usage-iam-rule-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-rule-list-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -List rules of an existing policy. +List the rules of a given policy. By default, the rules listed are ordered by creation date in ascending order. This can be modified via the `order_by` field. You must define the `policy_id` in the query path of your request. USAGE: scw iam rule list [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-iam-rule-update-usage.golden b/cmd/scw/testdata/test-all-usage-iam-rule-update-usage.golden index 471498fac9..01e1d55399 100644 --- a/cmd/scw/testdata/test-all-usage-iam-rule-update-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-rule-update-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Set rules of an existing policy. +Overwrite the rules of a given policy. Any information that you add using this command will overwrite the previous configuration. If you include some of the rules you already had in your previous configuration in your new one, but you change their order, the new order of display will apply. While policy rules are ordered, they have no impact on the access logic of IAM because rules are allow-only. USAGE: scw iam rule update [arg=value ...] @@ -8,8 +8,8 @@ USAGE: ARGS: policy-id Id of policy to update [rules.{index}.permission-set-names.{index}] Names of permission sets bound to the rule - [rules.{index}.project-ids.{index}] List of project IDs scoped to the rule - [rules.{index}.organization-id] ID of organization scoped to the rule + [rules.{index}.project-ids.{index}] List of Project IDs the rule is scoped to + [rules.{index}.organization-id] ID of Organization the rule is scoped to FLAGS: -h, --help help for update diff --git a/cmd/scw/testdata/test-all-usage-iam-rule-usage.golden b/cmd/scw/testdata/test-all-usage-iam-rule-usage.golden index 19e7e20b40..b44ead2da5 100644 --- a/cmd/scw/testdata/test-all-usage-iam-rule-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-rule-usage.golden @@ -6,8 +6,8 @@ USAGE: scw iam rule AVAILABLE COMMANDS: - list List rules of an existing policy - update Set rules of an existing policy + list List rules of a given policy + update Set rules of a given policy FLAGS: -h, --help help for rule diff --git a/cmd/scw/testdata/test-all-usage-iam-ssh-key-create-usage.golden b/cmd/scw/testdata/test-all-usage-iam-ssh-key-create-usage.golden index 036bddbbab..62b51cfd56 100644 --- a/cmd/scw/testdata/test-all-usage-iam-ssh-key-create-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-ssh-key-create-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Create an SSH key. +Add a new SSH key to a Scaleway Project. You must specify the `name`, `public_key` and `project_id`. USAGE: scw iam ssh-key create [arg=value ...] @@ -11,7 +11,7 @@ EXAMPLES: ARGS: name= The name of the SSH key. Max length is 1000 - public-key SSH public key. Currently ssh-rsa, ssh-dss (DSA), ssh-ed25519 and ecdsa keys with NIST curves are supported. Max length is 65000 + public-key SSH public key. Currently only the ssh-rsa, ssh-dss (DSA), ssh-ed25519 and ecdsa keys with NIST curves are supported. Max length is 65000 [project-id] Project ID to use. If none is passed the default project ID will be used FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-iam-ssh-key-delete-usage.golden b/cmd/scw/testdata/test-all-usage-iam-ssh-key-delete-usage.golden index 106519a235..4c2d553cef 100644 --- a/cmd/scw/testdata/test-all-usage-iam-ssh-key-delete-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-ssh-key-delete-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Delete an SSH key. +Delete a given SSH key, specified by the `ssh_key_id`. Deleting an SSH is permanent, and cannot be undone. Note that you might need to update any configurations that used the SSH key. USAGE: scw iam ssh-key delete [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-iam-ssh-key-get-usage.golden b/cmd/scw/testdata/test-all-usage-iam-ssh-key-get-usage.golden index d590f8e110..31012af018 100644 --- a/cmd/scw/testdata/test-all-usage-iam-ssh-key-get-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-ssh-key-get-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Get an SSH key. +Retrieve information about a given SSH key, specified by the `ssh_key_id` parameter. The SSH key's full details, including `id`, `name`, `public_key`, and `project_id` are returned in the response. USAGE: scw iam ssh-key get [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-iam-ssh-key-list-usage.golden b/cmd/scw/testdata/test-all-usage-iam-ssh-key-list-usage.golden index 8ebf6ec623..1fd3f42390 100644 --- a/cmd/scw/testdata/test-all-usage-iam-ssh-key-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-ssh-key-list-usage.golden @@ -1,16 +1,16 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -List SSH keys. +List SSH keys. By default, the SSH keys listed are ordered by creation date in ascending order. This can be modified via the `order_by` field. You can define additional parameters for your query such as `organization_id`, `name`, `project_id` and `disabled`. USAGE: scw iam ssh-key list [arg=value ...] ARGS: - [order-by=created_at_asc] Sort order of SSH keys (created_at_asc | created_at_desc | updated_at_asc | updated_at_desc | name_asc | name_desc) + [order-by=created_at_asc] Sort order of the SSH keys (created_at_asc | created_at_desc | updated_at_asc | updated_at_desc | name_asc | name_desc) [name] Name of group to find - [project-id] Filter by project ID - [disabled] Filter out disabled SSH keys or not - [organization-id=] Filter by organization ID + [project-id] Filter by Project ID + [disabled] Whether to include disabled SSH keys or not + [organization-id=] Filter by Organization ID FLAGS: -h, --help help for list diff --git a/cmd/scw/testdata/test-all-usage-iam-ssh-key-update-usage.golden b/cmd/scw/testdata/test-all-usage-iam-ssh-key-update-usage.golden index 9e5e41f9d4..de9658fe5e 100644 --- a/cmd/scw/testdata/test-all-usage-iam-ssh-key-update-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-ssh-key-update-usage.golden @@ -1,6 +1,6 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Update an SSH key. +Update the parameters of an SSH key, including `name` and `disable`. USAGE: scw iam ssh-key update [arg=value ...] diff --git a/cmd/scw/testdata/test-all-usage-iam-user-delete-usage.golden b/cmd/scw/testdata/test-all-usage-iam-user-delete-usage.golden index 40a53617a6..72068dc454 100644 --- a/cmd/scw/testdata/test-all-usage-iam-user-delete-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-user-delete-usage.golden @@ -1,12 +1,12 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Delete a guest user from an organization. +Remove a user from an Organization in which they are a guest. You must define the `user_id` in your request. Note that removing a user from an Organization automatically deletes their API keys, and any policies directly attached to them become orphaned. USAGE: scw iam user delete [arg=value ...] ARGS: - user-id ID of user to delete + user-id ID of the user to delete FLAGS: -h, --help help for delete diff --git a/cmd/scw/testdata/test-all-usage-iam-user-get-usage.golden b/cmd/scw/testdata/test-all-usage-iam-user-get-usage.golden index 61505fa634..1a8e39681f 100644 --- a/cmd/scw/testdata/test-all-usage-iam-user-get-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-user-get-usage.golden @@ -1,12 +1,12 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -Retrieve a user from its ID. +Retrieve information about a user, specified by the `user_id` parameter. The user's full details, including `id`, `email`, `organization_id`, `status` and `two_factor_enabled` are returned in the response. USAGE: scw iam user get [arg=value ...] ARGS: - user-id ID of user to find + user-id ID of the user to find FLAGS: -h, --help help for get diff --git a/cmd/scw/testdata/test-all-usage-iam-user-list-usage.golden b/cmd/scw/testdata/test-all-usage-iam-user-list-usage.golden index e8df8d223c..142ba09203 100644 --- a/cmd/scw/testdata/test-all-usage-iam-user-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-user-list-usage.golden @@ -1,14 +1,14 @@ 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲 πŸŸ₯πŸŸ₯πŸŸ₯ STDERR️️ πŸŸ₯πŸŸ₯πŸŸ₯️ -List users of an organization. +List the users of an Organization. By default, the users listed are ordered by creation date in ascending order. This can be modified via the `order_by` field. You must define the `organization_id` in the query path of your request. You can also define additional parameters for your query such as `user_ids`. USAGE: scw iam user list [arg=value ...] ARGS: [order-by=created_at_asc] Criteria for sorting results (created_at_asc | created_at_desc | updated_at_asc | updated_at_desc | email_asc | email_desc | last_login_asc | last_login_desc) - [user-ids.{index}] Filter out by a list of ID - organization-id= ID of organization to filter + [user-ids.{index}] Filter by list of IDs + organization-id= ID of the Organization to filter FLAGS: -h, --help help for list diff --git a/cmd/scw/testdata/test-all-usage-iam-user-usage.golden b/cmd/scw/testdata/test-all-usage-iam-user-usage.golden index 3d6bcca258..0e2eccec68 100644 --- a/cmd/scw/testdata/test-all-usage-iam-user-usage.golden +++ b/cmd/scw/testdata/test-all-usage-iam-user-usage.golden @@ -6,9 +6,9 @@ USAGE: scw iam user AVAILABLE COMMANDS: - delete Delete a guest user from an organization - get Retrieve a user from its ID - list List users of an organization + delete Delete a guest user from an Organization + get Get a given user + list List users of an Organization FLAGS: -h, --help help for user diff --git a/cmd/scw/testdata/test-all-usage-tem-domain-create-usage.golden b/cmd/scw/testdata/test-all-usage-tem-domain-create-usage.golden index 2d7751a1b7..0e70ba7d6b 100644 --- a/cmd/scw/testdata/test-all-usage-tem-domain-create-usage.golden +++ b/cmd/scw/testdata/test-all-usage-tem-domain-create-usage.golden @@ -7,7 +7,8 @@ USAGE: ARGS: [project-id] Project ID to use. If none is passed the default project ID will be used - [domain-name] + [domain-name] Fully qualified domain dame + [accept-tos] Accept the Scaleway Terms of Service [region=fr-par] Region to target. If none is passed will use default region from the config (fr-par) FLAGS: diff --git a/cmd/scw/testdata/test-all-usage-tem-email-list-usage.golden b/cmd/scw/testdata/test-all-usage-tem-email-list-usage.golden index 340ba696ba..16218ff987 100644 --- a/cmd/scw/testdata/test-all-usage-tem-email-list-usage.golden +++ b/cmd/scw/testdata/test-all-usage-tem-email-list-usage.golden @@ -14,6 +14,7 @@ ARGS: [mail-from] Optional, list emails sent with this `mail_from` sender's address [mail-to] Optional, list emails sent with this `mail_to` recipient's address [statuses.{index}] Optional, list emails having any of this status (unknown | new | sending | sent | failed | canceled) + [subject] Optional, list emails having this subject [region=fr-par] Region to target. If none is passed will use default region from the config (fr-par | all) FLAGS: diff --git a/cmd/scw/testdata/test-main-usage-usage.golden b/cmd/scw/testdata/test-main-usage-usage.golden index 26b7faed33..2939e4a6f2 100644 --- a/cmd/scw/testdata/test-main-usage-usage.golden +++ b/cmd/scw/testdata/test-main-usage-usage.golden @@ -7,7 +7,7 @@ AVAILABLE COMMANDS: account User related data apple-silicon Apple silicon API autocomplete Autocomplete related commands - baremetal Elastic metal API + baremetal Elastic Metal API cockpit Cockpit API container Container as a Service API dns DNS API diff --git a/docs/commands/account.md b/docs/commands/account.md index 1ceae6b494..df0095feab 100644 --- a/docs/commands/account.md +++ b/docs/commands/account.md @@ -3,11 +3,11 @@ This API allows you to manage projects. - [Project management commands](#project-management-commands) - - [Create project](#create-project) - - [Delete project](#delete-project) - - [Get project](#get-project) - - [List projects](#list-projects) - - [Update project](#update-project) + - [Create a new Project for an Organization](#create-a-new-project-for-an-organization) + - [Delete an existing Project](#delete-an-existing-project) + - [Get an existing Project](#get-an-existing-project) + - [List all Projects of an Organization](#list-all-projects-of-an-organization) + - [Update Project](#update-project) ## Project management commands @@ -15,9 +15,9 @@ This API allows you to manage projects. Project management commands. -### Create project +### Create a new Project for an Organization -Create project. +Generate a new Project for an Organization, specifying its configuration including name and description. **Usage:** @@ -30,15 +30,15 @@ scw account project create [arg=value ...] | Name | | Description | |------|---|-------------| -| name | | The name of the project | -| description | | The description of the project | +| name | | Name of the Project | +| description | | Description of the Project | | organization-id | | Organization ID to use. If none is passed the default organization ID will be used | -### Delete project +### Delete an existing Project -Delete project. +Delete an existing Project, specified by its Project ID. The Project needs to be empty (meaning there are no resources left in it) to be deleted effectively. Note that deleting a Project is permanent, and cannot be undone. **Usage:** @@ -55,9 +55,9 @@ scw account project delete [arg=value ...] -### Get project +### Get an existing Project -Get project. +Retrieve information about an existing Project, specified by its Project ID. Its full details, including ID, name and description, are returned in the response object. **Usage:** @@ -74,9 +74,9 @@ scw account project get [arg=value ...] -### List projects +### List all Projects of an Organization -List projects. +List all Projects of an Organization. The response will include the total number of Projects as well as their associated Organizations, names and IDs. Other information include the creation and update date of the Project. **Usage:** @@ -89,16 +89,16 @@ scw account project list [arg=value ...] | Name | | Description | |------|---|-------------| -| name | | The name of the project | -| order-by | One of: `created_at_asc`, `created_at_desc`, `name_asc`, `name_desc` | The sort order of the returned projects | -| project-ids.{index} | | Filter out by a list of project ID | +| name | | Name of the Project | +| order-by | One of: `created_at_asc`, `created_at_desc`, `name_asc`, `name_desc` | Sort order of the returned Projects | +| project-ids.{index} | | Project IDs to filter for. The results will be limited to any Projects with an ID in this array | | organization-id | | Organization ID to use. If none is passed the default organization ID will be used | -### Update project +### Update Project -Update project. +Update the parameters of an existing Project, specified by its Project ID. These parameters include the name and description. **Usage:** @@ -112,8 +112,8 @@ scw account project update [arg=value ...] | Name | | Description | |------|---|-------------| | project-id | | Project ID to use. If none is passed the default project ID will be used | -| name | | The name of the project | -| description | | The description of the project | +| name | | Name of the Project | +| description | | Description of the Project | diff --git a/docs/commands/apple-silicon.md b/docs/commands/apple-silicon.md index 43e2d60a1d..5e238ee173 100644 --- a/docs/commands/apple-silicon.md +++ b/docs/commands/apple-silicon.md @@ -1,6 +1,6 @@ # Documentation for `scw apple-silicon` -Scaleway Apple silicon M1 as-a-Service is built using the latest generation of Apple Mac mini hardware (fifth generation). +Scaleway Apple silicon as-a-Service is built using the latest generation of Apple Mac mini hardware (fifth generation). These dedicated Mac mini M1s are designed for developing, building, testing, and signing applications for Apple devices, including iPhones, iPads, Mac computers and much more. @@ -37,7 +37,7 @@ OS management commands ### Get an Operating System (OS) -Get an Operating System (OS). +Get an Operating System (OS). The response will include the OS's unique ID as well as its name and label. **Usage:** @@ -57,7 +57,7 @@ scw apple-silicon os get [arg=value ...] ### List all Operating System (OS) -List all Operating System (OS). +List all Operating System (OS). The response will include the total number of OS as well as their associated IDs, names and labels. **Usage:** @@ -70,8 +70,8 @@ scw apple-silicon os list [arg=value ...] | Name | | Description | |------|---|-------------| -| server-type | | List of compatible server type | -| name | | Filter os by name (for eg. "11.1" will return "11.1.2" and "11.1" but not "12") | +| server-type | | List of compatible server types | +| name | | Filter OS by name (note that "11.1" will return "11.1.2" and "11.1" but not "12")) | | zone | Default: `fr-par-1`
One of: `fr-par-3`, `all` | Zone to target. If none is passed will use default zone from the config | @@ -83,7 +83,7 @@ Apple silicon management commands ### Create a server -Create a server. +Create a new server in the targeted zone, specifying its configuration including name and type. **Usage:** @@ -105,7 +105,7 @@ scw apple-silicon server create [arg=value ...] ### Delete a server -Delete a server. +Delete an existing Apple silicon server, specified by its server ID. Deleting a server is permanent, and cannot be undone. Note that the minimum allocation period for Apple silicon-as-a-service is 24 hours, meaning you cannot delete your server prior to that. **Usage:** @@ -125,7 +125,7 @@ scw apple-silicon server delete [arg=value ...] ### Get a server -Get a server. +Retrieve information about an existing Apple silicon server, specified by its server ID. Its full details, including name, status and IP address, are returned in the response object. **Usage:** @@ -145,7 +145,7 @@ scw apple-silicon server get [arg=value ...] ### List all servers -List all servers. +List all servers in the specified zone. By default, returned servers in the list are ordered by creation date in ascending order, though this can be modified via the `order_by` field. **Usage:** @@ -158,16 +158,16 @@ scw apple-silicon server list [arg=value ...] | Name | | Description | |------|---|-------------| -| order-by | One of: `created_at_asc`, `created_at_desc` | The sort order of the returned servers | -| project-id | | List only servers of this project ID | -| organization-id | | List only servers of this organization ID | +| order-by | One of: `created_at_asc`, `created_at_desc` | Sort order of the returned servers | +| project-id | | Only list servers of this project ID | +| organization-id | | Only list servers of this Organization ID | | zone | Default: `fr-par-1`
One of: `fr-par-3`, `all` | Zone to target. If none is passed will use default zone from the config | ### Reboot a server -Reboot a server. +Reboot an existing Apple silicon server, specified by its server ID. **Usage:** @@ -187,7 +187,7 @@ scw apple-silicon server reboot [arg=value ...] ### Reinstall a server -Reinstall a server. +Reinstall an existing Apple silicon server (specified by its server ID) from a new image (OS). All the data on the disk is deleted and all configuration is reset to the defailt configuration values of the image (OS). **Usage:** @@ -230,7 +230,7 @@ scw apple-silicon server ssh [arg=value ...] ### Update a server -Update a server. +Update the parameters of an existing Apple silicon server, specified by its server ID. **Usage:** @@ -306,7 +306,7 @@ scw apple-silicon server-type get [arg=value ...] ### List server types -List all server types technical details. +List all technical details about Apple silicon server types available in the specified zone. Since there is only one Availability Zone for Apple silicon servers, the targeted value is `fr-par-3`. **Usage:** diff --git a/docs/commands/baremetal.md b/docs/commands/baremetal.md index 9f8542128b..a0188bdc62 100644 --- a/docs/commands/baremetal.md +++ b/docs/commands/baremetal.md @@ -1,11 +1,11 @@ # Documentation for `scw baremetal` -This API allows to manage your Bare metal server. +This API allows to manage your Elastic Metal server. - [Baseboard Management Controller (BMC) management commands](#baseboard-management-controller-(bmc)-management-commands) - - [Get BMC (Baseboard Management Controller) access for a given elastic metal server](#get-bmc-(baseboard-management-controller)-access-for-a-given-elastic-metal-server) - - [Start BMC (Baseboard Management Controller) access for a given elastic metal server](#start-bmc-(baseboard-management-controller)-access-for-a-given-elastic-metal-server) - - [Stop BMC (Baseboard Management Controller) access for a given elastic metal server](#stop-bmc-(baseboard-management-controller)-access-for-a-given-elastic-metal-server) + - [Get BMC access](#get-bmc-access) + - [Start BMC access](#start-bmc-access) + - [Stop BMC access](#stop-bmc-access) - [Server offer management commands](#server-offer-management-commands) - [Get offer](#get-offer) - [List offers](#list-offers) @@ -15,23 +15,23 @@ This API allows to manage your Bare metal server. - [Get option](#get-option) - [List options](#list-options) - [Operating System (OS) management commands](#operating-system-(os)-management-commands) - - [Get an OS with a given ID](#get-an-os-with-a-given-id) - - [List all available OS that can be install on an elastic metal server](#list-all-available-os-that-can-be-install-on-an-elastic-metal-server) -- [Private network management command](#private-network-management-command) - - [Add a server to a private network](#add-a-server-to-a-private-network) - - [Delete a private network](#delete-a-private-network) - - [List the private networks of a server](#list-the-private-networks-of-a-server) - - [Set multiple private networks on a server](#set-multiple-private-networks-on-a-server) + - [Get an OS with an ID](#get-an-os-with-an-id) + - [List available OSes](#list-available-oses) +- [Private Network management command](#private-network-management-command) + - [Add a server to a Private Network](#add-a-server-to-a-private-network) + - [Delete a Private Network](#delete-a-private-network) + - [List the Private Networks of a server](#list-the-private-networks-of-a-server) + - [Set multiple Private Networks on a server](#set-multiple-private-networks-on-a-server) - [Server management commands](#server-management-commands) - - [Create an elastic metal server](#create-an-elastic-metal-server) - - [Delete an elastic metal server](#delete-an-elastic-metal-server) - - [Get a specific elastic metal server](#get-a-specific-elastic-metal-server) - - [Install an elastic metal server](#install-an-elastic-metal-server) - - [List elastic metal servers for organization](#list-elastic-metal-servers-for-organization) - - [Reboot an elastic metal server](#reboot-an-elastic-metal-server) - - [Start an elastic metal server](#start-an-elastic-metal-server) - - [Stop an elastic metal server](#stop-an-elastic-metal-server) - - [Update an elastic metal server](#update-an-elastic-metal-server) + - [Create an Elastic Metal server](#create-an-elastic-metal-server) + - [Delete an Elastic Metal server](#delete-an-elastic-metal-server) + - [Get a specific Elastic Metal server](#get-a-specific-elastic-metal-server) + - [Install an Elastic Metal server](#install-an-elastic-metal-server) + - [List Elastic Metal servers for an organization](#list-elastic-metal-servers-for-an-organization) + - [Reboot an Elastic Metal server](#reboot-an-elastic-metal-server) + - [Start an Elastic Metal server](#start-an-elastic-metal-server) + - [Stop an Elastic Metal server](#stop-an-elastic-metal-server) + - [Update an Elastic Metal server](#update-an-elastic-metal-server) - [Wait for a server to reach a stable state (delivery and installation)](#wait-for-a-server-to-reach-a-stable-state-(delivery-and-installation)) - [Settings management commands](#settings-management-commands) - [List all settings](#list-all-settings) @@ -40,17 +40,17 @@ This API allows to manage your Bare metal server. ## Baseboard Management Controller (BMC) management commands -Baseboard Management Controller (BMC) allows you to remotely access the low-level parameters of your dedicated server. +A Baseboard Management Controller (BMC) allows you to remotely access the low-level parameters of your dedicated server. For instance, your KVM-IP management console could be accessed with it. -You need first to create an option Remote Access. You will find the ID and the price with a call to listOffers (https://developers.scaleway.com/en/products/baremetal/api/#get-78db92). Then you can add the option https://developers.scaleway.com/en/products/baremetal/api/#post-b14abd. Do not forget to delete the Option. +You need first to create an Remote Access option. You will find the ID and the price with a call to listOffers (https://developers.scaleway.com/en/products/baremetal/api/#get-78db92). Then you can add the option https://developers.scaleway.com/en/products/baremetal/api/#post-b14abd. Do not forget to delete the Option. Then you need to create Remote Access https://developers.scaleway.com/en/products/baremetal/api/#post-1af723. And finally Get Remote Access to get the login/password https://developers.scaleway.com/en/products/baremetal/api/#get-cefc0f. -### Get BMC (Baseboard Management Controller) access for a given elastic metal server +### Get BMC access -Get the BMC (Baseboard Management Controller) access associated with the given ID. +Get the BMC (Baseboard Management Controller) access associated with the ID, including the URL and login information needed to connect. **Usage:** @@ -68,12 +68,12 @@ scw baremetal bmc get [arg=value ...] -### Start BMC (Baseboard Management Controller) access for a given elastic metal server +### Start BMC access -Start BMC (Baseboard Management Controller) access associated with the given ID. +Start BMC (Baseboard Management Controller) access associated with the ID. The BMC (Baseboard Management Controller) access is available one hour after the installation of the server. -You need first to create an option Remote Access. You will find the ID and the price with a call to listOffers (https://developers.scaleway.com/en/products/baremetal/api/#get-78db92). Then you can add the option https://developers.scaleway.com/en/products/baremetal/api/#post-b14abd. Do not forget to delete the Option. - After start BMC, you need to Get Remote Access to get the login/password https://developers.scaleway.com/en/products/baremetal/api/#get-cefc0f. +You need first to create an option Remote Access. You will find the ID and the price with a call to listOffers (https://developers.scaleway.com/en/products/baremetal/api/#get-78db92). Then add the option https://developers.scaleway.com/en/products/baremetal/api/#post-b14abd. +After adding the BMC option, you need to Get Remote Access to get the login/password https://developers.scaleway.com/en/products/baremetal/api/#get-cefc0f. Do not forget to delete the Option after use. **Usage:** @@ -87,14 +87,14 @@ scw baremetal bmc start [arg=value ...] | Name | | Description | |------|---|-------------| | server-id | Required | ID of the server | -| ip | Required | The IP authorized to connect to the given server | +| ip | Required | The IP authorized to connect to the server | | zone | Default: `fr-par-1`
One of: `fr-par-1`, `fr-par-2`, `nl-ams-1` | Zone to target. If none is passed will use default zone from the config | -### Stop BMC (Baseboard Management Controller) access for a given elastic metal server +### Stop BMC access -Stop BMC (Baseboard Management Controller) access associated with the given ID. +Stop BMC (Baseboard Management Controller) access associated with the ID. **Usage:** @@ -114,14 +114,14 @@ scw baremetal bmc stop [arg=value ...] ## Server offer management commands -Server offers will answer with all different elastic metal server ranges available in a given zone. -Each of them will contain all the features of the server (cpus, memories, disks) with their associated pricing. +Server offers will answer with all different Elastic Metal server ranges available in a zone. +Each of them will contain all the features of the server (CPUs, memory, disks) with their associated pricing. ### Get offer -Return specific offer for the given ID. +Get details of an offer identified by its offer ID. **Usage:** @@ -141,7 +141,7 @@ scw baremetal offer get [arg=value ...] **Examples:** -Get a server offer with the given ID +Get a server offer with the ID ``` scw baremetal offer get zone=fr-par-1 offer-id=11111111-1111-1111-1111-111111111111 ``` @@ -151,7 +151,7 @@ scw baremetal offer get zone=fr-par-1 offer-id=11111111-1111-1111-1111-111111111 ### List offers -List all available server offers. +List all available Elastic Metal server configurations. **Usage:** @@ -164,7 +164,7 @@ scw baremetal offer list [arg=value ...] | Name | | Description | |------|---|-------------| -| subscription-period | One of: `unknown_subscription_period`, `hourly`, `monthly` | Period of subscription to filter offers | +| subscription-period | One of: `unknown_subscription_period`, `hourly`, `monthly` | Subscription period type to filter offers by | | zone | Default: `fr-par-1`
One of: `fr-par-1`, `fr-par-2`, `nl-ams-1`, `all` | Zone to target. If none is passed will use default zone from the config | @@ -192,7 +192,7 @@ A Server has additional options that let you personalize it to better fit your n ### Add server option -Add an option to a specific server. +Add an option, such as Private Networks, to a specific server. **Usage:** @@ -214,7 +214,7 @@ scw baremetal options add [arg=value ...] **Examples:** -Add a given option to a server +Add an option, such as Private Networks, to a server ``` scw baremetal options add server-id=11111111-1111-1111-1111-111111111111 option-id=11111111-1111-1111-1111-111111111111 ``` @@ -245,7 +245,7 @@ scw baremetal options delete [arg=value ...] **Examples:** -Delete a given option from a server +Delete an option from a server ``` scw baremetal options delete server-id=11111111-1111-1111-1111-111111111111 option-id=11111111-1111-1111-1111-111111111111 ``` @@ -255,7 +255,7 @@ scw baremetal options delete server-id=11111111-1111-1111-1111-111111111111 opti ### Get option -Return specific option for the given ID. +Return specific option for the ID. **Usage:** @@ -275,7 +275,7 @@ scw baremetal options get [arg=value ...] **Examples:** -Get a server option with the given ID +Get a server option with the ID ``` scw baremetal options get zone=fr-par-1 option-id=11111111-1111-1111-1111-111111111111 ``` @@ -298,8 +298,8 @@ scw baremetal options list [arg=value ...] | Name | | Description | |------|---|-------------| -| offer-id | | Filter options by offer_id | -| name | | Filter options by name | +| offer-id | | Offer ID to filter options for | +| name | | Name to filter options for | | zone | Default: `fr-par-1`
One of: `fr-par-1`, `fr-par-2`, `nl-ams-1`, `all` | Zone to target. If none is passed will use default zone from the config | @@ -324,9 +324,9 @@ scw baremetal options list zone=fr-par-1 An Operating System (OS) is the underlying software installed on your server -### Get an OS with a given ID +### Get an OS with an ID -Return specific OS for the given ID. +Return specific OS for the ID. **Usage:** @@ -354,9 +354,9 @@ scw baremetal os get -### List all available OS that can be install on an elastic metal server +### List available OSes -List all available OS that can be install on an elastic metal server. +List all OSes that are available for installation on Elastic Metal servers. **Usage:** @@ -369,27 +369,27 @@ scw baremetal os list [arg=value ...] | Name | | Description | |------|---|-------------| -| offer-id | | Filter OS by offer ID | +| offer-id | | Offer IDs to filter OSes for | | zone | Default: `fr-par-1`
One of: `fr-par-1`, `fr-par-2`, `nl-ams-1`, `all` | Zone to target. If none is passed will use default zone from the config | -## Private network management command +## Private Network management command -A private network allows interconnecting your resources +A Private Network allows you to interconnect your resources (servers, instances, ...) in an isolated and private network. The network reachability is limited to the -resources that are on the same private network. A VLAN +resources that are on the same Private Network . A VLAN interface is available on the server and can be freely managed (adding IP addresses, shutdown interface...). -Note that a resource can be a part of multiple private networks. +Note that a resource can be a part of multiple Private Networks. -### Add a server to a private network +### Add a server to a Private Network -Add a server to a private network. +Add a server to a Private Network. **Usage:** @@ -403,14 +403,14 @@ scw baremetal private-network add [arg=value ...] | Name | | Description | |------|---|-------------| | server-id | Required | The ID of the server | -| private-network-id | Required | The ID of the private network | +| private-network-id | Required | The ID of the Private Network | | zone | Default: `fr-par-1`
One of: `fr-par-2` | Zone to target. If none is passed will use default zone from the config | -### Delete a private network +### Delete a Private Network -Delete a private network. +Delete a Private Network. **Usage:** @@ -424,14 +424,14 @@ scw baremetal private-network delete [arg=value ...] | Name | | Description | |------|---|-------------| | server-id | Required | The ID of the server | -| private-network-id | Required | The ID of the private network | +| private-network-id | Required | The ID of the Private Network | | zone | Default: `fr-par-1`
One of: `fr-par-2` | Zone to target. If none is passed will use default zone from the config | -### List the private networks of a server +### List the Private Networks of a server -List the private networks of a server. +List the Private Networks of a server. **Usage:** @@ -444,18 +444,18 @@ scw baremetal private-network list [arg=value ...] | Name | | Description | |------|---|-------------| -| order-by | One of: `created_at_asc`, `created_at_desc`, `updated_at_asc`, `updated_at_desc` | The sort order for the returned private networks | -| server-id | | Filter private networks by server ID | -| private-network-id | | Filter private networks by private network ID | -| project-id | | Filter private networks by project ID | -| organization-id | | Filter private networks by organization ID | +| order-by | One of: `created_at_asc`, `created_at_desc`, `updated_at_asc`, `updated_at_desc` | The sort order for the returned Private Networks | +| server-id | | Filter Private Networks by server ID | +| private-network-id | | Filter Private Networks by Private Network ID | +| project-id | | Filter Private Networks by Project ID | +| organization-id | | Filter Private Networks by Organization ID | | zone | Default: `fr-par-1`
One of: `fr-par-2`, `all` | Zone to target. If none is passed will use default zone from the config | -### Set multiple private networks on a server +### Set multiple Private Networks on a server -Set multiple private networks on a server. +Set multiple Private Networks on a server. **Usage:** @@ -469,7 +469,7 @@ scw baremetal private-network set [arg=value ...] | Name | | Description | |------|---|-------------| | server-id | Required | The ID of the server | -| private-network-ids.{index} | Required | The IDs of the private networks | +| private-network-ids.{index} | Required | The IDs of the Private Networks | | zone | Default: `fr-par-1`
One of: `fr-par-2` | Zone to target. If none is passed will use default zone from the config | @@ -479,9 +479,9 @@ scw baremetal private-network set [arg=value ...] A server is a denomination of a type of instances provided by Scaleway -### Create an elastic metal server +### Create an Elastic Metal server -Create a new elastic metal server. Once the server is created, you probably want to install an OS. +Create a new Elastic Metal server. Once the server is created, proceed with the [installation of an OS](#post-3e949e). **Usage:** @@ -496,15 +496,15 @@ scw baremetal server create [arg=value ...] |------|---|-------------| | project-id | | Project ID to use. If none is passed the default project ID will be used | | name | Required
Default: `` | Name of the server (β‰ hostname) | -| description | | Description associated to the server, max 255 characters | +| description | | Description associated with the server, max 255 characters | | type | | Server commercial type | | tags.{index} | | Tags to associate to the server | -| install.os-id | | ID of the OS to install on the server | +| install.os-id | | ID of the OS to installation on the server | | install.hostname | | Hostname of the server | | install.ssh-key-ids.{index} | | SSH key IDs authorized on the server | -| install.user | | User used for the installation | -| install.password | | Password used for the installation | -| install.service-user | | User used for the service to install | +| install.user | | User for the installation | +| install.password | | Password for the installation | +| install.service-user | | Regular user that runs the service to be installed on the server | | install.service-password | | Password used for the service to install | | option-ids.{index} | | IDs of options to enable on server | | organization-id | | Organization ID to use. If none is passed the default organization ID will be used | @@ -522,9 +522,9 @@ scw baremetal server create -### Delete an elastic metal server +### Delete an Elastic Metal server -Delete the server associated with the given ID. +Delete the server associated with the ID. **Usage:** @@ -544,7 +544,7 @@ scw baremetal server delete [arg=value ...] **Examples:** -Delete an elastic metal server +Delete an Elastic Metal server ``` scw baremetal server delete 11111111-1111-1111-1111-111111111111 ``` @@ -552,9 +552,9 @@ scw baremetal server delete 11111111-1111-1111-1111-111111111111 -### Get a specific elastic metal server +### Get a specific Elastic Metal server -Get the server associated with the given ID. +Get full details of an existing Elastic Metal server associated with the ID. **Usage:** @@ -574,7 +574,7 @@ scw baremetal server get [arg=value ...] **Examples:** -Get a given server +Get a specific server ``` scw baremetal server get 11111111-1111-1111-1111-111111111111 ``` @@ -582,9 +582,9 @@ scw baremetal server get 11111111-1111-1111-1111-111111111111 -### Install an elastic metal server +### Install an Elastic Metal server -Install an OS on the server associated with the given ID. +Install an Operating System (OS) on the Elastic Metal server with a specific ID. **Usage:** @@ -598,7 +598,7 @@ scw baremetal server install [arg=value ...] | Name | | Description | |------|---|-------------| | server-id | Required | Server ID to install | -| os-id | Required | ID of the OS to install on the server | +| os-id | Required | ID of the OS to installation on the server | | hostname | Required | Hostname of the server | | all-ssh-keys | | Add all SSH keys on your baremetal instance (cannot be used with ssh-key-ids) | | ssh-key-ids.{index} | Required | SSH key IDs authorized on the server (cannot be used with all-ssh-keys) | @@ -612,7 +612,7 @@ scw baremetal server install [arg=value ...] **Examples:** -Install an OS on a given server with a particular SSH key ID +Install an OS on a server with a particular SSH key ID ``` scw baremetal server install 11111111-1111-1111-1111-111111111111 os-id=11111111-1111-1111-1111-111111111111 ssh-key-ids.0=11111111-1111-1111-1111-111111111111 ``` @@ -620,9 +620,9 @@ scw baremetal server install 11111111-1111-1111-1111-111111111111 os-id=11111111 -### List elastic metal servers for organization +### List Elastic Metal servers for an organization -List elastic metal servers for organization. +List Elastic Metal servers for a specific organization. **Usage:** @@ -636,19 +636,19 @@ scw baremetal server list [arg=value ...] | Name | | Description | |------|---|-------------| | order-by | One of: `created_at_asc`, `created_at_desc` | Order of the servers | -| tags.{index} | | Filter by tags | -| status.{index} | | Filter by status | -| name | | Filter by name | -| project-id | | Filter by project ID | -| option-id | | Filter by option ID | -| organization-id | | Filter by organization ID | +| tags.{index} | | Tags to filter for | +| status.{index} | | Status to filter for | +| name | | Names to filter for | +| project-id | | Project ID to filter for | +| option-id | | Option ID to filter for | +| organization-id | | Organization ID to filter for | | zone | Default: `fr-par-1`
One of: `fr-par-1`, `fr-par-2`, `nl-ams-1`, `all` | Zone to target. If none is passed will use default zone from the config | **Examples:** -List all servers on your default zone +List all servers in your default zone ``` scw baremetal server list ``` @@ -656,9 +656,9 @@ scw baremetal server list -### Reboot an elastic metal server +### Reboot an Elastic Metal server -Reboot the server associated with the given ID, use boot param to reboot in rescue. +Reboot the Elastic Metal server associated with the ID, use the `boot_type` `rescue` to reboot the server in rescue mode. **Usage:** @@ -692,9 +692,9 @@ scw baremetal server reboot 11111111-1111-1111-1111-111111111111 boot-type=rescu -### Start an elastic metal server +### Start an Elastic Metal server -Start the server associated with the given ID. +Start the server associated with the ID. **Usage:** @@ -715,7 +715,7 @@ scw baremetal server start [arg=value ...] **Examples:** -Start an elastic metal server +Start an Elastic Metalx server ``` scw baremetal server start 11111111-1111-1111-1111-111111111111 ``` @@ -728,9 +728,9 @@ scw baremetal server start 11111111-1111-1111-1111-111111111111 boot-type=rescue -### Stop an elastic metal server +### Stop an Elastic Metal server -Stop the server associated with the given ID. +Stop the server associated with the ID. The server remains allocated to your account and all data remains on the local storage of the server. **Usage:** @@ -750,7 +750,7 @@ scw baremetal server stop [arg=value ...] **Examples:** -Stop an elastic metal server +Stop an Elastic Metal server ``` scw baremetal server stop 11111111-1111-1111-1111-111111111111 ``` @@ -758,9 +758,9 @@ scw baremetal server stop 11111111-1111-1111-1111-111111111111 -### Update an elastic metal server +### Update an Elastic Metal server -Update the server associated with the given ID. +Update the server associated with the ID. You can update parameters such as the server's name, tags and description. Any parameters left null in the request body are not updated. **Usage:** @@ -775,8 +775,8 @@ scw baremetal server update [arg=value ...] |------|---|-------------| | server-id | Required | ID of the server to update | | name | | Name of the server (β‰ hostname), not updated if null | -| description | | Description associated to the server, max 255 characters, not updated if null | -| tags.{index} | | Tags associated to the server, not updated if null | +| description | | Description associated with the server, max 255 characters, not updated if null | +| tags.{index} | | Tags associated with the server, not updated if null | | zone | Default: `fr-par-1`
One of: `fr-par-1`, `fr-par-2`, `nl-ams-1` | Zone to target. If none is passed will use default zone from the config | @@ -813,7 +813,7 @@ scw baremetal server wait 11111111-1111-1111-1111-111111111111 ## Settings management commands -Allows to configure the general settings for your elastic metal server. +Allows to configure the general settings for your Elastic Metal server. @@ -832,7 +832,7 @@ scw baremetal settings list [arg=value ...] | Name | | Description | |------|---|-------------| -| order-by | One of: `created_at_asc`, `created_at_desc` | Order the response | +| order-by | One of: `created_at_asc`, `created_at_desc` | Sort order for items in the response | | project-id | Required | ID of the project | | zone | Default: `fr-par-1`
One of: `fr-par-1`, `fr-par-2`, `nl-ams-1`, `all` | Zone to target. If none is passed will use default zone from the config | @@ -854,7 +854,7 @@ scw baremetal settings update [arg=value ...] | Name | | Description | |------|---|-------------| | setting-id | Required | ID of the setting | -| enabled | | Enable/Disable the setting | +| enabled | | Defines whether the setting is enabled | | zone | Default: `fr-par-1`
One of: `fr-par-1`, `fr-par-2`, `nl-ams-1` | Zone to target. If none is passed will use default zone from the config | diff --git a/docs/commands/iam.md b/docs/commands/iam.md index 04359ee43e..8a2c3eb7e3 100644 --- a/docs/commands/iam.md +++ b/docs/commands/iam.md @@ -11,12 +11,12 @@ IAM API. - [Applications management commands](#applications-management-commands) - [Create a new application](#create-a-new-application) - [Delete an application](#delete-an-application) - - [Get an existing application](#get-an-existing-application) - - [List applications of an organization](#list-applications-of-an-organization) - - [Update an existing application](#update-an-existing-application) + - [Get a given application](#get-a-given-application) + - [List applications of an Organization](#list-applications-of-an-organization) + - [Update an application](#update-an-application) - [Groups management commands](#groups-management-commands) - - [Add a user of an application to a group](#add-a-user-of-an-application-to-a-group) - - [Create a new group](#create-a-new-group) + - [Add a user or an application to a group](#add-a-user-or-an-application-to-a-group) + - [Create a group](#create-a-group) - [Delete a group](#delete-a-group) - [Get a group](#get-a-group) - [List groups](#list-groups) @@ -32,11 +32,11 @@ IAM API. - [Create a new policy](#create-a-new-policy) - [Delete a policy](#delete-a-policy) - [Get an existing policy](#get-an-existing-policy) - - [List policies of an organization](#list-policies-of-an-organization) + - [List policies of an Organization](#list-policies-of-an-organization) - [Update an existing policy](#update-an-existing-policy) - [Rules management commands](#rules-management-commands) - - [List rules of an existing policy](#list-rules-of-an-existing-policy) - - [Set rules of an existing policy](#set-rules-of-an-existing-policy) + - [List rules of a given policy](#list-rules-of-a-given-policy) + - [Set rules of a given policy](#set-rules-of-a-given-policy) - [SSH keys management commands](#ssh-keys-management-commands) - [Create an SSH key](#create-an-ssh-key) - [Delete an SSH key](#delete-an-ssh-key) @@ -45,9 +45,9 @@ IAM API. - [List SSH keys](#list-ssh-keys) - [Update an SSH key](#update-an-ssh-key) - [Users management commands](#users-management-commands) - - [Delete a guest user from an organization](#delete-a-guest-user-from-an-organization) - - [Retrieve a user from its ID](#retrieve-a-user-from-its-id) - - [List users of an organization](#list-users-of-an-organization) + - [Delete a guest user from an Organization](#delete-a-guest-user-from-an-organization) + - [Get a given user](#get-a-given-user) + - [List users of an Organization](#list-users-of-an-organization) ## API keys management commands @@ -57,7 +57,7 @@ API keys management commands. ### Create an API key -Create an API key. +Create an API key. You must specify the `application_id` or the `user_id` and the description. You can also specify the `default_project_id` which is the Project ID of your preferred Project, to use with Object Storage. The `access_key` and `secret_key` values are returned in the response. Note that he secret key is only showed once. Make sure that you copy and store both keys somewhere safe. **Usage:** @@ -70,17 +70,17 @@ scw iam api-key create [arg=value ...] | Name | | Description | |------|---|-------------| -| application-id | | ID of application principal | -| user-id | | ID of user principal | +| application-id | | ID of the application | +| user-id | | ID of the user | | expires-at | | Expiration date of the API key | -| default-project-id | | The default project ID to use with object storage | -| description | | The description of the API key (max length is 200 chars) | +| default-project-id | | The default Project ID to use with Object Storage | +| description | | The description of the API key (max length is 200 characters) | ### Delete an API key -Delete an API key. +Delete an API key. Note that this action is irreversible and cannot be undone. Make sure you update any configurations using the API keys you delete. **Usage:** @@ -109,7 +109,7 @@ scw iam api-key delete SCW00000000000 ### Get an API key -Get an API key. +Retrive information about an API key, specified by the `access_key` parameter. The API key's details, including either the `user_id` or `application_id` of its bearer are returned in the response. Note that the string value for the `secret_key` is nullable, and therefore is not displayed in the response. The `secret_key` value is only displayed upon API key creation. **Usage:** @@ -128,7 +128,7 @@ scw iam api-key get [arg=value ...] ### List API keys -List API keys. +List API keys. By default, the API keys listed are ordered by creation date in ascending order. This can be modified via the `order_by` field. You can define additional parameters for your query such as `editable`, `expired`, `access_key` and `bearer_id`. **Usage:** @@ -142,21 +142,21 @@ scw iam api-key list [arg=value ...] | Name | | Description | |------|---|-------------| | order-by | Default: `created_at_asc`
One of: `created_at_asc`, `created_at_desc`, `updated_at_asc`, `updated_at_desc`, `expires_at_asc`, `expires_at_desc`, `access_key_asc`, `access_key_desc` | Criteria for sorting results | -| ~~application-id~~ | Deprecated | ID of an application bearer | -| ~~user-id~~ | Deprecated | ID of a user bearer | -| editable | | Filter out editable API keys or not | -| expired | | Filter out expired API keys or not | -| access-key | | Filter out by access key | -| description | | Filter out by description | -| bearer-id | | Filter out by bearer ID | -| bearer-type | One of: `unknown_bearer_type`, `user`, `application` | Filter out by type of bearer | -| organization-id | Required
Default: `` | ID of organization | +| ~~application-id~~ | Deprecated | ID of application that bears the API key | +| ~~user-id~~ | Deprecated | ID of user that bears the API key | +| editable | | Whether to filter out editable API keys or not | +| expired | | Whether to filter out expired API keys or not | +| access-key | | Filter by access key | +| description | | Filter by description | +| bearer-id | | Filter by bearer ID | +| bearer-type | One of: `unknown_bearer_type`, `user`, `application` | Filter by type of bearer | +| organization-id | Required
Default: `` | ID of Organization | ### Update an API key -Update an API key. +Update the parameters of an API key, including `default_project_id` and `description`. **Usage:** @@ -170,7 +170,7 @@ scw iam api-key update [arg=value ...] | Name | | Description | |------|---|-------------| | access-key | Required | Access key to update | -| default-project-id | | The new default project ID to set | +| default-project-id | | The new default Project ID to set | | description | | The new description to update | @@ -182,7 +182,7 @@ Applications management commands. ### Create a new application -Create a new application. +Create a new application. You must define the `name` parameter in the request. **Usage:** @@ -195,15 +195,15 @@ scw iam application create [arg=value ...] | Name | | Description | |------|---|-------------| -| name | Required
Default: `` | Name of application to create (max length is 64 chars) | -| description | | Description of application (max length is 200 chars) | +| name | Required
Default: `` | Name of the application to create (max length is 64 characters) | +| description | | Description of the application (max length is 200 characters) | | organization-id | | Organization ID to use. If none is passed the default organization ID will be used | ### Delete an application -Delete an application. +Delete an application. Note that this action is irreversible and will automatically delete the application's API keys. Policies attached to users and applications via this group will no longer apply. **Usage:** @@ -216,13 +216,13 @@ scw iam application delete [arg=value ...] | Name | | Description | |------|---|-------------| -| application-id | Required | ID of application to delete | +| application-id | Required | ID of the application to delete | -### Get an existing application +### Get a given application -Get an existing application. +Retrieve information about an application, specified by the `application_id` parameter. The application's full details, including `id`, `email`, `organization_id`, `status` and `two_factor_enabled` are returned in the response. **Usage:** @@ -235,13 +235,13 @@ scw iam application get [arg=value ...] | Name | | Description | |------|---|-------------| -| application-id | Required | ID of application to find | +| application-id | Required | ID of the application to find | -### List applications of an organization +### List applications of an Organization -List applications of an organization. +List the applications of an Organization. By default, the applications listed are ordered by creation date in ascending order. This can be modified via the `order_by` field. You must define the `organization_id` in the query path of your request. You can also define additional parameters for your query such as `application_ids`. **Usage:** @@ -255,16 +255,16 @@ scw iam application list [arg=value ...] | Name | | Description | |------|---|-------------| | order-by | Default: `created_at_asc`
One of: `created_at_asc`, `created_at_desc`, `updated_at_asc`, `updated_at_desc`, `name_asc`, `name_desc` | Criteria for sorting results | -| name | | Name of application to filter | -| editable | | Filter out editable applications or not | -| application-ids.{index} | | Filter out by a list of ID | -| organization-id | Required
Default: `` | ID of organization to filter | +| name | | Name of the application to filter | +| editable | | Whether to filter out editable applications or not | +| application-ids.{index} | | Filter by list of IDs | +| organization-id | Required
Default: `` | ID of the Organization to filter | -### Update an existing application +### Update an application -Update an existing application. +Update the parameters of an application, including `name` and `description`. **Usage:** @@ -277,9 +277,9 @@ scw iam application update [arg=value ...] | Name | | Description | |------|---|-------------| -| application-id | Required | ID of application to update | -| name | | New name of application (max length is 64 chars) | -| description | | New description of application (max length is 200 chars) | +| application-id | Required | ID of the application to update | +| name | | New name for the application (max length is 64 chars) | +| description | | New description for the application (max length is 200 chars) | @@ -288,9 +288,9 @@ scw iam application update [arg=value ...] Groups management commands. -### Add a user of an application to a group +### Add a user or an application to a group -Add a user of an application to a group. +Add a user or an application to a group. You can specify a `user_id` and and `application_id` in the body of your request. Note that you can only add one of each per request. **Usage:** @@ -303,15 +303,15 @@ scw iam group add-member [arg=value ...] | Name | | Description | |------|---|-------------| -| group-id | Required | ID of group | +| group-id | Required | ID of the group | | user-id | | ID of the user to add | | application-id | | ID of the application to add | -### Create a new group +### Create a group -Create a new group. +Create a new group. You must define the `name` and `organization_id` parameters in the request. **Usage:** @@ -324,7 +324,7 @@ scw iam group create [arg=value ...] | Name | | Description | |------|---|-------------| -| name | Required
Default: `` | Name of the group to create (max length is 64 chars). MUST be unique inside an organization | +| name | Required
Default: `` | Name of the group to create (max length is 64 chars). MUST be unique inside an Organization | | description | | Description of the group to create (max length is 200 chars) | | organization-id | | Organization ID to use. If none is passed the default organization ID will be used | @@ -342,7 +342,7 @@ scw iam group create name=foobar ### Delete a group -Delete a group. +Delete a group. Note that this action is irreversible and could delete permissions for group members. Policies attached to users and applications via this group will no longer apply. **Usage:** @@ -355,7 +355,7 @@ scw iam group delete [arg=value ...] | Name | | Description | |------|---|-------------| -| group-id | Required | ID of group to delete | +| group-id | Required | ID of the group to delete | **Examples:** @@ -371,7 +371,7 @@ scw iam group delete 11111111-1111-1111-1111-111111111111 ### Get a group -Get a group. +Retrive information about a given group, specified by the `group_id` parameter. The group's full details, including `user_ids` and `application_ids` are returned in the response. **Usage:** @@ -384,13 +384,13 @@ scw iam group get [arg=value ...] | Name | | Description | |------|---|-------------| -| group-id | Required | ID of group | +| group-id | Required | ID of the group | ### List groups -List groups. +List groups. By default, the groups listed are ordered by creation date in ascending order. This can be modified via the `order_by` field. You can define additional parameters to filter your query. Use `user_ids` or `application_ids` to list all groups certain users or applications belong to. **Usage:** @@ -405,16 +405,16 @@ scw iam group list [arg=value ...] |------|---|-------------| | order-by | Default: `created_at_asc`
One of: `created_at_asc`, `created_at_desc`, `updated_at_asc`, `updated_at_desc`, `name_asc`, `name_desc` | Sort order of groups | | name | | Name of group to find | -| application-ids.{index} | | Filter out by a list of application ID | -| user-ids.{index} | | Filter out by a list of user ID | -| group-ids.{index} | | Filter out by a list of group ID | -| organization-id | Default: `` | Filter by organization ID | +| application-ids.{index} | | Filter by a list of application IDs | +| user-ids.{index} | | Filter by a list of user IDs | +| group-ids.{index} | | Filter by a list of group IDs | +| organization-id | Default: `` | Filter by Organization ID | ### Remove a user or an application from a group -Remove a user or an application from a group. +Remove a user or an application from a group. You can specify a `user_id` and and `application_id` in the body of your request. Note that you can only remove one of each per request. Removing a user from a group means that any permissions given to them via the group (i.e. from an attached policy) will no longer apply. Be sure you want to remove these permissions from the user before proceeding. **Usage:** @@ -427,7 +427,7 @@ scw iam group remove-member [arg=value ...] | Name | | Description | |------|---|-------------| -| group-id | Required | ID of group | +| group-id | Required | ID of the group | | user-id | | ID of the user to remove | | application-id | | ID of the application to remove | @@ -435,7 +435,7 @@ scw iam group remove-member [arg=value ...] ### Update a group -Update a group. +Update the parameters of group, including `name` and `description`. **Usage:** @@ -448,8 +448,8 @@ scw iam group update [arg=value ...] | Name | | Description | |------|---|-------------| -| group-id | Required | ID of group to update | -| name | | New name for the group (max length is 64 chars). MUST be unique inside an organization | +| group-id | Required | ID of the group to update | +| name | | New name for the group (max length is 64 chars). MUST be unique inside an Organization | | description | | New description for the group (max length is 200 chars) | @@ -525,7 +525,7 @@ Permission sets management commands. ### List permission sets -List permission sets. +List permission sets available for given Organization. You must define the `organization_id` in the query path of your request. **Usage:** @@ -550,7 +550,7 @@ Policies management commands. ### Create a new policy -Create a new policy. +Create a new application. You must define the `name` parameter in the request. You can specify parameters such as `user_id`, `groups_id`, `application_id`, `no_principal`, `rules` and its child attributes. **Usage:** @@ -563,15 +563,15 @@ scw iam policy create [arg=value ...] | Name | | Description | |------|---|-------------| -| name | Required
Default: `` | Name of policy to create (max length is 64 chars) | -| description | | Description of policy to create (max length is 200 chars) | +| name | Required
Default: `` | Name of the policy to create (max length is 64 characters) | +| description | | Description of the policy to create (max length is 200 characters) | | rules.{index}.permission-set-names.{index} | | Names of permission sets bound to the rule | -| rules.{index}.project-ids.{index} | | List of project IDs scoped to the rule | -| rules.{index}.organization-id | | ID of organization scoped to the rule | -| user-id | | ID of user, owner of the policy | -| group-id | | ID of group, owner of the policy | -| application-id | | ID of application, owner of the policy | -| no-principal | | True when the policy do not belong to any principal | +| rules.{index}.project-ids.{index} | | List of Project IDs the rule is scoped to | +| rules.{index}.organization-id | | ID of Organization the rule is scoped to | +| user-id | | ID of user attributed to the policy | +| group-id | | ID of group attributed to the policy | +| application-id | | ID of application attributed to the policy | +| no-principal | | Whether or not a policy is attributed to a principal | | organization-id | | Organization ID to use. If none is passed the default organization ID will be used | @@ -588,7 +588,7 @@ scw iam policy create group-id=11111111-1111-1111-1111-111111111111 rules.0.orga ### Delete a policy -Delete a policy. +Delete a policy. You must define specify the `policy_id` parameter in your request. Note that when deleting a policy, all permissions it gives to its principal (user, group or application) will be revoked. **Usage:** @@ -607,7 +607,7 @@ scw iam policy delete [arg=value ...] ### Get an existing policy -Get an existing policy. +Retrieve information about a policy, speficified by the `policy_id` parameter. The policy's full details, including `id`, `name`, `organization_id`, `nb_rules` and `nb_scopes`, `nb_permission_sets` are returned in the response. **Usage:** @@ -624,9 +624,9 @@ scw iam policy get [arg=value ...] -### List policies of an organization +### List policies of an Organization -List policies of an organization. +List the policies of an Organization. By default, the policies listed are ordered by creation date in ascending order. This can be modified via the `order_by` field. You must define the `organization_id` in the query path of your request. You can also define additional parameters to filter your query, such as `user_ids`, `groups_ids`, `application_ids`, and `policy_name`. **Usage:** @@ -640,19 +640,19 @@ scw iam policy list [arg=value ...] | Name | | Description | |------|---|-------------| | order-by | Default: `created_at_asc`
One of: `policy_name_asc`, `policy_name_desc`, `created_at_asc`, `created_at_desc` | Criteria for sorting results | -| editable | | Filter out editable policies or not | -| user-ids.{index} | | Filter out by a list of user ID | -| group-ids.{index} | | Filter out by a list of group ID | -| application-ids.{index} | | Filter out by a list of application ID | -| no-principal | | True when the policy do not belong to any principal | -| policy-name | | Name of policy to fetch | -| organization-id | Required
Default: `` | ID of organization to filter | +| editable | | Whether or not filter out editable policies | +| user-ids.{index} | | Whether or not to filter by list of user IDs | +| group-ids.{index} | | Whether or not to filter by list of group IDs | +| application-ids.{index} | | Filter by a list of application IDs | +| no-principal | | Whether or not the policy is attributed to a principal | +| policy-name | | Name of the policy to fetch | +| organization-id | Required
Default: `` | ID of the Organization to filter | ### Update an existing policy -Update an existing policy. +Update the parameters of a policy, including `name`, `description`, `user_id`, `group_id`, `application_id` and `no_principal`. **Usage:** @@ -666,12 +666,12 @@ scw iam policy update [arg=value ...] | Name | | Description | |------|---|-------------| | policy-id | Required | Id of policy to update | -| name | | New name of policy (max length is 64 chars) | -| description | | New description of policy (max length is 200 chars) | -| user-id | | New ID of user, owner of the policy | -| group-id | | New ID of group, owner of the policy | -| application-id | | New ID of application, owner of the policy | -| no-principal | | True when the policy do not belong to any principal | +| name | | New name for the policy (max length is 64 characters) | +| description | | New description of policy (max length is 200 characters) | +| user-id | | New ID of user attributed to the policy | +| group-id | | New ID of group attributed to the policy | +| application-id | | New ID of application attributed to the policy | +| no-principal | | Whether or not the policy is attributed to a principal | @@ -680,9 +680,9 @@ scw iam policy update [arg=value ...] Rules management commands. -### List rules of an existing policy +### List rules of a given policy -List rules of an existing policy. +List the rules of a given policy. By default, the rules listed are ordered by creation date in ascending order. This can be modified via the `order_by` field. You must define the `policy_id` in the query path of your request. **Usage:** @@ -699,9 +699,9 @@ scw iam rule list [arg=value ...] -### Set rules of an existing policy +### Set rules of a given policy -Set rules of an existing policy. +Overwrite the rules of a given policy. Any information that you add using this command will overwrite the previous configuration. If you include some of the rules you already had in your previous configuration in your new one, but you change their order, the new order of display will apply. While policy rules are ordered, they have no impact on the access logic of IAM because rules are allow-only. **Usage:** @@ -716,8 +716,8 @@ scw iam rule update [arg=value ...] |------|---|-------------| | policy-id | Required | Id of policy to update | | rules.{index}.permission-set-names.{index} | | Names of permission sets bound to the rule | -| rules.{index}.project-ids.{index} | | List of project IDs scoped to the rule | -| rules.{index}.organization-id | | ID of organization scoped to the rule | +| rules.{index}.project-ids.{index} | | List of Project IDs the rule is scoped to | +| rules.{index}.organization-id | | ID of Organization the rule is scoped to | @@ -728,7 +728,7 @@ SSH keys management commands. ### Create an SSH key -Create an SSH key. +Add a new SSH key to a Scaleway Project. You must specify the `name`, `public_key` and `project_id`. **Usage:** @@ -742,7 +742,7 @@ scw iam ssh-key create [arg=value ...] | Name | | Description | |------|---|-------------| | name | Required
Default: `` | The name of the SSH key. Max length is 1000 | -| public-key | Required | SSH public key. Currently ssh-rsa, ssh-dss (DSA), ssh-ed25519 and ecdsa keys with NIST curves are supported. Max length is 65000 | +| public-key | Required | SSH public key. Currently only the ssh-rsa, ssh-dss (DSA), ssh-ed25519 and ecdsa keys with NIST curves are supported. Max length is 65000 | | project-id | | Project ID to use. If none is passed the default project ID will be used | @@ -759,7 +759,7 @@ scw iam ssh-key create name=foobar public-key="$(cat )" ### Delete an SSH key -Delete an SSH key. +Delete a given SSH key, specified by the `ssh_key_id`. Deleting an SSH is permanent, and cannot be undone. Note that you might need to update any configurations that used the SSH key. **Usage:** @@ -788,7 +788,7 @@ scw iam ssh-key delete 11111111-1111-1111-1111-111111111111 ### Get an SSH key -Get an SSH key. +Retrieve information about a given SSH key, specified by the `ssh_key_id` parameter. The SSH key's full details, including `id`, `name`, `public_key`, and `project_id` are returned in the response. **Usage:** @@ -819,7 +819,7 @@ scw iam ssh-key init ### List SSH keys -List SSH keys. +List SSH keys. By default, the SSH keys listed are ordered by creation date in ascending order. This can be modified via the `order_by` field. You can define additional parameters for your query such as `organization_id`, `name`, `project_id` and `disabled`. **Usage:** @@ -832,17 +832,17 @@ scw iam ssh-key list [arg=value ...] | Name | | Description | |------|---|-------------| -| order-by | Default: `created_at_asc`
One of: `created_at_asc`, `created_at_desc`, `updated_at_asc`, `updated_at_desc`, `name_asc`, `name_desc` | Sort order of SSH keys | +| order-by | Default: `created_at_asc`
One of: `created_at_asc`, `created_at_desc`, `updated_at_asc`, `updated_at_desc`, `name_asc`, `name_desc` | Sort order of the SSH keys | | name | | Name of group to find | -| project-id | | Filter by project ID | -| disabled | | Filter out disabled SSH keys or not | -| organization-id | Default: `` | Filter by organization ID | +| project-id | | Filter by Project ID | +| disabled | | Whether to include disabled SSH keys or not | +| organization-id | Default: `` | Filter by Organization ID | ### Update an SSH key -Update an SSH key. +Update the parameters of an SSH key, including `name` and `disable`. **Usage:** @@ -866,9 +866,9 @@ scw iam ssh-key update [arg=value ...] Users management commands. -### Delete a guest user from an organization +### Delete a guest user from an Organization -Delete a guest user from an organization. +Remove a user from an Organization in which they are a guest. You must define the `user_id` in your request. Note that removing a user from an Organization automatically deletes their API keys, and any policies directly attached to them become orphaned. **Usage:** @@ -881,13 +881,13 @@ scw iam user delete [arg=value ...] | Name | | Description | |------|---|-------------| -| user-id | Required | ID of user to delete | +| user-id | Required | ID of the user to delete | -### Retrieve a user from its ID +### Get a given user -Retrieve a user from its ID. +Retrieve information about a user, specified by the `user_id` parameter. The user's full details, including `id`, `email`, `organization_id`, `status` and `two_factor_enabled` are returned in the response. **Usage:** @@ -900,13 +900,13 @@ scw iam user get [arg=value ...] | Name | | Description | |------|---|-------------| -| user-id | Required | ID of user to find | +| user-id | Required | ID of the user to find | -### List users of an organization +### List users of an Organization -List users of an organization. +List the users of an Organization. By default, the users listed are ordered by creation date in ascending order. This can be modified via the `order_by` field. You must define the `organization_id` in the query path of your request. You can also define additional parameters for your query such as `user_ids`. **Usage:** @@ -920,8 +920,8 @@ scw iam user list [arg=value ...] | Name | | Description | |------|---|-------------| | order-by | Default: `created_at_asc`
One of: `created_at_asc`, `created_at_desc`, `updated_at_asc`, `updated_at_desc`, `email_asc`, `email_desc`, `last_login_asc`, `last_login_desc` | Criteria for sorting results | -| user-ids.{index} | | Filter out by a list of ID | -| organization-id | Required
Default: `` | ID of organization to filter | +| user-ids.{index} | | Filter by list of IDs | +| organization-id | Required
Default: `` | ID of the Organization to filter | diff --git a/docs/commands/tem.md b/docs/commands/tem.md index 47e26fc990..215f05c9ca 100644 --- a/docs/commands/tem.md +++ b/docs/commands/tem.md @@ -57,7 +57,8 @@ scw tem domain create [arg=value ...] | Name | | Description | |------|---|-------------| | project-id | | Project ID to use. If none is passed the default project ID will be used | -| domain-name | | | +| domain-name | | Fully qualified domain dame | +| accept-tos | | Accept the Scaleway Terms of Service | | region | Default: `fr-par`
One of: `fr-par` | Region to target. If none is passed will use default region from the config | @@ -252,6 +253,7 @@ scw tem email list [arg=value ...] | mail-from | | Optional, list emails sent with this `mail_from` sender's address | | mail-to | | Optional, list emails sent with this `mail_to` recipient's address | | statuses.{index} | One of: `unknown`, `new`, `sending`, `sent`, `failed`, `canceled` | Optional, list emails having any of this status | +| subject | | Optional, list emails having this subject | | region | Default: `fr-par`
One of: `fr-par`, `all` | Region to target. If none is passed will use default region from the config | diff --git a/go.mod b/go.mod index 464996fe37..2d77f4760a 100644 --- a/go.mod +++ b/go.mod @@ -19,7 +19,7 @@ require ( github.com/kubernetes-client/go-base v0.0.0-20190205182333-3d0e39759d98 github.com/mattn/go-colorable v0.1.13 github.com/mattn/go-isatty v0.0.17 - github.com/scaleway/scaleway-sdk-go v1.0.0-beta.14.0.20230310155856-7a2786489bc6 + github.com/scaleway/scaleway-sdk-go v1.0.0-beta.14.0.20230314101523-398c37802c41 github.com/spf13/cobra v1.6.1 github.com/spf13/pflag v1.0.5 github.com/stretchr/testify v1.8.2 diff --git a/go.sum b/go.sum index 76be72212c..d6cfc3cd51 100644 --- a/go.sum +++ b/go.sum @@ -72,8 +72,8 @@ github.com/pkg/term v1.1.0/go.mod h1:E25nymQcrSllhX42Ok8MRm1+hyBdHY0dCeiKZ9jpNGw github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM= -github.com/scaleway/scaleway-sdk-go v1.0.0-beta.14.0.20230310155856-7a2786489bc6 h1:bAqxZt/1FAD/M4XLqWYHySz5kNcoQ7Mrdo7imgWAyaQ= -github.com/scaleway/scaleway-sdk-go v1.0.0-beta.14.0.20230310155856-7a2786489bc6/go.mod h1:fCa7OJZ/9DRTnOKmxvT6pn+LPWUptQAmHF/SBJUGEcg= +github.com/scaleway/scaleway-sdk-go v1.0.0-beta.14.0.20230314101523-398c37802c41 h1:D9rWQCzAaXoBOEQTnw+x5YI1JLZRj/ccKtT4u5DCC1E= +github.com/scaleway/scaleway-sdk-go v1.0.0-beta.14.0.20230314101523-398c37802c41/go.mod h1:fCa7OJZ/9DRTnOKmxvT6pn+LPWUptQAmHF/SBJUGEcg= github.com/sergi/go-diff v1.2.0 h1:XU+rvMAioB0UC3q1MFrIQy4Vo5/4VsRDQQXHsEya6xQ= github.com/sergi/go-diff v1.2.0/go.mod h1:STckp+ISIX8hZLjrqAeVduY0gWCT9IjLuqbuNXdaHfM= github.com/spf13/cobra v1.6.1 h1:o94oiPyS4KD1mPy2fmcYYHHfCxLqYjJOhGsCHFZtEzA= diff --git a/internal/namespaces/baremetal/v1/baremetal_cli.go b/internal/namespaces/baremetal/v1/baremetal_cli.go index e6f532bbf2..3a16691499 100644 --- a/internal/namespaces/baremetal/v1/baremetal_cli.go +++ b/internal/namespaces/baremetal/v1/baremetal_cli.go @@ -57,8 +57,8 @@ func GetGeneratedCommands() *core.Commands { } func baremetalRoot() *core.Command { return &core.Command{ - Short: `Elastic metal API`, - Long: `This API allows to manage your Bare metal server.`, + Short: `Elastic Metal API`, + Long: `This API allows to manage your Elastic Metal server.`, Namespace: "baremetal", } } @@ -75,8 +75,8 @@ func baremetalServer() *core.Command { func baremetalOffer() *core.Command { return &core.Command{ Short: `Server offer management commands`, - Long: `Server offers will answer with all different elastic metal server ranges available in a given zone. -Each of them will contain all the features of the server (cpus, memories, disks) with their associated pricing. + Long: `Server offers will answer with all different Elastic Metal server ranges available in a zone. +Each of them will contain all the features of the server (CPUs, memory, disks) with their associated pricing. `, Namespace: "baremetal", Resource: "offer", @@ -95,9 +95,9 @@ func baremetalOs() *core.Command { func baremetalBmc() *core.Command { return &core.Command{ Short: `Baseboard Management Controller (BMC) management commands`, - Long: `Baseboard Management Controller (BMC) allows you to remotely access the low-level parameters of your dedicated server. + Long: `A Baseboard Management Controller (BMC) allows you to remotely access the low-level parameters of your dedicated server. For instance, your KVM-IP management console could be accessed with it. -You need first to create an option Remote Access. You will find the ID and the price with a call to listOffers (https://developers.scaleway.com/en/products/baremetal/api/#get-78db92). Then you can add the option https://developers.scaleway.com/en/products/baremetal/api/#post-b14abd. Do not forget to delete the Option. +You need first to create an Remote Access option. You will find the ID and the price with a call to listOffers (https://developers.scaleway.com/en/products/baremetal/api/#get-78db92). Then you can add the option https://developers.scaleway.com/en/products/baremetal/api/#post-b14abd. Do not forget to delete the Option. Then you need to create Remote Access https://developers.scaleway.com/en/products/baremetal/api/#post-1af723. And finally Get Remote Access to get the login/password https://developers.scaleway.com/en/products/baremetal/api/#get-cefc0f. `, @@ -119,7 +119,7 @@ func baremetalOptions() *core.Command { func baremetalSettings() *core.Command { return &core.Command{ Short: `Settings management commands`, - Long: `Allows to configure the general settings for your elastic metal server. + Long: `Allows to configure the general settings for your Elastic Metal server. `, Namespace: "baremetal", Resource: "settings", @@ -128,15 +128,15 @@ func baremetalSettings() *core.Command { func baremetalPrivateNetwork() *core.Command { return &core.Command{ - Short: `Private network management command`, - Long: `A private network allows interconnecting your resources + Short: `Private Network management command`, + Long: `A Private Network allows you to interconnect your resources (servers, instances, ...) in an isolated and private network. The network reachability is limited to the -resources that are on the same private network. A VLAN +resources that are on the same Private Network . A VLAN interface is available on the server and can be freely managed (adding IP addresses, shutdown interface...). -Note that a resource can be a part of multiple private networks. +Note that a resource can be a part of multiple Private Networks. `, Namespace: "baremetal", Resource: "private-network", @@ -145,8 +145,8 @@ Note that a resource can be a part of multiple private networks. func baremetalServerList() *core.Command { return &core.Command{ - Short: `List elastic metal servers for organization`, - Long: `List elastic metal servers for organization.`, + Short: `List Elastic Metal servers for an organization`, + Long: `List Elastic Metal servers for a specific organization.`, Namespace: "baremetal", Resource: "server", Verb: "list", @@ -163,42 +163,42 @@ func baremetalServerList() *core.Command { }, { Name: "tags.{index}", - Short: `Filter by tags`, + Short: `Tags to filter for`, Required: false, Deprecated: false, Positional: false, }, { Name: "status.{index}", - Short: `Filter by status`, + Short: `Status to filter for`, Required: false, Deprecated: false, Positional: false, }, { Name: "name", - Short: `Filter by name`, + Short: `Names to filter for`, Required: false, Deprecated: false, Positional: false, }, { Name: "project-id", - Short: `Filter by project ID`, + Short: `Project ID to filter for`, Required: false, Deprecated: false, Positional: false, }, { Name: "option-id", - Short: `Filter by option ID`, + Short: `Option ID to filter for`, Required: false, Deprecated: false, Positional: false, }, { Name: "organization-id", - Short: `Filter by organization ID`, + Short: `Organization ID to filter for`, Required: false, Deprecated: false, Positional: false, @@ -224,7 +224,7 @@ func baremetalServerList() *core.Command { }, Examples: []*core.Example{ { - Short: "List all servers on your default zone", + Short: "List all servers in your default zone", ArgsJSON: `null`, }, }, @@ -233,8 +233,8 @@ func baremetalServerList() *core.Command { func baremetalServerGet() *core.Command { return &core.Command{ - Short: `Get a specific elastic metal server`, - Long: `Get the server associated with the given ID.`, + Short: `Get a specific Elastic Metal server`, + Long: `Get full details of an existing Elastic Metal server associated with the ID.`, Namespace: "baremetal", Resource: "server", Verb: "get", @@ -260,7 +260,7 @@ func baremetalServerGet() *core.Command { }, Examples: []*core.Example{ { - Short: "Get a given server", + Short: "Get a specific server", ArgsJSON: `{"server_id":"11111111-1111-1111-1111-111111111111"}`, }, }, @@ -269,8 +269,8 @@ func baremetalServerGet() *core.Command { func baremetalServerCreate() *core.Command { return &core.Command{ - Short: `Create an elastic metal server`, - Long: `Create a new elastic metal server. Once the server is created, you probably want to install an OS.`, + Short: `Create an Elastic Metal server`, + Long: `Create a new Elastic Metal server. Once the server is created, proceed with the [installation of an OS](#post-3e949e).`, Namespace: "baremetal", Resource: "server", Verb: "create", @@ -294,7 +294,7 @@ func baremetalServerCreate() *core.Command { }, { Name: "description", - Short: `Description associated to the server, max 255 characters`, + Short: `Description associated with the server, max 255 characters`, Required: true, Deprecated: false, Positional: false, @@ -308,7 +308,7 @@ func baremetalServerCreate() *core.Command { }, { Name: "install.os-id", - Short: `ID of the OS to install on the server`, + Short: `ID of the OS to installation on the server`, Required: false, Deprecated: false, Positional: false, @@ -329,21 +329,21 @@ func baremetalServerCreate() *core.Command { }, { Name: "install.user", - Short: `User used for the installation`, + Short: `User for the installation`, Required: false, Deprecated: false, Positional: false, }, { Name: "install.password", - Short: `Password used for the installation`, + Short: `Password for the installation`, Required: false, Deprecated: false, Positional: false, }, { Name: "install.service-user", - Short: `User used for the service to install`, + Short: `Regular user that runs the service to be installed on the server`, Required: false, Deprecated: false, Positional: false, @@ -375,7 +375,7 @@ func baremetalServerCreate() *core.Command { }, Examples: []*core.Example{ { - Short: "Create instance a default elastic metal instance", + Short: "Create a default Elastic Metal server", ArgsJSON: `null`, }, }, @@ -384,8 +384,8 @@ func baremetalServerCreate() *core.Command { func baremetalServerUpdate() *core.Command { return &core.Command{ - Short: `Update an elastic metal server`, - Long: `Update the server associated with the given ID.`, + Short: `Update an Elastic Metal server`, + Long: `Update the server associated with the ID. You can update parameters such as the server's name, tags and description. Any parameters left null in the request body are not updated.`, Namespace: "baremetal", Resource: "server", Verb: "update", @@ -408,14 +408,14 @@ func baremetalServerUpdate() *core.Command { }, { Name: "description", - Short: `Description associated to the server, max 255 characters, not updated if null`, + Short: `Description associated with the server, max 255 characters, not updated if null`, Required: false, Deprecated: false, Positional: false, }, { Name: "tags.{index}", - Short: `Tags associated to the server, not updated if null`, + Short: `Tags associated with the server, not updated if null`, Required: false, Deprecated: false, Positional: false, @@ -435,8 +435,8 @@ func baremetalServerUpdate() *core.Command { func baremetalServerInstall() *core.Command { return &core.Command{ - Short: `Install an elastic metal server`, - Long: `Install an OS on the server associated with the given ID.`, + Short: `Install an Elastic Metal server`, + Long: `Install an Operating System (OS) on the Elastic Metal server with a specific ID.`, Namespace: "baremetal", Resource: "server", Verb: "install", @@ -452,7 +452,7 @@ func baremetalServerInstall() *core.Command { }, { Name: "os-id", - Short: `ID of the OS to install on the server`, + Short: `ID of the OS to installation on the server`, Required: true, Deprecated: false, Positional: false, @@ -511,7 +511,7 @@ func baremetalServerInstall() *core.Command { }, Examples: []*core.Example{ { - Short: "Install an OS on a given server with a particular SSH key ID", + Short: "Install an OS on a server with a particular SSH key ID", ArgsJSON: `{"os_id":"11111111-1111-1111-1111-111111111111","server_id":"11111111-1111-1111-1111-111111111111","ssh_key_ids":["11111111-1111-1111-1111-111111111111"]}`, }, }, @@ -526,7 +526,7 @@ func baremetalServerInstall() *core.Command { }, { Command: "scw baremetal server create", - Short: "Create an elastic metal server", + Short: "Create an Elastic Metal server", }, }, } @@ -534,8 +534,8 @@ func baremetalServerInstall() *core.Command { func baremetalServerDelete() *core.Command { return &core.Command{ - Short: `Delete an elastic metal server`, - Long: `Delete the server associated with the given ID.`, + Short: `Delete an Elastic Metal server`, + Long: `Delete the server associated with the ID.`, Namespace: "baremetal", Resource: "server", Verb: "delete", @@ -561,7 +561,7 @@ func baremetalServerDelete() *core.Command { }, Examples: []*core.Example{ { - Short: "Delete an elastic metal server", + Short: "Delete an Elastic Metal server", ArgsJSON: `{"server_id":"11111111-1111-1111-1111-111111111111"}`, }, }, @@ -570,8 +570,8 @@ func baremetalServerDelete() *core.Command { func baremetalServerReboot() *core.Command { return &core.Command{ - Short: `Reboot an elastic metal server`, - Long: `Reboot the server associated with the given ID, use boot param to reboot in rescue.`, + Short: `Reboot an Elastic Metal server`, + Long: `Reboot the Elastic Metal server associated with the ID, use the ` + "`" + `boot_type` + "`" + ` ` + "`" + `rescue` + "`" + ` to reboot the server in rescue mode.`, Namespace: "baremetal", Resource: "server", Verb: "reboot", @@ -618,8 +618,8 @@ func baremetalServerReboot() *core.Command { func baremetalServerStart() *core.Command { return &core.Command{ - Short: `Start an elastic metal server`, - Long: `Start the server associated with the given ID.`, + Short: `Start an Elastic Metal server`, + Long: `Start the server associated with the ID.`, Namespace: "baremetal", Resource: "server", Verb: "start", @@ -653,7 +653,7 @@ func baremetalServerStart() *core.Command { }, Examples: []*core.Example{ { - Short: "Start an elastic metal server", + Short: "Start an Elastic Metalx server", ArgsJSON: `{"server_id":"11111111-1111-1111-1111-111111111111"}`, }, { @@ -666,8 +666,8 @@ func baremetalServerStart() *core.Command { func baremetalServerStop() *core.Command { return &core.Command{ - Short: `Stop an elastic metal server`, - Long: `Stop the server associated with the given ID.`, + Short: `Stop an Elastic Metal server`, + Long: `Stop the server associated with the ID. The server remains allocated to your account and all data remains on the local storage of the server.`, Namespace: "baremetal", Resource: "server", Verb: "stop", @@ -693,7 +693,7 @@ func baremetalServerStop() *core.Command { }, Examples: []*core.Example{ { - Short: "Stop an elastic metal server", + Short: "Stop an Elastic Metal server", ArgsJSON: `{"server_id":"11111111-1111-1111-1111-111111111111"}`, }, }, @@ -702,11 +702,11 @@ func baremetalServerStop() *core.Command { func baremetalBmcStart() *core.Command { return &core.Command{ - Short: `Start BMC (Baseboard Management Controller) access for a given elastic metal server`, - Long: `Start BMC (Baseboard Management Controller) access associated with the given ID. + Short: `Start BMC access`, + Long: `Start BMC (Baseboard Management Controller) access associated with the ID. The BMC (Baseboard Management Controller) access is available one hour after the installation of the server. -You need first to create an option Remote Access. You will find the ID and the price with a call to listOffers (https://developers.scaleway.com/en/products/baremetal/api/#get-78db92). Then you can add the option https://developers.scaleway.com/en/products/baremetal/api/#post-b14abd. Do not forget to delete the Option. - After start BMC, you need to Get Remote Access to get the login/password https://developers.scaleway.com/en/products/baremetal/api/#get-cefc0f.`, +You need first to create an option Remote Access. You will find the ID and the price with a call to listOffers (https://developers.scaleway.com/en/products/baremetal/api/#get-78db92). Then add the option https://developers.scaleway.com/en/products/baremetal/api/#post-b14abd. +After adding the BMC option, you need to Get Remote Access to get the login/password https://developers.scaleway.com/en/products/baremetal/api/#get-cefc0f. Do not forget to delete the Option after use.`, Namespace: "baremetal", Resource: "bmc", Verb: "start", @@ -722,7 +722,7 @@ You need first to create an option Remote Access. You will find the ID and the p }, { Name: "ip", - Short: `The IP authorized to connect to the given server`, + Short: `The IP authorized to connect to the server`, Required: true, Deprecated: false, Positional: false, @@ -742,8 +742,8 @@ You need first to create an option Remote Access. You will find the ID and the p func baremetalBmcGet() *core.Command { return &core.Command{ - Short: `Get BMC (Baseboard Management Controller) access for a given elastic metal server`, - Long: `Get the BMC (Baseboard Management Controller) access associated with the given ID.`, + Short: `Get BMC access`, + Long: `Get the BMC (Baseboard Management Controller) access associated with the ID, including the URL and login information needed to connect.`, Namespace: "baremetal", Resource: "bmc", Verb: "get", @@ -772,8 +772,8 @@ func baremetalBmcGet() *core.Command { func baremetalBmcStop() *core.Command { return &core.Command{ - Short: `Stop BMC (Baseboard Management Controller) access for a given elastic metal server`, - Long: `Stop BMC (Baseboard Management Controller) access associated with the given ID.`, + Short: `Stop BMC access`, + Long: `Stop BMC (Baseboard Management Controller) access associated with the ID.`, Namespace: "baremetal", Resource: "bmc", Verb: "stop", @@ -809,7 +809,7 @@ func baremetalBmcStop() *core.Command { func baremetalOptionsAdd() *core.Command { return &core.Command{ Short: `Add server option`, - Long: `Add an option to a specific server.`, + Long: `Add an option, such as Private Networks, to a specific server.`, Namespace: "baremetal", Resource: "options", Verb: "add", @@ -849,7 +849,7 @@ func baremetalOptionsAdd() *core.Command { }, Examples: []*core.Example{ { - Short: "Add a given option to a server", + Short: "Add an option, such as Private Networks, to a server", ArgsJSON: `{"option_id":"11111111-1111-1111-1111-111111111111","server_id":"11111111-1111-1111-1111-111111111111"}`, }, }, @@ -892,7 +892,7 @@ func baremetalOptionsDelete() *core.Command { }, Examples: []*core.Example{ { - Short: "Delete a given option from a server", + Short: "Delete an option from a server", ArgsJSON: `{"option_id":"11111111-1111-1111-1111-111111111111","server_id":"11111111-1111-1111-1111-111111111111"}`, }, }, @@ -902,7 +902,7 @@ func baremetalOptionsDelete() *core.Command { func baremetalOfferList() *core.Command { return &core.Command{ Short: `List offers`, - Long: `List all available server offers.`, + Long: `List all available Elastic Metal server configurations.`, Namespace: "baremetal", Resource: "offer", Verb: "list", @@ -911,7 +911,7 @@ func baremetalOfferList() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "subscription-period", - Short: `Period of subscription to filter offers`, + Short: `Subscription period type to filter offers by`, Required: false, Deprecated: false, Positional: false, @@ -952,7 +952,7 @@ func baremetalOfferList() *core.Command { func baremetalOfferGet() *core.Command { return &core.Command{ Short: `Get offer`, - Long: `Return specific offer for the given ID.`, + Long: `Get details of an offer identified by its offer ID.`, Namespace: "baremetal", Resource: "offer", Verb: "get", @@ -978,7 +978,7 @@ func baremetalOfferGet() *core.Command { }, Examples: []*core.Example{ { - Short: "Get a server offer with the given ID", + Short: "Get a server offer with the ID", ArgsJSON: `{"offer_id":"11111111-1111-1111-1111-111111111111","zone":"fr-par-1"}`, }, }, @@ -988,7 +988,7 @@ func baremetalOfferGet() *core.Command { func baremetalOptionsGet() *core.Command { return &core.Command{ Short: `Get option`, - Long: `Return specific option for the given ID.`, + Long: `Return specific option for the ID.`, Namespace: "baremetal", Resource: "options", Verb: "get", @@ -1014,7 +1014,7 @@ func baremetalOptionsGet() *core.Command { }, Examples: []*core.Example{ { - Short: "Get a server option with the given ID", + Short: "Get a server option with the ID", ArgsJSON: `{"option_id":"11111111-1111-1111-1111-111111111111","zone":"fr-par-1"}`, }, }, @@ -1033,14 +1033,14 @@ func baremetalOptionsList() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "offer-id", - Short: `Filter options by offer_id`, + Short: `Offer ID to filter options for`, Required: false, Deprecated: false, Positional: false, }, { Name: "name", - Short: `Filter options by name`, + Short: `Name to filter options for`, Required: false, Deprecated: false, Positional: false, @@ -1089,7 +1089,7 @@ func baremetalSettingsList() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "order-by", - Short: `Order the response`, + Short: `Sort order for items in the response`, Required: false, Deprecated: false, Positional: false, @@ -1143,7 +1143,7 @@ func baremetalSettingsUpdate() *core.Command { }, { Name: "enabled", - Short: `Enable/Disable the setting`, + Short: `Defines whether the setting is enabled`, Required: false, Deprecated: false, Positional: false, @@ -1163,8 +1163,8 @@ func baremetalSettingsUpdate() *core.Command { func baremetalOsList() *core.Command { return &core.Command{ - Short: `List all available OS that can be install on an elastic metal server`, - Long: `List all available OS that can be install on an elastic metal server.`, + Short: `List available OSes`, + Long: `List all OSes that are available for installation on Elastic Metal servers.`, Namespace: "baremetal", Resource: "os", Verb: "list", @@ -1173,7 +1173,7 @@ func baremetalOsList() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "offer-id", - Short: `Filter OS by offer ID`, + Short: `Offer IDs to filter OSes for`, Required: false, Deprecated: false, Positional: false, @@ -1202,8 +1202,8 @@ func baremetalOsList() *core.Command { func baremetalOsGet() *core.Command { return &core.Command{ - Short: `Get an OS with a given ID`, - Long: `Return specific OS for the given ID.`, + Short: `Get an OS with an ID`, + Long: `Return specific OS for the ID.`, Namespace: "baremetal", Resource: "os", Verb: "get", @@ -1238,8 +1238,8 @@ func baremetalOsGet() *core.Command { func baremetalPrivateNetworkAdd() *core.Command { return &core.Command{ - Short: `Add a server to a private network`, - Long: `Add a server to a private network.`, + Short: `Add a server to a Private Network`, + Long: `Add a server to a Private Network.`, Namespace: "baremetal", Resource: "private-network", Verb: "add", @@ -1255,7 +1255,7 @@ func baremetalPrivateNetworkAdd() *core.Command { }, { Name: "private-network-id", - Short: `The ID of the private network`, + Short: `The ID of the Private Network`, Required: true, Deprecated: false, Positional: false, @@ -1275,8 +1275,8 @@ func baremetalPrivateNetworkAdd() *core.Command { func baremetalPrivateNetworkSet() *core.Command { return &core.Command{ - Short: `Set multiple private networks on a server`, - Long: `Set multiple private networks on a server.`, + Short: `Set multiple Private Networks on a server`, + Long: `Set multiple Private Networks on a server.`, Namespace: "baremetal", Resource: "private-network", Verb: "set", @@ -1292,7 +1292,7 @@ func baremetalPrivateNetworkSet() *core.Command { }, { Name: "private-network-ids.{index}", - Short: `The IDs of the private networks`, + Short: `The IDs of the Private Networks`, Required: true, Deprecated: false, Positional: false, @@ -1312,8 +1312,8 @@ func baremetalPrivateNetworkSet() *core.Command { func baremetalPrivateNetworkList() *core.Command { return &core.Command{ - Short: `List the private networks of a server`, - Long: `List the private networks of a server.`, + Short: `List the Private Networks of a server`, + Long: `List the Private Networks of a server.`, Namespace: "baremetal", Resource: "private-network", Verb: "list", @@ -1322,7 +1322,7 @@ func baremetalPrivateNetworkList() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "order-by", - Short: `The sort order for the returned private networks`, + Short: `The sort order for the returned Private Networks`, Required: false, Deprecated: false, Positional: false, @@ -1330,28 +1330,28 @@ func baremetalPrivateNetworkList() *core.Command { }, { Name: "server-id", - Short: `Filter private networks by server ID`, + Short: `Filter Private Networks by server ID`, Required: false, Deprecated: false, Positional: false, }, { Name: "private-network-id", - Short: `Filter private networks by private network ID`, + Short: `Filter Private Networks by Private Network ID`, Required: false, Deprecated: false, Positional: false, }, { Name: "project-id", - Short: `Filter private networks by project ID`, + Short: `Filter Private Networks by Project ID`, Required: false, Deprecated: false, Positional: false, }, { Name: "organization-id", - Short: `Filter private networks by organization ID`, + Short: `Filter Private Networks by Organization ID`, Required: false, Deprecated: false, Positional: false, @@ -1380,8 +1380,8 @@ func baremetalPrivateNetworkList() *core.Command { func baremetalPrivateNetworkDelete() *core.Command { return &core.Command{ - Short: `Delete a private network`, - Long: `Delete a private network.`, + Short: `Delete a Private Network`, + Long: `Delete a Private Network.`, Namespace: "baremetal", Resource: "private-network", Verb: "delete", @@ -1397,7 +1397,7 @@ func baremetalPrivateNetworkDelete() *core.Command { }, { Name: "private-network-id", - Short: `The ID of the private network`, + Short: `The ID of the Private Network`, Required: true, Deprecated: false, Positional: false,