View a markdown version of this page

访问收入衡量 API - AWS 合作伙伴中心
先决条件使用AWS托管策略向 IAM 角色和用户分配策略使用条件键管理权限所需权限摘要

AWS 合作伙伴中心 API 参考已重新构建。有关支持的 API 操作的更多信息，请参阅 AWS 合作伙伴中心 API 参考。

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

访问收入衡量 API

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

先决条件

在配置权限之前，请确保您的AWS 账户已链接到合作伙伴中心，并且您已创建必要的 IAM 角色和用户。有关更多信息，请参阅设置和身份验证。

使用AWS托管策略

AWS提供托管策略，授予与收入衡量 API 交互所需的权限。根据您的角色，有两种托管策略可供选择：

  • 合作伙伴 — 将AWSPartnerCentralRevenueAttributionManagement策略附加到您的 IAM 身份。

  • 客户 — 将AWSRevenueAttributionManagement策略附加到您的 IAM 身份。

有关更多信息，请参阅AWS合作伙伴中心用户的AWS托管政策。

AWSPartnerCentralRevenueAttributionManagement 政策

该政策为在 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 政策

本政策为未在 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 角色和用户分配策略

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

  1. 登录到AWS Management Console。

  2. 导航到 IAM 服务。

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

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

有关更多信息，请参阅添加和删除 IAM 身份权限。

使用条件键管理权限

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

有关更多信息，请参阅 IAM JSON 策略元素：条件运算符。

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

所需权限摘要

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