disable_key¶
Operation¶
disable_key
async
¶
disable_key(request: DisableKeyInput | DisableKeyInputDict, /, *, plugins: list[Plugin] | None = None) -> DisableKeyOutput
disable_key(*, plugins: list[Plugin] | None = None, **kwargs: Unpack[DisableKeyInputDict]) -> DisableKeyOutput
Sets the state of a KMS key to disabled. This change temporarily prevents use of the KMS key for cryptographic operations.
The KMS key that you use for this operation must be in a compatible key state. For more information about how key state affects the use of a KMS key, see Key states of KMS keys in the Key Management Service Developer Guide .
Cross-account use: No. You cannot perform this operation on a KMS key in a different Amazon Web Services account.
Required permissions: kms:DisableKey (key policy)
Related operations: EnableKey
Eventual consistency: The KMS API follows an eventual consistency model. For more information, see KMS eventual consistency.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
plugins
|
list[Plugin] | None
|
A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations. |
None
|
Returns:
| Type | Description |
|---|---|
DisableKeyOutput
|
An instance of |
Input¶
Pass the input fields as keyword arguments, or pass a model or dictionary as the first positional argument. Pass plugins separately as a keyword argument.
Model¶
DisableKeyInput
dataclass
¶
Bases: _SerdeShape
Dataclass for DisableKeyInput structure.
Attributes¶
key_id
class-attribute
instance-attribute
¶
key_id: str | None = ...
Identifies the KMS key to disable.
Specify the key ID or key ARN of the KMS key.
For example:
-
Key ID:
1234abcd-12ab-34cd-56ef-1234567890ab -
Key ARN:
arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
To get the key ID and key ARN for a KMS key, use ListKeys or DescribeKey.
Dictionaries¶
DisableKeyInputDict
¶
Bases: TypedDict
Dictionary form of DisableKeyInput.
Attributes¶
key_id
instance-attribute
¶
Identifies the KMS key to disable.
Specify the key ID or key ARN of the KMS key.
For example:
-
Key ID:
1234abcd-12ab-34cd-56ef-1234567890ab -
Key ARN:
arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
To get the key ID and key ARN for a KMS key, use ListKeys or DescribeKey.
Output¶
DisableKeyOutput
dataclass
¶
Bases: _SerdeShape
Dataclass for DisableKeyOutput structure.