Parameter Store でのパラメータラベルの操作

AWS Systems Manager コンソール (https://console.aws.amazon.com/systems-manager/) を開きます。

ナビゲーションペインで、[Parameter Store] を選択します。

パラメータの名前を選択して、そのパラメータ詳細ページを開きます。

[History] タブを選択します。

ラベルをアタッチするパラメータバージョンを選択します。

[Manage labels] (ラベルを管理) を選択します。

[Add new label] (新しいラベルを追加) を選択します。

テキストボックスにラベル名を入力します。ラベルを追加するには、[Add new label] (新しいラベルを追加) を選択します。1 つのバージョンに最大 10 個のラベルをアタッチできます。

完了したら、[変更の保存] を選択します。

AWS Systems Manager コンソール (https://console.aws.amazon.com/systems-manager/) を開きます。

ナビゲーションペインで、[Parameter Store] を選択します。

パラメータの名前を選択して、そのパラメータ詳細ページを開きます。

[History] タブを選択します。

アタッチされているすべてのラベルを表示するパラメータバージョンを見つけます。そのパラメータバージョンにアタッチされているすべてのラベルが [Labels (ラベル)] 列に表示されます。

AWS Systems Manager コンソール (https://console.aws.amazon.com/systems-manager/) を開きます。

ナビゲーションペインで、[Parameter Store] を選択します。

パラメータの名前を選択して、そのパラメータ詳細ページを開きます。

[History] タブを選択します。

ラベルを移動するパラメータバージョンを選択します。

[Manage labels] (ラベルを管理) を選択します。

[Add new label] (新しいラベルを追加) を選択します。

テキストボックスにラベル名を入力します。

完了したら、[変更の保存] を選択します。

AWS Systems Manager コンソール (https://console.aws.amazon.com/systems-manager/) を開きます。

ナビゲーションペインで、[Parameter Store] を選択します。

パラメータの名前を選択して、そのパラメータ詳細ページを開きます。

[History] タブを選択します。

ラベルを削除するパラメータバージョンを選択します。

[Manage labels] (ラベルを管理) を選択します。

削除する各ラベルの横にある [Remove] (削除) を選択します。

完了したら、[変更の保存] を選択します。

変更が正しいことを確認し、テキストボックスに Confirm と入力し、[Confirm] (確認) を選択します。

まだ AWS Command Line Interface (AWS CLI) をインストールして設定していない場合は、インストールして設定します。

詳細については、「AWS CLI の最新バージョンをインストールまたは更新します。」を参照してください。

次のコマンドを実行すると、ラベルをアタッチするためのアクセス許可があるパラメータのリストが表示されます。

aws ssm describe-parameters

ラベルをアタッチするパラメータの名前をメモします。

パラメータのすべてのバージョンを確認するには、次のコマンドを実行します。

aws ssm get-parameter-history --name "parameter-name"

ラベルをアタッチするパラメータバージョンをメモします。

次のコマンドを実行して、パラメータに関する情報をバージョン番号別に取得します。

aws ssm get-parameters --names "parameter-name:version-number" 

以下はその例です。

aws ssm get-parameters --names "/Production/SQLConnectionString:3" 

以下のいずれかのコマンドを実行して、1 つのパラメータの 1 つのバージョンにラベルをアタッチします。複数のラベルをアタッチする場合は、ラベル名をスペースで区切ります。

パラメータの最新バージョンにラベルをアタッチする

aws ssm label-parameter-version --name parameter-name  --labels label-name

パラメータの特定のバージョンにラベルをアタッチする

aws ssm label-parameter-version --name parameter-name --parameter-version version-number --labels label-name

次に例を示します。

aws ssm label-parameter-version --name /config/endpoint --labels production east-region finance

aws ssm label-parameter-version --name /config/endpoint --parameter-version 3 --labels MySQL-test

バージョン番号またはラベル名を使用することによって、パラメータの詳細を表示できます。前の手順で作成したラベルを指定して、次のコマンドを実行します。

aws ssm get-parameter --name parameter-name:label-name --with-decryption

このコマンドによって以下のような情報が返されます。

{
    "Parameter": {
        "Version": version-number, 
        "Type": "parameter-type", 
        "Name": "parameter-name", 
        "Value": "parameter-value", 
        "Selector": ":label-name"
    }
}

次のコマンドを実行すると、ラベルを表示できるパラメータのリストが表示されます。

aws ssm describe-parameters

ラベルを表示するパラメータの名前を書き留めます。

パラメータのすべてのバージョンを確認するには、次のコマンドを実行します。

aws ssm get-parameter-history --name parameter-name --with-decryption

システムが以下のような情報をレスポンスします。

{
    "Parameters": [
        {
            "Name": "/Config/endpoint", 
            "LastModifiedDate": 1528932105.382, 
            "Labels": [
                "Deprecated"
            ], 
            "Value": "MyTestService-June-Release.example.com", 
            "Version": 1, 
            "LastModifiedUser": "arn:aws:iam::123456789012:user/test", 
            "Type": "String"
        }, 
        {
            "Name": "/Config/endpoint", 
            "LastModifiedDate": 1528932111.222, 
            "Labels": [
                "Current"
            ], 
            "Value": "MyTestService-July-Release.example.com", 
            "Version": 2, 
            "LastModifiedUser": "arn:aws:iam::123456789012:user/test", 
            "Type": "String"
        }
    ]
}

パラメータのすべてのバージョンを確認するには、次のコマンドを実行します。parameter name を自分の情報に置き換えます。

aws ssm get-parameter-history \
    --name "parameter name"

ラベルの移動先と移動元となるパラメータのバージョンを書き留めます。

既存のラベルを別のバージョンのパラメータに割り当てるには、次のコマンドを実行します。各リソースプレースホルダーの例をユーザー自身の情報に置き換えます。

aws ssm label-parameter-version \
    --name parameter name \
    --parameter-version version number \
    --labels name-of-existing-label

パラメータのすべてのバージョンを確認するには、次のコマンドを実行します。parameter name を自分の情報に置き換えます。

aws ssm get-parameter-history \
    --name "parameter name"

システムが以下のような情報をレスポンスします。

{
    "Parameters": [
        {
            "Name": "foo",
            "DataType": "text",
            "LastModifiedDate": 1607380761.11,
            "Labels": [
                "l3",
                "l2"
            ],
            "Value": "test",
            "Version": 1,
            "LastModifiedUser": "arn:aws:iam::123456789012:user/test",
            "Policies": [],
            "Tier": "Standard",
            "Type": "String"
        },
        {
            "Name": "foo",
            "DataType": "text",
            "LastModifiedDate": 1607380763.11,
            "Labels": [
                "l1"
            ],
            "Value": "test",
            "Version": 2,
            "LastModifiedUser": "arn:aws:iam::123456789012:user/test",
            "Policies": [],
            "Tier": "Standard",
            "Type": "String"
        }
    ]
}

1 つまたは複数のラベルを削除するパラメータのバージョンを書き留めます。

次のコマンドを実行して、そのパラメータから選択したラベルを削除します。各リソースプレースホルダーの例をユーザー自身の情報に置き換えます。

aws ssm unlabel-parameter-version \
    --name parameter name \
    --parameter-version version \
    --labels label 1,label 2,label 3

システムが以下のような情報をレスポンスします。

{
    "InvalidLabels": ["invalid"], 
    "DeletedLabels" : ["Prod"]
 }