本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 正在连接 PagerDuty
<a name="connecting-to-ticketing-and-chat-connecting-pagerduty"></a>

PagerDuty 集成使 AWS DevOps 代理能够在事件调查和自动响应期间访问和更新您 PagerDuty 帐户中的事件数据、待命时间表和服务信息。此集成使用 OAuth 2.0 进行安全身份验证。

**重要**  
** AWS DevOps 代理仅支持较新的 PagerDuty OAuth 2.0（Scoped OAuth）。不支持带有重定向 URI 的旧版 PagerDuty OAuth。

## PagerDuty 要求
<a name="pagerduty-requirements"></a>

在连接之前 PagerDuty，请确保您有：
+ 带有您的 OAuth 客户端 ID 和客户端密钥的 PagerDuty 账户
+ 您的 PagerDuty 账户子域名（例如，如果您的 PagerDuty URL 是`https://your-company.pagerduty.com`，则子域名是）`your-company`

## 正在注册 PagerDuty
<a name="registering-pagerduty"></a>

PagerDuty 在 AWS 账户级别注册，并在该账户中的所有代理空间之间共享。每个注册对应一个 PagerDuty 账户，该账户由其区域和子域名标识。要注册其他 PagerDuty 帐户，请对每个帐户重复此过程。

### 步骤 1：在中配置访问权限 PagerDuty
<a name="step-1-configure-access-in-pagerduty"></a>

1. 登录 AWS 管理控制台

1. 导航到 AWS DevOps 代理控制台

1. 转到**能力提供者**页面（可从侧面导航中访问）

1. **PagerDuty**在 “**通信” 下的 “**可用**提供商” 部分中查找**，然后选择 “**注册” **

1. 按照 “**配置访问权限 PagerDuty**” 页面上的指导设置进行操作：

**检查您的服务区域和子域：**
+ **账户范围 ** — 选择您 PagerDuty 所在的地区（**美国**或**欧盟**）并输入您的 PagerDuty 子域名。例如，如果您的 PagerDuty URL 是`https://your-company.pagerduty.com`，请输入`your-company`。

**在以下位置创建新应用程序 PagerDuty：**
+ 在单独的浏览器选项卡中，登录 PagerDuty 并导航到**集成 > 应用程序注册 **
+ 使用 ** OAuth 2.0 Scoped OAuth 创建新应用程序 **
+ 在 “**权限” 下**，授予以下最低要求范围：`incidents.read``incidents.write`、`services.read`、`webhook_subscriptions.read`、和 `webhook_subscriptions.write`
+ 启用**事件集成**以允许 AWS DevOps 代理和之间的双向通信 PagerDuty

**配置 OAuth 凭证：**
+ **权限范围 ** — 所需的最低范围是：`incidents.read`、、`incidents.write`、`services.read`、`webhook_subscriptions.read`、`webhook_subscriptions.write`
+ **客户名称 ** — 输入您的 OAuth 客户端的描述性名称
+ **客户端 ID ** — 输入应用程序注册后的 OAuth 客户端 ID PagerDuty 
+ **客户端密钥 ** — 输入应用程序注册时的 OAuth 客户端密钥 PagerDuty 

### 第 2 步：查看并提交 PagerDuty 注册
<a name="step-2-review-and-submit-pagerduty-registration"></a>

1. 查看所有 PagerDuty 配置细节

1. 选择 “****提交” 完成注册

1. 成功注册后， PagerDuty 将显示在 “能力提供者” 页面的 “**当前注册” ** 部分中

## PagerDuty 添加到代理空间
<a name="adding-pagerduty-to-an-agent-space"></a>

在账户 PagerDuty 级别注册后，您可以将其连接到各个代理空间：

1. 在 AWS DevOps 代理控制台中，选择您的代理空间

1. 转到 ** “**能力” 选项卡

1. 在 “**通信**” 部分，选择 “**添加” **

1. 选择要连接到此代理空间的**PagerDuty**注册。

1. 选择**保存**

单个代理空间可以使用多个 PagerDuty 注册。要连接其他注册，请重复这些步骤。

## 管理 PagerDuty 连接
<a name="managing-pagerduty-connections"></a>
+ **更新凭证 ** — 如果您的 OAuth 凭据需要更新，请 PagerDuty 从能力提供者页面取消注册并使用新凭据重新注册。
+ **查看连接 **-在 AWS DevOps 代理控制台中，选择您的代理空间并转到功能选项卡以查看连接的通信集成。
+ **删除 PagerDuty **-要断开与代理空间 PagerDuty 的连接，请在 “通信” 部分将其选中，然后选择 “**删除” **。要完全删除注册，请先将其从所有代理空间中删除，然后从 “能力提供者” 页面取消注册。

## Webhook 支持
<a name="webhook-support"></a>

AWS DevOps 代理仅支持 PagerDuty V3 网络挂钩。不支持早期的 webhook 版本。

有关 PagerDuty V3 Webhook 订阅的更多信息，请参阅 PagerDuty 开发者文档[中的 ](https://developer.pagerduty.com/docs/webhooks-overview#webhook-subscriptions) Webhook 概述。