1. クラウド/サーバー Wasabi接続ゲートウェイ¶

1.1. 事前準備¶

Wasabi接続ゲートウェイの作成には、トークンの取得および共通機能ゲートウェイIDの取得が必要です。

※ トークンについては Smart Data Platform APIの利用開始を参考に取得してください。

※ 共通機能ゲートウェイIDについては、あらかじめ共通機能ゲートウェイを作成し、以下のどちらかの手順で取得してください。

◼︎ コントロールパネルから取得する場合
コントロールパネルにログインし、「クラウド/サーバー ローカルネットワーク」→「共通機能ゲートウェイ」へと進みます。
画面遷移後、使用したい共通機能ゲートウェイの名前を選択することで、共通機能ゲートウェイの詳細が表示されます。
ここに表示されている「ID」が共通機能ゲートウェイIDです。

◼︎ APIから取得する場合
1. Common Function Gateway を参考に、共通機能ゲートウェイの一覧(common_functions_gateways)を取得してください。
2.取得した共通機能ゲートウェイから、使用したい共通機能ゲートウェイのidを記録してください。

1.2. Wasabi接続ゲートウェイ操作手順書¶

1.2.1. 変数の説明・設定¶

変数	説明
TOKEN	[事前準備]で取得したトークン
COMMON_FUNCTION_GATEWAY_ID	[事前準備]で取得した共通機能ゲートウェイID
BASE_URL	リージョンによって変わるBASE_URL Smart Data PlatformのAPIをはじめて利用される方へを参考にしてください
WASABI_GATEWAY_ID	Wasabi接続ゲートウェイ作成時に生成されるID。個別のWasabi接続ゲートウェイ操作に用いる

$ TOKEN=値を置き換えてください
$ COMMON_FUNCTION_GATEWAY_ID=値を置き換えてください
$ BASE_URL=値を置き換えてください

1.2.2. Wasabi接続ゲートウェイの作成 (CREATE)¶

POST ${BASE_URL}/v2.0/wasabi_gateways

[ HTTP Request Parameters ]

パラメータ	形式	説明	required
common_function_gateway_id	string <uuid>	[事前準備]で取得した共通機能ゲートウェイID	Yes
name	string	作成するWasabi接続ゲートウェイの名前	No
description	string	作成するWasabi接続ゲートウェイの名前	No
tenant_id	string <uuid>	Wasabi接続ゲートウェイを作成するテナントID	No

[ HTTP Request Parameters ]

$ curl -sS -H "Content-Type: application/json" -H "X-Auth-Token: ${TOKEN}" -X POST -d "{
  \"common_function_gateway_id\": \"${COMMON_FUNCTION_GATEWAY_ID}\",
  \"name\": \"test_wasabi_gw\",
  \"description\": \"test_wasabi_gw_description\"
}" ${BASE_URL}/v2.0/wasabi_gateways

# 以下がレスポンスのサンプルです。
{
  "wasabi_gateway": {
    "common_function_gateway_id": "共通機能ゲートウェイID",
    "description": "test_wasabi_gw_description",
    "id": "Wasabi接続ゲートウェイID",
    "name": "test_wasabi_gw",
    "status": "PENDING_CREATE",
    "tenant_id": "テナントID"
  }
}

注釈

作成から一定時間待った後に、次に示す「Wasabi接続ゲートウェイ一覧の取得 (LIST)」または「特定のWasabi接続ゲートウェイの取得 (GET)」を実施し、statusが「ACTIVE」になっていることを確認してください。statusが「ACTIVE」になるまではご利用いただけません。

1.2.3. Wasabi接続ゲートウェイの取得 (LIST)¶

GET ${BASE_URL}/v2.0/wasabi_gateways

[ HTTP Request Example ]

$ curl -sS -H "Content-Type: application/json" -H "X-Auth-Token: ${TOKEN}" -X GET ${BASE_URL}/v2.0/wasabi_gateways
# 以下がレスポンスのサンプルです
# statusがACTIVEになっていることを確認してください。
{
 "wasabi_gateways": [
    {
       "common_function_gateway_id": "共通機能ゲートウェイID",
       "description": "test_wasabi_gw_description",
       "id": "Wasabi接続ゲートウェイID",
       "name": "test_wasabi_gw",
       "status": "ACTIVE",
       "tenant_id": "テナントID"
    }
  ]
}

1.2.4. 特定のWasabi接続ゲートウェイの取得 (GET)¶

※ CREATE、またはLISTのレスポンスから取得したWasabi接続ゲートウェイIDを設定します。

$ WASABI_GATEWAY_ID=取得したWasabi接続ゲートウェイID

GET ${BASE_URL}/v2.0/wasabi_gateways/${WASABI_GATEWAY_ID}
[ HTTP Request Example ]

$ curl -sS -H "Content-Type: application/json" -H "X-Auth-Token: ${TOKEN}" -X GET ${BASE_URL}/v2.0/wasabi_gateways/${WASABI_GATEWAY_ID}
# 以下がレスポンスのサンプルです
{
   "common_function_gateway_id": "共通機能ゲートウェイID",
   "description": "test_wasabi_gw_description",
   "id": "Wasabi接続ゲートウェイID",
   "name": "test_wasabi_gw",
   "status": "ACTIVE",
   "tenant_id": "テナントID"
}

1.2.5. 特定のWasabi接続ゲートウェイの更新 (UPDATE)¶

PUT ${BASE_URL}/v2.0/wasabi_gateways/${WASABI_GATEWAY_ID}

[ HTTP Request Parameters ]

パラメータ	形式	説明
name	string	更新するWasabi接続ゲートウェイの名前
description	string	更新するWasabi接続ゲートウェイの説明

[ HTTP Request Example ]

$ curl -sS -H "Content-Type: application/json" -H "X-Auth-Token: ${TOKEN}" -X PUT -d '{
 "name": "change_test_wasabi_gw",
 "description": "change_test_wasabi_gw_description"
}' ${BASE_URL}/v2.0/wasabi_gateways/${WASABI_GATEWAY_ID}
# 以下がレスポンスのサンプルです
{
   "common_function_gateway_id": "共通機能ゲートウェイID",
   "description": "change_test_wasabi_gw_description",
   "id": "Wasabi接続ゲートウェイID",
   "name": "change_test_wasabi_gw",
   "status": "PENDING_UPDATE",
   "tenant_id": "テナントID"
}

1.2.6. 特定のWasabi接続ゲートウェイの削除 (DELETE)¶

DELETE ${BASE_URL}/v2.0/wasabi_gateways/${WASABI_GATEWAY_ID}

[ HTTP Request Example ]

$ curl -sS -H "Content-Type: application/json" -H "X-Auth-Token: ${TOKEN}" -X DELETE ${BASE_URL}/v2.0/wasabi_gateways/${WASABI_GATEWAY_ID}
< HTTP/1.1 204 No Content

1.3. Wasabi接続ゲートウェイ作成後の手順¶

1.3.1. ルーティングの設定¶

詳細情報ページを参考に、Wasabi接続ゲートウェイ機能を利用できるよう必要なルーティング設定等を実施してください。
Wasabi API EndpointのグローバルIPアドレスレンジについては、 Wasabi東京/大阪リージョンのAPI EndpointのIPアドレスレンジについてを参照してください。

1.3.2. Wasabiへアクセスするアプリケーションの設定¶

Wasabiへアクセスするアプリケーションのインストールや設定方法については、各アプリケーションのドキュメントを参照してください。

クラウド/サーバー　Wasabi接続ゲートウェイチュートリアル