调用DescribeUserData查询一台ECS实例的自定义数据。

接口说明

  • 返回的实例自定义数据将以Base64编码的方式显示。
  • 如果实例不存在自定义数据,则返回空值。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeUserData

系统规定参数。取值:DescribeUserData

RegionId String cn-hangzhou

实例所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

InstanceId String i-bp14bnftyqhxg9ij****

要查询的实例ID。

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

InstanceId String i-bp14bnftyqhxg9ij****

实例ID。

UserData String ZWNobyBoZWxsbyBlY321ABC

实例的自定义数据。

RegionId String cn-hangzhou

地域ID。

示例

请求示例

https://ecs.aliyuncs.com/?Action= DescribeUserdata
&RegionId=cn-shenzhen
&InstanceId=i-bp14bnftyqhxg9ij****
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeUserdataResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <UserData>ZWNobyBoZWxsbyBlY321ABC</UserData>
    <InstanceId>i-bp14bnftyqhxg9ij****</InstanceId>
    <RegionId>cn-shenzhen</RegionId>
</DescribeUserdataResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  " UserData " : "ZWNobyBoZWxsbyBlY321ABC",
  " InstanceId " : "i-bp14bnftyqhxg9ij****",
  " RegionId" : "cn-shenzhen"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. 指定的实例不存在,请您检查实例ID是否正确。

访问错误中心查看更多错误码。