Smaws_Client_KMS.RevokeGrantDeletes the specified grant. You revoke a grant to terminate the permissions that the grant allows. For more information, see Retiring and revoking grants in the Key Management Service Developer Guide.
When you create, retire, or revoke a grant, there might be a brief delay, usually less than five minutes, until the grant is available throughout KMS. This state is known as eventual consistency. For details, see Eventual consistency in the Key Management Service Developer Guide.
For detailed information about grants, including grant terminology, see Grants in KMS in the Key Management Service Developer Guide. For examples of creating grants in several programming languages, see Use CreateGrant with an Amazon Web Services SDK or CLI.
Cross-account use: Yes. To perform this operation on a KMS key in a different Amazon Web Services account, specify the key ARN in the value of the KeyId parameter.
Required permissions: kms:RevokeGrant (key policy).
Related operations:
CreateGrantListGrantsListRetirableGrantsRetireGrantEventual consistency: The KMS API follows an eventual consistency model. For more information, see KMS eventual consistency.
val request :
Smaws_Lib.Context.t ->
Types.revoke_grant_request ->
(Smaws_Lib.Smithy_api.Types.unit_,
[> Smaws_Lib.Protocols.AwsJson.error
| `DependencyTimeoutException of Types.dependency_timeout_exception
| `DryRunOperationException of Types.dry_run_operation_exception
| `InvalidArnException of Types.invalid_arn_exception
| `InvalidGrantIdException of Types.invalid_grant_id_exception
| `KMSInternalException of Types.kms_internal_exception
| `KMSInvalidStateException of Types.kms_invalid_state_exception
| `NotFoundException of Types.not_found_exception ])
Stdlib.result