11.Конфигурация и управление сетью

1. Список сопоставлений портов

Адрес интерфейса:/v2/instance/listPortMapping

Метод запроса:POST

Тип данных запроса:application/json

Тип данных ответа:*/*,application/json

Поддерживаемая версия:v1.1.1

Описание интерфейса:

Получить правила проброса портов DNAT контейнера

Параметры запроса:

Имя параметра	Описание параметра	Местоположение	Обязательно ли	Тип данных	Описание
instanceUuids	uuid контейнера	body	true	list	Одна или несколько записей данных контейнера

Пример запроса:

POST "/openapi/v2/instance/listPortMapping"
body:
{
    "instanceUuids": [
        "f4d2fccea3e341dcba0bf0d6ec40455e","ae674f4546c74bf48c00c211334f214a"
    ]
}

Параметры ответа:

Имя параметра	Описание параметра	Тип	Описание
code	Код возврата	integer(int32)
message	Возвращаемое сообщение обработки	string
success	Признак успешности	boolean
result	Возвращаемый объект данных	list
uuid	id контейнера	string
portMappings	Список протоколов	list<object>
mappingId	id сопоставления	string
instanceIp	ip контейнера	string
instancePort	Исходный номер порта контейнера	integer
mappings		list<object>
id	id	string
publicIp	Публичный ip	string
publicPort	Публичный порт	string
isp	Оператор	string
ispType	Перечисление операторов	integer	1:China Mobile 2:China Unicom 4:China Telecom
idc	Машинный зал	string
protocol	Тип протокола	string
protocolType	Перечисление протоколов	integer	1:udp  2:tcp
description	Описание	string
timestamp	Временная метка	integer(int64)
traceId	ID обработки запроса	string

Пример ответа:

{
  "message": "操作成功！",
  "code": 200,
  "result": [
    {
      "uuid": "qishuo-jinhua-1-pt96wiqiundzlbwl",
      "portMappings": [
        {
          "mappingId": "fcd4181eb64d449aa1794701b473fb35",
          "instanceIp": "10.1.102.21",
          "instancePort": 10101,
          "protocol": "udp",
          "protocolType": 1,
          "description": "Firewall-config",
          "mappings": [
            {
              "id": "f59164f66f0e4cba8ea0a49b502a12e0",
              "publicIp": "61.153.100.190",
              "publicPort": 40398,
              "isp": "电信",
              "ispType": 4,
              "idc": "广州机房"
            },
            {
              "id": "a6909bbbb02a4c0180b193115a1ccb6d",
              "publicIp": "123.156.66.187",
              "publicPort": 40398,
              "isp": "联通",
              "ispType": 2,
              "idc": "广州机房"
            },
            {
              "id": "17d7b9a9a76f4297bc49f0f386f0bbb9",
              "publicIp": "117.147.181.162",
              "publicPort": 40398,
              "isp": "移动",
              "ispType": 1,
              "idc": "广州机房"
            }
          ]
        }
      ]
    }
  ],
  "timestamp": 1752145988534,
  "traceId": "C20250710191308534805"
}

2. Постраничный список публичных IP

Адрес интерфейса: /v1/network/snat/ip/page/list

Метод запроса:POST

Тип данных запроса:application/json

Тип данных ответа:*/*,application/json

Поддерживаемая версия:v2.5.0

Описание интерфейса:

Список публичных SNAT IP текущего пользователя в указанном проекте

Параметры запроса:

Имя параметра	Описание параметра	Местоположение	Обязательно ли	Тип данных	Описание
projectId	Id проекта	body	false	string	По умолчанию проект по умолчанию текущего пользователя
snatIpList	Список SNAT IP	body	false	list

Пример запроса, в фактическом запросе замените значения параметров:

POST "/openapi/v1/network/snat/ip/page/list"
body:
{
    "projectId":"7b5a664173f526309e43faf775f09d1d",
    "snatIpList":["112.10.12.89"]
}

Параметры ответа:

Имя параметра	Описание параметра	Тип	Описание
code	Код возврата	integer(int32)
message	Возвращаемое сообщение обработки	string
result	Возвращаемый объект данных	list<object>
nodeName	Название узла	string
ipList	Список SNAT IP	list<object>
bindNum	Количество привязок	integer
isp	Оператор	string
bindType	Тип привязки	integer	1:плата；2:контейнер
snatIp	SNAT IP	string
timestamp	Временная метка	integer(int64)
traceId	ID обработки запроса	boolean

Пример ответа:

{
    "message": "操作成功！",
    "code": 200,
    "result": [
        {
            "nodeName": "nashan1",
            "ipList": [
                {
                    "bindNum": 1,
                    "isp": "联通",
                    "bindType": 2,
                    "snatIp": "112.10.12.89"
                }
            ]
        }
    ],
    "timestamp": 1751625323436,
    "traceId": "C20250704183523436007"
}