

Referensi Pusat Partner AWS API direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat [Referensi Pusat Partner AWS API](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html).

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Akses untuk API Pengukuran Pendapatan
<a name="prm-access-control"></a>

Kontrol akses dan izin dikelola oleh AWS Identity and Access Management(IAM). Bagian ini memberikan panduan untuk mengonfigurasi izin yang diperlukan untuk berinteraksi dengan API Pengukuran Pendapatan, termasuk izin yang diperlukan untuk mencantumkan entitas.AWS Marketplace

## Prasyarat
<a name="prm-prerequisites"></a>

Sebelum mengonfigurasi izin, pastikan bahwa Anda Akun AWS ditautkan ke Partner Central dan Anda membuat peran dan pengguna IAM yang diperlukan. Untuk informasi selengkapnya, lihat [Pengaturan dan Otentikasi.](https://docs.aws.amazon.com/partner-central/latest/APIReference/setup-authentication.html)

## Penggunaan AWS kebijakan terkelola
<a name="prm-using-aws-managed-policies"></a>

AWS menyediakan kebijakan terkelola yang memberikan izin yang diperlukan untuk berinteraksi dengan API Pengukuran Pendapatan. Dua kebijakan terkelola tersedia tergantung pada kepribadian Anda:
+ **Mitra** — lampirkan `AWSPartnerCentralRevenueAttributionManagement` kebijakan ke identitas IAM Anda.
+ **Pelanggan** — lampirkan `AWSRevenueAttributionManagement` kebijakan ke identitas IAM Anda.

Untuk informasi selengkapnya, lihat [kebijakan AWS terkelola untuk pengguna Pusat AWS Mitra](https://docs.aws.amazon.com/partner-central/latest/getting-started/managed-policies.html).

### AWSPartnerCentralRevenueAttributionManagement kebijakan
<a name="prm-partner-facing-policy"></a>

Kebijakan ini menyediakan akses yang diperlukan untuk aktivitas pengelolaan atribusi pendapatan untuk AWS akun yang terdaftar di AWS Partner Central.

```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "RevenueMeasurementCreation",
            "Effect": "Allow",
            "Action": [
                "partnercentral:CreateRevenueAttribution",
                "partnercentral:CreateMarketplaceRevenueShare",
                "partnercentral:CreateMarketplaceRevenueShareAllocation"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "RevenueMeasurementListing",
            "Effect": "Allow",
            "Action": [
                "partnercentral:ListRevenueAttributions",
                "partnercentral:ListRevenueAttributionAllocations",
                "partnercentral:ListMarketplaceRevenueShares",
                "partnercentral:ListMarketplaceRevenueShareAllocations"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "RevenueAttributionManagement",
            "Effect": "Allow",
            "Action": [
                "partnercentral:GetRevenueAttribution",
                "partnercentral:UpdateRevenueAttribution",
                "partnercentral:GetRevenueAttributionAllocation",
                "partnercentral:StartRevenueAttributionAllocationsTask",
                "partnercentral:GetRevenueAttributionAllocationsTask"
            ],
            "Resource": "arn:aws:partnercentral:*:*:catalog/*/revenue-attribution/*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "MarketplaceRevenueShareManagement",
            "Effect": "Allow",
            "Action": [
                "partnercentral:GetMarketplaceRevenueShare",
                "partnercentral:GetMarketplaceRevenueShareAllocation",
                "partnercentral:UpdateMarketplaceRevenueShareAllocation"
            ],
            "Resource": "arn:aws:partnercentral:*:*:catalog/*/marketplace-revenue-share/*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "TaggingAccess",
            "Effect": "Allow",
            "Action": [
                "partnercentral:TagResource",
                "partnercentral:UntagResource",
                "partnercentral:ListTagsForResource"
            ],
            "Resource": [
                "arn:aws:partnercentral:*:*:catalog/*/revenue-attribution/*",
                "arn:aws:partnercentral:*:*:catalog/*/marketplace-revenue-share/*"
            ],
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "OpportunityAccess",
            "Effect": "Allow",
            "Action": [
                "partnercentral:ListOpportunities",
                "partnercentral:GetOpportunity"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "PartnerResourceAccess",
            "Effect": "Allow",
            "Action": [
                "partnercentral:ListPartners",
                "partnercentral:GetPartner"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "ListingAWSMarketplaceEntities",
            "Effect": "Allow",
            "Action": [
                "aws-marketplace:ListEntities"
            ],
            "Resource": "*"
        },
        {
            "Sid": "AWSMarketplaceEntityAccess",
            "Effect": "Allow",
            "Action": [
                "aws-marketplace:DescribeEntity"
            ],
            "Resource": [
                "arn:aws:aws-marketplace:*:*:AWSMarketplace*/Offer/*"
            ]
        },
        {
            "Sid": "AmazonQPartnerAssistantAccess",
            "Effect": "Allow",
            "Action": [
                "q:StartConversation",
                "q:SendMessage",
                "q:GetConversation",
                "q:ListConversations",
                "q:PassRequest"
            ],
            "Resource": "*"
        }
    ]
}
```

### AWSRevenueAttributionManagement kebijakan
<a name="prm-customer-facing-policy"></a>

Kebijakan ini menyediakan akses yang diperlukan untuk kegiatan pengelolaan atribusi pendapatan untuk AWS akun yang tidak terdaftar di AWS Partner Central.

```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "RevenueAttributionCreation",
            "Effect": "Allow",
            "Action": [
                "partnercentral:CreateRevenueAttribution"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "RevenueAttributionListing",
            "Effect": "Allow",
            "Action": [
                "partnercentral:ListRevenueAttributions"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "RevenueAttributionManagement",
            "Effect": "Allow",
            "Action": [
                "partnercentral:GetRevenueAttribution",
                "partnercentral:UpdateRevenueAttribution"
            ],
            "Resource": "arn:aws:partnercentral:*:*:catalog/*/revenue-attribution/*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "TaggingAccess",
            "Effect": "Allow",
            "Action": [
                "partnercentral:TagResource",
                "partnercentral:UntagResource",
                "partnercentral:ListTagsForResource"
            ],
            "Resource": [
                "arn:aws:partnercentral:*:*:catalog/*/revenue-attribution/*"
            ],
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "AWS",
                        "Sandbox"
                    ]
                }
            }
        }
    ]
}
```

## Menetapkan kebijakan untuk peran dan pengguna IAM
<a name="prm-assigning-policies"></a>

Ikuti langkah-langkah ini untuk menetapkan kebijakan untuk peran dan pengguna IAM:

1. Masuk ke Konsol Manajemen AWS.

1. Arahkan ke layanan IAM.

1. Pilih peran atau pengguna, dan pilih peran IAM atau pengguna yang ingin Anda lampirkan kebijakan.

1. Lampirkan `AWSPartnerCentralRevenueAttributionManagement` kebijakan (untuk mitra) atau `AWSRevenueAttributionManagement` kebijakan (untuk pelanggan) ke peran atau pengguna IAM yang dipilih.

Untuk informasi selengkapnya, lihat [Menambahkan dan menghapus izin identitas IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html).

## Mengelola izin menggunakan tombol kondisi
<a name="prm-managing-permissions-with-condition-keys"></a>

Kunci kondisi dalam kebijakan IAM memberikan izin tingkat sumber daya kapan harus menerapkan kebijakan pernyataan. Anda dapat menggunakan tombol kondisi untuk menentukan kondisi yang menentukan kapan izin tertentu diizinkan atau ditolak.

Untuk informasi selengkapnya, lihat [elemen kebijakan IAM JSON: Operator kondisi](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html).


**Ikhtisar tombol kondisi**  

| Kunci syarat | Deskripsi | Tindakan yang berlaku | Nilai valid | 
| --- | --- | --- | --- | 
| Partnercentral:Katalog | Memfilter akses berdasarkan jenis entitas katalog terkait | Semua tindakan | AWS, Kotak pasir | 

## Ringkasan izin yang diperlukan
<a name="prm-summary-of-required-permissions"></a>


**Ringkasan izin yang diperlukan**  

| Tindakan | Deskripsi | 
| --- | --- | 
| partnercentral: CreateRevenueAttribution | Memungkinkan membuat catatan atribusi pendapatan baru | 
| partnercentral: UpdateRevenueAttribution | Memungkinkan memperbarui catatan atribusi pendapatan yang ada | 
| partnercentral: GetRevenueAttribution | Memungkinkan mengambil rincian atribusi pendapatan tertentu | 
| partnercentral: ListRevenueAttributions | Memungkinkan mencantumkan atribusi pendapatan dengan filter opsional | 
| partnercentral: GetRevenueAttributionAllocation | Memungkinkan mengambil alokasi tunggal dengan ID-nya | 
| partnercentral: ListRevenueAttributionAllocations | Memungkinkan daftar alokasi berkomitmen dengan dukungan penyaringan | 
| partnercentral: StartRevenueAttributionAllocationsTask | Memungkinkan mengirimkan batch hingga 250 perubahan alokasi untuk pemrosesan asinkron | 
| partnercentral: GetRevenueAttributionAllocationsTask | Memungkinkan pengambilan status tugas alokasi yang dikirimkan sebelumnya | 
| partnercentral: CreateMarketplaceRevenueShare | Memungkinkan menciptakan sumber daya bagi hasil pasar baru | 
| partnercentral: GetMarketplaceRevenueShare | Memungkinkan mengambil rincian dari pangsa pendapatan pasar tertentu | 
| partnercentral: ListMarketplaceRevenueShares | Memungkinkan daftar pembagian pendapatan pasar dengan filter opsional | 
| partnercentral: CreateMarketplaceRevenueShareAllocation | Memungkinkan pembuatan alokasi bagi hasil pasar baru | 
| partnercentral: GetMarketplaceRevenueShareAllocation | Memungkinkan mengambil rincian alokasi bagi hasil pasar tertentu | 
| partnercentral: UpdateMarketplaceRevenueShareAllocation | Memungkinkan memperbarui alokasi bagi hasil pasar yang ada | 
| partnercentral: ListMarketplaceRevenueShareAllocations | Memungkinkan daftar alokasi di bawah pangsa pendapatan pasar | 
| partnercentral: TagResource | Mengizinkan menambahkan atau menimpa tag untuk sumber daya | 
| partnercentral: UntagResource | Memungkinkan menghapus tag dari sumber daya | 
| partnercentral: ListTagsForResource | Mengizinkan tag daftar yang terkait dengan sumber daya | 