Tous les produits
Search
Centre de documentation

:GetKeyPolicy

Dernière mise à jour :Aug 06, 2026

Consulte la stratégie de clé d'une clé principale client (CMK) dans une instance KMS.

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 Resource Access Management (RAM) puisse appeler cette opération, consultez Resource Access Management.

  • Étant donné que le nom de la stratégie de clé peut uniquement être défini sur default, vous devez définir le paramètre PolicyName sur default lors de la consultation de la stratégie de clé. Sinon, une erreur Not Found est renvoyée.

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 ou le nom de ressource Alibaba Cloud (ARN) de la clé.

Remarque

Lorsque vous accédez à une clé dans un autre compte Alibaba Cloud, vous devez saisir l'ARN de la clé. L'ARN d'une clé suit le format acs:kms:${region}:${account}:key/${keyid}.

key-hzz630494463ejqjx****

PolicyName

string

Non

Le nom de la stratégie de clé. Seule la valeur statique default est prise en charge.

default

Éléments de réponse

Élément

Type

Description

Exemple

object

RequestId

string

L'identifiant de la requête. Cet identifiant est un identifiant unique généré par Alibaba Cloud pour la requête. Vous pouvez utiliser cet identifiant pour résoudre les problèmes.

381D5D33-BB8F-395F-8EE4-AE3B84B523C8

Policy

string

La stratégie de clé.

{"Statement": [{"Action": ["kms:*"],"Effect": "Allow","Principal": {"RAM": ["acs:ram::190325303126****:*","acs:ram::119285303511****:*"]},"Resource": ["*"],"Sid": "kms default key policy"}],"Version": "1" }

Exemples

JSON format

{
  "RequestId": "381D5D33-BB8F-395F-8EE4-AE3B84B523C8",
  "Policy": "{\"Statement\": [{\"Action\": [\"kms:*\"],\"Effect\": \"Allow\",\"Principal\": {\"RAM\": [\"acs:ram::190325303126****:*\",\"acs:ram::119285303511****:*\"]},\"Resource\": [\"*\"],\"Sid\": \"kms default key policy\"}],\"Version\": \"1\" }"
}

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.
400 MissingParameter The parameter needed but no provided. The required parameters are not specified.
400 Forbidden.NoPermission This operation is forbidden by permission system. You are not authorized to perform this operation.
400 Forbidden.KeyPolicyUnSupported The specified key does not support key policy. The specified key does not support key policies.
404 Forbidden.KeyNotFound The specified Key is not found. The error message returned because the specified CMK does not exist.
404 Forbidden.ResourceNotFound Policy not found.

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

Notes de version

Consultez Notes de version pour la liste complète.