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

# 常见的调试和故障排除问题
<a name="common-issues"></a>

**重要**  
该 AWS OpsWorks Stacks 服务于 2024 年 5 月 26 日终止，新客户和现有客户均已禁用。我们强烈建议客户尽快将其工作负载迁移到其他解决方案。如果您对迁移有疑问，请通过 re [AWS : Post 或通过 Pre](https://repost.aws/) mium Su [AWS pp](https://aws.amazon.com/support) ort 与 AWS 支持 团队联系。

这部分介绍一些常见的调试和故障排除问题以及它们的解决方案。

**Topics**
+ [OpsWorks 堆栈故障排除](common-issues-troubleshoot.md)
+ [对实例注册进行故障排除](#common-issues-instance-registration)

## 对实例注册进行故障排除
<a name="common-issues-instance-registration"></a>

这部分包含一些常见的实例注册问题及其解决方案。

**注意**  
如果您遇到了注册问题，请使用 `--debug` 参数运行 `register`，其中提供了更多调试信息。

**Topics**
+ [EC2用户无权执行：...](#common-issues-instance-registration-ec2user)
+ [凭证应当局限于有效区域](#common-issues-instance-registration-valid-region)

### EC2用户无权执行：...
<a name="common-issues-instance-registration-ec2user"></a>

**问题：**`register` 命令返回如下内容：

```
A client error (AccessDenied) occurred when calling the CreateGroup operation: 
User: arn:aws:iam::123456789012:user/ImportEC2User is not authorized to
perform: iam:CreateGroup on resource: 
arn:aws:iam::123456789012:group/AWS/OpsWorks/OpsWorks-b583ce55-1d01-4695-b3e5-ee19257d1911
```

**原因：** `register` 命令运行时使用的凭证未授予所需的权限。该用户的策略必须允许执行 `iam:CreateGroup` 等操作。

**解决方案：**向 `register` 提供拥有所需权限的 IAM 用户凭证。有关更多信息，请参阅 [安装和配置 AWS CLI](registered-instances-register-registering-cli.md)。

### 凭证应当局限于有效区域
<a name="common-issues-instance-registration-valid-region"></a>

**问题：**`register` 命令返回以下内容：

```
A client error (InvalidSignatureException) occurred when calling the
DescribeStacks operation: Credential should be scoped to a valid region, not 'cn-north-1'.
```

**原因：**该命令的区域必须是有效的 OpsWorks Stacks 区域。有关受支持的区域的列表，请参阅“[区域支持](gettingstarted_intro.md#gettingstarted-intro-region)”。此错误通常是由以下原因之一导致的：
+ 堆栈位于其他区域，而您将堆栈的区域分配给了该命令的 `--region` 参数。

  您无需指定堆栈区域；Stac OpsWorks ks 会根据堆栈 ID 自动确定堆栈区域。
+ 您省略了隐式指定默认区域的 `--region` 参数，但 OpsWorks Stacks 不支持您的默认区域。

**解决方案：**明确设置`--region`为支持的 OpsWorks 堆栈区域``，或者编辑您的 AWS CLI `config`文件以将默认区域更改为支持的 OpsWorks 堆栈区域。有关更多信息，请参阅[配置 AWS 命令行界面](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)。