change-datafence-infra

Prev Next

VPC環境で利用できます。

Datafenceのインフラ設定を変更します。インフラの変更に一定時間がかかりますので、非同期で処理されます。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
POST /api/v1/fence/change-datafence-infra

リクエストボディ

リクエストボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
fenceId Integer Required Datafence番号
description String Optional Datafenceの説明
updateFence Object Required Datafenceのインフラ設定の変更情報
updateFence.fenceServerList Array Conditional Datafenceサーバリスト
  • 1~4台に設定
updateFence.fenceNasList Array Conditional Datafence NASリスト
  • 1台以上に設定

fenceServerList

fenceServerListの説明は次の通りです。

フィールド タイプ 必須の有無 説明
actionType String Required アクションタイプ
  • CREATE | UPDATE | DELETE
    • CREATE: 作成
    • UPDATE: 更新
    • DELETE: 返却
serverInstanceNo String Conditional Datafenceサーバインスタンス番号
  • actionTypeUPDATEまたはDELETEの場合、必ず入力
specCode String Conditional サーバスペックコード
  • actionTypeCREATEまたはUPDATEの場合、必ず入力
  • get-product-specを参照
softwareCode String Conditional サーバソフトウェアコード
  • actionTypeCREATEまたはUPDATEの場合、必ず入力
userPassword String Conditional Datafenceサーバアクセスパスワード
  • 英字の大文字、小文字、数字、記号をそれぞれ1文字以上組み合わせて8~14文字以内で入力
  • 使用できない記号: '、"、`、₩、/、&、$、スペース
  • actionTypeCREATEの場合、必ず入力
serverImageNo String Conditional ユーザーサーバイメージ番号

fenceNasList

fenceNasListの説明は次の通りです。

フィールド タイプ 必須の有無 説明
actionType String Required アクションタイプ
  • CREATE | DELETE
    • CREATE: 作成
    • DELETE: 返却
nasInstanceNo String Conditional NASインスタンス番号
  • actionTypeDELETEの場合、必ず入力
nasSize Integer Conditional NASボリュームサイズ(GB)
  • 500~10000
  • 100GB単位で設定
  • actionTypeCREATEの場合、必ず入力
count Integer Conditional NAS数
  • actionTypeCREATEの場合、必ず入力

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request POST 'https://datafence.apigw.ntruss.com/api/v1/fence/change-datafence-infra' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
--data '{
  "fenceId": 1,
  "description": "datafence001",
  "updateFence": {
    "fenceServerList": [
      {
        "actionType": "UPDATE",
        "serverInstanceNo": 10000,
        "specCode": "SVR.VSVR.STAND.C004.M016.NET.SSD.B100.G002",
        "softwareCode": "SW.VSVR.APP.LNX64.UBNTU.SVR2004.TNSFL.LATEST.B050",
        "userPassword": "Password1000#",
        "serverImageNo": 9999
      }
    ],
    "fenceNasList": [
      {
        "actionType": "UPDATE",
        "nasInstanceNo": 10000,
        "nasSize": 500,
        "count": 2
      }
    ]
  }
}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
message String - API処理結果メッセージ

レスポンスステータスコード

Datafence APIで共通して使用されるレスポンスステータスコードの詳細は、Datafence APIのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
  "message": "Fence modification requested."
}