AWS Partner Central API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 [AWS Partner Central API 참조](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)를 참조하세요.

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

# AWS파트너 중앙 계정 API에 대한 알림
<a name="account-api-events"></a>

파트너 계정 연결 알림을 통해 파트너는 비즈니스 관계 및 운영 워크플로에 직접적인 영향을 미치는 연결 수명 주기 이벤트에 대한 정보를 얻을 수 있습니다. 이러한 이벤트는 파트너가 다음을 수행하는 데 매우 중요합니다.
+ 새로운 공동 작업에 즉시 대응
+ 연결 포트폴리오 상태에 대한 인식 유지
+ 연결이 설정되거나 종료될 때 적절한 조치를 취합니다.
+ 관계가 변경되는 시점을 파악하여 비즈니스 연속성 보장

**Topics**
+ [이벤트를 모니터링하기 위한 사전 조건 완료](#events-prerequites)
+ [이벤트를 모니터링하도록 Amazon EventBridge 구성](#eventbridge-setup)
+ [계정 연결 API 이벤트에 대해 자세히 알아보기](#learn-about-events)

## 이벤트를 모니터링하기 위한 사전 조건 완료
<a name="events-prerequites"></a>

계정 연결 API에서 게시한 이벤트에 액세스하고 관리하려면 사용자에게 적절한 IAM 권한이 필요합니다. EventBridge에 사용할 수 있는 작업, 리소스 및 조건 키에 대한 자세한 내용은 [Amazon EventBridge 사용 설명서의 Amazon EventBridge에서 IAM 정책 조건 사용을](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-use-conditions.html#events-pattern-detail-type) 참조하세요. * EventBridge * 조건 키 중 하나는 특정 이벤트 유형에 대한 권한 범위를 지정하는 데 사용할 수 `events:detail-type`있는 입니다.

다음 예제 정책은 제안된 이벤트에 대한 권한을 사용자 지정하고 범위를 지정하는 방법을 보여줍니다. `AllowPutRuleForPartnercentralAccountEvents` 문은 규칙 생성을 허용하지만 `aws.partnercentral-account` 소스의 이벤트에 대해서만 가능합니다.

자세한 IAM 정책 예제는 EventBridge 권한에 대한 AWS 설명서를 참조하세요.

```
{
  "Version": "2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "AllowPutRuleForPartnerCentralAccountEvents",
      "Effect": "Allow",
      "Action": "events:PutRule",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "events:source": "aws.partnercentral-account.connection"
        }
      }
    }
  ]
}
```

## 이벤트를 모니터링하도록 Amazon EventBridge 구성
<a name="eventbridge-setup"></a>

계정 연결 API 이벤트를 모니터링하려면 캡처하려는 이벤트와 일치하는 EventBridge 규칙을 생성합니다.AWS Management Console또는AWS SDKs를 사용하여 규칙을 생성하고 관리할 수 있습니다. 다음 섹션에서는 두 방법을 모두 사용하여 규칙을 생성하는 방법을 설명합니다. 사용하는 방법에 관계없이 미국 동부(버지니아 북부) `us-east-1` 리전에서 규칙을 생성해야 합니다.

### AWS Management Console설정
<a name="eventbridge-console-setup"></a>

를 사용하여 EventBridge 규칙을 설정하려면 [Amazon EventBridge 사용 설명서의 Amazon EventBridge에서 이벤트에 반응하는 규칙 생성](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)의 단계를AWS Management Console따릅니다. * EventBridge * 규칙을 생성할 때 이벤트 버스를 **기본**값으로 설정하고 미국 동부(버지니아 북부) `us-east-1` 리전에서 규칙을 생성해야 합니다.

다음은 이벤트 규칙의 예입니다.

```
{
    "source": ["aws.partnercentral-account"],
    "detail": {
        "catalog": ["AWS"]
    }
}
```

### AWS SDK 설정
<a name="eventbridge-sdk-setup"></a>

AWS SDKs를 사용하여 EventBridge 규칙을 프로그래밍 방식으로 생성하고 관리할 수 있습니다. 자세한 내용은 *Amazon EventBridge API 참조*의 [PutRule](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutRule.html)을 참조하세요.

다음 예제에서는AWS SDK for Python(Boto3)을 사용합니다.

```
import boto3

client = boto3.client('events', region_name='us-east-1')

response = client.put_rule(
    Name='MyConnectionInvitationReceivedRule',
    EventPattern=
    '{
        "source": ["aws.partnercentral-account"], 
        "detail-type": ["Partner Connection Invitation Received"], 
        "detail": {"catalog": ["AWS"]}
    }',
    State='ENABLED'
)
print('Rule ARN:', response['RuleArn'])
```

## 계정 연결 API 이벤트에 대해 자세히 알아보기
<a name="learn-about-events"></a>

다음 섹션에서는 계정 연결 API 이벤트 유형, 이를 트리거하는 시나리오 및 이벤트 예제를 설명합니다.

### 이벤트 유형
<a name="types-of-events"></a>

다음은 이벤트 유형과 트리거입니다.
+ [파트너 연결 초대 수신](#connection-invitation-received): 다른 파트너가 연결을 설정하려고 함을 수신자에게 알립니다.
+ [파트너 연결 초대 수락:](#connection-invitation-accepted) 발신자에게 초대가 수락되었으며 이제 연결이 활성 상태임을 알립니다.
+ [파트너 연결 초대가 거부됨](#connection-invitation-rejected): 발신자에게 초대가 거부되었음을 알립니다.
+ [파트너 연결 취소됨](#connection-cancelled): 활성 연결이 종료되면 다른 연결된 참가자에게 알립니다.
+ [파트너 연결 초대 취소됨](#connection-invitation-cancelled): 발신자가 조치를 취하기 전에 초대를 취소했음을 수신자에게 알립니다.
+ [파트너 연결 초대 만료:](#connection-invitation-expired) 발신자와 수신자 모두에게 초대가 만료되었음을 알립니다.

### 이벤트 예제
<a name="example-rules"></a>

다음 섹션에서는 이전 섹션의 앞부분에 나열된 이벤트의 예를 제공합니다.

**Topics**
+ [파트너 연결 초대 수신됨](#connection-invitation-received)
+ [파트너 연결 초대 수락됨](#connection-invitation-accepted)
+ [파트너 연결 초대가 거부됨](#connection-invitation-rejected)
+ [파트너 연결 취소됨](#connection-cancelled)
+ [파트너 연결 초대 취소됨](#connection-invitation-cancelled)
+ [파트너 연결 초대 만료됨](#connection-invitation-expired)

#### 파트너 연결 초대 수신됨
<a name="connection-invitation-received"></a>

##### 트리거 컨텍스트
<a name="connection-invitation-received-context"></a>

이 이벤트는 연결 초대가 성공적으로 생성되어 CreateConnectionInvitation API를 통해 PAC의 데이터 스토어에 지속될 때 생성됩니다. 이벤트는 초대 생성이 성공적으로 완료된 후 즉시 전송되며 API 호출이 이루어진 시점뿐만 아니라 PAC의 데이터 스토어에도 유지됩니다.

새 연결 초대가 생성되면 이벤트가 자동으로 전송됩니다. 동일한 초대에 대한 중복 이벤트 없이 생성된 초대당 하나의 이벤트입니다.

##### 수신자
<a name="connection-invitation-received-recipients"></a>

연결 초대에 있는 수신자의AWS계정입니다.

##### 예상 처리
<a name="connection-invitation-received-handling"></a>

일반적인 고객 작업:
+ 즉시 알림: 새로운 파트너십 기회에 대해 비즈니스 팀에 알림 트리거
+ 워크플로 자동화: 보류 중인 초대를 사용하여 파트너 관리 시스템 자동 업데이트
+ 의사 결정 지원: 연결 유형에 따라 적절한 의사 결정자에게 초대 전달
+ 감사 로깅: 규정 준수 및 파트너십 추적을 위한 초대장 수신 기록
+ 응답 자동화: 신뢰할 수 있는 파트너의 경우 잠재적으로 특정 초대 유형을 자동 수락합니다.

일반적인 통합 패턴:
+ Lambda 함수 → 파트너 포털 대시보드 업데이트
+ SQS 대기열 → 검토를 위한 배치 프로세스 초대
+ SNS 주제 → 비즈니스 팀에 이메일/슬랙 알림
+ API 대상 → Webhook에서 외부 CRM/파트너 관리 시스템으로

##### 예제
<a name="connection-invitation-received-example"></a>

```
{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Received",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "inviterEmail": "abc@def.com",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderCompanyName": "<<Sender Partner Account Name>>",
        "senderProfileId": "pprofile-****",
        "expiresAt": "<ISO 8601 date time>"
    }
  }
}
```

#### 파트너 연결 초대 수락됨
<a name="connection-invitation-accepted"></a>

##### 트리거 컨텍스트
<a name="connection-invitation-accepted-context"></a>

이 이벤트는 연결 초대가 성공적으로 수락되고 연결이 생성되어 AcceptConnectionInvitation API를 통해 PAC의 데이터 스토어에 유지될 때 생성됩니다. 초대 수락이 성공적으로 완료되고 연결이 설정되면 이벤트가 즉시 전송됩니다.

연결 초대가 수락되면 이벤트가 자동으로 전송됩니다. 동일한 수락에 대한 중복 이벤트 없이 초대당 하나의 이벤트가 수락됩니다.

##### 수신자
<a name="connection-invitation-accepted-recipients"></a>

연결 초대에 관여한 두AWS계정 모두 원래 초대를 보낸 발신자 계정과 초대를 수락한 수신자 계정입니다.

##### 예상 처리
<a name="connection-invitation-accepted-handling"></a>

일반적인 고객 작업:
+ 파트너십 활성화: 워크플로를 트리거하여 계층 2 비즈니스 활동 활성화
+ 상태 업데이트: 파트너 관리 시스템을 활성 연결 상태로 업데이트
+ 알림: 성공적인 파트너십 수립에 대해 비즈니스 팀에 알림
+ 액세스 프로비저닝: 공동 작업에 적절한 권한 자동 부여
+ 분석: 파트너십 전환율 및 성공 지표 추적

일반적인 통합 패턴:
+ Lambda 함수 → 데이터 공유 권한 활성화 및 파트너 포털 업데이트
+ SQS 대기열 → 비즈니스 설정을 위한 배치 프로세스 연결 활성화
+ SNS 주제 → 비즈니스 및 기술 팀에 이메일/슬랙 알림
+ API 대상 → 파트너십 상태를 업데이트하기 위해 CRM 시스템으로 Webhook

##### 예제
<a name="connection-invitation-accepted-example"></a>

```
{
  "version": "1",
  "id": "<event id>",
  "detail-type":  "Partner Connection Invitation Accepted",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection Invitation ARN>>" , "<<Connection ARN>>" ],
  "account": "<corresponding partner AWS account>",
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration"
    },
    "connection": {
        "arn": "<<Connection ARN>>",
         "id": "pac-*****",
         "Participant1AccountId": "<<Sender AWS AccountId>>", 
         "Participant2AccountId": "<<Receiver AWS AccountId>>",
         "status": "ACTIVE"
     }
  }
}
```

#### 파트너 연결 초대가 거부됨
<a name="connection-invitation-rejected"></a>

##### 트리거 컨텍스트
<a name="connection-invitation-rejected-context"></a>

이 이벤트는 RejectConnectionInvitation API를 통해 연결 초대가 성공적으로 거부될 때 생성됩니다. 이벤트는 초대 거부가 처리되고 PAC의 데이터 스토어에 지속된 직후 전송됩니다.

연결 초대가 거부되면 이벤트가 자동으로 전송됩니다. 초대당 하나의 이벤트가 거부되고 동일한 거부에 대한 중복 이벤트가 없습니다.

##### 수신자
<a name="connection-invitation-rejected-recipients"></a>

원래 연결 초대를 보낸AWS계정(발신자 계정).

##### 예상 처리
<a name="connection-invitation-rejected-handling"></a>

일반적인 고객 작업:
+ 상태 업데이트: 거부 상태로 파트너 관리 시스템 업데이트
+ 후속 조치: 대체 파트너십 접근 방식을 위한 워크플로 트리거
+ 알림: 비즈니스 팀에 파트너십 결정에 대해 알림
+ 정리: 내부 시스템에서 보류 중인 초대 참조 제거

일반적인 통합 패턴:
+ Lambda 함수 → 파트너 포털 업데이트 및 후속 워크플로 트리거
+ SQS 대기열 → 비즈니스 분석을 위한 배치 프로세스 거부
+ SNS 주제 → 비즈니스 개발 팀에 이메일/슬랙 알림
+ API 대상 → 기회 상태를 업데이트하기 위해 Webhook에서 CRM 시스템으로

##### 예제
<a name="connection-invitation-rejected-example"></a>

```
{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Rejected",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "receiverProfileId": "pprofile-****"
    }
  }
}
```

#### 파트너 연결 취소됨
<a name="connection-cancelled"></a>

##### 트리거 컨텍스트
<a name="connection-cancelled-context"></a>

이 이벤트는 활성 연결이 성공적으로 취소되고 CancelConnection API를 통해 PAC의 데이터 스토어에서 활성 상태가 종료되도록 업데이트될 때 생성됩니다. 연결 취소가 처리되고 연결 상태가 업데이트되면 이벤트가 즉시 전송됩니다.

연결이 종료되면 이벤트가 자동으로 전송됩니다. 동일한 취소에 대한 중복 이벤트 없이 연결당 하나의 이벤트가 취소되었습니다.

##### 수신자
<a name="connection-cancelled-recipients"></a>

연결에 있는 다른 참가자의AWS계정(취소를 시작한 참가자가 아님).

##### 예상 처리
<a name="connection-cancelled-handling"></a>

일반적인 고객 작업:
+ 액세스 취소: 권한을 즉시 취소하고 데이터 공유를 비활성화합니다.
+ 상태 업데이트: 종료된 연결 상태로 파트너 관리 시스템 업데이트
+ 알림: 비즈니스 및 기술 팀에 파트너십 종료 알림
+ 정리: 연결 참조 제거 및 공유 리소스 정리
+ 분석: 연결 기간 및 종료 패턴 추적

일반적인 통합 패턴:
+ Lambda 함수 → 권한 취소 및 파트너 포털 상태 업데이트
+ SQS 대기열 → 정리 워크플로를 위한 배치 프로세스 연결 종료
+ SNS 주제 → 비즈니스 및 기술 팀에 이메일/슬랙 알림
+ API 대상 → 파트너십 상태를 업데이트하기 위해 Webhook에서 CRM 시스템으로

##### 예제
<a name="connection-cancelled-example"></a>

```
{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Cancelled",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection ARN>>" ],
  "account": "<corresponding partner AWS account>",
  "detail": {
    "catalog": "AWS",
    "connection" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pac-****",
        "connectionType": "OpportunityCollaboration",
        "canceledBy": "<<AWS account ID>>"
    }
  }
}
```

#### 파트너 연결 초대 취소됨
<a name="connection-invitation-cancelled"></a>

##### 트리거 컨텍스트
<a name="connection-invitation-cancelled-context"></a>

이 이벤트는 보류 중인 연결 초대가 CancelConnectionInvitation API를 통해 성공적으로 취소될 때 생성됩니다. 초대 취소가 처리되고 초대 상태가 취소됨으로 업데이트되면 이벤트가 즉시 전송됩니다.

연결 초대가 취소되면 이벤트가 자동으로 전송됩니다. 동일한 취소에 대한 중복 이벤트 없이 연결 초대당 하나의 이벤트가 취소되었습니다.

##### 수신자
<a name="connection-invitation-cancelled-recipients"></a>

연결 초대를 수신해야 하는AWS계정(수신자 계정).

##### 예상 처리
<a name="connection-invitation-cancelled-handling"></a>

일반적인 고객 작업:
+ 상태 업데이트: 보류 중인 초대 참조를 제거하도록 파트너 관리 시스템 업데이트
+ 알림: 비즈니스 팀에 잠재적 파트너십 기회가 취소되었음을 알립니다.
+ 정리: 내부 추적 시스템에서 초대 참조 제거
+ 분석: 파트너십 인사이트를 위한 초대 취소 패턴 추적

일반적인 통합 패턴:
+ Lambda 함수 → 파트너 포털 업데이트 및 보류 중인 초대 알림 제거
+ SQS 대기열 → 비즈니스 분석을 위한 배치 프로세스 취소
+ SNS 주제 → 비즈니스 개발 팀에 이메일/슬랙 알림
+ API 대상 → 기회 상태를 업데이트하기 위해 CRM 시스템으로 Webhook

##### 예제
<a name="connection-invitation-cancelled-example"></a>

```
{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Cancelled",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "account": "<corresponding partner AWS account>",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation" :{
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderProfileId": "pprofile-****"
    }
  }
}
```

#### 파트너 연결 초대 만료됨
<a name="connection-invitation-expired"></a>

##### 트리거 컨텍스트
<a name="connection-invitation-expired-context"></a>

이 이벤트는 보류 중인 연결 초대가 수신자가 수락하거나 거부하지 않고 ExpiresAt 타임스탬프에 도달한 후 자동으로 만료될 때 생성됩니다. 초대 만료 시간에 도달하면 시스템에서 이벤트가 자동으로 트리거됩니다.

연결 초대가 만료되면 이벤트가 자동으로 전송됩니다. 초대당 하나의 이벤트가 동일한 만료 기간 동안 중복 이벤트 없이 만료되었습니다.

##### 수신자
<a name="connection-invitation-expired-recipients"></a>

연결 초대에 관여한 두AWS계정 모두 원래 초대를 보낸 발신자 계정과 초대를 받은 수신자 계정입니다.

##### 예상 처리
<a name="connection-invitation-expired-handling"></a>

일반적인 고객 작업:
+ 상태 업데이트: 초대를 만료됨으로 표시하도록 파트너 관리 시스템 업데이트
+ 후속 조치: 재참여 또는 대체 파트너십 접근 방식을 위한 워크플로 트리거
+ 알림: 비즈니스 팀에 누락된 파트너십 기회에 대해 알림
+ 정리: 내부 추적 시스템에서 만료된 초대 참조 제거

일반적인 통합 패턴:
+ Lambda 함수 → 파트너 포털 업데이트 및 후속 워크플로 트리거
+ SQS 대기열 → 비즈니스 분석을 위한 배치 프로세스 만료
+ SNS 주제 → 비즈니스 개발 팀에 이메일/슬랙 알림
+ API 대상 → 기회 상태를 업데이트하기 위해 CRM 시스템으로 Webhook

##### 예제
<a name="connection-invitation-expired-example"></a>

```
{
  "version": "1",
  "id": "<event id>",
  "detail-type": "Partner Connection Invitation Expired",
  "source": "aws.partnercentral-account",
  "time": "<ISO 8601 date time>",
  "region": "us-east-1",
  "resources": [ "<<Connection Invitation ARN>>" ],
  "detail": {
    "catalog": "AWS",
    "connectionInvitation": {
        "arn": "<<Connection Invitation ARN>>",
        "id": "pacinv-****",
        "connectionType": "OpportunityCollaboration",
        "inviterEmail": "abc@def.com",
        "invitationMessage": "We'd like to collaborate on a joint solution for cloud security. Please accept this connection invitation to proceed.",
        "senderProfileId": "pprofile-****",
        "receiverProfileId": "pprofile-****"
    }
  }
}
```