Doc AWS SDK Examples GitHub リポジトリには、他にも SDK の例があります。 [AWS](https://github.com/awsdocs/aws-doc-sdk-examples)

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

# を使用した CloudWatch Logs の例 AWS CLI
<a name="cli_2_cloudwatch-logs_code_examples"></a>

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

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

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

**Topics**
+ [アクション](#actions)

## アクション
<a name="actions"></a>

### `create-log-group`
<a name="cloudwatch-logs_CreateLogGroup_cli_2_topic"></a>

次のコード例は、`create-log-group` を使用する方法を示しています。

**AWS CLI**  
次のコマンドは、`my-logs` という名前のロググループを作成します。  

```
aws logs create-log-group --log-group-name my-logs
```
+  API の詳細については、AWS CLI コマンドリファレンスの「[CreateLogGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/create-log-group.html)」を参照してください。**

### `create-log-stream`
<a name="cloudwatch-logs_CreateLogStream_cli_2_topic"></a>

次のコード例は、`create-log-stream` を使用する方法を示しています。

**AWS CLI**  
次のコマンドは、ロググループ `my-logs` に `20150601` という名前のログストリームを作成します。  

```
aws logs create-log-stream --log-group-name my-logs --log-stream-name 20150601
```
+  API の詳細については、AWS CLI コマンドリファレンスの「[CreateLogStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/create-log-stream.html)」を参照してください。**

### `delete-log-group`
<a name="cloudwatch-logs_DeleteLogGroup_cli_2_topic"></a>

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

**AWS CLI**  
以下のコマンドは、`my-logs` という名前のロググループを削除します。  

```
aws logs delete-log-group --log-group-name my-logs
```
+  API の詳細については、AWS CLI コマンドリファレンスの「[DeleteLogGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-log-group.html)」を参照してください。**

### `delete-log-stream`
<a name="cloudwatch-logs_DeleteLogStream_cli_2_topic"></a>

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

**AWS CLI**  
次のコマンドは、`my-logs` という名前のロググループから `20150531` という名前のログストリームを削除します。  

```
aws logs delete-log-stream --log-group-name my-logs --log-stream-name 20150531
```
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteLogStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-log-stream.html)」を参照してください。

### `delete-retention-policy`
<a name="cloudwatch-logs_DeleteRetentionPolicy_cli_2_topic"></a>

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

**AWS CLI**  
次のコマンドは、`my-logs` という名前のロググループに以前に適用された保持ポリシーを削除します。  

```
aws logs delete-retention-policy --log-group-name my-logs
```
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteRetentionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-retention-policy.html)」を参照してください。

### `describe-log-groups`
<a name="cloudwatch-logs_DescribeLogGroups_cli_2_topic"></a>

次のコード例は、`describe-log-groups` を使用する方法を示しています。

**AWS CLI**  
次のコマンドは、`my-logs` という名前のロググループを記述します。  

```
aws logs describe-log-groups --log-group-name-prefix my-logs
```
出力:  

```
{
    "logGroups": [
        {
            "storedBytes": 0,
            "metricFilterCount": 0,
            "creationTime": 1433189500783,
            "logGroupName": "my-logs",
            "retentionInDays": 5,
            "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:*"
        }
    ]
}
```
+  API の詳細については、AWS CLI コマンドリファレンスの「[DescribeLogGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/describe-log-groups.html)」を参照してください。**

### `describe-log-streams`
<a name="cloudwatch-logs_DescribeLogStreams_cli_2_topic"></a>

次のコード例は、`describe-log-streams` を使用する方法を示しています。

**AWS CLI**  
次のコマンドは、ロググループ `my-logs` のプレフィックス `2015` で始まるすべてのログストリームを表示します。  

```
aws logs describe-log-streams --log-group-name my-logs --log-stream-name-prefix 2015
```
出力:  

```
{
    "logStreams": [
        {
            "creationTime": 1433189871774,
            "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150531",
            "logStreamName": "20150531",
            "storedBytes": 0
        },
        {
            "creationTime": 1433189873898,
            "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150601",
            "logStreamName": "20150601",
            "storedBytes": 0
        }
    ]
}
```
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeLogStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/describe-log-streams.html)」を参照してください。

### `get-log-events`
<a name="cloudwatch-logs_GetLogEvents_cli_2_topic"></a>

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

**AWS CLI**  
次のコマンドは、ロググループ `my-logs` の `20150601` という名前のログストリームからログイベントを取得します。  

```
aws logs get-log-events --log-group-name my-logs --log-stream-name 20150601
```
出力:  

```
{
    "nextForwardToken": "f/31961209122447488583055879464742346735121166569214640130",
    "events": [
        {
            "ingestionTime": 1433190494190,
            "timestamp": 1433190184356,
            "message": "Example Event 1"
        },
        {
            "ingestionTime": 1433190516679,
            "timestamp": 1433190184356,
            "message": "Example Event 1"
        },
        {
            "ingestionTime": 1433190494190,
            "timestamp": 1433190184358,
            "message": "Example Event 2"
        }
    ],
    "nextBackwardToken": "b/31961209122358285602261756944988674324553373268216709120"
}
```
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetLogEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/get-log-events.html)」を参照してください。

### `put-log-events`
<a name="cloudwatch-logs_PutLogEvents_cli_2_topic"></a>

次のコード例は、`put-log-events` を使用する方法を示しています。

**AWS CLI**  
次のコマンドは、ロググループ `my-logs` の `20150601` という名前のログストリームにログイベントを配置します。  

```
aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events
```
出力:  

```
{
    "nextSequenceToken": "49542672486831074009579604567656788214806863282469607346"
}
```
上記の例では、現在のディレクトリにある `events` という名前のファイルからイベントの JSON 配列を読み取ります。  

```
[
  {
    "timestamp": 1433190184356,
    "message": "Example Event 1"
  },
  {
    "timestamp": 1433190184358,
    "message": "Example Event 2"
  },
  {
    "timestamp": 1433190184360,
    "message": "Example Event 3"
  }
]
```
以降の各呼び出しでは、前の呼び出しで提供された次のシーケンストークンをシーケンストークンオプションで指定する必要があります。  

```
aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events2 --sequence-token "49542672486831074009579604567656788214806863282469607346"
```
出力:  

```
{
    "nextSequenceToken": "49542672486831074009579604567900991230369019956308219826"
}
```
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[PutLogEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/put-log-events.html)」を参照してください。

### `put-retention-policy`
<a name="cloudwatch-logs_PutRetentionPolicy_cli_2_topic"></a>

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

**AWS CLI**  
次のコマンドは、`my-logs` という名前のロググループに 5 日間の保持ポリシーを追加します。  

```
aws logs put-retention-policy --log-group-name my-logs --retention-in-days 5
```
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[PutRetentionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/put-retention-policy.html)」を参照してください。