Update HA Constitution Device


Overview

Change menu (Managed Firewall/Managed UTM) and/or plan of HA constitution devices.


API Operation Object

  • Managed Firewall/UTM HA constitution devices


Synchronous / Asynchronous

  • Synchronous


Request

HTTP Request Method

  • POST


HTTP Request Path

{endpoint}/API/SoEntryFGHA

HTTP Request Header

X-Auth-Token: <token_id>
Content-Type: application/json

Request Parameter

Request Parameters

item

Required

type

format

description

sokind

yes

String

-

MH: Update HA Constitution Device

tenant_id

yes

String

UUID

Tenant ID of the owner (UUID)

locale

no

String

-

Messages are displayed in Japanese or English depending on this value. ja: Japanese, en: English. Default value is "en".

gt_host

yes

list

-

operatingmode

yes

String

-

Set "UTM_HA" or "FW_HA" to this value.

licensekind

yes

String

-

Set "02" or "08" as FW/UTM plan.

hostname

yes

String

-

Set the hostname.


Sample Request Body

{
   "tenant_id": "dbb65792d77d45a38da3d62b1350e6df",
   "sokind": "MH",
   "locale": "ja",
   "gt_host": [{
       "hostname": "CES888",
       "operatingmode": "UTM_HA",
       "licensekind": "02"
   },{
       "hostname": "CES890",
       "operatingmode": "UTM_HA",
       "licensekind": "02"
   }]
}

Response

HTTP Response Code

Response Codes

Response Code

Description

200

OK

400

Request format is invalid

401

Unauthorized

500

Internal Server Error

511

Internal Server Error (Fail Service Order etc.)


Response Parameter

Response Parameters

item

type

format

description

code

String

-

This code is for determining the details of the error.FOV-H-**: Successful Completion. FOV-H-E**: Error has occurred.

message

String

-

This message is shown when error has occurred.

soId

String

-

Identification ID of Service Order.

status

integer

-

This value indicates normal or abnormal. 1:normal, 2:abnormal


Sample Response Body

Normal Response

When locale is "ja"

{
    "code": "FOV-H-OK",
    "message": "正常終了",
    "soId": "FGHA_FT64D7781E8541B298FCFE418909B44C0",
    "status": 1
}

When locale is "en"
{
    "code": "FOV-H-OK",
    "message": "Successful completion",
    "soId": "FGHA_FT64D7781E8541B298FCFE418909B44C0",
    "status": 1
}

Error Response

When locale is "ja"

{
    "code": "FOV-H-E",
    "message": "システムエラーが発生しました。恐れ入りますが、チケットシステムでご連絡ください。",
    "status": 2
}

When locale is "en"
{
    "code": "FOV-H-E",
    "message": "System error has occurred. Excuse me, please contact us at the ticket system.",
    "status": 2
}