AWS 合作伙伴中心 API 参考已重新构建。有关支持的 API 操作的更多信息，请参阅 [AWS 合作伙伴中心 API 参考](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 的通知AWS合作伙伴中心渠道 API
频道 API 的事件提供有关频道相关活动的状态变化或详细信息的实时通知。这些事件有助于使您的系统与AWS合作伙伴中心保持同步，并有助于确保及时响应和更新。
## 先决条件
您需要相应的 IAM 权限才能通过AWS合作伙伴中心渠道 API 访问和管理活动。有关可用操作、资源和条件键的信息 EventBridge，请参阅亚马逊* EventBridge 用户指南*[中的在亚马逊 EventBridge中使用 IAM 策略条件](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-use-conditions.html#events-pattern-detail-type)。其中一个条件键是`events:detail-type`，您可以使用它来将权限范围限定为特定的事件类型。
以下示例策略演示了如何自定义事件的权限并确定其范围。该`AllowPutRuleForPartnercentralChannelEvents`语句允许创建规则，但仅适用于来自`aws.partnercentral-channel`源的事件。
有关详细的 IAM 策略示例，请参阅有关 EventBridge 权限的 AWS 文档。
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowPutRuleForPartnerCentralChannelEvents",
"Effect": "Allow",
"Action": "events:PutRule",
"Resource": "*",
"Condition": {
"StringEquals": {
"events:source": "aws.partnercentral-channel"
}
}
}
]
}
```
## 将 Amazon 配置 EventBridge 为监控事件
要监控频道 API 事件，您需要创建一个与要捕获的事件相匹配的 EventBridge 规则。您可以使用AWS Management Console或 S AWS DK 来创建和管理规则。以下各节说明如何使用这两种方法创建规则。无论使用哪种方法，都必须在美国东部（弗吉尼亚北部）`us-east-1`地区创建规则。
### AWS Management Console设置
要使用设置 EventBridge 规则AWS Management Console，请按照《亚马逊* EventBridge 用户指南*》中[创建响应亚马逊事件的规则 EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)中的步骤进行操作。创建规则时，必须将事件总线设置为**默认值**，并在美国东部（弗吉尼亚北部）`us-east-1`区域创建规则。
以下是事件规则的示例：
```
{
"source": ["aws.partnercentral-channel"],
"detail": {
"catalog": ["AWS"]
}
}
```
### AWS软件开发工具包设置
您可以使用AWS软件开发工具包以编程方式创建和管理 EventBridge 规则。有关更多信息，请参阅 *Amazon EventBridge API 参考[PutRule](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutRule.html)*中的。
以下示例使用适用于 Python 的AWS SDK (Boto3)：
```
import boto3
client = boto3.client('events', region_name='us-east-1')
response = client.put_rule(
Name='ChannelHandshakeCreatedRule',
EventPattern=
'{
"source": ["aws.partnercentral-channel"],
"detail-type": ["Channel Handshake Created"],
"detail": {"catalog": ["AWS"]}
}',
State='ENABLED'
)
print('Rule ARN:', response['RuleArn'])
```
## 了解有关频道 API 事件的更多信息
以下各节描述了渠道 API 事件类型、触发这些事件的场景以及事件示例。
### 事件类型
以下是事件类型及其触发器。
+ [频道握手已创建：创建](#channel-handshake-created)新频道握手时触发。
+ [频道握手已接受：接受](#channel-handshake-accepted)新的频道握手时触发。
+ [频道握手被拒绝](#channel-handshake-rejected)：当新的频道握手被拒绝时触发。
### 频道握手已创建
以下示例显示了针对不同握手类型的典型Channel Handshake创建事件。
**开始服务期握手：**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Created",
"source": "aws.partnercentral-channel",
"account": "789789789789",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-abc123def456g"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "rs-jkl012mno345p",
"handshakeType": "START_SERVICE_PERIOD",
"id": "ch-abc123def456g",
"receiverAccountId": "789789789789",
"ownerAccountId": "123123123123",
"senderAccountId": "456456456456",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"startServicePeriodHandshakeDetail": {
"servicePeriodType": "MINIMUM_NOTICE_PERIOD",
"minimumNoticeDays": "14",
"endDate": null,
"startDate": "2025-02-02T00:00:00Z",
"note": "Test note example"
}
}
}
}
```
**撤销服务期限握手：**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Created",
"source": "aws.partnercentral-channel",
"account": "789789789789",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-def456ghi789j"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "rs-jkl012mno345p",
"handshakeType": "REVOKE_SERVICE_PERIOD",
"id": "ch-def456ghi789j",
"ownerAccountId": "123123123123",
"receiverAccountId": "789789789789",
"senderAccountId": "456456456456",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"revokeServicePeriodHandshakeDetail": {
"servicePeriodType": "MINIMUM_NOTICE_PERIOD",
"minimumNoticeDays": "14",
"endDate": null,
"startDate": "2025-02-02T00:00:00Z",
"note": "Test note example"
}
}
}
}
```
**项目管理账户握手：**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Created",
"source": "aws.partnercentral-channel",
"account": "456456456456",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-ghi789jkl012m"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "pma-abc123def456g",
"handshakeType": "PROGRAM_MANAGEMENT_ACCOUNT",
"id": "ch-ghi789jkl012m",
"ownerAccountId": "123123123123",
"receiverAccountId": "456456456456",
"senderAccountId": "123123123123",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"programManagementAccountHandshakeDetail": {
"program": "SOLUTION_PROVIDER"
}
}
}
}
```
### 频道握手已接受
以下示例显示了不同握手类型的典型频道握手接受事件。
**开始服务期握手：**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Accepted",
"source": "aws.partnercentral-channel",
"account": "123123123123",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-abc123def456g"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "rs-jkl012mno345p",
"handshakeType": "START_SERVICE_PERIOD",
"id": "ch-abc123def456g",
"ownerAccountId": "123123123123",
"receiverAccountId": "789789789789",
"senderAccountId": "456456456456",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"startServicePeriodHandshakeDetail": {
"servicePeriodType": "MINIMUM_NOTICE_PERIOD",
"minimumNoticeDays": "14",
"endDate": null,
"startDate": "2025-02-02T00:00:00Z",
"note": "Test note example"
}
}
}
}
```
**撤销服务期限握手：**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Accepted",
"source": "aws.partnercentral-channel",
"account": "123123123123",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-def456ghi789j"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "rs-jkl012mno345p",
"handshakeType": "REVOKE_SERVICE_PERIOD",
"id": "ch-def456ghi789j",
"ownerAccountId": "123123123123",
"receiverAccountId": "789789789789",
"senderAccountId": "456456456456",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"revokeServicePeriodHandshakeDetail": {
"servicePeriodType": "MINIMUM_NOTICE_PERIOD",
"minimumNoticeDays": "14",
"endDate": null,
"startDate": "2025-02-02T00:00:00Z",
"note": "Test note example"
}
}
}
}
```
**项目管理账户握手：**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Accepted",
"source": "aws.partnercentral-channel",
"account": "123123123123",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-ghi789jkl012m"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "pma-abc123def456g",
"handshakeType": "PROGRAM_MANAGEMENT_ACCOUNT",
"id": "ch-ghi789jkl012m",
"ownerAccountId": "123123123123",
"receiverAccountId": "456456456456",
"senderAccountId": "123123123123",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"programManagementAccountHandshakeDetail": {
"program": "SOLUTION_PROVIDER"
}
}
}
}
```
### 频道握手被拒绝
以下示例显示了不同握手类型的典型频道握手被拒绝事件。
**开始服务期握手：**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Rejected",
"source": "aws.partnercentral-channel",
"account": "123123123123",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-abc123def456g"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "rs-jkl012mno345p",
"handshakeType": "START_SERVICE_PERIOD",
"id": "ch-abc123def456g",
"ownerAccountId": "123123123123",
"receiverAccountId": "789789789789",
"senderAccountId": "456456456456",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"startServicePeriodHandshakeDetail": {
"servicePeriodType": "MINIMUM_NOTICE_PERIOD",
"minimumNoticeDays": "14",
"endDate": null,
"startDate": "2025-02-02T00:00:00Z",
"note": "Test note example"
}
}
}
}
```
**撤销服务期限握手：**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Rejected",
"source": "aws.partnercentral-channel",
"account": "123123123123",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-def456ghi789j"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "rs-jkl012mno345p",
"handshakeType": "REVOKE_SERVICE_PERIOD",
"id": "ch-def456ghi789j",
"ownerAccountId": "123123123123",
"receiverAccountId": "789789789789",
"senderAccountId": "456456456456",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"revokeServicePeriodHandshakeDetail": {
"servicePeriodType": "MINIMUM_NOTICE_PERIOD",
"minimumNoticeDays": "14",
"endDate": null,
"startDate": "2025-02-02T00:00:00Z",
"note": "Test note example"
}
}
}
}
```
**项目管理账户握手：**
```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab",
"detail-type": "Channel Handshake Rejected",
"source": "aws.partnercentral-channel",
"account": "123123123123",
"time": "2025-02-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:partnercentral:us-east-1:123123123123:catalog/AWS/channel-handshake/ch-ghi789jkl012m"
],
"detail": {
"requestId": "12345678-1234-1234-1234-123456789abc",
"catalog": "AWS",
"associatedResourceIdentifier": "pma-abc123def456g",
"handshakeType": "PROGRAM_MANAGEMENT_ACCOUNT",
"id": "ch-ghi789jkl012m",
"ownerAccountId": "123123123123",
"receiverAccountId": "456456456456",
"senderAccountId": "123123123123",
"senderDisplayName": "TestDisplayName",
"handshakeDetail": {
"programManagementAccountHandshakeDetail": {
"program": "SOLUTION_PROVIDER"
}
}
}
}
```