Définit la stratégie de clé pour une 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 RAM ou un rôle RAM puisse appeler cette opération d'API, consultez Resource Access Management.
-
Pour plus d'informations sur les stratégies de clé, consultez Présentation des stratégies de clé.
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 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 |
key-hzz630494463ejqjx**** |
| PolicyName |
string |
Non |
Le nom de la stratégie de clé. Le nom peut uniquement être |
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 :
Le code suivant fournit un exemple de stratégie de clé :
La section suivante décrit les éléments d'une instruction (Statement) :
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.