이벤트를 모니터링하기 위한 사전 조건 완료 이벤트를 모니터링하도록 Amazon EventBridge 구성 계정 연결 API 이벤트에 대해 자세히 알아보기

AWS파트너 중앙 계정 API에 대한 알림

파트너 계정 연결 알림을 통해 파트너는 비즈니스 관계 및 운영 워크플로에 직접적인 영향을 미치는 연결 수명 주기 이벤트에 대한 정보를 얻을 수 있습니다. 이러한 이벤트는 파트너가 다음을 수행하는 데 매우 중요합니다.

새로운 공동 작업에 즉시 대응
연결 포트폴리오 상태에 대한 인식 유지
연결이 설정되거나 종료될 때 적절한 조치를 취합니다.
관계가 변경되는 시점을 파악하여 비즈니스 연속성 보장

이벤트를 모니터링하기 위한 사전 조건 완료

계정 연결 API에서 게시한 이벤트에 액세스하고 관리하려면 사용자에게 적절한 IAM 권한이 필요합니다. EventBridge에 사용할 수 있는 작업, 리소스 및 조건 키에 대한 자세한 내용은 Amazon EventBridge 사용 설명서의 Amazon EventBridge에서 IAM 정책 조건 사용을 참조하세요. 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 구성

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

AWS Management Console설정

를 사용하여 EventBridge 규칙을 설정하려면 Amazon EventBridge 사용 설명서의 Amazon EventBridge에서 이벤트에 반응하는 규칙 생성의 단계를AWS Management Console따릅니다. EventBridge 규칙을 생성할 때 이벤트 버스를 기본값으로 설정하고 미국 동부(버지니아 북부) us-east-1 리전에서 규칙을 생성해야 합니다.

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


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

AWS SDK 설정

AWS SDKs를 사용하여 EventBridge 규칙을 프로그래밍 방식으로 생성하고 관리할 수 있습니다. 자세한 내용은 Amazon EventBridge API 참조의 PutRule을 참조하세요.

다음 예제에서는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 이벤트에 대해 자세히 알아보기

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

이벤트 유형

다음은 이벤트 유형과 트리거입니다.

파트너 연결 초대 수신: 다른 파트너가 연결을 설정하려고 함을 수신자에게 알립니다.
파트너 연결 초대 수락: 발신자에게 초대가 수락되었으며 이제 연결이 활성 상태임을 알립니다.
파트너 연결 초대가 거부됨: 발신자에게 초대가 거부되었음을 알립니다.
파트너 연결 취소됨: 활성 연결이 종료되면 다른 연결된 참가자에게 알립니다.
파트너 연결 초대 취소됨: 발신자가 조치를 취하기 전에 초대를 취소했음을 수신자에게 알립니다.
파트너 연결 초대 만료: 발신자와 수신자 모두에게 초대가 만료되었음을 알립니다.

이벤트 예제

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

주제

파트너 연결 초대 수신됨
파트너 연결 초대 수락됨
파트너 연결 초대가 거부됨
파트너 연결 취소됨
파트너 연결 초대 취소됨
파트너 연결 초대 만료됨

파트너 연결 초대 수신됨

트리거 컨텍스트

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

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

수신자

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

예상 처리

일반적인 고객 작업:

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

일반적인 통합 패턴:

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

예제


{
  "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>"
    }
  }
}

파트너 연결 초대 수락됨

트리거 컨텍스트

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

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

수신자

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

예상 처리

일반적인 고객 작업:

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

일반적인 통합 패턴:

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

예제


{
  "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"
     }
  }
}

파트너 연결 초대가 거부됨

트리거 컨텍스트

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

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

수신자

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

예상 처리

일반적인 고객 작업:

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

일반적인 통합 패턴:

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

예제


{
  "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-****"
    }
  }
}

파트너 연결 취소됨

트리거 컨텍스트

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

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

수신자

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

예상 처리

일반적인 고객 작업:

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

일반적인 통합 패턴:

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

예제


{
  "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>>"
    }
  }
}

파트너 연결 초대 취소됨

트리거 컨텍스트

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

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

수신자

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

예상 처리

일반적인 고객 작업:

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

일반적인 통합 패턴:

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

예제


{
  "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-****"
    }
  }
}

파트너 연결 초대 만료됨

트리거 컨텍스트

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

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

수신자

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

예상 처리

일반적인 고객 작업:

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

일반적인 통합 패턴:

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

예제


{
  "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-****"
    }
  }
}

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

알림

AWS Partner Central Selling API에 대한 알림