Press CTRL+K to open search

Configuration API - updateSocketInterface

  • 업데이트 날짜 Jul 30, 2026
  • 에 게시됨 Jul 12, 2026
  • 4 읽은 시간(초)
Prev Next

Cato API 지원 정책을 사용하기 전에 반드시 검토하시기 바랍니다.

updateSocketInterface 개요

Cato 관리 애플리케이션의 Socket 섹션에서 사이트에 대한 다음 Socket 인터페이스 설정을 업데이트하려면 updateSocketInterface mutation API를 사용하세요 (Network > Sites > {site name} > Site Configuration > Socket)

  • 인터페이스의 대상

  • 이름

  • LAN 인터페이스 설정

  • 사이트 대역폭

  • WAN 인터페이스 설정

  • 오프 클라우드 (Cato 대상용)

  • 대체 WAN 인터페이스 설정

  • LAG (링크 집합) 멤버

  • VRRP 유형

사이트에 대한 siteID 찾기

Cato 관리 애플리케이션에서는 site ID가 표시되지 않습니다. site ID를 찾을 수 있는 방법:

  • entityLookup API 쿼리를 사용하여 (Cato API - EntityLookup 참조), type을 site 값으로 설정합니다.

    site의 이름을 값으로 하여 search 매개변수도 사용할 수 있으며 쿼리는 site ID를 반환합니다.

  • 사이트를 선택했을 때 Cato 관리 애플리케이션의 URL에 표시되는 숫자 (Network > Sites > {site name}). 예를 들어, 다음 URL에서 사이트 ID는 12345입니다: https://cc.catonetworks.com/#/26/sites/12345/networkAnalytics

Socket의 socketInterfaceId 값 이해하기

socketInterfaceId는 Cato 소켓의 값을 포함하는 enum입니다. 인터페이스 이름은 사이트의 소켓 화면에 다음과 같이 표시됩니다 (Network > Sites > {site name} > Site Configuration > Socket):

  • X1500 소켓 - 자동, LAN1, LAN2, WAN1, WAN2, WAN3, USB1, USB2

  • X1600 소켓 - 1-8, USB1, USB2

  • X1700 소켓 - INT_1 - INT_12

updateSocketInterfaceInput 인수의 세부사항

이는 Cato 구성 API를 사용하여 사이트에 대한 다음 Socket 인터페이스 설정을 업데이트하기 위한 인수입니다. destType 인수만 필수이며, 그렇지 않으면 업데이트하는 Socket 인터페이스 설정의 인수를 포함하십시오.

  • destType - 인터페이스의 대상

  • name - 사이트의 이름

  • lan - LAN 인터페이스 설정

  • bandwidth - 사이트 상향 및 하향 대역폭

  • wan - WAN 인터페이스 설정

  • offCloud - Cato를 대상으로 하는 인터페이스에 대한 오프 클라우드 설정

  • altWAN - 대체 WAN 또는 대체 WAN (레이어-2)를 대상으로 하는 인터페이스에 대한 설정

  • lag - LAN LAG 마스터 목적지에 대해 이 링크 집합 (LAG)의 최소 링크 수 (마스터 및 멤버 포함)

  • vrrp - 소켓 고가용성 (HA) 구성을 위한 소켓 간의 VRRP 연결 유형

updateSocketInterfaceInput destType

destType은 인터페이스의 대상을 정의하는 enum 인수입니다.

다음은 가능한 옵션입니다:

  • CATO - Cato 클라우드를 위한 WAN 트래픽

  • LAN - 소켓 뒤의 내부 LAN

  • VRRP_AND_LAN - 소켓 HA를 위해 인터페이스가 LAN 및 VRRP 트래픽에 사용됩니다.

  • INTERFACE_DISABLED - 인터페이스가 비활성화되었으며 트래픽을 전달하지 않습니다.

  • ALTERNATIVE - Cato 클라우드를 통하지 않는 WAN 트래픽, 예: MPLS

  • LAYER_2_WAN - 소켓 사이트가 동일한 서브넷에 있는 MPLS 네트워크에 대한 대체 WAN (레이어-2) 옵션

  • VRRP - 소켓 HA를 위해 인터페이스가 VRRP 트래픽만을 위해 사용됩니다.

  • LAN_LAG_MASTER_AND_VRRP - 소켓 HA 및 LAN LAG 구성을 위해 인터페이스가 LAN LAG 마스터이며 VRRP 트래픽에 사용됩니다.

  • LAN_LAG_MASTER - LAN LAG 구성을 위해 인터페이스가 LAN LAG 마스터입니다.

  • LAN_LAG_MEMBER - LAN LAG 구성을 위해 인터페이스가 LAN LAG 멤버입니다.

  • LAN_AND_HA - Azure와 AWS에서 vSocket HA를 위해 인터페이스가 LAN 및 HA 트래픽에 사용됩니다.

updateSocketInterfaceInput name

name 인수는 소켓 인터페이스의 이름을 위한 것입니다.

updateSocketInterfaceInput lan

lan 인수는 소켓의 LAN 인터페이스에 대한 설정을 위한 것입니다.

다음은 가능한 옵션입니다:

  • subnet - CIDR 형식의 LAN 인터페이스에 대한 기본 범위

  • localIP - LAN 네트워크 범위의 로컬 IP 주소

updateSocketInterfaceInput bandwidth

WAN 트래픽에 사용되는 인터페이스의 경우, bandwidth 인수는 인터페이스의 업스트림 및 다운스트림 대역폭을 정의합니다.

