鍵バージョンを有効または無効にする

Cloud KMS では、データの暗号化、復号、署名、検証に使用する暗号鍵マテリアルが、鍵バージョンに保存されています。鍵には、0 個以上の鍵バージョンがあります。鍵をローテーションすると、新しい鍵バージョンが作成されます。

このドキュメントでは、鍵バージョンを無効にする方法について説明します。鍵が無効になっている間は、その鍵で暗号化されているデータにはアクセスできません。データにアクセスするには、鍵バージョンを再度有効にします。

サービス ヘルス ダッシュボードで特に指定されていない限り、鍵バージョンの無効化は通常 1 分以内に一貫性が保たれます。鍵バージョンの有効化は、ほぼ即時に行えます。鍵バージョンへのアクセスは、Identity and Access Management（IAM）を使用して管理することもできます。IAM オペレーションの整合性は、数秒以内に確保されます。詳細については、IAM の使用をご覧ください。

また、完全に鍵バージョンを破棄することもできます。 組織のポリシーによっては、鍵バージョンを破棄する前に無効にする必要がある場合があります。詳細については、鍵バージョンの破棄を制御するをご覧ください。

鍵バージョンの無効化

鍵バージョンは、有効の状態において無効にできます。鍵バージョンを無効にする前に、その鍵がまだ使用されているかどうかを確認することをおすすめします。鍵の鍵使用状況の追跡の詳細を表示して、CMEK リソースを保護しているかどうかを確認できます。無効にする鍵バージョンで保護されているリソースがある場合は、鍵を無効にする前に別の鍵バージョンでリソースを再暗号化します。

gcloud kms keys versions disable key-version \
    --key key \
    --keyring key-ring \
    --location location

using Google.Cloud.Kms.V1;
using Google.Protobuf.WellKnownTypes;

public class DisableKeyVersionSample
{
    public CryptoKeyVersion DisableKeyVersion(string projectId = "my-project", string locationId = "us-east1", string keyRingId = "my-key-ring", string keyId = "my-key", string keyVersionId = "123")
    {
        // Create the client.
        KeyManagementServiceClient client = KeyManagementServiceClient.Create();

        // Build the key version.
        CryptoKeyVersion keyVersion