# Amazon ECS サービスデプロイ状態変更イベント
<a name="ecs_service_deployment_events"></a>

Amazon ECS は、詳細タイプの [** ECS Deployment State Change** ] を使用してサービスデプロイ状態変更イベントを送信します。以下は、Amazon ECS サービスデプロイ状態変更イベントの Eventbridgeルールを作成するために使用されるイベントパターンです。EventBridge ルールの作成の詳細については、「*Amazon EventBridge ユーザーガイド*」の「[Amazon EventBridge の開始方法](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-get-started.html)」を参照してください。

```
{
    "source": [
        "aws.ecs"
    ],
    "detail-type": [
        "ECS Deployment State Change"
    ]
}
```

Amazon ECS は、`INFO`、と `ERROR` イベントタイプのイベントを送信します。詳細については、[Amazon ECS サービスアクションイベント](ecs_service_events.md)を参照してください。

次に、サービスデプロイ状態の変更イベントを示します。

`SERVICE_DEPLOYMENT_IN_PROGRESS`  
サービスデプロイは進行中です。このイベントは、初期デプロイとロールバックデプロイの両方で送信されます。

`SERVICE_DEPLOYMENT_COMPLETED`  
サービスのデプロイが完了しました。このイベントは、デプロイ後にサービスが定常状態になると、送信されます。

`SERVICE_DEPLOYMENT_FAILED`  
サービスのデプロイに失敗しました。このイベントは、デプロイサーキットブレーカーロジックが有効になっているサービスに対して送信されます。

**Example サービスデプロイ進行中イベント**  
サービスデプロイ進行中イベントは、初期デプロイとロールバックデプロイの両方の開始時に配信されます。両者の違いは `reason` フィールドにあります。EventBridge パラメータの詳細については、「*Amazon EventBridge ユーザーガイド*」の「[AWS サービスイベントメタデータ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)」を参照してください。  
次に、初期デプロイが開始された場合の出力例を示します。  

```
{
   "version": "0",
   "id": "ddca6449-b258-46c0-8653-e0e3a6EXAMPLE",
   "detail-type": "ECS Deployment State Change",
   "source": "aws.ecs",
   "account": "111122223333",
   "time": "2020-05-23T12:31:14Z",
   "region": "us-west-2",
   "resources": [ 
        "arn:aws:ecs:us-west-2:111122223333:service/default/servicetest"
   ],
   "detail": {
        "eventType": "INFO", 
        "eventName": "SERVICE_DEPLOYMENT_IN_PROGRESS",
        "deploymentId": "ecs-svc/123",
        "updatedAt": "2020-05-23T11:11:11Z",
        "reason": "ECS deployment deploymentId in progress."
   }
}
```
次に、ロールバックデプロイが開始された場合の出力例を示します。`reason` フィールドには、サービスがロールバックされるデプロイの ID を指定します。  

```
{
   "version": "0",
   "id": "ddca6449-b258-46c0-8653-e0e3aEXAMPLE",
   "detail-type": "ECS Deployment State Change",
   "source": "aws.ecs",
   "account": "111122223333",
   "time": "2020-05-23T12:31:14Z",
   "region": "us-west-2",
   "resources": [ 
        "arn:aws:ecs:us-west-2:111122223333:service/default/servicetest"
   ],
   "detail": {
        "eventType": "INFO", 
        "eventName": "SERVICE_DEPLOYMENT_IN_PROGRESS",
        "deploymentId": "ecs-svc/123",
        "updatedAt": "2020-05-23T11:11:11Z",
        "reason": "ECS deployment circuit breaker: rolling back to deploymentId deploymentID."
   }
}
```

**Example サービスデプロイ完了イベント**  
サービスデプロイ完了状態イベントは、次の形式で配信されます。詳細については、「[タスクを置き換えて Amazon ECS サービスをデプロイする](deployment-type-ecs.md)」を参照してください。  

```
{
   "version": "0",
   "id": "ddca6449-b258-46c0-8653-e0e3aEXAMPLE",
   "detail-type": "ECS Deployment State Change",
   "source": "aws.ecs",
   "account": "111122223333",
   "time": "2020-05-23T12:31:14Z",
   "region": "us-west-2",
   "resources": [ 
        "arn:aws:ecs:us-west-2:111122223333:service/default/servicetest"
   ],
   "detail": {
        "eventType": "INFO", 
        "eventName": "SERVICE_DEPLOYMENT_COMPLETED",
        "deploymentId": "ecs-svc/123",
        "updatedAt": "2020-05-23T11:11:11Z",
        "reason": "ECS deployment deploymentID completed."
   }
}
```

**Example サービスデプロイ失敗イベント**  
サービスデプロイ失敗イベントは、次の形式で配信されます。サービスデプロイ失敗状態イベントは、デプロイサーキットブレーカーロジックが有効になっているサービスに対してのみ送信されます。詳細については、「[タスクを置き換えて Amazon ECS サービスをデプロイする](deployment-type-ecs.md)」を参照してください。  

```
{
   "version": "0",
   "id": "ddca6449-b258-46c0-8653-e0e3aEXAMPLE",
   "detail-type": "ECS Deployment State Change",
   "source": "aws.ecs",
   "account": "111122223333",
   "time": "2020-05-23T12:31:14Z",
   "region": "us-west-2",
   "resources": [ 
        "arn:aws:ecs:us-west-2:111122223333:service/default/servicetest"
   ],
   "detail": {
        "eventType": "ERROR", 
        "eventName": "SERVICE_DEPLOYMENT_FAILED",
        "deploymentId": "ecs-svc/123",
        "updatedAt": "2020-05-23T11:11:11Z",
        "reason": "ECS deployment circuit breaker: task failed to start."
   }
}
```