まえがき

事前準備

ネットワーク構築

仮想サーバ構築

SSL-VPN構築

SSL-VPN接続

仮想サーバ接続

API実行

No	項目	説明
1	実行環境（CentOS）の準備	APIを実行する環境を準備します。あらかじめ初期構築ガイドにしたがい、仮想サーバCentOSを作成し、OSに接続できることが前提となります。
2	curlコマンドの使用方法	本サービスのAPIを実行する上で必要となるcurlコマンドの使用方法を説明します。
3	エンドポイントの設定	APIを発行するエンドポイントについて説明します。
4	APIの実行方法	仮想サーバに対するAPIの実行方法を説明します。
	(1) 仮想サーバの一覧情報取得	仮想サーバの一覧情報を取得する方法を説明します。
	(2) 仮想サーバの状態確認	仮想サーバ一覧の状態を確認する方法を説明します。
	(3) 仮想サーバの停止	仮想サーバの状態を確認し、仮想サーバを停止する方法を説明します。
	(4) 仮想サーバの起動	仮想サーバの状態を確認し、仮想サーバを起動する方法を説明します。
	(5) 仮想サーバの削除	仮想サーバの一覧を確認し、対象の仮想サーバを削除する方法を説明します。
	(6) 仮想サーバの作成	新規に仮想サーバを作成する方法を説明します。
	(7) 仮想サーバの情報更新	作成した仮想サーバの情報(ここでは仮想サーバ名)を更新する方法を説明します。

$ sudo su -

# yum install epel-release # yum install jq

• •  
• [サポートプロトコル]
• DICT, FILE, FTP, FTPS, GOPHER, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, POP3, POP3S, RTMP, RTSP, SCP, SFTP, SMB,  SMBS,  SMTP, SMTPS, TELNET, TFTP
•  

•  

オプション（略称）	オプション（意味）	内容
-d <data>	--data	リクエストボディーを指定します。
-H <header>	--header <header>	ヘッダー情報を指定します。
-k	--insecure	セキュアではないSSL接続および通信を実行することを明示的に許可するためのオプションです。
-S	--show-error	エラーメッセージを表示します。
-s	--silent	進捗やエラーメッセージを抑止します。
-X <command>	--request <command>	HTTPの場合、HTTPサーバーと通信するとき、リクエストメソッドを指定します。メソッドの種類としては、GET、PUT、DELETE、POSTなどがあります。
<url>	<url>	リクエストURLを指定します。

メソッド (-X指定)	ヘッダー (-H指定)	ボディー (-d指定)	操作例
-X GET	-H "X-Auth-Token:  トークン情報" ※トークン情報：APIを実行する際に認証処理の代わりとなる情報	不要	仮想サーバの一覧情報取得 仮想サーバの詳細情報取得
-X DELETE	-H "X-Auth-Token: トークン情報"	不要	仮想サーバの削除
-X POST	-H "X-Auth-Token: トークン情報" -H "Content-Type: application/json"	必要	仮想サーバの作成 仮想サーバの起動・停止
-X PUT	-H "X-Auth-Token: トークン情報"  -H "Content-Type: application/json"	必要	仮想サーバの情報更新

リクエストURL ＝ APIエンドポイント一覧で取得したURL ＋ APIリファレンスのURI

https://compute.jp-west-3.cloud.global.fujitsu.com/v2.1/＜プロジェクトID＞

/servers

https://compute.jp-west-3.cloud.global.fujitsu.com/v2.1/＜プロジェクトID＞/servers

https://networking.jp-west-3.cloud.global.fujitsu.com

/v2.0/networks

https://networking.jp-west-3.cloud.global.fujitsu.com/v2.0/networks

{ " パラメーター名 " : " パラメーターの値 " , … , " パラメーター名 " : " パラメーターの値 " }

{ " user " : {           " userid " : " 1900 " , " username " : " fujitsu " , " password " : " secret " , " groups " : [ " admins " , " users " , " maintainers " ] } }

{ " パラメーター名 " : [ " パラメーターの値 " , … , " パラメーターの値 " ] }

• リージョナルトークン
• グローバルトークン

