View a markdown version of this page

파트너 계정 연결 작업 - AWS 파트너 센트럴
연결 초대 생성 및 전송연결 초대 수신 및 응답활성 연결 관리연결 이벤트 모니터링연결 상태 이해모범 사례연결 유형 및 용도

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

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

파트너 계정 연결 작업

파트너는 파트너 연결 API를AWS사용하여 자신의 계정 간 연결 또는 다른 파트너의AWS계정과의 연결을 관리할 수 있습니다. 이 프로세스에는 다음 두 단계가 포함됩니다.

  1. 연결 초대 단계: 연결 요청 시작 및 응답

  2. 활성 연결 단계: 설정된 연결 및 관련 비즈니스 활동 관리

연결 초대 생성 및 전송

1단계: 연결 초대 생성

파트너 연결을 설정하는 첫 번째 단계는 CreateConnectionInvitation 작업을 사용하여 연결 초대를 생성하고 보내는 것입니다. 초대를 생성할 때 다음을 지정해야 합니다.

  • 카탈로그: 연결을 관리할 카탈로그(AWS또는AWS샌드박스)

  • ConnectionType: 설정하려는 관계의 유형입니다. 다음 중 하나를 선택합니다.

    • OPPORTUNITY_COLLABORATION: 기회 협업을 위한 기회 참여 초대장을 보낼 수 있도록 다른 파트너의 계정으로 연결 요청을 보내려는 경우이 유형을 사용합니다.

    • SUBSIDIARY: 소유한 여러AWS Marketplace 판매자 계정을 APN에 연결했거나 파트너로 등록된 "기본" 계정에 연결하려는 경우이 유형을 사용합니다.

  • ReceiverIdentifier: 수신자의 퍼블릭 파트너 프로필 ID(기회 협업 연결 유형의 경우) 또는AWS계정 ID(보조 연결 유형의 경우)

  • 이메일: 통신을 위한 연락처 이메일 주소

  • 이름: 발신자의 이름

  • 메시지: 연결 요청의 목적을 설명하는 설명

초대가 생성되면 보류 중 상태가 되어 수신자의 작업을 기다립니다.

중요

연결 초대를 보내면 초대를 수락하는 경우 수신자에AWS계정 ID를 공개하는 데 동의하는 것입니다. 이 공개는 계정 수준 연결을 설정하는 데 필요합니다.

2단계: 전송된 초대 모니터링

ParticipantType 파라미터가 로 설정된 ListConnectionInvitations 작업을 사용하여 전송한 초대의 상태를 추적할 수 있습니다SENDER. 다음 작업을 수행할 수 있습니다.

  • 모든 발신 초대 보기

  • 상태(PENDING, ACCEPTED, REJECTED, EXPIRED)를 기준으로 필터링

  • 연결 유형별 필터링

  • 다른 파트너에 대한 특정 초대 확인

3단계: 초대 취소(선택 사항)

보류 중인 초대를 수락하기 전에 취소해야 하는 경우 CancelConnectionInvitation 작업을 사용할 수 있습니다. 참고:

  • 보류 중 상태의 초대만 취소할 수 있습니다.

  • 초대가 수락되고 연결이 설정되면 취소할 수 없습니다.

  • 설정된 연결을 종료하려면 CancelConnection 작업을 대신 사용해야 합니다.

연결 초대 수신 및 응답

1단계: 수신 초대 나열

받은 연결 초대를 보려면 ParticipantType 파라미터가 로 설정된 ListConnectionInvitations 작업을 사용합니다RECEIVER. 다음을 기준으로 필터링할 수 있습니다.

  • 연결 유형

  • 상태(PENDING, ACCEPTED, REJECTED)

  • 발신자 식별자

2단계: 초대 세부 정보 검토

GetConnectionInvitation 작업을 사용하여 다음을 포함하여 특정 초대의 전체 세부 정보를 봅니다.

  • 발신자 이름 및 연락처 이메일

  • 목적을 설명하는 초대 메시지

  • 요청 중인 연결 유형

  • 만료 날짜

  • 발신자의 공개 프로필 정보

