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

# Amazon OpenSearch Ingestion パイプラインの表示
<a name="list-pipeline"></a>

Amazon OpenSearch Ingestion パイプラインの詳細は、 AWS マネジメントコンソール、 AWS CLI、または OpenSearch Ingestion API を使用して表示できます。

## コンソール
<a name="list-pipeline-console"></a>

**パイプラインを表示するには**

1. [https://console.aws.amazon.com/aos/osis/home](https://console.aws.amazon.com/aos/osis/home#osis/ingestion-pipelines) で Amazon OpenSearch Service コンソールにサインインします。Pipelines ページが表示されます。

1. (オプション) 特定のステータスのパイプラインを表示するには、**[任意のステータス]** をクリックし、フィルタリングするステータスを選択します。

   パイプラインには、次のステータスがあります。
   + `Active` - パイプラインはアクティブで、データを取り込む準備ができています。
   + `Creating` - パイプラインを作成中です。
   + `Updating` - パイプラインを更新中です。
   + `Deleting` - パイプラインを削除中です。
   + `Create failed` - パイプラインを作成できませんでした。
   + `Update failed` - パイプラインを更新できませんでした。
   + `Stop failed` – パイプラインを停止できませんでした。
   + `Start failed` - パイプラインを開始できませんでした。
   + `Stopping` - パイプラインを停止中です。
   + `Stopped` - パイプラインは停止中で、いつでも再開できます。
   + `Starting` - パイプラインを開始中です。

パイプラインのステータスが `Create failed`、`Creating`、`Deleting`、`Stopped` の場合は、Ingestion OCU の料金は請求されません。

## CLI
<a name="list-pipeline-cli"></a>

を使用してパイプラインを表示するには AWS CLI、[list-pipelines](https://docs.aws.amazon.com/cli/latest/reference/osis/list-pipelines.html) リクエストを送信します。

```
aws osis list-pipelines  
```

リクエストは、既存の全パイプラインのリストを返します。

```
{
    "NextToken": null,
    "Pipelines": [
        {,
            "CreatedAt": 1.671055851E9,
            "LastUpdatedAt": 1.671055851E9,
            "MaxUnits": 4,
            "MinUnits": 2,
            "PipelineArn": "arn:aws:osis:us-west-2:123456789012:pipeline/log-pipeline",
            "PipelineName": "log-pipeline",
            "Status": "ACTIVE",
            "StatusReason": {
                "Description": "The pipeline is ready to ingest data."
            }
        },
            "CreatedAt": 1.671055851E9,
            "LastUpdatedAt": 1.671055851E9,
            "MaxUnits": 2,
            "MinUnits": 8,
            "PipelineArn": "arn:aws:osis:us-west-2:123456789012:pipeline/another-pipeline",
            "PipelineName": "another-pipeline",
            "Status": "CREATING",
            "StatusReason": {
                "Description": "The pipeline is being created. It is not able to ingest data."
            }
        }
    ]
}
```

1 つのパイプラインに関する情報を取得するには、[get-pipeline](https://docs.aws.amazon.com/cli/latest/reference/osis/get-pipeline.html) コマンドを使用します。

```
aws osis get-pipeline --pipeline-name "my-pipeline"
```

リクエストは、指定されたパイプラインの設定情報を返します。

```
{
    "Pipeline": {
        "PipelineName": "my-pipeline",
        "PipelineArn": "arn:aws:osis:us-east-1:123456789012:pipeline/my-pipeline",
        "MinUnits": 9,
        "MaxUnits": 10,
        "Status": "ACTIVE",
        "StatusReason": {
            "Description": "The pipeline is ready to ingest data."
        },
        "PipelineConfigurationBody": "log-pipeline:\n source:\n http:\n processor:\n - grok:\n match:\nlog: [ '%{COMMONAPACHELOG}' ]\n - date:\n from_time_received: true\n destination: \"@timestamp\"\n  sink:\n - opensearch:\n hosts: [ \"https://search-mdp-performance-test-duxkb4qnycd63rpy6svmvyvfpi.us-east-1.es.amazonaws.com\" ]\n index: \"apache_logs\"\n aws_sts_role_arn: \"arn:aws:iam::123456789012:role/my-domain-role\"\n  aws_region: \"us-east-1\"\n  aws_sigv4: true",,
        "CreatedAt": "2022-10-01T15:28:05+00:00",
        "LastUpdatedAt": "2022-10-21T21:41:08+00:00",
        "IngestEndpointUrls": [
            "my-pipeline-123456789012.us-east-1.osis.amazonaws.com"
        ]
    }
}
```

## OpenSearch Ingestion API
<a name="list-pipelines-api"></a>

OpenSearch Ingestion API を使用して OpenSearch Ingestion パイプラインを表示するには、[ListPipelines](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_osis_ListPipelines.html) オペレーションと [GetPipeline](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_osis_GetPipeline.html) オペレーションを呼び出します。