設定項目	変数名	説明
ドメイン名（契約番号）	DOMAIN_NAME	ポータルログイン時に指定するドメイン名（契約番号）
プロジェクトID	PROJECT_ID	操作対象のプロジェクトID IaaSポータルのAPI実行画面（下記IaaSポータルAPI実行画面参照）により、プロジェクトIDを確認できます。
ユーザー名	USER_NAME	ポータルログイン時に指定するユーザー名
ユーザーパスワード	USER_PW	ポータルログイン時に指定するパスワード
リージョンID	REGION_ID	IaaSポータルログイン時に表示されるリージョンの識別情報 下記IaaSポータル画面の"jp-west-3"の箇所がリージョンIDに該当します。

$ cd <任意のディレクトリ> $ vi get_token.sh

#!/bin/bash   export DOMAIN_NAME=F2aOOXYZ export PROJECT_ID=1234567890abcdefghigklmlopqrstuvwxyz export USER_NAME=fujitsutarou export USER_PW=1234567890qwertyuiop export REGION_ID=jp-west-3 export URL=https://identity.${REGION_ID}.cloud.global.fujitsu.com/v3/auth/tokens   FILE_TOKEN=./token.txt   curl -X POST -si $URL                               \      -H "Content-Type: application/json"  \      -H "Accept:application/json"               \      -d '{"auth":{ "identity":{"methods":["password"],"password": {"user":{"domain":{"name":"'$DOMAIN_NAME'"}, "name": "'$USER_NAME'", "password": "'"$USER_PW"'"}}} }}' |   \ awk '/X-Subject-Token/ {print $2}' | tr -d '\r\n' | tee ${FILE_TOKEN}   export OS_AUTH_TOKEN=`cat ${FILE_TOKEN}`

export URL=https://identity.gls.cloud.global.fujitsu.com/v3/auth/tokens

$ . ./get_token.sh  gAAAAABb0VD5cq8BWfyO6c4qEZ6iJlbDUgtWbDI6OUDNz3CbaE4cP94sRimbbU4qsXbyoaxz1JvfAJ-Rp7_z-pIT0bDwxdojfcJWW8TwoXYuEWpLyh_g3BLIAJnuUwNlshZ7u5LHL9-qa1qDmsFv87EdtpN6aRH7Mie9LRU0RfewVT2eJqSS478

$ echo $OS_AUTH_TOKEN gAAAAABb0VD5cq8BWfyO6c4qEZ6iJlbDUgtWbDI6OUDNz3CbaE4cP94sRimbbU4qsXbyoaxz1JvfAJ-Rp7_z-pIT0bDwxdojfcJWW8TwoXYuEWpLyh_g3BLIAJnuUwNlshZ7u5LHL9-qa1qDmsFv87EdtpN6aRH7Mie9LRU0RfewVT2eJqSS478

$ IDENTITY=https://identity.${REGION_ID}.cloud.global.fujitsu.com $ curl -s $IDENTITY/v3/auth/catalog -X GET -H  "X-Auth-Token: $OS_AUTH_TOKEN" | jq -c '.catalog[]|.endpoints[]|[.name,.url]'

