docs(key_manager): update documentation (#608)

Author: scaleway-bot

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

@@ -515,7 +515,7 @@ async def generate_data_key(
         :param without_plaintext: Default value is `false`, meaning that the plaintext is returned.
         Set it to `true` if you do not wish the plaintext to be returned in the response object.
         :param region: Region to target. If none is passed will use default region from the config.
-        :param algorithm: Encryption algorithm of the data encryption key.
+        :param algorithm: See the `DataKey.Algorithm.SymmetricEncryption` enum for a description of values.
         :return: :class:`DataKey <DataKey>`
 
         Usage:

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

@@ -90,10 +90,7 @@ class Key:
 
     state: KeyState
     """
-    Current state of the key. Values include:
-* `unknown_state`: key is in an unknown state.
-* `enabled`: key can be used for cryptographic operations.
-* `disabled`: key cannot be used for cryptographic operations.
+    See the `Key.State` enum for a description of values.
     """
 
     rotation_count: int
@@ -359,7 +356,7 @@ class GenerateDataKeyRequest:
 
     algorithm: Optional[DataKeyAlgorithmSymmetricEncryption]
     """
-    Encryption algorithm of the data encryption key.
+    See the `DataKey.Algorithm.SymmetricEncryption` enum for a description of values.
     """
 
 

scaleway/scaleway/key_manager/v1alpha1/api.py

@@ -515,7 +515,7 @@ def generate_data_key(
         :param without_plaintext: Default value is `false`, meaning that the plaintext is returned.
         Set it to `true` if you do not wish the plaintext to be returned in the response object.
         :param region: Region to target. If none is passed will use default region from the config.
-        :param algorithm: Encryption algorithm of the data encryption key.
+        :param algorithm: See the `DataKey.Algorithm.SymmetricEncryption` enum for a description of values.
         :return: :class:`DataKey <DataKey>`
 
         Usage:

scaleway/scaleway/key_manager/v1alpha1/types.py

@@ -90,10 +90,7 @@ class Key:
 
     state: KeyState
     """
-    Current state of the key. Values include:
-* `unknown_state`: key is in an unknown state.
-* `enabled`: key can be used for cryptographic operations.
-* `disabled`: key cannot be used for cryptographic operations.
+    See the `Key.State` enum for a description of values.
     """
 
     rotation_count: int
@@ -359,7 +356,7 @@ class GenerateDataKeyRequest:
 
     algorithm: Optional[DataKeyAlgorithmSymmetricEncryption]
     """
-    Encryption algorithm of the data encryption key.
+    See the `DataKey.Algorithm.SymmetricEncryption` enum for a description of values.
     """