AWS 合作伙伴中心 API 参考已重新构建。有关支持的 API 操作的更多信息，请参阅 [AWS 合作伙伴中心 API 参考](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 访问收入衡量 API
<a name="prm-access-control"></a>

访问控制和权限由AWS Identity and Access Management(IAM) 管理。本节提供有关配置与收入衡量 API 交互的必要权限的指导，包括列出AWS Marketplace实体所需的权限。

## 先决条件
<a name="prm-prerequisites"></a>

在配置权限之前，请确保您的AWS 账户已链接到合作伙伴中心，并且您已创建必要的 IAM 角色和用户。有关更多信息，请参阅[设置和身份验证](https://docs.aws.amazon.com/partner-central/latest/APIReference/setup-authentication.html)。

## 使用AWS托管策略
<a name="prm-using-aws-managed-policies"></a>

AWS提供托管策略，授予与收入衡量 API 交互所需的权限。根据您的角色，有两种托管策略可供选择：
+ **合作伙伴** — 将`AWSPartnerCentralRevenueAttributionManagement`策略附加到您的 IAM 身份。
+ **客户** — 将`AWSRevenueAttributionManagement`策略附加到您的 IAM 身份。

有关更多信息，请参阅[AWS合作伙伴中心用户的AWS托管政策](https://docs.aws.amazon.com/partner-central/latest/getting-started/managed-policies.html)。

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

该政策为在 P AWS artner Central 注册的AWS账户提供了必要的收入归因管理活动访问权限。

```
{
    "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 政策
<a name="prm-customer-facing-policy"></a>

本政策为未在 P AWS artner Central 注册的AWS账户提供了必要的收入归因管理活动访问权限。

```
{
    "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"
                    ]
                }
            }
        }
    ]
}
```

## 向 IAM 角色和用户分配策略
<a name="prm-assigning-policies"></a>

按照以下步骤将策略分配给 IAM 角色和用户：

1. 登录到AWS Management Console。

1. 导航到 IAM 服务。

1. 选择角色或用户，然后选择要向其关联策略的 IAM 角色或用户。

1. 将`AWSPartnerCentralRevenueAttributionManagement`策略（适用于合作伙伴）或`AWSRevenueAttributionManagement`策略（适用于客户）附加到选定的 IAM 角色或用户。

有关更多信息，请参阅[添加和删除 IAM 身份权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)。

## 使用条件键管理权限
<a name="prm-managing-permissions-with-condition-keys"></a>

IAM 策略中的条件密钥为何时强制执行声明策略提供资源级权限。您可以使用条件键来指定何时允许或拒绝某些权限的条件。

有关更多信息，请参阅 [IAM JSON 策略元素：条件运算符](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html)。


**条件键概述**  

| 条件键 | 说明 | 适用的行动 | 有效值 | 
| --- | --- | --- | --- | 
| 合作伙伴中心：目录 | 按关联目录实体的类型筛选访问权限 | 所有操作 | AWS，沙盒 | 

## 所需权限摘要
<a name="prm-summary-of-required-permissions"></a>


**所需权限摘要**  

| 处理建议 | 说明 | 
| --- | --- | 
| 合作伙伴中心：CreateRevenueAttribution | 允许创建新的收入归因记录 | 
| 合作伙伴中心：UpdateRevenueAttribution | 允许更新现有的收入归因记录 | 
| 合作伙伴中心：GetRevenueAttribution | 允许检索特定收入归因的详细信息 | 
| 合作伙伴中心：ListRevenueAttributions | 允许使用可选筛选条件列出收入归因 | 
| 合作伙伴中心：GetRevenueAttributionAllocation | 允许按其 ID 检索单个分配 | 
| 合作伙伴中心：ListRevenueAttributionAllocations | 允许列出支持筛选的已提交分配 | 
| 合作伙伴中心：StartRevenueAttributionAllocationsTask | 允许提交一批最多 250 个分配变更以进行异步处理 | 
| 合作伙伴中心：GetRevenueAttributionAllocationsTask | 允许检索先前提交的分配任务的状态 | 
| 合作伙伴中心：CreateMarketplaceRevenueShare | 允许创建新的市场收入分成资源 | 
| 合作伙伴中心：GetMarketplaceRevenueShare | 允许检索特定市场收入份额的详细信息 | 
| 合作伙伴中心：ListMarketplaceRevenueShares | 允许使用可选筛选器列出市场收入份额 | 
| 合作伙伴中心：CreateMarketplaceRevenueShareAllocation | 允许创建新的市场收入分成分配 | 
| 合作伙伴中心：GetMarketplaceRevenueShareAllocation | 允许检索特定市场收入分成分配的详细信息 | 
| 合作伙伴中心：UpdateMarketplaceRevenueShareAllocation | 允许更新现有的市场收入分成分配 | 
| 合作伙伴中心：ListMarketplaceRevenueShareAllocations | 允许在商城收入份额下进行上架分配 | 
| 合作伙伴中心：TagResource | 允许为资源添加或覆盖标签 | 
| 合作伙伴中心：UntagResource | 允许从资源中移除标签 | 
| 合作伙伴中心：ListTagsForResource | 允许列出与资源关联的标签 |