所有服務分配管理系統的必要端點邏輯

服務分配管理系統必須提供 REST API 所耗用的一組標準 meta 資料值，而 IBM Cloud 分配管理系統必須要有下列 REST API 端點或路徑的邏輯：

型錄 (GET)

傳回分配管理系統中所含的型錄 meta 資料。

資源實例 (PUT)

建立服務實例。

資源實例 (DELETE)

刪除服務實例。

資源實例 (PATCH)

更新服務實例。

型錄 (GET) 的附註：此端點定義分配管理系統與分配管理系統所支援服務及方案之 IBM Cloud 平台間的合約。 此端點會傳回儲存於您的中介伺服器中的目錄元資料。 這些值定義了您的服務與 IBM Cloud 平台之間的最低限度合約。 所有非必要的額外目錄元資料，皆儲存於 IBM Cloud 目錄中。 任何目錄顯示值（如連結和圖示）的更新，必須在控制台 IBM Cloud 進行，而非存放於您的經紀商中。 儲存在分配管理系統中的 meta 資料都不會顯示在 IBM Cloud 主控台或 IBM Cloud CLI 中。 主控台和命令列介面（CLI）會回傳在「Partner Center Sell」中設定，並儲存於「IBM Cloud」目錄中的內容。 以下部分列出了 catalog (GET) 方法所回傳的最低必要值：

{
       "services": [{
           "id": "0bc9d744-6f8c-4821-9648-2278bf6925bb",
           "name": "ibmcloud-link",
           "description": "An IBM provided service that enables aliasing to service instances in the IBM Cloud.",
           "bindable": true,
           "plan_updateable": false,
           "plans": [
               {
                   "id": "da40662d-2f72-4a19-8c79-8c77cf285e1",
                   "name": "ibmcloud-alias",
                   "free": true,
                   "description": "The IBM Cloud alias plan used for linking."
               }
               ]
       }]
}

可連結服務的必要端點邏輯

若您的服務可與 IBM Cloud 中的應用程式綁定，則必須向服務使用者提供 API 端點及憑證。 可連結服務必須使用 Open Service Broker 規格中的可連結作業，並實作下列端點或路徑：

連結及認證 (PUT)

將服務實例連結至應用程式。

連結及認證 (DEL)

將您的服務實例與應用程式取消連結。

必要 IBM Cloud 延伸端點

OSB 規格不支援已停用實例狀態。 已停用狀態包括導致帳戶暫停 (但尚未取消) 且不同於已刪除實例狀態的遺漏付款或其他狀況。 為 IBM Cloud 支援可能處於停用狀態的客戶 IBM Cloud，我們定義了擴展 API 端點，允許停用及重新啟用服務實例。 必須具備以下端點擴充功能：

啟用及停用實例 (GET)

狀態 - 傳回服務實例的狀態。

啟用及停用實例 (PUT)

啟用或停用服務實例。

服務提供者必須負責在停用端點啟動時，停用對服務實例的存取權，並且在啟用端點啟動時，重新啟用該存取權。

X-Broker-API-Originating-Identity

使用者身分標頭是透過 API 來源身分標頭提供的。 此要求標頭包含使用者的「IBM Cloud IAM 身分」。 IAM 身分已 base64 進行編碼。IBM Cloud 支援單一驗證領域：IBMid。 IBMid 領域使用「IBM ID 唯一 ID (IUI)」來識別使用者在 IBM Cloud 中的身分。 此 IUI 對服務提供者來說是不可探知的字串。

範例：

X-Broker-API-Originating-Identity: ibmcloud eyJpYW1faWQiOiJJQk1pZC01MEdOUjcxN1lFIn0=
Decoded:
{"iam_id":"IBMid-50GNR717YE"}

API 版本標頭

API 版本標頭 是 2.12。 例如：X-Broker-Api-Version: 2.12。

資源實例 (PUT) body.context 及資源實例 (PATCH) body.context

PUT /v2/service_instances/:resource_instance_id 及 PATCH /v2/service_instances/:resource_instance_id 會在 body.context 內收到下列值：{ "platform": "ibmcloud", "account_id": "tracys-account-id", "crn": "resource-instance-crn" }。

使用非同步作業而不使用同步作業的建議

OSB API 支援同步及非同步作業模式。 如果您的作業將花費不到 10 秒，則必須使用同步回應。 否則，您必須使用非同步作業模式。 非同步模式需要 last_operation 端點。 如需相關資訊，請參閱 取得服務實例進行中佈建的狀態。

跨位置管理分配管理系統的建議

使用者必須瞭解其雲端服務的位置，查看是否會有延遲、可用性及資料常駐等問題。

當您在 IBM Cloud 上建立服務實例時，使用者必須提供的必填參數之一，就是他們希望建立該服務實例的位置。 某些服務支援在多個地點進行建立。 例如，資料庫服務可支援在所有 IBM Cloud 區域建立資料庫，或僅支援部分區域。

如果協力廠商 API 型服務實作在另一個雲端中，並公開至 IBM Cloud 中，則位置會指出服務在其他雲端中的位置。

在 IBM Cloud 上線時，您必須實作至少一個 OSB 分配管理系統。 您可以根據部署策略以及您要為服務提供支援的位置，實作多個分配管理系統。 在 Partner Center Sell 內，您可以建立定價方案與分配管理系統之間的對映。 常見的選擇包括：定義一個單一中介伺服器來為服務的所有據點提供服務，或是為每個據點分別定義一個中介伺服器；此選擇權取決於服務提供者。

如需可用位置的清單，請檢閱 IBM 廣域型錄位置。 若您的服務需要定義更多地點，IBM Cloud 請諮詢入職團隊。