Obtient le texte en clair d'une clé de données gérée (DK).
Description de l'opération
Pour plus d'informations sur la stratégie d'accès qui doit être accordée à un utilisateur RAM ou à un rôle RAM pour appeler cette opération, reportez-vous au contrôle d'accès.\n\nCette opération peut être appelée via une passerelle partagée. Pour plus d'informations, reportez-vous au SDK Alibaba Cloud.\n\n- Passerelle partagée : accédez à KMS via des points de terminaison publics ou VPC.
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
Syntaxe de la requête
GET HTTP/1.1Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| DataKeyName |
string |
Non |
Le nom de la clé de données gérée (DK). Ce paramètre est requis. |
example-data-key |
| DataKeyVersionId |
string |
Non |
Le numéro de version de la clé de données gérée (DK). Ce paramètre est facultatif. Si vous définissez ce paramètre sur un numéro de version spécifique, le texte en clair de la version spécifiée de la clé de données gérée (DK) est renvoyé. |
xH6OPUmz |
| UseLatest |
boolean |
Non |
Indique si la dernière version de la clé de données gérée (DK) doit être utilisée lorsqu'aucun numéro de version n'est fourni. Valeurs valides :\n\n- true : renvoie la dernière version de la clé de données gérée (DK).\n- false : renvoie la première version de la clé de données gérée (DK).\n\nValeur par défaut : false. |
true |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
Schéma de la réponse. |
||
| RequestId |
string |
L'identifiant de la requête. Alibaba Cloud génère un identifiant unique pour chaque requête. Vous pouvez utiliser l'identifiant de la requête pour résoudre les problèmes. |
4bd560a1-729e-45f1-a3d9-b2a33d61046b |
| DataKeyName |
string |
Le nom de la clé de données gérée (DK). |
example-data-key |
| DataKeyVersionName |
string |
Le nom de l'identifiant qui stocke le matériel de clé de la version de la clé de données gérée (DK) renvoyée. |
kms-datakeyversion!example-data-key!xH6OPUmz |
| DataKeyVersionId |
string |
Le numéro de version de la clé de données gérée (DK) renvoyée. |
xH6OPUmz |
| Plaintext |
string |
La valeur en texte clair encodée en Base64 de la clé de données (DK). |
CYueyVmZJ2MfA1VSZV2jCbFT8bO7StAvBnHacplr9aI= |
Exemples
JSON format
{
"RequestId": "4bd560a1-729e-45f1-a3d9-b2a33d61046b",
"DataKeyName": "example-data-key",
"DataKeyVersionName": "kms-datakeyversion!example-data-key!xH6OPUmz",
"DataKeyVersionId": "xH6OPUmz\n",
"Plaintext": "CYueyVmZJ2MfA1VSZV2jCbFT8bO7StAvBnHacplr9aI="
}Codes d'erreur
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.