3단계: 초대 수락 또는 거부

초대 세부 정보를 검토한 후 다음 두 가지 옵션을 사용할 수 있습니다.

옵션 A: 초대 수락

AcceptConnectionInvitation 작업을 사용하여 연결을 설정합니다. 수락하는 경우:

  • 활성 상태에서 새 연결이 생성됩니다.

  • 초대 상태가 수락됨으로 변경됩니다.

  • AWS계정 ID가 발신자에게 공개됩니다.

  • 연결 유형으로 활성화된 비즈니스 활동 수행을 시작할 수 있습니다.

중요

중요 동의: 연결 초대를 수락하면 발신자에게AWS계정 ID를 공개하는 데 동의하는 것입니다. 이 공개는 계정 수준 연결을 설정하는 데 필요합니다.

옵션 B: 초대 거부

연결을 설정하지 않으려면 RejectConnectionInvitation 작업을 사용합니다. 선택적으로 거부 이유를 제공할 수 있습니다. 거부된 경우:

  • 초대 상태가 거부됨으로 변경됩니다.

  • 연결이 설정되지 않음

  • 초대가 보류 중인 초대 목록에 더 이상 표시되지 않습니다.

자동 만료

만료 기간 내에 조치를 취하지 않으면 시스템에서 자동으로 초대를 만료됨 상태로 전환합니다. 만료된 초대는 수락하거나 거부할 수 없습니다.

활성 연결 관리

연결 보기

연결이 설정되면 양 당사자는 다음 작업을 사용하여 연결을 보고 관리할 수 있습니다.

ListConnections: 필터링 옵션을 사용하여 연결 목록을 검색합니다.

  • 연결 유형 및 상태를 기준으로 필터링(예: OPPORTUNITY_COLLABORATION:ACTIVE)

  • 상대방의 식별자를 기준으로 필터링

  • 각 연결에 대한 요약 정보 보기

GetConnection: 다음을 포함하여 특정 연결의 전체 세부 정보를 검색합니다.

  • 이 파트너 관계와 연결된 모든 연결 유형

  • 각 연결 유형의 상태(활성 또는 종료됨)

  • 원래 초대의 연락처 정보

  • AWS양 당사자의 계정 IDs 및 퍼블릭 프로필 IDs

  • 각 연결 유형에 대한 생성 및 종료 타임스탬프

기존 연결에 연결 유형 추가

파트너와 이미 활성 연결이 있고 새 유형의 관계를 설정하려는 경우 다른 연결 유형의 새 연결 초대를 보낼 수 있습니다. 수락 시:

  • 새 연결 유형이 기존 연결에 추가됩니다.

  • 두 연결 유형 모두 독립적으로 관리할 수 있습니다.

  • 관계에 대해 동일한 연결 ID가 유지됩니다.

참고

지정된 카탈로그의 두 계정 간에는 언제든지 특정 유형의 활성 연결이 하나만 있을 수 있습니다.

연결 유형 종료

어느 당사자든 CancelConnection 작업을 사용하여 특정 연결 유형을 종료할 수 있습니다. 종료 시:

  • 종료할 연결 ID 및 연결 유형 지정

  • 종료 이유 제공

  • 연결 유형의 상태가 로 변경됩니다. CANCELED

  • 동일한 연결 내의 다른 연결 유형은 영향을 받지 않습니다.

연결 종료 완료

연결 내의 모든 연결 유형이 종료되면 연결 자체가 종료됨 상태로 전환됩니다. 완전히 종료된 연결:

  • 다시 활성화할 수 없지만 새 연결 요청을 보내 해당 계정으로 비즈니스를 계속할 수 있습니다.

  • 기록 보관을 위해 시스템에 남아 있습니다.

  • GetConnection API를 사용하여 볼 수 있음

  • 관계를 다시 설정하려면 새 초대가 필요합니다.

연결 이벤트 모니터링

