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 kumpulan data Domain) yang Anda tentukan. Anda membuat rekomendasi untuk grup kumpulan data Domain dan menentukan Amazon Resource Name (ARN) pemberi rekomendasi saat Anda membuat permintaan. [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) **Permintaan rekomendasi minimum per detik** **penting** 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 membuat pemberi rekomendasi, Anda dapat mengonfigurasi permintaan rekomendasi minimum pemberi rekomendasi per detik. Permintaan rekomendasi minimum per detik (`minRecommendationRequestsPerSecond`) menentukan throughput permintaan rekomendasi dasar yang disediakan oleh Amazon Personalize. minRecommendationRequestsPerSecond Defaultnya adalah`1`. 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 pemberi rekomendasi Anda. Jika permintaan per detik Anda meningkat lebih dari itu`minRecommendationRequestsPerSecond`, Amazon Personalize secara otomatis menskalakan kapasitas yang disediakan ke atas dan ke bawah, tetapi tidak pernah di bawah ini. `minRecommendationRequestsPerSecond` Ada penundaan waktu singkat sementara kapasitas meningkat yang dapat menyebabkan hilangnya permintaan. Tagihan Anda lebih besar dari permintaan minimum per jam (berdasarkan minRecommendationRequestsPerSecond) atau jumlah permintaan yang sebenarnya. Throughput permintaan aktual yang digunakan dihitung sebagai rata-rata requests/second dalam jendela satu jam. Sebaiknya mulai dengan default`minRecommendationRequestsPerSecond`, lacak penggunaan Anda menggunakan CloudWatch metrik Amazon, dan kemudian tingkatkan `minRecommendationRequestsPerSecond` seperlunya. **Status** Seorang pemberi rekomendasi dapat berada di salah satu negara bagian berikut: + BUAT TERTUNDA > BUAT IN\$1PROGRESS> AKTIF -atau- BUAT GAGAL + STOP PENDING > STOP IN\$1PROGRESS > TIDAK AKTIF> MULAI TERTUNDA > MULAI IN\$1PROGRESS > AKTIF + HAPUS TERTUNDA > HAPUS IN\$1PROGRESS Untuk mendapatkan status pemberi rekomendasi, hubungi [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html). **catatan** Tunggu sampai pemberi rekomendasi `ACTIVE` sebelum meminta rekomendasi dari pemberi rekomendasi. `status` **Terkait APIs** + [ListRecommenders](https://docs.aws.amazon.com/personalize/latest/dg/API_ListRecommenders.html) + [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) + [UpdateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateRecommender.html) + [DeleteRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteRecommender.html) ## 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](#API_CreateRecommender_RequestSyntax) ** Nama Sumber Daya Amazon (ARN) dari grup kumpulan data domain tujuan untuk pemberi rekomendasi. Tipe: String Batasan Panjang: Panjang maksimum 256. Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+` Wajib: Ya ** [name](#API_CreateRecommender_RequestSyntax) ** 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](#API_CreateRecommender_RequestSyntax) ** Nama Sumber Daya Amazon (ARN) dari resep yang akan digunakan oleh pemberi rekomendasi. Untuk pemberi rekomendasi, resep adalah kasus penggunaan grup kumpulan data Domain. Hanya kasus penggunaan grup kumpulan data Domain yang dapat digunakan untuk membuat pemberi rekomendasi. Untuk informasi tentang kasus penggunaan, lihat [Memilih kasus penggunaan pemberi rekomendasi](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html). Tipe: String Batasan Panjang: Panjang maksimum 256. Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+` Wajib: Ya ** [recommenderConfig](#API_CreateRecommender_RequestSyntax) ** Detail konfigurasi dari pemberi rekomendasi. Tipe: Objek [RecommenderConfig](API_RecommenderConfig.md) Wajib: Tidak ** [tags](#API_CreateRecommender_RequestSyntax) ** Daftar [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) untuk diterapkan ke pemberi rekomendasi. Tipe: Array objek [Tag](API_Tag.md) 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](#API_CreateRecommender_ResponseSyntax) ** 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 maksimum tag yang dapat Anda terapkan ke sumber daya ini. Kode Status HTTP: 400 ## Lihat Juga Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini: + [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateRecommender) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateRecommender) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateRecommender) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateRecommender) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateRecommender) + [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateRecommender) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateRecommender) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateRecommender) + [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateRecommender) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateRecommender)