Python: KMS, basics

.doc_gen/metadata/kms_metadata.yaml

@@ -36,6 +36,15 @@ kms_TagResource:
             - description:
               snippet_tags:
                 - kms.java2_tag.main
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/kms
+          excerpts:
+            - description:
+              snippet_tags:
+                - python.example_code.kms.KeyManager.decl
+                - python.example_code.kms.TagResource
     PHP:
       versions:
         - sdk_version: 3
@@ -58,6 +67,15 @@ kms_Sign:
             - description:
               snippet_tags:
                 - kms.java2_sign.main
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/kms
+          excerpts:
+            - description:
+              snippet_tags:
+                - python.example_code.kms.KeyEncrypt.decl
+                - python.example_code.kms.Sign
     PHP:
       versions:
         - sdk_version: 3
@@ -69,6 +87,19 @@ kms_Sign:
                 - php.example_code.kms.service.sign
   services:
     kms: {Sign}
+kms_Verify:
+  languages:
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/kms
+          excerpts:
+            - description:
+              snippet_tags:
+                - python.example_code.kms.KeyEncrypt.decl
+                - python.example_code.kms.Verify
+  services:
+    kms: {Verify}
 kms_CreateKey:
   languages:
     Kotlin:
@@ -105,7 +136,7 @@ kms_CreateKey:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.KeyManager
+                - python.example_code.kms.KeyManager.decl
                 - python.example_code.kms.CreateKey
     Ruby:
       versions:
@@ -170,7 +201,7 @@ kms_Decrypt:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.KeyEncrypt
+                - python.example_code.kms.KeyEncrypt.decl
                 - python.example_code.kms.Decrypt
     Ruby:
       versions:
@@ -226,7 +257,7 @@ kms_Encrypt:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.KeyEncrypt
+                - python.example_code.kms.KeyEncrypt.decl
                 - python.example_code.kms.Encrypt
     Ruby:
       versions:
@@ -255,7 +286,7 @@ kms_GenerateDataKey:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.KeyManager
+                - python.example_code.kms.KeyManager.decl
                 - python.example_code.kms.GenerateDataKey
     Rust:
       versions:
@@ -336,7 +367,7 @@ kms_ListKeys:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.KeyManager
+                - python.example_code.kms.KeyManager.decl
                 - python.example_code.kms.ListKeys
     Rust:
       versions:
@@ -357,7 +388,7 @@ kms_ReEncrypt:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.KeyEncrypt
+                - python.example_code.kms.KeyEncrypt.decl
                 - python.example_code.kms.ReEncrypt
     Rust:
       versions:
@@ -422,7 +453,7 @@ kms_CreateAlias:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.AliasManager
+                - python.example_code.kms.AliasManager.decl
                 - python.example_code.kms.CreateAlias
   services:
     kms: {CreateAlias}
@@ -471,7 +502,7 @@ kms_CreateGrant:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.GrantManager
+                - python.example_code.kms.GrantManager.decl
                 - python.example_code.kms.CreateGrant
   services:
     kms: {CreateGrant}
@@ -520,7 +551,7 @@ kms_DescribeKey:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.KeyManager
+                - python.example_code.kms.KeyManager.decl
                 - python.example_code.kms.DescribeKey
   services:
     kms: {DescribeKey}
@@ -569,8 +600,8 @@ kms_DisableKey:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.KeyManager
-                - python.example_code.kms.EnableDisableKey
+                - python.example_code.kms.KeyManager.decl
+                - python.example_code.kms.DisableKey
   services:
     kms: {DisableKey}
 kms_EnableKey:
@@ -618,8 +649,8 @@ kms_EnableKey:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.KeyManager
-                - python.example_code.kms.EnableDisableKey
+                - python.example_code.kms.KeyManager.decl
+                - python.example_code.kms.EnableKey
   services:
     kms: {EnableKey}
 kms_ScheduleKeyDeletion:
@@ -650,7 +681,7 @@ kms_ScheduleKeyDeletion:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.KeyManager
+                - python.example_code.kms.KeyManager.decl
                 - python.example_code.kms.ScheduleKeyDeletion
   services:
     kms: {ScheduleKeyDeletion}
@@ -699,7 +730,7 @@ kms_ListAliases:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.AliasManager
+                - python.example_code.kms.AliasManager.decl
                 - python.example_code.kms.ListAliases
   services:
     kms: {ListAliases}
@@ -713,7 +744,7 @@ kms_UpdateAlias:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.AliasManager
+                - python.example_code.kms.AliasManager.decl
                 - python.example_code.kms.UpdateAlias
   services:
     kms: {UpdateAlias}
@@ -745,7 +776,7 @@ kms_DeleteAlias:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.AliasManager
+                - python.example_code.kms.AliasManager.decl
                 - python.example_code.kms.DeleteAlias
   services:
     kms: {DeleteAlias}
@@ -794,7 +825,7 @@ kms_ListGrants:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.GrantManager
+                - python.example_code.kms.GrantManager.decl
                 - python.example_code.kms.ListGrants
   services:
     kms: {ListGrants}
