Tous les produits
Search
Centre de documentation

:SetKeyPolicy

Dernière mise à jour :Aug 06, 2026

Définit la stratégie de clé pour une CMK dans une instance KMS.

Description de l'opération

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

Pour accéder à une clé d'un autre compte Alibaba Cloud, vous devez spécifier l'ARN de la clé. L'ARN de la clé est au format acs:kms:${region}:${account}:key/${keyid}.

key-hzz630494463ejqjx****

PolicyName

string

Non

Le nom de la stratégie de clé. Le nom peut uniquement être default.

default

Policy

string

Oui

La stratégie de clé. La stratégie est au format JSON. La stratégie peut comporter jusqu'à 32 768 octets.

Une stratégie de clé contient les éléments suivants :

  • Version : la version de la stratégie de clé. La valeur peut uniquement être 1.

  • Statement : l'instruction de la stratégie de clé. Chaque stratégie de clé peut contenir une ou plusieurs instructions.

Le code suivant fournit un exemple de stratégie de clé :

{
    "Version": "1",
    "Statement": [
        {
            "Sid": "Enable RAM User Permissions",
            "Effect": "Allow",
            "Principal": {
              "RAM": ["acs:ram::112890462****:*"]
            },
            "Action": [
                "kms:*"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}

La section suivante décrit les éléments d'une instruction (Statement) :

  • Sid : facultatif. L'identifiant d'instruction personnalisé. La valeur peut comporter jusqu'à 128 caractères et peut contenir des lettres majuscules, des lettres minuscules, des chiffres et les caractères spéciaux suivants : _ / + = . @ -.

  • Effect : requis. L'effet de l'instruction de stratégie. Valeurs valides : Allow et Deny.

  • Principal : requis. Le principal autorisé à accéder à la clé. Vous pouvez définir ce paramètre sur le compte Alibaba Cloud actuel, un utilisateur RAM ou un rôle RAM du compte Alibaba Cloud actuel, ou un utilisateur RAM ou un rôle RAM d'un autre compte Alibaba Cloud.

  • Action : requis. Les opérations d'API autorisées ou refusées. La valeur doit commencer par kms:. Pour plus d'informations sur les opérations, consultez Présentation des stratégies de clé. Si vous spécifiez une opération qui n'est pas incluse dans la liste, l'opération ne prendra pas effet.

  • Resource : requis. La clé. La valeur peut uniquement être *.

  • Condition : facultatif. Les conditions de prise d'effet de la stratégie. Vous pouvez utiliser des conditions pour évaluer le contexte d'une requête d'API afin de déterminer si l'instruction de stratégie est applicable. Le format est "Condition": {"condition operator": {"condition key": "condition value"}}. Pour plus d'informations, consultez Présentation des stratégies de clé.

Remarque

Après avoir accordé des autorisations à un utilisateur RAM ou à un rôle RAM d'un autre compte Alibaba Cloud, vous devez utiliser le compte Alibaba Cloud auquel l'utilisateur RAM ou le rôle RAM appartient pour lui accorder les autorisations d'utilisation de la clé dans la console RAM. Pour plus d'informations, consultez Stratégies personnalisées pour KMS, Accorder des autorisations à un utilisateur RAM et Accorder des autorisations à un rôle RAM.

{"Statement":[{"Action":["kms:*"],"Effect":"Allow","Principal":{"RAM":["acs:ram::119285303511****:*"]},"Resource":["*"],"Sid":"kms default key policy"},{"Action":["kms:List*","kms:Describe*","kms:Create*","kms:Enable*","kms:Disable*","kms:Get*","kms:Set*","kms:Update*","kms:Delete*","kms:Cancel*","kms:TagResource","kms:UntagResource","kms:ImportKeyMaterial","kms:ScheduleKeyDeletion"],"Effect":"Allow","Principal":{"RAM":["acs:ram::119285303511****:user/for_test_policy"]},"Resource":["*"]}],"Version":"1"}

Éléments de réponse

Élément

Type

Description

Exemple

object

RequestId

string

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

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

Exemples

JSON format

{
  "RequestId": "381D5D33-BB8F-395F-8EE4-AE3BB4B523C8"
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 MissingParameter The parameter needed but no provided. The required parameters are not specified.
400 InvalidParameter The specified parameter is not valid. An invalid value is specified for the parameter.
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.
400 Rejected.ShareQuotaExceedLimit Instance Share Quota Exceed Limit. The instance share quota exceeds the limit.
500 InternalFailure Internal Failure An internal error occurred.
403 Forbidden.DKMSInstanceStateInvalid The DKMS instance state is invalid. Your dedicated KMS instance is invalid.
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.