設定帳戶設定

您可以設定 IBM Cloud Logs Routing 帳戶設定，以定義在您的帳戶中收集、路由和管理平台日誌的位置和方式。您可以透過 UI 執行，或使用 CLI、REST API V3 或 Terraform 腳本。

當您設定或修改 IBM Cloud Logs Routing 帳戶設定時，請考慮下列資訊：

每次修改 IBM Cloud Logs Routing 帳戶設定時，新請求中傳遞的資料會取代任何現有的設定資料。您必須確保在執行帳戶設定更新時，不會刪除任何現有資料，方法是將這些資料包含在新請求中。

在透過設定 --private-api-endpoint-only TRUE 停用公用端點之前，請確定您的帳號可以存取私人端點。您可以執行指令 ibmcloud account show. 如果 VRF Enabled 是 true，而 Service Endpoint Enabled 是 true，那麼您就可以存取私有端點。如果您無法存取私人端點，就無法重新啟用公用端點，因為重新啟用公用端點需要私人端點存取權。

您可以使用私有端點和公用端點來管理設定。如需有關 ENDPOINTS 可用清單的詳細資訊，請參閱端點。

透過私人網路，您必須使用格式如下的 API 端點：https://api.private.<region>.logs-router.cloud.ibm.com
透過公共網路，您必須使用格式如下的 API 端點：https://api.<region>.logs-router.cloud.ibm.com

透過 IBM Cloud Logs Routing 帳戶設定，您可以設定哪些資料？

您可以定義以下任何資訊：

IBM Cloud 帳戶中儲存 IBM Cloud Logs Routing 帳戶組態元資料的位置。

我們所說的元資料，是指在任何區域的帳戶中都可使用的目標/路由/設定資料。

您可以選擇任何可使用 IBM Cloud Logs Routing 的支援位置。如需詳細資訊，請參閱地點。

您可以選擇儲存元資料的位置。您也可以設定儲存元資料的備份位置，以便復原。

考慮任何公司或產業的合規要求，例如金融服務驗證地點或歐盟管理區域。

在建立目標和路由之前，您必須先設定主要元資料區域，以確保組態符合您的法規需求。
允許在帳戶中管理 IBM Cloud Logs Routing 帳戶組態的端點類型。

預設情況下，公共端點和私人端點都已啟用。

您可以設定您的帳戶，限制只能透過私人端點進行管理。
帳戶管理員可以定義收集記錄目標的位置。

您可以選擇任何可使用 IBM Cloud Logs Routing 的支援位置。如需詳細資訊，請參閱地點。

考慮任何公司或產業的合規要求，例如金融服務驗證地點或歐盟管理區域。
預設目標位置，也就是帳戶中的 1 個或多個目標，會從您未設定收集記錄方式的支援 IBM Cloud Logs Routing 位置收集記錄。

如果您定義超過 1 個目標，所有預設目標都會得到一份沒有路由規則指示在帳戶中傳送位置的日誌。每個帳戶最多可以定義 2 個預設目標。
IBM Cloud Logs Routing 帳戶中已啟用的 API 版本。有效值為：1 或 3。

IAM 權限

確保您有正確的 IAM 權限來設定 IBM Cloud Logs Routing 設定。

使用使用者介面管理設定

您可以使用 IBM Cloud Logs Routing UI 管理您的設定定義。如需詳細資訊，請參閱設定帳戶設定。

CLI 指令

下表列出您可以執行以管理設定的動作：

使用 IBM Cloud Logs Routing CLI 進行設定動作
動作	指令
取得設定資訊	`ibmcloud logs-router setting get`
更新設定	`ibmcloud logs-router setting update`

如需詳細資訊，請參閱 IBM Cloud Logs Routing CLI。

API 方法

下表列出您可以執行以管理設定的動作：

使用 IBM Cloud Logs Routing REST API 進行設定動作
動作	REST API 方法	API_URL
取得設定資訊	`GET`	`<ENDPOINT>/v3/settings`
更新設定	`PATCH`	`<ENDPOINT>/v3/settings`

您可以使用私有端點和公用端點來管理目標。如需有關 ENDPOINTS 可用清單的詳細資訊，請參閱端點。

您可以使用格式如下的 API 端點從私人網路管理目標：https://api.private.REGION.logs-router.cloud.ibm.com
您可以使用格式如下的 API 端點從公共網路管理目標：https://api.REGION.logs-router.cloud.ibm.com

如需 REST API 的詳細資訊，請參閱設定 API。

HTTP 回應碼

當您使用 IBM Cloud Logs Routing REST API 時，您可以取得標準的 HTTP 回應代碼，以表示方法是否成功完成。

200 回應總是表示成功。
4xx 回應表示失敗。
5xx 回應通常表示內部系統錯誤。

請參閱下表中的一些 HTTP 回應代碼：

HTTP 回應代碼清單
狀態碼	狀態	說明
`200`	OK	已順利完成要求。
`201`	OK	已順利完成要求。建立資源。
`400`	要求不正確	該請求未成功。您可能遺漏了一個必要的參數。
`401`	未獲授權	API 請求中使用的 IAM 令牌無效或過期。
`403`	禁止	由於權限不足，該操作被禁止。
`404`	找不到	請求的資源不存在或已被刪除。
`409`	衝突	請求資料與系統中的資源狀態有衝突。
`429`	太多要求	太多的請求過快地撞擊 API。
`500`	內部伺服器錯誤	發生錯誤。您的要求無法處理。請稍後重試。如果問題仍然存在，請記下回應標頭中的 transaction-id 並聯繫 IBM Cloud 支援。