Automatisation AWS Ground Station grâce aux événements

Note

Le terme « événement » est utilisé partout dans le présent document. CloudWatch Les événements et EventBridge sont le même service sous-jacent etAPI. Les règles permettant de faire correspondre les événements entrants et de les acheminer vers des cibles à des fins de traitement peuvent être établies à l'aide de l'un ou l'autre service.

Les événements vous permettent d'automatiser vos AWS services et de répondre automatiquement aux événements du système tels que les problèmes de disponibilité des applications ou les modifications des ressources. Les événements liés AWS aux services sont diffusés en temps quasi réel. Vous pouvez écrire des règles simples pour indiquer quels événements vous intéressent et les actions automatisées à effectuer quand un événement correspond à une règle. Parmi les actions qui peuvent être déclenchées automatiquement, citons les suivantes :

• Invoquer une fonction AWS Lambda

• Invocation de la commande Amazon EC2 Run

• Relais de l'événement à Amazon Kinesis Data Streams

• Activation d'une machine à AWS Step Functions états

• Notification d'un SNS sujet Amazon ou d'une file d'attente Amazon SQS

Voici quelques exemples d'utilisation d'événements avec AWS Ground Station  :

• Invocation d'une fonction Lambda pour automatiser le démarrage et l'arrêt des instances EC2 Amazon en fonction de l'état de l'événement.

• Publier sur un SNS sujet Amazon chaque fois qu'un contact change d'état. Ces rubriques peuvent être configurées pour envoyer des notifications par e-mail au début ou à la fin des contacts.

Pour plus d'informations, consultez le guide de l'utilisateur d'Amazon EventBridge Events.

AWS Ground Station Types d'événements

Note

La valeur « source » de tous les événements générés par AWS Ground Station est « aws.groundstation ».

AWS Ground Station émet des événements liés aux changements d'état pour vous permettre de personnaliser votre automatisation. Actuellement, AWS Ground Station prend en charge les événements de changement d'état des contacts, les événements de modification du groupe de points de terminaison du flux de données et les événements de changement d'état des éphémérides. Les sections suivantes fournissent des informations détaillées sur chaque type.

Chronologie des événements de contact

AWS Ground Station émet des événements lorsque votre contact change d'état. Pour plus d'informations sur la nature de ces changements d'État et sur la signification des États eux-mêmes, voirCycle de vie des contacts. Tous les groupes de points de terminaison de flux de données utilisés dans votre contact sont associés à un ensemble indépendant d'événements qui sont également émis. Au cours de cette même période, nous émettons également des événements pour votre groupe de points de terminaison de flux de données. Vous pouvez configurer l'heure précise des événements avant et après le passage lorsque vous configurez votre profil de mission et votre groupe de points de terminaison de flux de données.

Le schéma suivant montre les statuts et les événements émis pour un contact nominal et son groupe de points de terminaison de flux de données associé.

Modification de l’état d’un contact Ground Station

Si vous souhaitez effectuer une action spécifique lorsqu'un prochain contact change d'état, vous pouvez définir une règle pour automatiser cette action. Ceci est utile lorsque vous souhaitez recevoir des notifications sur les changements d'état de votre contact. Si vous souhaitez modifier le moment où vous recevez ces événements, vous pouvez modifier le profil de votre mission contactPrePassDurationSecondset contactPostPassDurationSeconds. Les événements sont envoyés à la région à partir de laquelle le contact a été planifié.

Un exemple d'événement est fourni ci-dessous.

{
    "version": "0",
    "id": "01234567-0123-0123",
    "account": "123456789012",
    "time": "2019-05-30T17:40:30Z",
    "region": "us-west-2",
    "source": "aws.groundstation",
    "resources": [
        "arn:aws:groundstation:us-west-2:123456789012:contact/11111111-1111-1111-1111-111111111111"
    ],
    "detailType": "Ground Station Contact State Change",
    "detail": {
        "contactId": "11111111-1111-1111-1111-111111111111",
        "groundstationId": "Ground Station 1",
        "missionProfileArn": "arn:aws:groundstation:us-west-2:123456789012:mission-profile/11111111-1111-1111-1111-111111111111",
        "satelliteArn": "arn:aws:groundstation::123456789012:satellite/11111111-1111-1111-1111-111111111111",
        "contactStatus": "PASS"
    },
    "account": "123456789012"
}

