---
title: "設定 API - staticHost の追加、更新、削除"
slug: "configuration-api-adding-updating-and-removing-statichost"
updated: 2026-07-30T01:26:02Z
published: 2026-07-30T01:26:02Z
canonical: "knowledge.catonetworks.com/configuration-api-adding-updating-and-removing-statichost"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 設定 API - staticHost の追加、更新、削除

Cato APIを使用開始する前に、[Cato APIのサポートポリシー](/v1/docs/support-policy-for-the-cato-api)をよくお読みください。

この記事では、Cato APIを使用してサイトに定義されたホストを以下のコマンドで管理する方法を説明します：

- 静的ホストを追加
- 静的ホストを更新
- 静的ホストを削除

## staticHost の概要

staticHost 変更 API を使用して、アカウント内のサイトにホストを追加、更新、削除し、次の設定を定義します：

- ホストの名前
- ホストのIPアドレス
- MACアドレス（オプション - ホストのDHCP IP割り当てを予約するために使用）

リセラーアカウントの場合、顧客アカウントごとに個別にAPIキーを作成して設定できます。

### サイトの siteID の特定

Cato管理アプリケーションにはサイトIDが表示されず、以下の方法で特定できます：

- “entityLookup” API クエリを使用し、**サイト** の値を持つ`type` を使用します（[Cato API - EntityLookup](/v1/docs/cato-api-entitylookup)を参照）。

また、`search` パラメータをサイトの名前として使用すると、クエリがサイトIDを返します。
- サイトを選択した場合の Cato 管理アプリケーションの URL 番号（ネットワーク > サイト > {サイト名}）。 たとえば、次の URLでサイト ID は12345です: https://cc.catonetworks.com/#/26/sites/12345/networkAnalytics

## addStaticHostおよびupdateStaticHost引数の詳細

同じ引数が、Cato設定APIを使用してサイトの背後にホストを作成または更新するために使用されます。 `addStaticHost`用の引数は、省略不可とマークされていない限り必須です。 `updateStaticHost`では、更新するホスト設定の引数を含めます。

- hostId - `updateStaticHost` 用に更新するホストのIDを入力します

`addStaticHost` では、新規ホスト作成時にこの ID が生成されます
- name - サイト背後のホストの名前
- ip - サイト背後のホストのIPアドレス
- macAddress - （オプション）サイト背後のホストのMACアドレス

ホストのMACアドレスは、静的IPアドレスを持つホストのDHCP予約に使用されます

### StaticHost hostId

`hostId` はホストエンティティの内部Cato IDです。

`networkRangeId`は[entityLookup](/v1/docs/cato-api-entitylookup)リードオンリーAPIを使用して取得可能で、`type` として値 **host** を使用します

### StaticHost名

`名前` 引数を使用してホストの名前を定義します。

### StaticHost IP

`ip` 引数を使用してホストのIPアドレスを定義します。

### StaticHost MAC アドレス（オプション）

DHCP予約のために、`macAddress` 引数を使用してホストのMACアドレスを定義します。

CatoをDHCPサーバーとして使うアカウントでは、MACアドレスですでに定義されたホストのIPアドレスは予約され、別のホストに割り当てることはできません。 ホストのIPアドレスがサイトに定義されたネットワークセグメントのDHCPレンジ内にないことを確認してください。

## 静的ホストを削除

`removeStaticHost` API を使用して、サイトに定義されたホストを削除します。 このAPIには`hostId` のみを使用する必要があります。

## Postmanスクリプトのサンプル

```plaintext
mutation addStaticHost ($accountId: ID!, $siteId: ID!, $input:AddStaticHostInput!) {
    site(accountId: $accountId) {
      addStaticHost(
        siteId: $siteId, 
        input: $input
      ) {
      hostId
    }
  }
}
```

**GraphQL変数**

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

**関連リソース**

- [Catoサイト作成API と Postman を用いた使用](/v1/docs/using-the-cato-site-creation-api-with-postman)
- [設定 API スクリプト](https://support.catonetworks.com/hc/en-us/articles/8130916998429)