Créer des rubriques d'entrée et de sortie Amazon SNS

Vous devez créer une rubrique d'entrée Amazon SNS pour créer une tâche d'étiquetage en streaming. Vous pouvez éventuellement fournir une rubrique de sortie Amazon SNS.

Lorsque vous créez une rubrique Amazon SNS à utiliser dans le cadre de votre tâche d'étiquetage en streaming, notez l'Amazon Resource Name (ARN) de la rubrique. L'ARN sera la valeur d'entrée du paramètre SnsTopicArn dans InputConfig et OutputConfig lorsque vous créez une tâche d'étiquetage.

Créer une rubrique d'entrée

Votre rubrique d'entrée est utilisée pour envoyer de nouveaux objets de données à Ground Truth. Pour créer une rubrique d'entrée, suivez les instructions fournies dans Création d'une rubrique Amazon SNS dans le Guide du développeur Amazon Simple Notification Service.

Notez votre ARN de rubrique d'entrée et utilisez-le comme entrée pour le paramètre SnsTopicArn de CreateLabelingJob dans InputConfig.

Créer une rubrique de sortie

Si vous fournissez une rubrique en sortie, elle est utilisée pour envoyer des notifications lorsqu'un objet de données est étiqueté. Lorsque vous créez une rubrique, vous avez la possibilité d'ajouter une clé de chiffrement. Utilisez cette option pour ajouter une clé AWS Key Management Service gérée par le client à votre rubrique afin de chiffrer les données de sortie de votre tâche d'étiquetage avant qu'elle ne soit publiée dans votre rubrique de sortie.

Pour créer une rubrique de sortie, suivez les instructions de la section Créer une rubrique Amazon SNS du Guide du développeur Amazon Simple Notification Service.

Si vous ajoutez un chiffrement, vous devez attacher une autorisation supplémentaire à la rubrique. Pour plus d'informations, veuillez consulter Ajouter le chiffrement à votre rubrique de sortie (facultatif).

Important

Pour ajouter une clé gérée par le client à votre rubrique de sortie lors de la création d'une rubrique dans la console, n'utilisez pas l'option (Default) alias/aws/sns. Sélectionnez une clé gérée par le client que vous avez créée.

Notez votre ARN de rubrique d'entrée et utilisez-le dans votre requête CreateLabelingJob dans le paramètre SnsTopicArn de OutputConfig.

Ajouter le chiffrement à votre rubrique de sortie (facultatif)

Pour chiffrer les messages publiés dans votre rubrique de sortie, vous devez fournir une clé AWS KMS gérée par le client à votre rubrique. Modifiez la politique suivante et ajoutez-la à votre clé gérée par le client pour autoriser Ground Truth à chiffrer les données de sortie avant de les publier dans votre rubrique de sortie.

Remplacez <account_id> par l'ID du compte que vous utilisez pour créer votre rubrique. Pour savoir comment trouver votre ID du compte AWS, veuillez consulter Trouver de votre ID de compte AWS.

{
    "Id": "key-console-policy",
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Enable IAM User Permissions",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::<account_id>:root"
            },
            "Action": "kms:*",
            "Resource": "*"
        },
        {
            "Sid": "Allow access for Key Administrators",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::<account_id>:role/Admin"
            },
            "Action": [
                "kms:Create*",
                "kms:Describe*",
                "kms:Enable*",
                "kms:List*",
                "kms:Put*",
                "kms:Update*",
                "kms:Revoke*",
                "kms:Disable*",
                "kms:Get*",
                "kms:Delete*",
                "kms:TagResource",
                "kms:UntagResource",
                "kms:ScheduleKeyDeletion",
                "kms:CancelKeyDeletion"
            ],
            "Resource": "*"
        }
    ]
}

En outre, vous devez modifier et ajouter la stratégie suivante au rôle d'exécution que vous utilisez pour créer votre tâche d'étiquetage (la valeur d'entrée pour RoleArn).

Remplacez <account_id> par l'ID du compte que vous utilisez pour créer votre rubrique. Remplacez <region> par la région AWS que vous utilisez pour créer votre tâche d'étiquetage. Remplacez <key_id> par votre ID de clé gérée par le client.

{ 
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "sid1",
      "Effect": "Allow",
      "Action": [
        "kms:Decrypt",
        "kms:GenerateDataKey"
      ],
      "Resource": "arn:aws:kms:<region>:<account_id>:key/<key_id>"
    }
  ]
}

Pour plus d'informations sur la création et la sécurisation des clés, veuillez consulter les rubriques Création de clés et Utilisation de stratégies de clé dans le Guide du développeur AWS Key Management Service.

Abonner un point de terminaison à votre rubrique de sortie Amazon SNS

Lorsqu'un employé effectue une tâche d'étiquetage à partir d'une tâche d'étiquetage en streaming Ground Truth, celui-ci utilise votre rubrique de sortie pour publier des données de sortie sur un ou plusieurs points de terminaison que vous spécifiez. Pour recevoir des notifications lorsqu'un employé termine une tâche d'étiquetage, vous devez abonner un point de terminaison à la rubrique de sortie Amazon SNS.

Pour savoir comment ajouter des points de terminaison à votre rubrique de sortie, veuillez consulter S'abonner à une rubrique Amazon SNS dans le Guide du développeur Amazon Simple Notification Service.

Pour en savoir plus sur le format de données de sortie publié sur ces points de terminaison, veuillez consulter Données de sortie.

Important

Si vous n'abonnez pas de point de terminaison à votre rubrique de sortie Amazon SNS, vous ne recevrez pas de notifications lorsque de nouveaux objets de données sont étiquetés.