DescribeInstances - 堡垒机

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DescribeInstances	要执行的操作。取值：DescribeInstances。
PageNumber	Integer	否	1	设置从返回结果的第几页开始显示查询结果。默认值为1，表示从第1页开始显示。
PageSize	Integer	否	10	设置分页查询时，每页显示的堡垒机实例的数量。默认值为10，表示每页显示10条堡垒机实例信息。
RegionId	String	否	cn-hangzhou	实例所在的地域ID。
InstanceStatus	String	否	RUNNING	堡垒机实例的状态。取值： PENDING：未初始化 CREATING：创建中 RUNNING：运行中 EXPIRED：已过期 CREATE_FAILED：创建失败 UPGRADING：变配中 UPGRADE_FAILED：变配失败
ResourceGroupId	String	否	rg-acfm26ougi****	堡垒机实例所在的企业资源组的ID。
InstanceId.N	String	否	2	堡垒机实例的ID。
Tag.N.Key	String	否	test	实例的标签键。
Tag.N.Value	String	否	testapi	实例的标签值。

返回数据


名称	类型	示例值	描述
TotalCount	Long	4	查询到的堡垒机实例的总数量。
RequestId	String	61D36C55-AAFC-4678-8FAD-34FEF9E7182E	本次调用请求的ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。
Instances	Array of Instance		查询到的堡垒机实例的列表。
VpcId	String	vpc-bp1c85tzgqu1bf5b****	堡垒机实例绑定的VPC ID。
VswitchId	String	vsw-bp1xfwzzfti0kjbf****	堡垒机实例绑定的交换机ID。
ImageVersion	String	3.0.0	堡垒机实例镜像的版本。
PlanCode	String	cloudbastion_ha	堡垒机实例的规格。取值： cloudbastion：基础版 cloudbastion_ha：企业双擎版
Description	String	测试API	堡垒机实例的备注信息。
ExpireTime	Long	1578326400000	堡垒机实例的到期的时间戳。单位为毫秒。
Legacy	Boolean	false	该堡垒机实例是否为旧版堡垒机实例。取值： true：表示V2和V3.1系列的堡垒机实例。 false：表示V3.2系列的堡垒机实例。
InstanceId	String	bastionhost-cn-78v1gh****	堡垒机的实例ID。
InternetEndpoint	String	drawvxalwb-public.bastionhost.aliyuncs.com	堡垒机实例的公网域名。
RegionId	String	cn-hangzhou	堡垒机实例所在的地域ID。
IntranetEndpoint	String	drawvxalwb.bastionhost.aliyuncs.com	堡垒机实例的私网域名。
StartTime	Long	1577681345000	堡垒机实例的购买或续费的时间戳。单位为毫秒。
ResourceGroupId	String	g-acfm26ougi****	堡垒机实例所在的企业资源组的ID。
InstanceStatus	String	RUNNING	堡垒机实例的状态。取值： PENDING：未初始化 CREATING：创建中 RUNNING：运行中 EXPIRED：已过期 CREATE_FAILED：创建失败 UPGRADING：变配中 UPGRADE_FAILED：变配失败
LicenseCode	String	bhah_ent_50_asset	堡垒机实例的许可Code。
PublicNetworkAccess	Boolean	true	公网是否可以访问该堡垒机实例。取值： true：公网可以访问该堡垒机 false：公网不可访问该堡垒机

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeInstances
&PageNumber=1
&PageSize=10
&RegionId=cn-hangzhou
&InstanceStatus=RUNNING
&ResourceGroupId=rg-acfm26ougi****
&InstanceId=["2"]
&Tag=[{"Key":"test","Value":"testapi"}]
&公共请求参数

正常返回示例

XML格式

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

<DescribeInstancesResponse>
    <TotalCount>4</TotalCount>
    <RequestId>61D36C55-AAFC-4678-8FAD-34FEF9E7182E</RequestId>
    <Instances>
        <VpcId>vpc-bp1c85tzgqu1bf5b****</VpcId>
        <VswitchId>vsw-bp1xfwzzfti0kjbf****</VswitchId>
        <ImageVersion>3.0.0</ImageVersion>
        <PlanCode>cloudbastion_ha</PlanCode>
        <Description>测试API</Description>
        <ExpireTime>1578326400000</ExpireTime>
        <Legacy>false</Legacy>
        <InstanceId>bastionhost-cn-78v1gh****</InstanceId>
        <InternetEndpoint>drawvxalwb-public.bastionhost.aliyuncs.com</InternetEndpoint>
        <RegionId>cn-hangzhou</RegionId>
        <IntranetEndpoint>drawvxalwb.bastionhost.aliyuncs.com</IntranetEndpoint>
        <StartTime>1577681345000</StartTime>
        <ResourceGroupId>g-acfm26ougi****</ResourceGroupId>
        <InstanceStatus>RUNNING</InstanceStatus>
        <LicenseCode>bhah_ent_50_asset</LicenseCode>
        <PublicNetworkAccess>true</PublicNetworkAccess>
    </Instances>
</DescribeInstancesResponse>

JSON格式

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

{
  "TotalCount" : 4,
  "RequestId" : "61D36C55-AAFC-4678-8FAD-34FEF9E7182E",
  "Instances" : [ {
    "VpcId" : "vpc-bp1c85tzgqu1bf5b****",
    "VswitchId" : "vsw-bp1xfwzzfti0kjbf****",
    "ImageVersion" : "3.0.0",
    "PlanCode" : "cloudbastion_ha",
    "Description" : "测试API",
    "ExpireTime" : 1578326400000,
    "Legacy" : false,
    "InstanceId" : "bastionhost-cn-78v1gh****",
    "InternetEndpoint" : "drawvxalwb-public.bastionhost.aliyuncs.com",
    "RegionId" : "cn-hangzhou",
    "IntranetEndpoint" : "drawvxalwb.bastionhost.aliyuncs.com",
    "StartTime" : 1577681345000,
    "ResourceGroupId" : "g-acfm26ougi****",
    "InstanceStatus" : "RUNNING",
    "LicenseCode" : "bhah_ent_50_asset",
    "PublicNetworkAccess" : true
  } ]
}

错误码

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