AWS 合作夥伴中心 API 參考已重組。如需支援的 API 操作的詳細資訊，請參閱 [AWS 合作夥伴中心 API 參考](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用合作夥伴設定檔
<a name="working-with-partner-profile"></a>

## 設定檔管理
<a name="profile-management"></a>

合作夥伴透過公有/私有可見性控制、非同步驗證和狀態追蹤，管理包含公司詳細資訊 （名稱、描述、網站、標誌） 的設定檔，一次允許更新一次。

1. **設定檔資訊** – 合作夥伴設定檔必須包含基本的公司詳細資訊，例如顯示名稱、描述、網站 URL、標誌、IndustrySegments和 PrimarySolutionType。

1. **多語言支援** – 合作夥伴設定檔支援多種語言。設定檔的每個當地語系化版本都包含地區設定的屬性。

1. **設定檔可見性控制 – **合作夥伴可以設定其設定檔可見性 （公有或私有）。

1. **設定檔儲存** – 設定檔資訊將存放在合作夥伴帳戶物件中。

1. **設定檔狀態管理** – 發佈之前，設定檔更新會以非同步方式驗證。合作夥伴可以檢查最新的設定檔更新狀態 (IN\_PROGRESS、SUCCEED、FAILED 和 CANCELLED)。只有核准的設定檔才會公開顯示。

1. **請求並行控制** – 一次僅允許一個設定檔更新請求。如果設定檔更新已在進行中，客戶必須先透過 CancelPartnerProfileUpdateTask API 明確取消持續更新，才能啟動新的更新。

1. **取消更新任務** – 合作夥伴可以透過呼叫 CancelPartnerProfileUpdateTask API 來取消進行中的設定檔更新。只有在更新處於 IN\_PROGRESS 狀態時，才允許取消，並且必須在開始新的更新之前完成。

### API 摘要
<a name="profile-api-summary"></a>

1. **StartPutProfileTask API：**此 API 接受合作夥伴設定檔更新，並執行基本同步輸入驗證。

1. **GetProfileUpdateTask API：**此 API 允許合作夥伴擷取目前的設定檔更新狀態。它適用於客戶透過 StartPutPartnerProfile API 開始設定檔更新後，讓合作夥伴檢查其請求是 IN\_PROGRESS、FAILED、SUCCEEDED 還是 CANCELLED。

1. **CancelProfileTask API：**允許合作夥伴明確取消目前處於 IN\_PROGRESS 狀態的設定檔更新任務。這包括自動審核和手動審核階段。取消請求可讓合作夥伴啟動新的設定檔更新，而無需等待目前的審核程序完成。

1. **PutProfileVisibility API：**透過呼叫此 API，無論地區設定為何，合作夥伴都可以控制設定檔的可見性。這可讓合作夥伴將設定檔設為公有或私有，而無需修改內容。

1. **GetProfileVisibility API：**透過呼叫 UpdatePartnerProfileVisibility API，無論地區設定為何，合作夥伴都可以控制設定檔的可見性。這可讓合作夥伴將設定檔設為公有或私有，而無需修改內容。