Press CTRL+K to open search

구성 API - updateHa

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

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

updateHa 개요

Cato 관리 응용프로그램(Network > Sites > {site name} > Site Configuration > Socket)에서 Socket 고가용성(HA) 구성과 함께 사이트의 Socket 섹션의 다음 설정을 업데이트 하기 위해 updateHa 변이 API를 사용하세요.

  • 기본 및 보조 Socket의 관리 IP 주소

  • VRID - 기본 Socket이 다운되었을 때와 다시 작동할 때를 식별하는 VRRP 메시지의 ID

참고：

updateHa API는 두 소켓이 사이트에 할당되고 Cato 관리 애플리케이션을 사용하여 소켓 HA 사이트로 구성된 후에만 실행할 수 있습니다.

사이트에 대한 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

updateHa 매개변수 세부 정보

Cato 구성 API를 사용하여 사이트의 다음 HA Socket 설정을 업데이트하기 위한 매개변수들입니다. 모든 updateHaInput 매개변수는 선택적입니다:

  • primaryManagementIp - 기본 Socket의 관리 IP 주소

  • secondaryManagementIp- 보조 Socket의 관리 IP 주소

  • VRID - VRRP 메시지의 가상 라우터 식별자

updateHaInput primaryManagementIp

기본 Socket의 관리 IP 주소를 업데이트합니다. 이 IP 주소를 사용하여 기본 Socket의 WebUI에 액세스할 수 있습니다.

updateHaInput secondaryManagementIp

보조 Socket의 관리 IP 주소를 업데이트합니다. 이 IP 주소를 사용하여 보조 Socket의 WebUI에 액세스할 수 있습니다.

updateHaInput vrid

기본 및 보조 Socket 간의 VRRP 메시지에 대한 VRID(가상 라우터 식별자)를 업데이트합니다. 기본 VRID는 100입니다.

샘플 포스트맨 스크립트

변이 updateHa ($accountId: ID!, $siteId: ID!, $input: UpdateHaInput!) {
    site(accountId: $accountId) {
        updateHa (siteId: $siteId, input: $input) {
            siteId
        }
    }
}

GraphQL 변수

{
    "accountId": "26",
    "siteId": 126,
    "input": {
        "primaryManagementIp": "192.168.4.2",
        "secondaryManagementIp": "192.168.4.3",
        "vrid": 100
    }
}

관련 자원

관련 기사