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-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/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/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/iam/v1alpha1/iam_cli.go b/internal/namespaces/iam/v1alpha1/iam_cli.go index e750b7ff1b..067ce5d204 100644 --- a/internal/namespaces/iam/v1alpha1/iam_cli.go +++ b/internal/namespaces/iam/v1alpha1/iam_cli.go @@ -159,7 +159,7 @@ func iamJwt() *core.Command { func iamSSHKeyList() *core.Command { return &core.Command{ Short: `List SSH keys`, - Long: `List SSH keys.`, + Long: `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` + "`" + `.`, Namespace: "iam", Resource: "ssh-key", Verb: "list", @@ -168,7 +168,7 @@ func iamSSHKeyList() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "order-by", - Short: `Sort order of SSH keys`, + Short: `Sort order of the SSH keys`, Required: false, Deprecated: false, Positional: false, @@ -184,21 +184,21 @@ func iamSSHKeyList() *core.Command { }, { Name: "project-id", - Short: `Filter by project ID`, + Short: `Filter by Project ID`, Required: false, Deprecated: false, Positional: false, }, { Name: "disabled", - Short: `Filter out disabled SSH keys or not`, + Short: `Whether to include disabled SSH keys or not`, Required: false, Deprecated: false, Positional: false, }, { Name: "organization-id", - Short: `Filter by organization ID`, + Short: `Filter by Organization ID`, Required: false, Deprecated: false, Positional: false, @@ -243,7 +243,7 @@ func iamSSHKeyList() *core.Command { func iamSSHKeyCreate() *core.Command { return &core.Command{ Short: `Create an SSH key`, - Long: `Create an SSH key.`, + Long: `Add a new SSH key to a Scaleway Project. You must specify the ` + "`" + `name` + "`" + `, ` + "`" + `public_key` + "`" + ` and ` + "`" + `project_id` + "`" + `.`, Namespace: "iam", Resource: "ssh-key", Verb: "create", @@ -260,7 +260,7 @@ func iamSSHKeyCreate() *core.Command { }, { Name: "public-key", - Short: `SSH public key. Currently ssh-rsa, ssh-dss (DSA), ssh-ed25519 and ecdsa keys with NIST curves are supported. Max length is 65000`, + Short: `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`, Required: true, Deprecated: false, Positional: false, @@ -297,7 +297,7 @@ func iamSSHKeyCreate() *core.Command { func iamSSHKeyGet() *core.Command { return &core.Command{ Short: `Get an SSH key`, - Long: `Get an SSH key.`, + Long: `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.`, Namespace: "iam", Resource: "ssh-key", Verb: "get", @@ -326,7 +326,7 @@ func iamSSHKeyGet() *core.Command { func iamSSHKeyUpdate() *core.Command { return &core.Command{ Short: `Update an SSH key`, - Long: `Update an SSH key.`, + Long: `Update the parameters of an SSH key, including ` + "`" + `name` + "`" + ` and ` + "`" + `disable` + "`" + `.`, Namespace: "iam", Resource: "ssh-key", Verb: "update", @@ -368,7 +368,7 @@ func iamSSHKeyUpdate() *core.Command { func iamSSHKeyDelete() *core.Command { return &core.Command{ Short: `Delete an SSH key`, - Long: `Delete an SSH key.`, + Long: `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.`, Namespace: "iam", Resource: "ssh-key", Verb: "delete", @@ -417,8 +417,8 @@ func iamSSHKeyDelete() *core.Command { func iamUserList() *core.Command { return &core.Command{ - Short: `List users of an organization`, - Long: `List users of an organization.`, + Short: `List users of an Organization`, + Long: `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` + "`" + `.`, Namespace: "iam", Resource: "user", Verb: "list", @@ -436,14 +436,14 @@ func iamUserList() *core.Command { }, { Name: "user-ids.{index}", - Short: `Filter out by a list of ID`, + Short: `Filter by list of IDs`, Required: false, Deprecated: false, Positional: false, }, { Name: "organization-id", - Short: `ID of organization to filter`, + Short: `ID of the Organization to filter`, Required: true, Deprecated: false, Positional: false, @@ -467,8 +467,8 @@ func iamUserList() *core.Command { func iamUserGet() *core.Command { return &core.Command{ - Short: `Retrieve a user from its ID`, - Long: `Retrieve a user from its ID.`, + Short: `Get a given user`, + Long: `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.`, Namespace: "iam", Resource: "user", Verb: "get", @@ -477,7 +477,7 @@ func iamUserGet() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "user-id", - Short: `ID of user to find`, + Short: `ID of the user to find`, Required: true, Deprecated: false, Positional: true, @@ -496,8 +496,8 @@ func iamUserGet() *core.Command { func iamUserDelete() *core.Command { return &core.Command{ - Short: `Delete a guest user from an organization`, - Long: `Delete a guest user from an organization.`, + Short: `Delete a guest user from an Organization`, + Long: `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.`, Namespace: "iam", Resource: "user", Verb: "delete", @@ -506,7 +506,7 @@ func iamUserDelete() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "user-id", - Short: `ID of user to delete`, + Short: `ID of the user to delete`, Required: true, Deprecated: false, Positional: true, @@ -531,8 +531,8 @@ func iamUserDelete() *core.Command { func iamApplicationList() *core.Command { return &core.Command{ - Short: `List applications of an organization`, - Long: `List applications of an organization.`, + Short: `List applications of an Organization`, + Long: `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` + "`" + `.`, Namespace: "iam", Resource: "application", Verb: "list", @@ -550,28 +550,28 @@ func iamApplicationList() *core.Command { }, { Name: "name", - Short: `Name of application to filter`, + Short: `Name of the application to filter`, Required: false, Deprecated: false, Positional: false, }, { Name: "editable", - Short: `Filter out editable applications or not`, + Short: `Whether to filter out editable applications or not`, Required: false, Deprecated: false, Positional: false, }, { Name: "application-ids.{index}", - Short: `Filter out by a list of ID`, + Short: `Filter by list of IDs`, Required: false, Deprecated: false, Positional: false, }, { Name: "organization-id", - Short: `ID of organization to filter`, + Short: `ID of the Organization to filter`, Required: true, Deprecated: false, Positional: false, @@ -596,7 +596,7 @@ func iamApplicationList() *core.Command { func iamApplicationCreate() *core.Command { return &core.Command{ Short: `Create a new application`, - Long: `Create a new application.`, + Long: `Create a new application. You must define the ` + "`" + `name` + "`" + ` parameter in the request.`, Namespace: "iam", Resource: "application", Verb: "create", @@ -605,7 +605,7 @@ func iamApplicationCreate() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "name", - Short: `Name of application to create (max length is 64 chars)`, + Short: `Name of the application to create (max length is 64 characters)`, Required: true, Deprecated: false, Positional: false, @@ -613,7 +613,7 @@ func iamApplicationCreate() *core.Command { }, { Name: "description", - Short: `Description of application (max length is 200 chars)`, + Short: `Description of the application (max length is 200 characters)`, Required: false, Deprecated: false, Positional: false, @@ -633,8 +633,8 @@ func iamApplicationCreate() *core.Command { func iamApplicationGet() *core.Command { return &core.Command{ - Short: `Get an existing application`, - Long: `Get an existing application.`, + Short: `Get a given application`, + Long: `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.`, Namespace: "iam", Resource: "application", Verb: "get", @@ -643,7 +643,7 @@ func iamApplicationGet() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "application-id", - Short: `ID of application to find`, + Short: `ID of the application to find`, Required: true, Deprecated: false, Positional: true, @@ -662,8 +662,8 @@ func iamApplicationGet() *core.Command { func iamApplicationUpdate() *core.Command { return &core.Command{ - Short: `Update an existing application`, - Long: `Update an existing application.`, + Short: `Update an application`, + Long: `Update the parameters of an application, including ` + "`" + `name` + "`" + ` and ` + "`" + `description` + "`" + `.`, Namespace: "iam", Resource: "application", Verb: "update", @@ -672,21 +672,21 @@ func iamApplicationUpdate() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "application-id", - Short: `ID of application to update`, + Short: `ID of the application to update`, Required: true, Deprecated: false, Positional: true, }, { Name: "name", - Short: `New name of application (max length is 64 chars)`, + Short: `New name for the application (max length is 64 chars)`, Required: false, Deprecated: false, Positional: false, }, { Name: "description", - Short: `New description of application (max length is 200 chars)`, + Short: `New description for the application (max length is 200 chars)`, Required: false, Deprecated: false, Positional: false, @@ -706,7 +706,7 @@ func iamApplicationUpdate() *core.Command { func iamApplicationDelete() *core.Command { return &core.Command{ Short: `Delete an application`, - Long: `Delete an application.`, + Long: `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.`, Namespace: "iam", Resource: "application", Verb: "delete", @@ -715,7 +715,7 @@ func iamApplicationDelete() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "application-id", - Short: `ID of application to delete`, + Short: `ID of the application to delete`, Required: true, Deprecated: false, Positional: true, @@ -741,7 +741,7 @@ func iamApplicationDelete() *core.Command { func iamGroupList() *core.Command { return &core.Command{ Short: `List groups`, - Long: `List groups.`, + Long: `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.`, Namespace: "iam", Resource: "group", Verb: "list", @@ -766,28 +766,28 @@ func iamGroupList() *core.Command { }, { Name: "application-ids.{index}", - Short: `Filter out by a list of application ID`, + Short: `Filter by a list of application IDs`, Required: false, Deprecated: false, Positional: false, }, { Name: "user-ids.{index}", - Short: `Filter out by a list of user ID`, + Short: `Filter by a list of user IDs`, Required: false, Deprecated: false, Positional: false, }, { Name: "group-ids.{index}", - Short: `Filter out by a list of group ID`, + Short: `Filter by a list of group IDs`, Required: false, Deprecated: false, Positional: false, }, { Name: "organization-id", - Short: `Filter by organization ID`, + Short: `Filter by Organization ID`, Required: false, Deprecated: false, Positional: false, @@ -825,8 +825,8 @@ func iamGroupList() *core.Command { func iamGroupCreate() *core.Command { return &core.Command{ - Short: `Create a new group`, - Long: `Create a new group.`, + Short: `Create a group`, + Long: `Create a new group. You must define the ` + "`" + `name` + "`" + ` and ` + "`" + `organization_id` + "`" + ` parameters in the request.`, Namespace: "iam", Resource: "group", Verb: "create", @@ -835,7 +835,7 @@ func iamGroupCreate() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "name", - Short: `Name of the group to create (max length is 64 chars). MUST be unique inside an organization`, + Short: `Name of the group to create (max length is 64 chars). MUST be unique inside an Organization`, Required: true, Deprecated: false, Positional: false, @@ -884,7 +884,7 @@ func iamGroupCreate() *core.Command { func iamGroupGet() *core.Command { return &core.Command{ Short: `Get a group`, - Long: `Get a group.`, + Long: `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.`, Namespace: "iam", Resource: "group", Verb: "get", @@ -893,7 +893,7 @@ func iamGroupGet() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "group-id", - Short: `ID of group`, + Short: `ID of the group`, Required: true, Deprecated: false, Positional: true, @@ -913,7 +913,7 @@ func iamGroupGet() *core.Command { func iamGroupUpdate() *core.Command { return &core.Command{ Short: `Update a group`, - Long: `Update a group.`, + Long: `Update the parameters of group, including ` + "`" + `name` + "`" + ` and ` + "`" + `description` + "`" + `.`, Namespace: "iam", Resource: "group", Verb: "update", @@ -922,14 +922,14 @@ func iamGroupUpdate() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "group-id", - Short: `ID of group to update`, + Short: `ID of the group to update`, Required: true, Deprecated: false, Positional: true, }, { Name: "name", - Short: `New name for the group (max length is 64 chars). MUST be unique inside an organization`, + Short: `New name for the group (max length is 64 chars). MUST be unique inside an Organization`, Required: false, Deprecated: false, Positional: false, @@ -955,8 +955,8 @@ func iamGroupUpdate() *core.Command { func iamGroupAddMember() *core.Command { return &core.Command{ - Short: `Add a user of an application to a group`, - Long: `Add a user of an application to a group.`, + Short: `Add a user or an application to a group`, + Long: `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.`, Namespace: "iam", Resource: "group", Verb: "add-member", @@ -965,7 +965,7 @@ func iamGroupAddMember() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "group-id", - Short: `ID of group`, + Short: `ID of the group`, Required: true, Deprecated: false, Positional: true, @@ -999,7 +999,7 @@ func iamGroupAddMember() *core.Command { func iamGroupRemoveMember() *core.Command { return &core.Command{ Short: `Remove a user or an application from a group`, - Long: `Remove a user or an application from a group.`, + Long: `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.`, Namespace: "iam", Resource: "group", Verb: "remove-member", @@ -1008,7 +1008,7 @@ func iamGroupRemoveMember() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "group-id", - Short: `ID of group`, + Short: `ID of the group`, Required: true, Deprecated: false, Positional: true, @@ -1052,7 +1052,7 @@ func iamGroupRemoveMember() *core.Command { func iamGroupDelete() *core.Command { return &core.Command{ Short: `Delete a group`, - Long: `Delete a group.`, + Long: `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.`, Namespace: "iam", Resource: "group", Verb: "delete", @@ -1061,7 +1061,7 @@ func iamGroupDelete() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "group-id", - Short: `ID of group to delete`, + Short: `ID of the group to delete`, Required: true, Deprecated: false, Positional: true, @@ -1102,8 +1102,8 @@ func iamGroupDelete() *core.Command { func iamPolicyList() *core.Command { return &core.Command{ - Short: `List policies of an organization`, - Long: `List policies of an organization.`, + Short: `List policies of an Organization`, + Long: `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` + "`" + `.`, Namespace: "iam", Resource: "policy", Verb: "list", @@ -1121,49 +1121,49 @@ func iamPolicyList() *core.Command { }, { Name: "editable", - Short: `Filter out editable policies or not`, + Short: `Whether or not filter out editable policies`, Required: false, Deprecated: false, Positional: false, }, { Name: "user-ids.{index}", - Short: `Filter out by a list of user ID`, + Short: `Whether or not to filter by list of user IDs`, Required: false, Deprecated: false, Positional: false, }, { Name: "group-ids.{index}", - Short: `Filter out by a list of group ID`, + Short: `Whether or not to filter by list of group IDs`, Required: false, Deprecated: false, Positional: false, }, { Name: "application-ids.{index}", - Short: `Filter out by a list of application ID`, + Short: `Filter by a list of application IDs`, Required: false, Deprecated: false, Positional: false, }, { Name: "no-principal", - Short: `True when the policy do not belong to any principal`, + Short: `Whether or not the policy is attributed to a principal`, Required: false, Deprecated: false, Positional: false, }, { Name: "policy-name", - Short: `Name of policy to fetch`, + Short: `Name of the policy to fetch`, Required: false, Deprecated: false, Positional: false, }, { Name: "organization-id", - Short: `ID of organization to filter`, + Short: `ID of the Organization to filter`, Required: true, Deprecated: false, Positional: false, @@ -1188,7 +1188,7 @@ func iamPolicyList() *core.Command { func iamPolicyCreate() *core.Command { return &core.Command{ Short: `Create a new policy`, - Long: `Create a new policy.`, + Long: `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.`, Namespace: "iam", Resource: "policy", Verb: "create", @@ -1197,7 +1197,7 @@ func iamPolicyCreate() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "name", - Short: `Name of policy to create (max length is 64 chars)`, + Short: `Name of the policy to create (max length is 64 characters)`, Required: true, Deprecated: false, Positional: false, @@ -1205,7 +1205,7 @@ func iamPolicyCreate() *core.Command { }, { Name: "description", - Short: `Description of policy to create (max length is 200 chars)`, + Short: `Description of the policy to create (max length is 200 characters)`, Required: false, Deprecated: false, Positional: false, @@ -1219,42 +1219,42 @@ func iamPolicyCreate() *core.Command { }, { Name: "rules.{index}.project-ids.{index}", - Short: `List of project IDs scoped to the rule`, + Short: `List of Project IDs the rule is scoped to`, Required: false, Deprecated: false, Positional: false, }, { Name: "rules.{index}.organization-id", - Short: `ID of organization scoped to the rule`, + Short: `ID of Organization the rule is scoped to`, Required: false, Deprecated: false, Positional: false, }, { Name: "user-id", - Short: `ID of user, owner of the policy`, + Short: `ID of user attributed to the policy`, Required: false, Deprecated: false, Positional: false, }, { Name: "group-id", - Short: `ID of group, owner of the policy`, + Short: `ID of group attributed to the policy`, Required: false, Deprecated: false, Positional: false, }, { Name: "application-id", - Short: `ID of application, owner of the policy`, + Short: `ID of application attributed to the policy`, Required: false, Deprecated: false, Positional: false, }, { Name: "no-principal", - Short: `True when the policy do not belong to any principal`, + Short: `Whether or not a policy is attributed to a principal`, Required: false, Deprecated: false, Positional: false, @@ -1281,7 +1281,7 @@ func iamPolicyCreate() *core.Command { func iamPolicyGet() *core.Command { return &core.Command{ Short: `Get an existing policy`, - Long: `Get an existing policy.`, + Long: `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.`, Namespace: "iam", Resource: "policy", Verb: "get", @@ -1310,7 +1310,7 @@ func iamPolicyGet() *core.Command { func iamPolicyUpdate() *core.Command { return &core.Command{ Short: `Update an existing policy`, - Long: `Update an existing policy.`, + Long: `Update the parameters of a policy, including ` + "`" + `name` + "`" + `, ` + "`" + `description` + "`" + `, ` + "`" + `user_id` + "`" + `, ` + "`" + `group_id` + "`" + `, ` + "`" + `application_id` + "`" + ` and ` + "`" + `no_principal` + "`" + `.`, Namespace: "iam", Resource: "policy", Verb: "update", @@ -1326,42 +1326,42 @@ func iamPolicyUpdate() *core.Command { }, { Name: "name", - Short: `New name of policy (max length is 64 chars)`, + Short: `New name for the policy (max length is 64 characters)`, Required: false, Deprecated: false, Positional: false, }, { Name: "description", - Short: `New description of policy (max length is 200 chars)`, + Short: `New description of policy (max length is 200 characters)`, Required: false, Deprecated: false, Positional: false, }, { Name: "user-id", - Short: `New ID of user, owner of the policy`, + Short: `New ID of user attributed to the policy`, Required: false, Deprecated: false, Positional: false, }, { Name: "group-id", - Short: `New ID of group, owner of the policy`, + Short: `New ID of group attributed to the policy`, Required: false, Deprecated: false, Positional: false, }, { Name: "application-id", - Short: `New ID of application, owner of the policy`, + Short: `New ID of application attributed to the policy`, Required: false, Deprecated: false, Positional: false, }, { Name: "no-principal", - Short: `True when the policy do not belong to any principal`, + Short: `Whether or not the policy is attributed to a principal`, Required: false, Deprecated: false, Positional: false, @@ -1381,7 +1381,7 @@ func iamPolicyUpdate() *core.Command { func iamPolicyDelete() *core.Command { return &core.Command{ Short: `Delete a policy`, - Long: `Delete a policy.`, + Long: `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.`, Namespace: "iam", Resource: "policy", Verb: "delete", @@ -1415,8 +1415,8 @@ func iamPolicyDelete() *core.Command { func iamRuleUpdate() *core.Command { return &core.Command{ - Short: `Set rules of an existing policy`, - Long: `Set rules of an existing policy.`, + Short: `Set rules of a given policy`, + Long: `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.`, Namespace: "iam", Resource: "rule", Verb: "update", @@ -1439,14 +1439,14 @@ func iamRuleUpdate() *core.Command { }, { Name: "rules.{index}.project-ids.{index}", - Short: `List of project IDs scoped to the rule`, + Short: `List of Project IDs the rule is scoped to`, Required: false, Deprecated: false, Positional: false, }, { Name: "rules.{index}.organization-id", - Short: `ID of organization scoped to the rule`, + Short: `ID of Organization the rule is scoped to`, Required: false, Deprecated: false, Positional: false, @@ -1465,8 +1465,8 @@ func iamRuleUpdate() *core.Command { func iamRuleList() *core.Command { return &core.Command{ - Short: `List rules of an existing policy`, - Long: `List rules of an existing policy.`, + Short: `List rules of a given policy`, + Long: `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.`, Namespace: "iam", Resource: "rule", Verb: "list", @@ -1500,7 +1500,7 @@ func iamRuleList() *core.Command { func iamPermissionSetList() *core.Command { return &core.Command{ Short: `List permission sets`, - Long: `List permission sets.`, + Long: `List permission sets available for given Organization. You must define the ` + "`" + `organization_id` + "`" + ` in the query path of your request.`, Namespace: "iam", Resource: "permission-set", Verb: "list", @@ -1537,7 +1537,7 @@ func iamPermissionSetList() *core.Command { func iamAPIKeyList() *core.Command { return &core.Command{ Short: `List API keys`, - Long: `List API keys.`, + Long: `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` + "`" + `.`, Namespace: "iam", Resource: "api-key", Verb: "list", @@ -1555,56 +1555,56 @@ func iamAPIKeyList() *core.Command { }, { Name: "application-id", - Short: `ID of an application bearer`, + Short: `ID of application that bears the API key`, Required: false, Deprecated: true, Positional: false, }, { Name: "user-id", - Short: `ID of a user bearer`, + Short: `ID of user that bears the API key`, Required: false, Deprecated: true, Positional: false, }, { Name: "editable", - Short: `Filter out editable API keys or not`, + Short: `Whether to filter out editable API keys or not`, Required: false, Deprecated: false, Positional: false, }, { Name: "expired", - Short: `Filter out expired API keys or not`, + Short: `Whether to filter out expired API keys or not`, Required: false, Deprecated: false, Positional: false, }, { Name: "access-key", - Short: `Filter out by access key`, + Short: `Filter by access key`, Required: false, Deprecated: false, Positional: false, }, { Name: "description", - Short: `Filter out by description`, + Short: `Filter by description`, Required: false, Deprecated: false, Positional: false, }, { Name: "bearer-id", - Short: `Filter out by bearer ID`, + Short: `Filter by bearer ID`, Required: false, Deprecated: false, Positional: false, }, { Name: "bearer-type", - Short: `Filter out by type of bearer`, + Short: `Filter by type of bearer`, Required: false, Deprecated: false, Positional: false, @@ -1612,7 +1612,7 @@ func iamAPIKeyList() *core.Command { }, { Name: "organization-id", - Short: `ID of organization`, + Short: `ID of Organization`, Required: true, Deprecated: false, Positional: false, @@ -1654,7 +1654,7 @@ func iamAPIKeyList() *core.Command { func iamAPIKeyCreate() *core.Command { return &core.Command{ Short: `Create an API key`, - Long: `Create an API key.`, + Long: `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.`, Namespace: "iam", Resource: "api-key", Verb: "create", @@ -1663,14 +1663,14 @@ func iamAPIKeyCreate() *core.Command { ArgSpecs: core.ArgSpecs{ { Name: "application-id", - Short: `ID of application principal`, + Short: `ID of the application`, Required: false, Deprecated: false, Positional: false, }, { Name: "user-id", - Short: `ID of user principal`, + Short: `ID of the user`, Required: false, Deprecated: false, Positional: false, @@ -1684,14 +1684,14 @@ func iamAPIKeyCreate() *core.Command { }, { Name: "default-project-id", - Short: `The default project ID to use with object storage`, + Short: `The default Project ID to use with Object Storage`, Required: false, Deprecated: false, Positional: false, }, { Name: "description", - Short: `The description of the API key (max length is 200 chars)`, + Short: `The description of the API key (max length is 200 characters)`, Required: false, Deprecated: false, Positional: false, @@ -1721,7 +1721,7 @@ func iamAPIKeyCreate() *core.Command { func iamAPIKeyGet() *core.Command { return &core.Command{ Short: `Get an API key`, - Long: `Get an API key.`, + Long: `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.`, Namespace: "iam", Resource: "api-key", Verb: "get", @@ -1750,7 +1750,7 @@ func iamAPIKeyGet() *core.Command { func iamAPIKeyUpdate() *core.Command { return &core.Command{ Short: `Update an API key`, - Long: `Update an API key.`, + Long: `Update the parameters of an API key, including ` + "`" + `default_project_id` + "`" + ` and ` + "`" + `description` + "`" + `.`, Namespace: "iam", Resource: "api-key", Verb: "update", @@ -1766,7 +1766,7 @@ func iamAPIKeyUpdate() *core.Command { }, { Name: "default-project-id", - Short: `The new default project ID to set`, + Short: `The new default Project ID to set`, Required: false, Deprecated: false, Positional: false, @@ -1793,7 +1793,7 @@ func iamAPIKeyUpdate() *core.Command { func iamAPIKeyDelete() *core.Command { return &core.Command{ Short: `Delete an API key`, - Long: `Delete an API key.`, + Long: `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.`, Namespace: "iam", Resource: "api-key", Verb: "delete",