다음은 가능한 옵션입니다:

  • upstreamBandwidth - 이 인터페이스의 최대 상향 대역폭

  • downstreamBandwidth - 이 인터페이스의 최대 하향 대역폭

updateSocketInterfaceInput wan

wan 인자는 소켓의 WAN 인터페이스 설정용입니다. WAN 역할은 일반적으로 네트워크 규칙에서 트래픽을 정의하는 데 사용됩니다. 우선순위는 활성 및 수동 인터페이스가 있는 소켓의 장애 조치 우선순위에 사용됩니다.

다음은 가능한 옵션입니다:

  • role - WAN 인터페이스의 역할을 정의합니다: 없음, 자동, wan_1, wan_2, wan_3

  • precedence - 인터페이스의 장애 조치 우선순위를 정의합니다: ACTIVE, PASSIVE, LAST_RESORT

    LAST_RESORT는 가장 낮은 우선순위의 인터페이스입니다.

updateSocketInterfaceInput offCloud

offCloud 인자는 트래픽을 카토 클라우드 대신 공용 인터넷을 통해 라우팅하기 위해 오프 클라우드 기능을 사용하는 소켓 사이트용입니다.

다음은 가능한 옵션입니다:

  • enabled - Boolean 값, true이면 사이트의 오프 클라우드 트래픽이 활성화됩니다.

  • publicIP (선택 사항) - 인터넷 연결을 시작하기 위한 정적 공인 IP 주소를 정의합니다.

  • publicStaticPort (선택 사항) - 오프 클라우드 트래픽용 정적 포트 번호를 정의합니다.

updateSocketInterfaceInput altWan

altWan 인자는 MPLS와 같은 대체 WAN 네트워크에 연결하는 소켓 사이트용입니다. 일반적으로, 개인 IP 및 인터페이스가 MPLS 공급업체에 직접 연결하는 데 사용됩니다.

다음은 가능한 옵션입니다:

  • privateInterfaceIp - 트래픽을 위한 소켓 인터페이스의 개인 IP 주소

  • privateNetwork - LAN을 위한 개인 IP 범위(CIDR 포함)

  • privateGatewayIp - 대체 WAN 게이트웨이(MPLS 방화벽 또는 라우터 등)의 개인 IP 주소

  • privateVlanTag (선택 사항) - 인터페이스(개인 IP 주소)를 위한 VLAN 태그

  • publicInterfaceIP (선택 사항) - 트래픽을 위한 소켓 인터페이스의 공인 IP 주소

  • publicNetwork (선택 사항) - LAN을 위한 공인 IP 범위(CIDR 포함)

  • publicGatewayIp (선택 사항) - 대체 WAN 게이트웨이(MPLS 방화벽 또는 라우터 등)의 공인 IP 주소

  • publicVlantag (선택 사항) - 인터페이스(공인 IP 주소)를 위한 VLAN 태그

updateSocketInterfaceInput lag

lag 인자는 마스터 LAN LAG 인터페이스용이며 이 소켓 사이트의 LAG를 위한 최소 인터페이스 수(마스터 및 멤버 포함)를 정의합니다.

이것은 옵션입니다:

  • minLinks - LAG의 최소 인터페이스(링크) 수

updateSocketInterfaceInput vrrp

vrrp 열거형 인자는 소켓 HA 구성용이며 소켓 간 키프얼라이브 메시지를 위한 VRRP 연결 유형을 정의합니다.

다음은 가능한 옵션입니다:

  • VIA_SWITCH - VRRP 연결은 소켓들 사이의 스위치를 통해 라우팅됩니다.

  • DIRECT_LINK - VRRP 연결은 소켓들 간에 직접 라우팅됩니다.

샘플 포스트맨 스크립트

샘플 스크립트 - 네이티브 범위와 이름 업데이트

이것은 구성 API를 사용하여 LAN1 인터페이스의 이름을 LAN-01로 변경하고 소켓의 네이티브 범위를 위한 서브넷 및 로컬 IP를 업데이트하는 예입니다.

mutation updateSocketInterface ($accountId: ID!, $siteId: ID!, $socketInterfaceId: SocketInterfaceIDEnum!, $input: UpdateSocketInterfaceInput!) {
    site(accountId: $accountId) {
        updateSocketInterface (siteId: $siteId, socketInterfaceId: $socketInterfaceId, input: $input) {
            siteId
            socketInterfaceId
        }
    }
}

GraphQL 변수

{
    "accountId": "26",
    "siteId": 26,
    "socketInterfaceId": "LAN1",
    "input": {
        "name": "LAN-01",
        "destType": "LAN",
        "lan": {
            "subnet": "10.0.0.0/24",
            "localIp": "10.0.0.1"
        }
    }
}

샘플 스크립트 - 대역폭과 이름 변경

이것은 구성 API를 사용하여 WAN 인터페이스의 대역폭과 이름을 변경하는 예입니다.

mutation updateSocketInterface ($accountId: ID!, $siteId: ID!, $socketInterfaceId: SocketInterfaceIDEnum!, $input: UpdateSocketInterfaceInput!) {
    site(accountId: $accountId) {
        updateSocketInterface (siteId: $siteId, socketInterfaceId: $socketInterfaceId, input: $input) {
            siteId
            socketInterfaceId
        }
    }
}

GraphQL 변수

{
    "accountId": "26",
    "siteId": 126,
    "socketInterfaceId": "WAN1",
    "input": {
        "name": "WAN Demo",
        "destType": "CATO",
        "bandwidth": {
            "upstreamBandwidth": 100,
            "downstreamBandwidth": 100
        }
    }
}

관련 기사