Importe le matériel de clé généré en externe dans une CMK dont l'origine est EXTERNAL.
Description de l'opération
Lorsque vous appelez CreateKey pour créer une CMK, vous pouvez définir Origin sur EXTERNAL pour spécifier que le matériel de clé provient d'une source externe. Utilisez cette opération pour importer le matériel de clé dans une telle CMK.
-
Pour consulter l'Origin de la CMK, reportez-vous à DescribeKey.
-
Avant d'importer le matériel de clé, appelez GetParametersForImport pour obtenir les paramètres requis pour l'importation, y compris la clé publique et le jeton d'importation.
-
Pour une CMK de type Aliyun_AES_256, le matériel de clé doit être de 256 bits. Pour une CMK de type Aliyun_SM4, le matériel de clé doit être de 128 bits.
-
Vous pouvez définir une date d'expiration pour le matériel de clé, ou définir qu'il n'expire jamais.
-
Vous pouvez réimporter le matériel de clé et réinitialiser la date d'expiration pour la CMK spécifiée à tout moment, mais le même matériel de clé doit être importé.
-
Une fois le matériel de clé importé expiré ou supprimé, la CMK spécifiée devient indisponible jusqu'à ce que le même matériel de clé soit à nouveau importé.
-
Le même matériel de clé peut être importé dans plusieurs CMK, mais les données ou les clés de données chiffrées par une CMK ne peuvent pas être déchiffrées par une autre CMK.
Pour plus d'informations sur la stratégie d'accès requise pour qu'un utilisateur RAM ou un rôle RAM puisse appeler cette opération, reportez-vous à Resource Access Management.
Testez maintenant
Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.
Test
Autorisation RAM
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| KeyId |
string |
Oui |
L'identifiant de la CMK dans laquelle le matériel de clé doit être importé. |
1234abcd-12ab-34cd-56ef-12345678**** |
| EncryptedKeyMaterial |
string |
Oui |
Le matériel de clé chiffré avec la clé publique renvoyée par GetParametersForImport, puis encodé en Base64. |
bCPZx7I6v6KXsqEpr2OXKxuj2CCRtKdwp75Bw+BGncYqBdfjFBYRtOE6HRlT0oeiRDWzwnw9OA54OL36smDJrq4Lo9x0CyYDiuKnRkcKtMtlzW0din7Pd7IlZWWRdVueiw2qpzl7PkUWQGTdsdbzpfJJQ+qj/cRIrk/E83UGyeyytSpgnb+lu0xEYcPajRyWNsbi98N3pqqQzHXNNHO2NJqHlnQgglqTiBEjkGeKFhfKmTc3vjulIdVa3EaVIN6lwWfgx+UUYSrvbA77WDYKlDsZ4SbK2/T7za9Tp1qU7Ynqba7OKGVVj7PMbiaO80AxWZnjUMYCgEp5w7V+seOXqw== |
| ImportToken |
string |
Oui |
Le jeton d'importation obtenu en appelant GetParametersForImport. |
Base64String |
| KeyMaterialExpireUnix |
integer |
Oui |
L'heure à laquelle le matériel de clé expire. Si ce paramètre n'est pas spécifié ou s'il est défini sur 0, le matériel de clé n'expire pas. Remarque
La valeur ne peut pas être antérieure à l'heure à laquelle l'opération est appelée (basée sur l'heure du serveur). |
0 |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
|||
| RequestId |
string |
L'identifiant de la requête. |
ec1017cf-ead4-f3ca-babc-c3b34f3dbecb |
Exemples
JSON format
{
"RequestId": "ec1017cf-ead4-f3ca-babc-c3b34f3dbecb"
}Codes d'erreur
|
Code de statut HTTP |
Code d'erreur |
Message d'erreur |
Description |
|---|---|---|---|
| 400 | InvalidKeyMaterial | key material is invalid | |
| 400 | InvalidImportToken | import token is invalid | |
| 400 | ExpiredImportToken | import token is expired | |
| 400 | Unsupported.Origin | This key origin is not valid for this api | The key origin is not supported for this API operation. |
| 400 | InvalidParameter | The specified parameter is not valid. | An invalid value is specified for the parameter. |
| 404 | InvalidAccessKeyId.NotFound | The Access Key ID provided does not exist in our records. |
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.