Prasyarat untuk pekerjaan penerjemahan batch

Prasyarat berikut harus dipenuhi agar Amazon Translate dapat melakukan pekerjaan penerjemahan batch yang berhasil:

Format file yang didukung

Amazon Translate mendukung jenis file berikut untuk pekerjaan penerjemahan batch:

Amazon Translate memerlukan file yang dikodekan dalam UTF-8.

Izin prasyarat

Sebelum Anda dapat menjalankan pekerjaan penerjemahan batch,AWS akun Anda harus memiliki peran layanan di IAM. Peran ini harus memiliki kebijakan izin yang memberikan Amazon Translate:

Peran juga harus menyertakan kebijakan kepercayaan yang memungkinkan Amazon Translate untuk mengambil peran tersebut dan mendapatkan izinnya. Kebijakan kepercayaan ini harus memungkinkan prinsipaltranslate.amazonaws.com layanan untuk melakukansts:AssumeRole tindakan.

Ketika Anda membuat pekerjaan penerjemahan batch dengan menggunakan konsol Amazon Translate, Anda memiliki opsi untuk mengizinkan Amazon Translate Anda membuat peran ini secara otomatis untuk Anda. Ketika Anda menjalankan pekerjaan penerjemahan batch dengan menggunakan Amazon Translate API, Anda menyediakan Amazon Resource Name (ARN) dari peran Anda dalam permintaan Anda.AWS CLI

Untuk informasi selengkapnya, lihat Membuat Peran untuk Menyerahkan Izin ke Layanan AWS dalam Panduan Pengguna 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"
        }
      }
    }
  ]
}

Izin prasyarat untuk menyesuaikan enkripsi

Anda dapat menyesuaikan pengaturan enkripsi di Amazon Translate, tetapi pertama-tama Anda harus menambahkan izin ke peran layanan di IAM.

Amazon Translate mengenkripsi output terjemahan yang Anda hasilkan saat menjalankan tugas penerjemahan batch. Secara default, ia melakukan enkripsi ini dengan file Kunci yang dikelola AWS. Jenis kunci ini dibuat olehAWS dan disimpan dalamAWS Key Management Service (AWS KMS) di akun Anda. Namun, Anda tidak dapat mengelola kunci ini sendiri. Itu dikelola dan digunakan atas nama Anda hanya olehAWS.

Secara opsional, Anda dapat memilih untuk mengenkripsi output Anda dengan kunci yang dikelola pelanggan, yang merupakan kunci KMS yang Anda buat, miliki, dan kelola diAWS akun Anda.

Kunci Anda harus memiliki kebijakan utama yang memungkinkan Amazon Translate menggunakannya. Kebijakan kunci melakukan hal ini dengan memberikan izinnya kepada peran layanan yang memungkinkan Amazon Translate untuk mengakses bucket Amazon S3 Anda.

Kebijakan kunci memungkinkan peran layanan untuk melakukanAWS KMS operasi yang diperlukan untuk mengenkripsi output Anda, seperti yang ditunjukkan oleh pernyataan kebijakan contoh berikut.

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

Untuk informasi selengkapnya, lihat Kebijakan utamaAWS KMS di dalam PanduanAWS Key Management Service Pengembang

Izin untuk menggunakanAWS KMS kunci dariAWS akun lain

Jika Anda ingin menggunakan kunci KMS yang ada diAWS akun yang berbeda dari yang Anda gunakan Amazon Translate, maka Anda harus:

Untuk memperbarui peran layanan Anda, lampirkan kebijakan yang memungkinkannya melakukanAWS KMS operasi yang diperlukan dengan kunci KMS yang ada diAWS akun lain, seperti yang ditunjukkan oleh contoh berikut.

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

Untuk memperbarui kebijakan kunci KMS Anda, tambahkan peran layanan dan pengguna admin sebagai prinsipal yang diizinkan untuk menggunakan kunci, seperti yang ditunjukkan oleh pernyataan kebijakan contoh berikut.

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

Untuk informasi selengkapnya, lihat Mengizinkan pengguna di akun lain menggunakanAWS KMS kunci di PanduanAWS Key Management Service Pengembang