Copyright | (c) 2013-2021 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Deletes key material that you previously imported. This operation makes the specified KMS key unusable. For more information about importing key material into KMS, see Importing Key Material in the Key Management Service Developer Guide.
When the specified KMS key is in the PendingDeletion
state, this
operation does not change the KMS key's state. Otherwise, it changes
the KMS key's state to PendingImport
.
After you delete key material, you can use ImportKeyMaterial to reimport the same key material into the KMS key.
The KMS key that you use for this operation must be in a compatible key state. For details, see Key state: Effect on your KMS key 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:DeleteImportedKeyMaterial (key policy)
Related operations:
- GetParametersForImport
- ImportKeyMaterial
Synopsis
- data DeleteImportedKeyMaterial = DeleteImportedKeyMaterial' {}
- newDeleteImportedKeyMaterial :: Text -> DeleteImportedKeyMaterial
- deleteImportedKeyMaterial_keyId :: Lens' DeleteImportedKeyMaterial Text
- data DeleteImportedKeyMaterialResponse = DeleteImportedKeyMaterialResponse' {
- newDeleteImportedKeyMaterialResponse :: DeleteImportedKeyMaterialResponse
Creating a Request
data DeleteImportedKeyMaterial Source #
See: newDeleteImportedKeyMaterial
smart constructor.
DeleteImportedKeyMaterial' | |
|
Instances
newDeleteImportedKeyMaterial Source #
Create a value of DeleteImportedKeyMaterial
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:keyId:DeleteImportedKeyMaterial'
, deleteImportedKeyMaterial_keyId
- Identifies the KMS key from which you are deleting imported key
material. The Origin
of the KMS key must be EXTERNAL
.
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.
Request Lenses
deleteImportedKeyMaterial_keyId :: Lens' DeleteImportedKeyMaterial Text Source #
Identifies the KMS key from which you are deleting imported key
material. The Origin
of the KMS key must be EXTERNAL
.
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.
Destructuring the Response
data DeleteImportedKeyMaterialResponse Source #
See: newDeleteImportedKeyMaterialResponse
smart constructor.
Instances
newDeleteImportedKeyMaterialResponse :: DeleteImportedKeyMaterialResponse Source #
Create a value of DeleteImportedKeyMaterialResponse
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.