Docs
api
Global Dynamic Acceleration(PathX)
DescribeGlobalSSHInstance

Get GlobalSSH Instance List - DescribeGlobalSSHInstance

Overview

Retrieve GlobalSSH instance list (pass instance ID to get individual instance information, no pass to get all instances under the project)

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is DescribeGlobalSSHInstance.Yes
PublicKeystringThe user’s public key can be obtained from ConsoleYes
SignaturestringUser signature generated based on public key and API command, see Signature AlgorithmYes

Request Parameters

Parameter NameTypeDescription InformationRequired
ProjectIdstringProject ID, such as org-xxxx. Please refer to GetProjectList interfaceYes
InstanceIdstringInstance ID, Unique Resource IdentifierNo

Response Field

Field NameTypeDescription InformationRequired
RetCodeintReturn status code. If it is 0, it means successful return. If it is not 0, it means failure.Yes
ActionstringOperation command name.Yes
MessagestringReturns an error message, providing detailed description when RetCode is non-zero.No
InstanceSetarray[GlobalSSHInfo]List of GlobalSSH instances, refer to the GlobalSSHInfo model for instance attributes.No

Data Model

GlobalSSHInfo

Field NameTypeDescription InformationRequired
InstanceIdstringInstance ID, Unique Resource IdentifierYes
InstanceTypestringEnumeration values: [“Enterprise”,“Basic”,“Free”,“Welfare”], representing Enterprise Edition, Basic Version, Free Version, and earlier public beta free version respectively.Yes
AcceleratingDomainstringThe acceleration domain name assigned by GlobalSSH.Yes
AreastringRegion of the IP being accessed by SSHYes
TargetIPstringThe origin IPv4 address accessed by SSH.Yes
RemarkstringNote InformationYes
PortintThe SSH port monitored by the origin server, RDP port for Windows systemYes
GlobalSSHPortintWhen InstanceType equals to Free, it is automatically assigned by the system and does not equal to the value of the source station Port. When InstanceType does not equal to Free, it is the same as the value of the source station Port.Yes
ChargeTypestringPayment cycle, such as Month, Year, Dynamic, etc.Yes
CreateTimeintResource Creation TimestampYes
ExpireTimeintResource Expiration TimestampYes
ExpirebooleanIs it expired?Yes
IPV6AccessbooleanIs EIP IPV6 access enabled, Flase: not enabledNo
ExtraDomainarray[string]List of other available acceleration domain names assigned by GlobalSSHNo
BandwidthPackageintglobalssh Ultimate Bandwidth Package SizeNo
ForwardRegionstringWhen the InstanceType is the Basic version, the specific assigned forwarding data center needs to be displayed.No
DomainStatusobjectAcceleration domain current availability detection result HashMap structure 0 indicates available, 1 indicates contamination.No

Example

Request Example

https://api.dezai.com/?Action=DescribeGlobalSSHInstance
&ProjectId=UjsPseDf
&InstanceId=djsjuLQU

Response Example

{
  "Action": "DescribeGlobalSSHInstanceResponse",
  "InstanceSet": [
    {
      "AcceleratingDomain": "muLRknRb",
      "Area": "rojJRrWD",
      "BandwidthPackage": 5,
      "ChargeType": "Year",
      "CreateTime": 4,
      "DomainStatus": {},
      "Expire": true,
      "ExpireTime": 7,
      "ExtraDomain": [
        "JSweMMIB"
      ],
      "ForwardRegion": "yBKumXLK",
      "GlobalSSHPort": 5,
      "IPV6Access": false,
      "InstanceId": "jUtFMSnm",
      "InstanceType": "ZpSbjafD",
      "Port": 2,
      "Remark": "mtRmapTE",
      "TargetIP": "OhMnFNvq"
    }
  ],
  "RetCode": 0
}