Press CTRL+K to open search

구성 API - addSocketSite

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

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

addSocketSite 개요

addSocketSite 변형 API를 사용하여 계정에 새로운 Socket 사이트를 만들고 해당 사이트에 대해 다음 설정을 정의하세요:

  • 이름

  • 설명

  • 유형

  • 연결 유형

  • 시간대

  • 국가

  • 주

  • 주소

  • 기본 범위

사이트는 기본 대역폭 설정(25 Mbps 다운스트림 및 25 Mbps 업스트림)으로 생성되며, 라이센스가 할당되지 않은 상태로 생성됩니다.

리셀러 계정의 경우, Cato API로 설정을 구성하는 고객 계정 내에 별도의 API 키를 생성할 수 있습니다.

계정의 accountId 찾기

이 계정 ID는 Cato 관리 애플리케이션에 표시되지 않으며, 대신 Cato 관리 애플리케이션의 URL에 있는 숫자입니다. 예를 들어 다음 URL의 계정 ID 는 26입니다: https://cc.catonetworks.com/#!/26/topology.

사이트 생성 API의 accountId 인수에 이 ID를 입력하세요. 예를 들어:

site(accountId: 26) {
    addSocketSite(input: $addSocketSite) { 
        siteId 
    } 
}

addSocketSite 인수에 대한 세부사항

Cato 구성 API를 사용하여 새로운 Socket 사이트를 생성하기 위한 인수입니다. 선택적이라고 표시되지 않는 한 인수는 필수입니다:

  • name - 사이트의 이름

  • connectionType - 이 사이트의 물리적 Socket 또는 vSocket

  • siteType - 조직 내 사이트의 유형, 예: Cloud Data Center

  • description - (선택 사항) 사이트에 대한 설명

  • nativeNetworkRange - CIDR 형식의 사이트 뒤 네이티브 LAN의 IP 범위

  • siteLocation - 사이트 물리적 위치에 대한 데이터

AddSocketSite 이름

생성하는 Socket 사이트의 이름을 정의하십시오.

AddSocketSite connectionType

connectionType는 사이트에 대한 물리적 또는 가상 Socket 유형을 정의하는 열거형 인수입니다.

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

  • SOCKET_X1500 - 물리적 사이트를 위한 X1500 또는 X1500B Socket

  • SOCKET_X1600 - 물리적 사이트를 위한 X1600 Socket

  • SOCKET_X1700 - 물리적 사이트를 위한 X1700 또는 X1700B Socket

  • SOCKET_ESX - 가상 VMware 사이트를 위한 vSocket

  • SOCKET_AWS - 가상 AWS 사이트를 위한 vSocket

  • SOCKET_AZURE - 가상 Azure 사이트를 위한 vSocket

AddSocketSite siteType

siteType은 Cato 관리 애플리케이션의 모니터링 > 토폴로지 화면에서 사이트에 사용되는 아이콘을 결정하는 사이트 유형을 정의하는 열거형 인수입니다.

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

  • BRANCH - 물리적 또는 가상 사이트

  • HEADQUARTERS - 본사를 위한 물리적 사이트

  • CLOUD_DC - 클라우드 기반 데이터센터를 위한 가상 사이트

  • DATACENTER - 데이터센터를 위한 물리적 사이트

AddSocketSite 설명 (옵션)

설명은 사이트를 설명하기 위한 선택적 자유 텍스트 필드입니다.

AddSocketSite nativeNetworkRange

nativeNetworkRange 인수에서 사이트의 네이티브 LAN 범위를 IPSubnet 형식으로 정의하십시오. 네이티브 범위는 서브넷에 대해 CIDR을 사용하며, /32 CIDR 블록은 지원되지 않습니다.

AddSocketSite siteLocation

siteLocation 인수는 사이트에 대한 다음 물리적 세부 정보를 정의합니다. countryCode는 계정의 특정 지역의 사용 가능한 사이트 라이선스 수와 관련이 있습니다.

이 인수에 대한 값을 검색하려면 entityLookup API 쿼리를 사용할 수 있습니다. Cato API - EntityLookup를 참조하세요.

다음은 siteLocation 인수입니다:

  • countryCode - 사이트가 위치한 국가에 대한 두 글자 코드(ISO 3166-1 alpha-2)

    entityLookup의 경우 유형을 국가 값으로 사용합니다

  • stateCode - (선택 사항) 해당 국가의 주(州)에서 사이트가 위치한 장소

    entityLookup의 경우 유형을 countryState 값으로 사용합니다

  • timezone - 사이트의 시간대, 소켓 및 v소켓 업그레이드를 위한 유지보수 창의 시간 프레임을 설정하는 데 사용됩니다

    entityLookup의 경우 유형을 시간대 값으로 사용합니다

  • 주소 - (선택 사항) 물리적 사이트의 거리 주소

샘플 포스트맨 스크립트

변형 addSocketSite ($accountId: ID!, $input: AddSocketSiteInput!) {
    site(accountId: $accountId) {
        addSocketSite (input: $input) {
            siteId
        }
    }
}

GraphQL 변수

{
    "accountId": "26",
    "input": {
        "name": "SampleUsSite2",
        "description": "My first API site",
        "siteType": "BRANCH",
        "connectionType": "SOCKET_X1500",
        "nativeNetworkRange": "10.0.0.0/24",
        "siteLocation": {
            "countryCode": "US",
            "timezone": "US/Central",
            "stateCode": "US-AL"
        }
    }
}

관련 자원

관련 기사