查詢一台 ECS 執行個體的 自訂資料。

描述

  • 返回的執行個體自訂資料將以 Base 64 編碼的方式顯示。
  • 如果執行個體不存在自訂資料，則返回空值。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：DescribeUserdata
RegionId String 是 執行個體所屬的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
InstanceId String 是 要查詢的執行個體 ID。

返回參數

名稱 類型 描述
UserData String 執行個體的自訂資料，並以 Base 64 編碼方式的方式顯示
InstanceId String 執行個體Id
RegionId String 地域 ID

樣本

請求樣本 
https://ecs.aliyuncs.com/?Action= DescribeUserdata
&RegionId=cn-shenzhen
&InstanceId=i-instance1
&<公共請求參數>

https://ecs.example.com/?Action= DescribeUserdata
&RegionId=cn-shenzhen
&InstanceId=i-instance1
&<公共請求參數>
返回樣本

XML 格式

<DescribeUserdataResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <UserData>userdata1</UserData>
    <InstanceId> i-instance1</InstanceId>
    <RegionId> cn-shenzhen </RegionId>
</DescribeUserdataResponse>
JSON 格式 
{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
    " UserData ": " userdata1"
    " InstanceId ": " i-instance1"
    " RegionId": "cn-shenzhen"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
InvalidRegionId.NotFound The specified RegionId does not exist. 404 指定的 RegionId 不存在。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的 InstanceId 不存在。