Referensi API AWS Marketplace direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat Referensi API [ AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pencatatan logAWS MarketplacePanggilan API perjanjian dengan CloudTrail
API Perjanjian terintegrasi denganAWS CloudTrail, layanan yang menyediakan catatan tindakan yang diambil oleh pengguna, peran, atau Layanan AWS dalamAWS Marketplace. CloudTrail menangkap panggilan API untuk API Perjanjian sebagai peristiwa. Panggilan yang diambil termasuk panggilan dari AWS Marketplace situs web, konsol, dan antarmuka lain yang memanfaatkan API Perjanjian, serta panggilan kode langsung ke operasi API Perjanjian.
Jika Anda membuat jejak, Anda dapat mengaktifkan pengiriman CloudTrail peristiwa secara berkelanjutan ke bucket Amazon S3, termasuk peristiwa untuk API Perjanjian. *Jejak* memungkinkan CloudTrail untuk mengirim berkas log ke bucket Amazon S3. Jika Anda tidak mengonfigurasi jejak, Anda masih dapat melihat peristiwa terbaru di CloudTrail konsol dalam **Riwayat acara**. Dengan menggunakan informasi yang dikumpulkan oleh CloudTrail, Anda dapat menentukan permintaan yang dibuat ke API Perjanjian, alamat IP dari mana permintaan dibuat, siapa yang membuat permintaan, kapan dibuat, dan detail tambahan.
Untuk informasi selengkapnya CloudTrail, lihat [Panduan AWS CloudTrail Pengguna](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html).
## Perjanjian informasi API di CloudTrail
CloudTrail diaktifkan pada Akun AWS saat Anda membuat akun. Ketika aktivitas terjadi di API Perjanjian, aktivitas tersebut dicatat dalam suatu CloudTrail peristiwa bersama dengan Layanan AWS peristiwa lain dalam **riwayat Peristiwa**. Anda dapat melihat, mencari, dan mengunduh acara terbaru di situs AndaAkun AWS. Untuk informasi selengkapnya, lihat [Melihat CloudTrail peristiwa dengan riwayat peristiwa](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) di *Panduan AWS CloudTrail Pengguna*.
Untuk catatan peristiwa yang sedang berlangsung di AndaAkun AWS, termasuk peristiwa untuk API Perjanjian, buat jejak. *Jejak* memungkinkan CloudTrail untuk mengirimkan file log ke bucket Amazon S3. Secara default, saat Anda membuat jejak di konsol, jejak tersebut berlaku untuk semua Wilayah AWS. Jejak mencatat peristiwa dari semua Wilayah di partisi AWS dan mengirimkan file log ke bucket Amazon S3 yang Anda tentukan. Selain itu, Anda dapat mengonfigurasi lainnya Layanan AWS untuk menganalisis lebih lanjut dan menindaklanjuti data peristiwa yang dikumpulkan dalam CloudTrail log. Untuk informasi selengkapnya, lihat berikut:
+ [Gambaran umum untuk membuat jejak](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail layanan dan integrasi yang didukung](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html)
+ [Mengonfigurasi notifikasi Amazon SNS untuk CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Menerima file CloudTrail log dari beberapa wilayah](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) dan [Menerima file CloudTrail log dari beberapa akun](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Setiap entri peristiwa atau log berisi informasi tentang entitas yang membuat permintaan tersebut. Informasi identitas membantu Anda menentukan hal berikut:
+ Baik permintaan tersebut dibuat dengan kredensial pengguna atau root.
+ Apakah permintaan tersebut dibuat dengan kredensial keamanan sementara untuk satu peran atau pengguna gabungan.
+ Apakah permintaan tersebut dibuat oleh Layanan AWS lain.
Untuk informasi selengkapnya, lihat [elemen CloudTrail UserIdentity](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html) di *AWS CloudTrailPanduan Pengguna*.
## Memahami tindakan API Perjanjian
API Perjanjian digunakan untuk membeli perangkat lunak sebagai layanan (SaaS), server (termasuk wadah), dan produk layanan profesional. AWS Marketplace Ini juga digunakan untuk mengelola perjanjian atau langganan yang dihasilkan. AWS Marketplace
**catatan**
Pembelian AWS Data Exchange produk tidak akan dicatat oleh CloudTrail.
`AcceptAgreementRequest`Tindakan ini digunakan ketika pengguna AWS Identity and Access Management (IAM) atau peran Akun AWS pembelian produk yang berlaku padaAWS Marketplace. Demikian pula, `CancelAgreement` tindakan tersebut digunakan ketika pengguna atau peran IAM membatalkan perjanjian atau langganan mereka. Dengan memantau CloudTrail log di API Perjanjian, pembeli dapat memantau tindakan terkait pembelian yang paling penting yang terjadi di dalamnya. Akun AWS AWS Marketplace
`DescribeAgreement`Tindakan ini digunakan ketika pelanggan secara khusus melihat meta data untuk perjanjian tertentu. `GetAgreementTerms`Tindakan ini digunakan ketika ketentuan perjanjian tertentu dilihat. `SearchAgreements`Tindakan ini digunakan ketika pengguna IAM atau daftar peran atau menyaring sebagian dari perjanjian mereka dari daftar lengkap semua perjanjian mereka.
**catatan**
Tindakan `AcceptAgreementRequest` dan `CancelAgreement` tindakan tersedia untuk pembeli tetapi bukan penjual. Namun, `DescribeAgreement``GetAgreementTerms`, dan `SearchAgreements` tindakan dapat digunakan oleh pembeli dan penjual.
Pembeli juga dapat mengidentifikasi ID Perjanjian perjanjian dari CloudTrail log. Untuk informasi selengkapnya tentang perjanjian, pilih tab **Kelola langganan** di AWS Marketplace konsol, di mana ID Perjanjian disediakan di tampilan **Detail**. ID Perjanjian dapat ditemukan di `responseElements` untuk tindakan `AcceptAgreementRequest` API dan `requestParameters` untuk tindakan `CancelAgreement` API.
## Memahami Perjanjian entri file log API
Trail adalah konfigurasi yang memungkinkan pengiriman peristiwa sebagai file log ke bucket Amazon S3 yang Anda tentukan. CloudTrail file log berisi satu atau lebih entri log. Peristiwa mewakili permintaan tunggal dari sumber manapun dan mencakup informasi tentang tindakan yang diminta, tanggal dan waktu tindakan, parameter permintaan, dan sebagainya. CloudTrail file log bukanlah jejak tumpukan yang diurutkan dari panggilan API publik, jadi file tersebut tidak ditampilkan dalam urutan tertentu.
Contoh berikut menunjukkan entri CloudTrail log yang menunjukkan `AcceptAgreementRequest` tindakan.
```
{
"eventVersion": "1.08",
"userIdentity": {
"type": "Unknown",
"principalId": "ABCDEFGHIJKLMNOP12345",
"arn": "arn:aws:iam::123456789010:user/CloudTrailTestUser",
"accountId": "123456789010",
"accessKeyId": "ABCDEFGHIJKLMNOP123"
},
"eventTime": "2023-08-11T17:13:50Z",
"eventSource": "agreement-marketplace.amazonaws.com",
"eventName": "AcceptAgreementRequest",
"awsRegion": "us-west-2",
"sourceIPAddress": "127.0.0.1",
"userAgent": "Coral/Netty4",
"requestParameters": {
"agreementRequestId": "ar-6xbrddjzym594imkrrezrn5wa"
},
"responseElements": {
"agreementId": "agmt-1lnrq6riwpg2tczhv378zknlc"
},
"requestID": "fEXAMPLE-cb3e-4e21-86fd-6b3EXAMPLEd1",
"eventID": "7EXAMPLE-97d6-4139-91e3-01aEXAMPLE48",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789010",
"eventCategory": "Management"
}
```
Contoh berikut menunjukkan entri CloudTrail log yang menunjukkan `CancelAgreement` tindakan.
```
{
"eventVersion": "1.08",
"userIdentity": {
"type": "Unknown",
"principalId": "ABCDEFGHIJKLMNOP12345",
"arn": "arn:aws:iam::123456789010:user/CloudTrailTestUser",
"accountId": "123456789010",
"accessKeyId": "ABCDEFGHIJKLMNOP1234"
},
"eventTime": "2023-08-14T03:11:42Z",
"eventSource": "agreement-marketplace.amazonaws.com",
"eventName": "CancelAgreement",
"awsRegion": "us-west-2",
"sourceIPAddress": "127.0.0.1",
"userAgent": "Coral/Netty4",
"requestParameters": {
"agreementId": "agmt-enitbfqjebjmwmomzrucf032t"
},
"responseElements": null,
"requestID": "fEXAMPLE-cb3e-4e21-86fd-6b3EXAMPLEd1",
"eventID": "7EXAMPLE-97d6-4139-91e3-01aEXAMPLE48",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789010",
"eventCategory": "Management"
}
```
Contoh berikut menunjukkan entri CloudTrail log yang menunjukkan `DescribeAgreement` tindakan.
```
{
"eventVersion": "1.08",
"userIdentity": {
"type": "Unknown",
"principalId": "ABCDEFGHIJKLMNOP12345",
"arn": "arn:aws:iam::123456789010:user/CloudtrailTestUser",
"accountId": "123456789010",
"accessKeyId": "ABCDEFGHIJKLMNOP123",
},
"eventTime": "2023-10-30T22:45:24Z",
"eventSource": "agreement-marketplace.amazonaws.com",
"eventName": "DescribeAgreement",
"awsRegion": "us-west-2",
"sourceIPAddress": "127.0.0.1",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Safari/537.36",
"requestParameters": {
"agreementId": "agmt-6wy4rhp7l6iyuu2jrcgd1shdi"
},
"responseElements": null,
"requestID": "bEXAMPLE-347f-4c07-9645-cd2EXAMPLE61",
"eventID": "dEXAMPLE-d891-42a5-8da6-1cdEXAMPLE34",
"readOnly": true,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789010",
"eventCategory": "Management",
}
```
Contoh berikut menunjukkan entri CloudTrail log yang menunjukkan `GetAgreementTerms` tindakan.
```
{
"eventVersion": "1.08",
"userIdentity": {
"type": "Unknown",
"principalId": "ABCDEFGHIJKLMNOP12345",
"arn": "arn:aws:iam::123456789010:user/CloudtrailTestUser",
"accountId": "123456789010",
"accessKeyId": "ABCDEFGHIJKLMNOP123",
},
"eventTime": "2023-10-30T22:48:37Z",
"eventSource": "agreement-marketplace.amazonaws.com",
"eventName": "GetAgreementTerms",
"awsRegion": "us-west-2",
"sourceIPAddress": "127.0.0.1",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Safari/537.36",
"requestParameters": {
"agreementId": "agmt-6wy4rhp7l6iyuu2jrcgd1shdi"
},
"responseElements": null,
"requestID": "eEXAMPLE-fc57-4127-bbda-bc1EXAMPLE03",
"eventID": "bEXAMPLE-5345-4634-8b58-925EXAMPLE3e",
"readOnly": true,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789010",
"eventCategory": "Management",
}
```
Contoh berikut menunjukkan entri CloudTrail log yang menunjukkan `SearchAgreements` tindakan.
```
{
"eventVersion": "1.08",
"userIdentity": {
"type": "Unknown",
"principalId": "ABCDEFGHIJKLMNOP12345",
"arn": "arn:aws:iam::123456789010:user/CloudtrailTestUser",
"accountId": "123456789010",
"accessKeyId": "ABCDEFGHIJKLMNOP123",
},
"eventTime": "2023-10-30T18:41:10Z",
"eventSource": "agreement-marketplace.amazonaws.com",
"eventName": "SearchAgreements",
"awsRegion": "us-west-2",
"sourceIPAddress": "127.0.0.1",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Safari/537.36",
"requestParameters": {
"catalog": "AWSMarketplace",
"filters": [
{
"name": "PartyType",
"values": [
"Proposer"
]
},
{
"name": "ResourceType",
"values": [
"SaaSProduct"
]
},
{
"name": "Status",
"values": [
"ACTIVE"
]
},
{
"name": "AgreementType",
"values": [
"PurchaseAgreement"
]
}
],
"maxResults": 5
},
"responseElements": null,
"requestID": "fEXAMPLE-0aa6-4e42-8715-6a1EXAMPLE95",
"eventID": "0EXAMPLE-8ce8-4814-bcf1-636EXAMPLEb5",
"readOnly": true,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789010",
"eventCategory": "Management",
}
```