Les valeurs possibles pour contactStatus sont définies dansAWS Ground Station statuts des contacts.

Modification de l'état du groupe de points de terminaison du flux de données Ground Station

Si vous souhaitez effectuer une action lorsque votre groupe de points de terminaison de flux de données est utilisé pour recevoir des données, vous pouvez configurer une règle pour automatiser cette action. Cela vous permettra d'effectuer différentes actions en réponse aux états changeants du groupe de points de terminaison de flux de données. Si vous souhaitez modifier le moment où vous recevez ces événements, utilisez un groupe de points de terminaison de flux de données avec un et différent contactPrePassDurationSeconds. contactPostPassDurationSeconds Cet événement sera envoyé à la région du groupe de points de terminaison de flux de données.

Vous trouverez un exemple ci-dessous.

{
    "version": "0",
    "id": "01234567-0123-0123",
    "account": "123456789012",
    "time": "2019-05-30T17:40:30Z",
    "region": "us-west-2",
    "source": "aws.groundstation",
    "resources": [
        "arn:aws:groundstation:us-west-2:123456789012:dataflow-endpoint-group/bad957a8-1d60-4c45-a92a-39febd98921d",
        "arn:aws:groundstation:us-west-2:123456789012:contact/98ddd10f-f2bc-479c-bf7d-55644737fb09",
        "arn:aws:groundstation:us-west-2:123456789012:mission-profile/c513c84c-eb40-4473-88a2-d482648c9234"
    ],
    "detailType": "Ground Station Dataflow Endpoint Group State Change",
    "detail": {
        "dataflowEndpointGroupId": "bad957a8-1d60-4c45-a92a-39febd98921d",
        "groundstationId": "Ground Station 1",
        "contactId": "98ddd10f-f2bc-479c-bf7d-55644737fb09",
        "dataflowEndpointGroupArn": "arn:aws:groundstation:us-west-2:680367718957:dataflow-endpoint-group/bad957a8-1d60-4c45-a92a-39febd98921d",
        "missionProfileArn": "arn:aws:groundstation:us-west-2:123456789012:mission-profile/c513c84c-eb40-4473-88a2-d482648c9234",
        "dataflowEndpointGroupState": "PREPASS"
    },
    "account": "123456789012"
}

Les états possibles pour dataflowEndpointGroupState sont : PREPASS, PASS, POSTPASS et COMPLETED.

Événements Ephemeris

Changement d'état des éphémérides de la station au sol

Si vous souhaitez effectuer une action lorsqu'une éphéméride change d'état, vous pouvez définir une règle pour automatiser cette action. Cela vous permet d'effectuer différentes actions en réponse au changement d'état d'une éphéméride. Par exemple, vous pouvez effectuer une action lorsque la validation d'une éphéméride est terminée, et c'est maintenant le cas. ENABLED La notification de cet événement sera envoyée à la région où les éphémérides ont été téléchargées.

Vous trouverez un exemple ci-dessous.

    {
    "id": "7bf73129-1428-4cd3-a780-95db273d1602",
    "detail-type": "Ground Station Ephemeris State Change",
    "source": "aws.groundstation",
    "account": "123456789012",
    "time": "2019-12-03T21:29:54Z",
    "region": "us-west-2",
    "resources": [
    "arn:aws:groundstation::123456789012:satellite/10313191-c9d9-4ecb-a5f2-bc55cab050ec",
    "arn:aws:groundstation::123456789012:ephemeris/111111-cccc-bbbb-a555-bcccca005000",
    ],
    "detail": {
    "ephemerisStatus": "ENABLED",
    "ephemerisId": "111111-cccc-bbbb-a555-bcccca005000",
    "satelliteId": "10313191-c9d9-4ecb-a5f2-bc55cab050ec"
    }
    }
   

Les états possibles pour les ephemerisStatus incluent ENABLEDVALIDATING,INVALID,ERROR,DISABLED, EXPIRED