Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
CreateEventTracker
Membuat pelacak peristiwa yang Anda gunakan saat menambahkan data peristiwa ke grup dataset tertentu menggunakan PutEvents API.
catatan
Hanya satu pelacak peristiwa yang dapat dikaitkan dengan grup dataset. Anda akan mendapatkan kesalahan jika Anda memanggil CreateEventTracker menggunakan grup dataset yang sama dengan pelacak peristiwa yang ada.
Saat Anda membuat pelacak peristiwa, respons menyertakan ID pelacakan, yang Anda berikan sebagai parameter saat Anda menggunakan PutEvents operasi. Amazon Personalize kemudian menambahkan data peristiwa ke dataset interaksi Item dari grup dataset yang Anda tentukan di pelacak acara Anda.
Pelacak acara dapat berada di salah satu status berikut:
-
BUAT TERTUNDA > BUAT IN_PROGRESS > AKTIF -atau- BUAT GAGAL
-
HAPUS TERTUNDA > HAPUS IN_PROGRESS
Untuk mendapatkan status pelacak acara, hubungi DescribeEventTracker.
catatan
Pelacak peristiwa harus dalam status AKTIF sebelum menggunakan ID pelacakan.
API Terkait
Sintaksis Permintaan
{
"datasetGroupArn": "string",
"name": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}Parameter Permintaan
Permintaan menerima data berikut dalam format JSON.
- datasetGroupArn
-
Nama Sumber Daya Amazon (ARN) dari grup dataset yang menerima data peristiwa.
Tipe: String
Batasan Panjang: Panjang maksimum 256.
Pola:
arn:([a-z\d-]+):personalize:.*:.*:.+Wajib: Ya
- name
-
Nama untuk pelacak acara.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.
Pola:
^[a-zA-Z0-9][a-zA-Z0-9\-_]*Wajib: Ya
-
Daftar tag untuk diterapkan ke pelacak acara.
Tipe: Array objek Tag
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.
Wajib: Tidak
Sintaksis Respons
{
"eventTrackerArn": "string",
"trackingId": "string"
}Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- eventTrackerArn
-
ARN dari pelacak acara.
Tipe: String
Batasan Panjang: Panjang maksimum 256.
Pola:
arn:([a-z\d-]+):personalize:.*:.*:.+ - trackingId
-
ID pelacak acara. Sertakan ID ini dalam permintaan ke PutEvents API.
Tipe: String
Batasan Panjang: Panjang maksimum 256.
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:
