Yandex Cloud
Поиск
Связаться с экспертомПопробовать бесплатно
  • Кейсы
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
  • Marketplace
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Искусственный интеллект
    • Безопасность
    • Инструменты DevOps
    • Бессерверные вычисления
    • Управление ресурсами
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Калькулятор цен
    • Тарифы
    • Акции и free tier
  • Кейсы
  • Документация
  • Блог
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ООО «Яндекс.Облако»
Yandex Cloud Interconnect
    • Обзор сервиса
    • Обзор операций
    • Терминология
    • Точки присутствия
    • Трансиверы
    • Транковое подключение
    • Приватное соединение
    • Публичное соединение
    • Партнеры CIC
    • Мониторинг
    • Объемы данных и емкости подключений
    • Квоты и лимиты
  • Правила тарификации
  • Управление доступом
    • Аутентификация в API
      • Overview
        • Overview
        • Get
        • List
  • История изменений

В этой статье:

  • gRPC request
  • GetPublicConnectionRequest
  • PublicConnection
  • Peering
  1. Справочник API
  2. gRPC (англ.)
  3. PublicConnection
  4. Get

Cloud Interconnect API, gRPC: PublicConnectionService.Get

Статья создана
Yandex Cloud
Улучшена
Tania L.
Обновлена 24 апреля 2025 г.
  • gRPC request
  • GetPublicConnectionRequest
  • PublicConnection
  • Peering

Returns the specified PublicConnection resource.

To get the list of available PublicConnection resources, make a List request.

gRPC requestgRPC request

rpc Get (GetPublicConnectionRequest) returns (PublicConnection)

GetPublicConnectionRequestGetPublicConnectionRequest

{
  "public_connection_id": "string"
}

Field

Description

public_connection_id

string

Required field. ID of the PublicConnection resource to return.
To get the publicConnection ID use a PublicConnectionService.List request.

PublicConnectionPublicConnection

{
  "id": "string",
  "name": "string",
  "description": "string",
  "folder_id": "string",
  "region_id": "string",
  "trunk_connection_id": "string",
  "vlan_id": "google.protobuf.Int64Value",
  "ipv4_peering": {
    "peering_subnet": "string",
    "peer_ip": "string",
    "cloud_ip": "string",
    "peer_bgp_asn": "int64",
    "cloud_bgp_asn": "int64",
    "peer_bgp_md5_key": "string"
  },
  "ipv4_allowed_service_types": [
    "CloudServiceType"
  ],
  "ipv4_peer_announced_prefixes": [
    "string"
  ],
  "labels": "map<string, string>",
  "status": "Status",
  "created_at": "google.protobuf.Timestamp"
}

A PublicConnection resource.

Field

Description

id

string

ID of the publicConnection.

name

string

Name of the publicConnection.
The name must be unique within the folder.
Value must match the regular expression ``\

a-zA-Z?``.

description

string

Optional description of the publicConnection. 0-256 characters long.

folder_id

string

ID of the folder that the publicConnection belongs to.

region_id

string

ID of the region that the publicConnection belongs to.

trunk_connection_id

string

ID of the trunk_connection that the publicConnection belongs to.

vlan_id

google.protobuf.Int64Value

VLAN_ID that the privateConnection uses in multiplexing.
Not used in connections over partners-II
Value range: [1, 4095]

ipv4_peering

Peering

IPv4 peering config of connection

ipv4_allowed_service_types[]

enum CloudServiceType

Cloud services that the publicConnection connects to.

  • CLOUD_SERVICE_TYPE_UNSPECIFIED
  • CLOUD_SERVICE_YANDEX
  • CLOUD_SERVICE_ALL_PUBLIC
  • CLOUD_SERVICE_S3
  • CLOUD_SERVICE_ML
  • CLOUD_SERVICE_APIGW
  • CLOUD_SERVICE_CONTAINER_REGISTRY
  • CLOUD_SERVICE_CONSOLE
  • CLOUD_SERVICE_MONITORING
  • CLOUD_SERVICE_YANDEX_GPT
  • CLOUD_SERVICES_ALL_API_ENDPOINT
  • CLOUD_SERVICE_YMQ

ipv4_peer_announced_prefixes[]

string

IPv4 Peer Announced Prefixes
It's an list of ip with format ipPrefix/length where address part of ipPrefix is 0

labels

object (map<string, string>)

Resource labels, key:value pairs.
No more than 64 per resource.
The maximum string length in characters for each value is 63.
Each value must match the regular expression [-_0-9a-z]*.
The string length in characters for each key must be 1-63.
Each key must match the regular expression [a-z][-_0-9a-z]*.

status

enum Status

Status of the publicConnection.

  • STATUS_UNSPECIFIED
  • CREATING
  • UPDATING
  • DELETING
  • ACTIVE

created_at

google.protobuf.Timestamp

Creation timestamp in RFC3339 text format.

PeeringPeering

Field

Description

peering_subnet

string

PeeringSubnet.
It's an ip with format ipPrefix/length where address part of ipPrefix is 0.

peer_ip

string

PeerIp.
It's an ip with just an ipAddress format without mask.

cloud_ip

string

CloudIp.
It's an ip with just an ipAddress format without mask.

peer_bgp_asn

int64

PeerBgpAsn.
PeerAsn excluding rfc5398 (excluding 64496 - 64511 and 65536 - 65551).

cloud_bgp_asn

int64

CloudBgpAsn.

peer_bgp_md5_key

string

PeerBgpMd5Key.
Optional.

Была ли статья полезна?

Предыдущая
Overview
Следующая
List
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ООО «Яндекс.Облако»