Requisitos previos para los trabajos de traducción por lotes

Se deben cumplir los siguientes requisitos previos para que Amazon Translate pueda realizar un trabajo de traducción por lotes correctamente:

Formatos de archivo compatibles

Amazon Translate admite los siguientes tipos de archivos para los trabajos de traducción por lotes:

Amazon Translate requiere que los archivos tengan la codificación UTF-8.

Permisos de requisitos previos

Para poder ejecutar un trabajo de traducción por lotes, su AWS cuenta debe tener una función de servicio en IAM. Este rol debe tener una política de permisos que conceda Amazon Translate::

También debe incluir una política de confianza que permita a Amazon Translate asumir el rol y obtener sus permisos. Esta política de confianza debe permitir que la entidad principal de servicio de translate.amazonaws.com realice la acción sts:AssumeRole.

Cuando cree un trabajo de traducción por lotes mediante la consola de Amazon Translate, tiene la opción de permitir que Amazon Translate cree automáticamente este rol por usted. Cuando ejecuta un trabajo de traducción por lotes mediante la API Amazon Translate AWS CLI o la API Amazon Translate, proporciona el nombre de recurso de Amazon (ARN) del rol en su solicitud.

Para obtener más información, consulte Creación de un rol para delegar permisos a un servicio de AWS en la Guía del usuario de IAM.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "s3:GetObject",
      "Resource": [
        "arn:aws:s3:::input-bucket-name/*",
        "arn:aws:s3:::output-bucket-name/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": "s3:ListBucket",
      "Resource": [
        "arn:aws:s3:::input-bucket-name",
        "arn:aws:s3:::output-bucket-name"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "s3:PutObject"
      ],
      "Resource": "arn:aws:s3:::output-bucket-name/*"
    }
  ]
}

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "translate.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "ArnLike": {
            "aws:SourceArn": "arn:aws:translate:*:111122223333:*"
        },
        "StringEquals": {
            "aws:SourceAccount": "111122223333"
        }
      }
    }
  ]
}

Permisos necesarios para personalizar el cifrado

Puede personalizar la configuración de cifrado en Amazon Translate, pero primero debe añadir permisos al rol de servicio en IAM.

Amazon Translate cifra el resultado de la traducción que produce al ejecutar un trabajo de traducción por lotes. De forma predeterminada, realiza este cifrado con una Clave administrada de AWS. Este tipo de clave se crea AWS y se almacena en AWS Key Management Service (AWS KMS) en su cuenta. Sin embargo, no puede administrar esta clave de KMS por su cuenta. AWS la administra y la usa en su nombre.

Si lo desea, puede optar por cifrar el resultado con una clave administrada por el cliente, que es una clave de KMS que usted crea, posee y administra en su AWS cuenta.

La clave debe tener una política de claves que permita utilizar la clave de Amazon Translate. Para ello, la política de claves concede sus permisos al rol de servicio que permite a Amazon Translate acceder a su bucket de Amazon S3.

La política de claves permite al rol de servicio realizar las AWS KMS operaciones necesarias para cifrar el resultado, como se muestra en el siguiente ejemplo de declaración de política.

{
  "Effect": "Allow",
  "Principal":
  {
    "AWS":
    [
      "arn:aws:iam::111122223333:role/AmazonTranslateServiceRoleS3FullAccess"
    ]
  },
  "Action":
  [
    "kms:Decrypt",
    "kms:GenerateDataKey",
    "kms:CreateGrant",
    "kms:RetireGrant",
    "kms:DescribeKey"
  ],
  "Resource": "*"
}

Para obtener más información, consulte Políticas de claves en AWS KMS en la Guía para desarrolladores de AWS Key Management Service .

Permisos para usar una AWS KMS clave de otra cuenta AWS

Si quieres usar una clave de KMS que esté en una AWS cuenta diferente de aquella en la que usas Amazon Translate, debes:

Para actualizar su función de servicio, adjunte una política que le permita realizar las AWS KMS operaciones necesarias con la clave de KMS que se encuentra en la otra AWS cuenta, como se muestra en el siguiente ejemplo.

{
  "Effect": "Allow",
  "Action":
  [
    "kms:Decrypt",
    "kms:GenerateDataKey",
    "kms:CreateGrant",
    "kms:RetireGrant",
    "kms:DescribeKey"
  ],
  "Resource": "arn:aws:kms:us-west-2:111122223333:key/key-id"
}

Para actualizar su política de claves de KMS, añada el rol de servicio y el usuario administrador como entidades principales autorizadas a usar la clave, tal como se muestra en el siguiente ejemplo de instrucción de política.

{
  "Effect": "Allow",
  "Principal":
  {
    "AWS":
    [
      "arn:aws:iam::444455556666:role/AmazonTranslateServiceRoleS3FullAccess",
      "arn:aws:iam::444455556666:admin"
    ]
  },
  "Action":
  [
    "kms:Decrypt",
    "kms:CreateGrant",
    "kms:GenerateDataKey",
    "kms:RetireGrant",
    "kms:DescribeKey"
  ],
  "Resource": "*"
}

Para obtener más información, consulte Permitir que los usuarios de otras cuentas usen una AWS KMS clave en la Guía para AWS Key Management Service desarrolladores