Crear temas de entrada y salida de Amazon SNS

Debe crear una entrada de Amazon SNS para crear un trabajo de etiquetado en streaming. Si lo desea, puede proporcionar un tema de salida de Amazon SNS.

Al crear un tema de Amazon SNS para utilizarlo en el trabajo de etiquetado en streaming, anote el nombre de recurso de Amazon (ARN) del tema. El ARN serán los valores de entrada del parámetro SnsTopicArn en InputConfig y OutputConfig cuando cree un trabajo de etiquetado.

Crear un tema de entrada

El tema de entrada se utiliza para enviar nuevos objetos de datos a Ground Truth. Para crear un tema de entrada, siga las instrucciones de Creating an Amazon SNS topic en la Guía para desarrolladores de Amazon Simple Notification Service.

Anote el ARN del tema de entrada y utilícelo como entrada para el parámetro de CreateLabelingJob SnsTopicArn en InputConfig.

Crear un tema de salida

Si proporciona un tema de salida, se utiliza para enviar notificaciones cuando se etiqueta un objeto de datos. Cuando crea un tema tiene la opción de agregar una clave de cifrado. Utilice esta opción para añadir una clave gestionada por el AWS Key Management Service cliente a su tema para cifrar los datos de salida del trabajo de etiquetado antes de publicarlos en el tema de salida.

Para crear un tema de salida, siga las instrucciones de Creating an Amazon SNS topic en la Guía para desarrolladores de Amazon Simple Notification Service.

Si agrega cifrado, debe asociar un permiso adicional al tema. Para obtener más información, consulte Añada cifrado al tema de salida (opcional).

importante

Para añadir una clave gestionada por el cliente al tema de salida al crear un tema en la consola, no utilice la opción alias/aws/sns (predeterminada). Seleccione una clave gestionada por el cliente que ha creado.

Anote el ARN del tema de entrada y utilícelo en su solicitud de CreateLabelingJob en el parámetro SnsTopicArn en OutputConfig.

Añada cifrado al tema de salida (opcional)

Para cifrar mensajes publicados en el tema de salida debe proporcionar una clave gestionada por el cliente de AWS KMS al tema. Modifique la siguiente política y agréguela a la clave gestionada por el cliente para dar a Ground Truth permiso para cifrar datos de salida antes de publicarlos en el tema de salida.

Sustituya <account_id> por el identificador de la cuenta que está utilizando para crear el tema. Para obtener información sobre cómo encontrar tu ID de AWS cuenta, consulta Cómo encontrar tu ID de AWS cuenta.

{
    "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": "*"
        }
    ]
}

Además, debe modificar y añadir la siguiente política al rol de ejecución que utiliza para crear el trabajo de etiquetado (el valor de entrada de RoleArn).

Sustituya <account_id> por el identificador de la cuenta que está utilizando para crear el tema. Sustituya <region> por la región de AWS en la que vaya a crear el trabajo de etiquetado. Sustituya <key_id> por el identificador de clave gestionada por el cliente.

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

Para obtener más información sobre la creación y protección de claves, consulte Creación de claves y uso de políticas clave en la Guía para AWS Key Management Service desarrolladores.

Suscribir un punto de conexión a un tema de Amazon SNS

Cuando un trabajador completa una tarea de etiquetado desde un trabajo de etiquetado en streaming de Ground Truth, Ground Truth utiliza el tema de salida para publicar datos de salida en uno o más puntos de conexión que usted especifique. Para recibir notificaciones cuando un trabajador termina una tarea de etiquetado debe suscribir un punto de conexión a un tema de salida de Amazon SNS.

Para aprender a agregar puntos de conexión a un tema de salida, consulte Suscripción a un tema de Amazon SNS en la Guía para desarrolladores de Amazon Simple Notification Service.

Para obtener más información sobre el formato de datos de salida que se publica en estos puntos de conexión, consulte Datos de salida.

importante

Si no suscribe un punto de conexión a un tema de salida de Amazon SNS, no recibirá notificaciones cuando se etiqueten nuevos objetos de datos.