全部產品
Search

搜尋本產品

    Alibaba Cloud Linux：AuthDiagnosis

    文件中心

    Alibaba Cloud Linux：AuthDiagnosis

    更新時間：Sep 11, 2026

    本介面用於授權 SysOM 對本帳號下的 ECS 執行個體進行診斷，只有在呼叫本介面對特定的 ECS 進行授權後，才可以呼叫 InvokeDiagnosis 介面對其發起診斷。

    介面說明

    重要 診斷功能需要在 RAM 使用者下建立服務角色，呼叫本介面會自動檢查服務角色是否建立，如果服務角色不存在則會自動建立，這要求呼叫本介面的 RAM 使用者具有 ram:CreateServiceLinkedRole 權限

    呼叫本介面授權 SysOM 對 ECS 進行診斷有如下注意事項：

    • 一次授權有效期為 7 天，7 天之後授權會失效，需要再次呼叫本介面進行授權；

    • 呼叫本介面進行授權時如果 SysOM 服務連結角色（AliyunServiceRoleForSysom）不存在會自動建立，這要求呼叫本介面的 RAM 使用者具有 ram:CreateServiceLinkedRole 權限。

    • 呼叫本介面對特定執行個體進行授權，會自動給目標 ECS 執行個體加上標籤 sysom:diagnosis，SysOM 只允許對加了這個標籤的執行個體進行診斷。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    sysom:AuthDiagnosis

    none

    *全部資源。

    *

    		 無 無

    請求文法

    POST /api/v1/openapi/diagnosis/auth HTTP/1.1

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    body

    object

    否

    請求體參數。

    autoCreateRole

    boolean

    否

    自動建立角色。

    autoInstallAgent

    boolean

    否

    自動安裝 Agent。

    instances

    array<object>

    是

    授權診斷的機器清單。

    object

    否

    i-wz9gdv7qmdhntqmc4rjd
    instance

    string

    否

    執行個體 ID。

    i-wz9b9vucz1iubsz8sjqo
    region

    string

    否

    區域 ID。

    cn-hangzhou

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    回傳結果。

    code

    string

    狀態碼

    • code == Success 則代表授權成功；

    • 其他狀態碼代表授權失敗，授權失敗時檢視 message 欄位取得詳細的錯誤資訊；

    Success
    data

    any

    本介面沒有回傳資料。

    {}
    message

    string

    錯誤資訊

    • 如果 code == Success，則本欄位為空；

    • 否則本欄位包含請求錯誤資訊。

    SysomOpenAPIAssumeRoleException: EntityNotExist.Role The role not exists: acs:ram::xxxxx:role/aliyunserviceroleforsysom
    request_id

    string

    請求 RequestId。

    35F91AAB-5FDF-5A22-B211-C7C6B00817D0

    樣本

    正常返回樣本

    JSON格式

    {
  "code": "Success",
  "data": "{}",
  "message": "SysomOpenAPIAssumeRoleException: EntityNotExist.Role The role not exists: acs:ram::xxxxx:role/aliyunserviceroleforsysom",
  "request_id": "35F91AAB-5FDF-5A22-B211-C7C6B00817D0"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 SysomOpenAPI.NotSupportedAgentVersion Unsupported sysom agent version.

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。