---
title: "設定 API - updateHa"
slug: "configuration-api-updateha"
updated: 2026-07-30T01:26:04Z
published: 2026-07-30T01:26:04Z
canonical: "knowledge.catonetworks.com/configuration-api-updateha"
---

> ## 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 - updateHa

Cato API を使用する前に、[Cato API のサポートポリシー](/v1/docs/support-policy-for-the-cato-api)を確認することを強くお勧めします。

## updateHa の概要

Cato 管理アプリケーション（ネットワーク>サイト>{site name}>サイト設定>ソケット）で Socket High Availability (HA) 設定が有効なサイトの **ソケット** セクションで次の設定を更新するために `updateHa` ミューテーション API を使用します：

- プライマリおよびセカンダリソケットの管理 IP アドレス
- VRID - プライマリソケットがダウンしているとき、および再び機能するようになったときを識別する VRRP メッセージの ID

> [!NOTE]
> 注：
> 
> 両方のソケットがサイトに割り当てられ、Cato 管理アプリケーションを使用してソケット HA サイトとして構成されている場合にのみ、`updateHa` API を実行できます。

### サイトの siteID の特定

Cato 管理アプリケーションにはサイト ID が表示されないため、以下の方法で見つけることができます：

- entityLookup API クエリを使用して（[Cato API - EntityLookup](/v1/docs/cato-api-entitylookup) を参照）、値が **サイト** である `タイプ` を使用します

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

## updateHa 引数の詳細

Cato 設定 API を使用して、次の HA ソケット設定を更新するための引数です。 すべての `updateHaInput` 引数は任意です：

- primaryManagementIp - プライマリソケットの管理 IP アドレス
- secondaryManagementIp- セカンダリソケットの管理 IP アドレス
- VRID - VRRP メッセージ用の仮想ルーター識別子

### updateHaInput primaryManagementIp

プライマリソケットの管理 IP アドレスを更新します。 この IP アドレスを使用してプライマリソケットの Socket WebUI にアクセスできます。

### updateHaInput secondaryManagementIp

セカンダリソケットの管理 IP アドレスを更新します。 この IP アドレスを使用してセカンダリソケットの Socket WebUI にアクセスできます。

### updateHaInput vrid

VRID（仮想ルーター識別子）を VRRP メッセージ用にプライマリおよびセカンダリソケットの間で更新します。 デフォルト VRID は 100 です。

## Sample Postman スクリプト

```plaintext
ミューテーション updateHa ($accountId: ID!, $siteId: ID!, $input: UpdateHaInput!) {
    site(accountId: $accountId) {
        updateHa (siteId: $siteId, input: $input) {
            siteId
        }
    }
}
```

**GraphQL 変数**

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

**関連リソース**

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