GetPublicKey - - Centre de documentation Alibaba Cloud

Description de l'opération

Pour plus d'informations sur la stratégie d'accès requise pour qu'un utilisateur ou un rôle RAM puisse appeler cette opération OpenAPI, consultez Resource Access Management.\n\n- Cette opération prend en charge à la fois les passerelles partagées et les passerelles dédiées. Pour plus d'informations, consultez Alibaba Cloud SDK.\n\n - Passerelle partagée : vous pouvez accéder à KMS via Internet ou à l'aide d'un nom de domaine VPC. Si vous accédez à KMS via Internet, vous devez activer l'accès à Internet. Pour plus d'informations, consultez Accès aux clés d'une instance KMS via Internet.\n\n - Passerelle dédiée : vous pouvez accéder à KMS à l'aide du point de terminaison privé de KMS (<YOUR_KMS_INSTANCE_ID>.cryptoservice.kms.aliyuncs.com).

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

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
KeyId	string	Oui	L'identifiant globalement unique de la clé principale client (CMK). Ce paramètre peut également être un alias associé à la CMK. Pour plus d'informations, consultez Utilisation des alias.	5c438b18-05be-40ad-b6c2-3be6752c****
KeyVersionId	string	Oui	L'identifiant globalement unique de la version de la clé.	2ab1a983-7072-4bbc-a582-584b5bd8****
DryRun	string	Non	Indique si le mode DryRun doit être activé. true : active le mode DryRun. false (par défaut) : désactive le mode DryRun. Le mode DryRun est utilisé pour tester les appels d'API, vérifier vos autorisations sur les ressources et contrôler la validité des paramètres. Si vous activez le mode DryRun, KMS renvoie toujours une réponse d'échec et un motif d'échec. Les motifs d'échec incluent les éléments suivants : DryRunOperationError : la requête aurait réussi si le paramètre DryRun n'avait pas été spécifié. ValidationError : les paramètres spécifiés dans la requête sont invalides. AccessDeniedError : vous n'êtes pas autorisé à effectuer l'opération sur la ressource KMS.	false

Éléments de réponse

Élément	Type	Description	Exemple
	object
KeyVersionId	string	L'identifiant globalement unique de la version de la clé.	2ab1a983-7072-4bbc-a582-584b5bd8****
KeyId	string	L'identifiant globalement unique de la CMK.\n\n> Si vous spécifiez un alias de la CMK pour le paramètre KeyId dans la requête, l'identifiant de la CMK à laquelle l'alias est associé est renvoyé.	5c438b18-05be-40ad-b6c2-3be6752c****
RequestId	string	L'identifiant de la requête.	475f1620-b9d3-4d35-b5c6-3fbdd941423d
PublicKey	string	La clé publique au format PEM.	-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAs5Yu9AEgATN2/e3nUz1K\nEy6ng8MSPutcse2/VECG/NUF9C6D4IsJ64ShzY3dcn34WYzTOe916eMJFxyrNrSw\nHtc4UOR5AvaoRrfpgu2uq+i70/ZXrWL+pGb1hgZV8cWheIHMxwrR3IiQlM5qN7EF\n9BdyWtyBfUGsp0Bn1VqlPc5G0x0a9xU2z9YtP994yDenNVIoIQ6Cov1lIEuwXAb2\n7boC41ePXwD0JWt41sP+rgCmpjBx00puIG+IlnoReEgI1ZGYmK98GgA/XzmNjZiD\nyvXJZAcM33Ue85+PkR5iHTtSEbi4QAoqpJabprUzz3Fin2j1dRrcacxGb7p31A9c\nJQIDAQAB\n-----END PUBLIC KEY-----\n

Exemples

JSON format

{
  "KeyVersionId": "2ab1a983-7072-4bbc-a582-584b5bd8****",
  "KeyId": "5c438b18-05be-40ad-b6c2-3be6752c****",
  "RequestId": "475f1620-b9d3-4d35-b5c6-3fbdd941423d",
  "PublicKey": "-----BEGIN PUBLIC KEY-----\\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAs5Yu9AEgATN2/e3nUz1K\\nEy6ng8MSPutcse2/VECG/NUF9C6D4IsJ64ShzY3dcn34WYzTOe916eMJFxyrNrSw\\nHtc4UOR5AvaoRrfpgu2uq+i70/ZXrWL+pGb1hgZV8cWheIHMxwrR3IiQlM5qN7EF\\n9BdyWtyBfUGsp0Bn1VqlPc5G0x0a9xU2z9YtP994yDenNVIoIQ6Cov1lIEuwXAb2\\n7boC41ePXwD0JWt41sP+rgCmpjBx00puIG+IlnoReEgI1ZGYmK98GgA/XzmNjZiD\\nyvXJZAcM33Ue85+PkR5iHTtSEbi4QAoqpJabprUzz3Fin2j1dRrcacxGb7p31A9c\\nJQIDAQAB\\n-----END PUBLIC KEY-----\\n"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
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.
404	Forbidden.KeyNotFound	The specified Key is not found.	The error message returned because the specified CMK does not exist.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.