Configuration du stockage compatible Amazon S3 sur les appareils Snow Family : notifications d'événements - AWS Snowball Edge Guide du développeur

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration du stockage compatible Amazon S3 sur les appareils Snow Family : notifications d'événements

Le stockage compatible Amazon S3 sur les appareils de la gamme Snow prend en charge les notifications d'événements Amazon S3 pour les API appels d'objets sur la base du protocole Message Queuing Telemetry Transport (). MQTT

Vous pouvez utiliser le stockage compatible Amazon S3 sur les appareils Snow Family pour recevoir des notifications lorsque certains événements se produisent dans votre compartiment S3. Pour activer les notifications, ajoutez une configuration de notification qui identifie les événements que vous souhaitez que le service publie.

Le stockage compatible Amazon S3 sur les appareils de la gamme Snow prend en charge les types de notifications suivants :

  • Événements créés par un nouvel objet

  • Événements de suppression d'objets

  • Événements de balisage d'objets

Configuration des notifications d'événements Amazon S3

  1. Avant de commencer, vous devez disposer MQTT d'une infrastructure dans votre réseau.

  2. Dans votre client Snowball Edge, exécutez la snowballEdge configure commande pour configurer l'appareil Snowball Edge.

    Lorsque vous y êtes invité, entrez les informations suivantes :

    • Le chemin d'accès à votre fichier manifeste.

    • Le code de déverrouillage de l'appareil.

    • Le point de terminaison de l'appareil (par exemple, https://10.0.0.1).

  3. Exécutez la put-notification-configuration commande suivante pour envoyer des notifications à un courtier externe.

    snowballEdge put-notification-configuration --broker-endpoint ssl://mqtt-broker-ip-address:8883 --enabled true --service-id s3-snow --ca-certificate file:path-to-mqtt-broker-ca-cert

  4. Exécutez la get-notification-configuration commande suivante pour vérifier que tout est correctement configuré :

    snowballEdge get-notification-configuration --service-id s3-snow

    Cela renvoie le point de terminaison du courtier et le champ activé.

Une fois que vous avez configuré l'ensemble du cluster pour envoyer des notifications au MQTT courtier du réseau, chaque API appel d'objet entraîne une notification d'événement.

Note

Vous devez vous abonner au sujet s3SnowEvents/Device ID (ou Cluster Id s'il s'agit d'un cluster)/bucketName. Vous pouvez également utiliser des caractères génériques, par exemple le nom du sujet peut être # or s3SnowEvents/#.

Voici un exemple de journal des événements relatifs au stockage compatible avec Amazon S3 sur les appareils de la famille Snow :


{
    "eventDetails": {
        "additionalEventData": {
            "AuthenticationMethod": "AuthHeader",
            "CipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
            "SignatureVersion": "SigV4",
            "bytesTransferredIn": 1205,
            "bytesTransferredOut": 0,
            "x-amz-id-2": "uLdTfvdGTKlX6TBgCZtDd9Beef8wzUurA+Wpht7rKtfdaNsnxeLILg=="
        },
        "eventName": "PutObject",
        "eventTime": "2023-01-30T14:13:24.772Z",
        "requestAuthLatencyMillis": 40,
        "requestBandwidthKBs": 35,
        "requestID": "140CD93455CB62B4",
        "requestLatencyMillis": 77,
        "requestLockLatencyNanos": 1169953,
        "requestParameters": {
            "Content-Length": "1205",
            "Content-MD5": "GZdTUOhYHvHgQgmaw2gl4w==",
            "Host": "10.0.2.251",
            "bucketName": "buckett",
            "key": "file-key"
        },
        "requestTTFBLatencyMillis": 77,
        "responseElements": {
            "ETag": ""19975350e8581ef1e042099ac36825e3"",
            "Server": "AmazonS3",
            "x-amz-id-2": "uLdTfvdGTKlX6TBgCZtDd9Beef8wzUurA+Wpht7rKtfdaNsnxeLILg==",
            "x-amz-request-id": "140CD93455CB62B4"
        },
        "responseStatusCode": 200,
        "sourceIPAddress": "172.31.37.21",
        "userAgent": "aws-cli/1.27.23 Python/3.7.16 Linux/4.14.301-224.520.amzn2.x86_64 botocore/1.29.23",
        "userIdentity": {
            "identityType": "IAMUser",
            "principalId": "531520547609",
            "arn": "arn:aws:iam::531520547609:root",
            "userName": "root"
        }
    }
}

Pour plus d'informations sur les notifications d'événements Amazon S3, consultez Notifications d'événements Amazon S3.