を使用した Amazon Data Lifecycle Manager の例 AWS CLI - AWS SDKコードの例
アクション

Doc AWS SDK ExamplesWord リポジトリには、さらに多くの GitHub の例があります。 AWS SDK

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

を使用した Amazon Data Lifecycle Manager の例 AWS CLI

次のコード例は、Amazon Data Lifecycle Manager AWS Command Line Interface で を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。

アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には、完全なソースコードへのリンクが含まれています。ここでは、コンテキストでコードを設定および実行する方法の手順を確認できます。

トピック

アクション

次の例は、create-default-role を使用する方法を説明しています。

AWS CLI

Amazon IAM に必要な DLM ロールを作成するには

次のdlm create-default-role例では、スナップショットを管理するための AWS DataLifecycleManagerDefaultRole デフォルトロールを作成します。

aws dlm create-default-role \
    --resource-type snapshot

このコマンドでは何も出力されません。

詳細については、Amazon Elastic Compute Cloud ユーザーガイドの「Amazon Data Lifecycle Manager のデフォルトのサービスロール」を参照してください。

  • API の詳細については、 AWS CLI コマンドリファレンスの CreateDefaultRole を参照してください。

次の例は、create-lifecycle-policy を使用する方法を説明しています。

AWS CLI

ライフサイクルポリシーを作成するには

次のcreate-lifecycle-policy例では、指定した時間にボリュームのスナップショットを毎日作成するライフサイクルポリシーを作成します。指定されたタグはスナップショットに追加され、タグはボリュームからコピーされ、スナップショットに追加されます。新しいスナップショットの作成が指定された最大数を超える場合、最も古いスナップショットは削除されます。

aws dlm create-lifecycle-policy \
    --description "My first policy" \
    --state ENABLED \
    --execution-role-arn arn:aws:iam::12345678910:role/AWSDataLifecycleManagerDefaultRole \
    --policy-details file://policyDetails.json

policyDetails.json の内容:

{
    "ResourceTypes": [
        "VOLUME"
    ],
    "TargetTags": [
        {
            "Key": "costCenter",
            "Value": "115"
        }
    ],
    "Schedules":[
        {
            "Name": "DailySnapshots",
            "CopyTags": true,
            "TagsToAdd": [
                {
                    "Key": "type",
                     "Value": "myDailySnapshot"
                }
            ],
            "CreateRule": {
                "Interval": 24,
                "IntervalUnit": "HOURS",
                "Times": [
                    "03:00"
                ]
            },
            "RetainRule": {
                "Count":5
            }
        }
    ]
}

出力:

{
    "PolicyId": "policy-0123456789abcdef0"
}

  • API の詳細については、 AWS CLI コマンドリファレンスの CreateLifecyclePolicy を参照してください。

次のコード例は、delete-lifecycle-policy を使用する方法を示しています。

AWS CLI

ライフサイクルポリシーを削除するには

次の例では、指定されたライフサイクルポリシーを削除します。

aws dlm delete-lifecycle-policy --policy-id policy-0123456789abcdef0

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDeleteLifecyclePolicy」を参照してください。

次のコード例は、get-lifecycle-policies を使用する方法を示しています。

AWS CLI

ライフサイクルポリシーの概要を取得するには

次のget-lifecycle-policies例では、すべてのライフサイクルポリシーを一覧表示します。

aws dlm get-lifecycle-policies

出力:

{
    "Policies": [
        {
            "PolicyId": "policy-0123456789abcdef0",
            "Description": "My first policy",
            "State": "ENABLED"
        }
    ]
}

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のGetLifecyclePolicies」を参照してください。

次のコード例は、get-lifecycle-policy を使用する方法を示しています。

AWS CLI

ライフサイクルポリシーを記述するには

次のget-lifecycle-policy例では、指定されたライフサイクルポリシーの詳細を表示します。

aws dlm get-lifecycle-policy \
    --policy-id policy-0123456789abcdef0

出力:

{
    "Policy": {
        "PolicyId": "policy-0123456789abcdef0",
        "Description": "My policy",
        "State": "ENABLED",
        "ExecutionRoleArn": "arn:aws:iam::123456789012:role/AWSDataLifecycleManagerDefaultRole",
        "DateCreated": "2019-08-08T17:45:42Z",
        "DateModified": "2019-08-08T17:45:42Z",
        "PolicyDetails": {
            "PolicyType": "EBS_SNAPSHOT_MANAGEMENT",
            "ResourceTypes": [
                "VOLUME"
            ],
            "TargetTags": [
              {
                  "Key": "costCenter",
                  "Value": "115"
              }
            ],
            "Schedules": [
              {
                  "Name": "DailySnapshots",
                  "CopyTags": true,
                  "TagsToAdd": [
                    {
                        "Key": "type",
                        "Value": "myDailySnapshot"
                    }
                  ],
                  "CreateRule": {
                    "Interval": 24,
                    "IntervalUnit": "HOURS",
                    "Times": [
                        "03:00"
                    ]
                  },
                  "RetainRule": {
                    "Count": 5
                  }
              }
            ]
        }
    }
}

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のGetLifecyclePolicy」を参照してください。

次の例は、update-lifecycle-policy を使用する方法を説明しています。

AWS CLI

例 1: ライフサイクルポリシーを有効にするには

次のupdate-lifecycle-policy例では、指定されたライフサイクルポリシーを有効にします。

aws dlm update-lifecycle-policy \
    --policy-id policy-0123456789abcdef0 \
    --state ENABLED

例 2: ライフサイクルポリシーを無効にするには

次のupdate-lifecycle-policy例では、指定されたライフサイクルポリシーを無効にします。

aws dlm update-lifecycle-policy \
    --policy-id policy-0123456789abcdef0 \
    --state DISABLED

例 3: ライフサイクルポリシーの詳細を更新するには

次のupdate-lifecycle-policy例では、指定されたライフサイクルポリシーのターゲットタグを更新します。

aws dlm update-lifecycle-policy \
    --policy-id policy-0123456789abcdef0
    --policy-details file://policyDetails.json

policyDetails.json の内容。このファイルで参照されていないその他の詳細は、 コマンドによって変更されません。

{
    "TargetTags": [
        {
            "Key": "costCenter",
            "Value": "120"
        },
        {
            "Key": "project",
            "Value": "lima"
        }
    ]
}

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のUpdateLifecyclePolicy」を参照してください。