CreateCampaign - Amazon Personalize

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 sedang aktif. Untuk menghindari biaya yang tidak perlu, pastikan untuk menghapus kampanye ketika Anda selesai. Untuk informasi tentang biaya kampanye, lihat harga Amazon Personalisasi.

Membuat kampanye yang menerapkan versi solusi. Saat klien memanggil GetPersonalizedRankingAPI GetRecommendationsdan, kampanye ditentukan dalam permintaan.

TPS dan Penskalaan Otomatis yang Disediakan Minimum

penting

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 Amazon Personalize, 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 sedang aktif. Transaksi adalah satu GetRecommendations atau GetPersonalizedRanking permintaan. minProvisionedTPSDefaultnya adalah 1.

Jika TPS Anda meningkat lebih dari ituminProvisionedTPS, Amazon Personalize secara otomatis menskalakan kapasitas yang disediakan ke atas dan ke bawah, tetapi tidak pernah di bawah. minProvisionedTPS Ada penundaan waktu singkat sementara kapasitas meningkat yang dapat menyebabkan hilangnya transaksi. Ketika lalu lintas Anda berkurang, kapasitas kembali keminProvisionedTPS.

Anda dikenakan biaya untuk TPS minimum yang disediakan atau, jika permintaan Anda melebihi, TPS yang minProvisionedTPS sebenarnya. TPS sebenarnya adalah jumlah 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 Amazon Personalisasi.

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 sampai kampanye ACTIVE sebelum meminta rekomendasi kampanye. status

Sintaksis Permintaan

{ "campaignConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "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

Diperlukan: Tidak

minProvisionedTPS

Menentukan transaksi minimum yang disediakan (rekomendasi) per detik yang akan didukung Amazon Personalize. Tinggi minProvisionedTPS akan meningkatkan tagihan Anda. Sebaiknya mulai dengan 1 untuk minProvisionedTPS (default). Lacak penggunaan Anda menggunakan CloudWatch metrik Amazon, dan tingkatkan minProvisionedTPS seperlunya.

Jenis: Integer

Rentang yang Valid: Nilai minimum 1.

Diperlukan: Tidak

name

Nama untuk kampanye baru. Nama kampanye harus unik di akun Anda.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.

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

Diperlukan: 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/$LATEST format. Anda harus menggunakan format ini jika Anda mengatur syncWithLatestSolutionVersion ke True dalam 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.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

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

Diperlukan: Ya

tags

Daftar tag untuk diterapkan ke kampanye.

Tipe: Array objek Tag

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

Diperlukan: 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.

Jenis: 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 AWS SDK khusus bahasa, lihat berikut ini: