View a markdown version of this page

CreateRecommender - Amazon Personalize
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

CreateRecommender

Membuat pemberi rekomendasi dengan resep (kasus penggunaan grup dataset Domain) yang Anda tentukan. Anda membuat pemberi rekomendasi untuk grup dataset Domain dan menentukan Nama Sumber Daya Amazon (ARN) pemberi rekomendasi saat Anda membuat GetRecommendations permintaan.

Minimal permintaan rekomendasi per detik

penting

Yang tinggi minRecommendationRequestsPerSecond akan meningkatkan tagihan Anda. Sebaiknya mulai dengan 1 untuk minRecommendationRequestsPerSecond (default). Lacak penggunaan Anda menggunakan CloudWatch metrik Amazon, dan tingkatkan minRecommendationRequestsPerSecond seperlunya.

Saat Anda membuat pemberi rekomendasi, Anda dapat mengonfigurasi permintaan rekomendasi minimum per detik. Permintaan rekomendasi minimum per detik (minRecommendationRequestsPerSecond) menentukan throughput permintaan rekomendasi dasar yang disediakan oleh Amazon Personalize. Min default RecommendationRequestsPerSecond adalah1. Permintaan rekomendasi adalah GetRecommendations operasi tunggal. Throughput permintaan diukur dalam permintaan per detik dan Amazon Personalize menggunakan permintaan Anda per detik untuk mendapatkan permintaan Anda per jam dan harga penggunaan rekomendasi Anda.

Jika permintaan per detik Anda meningkat lebih dari ituminRecommendationRequestsPerSecond, Amazon Personalize secara otomatis meningkatkan dan menurunkan kapasitas yang disediakan, tetapi tidak pernah di bawah. minRecommendationRequestsPerSecond Ada penundaan waktu yang singkat sementara kapasitas meningkat yang dapat menyebabkan hilangnya permintaan.

Tagihan Anda lebih besar dari permintaan minimum per jam (berdasarkan minRecommendationRequestsPerSecond) atau jumlah permintaan aktual. Throughput permintaan aktual yang digunakan dihitung sebagai rata-rata requests/second dalam jendela satu jam. Sebaiknya mulai dengan defaultminRecommendationRequestsPerSecond, lacak penggunaan Anda menggunakan CloudWatch metrik Amazon, lalu tingkatkan minRecommendationRequestsPerSecond seperlunya.

Status

Seorang pemberi rekomendasi dapat berada di salah satu negara bagian berikut:

  • BUAT TERTUNDA > BUAT IN_PROGRESS > AKTIF -atau- BUAT GAGAL

  • BERHENTI MENUNGGU > HENTIKAN IN_PROGRES> TIDAK AKTIF> MULAI TERTUNDE> MULAI IN_PROGRES> AKTIF

  • HAPUS TERTUNDA > HAPUS IN_PROGRESS

Untuk mendapatkan status pemberi rekomendasi, hubungi DescribeRecommender.

catatan

Tunggu sampai status pemberi rekomendasi ACTIVE sebelum meminta rekomendasi dari pemberi rekomendasi.

API Terkait

Sintaksis Permintaan

{
   "datasetGroupArn": "string",
   "name": "string",
   "recipeArn": "string",
   "recommenderConfig": { 
      "enableMetadataWithRecommendations": boolean,
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "minRecommendationRequestsPerSecond": number,
      "trainingDataConfig": { 
         "excludedDatasetColumns": { 
            "string" : [ "string" ]
         },
         "includedDatasetColumns": { 
            "string" : [ "string" ]
         }
      }
   },
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

Parameter Permintaan

Permintaan menerima data berikut dalam format JSON.

datasetGroupArn

Nama Sumber Daya Amazon (ARN) dari grup dataset domain tujuan untuk pemberi rekomendasi.

Tipe: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):personalize:.*:.*:.+

Wajib: Ya

name

Nama pemberi rekomendasi.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.

Pola: ^[a-zA-Z0-9][a-zA-Z0-9\-_]*

Wajib: Ya

recipeArn

Nama Sumber Daya Amazon (ARN) dari resep yang akan digunakan oleh pemberi rekomendasi. Untuk pemberi rekomendasi, resep adalah kasus penggunaan grup dataset Domain. Hanya kasus penggunaan grup dataset Domain yang dapat digunakan untuk membuat pemberi rekomendasi. Untuk informasi tentang kasus penggunaan, lihat Memilih kasus penggunaan pemberi rekomendasi.

Tipe: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):personalize:.*:.*:.+

Wajib: Ya

recommenderConfig

Detail konfigurasi dari pemberi rekomendasi.

Tipe: Objek RecommenderConfig

Wajib: Tidak

tags

Daftar tag untuk diterapkan pada pemberi rekomendasi.

Tipe: Array objek Tag

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.

Wajib: Tidak

Sintaksis Respons

{
   "recommenderArn": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

recommenderArn

Nama Sumber Daya Amazon (ARN) dari pemberi rekomendasi.

Tipe: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):personalize:.*:.*:.+

Kesalahan

InvalidInputException

Berikan nilai yang valid untuk bidang atau parameter.

Kode Status HTTP: 400

LimitExceededException

Batas jumlah permintaan per detik telah terlampaui.

Kode Status HTTP: 400

ResourceAlreadyExistsException

Sumber daya yang ditentukan sudah ada.

Kode Status HTTP: 400

ResourceInUseException

Sumber daya yang ditentukan sedang digunakan.

Kode Status HTTP: 400

ResourceNotFoundException

Tidak dapat menemukan sumber daya yang ditentukan.

Kode Status HTTP: 400

TooManyTagsException

Anda telah melampaui jumlah tag maksimum yang dapat Anda terapkan ke sumber daya ini.

Kode Status HTTP: 400

Lihat Juga

Untuk informasi selengkapnya tentang menggunakan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: