Configuração do armazenamento compatível com o Amazon S3 em dispositivos da Família Snow: notificações de eventos - AWS Snowball Edge Guia do desenvolvedor

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configuração do armazenamento compatível com o Amazon S3 em dispositivos da Família Snow: notificações de eventos

O armazenamento compatível com o Amazon S3 em dispositivos da família Snow suporta notificações de eventos do Amazon S3 para chamadas de API de objetos com base no protocolo Message Queuing Telemetry Transport (MQTT).

Você pode usar armazenamento compatível com Amazon S3 em dispositivos da Família Snow para receber notificações quando determinados eventos acontecerem no bucket do S3. Para habilitar notificações, adicione uma configuração de notificação que identifique os eventos que deseja que o serviço publique.

O armazenamento compatível com Amazon S3 em dispositivos da Família Snow suporta os seguintes tipos de notificação:

  • Eventos de criação de novos objetos

  • Eventos de remoção de objetos

  • Eventos de marcação de objetos

Configurar notificações de eventos do Amazon S3

  1. Antes de começar, é necessário ter uma infraestrutura do MQTT na sua rede.

  2. No seu Snowball Edge Client, execute o comando snowballEdge configure para configurar o dispositivo Snowball Edge.

    Quando solicitado, forneça as seguintes informações:

    • O caminho até o seu arquivo manifesto.

    • O código de desbloqueio do dispositivo.

    • O endpoint do dispositivo (por exemplo, https://10.0.0.1).

  3. Execute o comando put-notification-configuration a seguir para enviar notificações a um atendente externo.

    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. Execute o comando get-notification-configuration a seguir para verificar se tudo está configurado corretamente:

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

    Isso retorna o endpoint do atendente e o campo ativado.

Depois de configurar todo o cluster para enviar notificações ao atendente MQTT na rede, cada chamada de API de objeto resultará em uma notificação de evento.

nota

Você precisa se inscrever no tópico s3SnowEvents/ID do dispositivo (ou ID do cluster, se for um cluster) /bucketName. Você também pode usar curingas, por exemplo, o nome do tópico pode ser # ou s3 SnowEvents /#.

A seguir está um exemplo de registro de eventos de armazenamento compatível com Amazon S3 em dispositivos da Família 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"
        }
    }
}

Para obter mais informações sobre notificações de eventos do Amazon S3, consulte Notificações de eventos do Amazon S3.