構成API - updateSocketInterface

updateSocketInterfaceの概要

Cato管理アプリケーションのサイトのSocketセクションで、次のソケットインタフェース設定を更新するためにupdateSocketInterface mutation APIを使用します(ネットワーク > サイト > {site name} > サイト構成 > ソケット)。

  • インタフェースの宛先

  • 名称

  • LANインタフェース設定

  • サイト帯域幅

  • WANインタフェース設定

  • オフクラウド(Catoの宛先のため)

  • 代替WANインタフェース設定

  • LAG(リンクアグリゲーション)メンバー

  • VRRP種類

サイトのsiteIDの検索

サイトIDはCato管理アプリケーションに表示されないため、サイトIDを探すことができます:

  • EntityLookup APIクエリを使用して(Cato API - EntityLookupを参照)、値sitetypeを使用します。

    サイトの名前を値としてsearchパラメータを使用すると、クエリがサイトIDを返します

  • サイトを選択した際のCato管理アプリケーションのURL番号(ネットワーク > サイト > {site name})。 例えば、以下のURLではサイトIDが12345: https://cc.catonetworks.com/#/26/sites/12345/networkAnalytics

ソケットのsocketInterfaceId値の理解

socketInterfaceIdはCatoソケットのための値を含む列挙型です。 インタフェース名はサイトのソケット画面(ネットワーク > サイト > {site name} > サイト構成 > ソケット)で以下のように表示されます:

  • X1500ソケット - 自動、LAN1、LAN2、WAN1、WAN2、WAN3、USB1、USB2

  • X1600ソケット - 1-8、USB1、USB2
  • X1700ソケット - INT_1 - INT_12

updateSocketInterfaceInputの引数詳細

これらはCato構成APIを使用して、サイトのソケットインタフェース設定を更新するための引数です。 destType引数のみが必須であり、それ以外は更新するソケットインタフェース設定の引数を含めてください。

  • destType - インタフェースの宛先

  • name - サイトの名称

  • lan - LANインタフェース設定

  • bandwidth - サイトの上りと下りの帯域幅

  • wan - WANインタフェース設定

  • offCloud - 宛先Catoのインタフェース用オフクラウド設定

  • altWAN - 宛先が代替WANまたは代替WAN(レイヤー2)のインタフェース設定

  • lag - LAN LAGマスターの宛先のためのリンク集約(LAG)のリンク最低数(マスターとメンバーを含む)

  • vrrp - ソケット高可用性(HA)構成のために、ソケット間のVRRP接続タイプ

updateSocketInterfaceInput destType

destTypeはインタフェースの宛先を定義する列挙型引数です。

これらはオプションです:

  • CATO - Catoクラウド用のWANトラフィック

  • LAN - ソケット裏の内部LAN

  • VRRP_AND_LAN - ソケットHAのため、インタフェースはLANとVRRPトラフィックに使用されます

  • INTERFACE_DISABLED - インタフェースは無効で、トラフィックを通過させません

  • ALTERNATIVE - MPLSのようなCatoクラウド外のWANトラフィック

  • LAYER_2_WAN - ソケットサイトが同じサブネットにある情况下でMPLSネットワーク用の代替WAN(レイヤー2)オプション

  • VRRP - ソケットHAのため、インタフェースはVRRPトラフィックだけに使用されます

  • LAN_LAG_MASTER_AND_VRRP - ソケットHAとLAN LAG構成のために、インタフェースはLAN LAGマスターであり、VRRPトラフィックに使用されます

  • LAN_LAG_MASTER - LAN LAG構成のために、インタフェースはLAN LAGマスターです

  • LAN_LAG_MEMBER - LAN LAG構成のために、インタフェースはLAN LAGメンバーです

  • LAN_AND_HA - AzureとAWSでのvSocket HAのために、インタフェースはLANとHAトラフィックに使用されます

updateSocketInterfaceInput name

name引数はソケットインタフェースの名称用です。

updateSocketInterfaceInput lan

lan引数はソケット用LANインタフェースの設定用です。

これらはオプションです:

  • subnet - CIDR形式のLANインタフェース用ネイティブ範囲

  • localIP - LANネットワーク範囲のローカルIPアドレス

updateSocketInterfaceInput bandwidth

WANトラフィック用インタフェースの場合、bandwidth引数はインタフェースの上りと下りの帯域幅を定義します。

これらがオプションです:

  • upstreamBandwidth - このインタフェースの最大上り帯域幅

  • downstreamBandwidth - このインタフェースの最大下り帯域幅

updateSocketInterfaceInput wan

