• 2026 年 4 月 30 日之後， AWS Systems Manager CloudWatch Dashboard 將不再可用。客戶可以繼續使用 Amazon CloudWatch 主控台來檢視、建立和管理其 Amazon CloudWatch 儀表板，就像現在一樣。如需詳細資訊，請參閱 [Amazon CloudWatch Dashboard 文件](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 故障診斷 AWS Systems Manager Distributor
下列資訊可協助您對使用 Distributor ( AWS Systems Manager中的工具) 時可能發生的問題進行疑難排解。
**Topics**
+ [安裝了相同名稱的錯誤套件](#distributor-tshoot-1)
+ [錯誤：無法擷取資訊清單：找不到套件的最新版本](#distributor-tshoot-2)
+ [錯誤：無法擷取資訊清單：驗證異常](#distributor-tshoot-3)
+ [不支援套件 (套件缺少安裝動作)](#distributor-tshoot-4)
+ [錯誤：無法下載資訊清單：具有名稱的文件不存在](#distributor-tshoot-5)
+ [上傳失敗。](#distributor-tshoot-6)
+ [錯誤：無法找到平台：無法找到平台的資訊清單：oracle，8.9 版，架構 x86\$164](#distributor-tshoot-7)
## 安裝了相同名稱的錯誤套件
**問題：**您已安裝套件，但 Distributor 改為安裝不同的套件。
**原因：**安裝時，Systems Manager 會尋找 AWS 發佈的套件做為結果，優先於使用者定義的外部套件。如果您的使用者定義套件名稱與 AWS 已發佈的套件名稱相同， AWS 則會安裝套件，而非您的套件。
**解決方案：**為避免此問題，請將套件命名為與 AWS 已發佈套件名稱不同的名稱。
## 錯誤：無法擷取資訊清單：找不到套件的最新版本
**問題：**您收到了以下錯誤：
```
Failed to retrieve manifest: ResourceNotFoundException: Could not find the latest version of package
arn:aws:ssm:::package/package-name status code: 400, request id: guid
```
**原因：**您使用的 SSM Agent 搭配 Distributor 版本早於 2.3.274.0 版本。
**解決方案：**將 SSM Agent 的版本更新到 2.3.274.0 版本或更新版本。如需詳細資訊，請參閱 [使用 Run Command 更新 SSM Agent](run-command-tutorial-update-software.md#rc-console-agentexample) 或 [逐步解說：SSM Agent使用 自動更新 AWS CLI](state-manager-update-ssm-agent-cli.md) 。
## 錯誤：無法擷取資訊清單：驗證異常
**問題：**您收到了以下錯誤：
```
Failed to retrieve manifest: ValidationException: 1 validation error detected: Value 'documentArn'
at 'packageName' failed to satisfy constraint: Member must satisfy regular expression pattern:
arn:aws:ssm:region-id:account-id:package/package-name
```
**原因：**您使用的 SSM Agent 搭配 Distributor 版本早於 2.3.274.0 版本。
**解決方案：**將 SSM Agent 的版本更新到 2.3.274.0 版本或更新版本。如需詳細資訊，請參閱 [使用 Run Command 更新 SSM Agent](run-command-tutorial-update-software.md#rc-console-agentexample) 或 [逐步解說：SSM Agent使用 自動更新 AWS CLI](state-manager-update-ssm-agent-cli.md) 。
## 不支援套件 (套件缺少安裝動作)
**問題：**您收到了以下錯誤：
```
Package is not supported (package is missing install action)
```
**原因：**套件目錄結構不正確。
**解決方案：**不要壓縮包含軟件和所需指令碼的父目錄。相反地，直接在絕對路徑中建立全部所需內容的 `.zip` 檔案。驗證是否正確建立 `.zip` 檔案，請解壓縮目標平台目錄並檢閱目錄結構。例如，安裝指令碼絕對路徑應該是 `/ExamplePackage_targetPlatform/install.sh`。
## 錯誤：無法下載資訊清單：具有名稱的文件不存在
**問題：**您收到了以下錯誤：
```
Failed to download manifest - failed to retrieve package document description: InvalidDocument: Document with name filename does not exist.
```
**原因 1：**共用來自另一個帳戶的 Distributor 套件時，Distributor 無法透過套件名稱找到套件。
**解決方案 1：**共用另一個帳戶的套件時，使用套件的完整 Amazon Resource Name (ARN)，而不是只使用其名稱。
**原因 2：**使用 VPC 時，您尚未提供 IAM 執行個體描述檔存取權給 AWS 受管 S3 儲存貯體，其中包含 AWS 區域 目標 `AWS-ConfigureAWSPackage`的文件。
**解決方案 2：**確保您的 IAM 執行個體描述檔SSM Agent提供受 AWS 管 S3 儲存貯體的存取權，其中包含 AWS 區域 您要鎖定`AWS-ConfigureAWSPackage`的 文件，如 中所述[SSM Agent 與 AWS 受管 S3 儲存貯體的通訊](ssm-agent-technical-details.md#ssm-agent-minimum-s3-permissions)。
## 上傳失敗。
**問題：**您收到了以下錯誤：
```
Upload failed. At least one of your files was not successfully uploaded to your S3 bucket.
```
**原因：**軟體套件的名稱包含空格。例如，`Hello World.msi` 將無法上傳。
## 錯誤：無法找到平台：無法找到平台的資訊清單：oracle，8.9 版，架構 x86\$164
**問題：**您收到了以下錯誤：
```
Failed to find platform: no manifest found for platform: oracle, version 8.9, architecture x86_64
```
**原因：**錯誤表示 JSON 套件資訊清單沒有該平台的任何定義 (在此案例中為 Oracle Linux)。
**解決方案：**從 [Trend Micro Deep Security 軟體](https://help.deepsecurity.trendmicro.com/software.html)網站下載您要分發的套件。使用[使用簡單工作流程建立套件](distributor-working-with-packages-create.md#distributor-working-with-packages-create-simple)建立 `.rpm` 軟體套件。為套件設定下列值，然後使用 Distributor 完成上傳軟體套件：
```
Platform version: _any
Target platform: oracle
Architecture: x86_64
```