All Products
Search
Document Center

Bastionhost:DescribeInstanceAttribute

Last Updated:Jan 31, 2023

Queries the attribute information about the specified bastion host. The information includes the ID and remarks of the bastion host.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringNo

The region ID of the bastion host to query.

cn-hangzhou
InstanceIdstringYes

The ID of the bastion host to query.

bastionhost-cn-78v1ghxxxxx

Response parameters

ParameterTypeDescriptionExample
object

The responses parameters.

RequestIdstring

The ID of the request, which is used to locate and troubleshoot issues.

082FAB35-6AB9-4FD5-8750-D36673548E76
InstanceAttributeobject

The attribute information about the bastion host.

VpcIdstring

The ID of the virtual private cloud (VPC) to which the bastion host belongs.

vpc-bp1c85tzgqu1bf5bxxxxx
VswitchIdstring

The ID of the vSwitch to which the bastion host belongs.

vsw-bp1xfwzzfti0kjbfxxxxx
Descriptionstring

The remarks of the bastion host.

Test API
ExpireTimelong

The time when the bastion host expires.

1578326400000
ModifyPasswordModulestring

The status of the automatic password change feature.

  • Enable
  • Disable
Enable
EniInstanceIdstring

The ID of the elastic network interface (ENI).

eni-bp1455jrzwm7moaxxxxx
InstanceIdstring

The ID of the bastion host.

bastionhost-cn-78v1ghxxxxx
InternetEndpointstring

The public endpoint of the bastion host.

drawvxalwb-public.bastionhost.aliyuncs.com
RegionIdstring

The ID of the region in which the bastion host resides.

cn-hangzhou
IntranetEndpointstring

The internal endpoint of the bastion host.

drawvxalwb.bastionhost.aliyuncs.com
StartTimelong

The time when the bastion host was purchased.

1577681345000
ResourceGroupIdstring

The ID of the resource group to which the bastion host belongs.

rg-aekzc427dbl2shy
NetworkProxyModulestring

The status of the network domain feature.

  • Enable
  • Disable
Enable
WebTerminalModulestring

The status of the web terminal.

  • Enable
  • Disable
Enable
DbOperationModulestring

The status of the database O&M feature.

Disable
InstanceStatusstring

The status of the bastion host. Valid values:

  • PENDING: The bastion host is not initialized.
  • CREATING: The bastion host is being created.
  • RUNNING: The bastion host is running.
  • EXPIRED: The bastion host expired.
  • CREATE_FAILED: The bastion host fails to be created.
  • UPGRADING: The configurations of the bastion host are being changed.
  • UPGRADE_FAILED: The configurations of the bastion host fail to be changed.
RUNNING
LicenseCodestring

The license code.

bhah_ent_50_asset
PublicNetworkAccessboolean

Indicates whether the bastion host can be accessed over the Internet.

true
Storagelong

The storage capacity of the bastion host.

2199023255552
Portsarray

An array that consists of the O&M ports of the bastion host.

object

The O&M port of the bastion host.

StandardPortinteger

The standard port of the bastion host. Valid values:

  • SSH: 60022
  • RDP: 63389
  • HTTPS: 443
60022
CustomPortinteger

The custom port.

Note: You can change only the SSH and RDP ports. If O&M ports are not specified, the value of the StandardPort parameter is returned.
600xx
PublicExportIpsarray

An array that consists of the egress public IP addresses of the bastion host.

string

The egress public IP address of the bastion host.

[10.162.168.xx/32]
PublicWhiteListarray

An array that consists of public IP addresses in a whitelist for the bastion host.

string

The public IP address that is added to the whitelist of the bastion host.

[10.162.168.xx/32]
AuthorizedSecurityGroupsarray

An array that consists of the IDs of authorized security groups.

string

The ID of the authorized security group.

[sg-bp14u00sh39jvw5xxxxx]
PrivateExportIpsarray

An array that consists of the egress private IP addresses of the bastion host.

string

The egress private IP address of the bastion host.

192.168.xx.xx
PublicIpsarray

An array that consists of the public IP addresses of the bastion host.

string

The public IP address of the bastion host.

116.62.xx.xx
SecurityGroupIdsarray

An array that consists of the IDs of the security groups to which the bastion host belongs.

string

The ID of the security group to which the bastion host belongs.

sg-bp15ed6xe1yxeycg7o****
PrivateWhiteListarray

An array that consists of private IP addresses in a whitelist for the bastion host.

string

The private IP address that is added to the whitelist of the bastion host.

192.168.xx.xx

Example

Normal return example

JSONFormat

{
  "RequestId": "082FAB35-6AB9-4FD5-8750-D36673548E76",
  "InstanceAttribute": {
    "VpcId": "vpc-bp1c85tzgqu1bf5bxxxxx",
    "VswitchId": "vsw-bp1xfwzzfti0kjbfxxxxx",
    "Description": "Test API\n",
    "ExpireTime": 1578326400000,
    "ModifyPasswordModule": "Enable",
    "EniInstanceId": "eni-bp1455jrzwm7moaxxxxx",
    "InstanceId": "bastionhost-cn-78v1ghxxxxx",
    "InternetEndpoint": "drawvxalwb-public.bastionhost.aliyuncs.com",
    "RegionId": "cn-hangzhou",
    "IntranetEndpoint": "drawvxalwb.bastionhost.aliyuncs.com",
    "StartTime": 1577681345000,
    "ResourceGroupId": "rg-aekzc427dbl2shy",
    "NetworkProxyModule": "Enable",
    "WebTerminalModule": "Enable",
    "DbOperationModule": "Disable",
    "InstanceStatus": "RUNNING",
    "LicenseCode": "bhah_ent_50_asset",
    "PublicNetworkAccess": true,
    "Storage": 2199023255552,
    "Ports": [
      {
        "StandardPort": 60022,
        "CustomPort": 0
      }
    ],
    "PublicExportIps": [
      "[10.162.168.xx/32]"
    ],
    "PublicWhiteList": [
      "[10.162.168.xx/32]"
    ],
    "AuthorizedSecurityGroups": [
      "[sg-bp14u00sh39jvw5xxxxx]"
    ],
    "PrivateExportIps": [
      "192.168.xx.xx"
    ],
    "PublicIps": [
      "116.62.xx.xx"
    ],
    "SecurityGroupIds": [
      "sg-bp15ed6xe1yxeycg7o****"
    ],
    "PrivateWhiteList": [
      "192.168.xx.xx"
    ]
  }
}

Error codes

For a list of error codes, visit the API error center.