Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
CreateCampaign
penting
Anda dikenakan biaya kampanye saat aktif. Untuk menghindari biaya yang tidak perlu, pastikan untuk menghapus kampanye setelah Anda selesai. Untuk informasi tentang biaya kampanye, lihat Harga Personalisasi Amazon
Membuat kampanye yang menerapkan versi solusi. Ketika klien memanggil GetPersonalizedRanking API GetRecommendations dan, kampanye ditentukan dalam permintaan.
TPS Minimum yang Disediakan dan Auto-Scaling
penting
Yang tinggi minProvisionedTPS akan meningkatkan biaya Anda. Sebaiknya mulai dengan 1 untuk minProvisionedTPS (default). Lacak penggunaan Anda menggunakan CloudWatch metrik Amazon, dan tingkatkan minProvisionedTPS seperlunya.
Saat membuat kampanye Personalisasi Amazon, Anda dapat menentukan transaksi minimum yang disediakan per detik (minProvisionedTPS) untuk kampanye. Ini adalah throughput transaksi dasar untuk kampanye yang disediakan oleh Amazon Personalize. Ini menetapkan biaya penagihan minimum untuk kampanye saat aktif. Transaksi adalah satu GetRecommendations atau GetPersonalizedRanking permintaan. Default minProvisionedTPS nya adalah 1.
Jika TPS Anda meningkat melampaui batasminProvisionedTPS, Amazon Personalize secara otomatis meningkatkan dan menurunkan kapasitas yang disediakan, tetapi tidak pernah di bawah. minProvisionedTPS Ada penundaan waktu yang singkat sementara kapasitas meningkat yang dapat menyebabkan hilangnya transaksi. Ketika lalu lintas Anda berkurang, kapasitas kembali keminProvisionedTPS.
Anda akan dikenakan biaya untuk TPS minimum yang disediakan atau, jika permintaan Anda melebihiminProvisionedTPS, TPS yang sebenarnya. TPS sebenarnya adalah jumlah total permintaan rekomendasi yang Anda buat. Sebaiknya mulai dengan yang rendahminProvisionedTPS, lacak penggunaan Anda menggunakan CloudWatch metrik Amazon, lalu tingkatkan minProvisionedTPS seperlunya.
Untuk informasi selengkapnya tentang biaya kampanye, lihat Harga Personalisasi Amazon
Status
Kampanye dapat berada di salah satu negara bagian berikut:
-
BUAT TERTUNDA > BUAT IN_PROGRESS > AKTIF -atau- BUAT GAGAL
-
HAPUS TERTUNDA > HAPUS IN_PROGRESS
Untuk mendapatkan status kampanye, hubungi DescribeCampaign.
catatan
Tunggu status sampai kampanye selesai ACTIVE sebelum meminta rekomendasi kampanye.
API Terkait
Sintaksis Permintaan
{
"campaignConfig": {
"enableMetadataWithRecommendations": boolean,
"itemExplorationConfig": {
"string" : "string"
},
"rankingInfluence": {
"string" : number
},
"syncWithLatestSolutionVersion": boolean
},
"minProvisionedTPS": number,
"name": "string",
"solutionVersionArn": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}
Parameter Permintaan
Permintaan menerima data berikut dalam format JSON.
- campaignConfig
-
Detail konfigurasi kampanye.
Tipe: Objek CampaignConfig
Wajib: Tidak
- minProvisionedTPS
-
Menentukan transaksi (rekomendasi) minimum yang diminta per detik yang akan didukung oleh Amazon Personalize. Yang tinggi
minProvisionedTPSakan meningkatkan tagihan Anda. Sebaiknya mulai dengan 1 untukminProvisionedTPS(default). Lacak penggunaan Anda menggunakan CloudWatch metrik Amazon, dan tingkatkanminProvisionedTPSseperlunya.Tipe: Bilangan Bulat
Rentang yang Valid: Nilai minimum 1.
Wajib: Tidak
- name
-
Nama untuk kampanye baru. Nama kampanye harus unik di dalam akun Anda.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.
Pola:
^[a-zA-Z0-9][a-zA-Z0-9\-_]*Wajib: Ya
- solutionVersionArn
-
Nama Sumber Daya Amazon (ARN) dari model terlatih untuk digunakan bersama kampanye. Untuk menentukan versi solusi terbaru dari solusi Anda, tentukan ARN solusi Anda dalam
SolutionArn/$LATESTformat. Anda harus menggunakan format ini jika Anda menysyncWithLatestSolutionVersionTrueetel ke CampaignConfig.Untuk menerapkan model yang bukan versi solusi terbaru dari solusi Anda, tentukan ARN versi solusi.
Untuk informasi selengkapnya tentang pembaruan kampanye otomatis, lihat Mengaktifkan pembaruan kampanye otomatis.
Tipe: String
Batasan Panjang: Panjang maksimum 256.
Pola:
arn:([a-z\d-]+):personalize:.*:.*:.+Wajib: Ya
-
Daftar tag yang akan diterapkan pada kampanye.
Tipe: Array objek Tag
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.
Wajib: Tidak
Sintaksis Respons
{
"campaignArn": "string"
}
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- campaignArn
-
Amazon Resource Name (ARN) dari kampanye.
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: