调用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>
<InstanceId>i-bp14bnftyqhxg9ij****</InstanceId>
<UserData>ZWNobyBoZWxsbyBlY321ABC</UserData>
<RegionId>cn-hangzhou</RegionId>
</DescribeUserDataResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"InstanceId" : "i-bp14bnftyqhxg9ij****",
"UserData" : "ZWNobyBoZWxsbyBlY321ABC",
"RegionId" : "cn-hangzhou"
}错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的实例不存在，请您检查实例ID是否正确。 |
访问错误中心查看更多错误码。