AWS Partner Central API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 [AWS Partner Central 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)에서 관리합니다. 이 섹션에서는AWS Marketplace엔터티를 나열하는 데 필요한 권한을 포함하여 수익 측정 API와 상호 작용하는 데 필요한 권한을 구성하는 지침을 제공합니다.

## 사전 조건
<a name="prm-prerequisites"></a>

권한을 구성하기 전에AWS 계정가 Partner Central에 연결되어 있고 필요한 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 자격 증명에 연결합니다.

자세한 내용은 [AWSAWS Partner Central 사용자를 위한 관리형 정책을](https://docs.aws.amazon.com/partner-central/latest/getting-started/managed-policies.html) 참조하세요.

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

이 정책은AWS Partner 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>

이 정책은AWS Partner 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. 선택한 IAM 역할 또는 사용자에 `AWSPartnerCentralRevenueAttributionManagement` 정책(파트너용) 또는 `AWSRevenueAttributionManagement` 정책(고객용)을 연결합니다.

자세한 내용은 [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)를 참조하세요.


**조건 키 개요**  

| 조건 키 | 설명 | 적용 가능한 작업 | 유효값 | 
| --- | --- | --- | --- | 
| partnercentral:Catalog | 연결된 카탈로그 개체의 유형을 기준으로 액세스를 필터링합니다. | 모든 작업 | AWS, 샌드박스 | 

## 필수 권한 요약
<a name="prm-summary-of-required-permissions"></a>


**필수 권한 요약**  

| 작업 | 설명 | 
| --- | --- | 
| partnercentral:CreateRevenueAttribution | 새 수익 어트리뷰션 레코드 생성 허용 | 
| partnercentral:UpdateRevenueAttribution | 기존 수익 어트리뷰션 레코드 업데이트 허용 | 
| partnercentral:GetRevenueAttribution | 특정 수익 어트리뷰션의 세부 정보를 검색할 수 있습니다. | 
| partnercentral:ListRevenueAttributions | 선택적 필터를 사용하여 수익 어트리뷰션 나열 허용 | 
| partnercentral:GetRevenueAttributionAllocation | ID로 단일 할당 검색 허용 | 
| partnercentral:ListRevenueAttributionAllocations | 필터링 지원을 통해 커밋된 할당 나열 허용 | 
| partnercentral:StartRevenueAttributionAllocationsTask | 비동기 처리를 위해 최대 250개의 할당 변경 사항 배치 제출 허용 | 
| partnercentral:GetRevenueAttributionAllocationsTask | 이전에 제출된 할당 작업의 상태를 검색할 수 있습니다. | 
| partnercentral:CreateMarketplaceRevenueShare | 새 마켓플레이스 수익 공유 리소스 생성 허용 | 
| partnercentral:GetMarketplaceRevenueShare | 특정 마켓플레이스 수익 공유의 세부 정보 검색 허용 | 
| partnercentral:ListMarketplaceRevenueShares | 선택적 필터를 사용하여 마켓플레이스 수익 공유 나열 허용 | 
| partnercentral:CreateMarketplaceRevenueShareAllocation | 새 마켓플레이스 수익 공유 할당 생성 허용 | 
| partnercentral:GetMarketplaceRevenueShareAllocation | 특정 마켓플레이스 수익 공유 할당의 세부 정보 검색 허용 | 
| partnercentral:UpdateMarketplaceRevenueShareAllocation | 기존 마켓플레이스 수익 공유 할당 업데이트 허용 | 
| partnercentral:ListMarketplaceRevenueShareAllocations | 마켓플레이스 수익 공유에 따른 할당 나열 허용 | 
| partnercentral:TagResource | 리소스에 대한 태그 추가 또는 덮어쓰기 허용 | 
| partnercentral:UntagResource | 리소스에서 태그 제거 허용 | 
| partnercentral:ListTagsForResource | 리소스와 연결된 태그 나열 허용 |