docs(secret): update documentation

scaleway-async/scaleway_async/secret/v1alpha1/api.py

@@ -356,9 +356,7 @@ async def create_secret_version(
         :param disable_previous: Disable the previous secret version.
         If there is no previous version or if the previous version was already disabled, does nothing.
         :param password_generation: Options to generate a password.
-        If specified, a random password will be generated. The data field must be empty.
-        By default, the generator will use upper and lower case letters, and digits.
-        This behavior can be tuned using the generation params.
+        If specified, a random password will be generated. The data field must be empty. By default, the generator will use upper and lower case letters, and digits. This behavior can be tuned using the generation parameters.
 
         One-of ('_password_generation'): at most one of 'password_generation' could be set.
         :return: :class:`SecretVersion <SecretVersion>`
@@ -409,7 +407,8 @@ async def get_secret_version(
         Retrieve the metadata of a secret's given version specified by the `region`, `secret_id` and `revision` parameters.
         :param region: Region to target. If none is passed will use default region from the config.
         :param secret_id: ID of the secret.
-        :param revision: Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+        :param revision: Version number.
+        The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
         :return: :class:`SecretVersion <SecretVersion>`
 
         Usage:
@@ -447,7 +446,8 @@ async def get_secret_version_by_name(
         Retrieve the metadata of a secret's given version specified by the `region`, `secret_name` and `revision` parameters.
         :param region: Region to target. If none is passed will use default region from the config.
         :param secret_name: Name of the secret.
-        :param revision: Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+        :param revision: Version number.
+        The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
         :return: :class:`SecretVersion <SecretVersion>`
 
         Usage:
@@ -486,7 +486,8 @@ async def update_secret_version(
         Edit the metadata of a secret's given version, specified by the `region`, `secret_id` and `revision` parameters.
         :param region: Region to target. If none is passed will use default region from the config.
         :param secret_id: ID of the secret.
-        :param revision: Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+        :param revision: Version number.
+        The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
         :param description: Description of the version.
         :return: :class:`SecretVersion <SecretVersion>`
 
@@ -696,7 +697,8 @@ async def destroy_secret_version(
         Delete a secret's version and the sensitive data contained in it. Deleting a version is permanent and cannot be undone.
         :param region: Region to target. If none is passed will use default region from the config.
         :param secret_id: ID of the secret.
-        :param revision: Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+        :param revision: Version number.
+        The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
         :return: :class:`SecretVersion <SecretVersion>`
 
         Usage:
@@ -734,7 +736,8 @@ async def enable_secret_version(
         Make a specific version accessible. You must specify the `region`, `secret_id` and `revision` parameters.
         :param region: Region to target. If none is passed will use default region from the config.
         :param secret_id: ID of the secret.
-        :param revision: Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+        :param revision: Version number.
+        The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
         :return: :class:`SecretVersion <SecretVersion>`
 
         Usage:
@@ -772,7 +775,8 @@ async def disable_secret_version(
         Make a specific version inaccessible. You must specify the `region`, `secret_id` and `revision` parameters.
         :param region: Region to target. If none is passed will use default region from the config.
         :param secret_id: ID of the secret.
-        :param revision: Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+        :param revision: Version number.
+        The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
         :return: :class:`SecretVersion <SecretVersion>`
 
         Usage:
@@ -810,7 +814,8 @@ async def access_secret_version(
         Access sensitive data in a secret's version specified by the `region`, `secret_id` and `revision` parameters.
         :param region: Region to target. If none is passed will use default region from the config.
         :param secret_id: ID of the secret.
-        :param revision: Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+        :param revision: Version number.
+        The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
         :return: :class:`AccessSecretVersionResponse <AccessSecretVersionResponse>`
 
         Usage:
@@ -848,7 +853,8 @@ async def access_secret_version_by_name(
         Access sensitive data in a secret's version specified by the `region`, `secret_name` and `revision` parameters.
         :param region: Region to target. If none is passed will use default region from the config.
         :param secret_name: Name of the secret.
-        :param revision: Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+        :param revision: Version number.
+        The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
         :return: :class:`AccessSecretVersionResponse <AccessSecretVersionResponse>`
 
         Usage:

scaleway-async/scaleway_async/secret/v1alpha1/types.py

@@ -55,7 +55,8 @@ class AccessSecretVersionResponse:
 
     revision: int
     """
-    Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1.
+    Version number.
+    The first version of the secret is numbered 1, and all subsequent revisions augment by 1.
     """
 
     data: str
@@ -390,9 +391,7 @@ class CreateSecretVersionRequest:
     password_generation: Optional[PasswordGenerationParams]
     """
     Options to generate a password.
-    If specified, a random password will be generated. The data field must be empty.
-    By default, the generator will use upper and lower case letters, and digits.
-    This behavior can be tuned using the generation params.
+    If specified, a random password will be generated. The data field must be empty. By default, the generator will use upper and lower case letters, and digits. This behavior can be tuned using the generation parameters.
 
     One-of ('_password_generation'): at most one of 'password_generation' could be set.
     """
@@ -412,7 +411,8 @@ class GetSecretVersionRequest:
 
     revision: str
     """
-    Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+    Version number.
+    The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
     """
 
 
@@ -430,7 +430,8 @@ class GetSecretVersionByNameRequest:
 
     revision: str
     """
-    Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+    Version number.
+    The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
     """
 
 
@@ -448,7 +449,8 @@ class UpdateSecretVersionRequest:
 
     revision: str
     """
-    Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+    Version number.
+    The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
     """
 
     description: Optional[str]
@@ -515,7 +517,8 @@ class DestroySecretVersionRequest:
 
     revision: str
     """
-    Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+    Version number.
+    The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
     """
 
 
@@ -533,7 +536,8 @@ class EnableSecretVersionRequest:
 
     revision: str
     """
-    Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+    Version number.
+    The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
     """
 
 
@@ -551,7 +555,8 @@ class DisableSecretVersionRequest:
 
     revision: str
     """
-    Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+    Version number.
+    The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
     """
 
 
@@ -569,7 +574,8 @@ class AccessSecretVersionRequest:
 
     revision: str
     """
-    Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+    Version number.
+    The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
     """
 
 
@@ -587,5 +593,6 @@ class AccessSecretVersionByNameRequest:
 
     revision: str
     """
-    Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+    Version number.
+    The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
     """

scaleway/scaleway/secret/v1alpha1/api.py

@@ -356,9 +356,7 @@ def create_secret_version(
         :param disable_previous: Disable the previous secret version.
         If there is no previous version or if the previous version was already disabled, does nothing.
         :param password_generation: Options to generate a password.
-        If specified, a random password will be generated. The data field must be empty.
-        By default, the generator will use upper and lower case letters, and digits.
-        This behavior can be tuned using the generation params.
+        If specified, a random password will be generated. The data field must be empty. By default, the generator will use upper and lower case letters, and digits. This behavior can be tuned using the generation parameters.
 
         One-of ('_password_generation'): at most one of 'password_generation' could be set.
         :return: :class:`SecretVersion <SecretVersion>`
@@ -409,7 +407,8 @@ def get_secret_version(
         Retrieve the metadata of a secret's given version specified by the `region`, `secret_id` and `revision` parameters.
         :param region: Region to target. If none is passed will use default region from the config.
         :param secret_id: ID of the secret.
-        :param revision: Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+        :param revision: Version number.
+        The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
         :return: :class:`SecretVersion <SecretVersion>`
 
         Usage:
@@ -447,7 +446,8 @@ def get_secret_version_by_name(
         Retrieve the metadata of a secret's given version specified by the `region`, `secret_name` and `revision` parameters.
         :param region: Region to target. If none is passed will use default region from the config.
         :param secret_name: Name of the secret.
-        :param revision: Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+        :param revision: Version number.
+        The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
         :return: :class:`SecretVersion <SecretVersion>`
 
         Usage:
@@ -486,7 +486,8 @@ def update_secret_version(
         Edit the metadata of a secret's given version, specified by the `region`, `secret_id` and `revision` parameters.
         :param region: Region to target. If none is passed will use default region from the config.
         :param secret_id: ID of the secret.
-        :param revision: Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+        :param revision: Version number.
+        The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
         :param description: Description of the version.
         :return: :class:`SecretVersion <SecretVersion>`
 
@@ -696,7 +697,8 @@ def destroy_secret_version(
         Delete a secret's version and the sensitive data contained in it. Deleting a version is permanent and cannot be undone.
         :param region: Region to target. If none is passed will use default region from the config.
         :param secret_id: ID of the secret.
-        :param revision: Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+        :param revision: Version number.
+        The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
         :return: :class:`SecretVersion <SecretVersion>`
 
         Usage:
@@ -734,7 +736,8 @@ def enable_secret_version(
         Make a specific version accessible. You must specify the `region`, `secret_id` and `revision` parameters.
         :param region: Region to target. If none is passed will use default region from the config.
         :param secret_id: ID of the secret.
-        :param revision: Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+        :param revision: Version number.
+        The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
         :return: :class:`SecretVersion <SecretVersion>`
 
         Usage:
@@ -772,7 +775,8 @@ def disable_secret_version(
         Make a specific version inaccessible. You must specify the `region`, `secret_id` and `revision` parameters.
         :param region: Region to target. If none is passed will use default region from the config.
         :param secret_id: ID of the secret.
-        :param revision: Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+        :param revision: Version number.
+        The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
         :return: :class:`SecretVersion <SecretVersion>`
 
         Usage:
@@ -810,7 +814,8 @@ def access_secret_version(
         Access sensitive data in a secret's version specified by the `region`, `secret_id` and `revision` parameters.
         :param region: Region to target. If none is passed will use default region from the config.
         :param secret_id: ID of the secret.
-        :param revision: Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+        :param revision: Version number.
+        The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
         :return: :class:`AccessSecretVersionResponse <AccessSecretVersionResponse>`
 
         Usage:
@@ -848,7 +853,8 @@ def access_secret_version_by_name(
         Access sensitive data in a secret's version specified by the `region`, `secret_name` and `revision` parameters.
         :param region: Region to target. If none is passed will use default region from the config.
         :param secret_name: Name of the secret.
-        :param revision: Version number. The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
+        :param revision: Version number.
+        The first version of the secret is numbered 1, and all subsequent revisions augment by 1. Value can be a number or "latest".
         :return: :class:`AccessSecretVersionResponse <AccessSecretVersionResponse>`
 
         Usage: