全部產品
Search

搜尋本產品

    Security Center：BindAuthToMachine

    文件中心

    Security Center：BindAuthToMachine

    更新時間：Jun 26, 2026

    伺服器綁定授權資訊。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-sas:BindAuthToMachine

    update

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Criteria

    string

    否

    設定搜尋資產的條件。該參數 JSON 格式，輸入參數時注意大小寫。

    說明

    支援使用資產的執行個體 ID、執行個體名稱、所屬 VPC ID、地域、公網 IP 位址等條件搜尋資產。您可以呼叫 DescribeCriteria 介面查詢支援的搜尋條件。

    [{"name":"riskStatus","value":"YES"},{"name":"internetIp","value":"1.2.XX.XX"}]
    LogicalExp

    string

    否

    設定多個搜尋條件間生效的邏輯關係。預設 OR，取值：

    • OR：表示多個條件間為或的關係。

    • AND：表示多個條件間為與的關係。

    OR
    BindAll

    boolean

    否

    是否全量綁定。預設 false，取值：

    • true：是

    • false：否。

    true
    AuthVersion

    integer

    否

    資產的授權版本。取值：

    • 6：防病毒版

    • 5：高級版

    • 3：企業版

    • 7：旗艦版

    • 10：增值服務版。

    6
    AutoBind

    integer

    否

    開啟自動綁定。取值：

    • 0：關閉

    • 1：開啟。

    1
    IsPreBind

    integer

    否

    是否預綁定操作。取值：

    • 0：否

    • 1：是

    說明

    開啟預綁定後，會在完成購買後自動為指定伺服器綁定對應版本的授權數。

    1
    PreBindOrderId

    integer

    否

    預綁定關聯的訂單編號。

    233016**0482
    NtmVersion

    string

    否

    預綁定關聯的訂單版本。取值：

    • level7：防病毒版

    • level3：高級版

    • level2：企業版

    • level8：旗艦版

    • level10：僅採購增值服務。

    level2
    Bind

    array

    否

    綁定的 UUID 集合。

    說明

    Bind 和 UnBind 不能同時為空。

    string

    否

    綁定的 UUID。

    說明

    您可以呼叫 DescribeCloudCenterInstances 介面取得此參數。

    44f9ee5a-e39d-46bb-833b-5fc2ff47****
    UnBind

    array

    否

    解綁的 UUID 集合。

    說明

    Bind 和 UnBind 不能同時為空。

    string

    否

    解除綁定的 UUID。

    說明

    您可以呼叫 DescribeCloudCenterInstances 介面取得此參數。

    3e3c9d79-2880-465d-9e1b-1bc2af7d****
    ResourceDirectoryAccountId

    integer

    否

    資源目錄成員帳號 ID（阿里雲帳號）。

    說明

    呼叫 DescribeMonitorAccounts 介面可以取得該參數。

    16670360956*****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    ResultCode

    integer

    綁定結果狀態碼。取值：

    • 0：成功

    • 1：參數錯誤

    • 2：缺少伺服器授權數

    • 3：缺少伺服器授權核數。

    2
    RequestId

    string

    本次呼叫請求的 ID，是由阿里雲為該請求生成的唯一識別碼，可用於排查和定位問題。

    23AD0BD2-8771-5647-819E-6BA51E212F80
    UnBindCount

    integer

    成功解綁伺服器數。

    1
    BindCount

    integer

    成功綁定伺服器數。

    1
    InsufficientEcsCount

    integer

    授權伺服器授權數不足的數量。

    1
    InsufficientCoreCount

    integer

    授權核數授權數不足的數量。

    1

    樣本

    正常返回樣本

    JSON格式

    {
  "ResultCode": 2,
  "RequestId": "23AD0BD2-8771-5647-819E-6BA51E212F80",
  "UnBindCount": 1,
  "BindCount": 1,
  "InsufficientEcsCount": 1,
  "InsufficientCoreCount": 1
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 MissingPreBindVersion The pre-bound version is missing.
    400 -101 Invalid parameter value.
    400 RdCheckNoPermission Resource directory account verification has no permission.
    500 ServerError ServerError
    500 RdCheckInnerError Resource directory account service internal error.
    403 NoPermission caller has no permission

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

    變更歷史

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