파트너는 Amazon EventBridge를 사용하여 연결 관련 이벤트를 모니터링하여 다음 정보를 파악해야 합니다.

  • 새로운 수신 연결 초대

  • 보낸 초대의 상태 변경(ACCEPTED, REJECTED, EXPIRED)

  • 상대방이 시작한 연결 종료

이벤트를 수신하면 적절한 API 가져오기 작업을 사용하여 최신 세부 정보를 가져옵니다.

  • GetConnectionInvitation 초대 업데이트

  • GetConnection 연결 업데이트용

가능한 이벤트

  • 연결 초대 생성됨: 수신되는 연결 초대를 수신 계정에 알립니다.

  • 연결 초대 취소됨: 발신자가 수신 연결 초대를 취소할 때 수신자 계정에 알립니다.

  • 연결 초대 만료: 작업 없이 연결 초대가 만료되면 발신자와 수신자 계정 모두에 알립니다.

  • 연결 초대가 거부됨: 수신자가 연결 초대를 거부하면 발신자 계정에 알립니다.

  • 연결 초대 수락: 연결 초대가 수락되고 연결이 설정되면 발신자 계정에 알립니다.

  • 연결 취소됨: 모든 연결이 완전히 종료되면 연결된 당사자 모두에게 알립니다.

연결 상태 이해

연결 초대 상태

State 설명 로 전환할 수 있음
PENDING 생성 시 초기 상태, 수신기 작업 대기 중 ACCEPTED, REJECTED, EXPIRED, CANCELED
ACCEPTED 수신기 수락됨, 연결이 생성됨 없음(터미널 상태)
REJECTED 수신자 거부됨, 선택적 거부 이유 포함 없음(터미널 상태)
EXPIRED 만료 기간 내에 작업이 없어 시스템 만료 없음(터미널 상태)
CANCELED 발신자가 수락 전에 초대를 철회함 없음(터미널 상태)

연결 유형 상태

State 설명
ACCEPTED 연결 유형이 작동 중이고 연결된 비즈니스 활동이 활성화됨
CANCELED 한 당사자가 종료한 연결 유형

모범 사례

  1. 명확한 커뮤니케이션: 연결 초대장에 목적과 예상되는 협업을 설명하는 상세하고 명확한 메시지를 제공합니다.

  2. 적시 응답: 자동 만료를 방지하기 위해 연결 초대를 즉시 모니터링하고 응답합니다.

  3. 정기 검토: 활성 연결을 정기적으로 검토하여 현재 비즈니스 요구 사항과 관련이 있는지 확인합니다.

  4. 적절한 종료: 비즈니스 관계를 종료할 때 CancelConnection 작업을 명확한 이유와 함께 사용하여 전문적인 커뮤니케이션을 유지합니다.

  5. 이벤트 모니터링: 연결 상태 변경에 대한 알림을 자동으로 수신하도록 EventBridge 규칙을 설정하여 중요한 업데이트에 대한 알림을 받을 수 있습니다.

  6. 연결 유형 관리: 각 유형은 서로 다른 비즈니스 기능을 지원하므로 연결을 설정하기 전에 필요한 연결 유형을 고려합니다.

  7. 보안 인식: 연결을 설정하면 당사자 간의AWS계정 IDs 드러납니다. 신뢰할 수 있는 파트너와만 연결합니다.

연결 유형 및 용도

연결 유형 용도 사용 사례
OPPORTUNITY_COLLABORATION 다른 파트너와의 공동 판매 기회에 대한 협업을 활성화합니다. 다른 파트너가 기회에 액세스하거나 그 반대로 액세스하도록 하려면이 연결 유형을 사용합니다. 이 연결을 통해 연결된 파트너에게 기회 참여 초대를 보낼 수 있습니다.
SUBSIDIARY 여러AWS Marketplace 판매자 계정과 기본 파트너 계정 간의 연결을 설정합니다. 파트너 및 판매자로 등록된 기본 계정에 연결하려는AWS Marketplace 판매자 계정이 여러 개 있는 경우를 사용합니다.