Cisco Meraki 서비스 그래프 커넥터 API 엔드포인트

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 06월 17일
  • 소요 시간: 4분

    • 서비스 그래프 커넥터 for Meraki는 Cisco Meraki 대시보드 API 데이터를 에 통합합니다ServiceNow AI Platform®구성 관리 데이터베이스(CMDB). 이 문서에서는 사용되는 API 엔드포인트와 데이터가 시스템을 통해 흐르는 방식에 대해 자세히 설명합니다.

    표 1. 조직 엔드포인트
    설명 API 응답
    조직 API 응답

    URL:/organizations

    		 
    {                                                                    │
│    "id": "123456",                                                    │
│    "name": "My Organization",                                         │
│    "management": {                                                    │
│      "details": {                                                     │
│        "MSP ID": "...",                                               │
│        "customer number": "...",                                      │
│        "IP restriction mode for API": "..."                           │
│      }                                                                │
│    }                                                                  │
│  }
    표 2. 네트워크 엔드포인트
    설명 엔드포인트
    네트워크 API 응답

    URL:/organizations/{orgId}/networks

    		 
    {                                                                    │
│    "id": "N_123456",                                                  │
│    "organizationId": "123456",                                        │
│    "name": "My Network",                                              │
│    "notes": "Network description"                                     │
│  }
    표 3. 장치 엔드포인트
    설명 엔드포인트
    장치 API 응답

    URL: /organizations/{orgId}/devices

    		 
    {                                                                    │
│    "serial": "Q2XX-XXXX-XXXX",                                        │
│    "name": "My Device",                                               │
│    "networkId": "N_123456",                                           │
│    "model": "MX68",                                                   │
│    "mac": "00:11:22:33:44:55",                                        │
│    "productType": "appliance",                                        │
│    "firmware": "mx-18.1",                                             │
│    "lat": 37.7749,                                                    │
│    "lng": -122.4194,                                                  │
│    "address": "123 Main St",                                          │
│    "notes": "Device description"                                      │
│  }
    표 4. 장치 상태 엔드포인트
    설명 엔드포인트
    장치 상태 API 응답

    URL: /organizations/{orgId}/devices/statuses

    		 
    {                                                                    │
│    "serial": "Q2XX-XXXX-XXXX",                                        │
│    "status": "online",                                                │
│    "publicIp": "203.0.113.1",                                         │
│    "wan1Ip": "192.168.1.1",                                           │
│    "wan2Ip": "192.168.2.1",                                           │
│    "wan1Gateway": "192.168.1.254",                                    │
│    "wan1IpType": "dhcp",                                              │
│    "wan1PrimaryDns": "8.8.8.8",                                       │
│    "wan1SecondaryDns": "8.8.4.4"                                      │
│  }
    표 5. 업링크 상태 엔드포인트
    설명 엔드포인트
    업링크 상태 엔드포인트

    URL: /organizations/{orgId}/uplinks/statuses

    		 
    {                                                                    │
│    "serial": "Q2XX-XXXX-XXXX",                                        │
│    "networkId": "N_123456",                                           │
│    "model": "MX68",                                                   │
│    "highAvailability": {                                              │
│      "enabled": true,                                                 │
│      "role": "primary"                                                │
│    },                                                                 │
│    "uplinks": [                                                       │
│      {                                                                │
│        "interface": "wan1",                                           │
│        "status": "active",                                            │
│        "ip": "192.168.1.1",                                           │
│        "gateway": "192.168.1.254",                                    │
│        "publicIp": "203.0.113.1",                                     │
│        "primaryDns": "8.8.8.8",                                       │
│        "secondaryDns": "8.8.4.4",                                     │
│        "ipAssignedBy": "dhcp"                                         │
│      },                                                               │
│      {                                                                │
│        "interface": "cellular",                                       │
│        "status": "ready",                                             │
│        "apn": "broadband",                                            │
│        "iccid": "...",                                                │
│        "imsi": "...",                                                 │
│        "msisdn": "..."                                                │
│      }                                                                │
│    ]                                                                  │
│  }
    표 6. 스위치 포트 엔드포인트
    설명 엔드포인트
    스위치 포트 엔드포인트

    URL: /organizations/{orgId}/switch/ports/statuses/bySwitch

    		 
    {                                                                    │
│    "items": [                                                         │
│      {                                                                │
│        "serial": "Q2XX-XXXX-XXXX",                                    │
│        "network": { "id": "N_123456" },                               │
│        "ports": [                                                     │
│          {                                                            │
│            "portId": "1",                                             │
│            "status": "connected"                                      │
│          },                                                           │
│          {                                                            │
│            "portId": "2",                                             │
│            "status": "disconnected"                                   │
│          }                                                            │
│        ]                                                              │
│      }                                                                │
│    ]                                                                  │
│  }
    표 7. 장치 인벤토리 엔드포인트
    설명 엔드포인트
    장치 인벤토리 엔드포인트

    URL: /organizations/{orgId}/inventory/devices

    		 
     {                                                                    │
│    "serial": "Q2XX-XXXX-XXXX",                                        │
│    "orderNumber": "ORD-12345",                                        │
│    "licenseExpirationDate": "2025-12-31"                              │
│  }