wan 引数は、ソケットのWANインタフェースの設定用です。 WANの役割は通常、ネットワークルールでトラフィックを定義するために使用されます。 優先度は、アクティブおよびパッシブインタフェースを持つソケットのフェイルオーバー優先度に使用されます

これらがオプションです:

  • 役割 - WANインタフェースの役割を定義します: なし, 自動, wan_1, wan_2, wan_3

  • 優先度 - インタフェースのフェイルオーバー優先度を定義します: ACTIVE, PASSIVE, LAST_RESORT

    LAST_RESORTは最も低い優先度のインタフェースです

updateSocketInterfaceInput offCloud

offCloud 引数は、オフクラウド機能を使用してトラフィックをCato Cloudの代わりにパブリックインターネット経由でルーティングするソケットサイト用です。

これらがオプションです:

  • enabled - ブール値、true の場合、サイトに対してオフクラウドトラフィックが有効になります

  • publicIP(オプション)- インターネットへの接続を開始するための静的パブリックIPアドレスを定義します

  • publicStaticPort(オプション)- オフクラウドトラフィックの静的インタフェース番号を定義します

updateSocketInterfaceInput altWan

altWan 引数は、MPLSなどのアルタナティブWANネットワークに接続するソケットサイト用です。 一般に、プライベートIPとインタフェースはMPLSプロバイダに直接接続するために使用されます。

これらがオプションです:

  • privateInterfaceIp - トラフィック用のソケットインタフェースのプライベートIPアドレス

  • privateNetwork - LANのIP 範囲(CIDR付き)

  • privateGatewayIp - アルタナティブWANゲートウェイ(例:MPLSファイアウォールやルーター)用のプライベートIPアドレス

  • privateVlanTag(オプション)- インタフェース(プライベートIPアドレス)のVLANタグ

  • publicInterfaceIP(オプション)- トラフィック用のソケットインタフェースのパブリックIPアドレス

  • publicNetwork(オプション)- LANのパブリックIP範囲(CIDR付き)

  • publicGatewayIp(オプション)- アルタナティブWANゲートウェイ(例:MPLSファイアウォールやルーター)用のパブリックIPアドレス

  • publicVlantag(オプション)- インタフェース(パブリックIPアドレス)のVLANタグ

updateSocketInterfaceInput lag

lag 引数は、マスターLAN LAGインタフェース用で、このソケットサイトのLAGに必要な最小インタフェース数(マスターとメンバーを含む)を定義します。

オプションはこれです:

  • minLinks - LAGの最小インタフェース(リンク)数

updateSocketInterfaceInput vrrp

vrrp 列挙引数は、ソケットHA設定用で、キープアライブメッセージのためのソケット間のVRRP接続タイプを定義します。

これらがオプションです:

  • VIA_SWITCH - VRRP接続は、ソケット間のスイッチを経由してルーティングされます

  • DIRECT_LINK - VRRP接続は、ソケット間を直接ルーティングされます

サンプルPostman スクリプト

サンプルスクリプト - ネイティブ範囲と名前の更新

これは、LAN1インタフェースの名前をLAN-01に変更し、ソケットのネイティブ範囲のサブネットとlocalIPを更新するために設定APIを使用した例です。

mutation updateSocketInterface ($accountId: ID!, $siteId: ID!, $socketInterfaceId: SocketInterfaceIDEnum!, $input: UpdateSocketInterfaceInput!) {
 "accountId":$accountId,
 "siteId":$siteId,
 "socketInterfaceId":$socketInterfaceId,
 "input":$input
}

GraphQL 変数

{
 "accountId": "26",
 "siteId": 26,
 "socketInterfaceId": "LAN1",
 "input": {
 "name": "LAN-01",
 "destType": "LAN",
 "lan": {
 "subnet": "10.0.0.0/24",
 "localIp": "10.0.0.1"
 }
 }
}

サンプルスクリプト - 帯域幅と名前の変更

これは、WANインタフェースの帯域と名前を変更するために設定APIを使用した例です。

mutation updateSocketInterface ($accountId: ID!, $siteId: ID!, $socketInterfaceId: SocketInterfaceIDEnum!, $input: UpdateSocketInterfaceInput!) {
 "accountId":$accountId,
 "siteId":$siteId,
 "socketInterfaceId":$socketInterfaceId,
 "input":$input
}

GraphQL 変数

{
 "accountId": "26",
 "siteId": 126,
 "socketInterfaceId": "WAN1",
 "input": {
 "name": "WAN Demo",
 "destType": "CATO",
 "bandwidth": {
 "upstreamBandwidth": 100,
 "downstreamBandwidth": 100
 }
 }
}

この記事は役に立ちましたか?

0人中0人がこの記事が役に立ったと言っています

0件のコメント