@@ -808,7 +839,7 @@ kms_RetireGrant:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.GrantManager
+                - python.example_code.kms.GrantManager.decl
                 - python.example_code.kms.RetireGrant
   services:
     kms: {RetireGrant}
@@ -840,7 +871,7 @@ kms_RevokeGrant:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.GrantManager
+                - python.example_code.kms.GrantManager.decl
                 - python.example_code.kms.RevokeGrant
   services:
     kms: {RevokeGrant}
@@ -863,7 +894,7 @@ kms_ListKeyPolicies:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.KeyPolicy
+                - python.example_code.kms.KeyPolicy.decl
                 - python.example_code.kms.ListKeyPolicies
   services:
     kms: {ListKeyPolicies}
@@ -877,7 +908,7 @@ kms_GetKeyPolicy:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.KeyPolicy
+                - python.example_code.kms.KeyPolicy.decl
                 - python.example_code.kms.GetKeyPolicy
   services:
     kms: {GetKeyPolicy}
@@ -900,18 +931,11 @@ kms_PutKeyPolicy:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.KeyPolicy
+                - python.example_code.kms.KeyPolicy.decl
                 - python.example_code.kms.PutKeyPolicy
   services:
     kms: {PutKeyPolicy}
-kms_Scenario_KeyEncryption:
-  title: Encrypt and decrypt text with &KMSlong; using an &AWS; SDK
-  title_abbrev: Encrypt and decrypt text
-  synopsis_list:
-    - Encrypt plain text by using a &kms-key;.
-    - Decrypt ciphertext by using a &kms-key;.
-    - Reencrypt ciphertext by using a second &kms-key;.
-  category: Scenarios
+kms_EnableKeyRotation:
   languages:
     Python:
       versions:
@@ -921,31 +945,10 @@ kms_Scenario_KeyEncryption:
           excerpts:
             - description:
               snippet_tags:
-                - python.example_code.kms.Scenario_KeyEncryption
+                - python.example_code.kms.KeyManager.decl
+                - python.example_code.kms.EnableKeyRotation
   services:
-    kms: {Encrypt, Decrypt, ReEncrypt}
-kms_Scenario_KeyManagement:
-  title: Manage &kms-keys-long; using an &AWS; SDK
-  title_abbrev: Manage keys
-  synopsis_list:
-    - Create a &kms-key;.
-    - List &kms-keys; for your account and get details about them.
-    - Enable and disable &kms-keys;.
-    - Generate a symmetric data key that can be used for client-side encryption.
-    - Delete &kms-keys;.
-  category: Scenarios
-  languages:
-    Python:
-      versions:
-        - sdk_version: 3
-          github: python/example_code/kms
-          sdkguide:
-          excerpts:
-            - description:
-              snippet_tags:
-                - python.example_code.kms.Scenario_KeyManagement
-  services:
-    kms: {CreateKey, ListKeys, DescribeKey, GenerateDataKey, EnableKey, DisableKey, ScheduleKeyDeletion}
+    kms: {EnableKeyRotation}
 kms_Scenario_Basics:
   synopsis_list:
     - Create a &kms-key;.
@@ -969,6 +972,52 @@ kms_Scenario_Basics:
             - description: Define a class that wraps KMS actions.
               snippet_tags:
                 - kms.java2_actions.main   
+    Python:
+      versions:
+        - sdk_version: 3
+          github: python/example_code/kms
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - python.example_code.kms.kms_basics
+            - description: Wrapper class and methods for &kms-key; management.
+              snippet_tags:
+                - python.example_code.kms.KeyManager.decl
+                - python.example_code.kms.CreateKey
+                - python.example_code.kms.DescribeKey
+                - python.example_code.kms.EnableKeyRotation
+                - python.example_code.kms.CreateAsymmetricKey
+                - python.example_code.kms.TagResource
+                - python.example_code.kms.ScheduleKeyDeletion
+            - description: >
+                Wrapper class and methods for &kms-key; aliases.
+              snippet_tags:
+                - python.example_code.kms.AliasManager.decl
+                - python.example_code.kms.CreateAlias
+                - python.example_code.kms.ListAliases
+                - python.example_code.kms.DeleteAlias
+            - description: >
+                Wrapper class and methods for &kms-key; encryption.
+              snippet_tags:
+                - python.example_code.kms.KeyEncrypt.decl
+                - python.example_code.kms.Encrypt
+                - python.example_code.kms.Decrypt
+                - python.example_code.kms.Sign
+                - python.example_code.kms.Verify
+            - description: >
+                Wrapper class and methods for &kms-key; grants.
+              snippet_tags:
+                - python.example_code.kms.GrantManager.decl
+                - python.example_code.kms.CreateGrant
+                - python.example_code.kms.ListGrants
+                - python.example_code.kms.RevokeGrant
+            - description: >
+                Wrapper class and methods for &kms-key; policies.
+              snippet_tags:
+                - python.example_code.kms.KeyPolicy.decl
+                - python.example_code.kms.set_new_policy
+                - python.example_code.kms.GetKeyPolicy
     PHP:
       versions:
         - sdk_version: 3