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.

# Kontrol akses untuk AWS Marketplace API Penemuan
<a name="discovery-api-access-control"></a>

Discovery API menggunakan AWS Identity and Access Management (IAM) untuk otentikasi dan otorisasi. Setiap AWS pelanggan dapat memanggil Discovery API dengan mengonfigurasi izin IAM yang sesuai.

Pengguna harus memiliki izin berikut untuk memanggil operasi Discovery API:
+ `GetListing`— Memberikan izin untuk mengambil informasi tentang daftar.
+ `GetProduct`Memberikan izin untuk mengambil informasi tentang suatu produk.
+ `GetOffer`— Memberikan izin untuk mengambil informasi tentang penawaran.
+ `GetOfferTerms`— Memberikan izin untuk mengambil persyaratan untuk penawaran.
+ `GetOfferSet`— Memberikan izin untuk mengambil informasi tentang set penawaran.
+ `ListPurchaseOptions`— Memberikan izin untuk membuat daftar opsi pembelian yang tersedia bagi pembeli.
+ `ListFulfillmentOptions`— Memberikan izin untuk membuat daftar opsi pemenuhan untuk suatu produk.
+ `SearchListings`— Memberikan izin untuk mencari daftar produk.
+ `SearchFacets`— Memberikan izin untuk mengambil nilai facet untuk memfilter daftar.

## Izin IAM
<a name="discovery-iam-permissions"></a>

Untuk memanggil operasi Discovery API, prinsipal IAM (pengguna atau peran) harus memiliki `aws-marketplace` izin yang sesuai. Discovery API mendukung izin tingkat sumber daya, sehingga Anda dapat mencakup akses ke jenis sumber daya tertentu dalam kebijakan IAM Anda.

Kebijakan IAM berikut memberikan akses ke semua operasi Discovery API dengan pelingkupan tingkat sumber daya:

```
{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "aws-marketplace:GetListing",
                "aws-marketplace:GetProduct",
                "aws-marketplace:GetOffer",
                "aws-marketplace:GetOfferTerms",
                "aws-marketplace:GetOfferSet",
                "aws-marketplace:ListPurchaseOptions",
                "aws-marketplace:ListFulfillmentOptions",
                "aws-marketplace:SearchFacets",
                "aws-marketplace:SearchListings"
            ],
            "Resource": [
                "arn:aws:aws-marketplace:::catalog/<catalog-name>/product/*",
                "arn:aws:aws-marketplace:::catalog/<catalog-name>/listing/*",
                "arn:aws:aws-marketplace:::catalog/<catalog-name>/offer/*",
                "arn:aws:aws-marketplace:::catalog/<catalog-name>/offerSet/*",
                "arn:aws:aws-marketplace:::catalog/<catalog-name>/purchaseOption/*"
            ]
        }
    ]
}
```

Ganti `<catalog-name>` dengan pengidentifikasi katalog yang sesuai (misalnya,`AWSMarketplace`).

### Format ARN sumber daya
<a name="discovery-resource-arn-formats"></a>

Tabel berikut menunjukkan jenis sumber daya dan format ARN yang digunakan oleh operasi Discovery API:


| Tipe sumber daya | Format ARN | Digunakan oleh | 
| --- | --- | --- | 
| Produk | arn:aws:aws-marketplace:::catalog/{{catalog-name}}/product/{{product-id}} | GetProduct, ListFulfillmentOptions | 
| Daftar | arn:aws:aws-marketplace:::catalog/{{catalog-name}}/listing/{{listing-id}} | GetListing, SearchListings, SearchFacets | 
| Penawaran | arn:aws:aws-marketplace:::catalog/{{catalog-name}}/offer/{{offer-id}} | GetOffer, GetOfferTerms | 
| Set Penawaran | arn:aws:aws-marketplace:::catalog/{{catalog-name}}/offerSet/{{offerSet-id}} | GetOfferSet | 
| Opsi Pembelian | arn:aws:aws-marketplace:::catalog/{{catalog-name}}/purchaseOption/{{purchaseOption-id}} | ListPurchaseOptions | 

### Operasi pelingkupan ke sumber daya tertentu
<a name="discovery-scoping-get-operations"></a>

Untuk Get operations (GetListing GetProduct, GetOffer, GetOfferTerms,, GetOfferSet) dan ListFulfillmentOptions operasinya, Anda dapat mengakses akses ke ID sumber daya tertentu alih-alih menggunakan wildcard. Misalnya, untuk membatasi akses ke satu daftar:

```
{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "aws-marketplace:GetListing",
            "Resource": "arn:aws:aws-marketplace:::catalog/AWSMarketplace/listing/{{listing-id}}"
        }
    ]
}
```

Pola ini berfungsi untuk setiap operasi Get dan ListFulfillmentOptions. Ganti jenis sumber daya dan ID yang sesuai:
+ `arn:aws:aws-marketplace:::catalog/{{catalog-name}}/product/{{product-id}}`
+ `arn:aws:aws-marketplace:::catalog/{{catalog-name}}/listing/{{listing-id}}`
+ `arn:aws:aws-marketplace:::catalog/{{catalog-name}}/offer/{{offer-id}}`
+ `arn:aws:aws-marketplace:::catalog/{{catalog-name}}/offerSet/{{offerSet-id}}`

 ListPurchaseOptions Operasi SearchListings, SearchFacets, dan tidak mendukung pelingkupan ke satu sumber daya karena beroperasi di beberapa item. Gunakan pola ARN wildcard berikut untuk operasi ini:
+ Untuk SearchListings dan SearchFacets: `arn:aws:aws-marketplace:::catalog/{{catalog-name}}/listing/*`
+ Untuk ListPurchaseOptions: `arn:aws:aws-marketplace:::catalog/{{catalog-name}}/purchaseOption/*`

## Service-linked peran
<a name="discovery-service-linked-roles"></a>

Discovery API tidak menggunakan peran terkait layanan. Semua akses dikendalikan melalui kebijakan IAM standar.

## Cross-account akses
<a name="discovery-cross-account-access"></a>

Anda dapat memberikan akses lintas akun ke Discovery API menggunakan peran IAM. Buat peran di akun target dengan izin Discovery API yang sesuai, lalu ambil peran tersebut dari akun sumber.