["compute","https://compute.jp-west-3.cloud.global.fujitsu.com/v2.1/1234567890abcdefghigklmlopqrstuvwxyz"] ["keymanagement","https://keymanagement.jp-west-3.cloud.global.fujitsu.com"] ["image","https://image.jp-west-3.cloud.global.fujitsu.com"] ["objectstorage","https://objectstorage.jp-west-3.cloud.global.fujitsu.com/v2/AUTH_1234567890abcdefghigklmlopqrstuvwxyz"] ["networking","https://networking.jp-west-3.cloud.global.fujitsu.com"] ["orchestration","https://orchestration.jp-west-3.cloud.global.fujitsu.com/v1/1234567890abcdefghigklmlopqrstuvwxyz"] ["blockstorage","https://blockstorage.jp-west-3.cloud.global.fujitsu.com/v2/1234567890abcdefghigklmlopqrstuvwxyz"] ["database","https://database.jp-west-3.cloud.global.fujitsu.com/v1.0/1234567890abcdefghigklmlopqrstuvwxyz"] ["blockstorage","https://blockstorage.jp-west-3.cloud.global.fujitsu.com/v3/1234567890abcdefghigklmlopqrstuvwxyz"] ["identity","https://identity.jp-west-3.cloud.global.fujitsu.com"] ["compute","https://compute.jp-west-3.cloud.global.fujitsu.com/v2/1234567890abcdefghigklmlopqrstuvwxyz"] ["nfv","https://nfv.jp-west-3.cloud.global.fujitsu.com"] ["bms","https://baremetal.jp-west-3.cloud.global.fujitsu.com"] ["alarm","https://telemetry.jp-west-3.cloud.global.fujitsu.com"] ["software","https://software.jp-west-3.cloud.global.fujitsu.com"] ["autoscale","https://autoscale.jp-west-3.cloud.global.fujitsu.com"] ["identityv3","https://identity.jp-west-3.cloud.global.fujitsu.com/v3"] ["import-export","https://import-export.jp-west-3.cloud.global.fujitsu.com"]

$ GLOBAL_IDENTITY=https://identity.gls.cloud.global.fujitsu.com $ curl -s $GLOBAL_IDENTITY/v3/auth/catalog -X GET -H  "X-Auth-Token: $OS_AUTH_TOKEN" | jq -c '.catalog[]|.endpoints[]|[.name,.url]'

$ echo $DOMAIN_NAME F2aOOXYZ   $ echo $PROJECT_ID 1234567890abcdefghigklmlopqrstuvwxyz   $ echo $USER_NAME fujitsutarou   $ echo $USER_PW 1234567890qwertyuiop   $ echo $REGION_ID jp-west-3

$ export URL_COMPUTE=https://compute.${REGION_ID}.cloud.global.fujitsu.com/v2.1/${PROJECT_ID} $ echo $URL_COMPUTE https://compute.jp-west-3.cloud.global.fujitsu.com/v2.1/1234567890abcdefghigklmlopqrstuvwxyz

• URI ：/servers
• メソッド： -X GET
• リクエストヘッダー：-H "X-Auth-Token: $OS_AUTH_TOKEN"
• リクエストボディー：なし

$ curl -Ss ${URL_COMPUTE}/servers -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" | jq .

