doc: use AWS vocabulary in AWS example (#554)

When using AWS S3 buckets (provided by AWS or by another S3-compliant provider) in most cases access is not controlled using username & password combination but instead an aws_access_key_id & aws_secret_access_key (optionally an aws_session_token).

Co-authored-by: Peter Van Bouwel <[email protected]>

extensions/workspaces/openapi.yaml

@@ -114,15 +114,19 @@ paths:
                     title: Amazon S3
                     description: >-
                       Amazon S3 is a cloud storage service provided by Amazon Web Services.
+                      It provides storage containers which are called buckets.
                     intents:
                       - create
                       - register
                     parameters:
-                      username:
-                        title: Username
+                      aws_access_key_id:
+                        title: AWS access key
                         type: string
-                      password:
-                        title: Password
+                      aws_secret_access_key:
+                        title: AWS secret key associated with the access key.
+                        type: string
+                      bucket_name:
+                        title: Bucket name
                         type: string
                     links: []    
   /workspaces:
@@ -374,13 +378,14 @@ components:
     workspace_parameters:
       type: object
       description: >-
-        Additional parameters to register the workspace as defined in `GET /workspace_types`.
+        Additional parameters to register the workspace as defined in `GET /workspace_providers`.
         The structure is not specified by the API.
       additionalProperties:
         description: Any type
       example:
-        username: john_doe
-        password: secret123
+        aws_access_key_id: AKIAI0A0FAKE0EXAMPLE
+        aws_secret_access_key: TheKey1CorrespondingtoAccessKey.
+        bucket_name: my-bucket123
     workspace_properties:
       type: object
       description: >-