Docs
api
Cloud Network(UGN)
DescribeSimpleUGN

Get Simplified UGN Details - DescribeSimpleUGN

Overview

Get Simplified UGN Details

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is DescribeSimpleUGN.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. If not filled in, the default project is used, sub-accounts must be filled in. Please refer to the GetProjectList interface.No
UGNIDstringUGN IDYes

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
UGNUGNYes
Networksarray[SimpleNetwork]Yes
BwPackagesarray[SimpleBwPackage]Yes
Routesarray[SimpleRoute]Yes

Data Model

UGN

Field NameTypeDescription InformationRequired
UGNIDstringUGN Resource IDYes
NamestringUGN NameYes
RemarkstringUGN NotesYes
CreateTimeintCreation Time of Cloud NetworkYes
NetworkCountintAssociated Network Instance QuantityYes
BwPackageCountintNumber of Bound Bandwidth PackagesYes

SimpleNetwork

Field NameTypeDescription InformationRequired
RegionstringRegion of the Network InstanceYes
NetworkIDstringID of the network instance, such as vnet-xxxxxYes
NamestringNetwork Instance NameYes
TypestringNetwork Instance Type: VPC/HybridGW/…Yes
OrgNamestringProject name where the network instance is locatedYes
RegionIDintRegion ID of the network instanceNo
OrgIDintID of the project where the network instance is locatedNo
CreateTimeintNo

SimpleBwPackage

Field NameTypeDescription InformationRequired
PackageIDstringYes
UGNIDstringYes
PayModestringBilling Mode FixedBw: Fixed Bandwidth | Peak95: Classic 95 | Max5: Fifth Peak | Traffic: Traffic BillingYes
RegionAstringRegion A NameYes
RegionBstringRegion B NameYes
BandWidthfloatBandwidth ValueYes
QosstringService Quality
Diamond: Diamond | Platinum: Platinum | Gold: Gold
Yes
PathstringIntelligent Path
Delay: Minimum Delay | IGP: Regular Route | TCO: Lowest Cost
Yes
CreateTimeintCreation TimeYes
NamestringNo
RemarkstringNo
ExpireTimeintExpiration TimeNo
ChangeStatusintBandwidth Package Switch StatusNo
ChangeTimeintBandwidth Package Switching TimeNo
ChangePayModestringSwitch Billing Type for Bandwidth PackageNo

SimpleRoute

Field NameTypeDescription InformationRequired
DstAddrstringDestination SegmentNo
NextHopIDstringNext Hop Network Instance IDNo
NextHopTypestringNext hop network instance typeNo
NextHopRegionstringRegion of the next hop network instanceNo
NextHopRegionIDintRegion id of the next hop network instanceNo
PriorityintRouting PriorityNo
DenybooleanInvalid due to hitting routing policyNo
Restrictbooleantrue: Invalid due to lower priority than other routes with the same prefixNo
Conflictbooleantrue: Invalid due to the same priority but later insertion into the database than other routes with the same prefix.No
InPolicyIdstringInbound routing policy id in matchNo
InPolicyNamestringInbound routing policy name in matchNo
OutPolicyIdstringOutgoing routing policy id in matchNo
OutPolicyNamestringName of the outbound routing policy in matchNo

Example

Request Example

https://api.dezai.com/?Action=DescribeSimpleUGN
&ProjectId=GoyMEaqI
&UGNID=BqXFlXPM

Response Example

{
  "Action": "DescribeSimpleUGNResponse",
  "BwPackages": [
    {
      "ChangePayMode": "pcnbFlpQ",
      "ChangeStatus": 6,
      "ChangeTime": 1,
      "CreateTime": 5,
      "ExpireTime": 9,
      "IsCrossBorder": true,
      "Message": "upqtoHLo",
      "Name": "BIueGIVJ",
      "PackageID": "vjpUMeWg",
      "Path": "TCO|IGP|Delay",
      "PayMode": "Free|SolidBw|Peak95|Max5|Traffic",
      "Qos": "金|银|铜",
      "RegionA": "dxBALSbx",
      "RegionABwMax": 8,
      "RegionABwMin": 5,
      "RegionB": "OTEAkkrX",
      "RegionBBwMax": 9,
      "RegionBBwMin": 6,
      "Remark": "xLwRqlaF",
      "UGNID": "IokLUMlQ"
    }
  ],
  "Message": "ekWmsxEt",
  "Networks": [
    {
      "NICs": [
        {
          "IP": "mDJBSJNd",
          "Mac": "vaxygoWB"
        }
      ]
    }
  ],
  "Policies": [
    "mgWCSWoN"
  ],
  "RetCode": 0,
  "Routes": [
    {
      "DstAddr": "MnPDhhax",
      "NexthopID": "TCwWNQyx",
      "NexthopRegion": "PzANTsVh",
      "NexthopRegionID": 1,
      "NexthopType": "NKCXpCxj",
      "Priority": 4
    }
  ],
  "UGN": {}
}