{   "servers": [     {       "id": "13c4b868-3809-4e2c-9340-d5c8c5963612",       "links": [         {           "href": "https://compute.jp-west-3.cloud.global.fujitsu.com/v2.1/1234567890abcdefghigklmlopqrstuvwxyz/servers/13c4b868-3809-4e2c-9340-d5c8c5963612",           "rel": "self"         },         {           "href": "https://compute.jp-west-3.cloud.global.fujitsu.com/1234567890abcdefghigklmlopqrstuvwxyz/servers/13c4b868-3809-4e2c-9340-d5c8c5963612",           "rel": "bookmark"         }       ],       "name": "centos7_V1"     }, (省略)

$ curl -Ss ${URL_COMPUTE}/servers -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" | jq '.servers[] | {"name":.name, "id":.id}'

{   "name": "centos7_V1",      ※以降の説明では、"centos7_V1"を操作対象に扱います。   "id": "13c4b868-3809-4e2c-9340-d5c8c5963612" } {   "name": "centos7_API2",   "id": "d2fd64eb-995e-426d-a7ae-4739e90b7091" } {   "name": "centos7-old",   "id": "d2238f1d-5075-451f-b54a-4afa528b5132" }

$ export SERVER_ID=13c4b868-3809-4e2c-9340-d5c8c5963612

$ export SERVER_ID=13c4b868-3809-4e2c-9340-d5c8c5963612

$ curl -Ss ${URL_COMPUTE}/servers/${SERVER_ID} -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" | jq .

{   "server": {     "OS-EXT-STS:task_state": null,     "addresses": {       "ssl-vpn-network": [         {           "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:d5:ad:dd",           "version": 4,           "addr": "192.168.0.7",           "OS-EXT-IPS:type": "fixed"         }       ]     },     "links": [       {         "href": "https://compute.jp-west-3.cloud.global.fujitsu.com/v2.1/1234567890abcdefghigklmlopqrstuvwxyz/servers/13c4b868-3809-4e2c-9340-d5c8c5963612",         "rel": "self"       },       {         "href": "https://compute.jp-west-3.cloud.global.fujitsu.com/1234567890abcdefghigklmlopqrstuvwxyz/servers/13c4b868-3809-4e2c-9340-d5c8c5963612",         "rel": "bookmark"       }     ],     "image": "",     "OS-EXT-STS:vm_state": "active",     "OS-EXT-SRV-ATTR:instance_name": "inst-0000b787",     "OS-SRV-USG:launched_at": "2018-10-25T01:47:05.000000",     "flavor": {       "id": "1346eb39-10ef-405d-bef6-f451fe3b12d1",       "links": [         {           "href": "https://compute.jp-west-3.cloud.global.fujitsu.com/1234567890abcdefghigklmlopqrstuvwxyz/flavors/1346eb39-10ef-405d-bef6-f451fe3b12d1",           "rel": "bookmark"         }       ]     },     "id": "13c4b868-3809-4e2c-9340-d5c8c5963612",     "security_groups": [       {         "name": "ssl-vpn-SG"       }     ],     "user_id": "1a737cf857f9497cbb7a4e903c9be38d",     "OS-DCF:diskConfig": "MANUAL",     "accessIPv4": "",     "accessIPv6": "",     "progress": 0,     "OS-EXT-STS:power_state": 1,     "OS-EXT-AZ:availability_zone": "jp-west-3a",     "metadata": {},     "status": "ACTIVE",     "updated": "2018-10-25T01:47:05Z",     "hostId": "098d035ce24ab4defbe355b267cc9ba579520c60f4dcb69ec0a27cda",     "OS-EXT-SRV-ATTR:host": "sv-01-01-11-03.management.jp-west-3.local",     "OS-SRV-USG:terminated_at": null,     "key_name": "test-keypair",     "OS-EXT-SRV-ATTR:hypervisor_hostname": "sv-01-01-11-03.management.jp-west-3.local",     "name": "centos7_V1",     "created": "2018-10-25T01:46:53Z",     "tenant_id": "1234567890abcdefghigklmlopqrstuvwxyz",     "os-extended-volumes:volumes_attached": [       {         "id": "067438e8-3760-4b32-ad2c-e24fa773dba6"       }     ],     "config_drive": ""   } }

$ curl -Ss ${URL_COMPUTE}/servers/${SERVER_ID} -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" | jq '.server | {"name": .name, "id": .id, "status": .status}'

{   "name": "centos7_V1",   "id": "13c4b868-3809-4e2c-9340-d5c8c5963612",   "status": "ACTIVE" }

$ curl -Ss ${URL_COMPUTE}/servers/${SERVER_ID} -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" | jq '.server | {"name": .name, "id": .id, "status": .status}'

{   "name": "centos7_V1",   "id": "13c4b868-3809-4e2c-9340-d5c8c5963612",   "status": "ACTIVE" }

$ curl -Ss ${URL_COMPUTE}/servers/${SERVER_ID}/action -X POST -H "X-Auth-Token: $OS_AUTH_TOKEN" -H "Content-Type: application/json" -d '{"os-stop" : null }' | jq .

$ curl -Ss ${URL_COMPUTE}/servers/${SERVER_ID} -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" | jq '.server | {"name": .name, "id": .id, "status": .status}'

{   "name": "centos7_V1",   "id": "13c4b868-3809-4e2c-9340-d5c8c5963612",   "status": "SHUTOFF" }

$ curl -Ss ${URL_COMPUTE}/servers/${SERVER_ID} -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" | jq '.server | {"name": .name, "id": .id, "status": .status}'

{   "name": "centos7_V1",   "id": "13c4b868-3809-4e2c-9340-d5c8c5963612",   "status": "SHUTOFF" }

$ curl -Ss ${URL_COMPUTE}/servers/${SERVER_ID}/action -X POST -H "X-Auth-Token: $OS_AUTH_TOKEN" -H "Content-Type: application/json" -d '{"os-start" : null }' | jq .

$ curl -Ss ${URL_COMPUTE}/servers/${SERVER_ID} -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" | jq '.server | {"name": .name, "id": .id, "status": .status}'

{   "name": "centos7_V1",   "id": "13c4b868-3809-4e2c-9340-d5c8c5963612",   "status": "ACTIVE" }

$ echo $SERVER_ID 13c4b868-3809-4e2c-9340-d5c8c5963612

$ curl -Ss ${URL_COMPUTE}/servers/${SERVER_ID} -X DELETE -H "X-Auth-Token: $OS_AUTH_TOKEN" | jq .

$ curl -Ss ${URL_COMPUTE}/servers -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" | jq '.servers[] | {"name": .name, "id": .id}'

{   "name": "centos7_API2",   "id": "d2fd64eb-995e-426d-a7ae-4739e90b7091" } {   "name": "centos7-old",   "id": "d2238f1d-5075-451f-b54a-4afa528b5132" }

名前			説明
server	name		仮想サーバの名前として、"centos7_API" を指定します。
	flavorRef		フレーバのID を指定します(※)。 本ガイドでは、"P3-1"タイプのフレーバIDを指定します。
	block_device_mapping_v2	boot_index	ブートインデックスには、"0 "を指定します。
		uuid	イメージのIDを指定します(※)。 本ガイドでは、"CentOS7 64bit"のイメージIDを指定します。
		volume_size	"30"(GB)を指定します。
		device_name	"/dev/vda"を指定します。
		source_type	"image"を指定します。
		destination_type	"volume"を指定します。
	key_name		既に作成しているキーペア名を指定します。
	networks	uuid	ネットワークのIDを指定します(※)。 本ガイドでは、"ssl-vpn"のネットワークのIDを指定します。
	security_groups	name	セキュリティグループの名前を指定します(※)。 本ガイドでは、"ssl-vpn-SG"に対応する名前を指定します。

$ export URL_COMPUTE=https://compute.$REGION_ID.cloud.global.fujitsu.com/v2.1/$PROJECT_ID $ curl -Ss $URL_COMPUTE/flavors -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" | jq '.flavors[] | {"name": .name, "id": .id}'

{   "name": "M3-4",   "id": "00f26551-ef1c-49a6-9725-b885c31d4d25" } {   "name": "S3-8",   "id": "13246307-6b41-47a1-aaf2-a985398c1722" } {   "name": "P3-1",   "id": "1346eb39-10ef-405d-bef6-f451fe3b12d1" } (省略)

$ export FLAVOR_ID=1346eb39-10ef-405d-bef6-f451fe3b12d1

$ export URL_IMAGE=https://image.jp-west-3.cloud.global.fujitsu.com $ curl $URL_IMAGE/v2/images -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" | jq '.images[] | {"name": .name, "id":.id}'

(省略) {   "name": "Windows Server 2012 R2 SE 64bit (English) 03",   "id": "24228262-2bd0-4956-a9c3-bef4ce709e11" } {   "name": "CentOS 7.3 64bit (English) 01",   "id": "a0fe2e71-acb9-479d-b7f9-0270d1ef4fb1" } {   "name": "Windows Server 2016 SE 64bit + SQL Server 2016 SE (Japanese) 01",   "id": "c45e5913-8194-4637-92c1-61835f037d4f" }

$ export IMAGE_ID=a0fe2e71-acb9-479d-b7f9-0270d1ef4fb1

$ export URL_NW=https://networking.jp-west-3.cloud.global.fujitsu.com $ curl -Ss $URL_NW/v2.0/networks -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" | jq '.networks[] | {"name": .name, "id": .id}'

{   "name": "K5NET-LOCAL-41160-41174",   "id": "08fab04b-d93c-4cc7-b726-2fb6405c7e95" } {   "name": "fip-net",   "id": "5234aa88-9cd8-49bd-b613-d0006eacb87b" } {   "name": "ssl-vpn-network",   "id": "acf387aa-8c4e-4728-a560-14a11661f65e" } {   "name": "K5NET-INTERNET-41160-41174",   "id": "b1d7558c-5674-487a-9cf6-8931ece1ce50"

$ export NETWORK_ID=acf387aa-8c4e-4728-a560-14a11661f65e

$ curl -Ss $URL_NW/v2.0/security-groups -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" | jq '.security_groups[] | {"name": .name, "id": .id}'

{   "name": "ssl-vpn-SG",   "id": "0e3c0936-bf88-406d-82fb-0d26a0b12ee0" } {   "name": "default",   "id": "9290fea4-56fc-4030-9d37-03d3c8222e1b" }

$ export SG_NAME=ssl-vpn-SG

$ export VM_NAME=centos7_API $ export VOL_SIZE=30 $ export DEVICE_NAME=/dev/vda $ export SOURCE=image $ export KEYNAME=test-keypair

$ echo $VM_NAME $ echo $FLAVOR_ID $ echo $IMAGE_ID $ echo  $VOL_SIZE $ echo $DEVICE_NAME $ echo $SOURCE $ echo $KEYNAME $ echo $NETWORK $ echo $SG_NAME

{"server": {"security_groups": [{"name": "0e3c0936-bf88-406d-82fb-0d26a0b12ee0"}], "OS-DCF:diskConfig": "MANUAL", "id": "1c84de54-78a3-48c0-bdd6-654abafc2d6f", "links": [{"href": "https://compute.jp-west-3.cloud.global.fujitsu.com/v2.1/1234567890abcdefghigklmlopqrstuvwxyz/servers/1c84de54-78a3-48c0-bdd6-654abafc2d6f", "rel": "self"}, {"href": "https://compute.jp-west-3.cloud.global.fujitsu.com/1234567890abcdefghigklmlopqrstuvwxyz/servers/1c84de54-78a3-48c0-bdd6-654abafc2d6f", "rel": "bookmark"}], "adminPass": "gnSgE2mGw3Bn"}}

$ curl -Ss ${URL_COMPUTE}/servers/detail -X GET  \ >-H "X-Auth-Token: $OS_AUTH_TOKEN" | jq '.servers[] | {name:.name, id:.id, status: .status}'

{   "name": "centos7_API",   "id": "1c84de54-78a3-48c0-bdd6-654abafc2d6f",   "status": "ACTIVE" } (省略)

$ curl -Ss ${URL_COMPUTE}/servers/${SERVER_ID} -X PUT -H "X-Auth-Token: $OS_AUTH_TOKEN"  -H "Content-Type: application/json" -d '{"server": {"name": "centos7_update" }}' | jq .

{   "server": {     "status": "ACTIVE",     "updated": "2018-11-06T09:38:31Z",     "hostId": "216321eb3c71b5f95ac101bed3dcf0ed4af24417c83e73444336879f",     "user_id": "1a737cf857f9497cbb7a4e903c9be38d",     "name": "centos7_update",     "links": [       {         "href": "https://compute.jp-west-3.cloud.global.fujitsu.com/v2.1/1234567890abcdefghigklmlopqrstuvwxyz/servers/1c84de54-78a3-48c0-bdd6-654abafc2d6f",         "rel": "self"       },       {         "href": "https://compute.jp-west-3.cloud.global.fujitsu.com/1234567890abcdefghigklmlopqrstuvwxyz/servers/1c84de54-78a3-48c0-bdd6-654abafc2d6f",         "rel": "bookmark"       }     ], (省略)

$ curl -Ss ${URL_COMPUTE}/servers/${SERVER_ID} -X PUT \ -H "X-Auth-Token: $OS_AUTH_TOKEN"  \ -H "Content-Type: application/json" \ -d @- <<EOF {         "server":                {                           "name": "centos7_update"                } } EOF

$ curl -Ss ${URL_COMPUTE}/servers -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" | jq '.servers[] | {name: .name, id: .id}'

{   "name": "centos7_update",   "id": "1c84de54-78a3-48c0-bdd6-654abafc2d6f" } (省略)

•  

All Rights Reserved, Copyright FUJITSU LIMITED 2018