華為云計算 云知識 查詢監(jiān)聽器詳情ShowListenerga
查詢監(jiān)聽器詳情ShowListenerga

 

功能介紹

查詢監(jiān)聽器詳情。

調用方法

請參見如何調用API。

URI

GET /v1/listeners/{listener_id}

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

listener_id

String

監(jiān)聽器ID。

最小長度:1

最大長度:36

請求參數(shù)

表2 請求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。通過調用 IAM 服務獲取用戶Token接口獲?。憫㈩^中X-Subject-Token的值)。

響應參數(shù)

狀態(tài)碼: 200

表3 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

listener

ListenerDetail object

監(jiān)聽器實例。

request_id

String

請求ID。

表4 ListenerDetail

參數(shù)

參數(shù)類型

描述

id

String

監(jiān)聽器ID。

name

String

監(jiān)聽器名稱,取值范圍:1~64個字符之間,只能由數(shù)字、字母、中劃線和中文組成。

最小長度:1

最大長度:64

description

String

監(jiān)聽器的描述信息,取值范圍:0~255個字符之間,禁止輸入字符:<>。

最小長度:0

最大長度:255

protocol

String

監(jiān)聽的網(wǎng)絡傳輸協(xié)議類型。

枚舉值:

  • TCP

  • UDP

status

String

配置狀態(tài),取值:

  • ACTIVE:運行中

  • PENDING:待定

  • ERROR:錯誤

  • DELETING:正在刪除

枚舉值:

  • ACTIVE

  • PENDING

  • ERROR

  • DELETING

port_ranges

Array of PortRange objects

監(jiān)聽端口范圍列表。

數(shù)組長度:1 - 10

client_affinity

String

客戶端親和性,取值:

  • SOURCE_IP:按源IP保持會話。

  • NONE:關閉。

枚舉值:

  • SOURCE_IP

  • NONE

accelerator_id

String

全球加速 實例ID。

created_at

String

創(chuàng)建時間。

updated_at

String

更新時間。

domain_id

String

租戶ID。

frozen_info

FrozenInfo object

云服務或資源實例凍結信息。

tags

Array of ResourceTag objects

標簽列表。

表5 PortRange

參數(shù)

參數(shù)類型

描述

from_port

Integer

起始端口。

最小值:1

最大值:65535

to_port

Integer

結束端口。

最小值:1

最大值:65535

表6 FrozenInfo

參數(shù)

參數(shù)類型

描述

status

Integer

云服務或資源實例狀態(tài),取值:

  • 0:解凍/正常(云服務恢復正常)。

  • 1:凍結(資源和數(shù)據(jù)會保留,但租戶無法再正常使用云服務)。

  • 2:刪除/終止(資源和數(shù)據(jù)將清除)。

最小值:0

最大值:2

effect

Integer

在凍結/解凍操作下,取值:

  • 1(默認值):凍結可釋放。

  • 2:凍結不可釋放。

  • 3:凍結后不可續(xù)費。

最小值:1

最大值:3

缺省值:1

scene

Array of strings

更新云服務狀態(tài)的業(yè)務場景列表,取值:

  • ARREAR(默認值):欠費場景。為正常的運營業(yè)務場景,包括包周期資源到期、按需資源扣費失敗。

  • POLICE:公安凍結場景。

  • ILLEGAL:違規(guī)凍結場景。

  • VERIFY:客戶未實名認證凍結場景。

  • PARTNER:合作伙伴凍結(合作伙伴凍結子客戶資源)。

最大長度:16

表7 ResourceTag

參數(shù)

參數(shù)類型

描述

key

String

標簽鍵,規(guī)則:

  • 1.key不能為空,長度1~128個字符(中文也可以輸入128個字符)。

  • 2.可用 UTF-8 格式表示的字母(包含中文)、數(shù)字和空格,以及以下字符_ . : = + - @。

  • 3._sys_開頭屬于系統(tǒng)標簽,租戶不能輸入。

最小長度:1

最大長度:128

value

String

標簽值,規(guī)則:

  • 1.長度0~255個字符(中文也可以輸入255個字符)。

  • 2.可用 UTF-8 格式表示的字母(包含中文)、數(shù)字和空格,以及以下字符_ . : / = + - @。

  • 3.資源標簽值可以為空(empty or null)。

最小長度:0

最大長度:255

請求示例

查詢監(jiān)聽器詳情

GET https://{ga_endpoint}/v1/listeners/1b11747a-b139-492f-9692-2df0b1c87193

響應示例

狀態(tài)碼: 200

操作成功

{
  "listener" : {
    "id" : "1b11747a-b139-492f-9692-2df0b1c87193",
    "name" : "listenerName",
    "description" : "listener description",
    "protocol" : "TCP",
    "status" : "ACTIVE",
    "port_ranges" : [ {
      "from_port" : 4000,
      "to_port" : 4200
    } ],
    "client_affinity" : "SOURCE_IP",
    "accelerator_id" : "ac1bf54f-6a23-4074-af77-800648d25bc8",
    "created_at" : "2019-01-08T01:21:37.151Z",
    "updated_at" : "2019-01-08T01:21:37.151Z",
    "domain_id" : "99a3fff0d03c428eac3678da6a7d0f24",
    "frozen_info" : {
      "status" : 2,
      "effect" : 1,
      "scene" : [ "ARREAR", "POLICE" ]
    },
    "tags" : [ {
      "key" : "tagKey",
      "value" : "tagValue"
    } ]
  },
  "request_id" : "915a14a6-867b-4af7-83d1-70efceb146f9"
}

狀態(tài)碼

狀態(tài)碼

描述

200

操作成功

錯誤碼

請參見錯誤碼。