AWS Partner Central API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 AWS Partner Central API 참조를 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

설정 및 인증

AWS Partner Central API 설정 및 인증에는 세 단계가 포함됩니다. 다음은 프로세스에 대한 개요입니다.

를 Partner Central AWS 계정에 연결

를 Partner Central AWS 계정에 연결하는 것은 API를 사용하기 위한 사전 조건입니다. 자세한 내용은 AWS Partner Central 계정과AWS Marketplace판매자 계정 연결을 참조하세요. Alliance-lead 또는 Cloud-administrator 권한이 있는 계정으로 Partner Central에 로그인하고 Account Linking 섹션으로 이동하여 프롬프트를 따라야 합니다.

IAM 설정

AWS Partner Central API를 사용하려면 호출을 시작하려면AWS Identity and Access Management(IAM) 역할 또는 IAM 사용자가 필요합니다. 자세한 내용은 언제 IAM을 사용하나요?를 참조하세요. 이에 대한AWS 계정가이드의 IAM 역할 생성 및 IAM 사용자 생성 단계를 따릅니다. 파트너 중앙 연결AWS Marketplace판매자 계정에서이 IAM 역할/사용자를 생성해야 합니다. IAM 역할/사용자 생성에는 비용이 발생하지 않습니다.

AWS Marketplace제안 관리

AWS Marketplace제안을 관리하고 기회에 연결하려면 파트너는 IAM 역할에 카탈로그 APIs에 액세스할 수 있는 권한을 부여해야 합니다. 역할/사용자에게 aws-marketplace:ListEntities 및와 같은 권한이 있는지 확인합니다aws-marketplace:SearchAgreements.

API 호출 인증

AWS Partner Central API는 인증에 서명 버전 4(SigV4)를 사용합니다. 구현 방법은 다음과 같습니다.

AWS SDK 사용

AWS SDKs 요청 서명을 자동으로 처리합니다. 자격AWS증명을 제공하면 SDK가 나머지 작업을 수행합니다.

AWS SDK를 사용하지 않는 인증

선택한 프로그래밍 언어에AWS SDK를 사용할 수 없는 경우 인증에는 표준 요청을 수동으로 생성하고, 요청에 서명하고, 세션 토큰을 처리하는 작업이 포함됩니다.는 SigV4 서명 사용에 대한 포괄적인 지침을AWS제공합니다. 그러나 수동 요청 서명은 복잡성을 높이고 보안 토큰을 신중하게 관리해야 하므로AWS SDK를 사용하는 것이 좋습니다.

awsJson1_0 프로토콜에 대한 모든 요청은 다음 헤더를 사용하는 HTTP "POST" 메서드를 사용하여 루트 URL(/)로 전송해야 합니다.

필수 헤더

awsJson1_0 프로토콜에 대한 모든 API 요청은 다음 헤더를 사용하는 HTTP "POST" 메서드를 사용하여 루트 URL(/)로 전송해야 합니다.

사용자 지정 사용자 에이전트를 사용하여 호출에 서명

AWS Partner Central에 API를 요청할 때 클라이언트 애플리케이션의 소스를AWS식별하고, 사용량을 모니터링하고, 성능을 감사하는 데 도움이 되는 X-Amzn-User-Agent 헤더를 포함하는 것이 좋습니다.는이 헤더를AWS사용하여 호출하는 클라이언트 애플리케이션의 유형을 구분하고, 다양한 클라이언트 구현의 성공률에 대한 인사이트를 수집합니다.

사용자 지정 사용자 에이전트 헤더

헤더 이름: X-Amzn-User-Agent

용도: 상호 작용의 소스를 분류하여 API 요청을 수행하는 클라이언트 유형을 구분합니다.

형식: {Integrator}|{Product}

예제 값: AWS|AWS Partner CRM Connector

모든 요청에이 헤더를 포함하면AWS가 요청 패턴을 분석하고, 통합을 추적하고, 다양한 클라이언트 시스템의 API 경험을 개선할 수 있습니다.

SDKs에서 사용자 지정 헤더 사용

SDK 호출에 X-Amzn-User-Agent 헤더를 포함하려면 API 호출을 수행하기 전에 클라이언트 요청 동작을 수정할 수 있습니다. 다음은AWS SDK for Python(Boto3)을 사용하는 판매 API 예제입니다.

import boto3

# Define service and endpoint details
service_name = "partnercentral-selling"
endpoint_url = "https://partnercentral-selling.us-east-1.api.aws"

# Create a boto3 client for Partner Central
partner_central_client = boto3.client(
service_name=service_name,
='us-east-1',
endpoint_url=endpoint_url
)

# Function to add the custom User-Agent header

def add_version_header(params, **kwargs):
params["headers"]['X-Amzn-User-Agent'] = 'AWS|AWS Partner CRM Connector'

# Register the event to modify the request before the call is made
partner_central_client.meta.events.register(
f'before-call.{service_name}.*', add_version_header
)

# Now, whenever an API call is made using this client, the custom User-Agent header will be included

이 예제에서는 Boto3 SDK에 이벤트를 등록하여 모든 API 요청에 X-Amzn-User-Agent 헤더를 자동으로 추가하는 방법을 보여줍니다. 각 요청 가로채기 메커니즘을 수정하여 다른AWS SDKs에 동일한 접근 방식을 적용할 수 있습니다.