サーバにNICを追加します。
本APIは、非同期で実行されます。本APIの実行に成功すると、処理の実行中はL-Platformの状態が構成変更中(RECONFIG_ING)に遷移し、処理が完了するとL-Platformの状態が正常稼働中(NORMAL)に戻ります。
L-Platformの状態が構成変更中の場合は、L-Platformに対する操作ができません。
L-Platformの状態をGetLPlatformStatusで監視し、正常稼働中に遷移するのを待ってから次の操作を行ってください。
サーバ仮想化ソフトウェアが、VMware、Hyper-V、RHEL-KVM、およびOVM for SPARCのサーバにだけ実行可能です。
対象のサーバにスナップショットが存在する場合、NICの追加はできません。
以下の場合、本APIは実行できません。
対象のL-Platform内にBladeLogicで管理されていないSolarisゾーンのサーバが存在する場合
対象のサーバがBladeLogicで管理されていないOVM for SPARC管理のサーバである場合
注意
NICを追加した場合、ゲストOSへのIPアドレスの自動設定は行われません。
NICを追加したあと、ゲストOSにログインし、L-Serverの詳細情報に表示されたIPアドレスを手動でゲストOSに設定してください。
IPアドレスを設定したあと、追加したNICが外部機器と正しく通信できることを確認してください。
複数のNICを追加する場合は、1つずつ追加してください。
対象のサーバがOVM for SPARC管理のサーバである場合、本製品の管理情報の追加・削除だけが実行され、VMゲストのNICの実体は追加・削除されません。
NICの実体の追加・削除は、サーバ仮想化ソフトウェアで実施してください。
リクエストパラメーター
パラメーター名 | 項目 | 項目説明 |
---|---|---|
Version | 説明 | L-Platform APIのバージョンID |
型 | string ASCII | |
設定内容 | 固定。"2.0"を指定してください。 | |
Locale | 説明 | L-Platform APIと通信するための言語。ISO 639で規定されている言語コードを指定します。 |
型 | string ASCII | |
設定内容 | 以下から選択します。 | |
Action | 説明 | 実行するL-Platform APIの名称 |
型 | string ASCII | |
設定内容 | 固定。"CreateNic"を指定してください。 | |
userId | 説明 | L-Platform APIを実行するユーザーID |
型 | string ASCII | |
設定内容 | 31文字以内 | |
orgId | 説明 | L-Platform APIを実行するユーザーのテナント名 |
型 | string ASCII | |
設定内容 | 32文字以内 | |
lplatformId | 説明 | ネットワークを追加するL-PlatformのID |
型 | string ASCII | |
設定内容 | 32文字以内 | |
lserverId | 説明 | サーバID |
型 | string ASCII | |
設定内容 | 32文字以内 | |
networkId | 説明 | 追加したNICを接続するネットワークID |
型 | string ASCII | |
設定内容 | 32文字以内 | |
[ipAddress] | 説明 | 追加したNICに割り当てるIPアドレス。 |
型 | string ASCII | |
設定内容 | - |
レスポンス
《ステータスコード》
正常に終了した場合に"200 OK"を返します。
《XML》
<?xml version="1.0" encoding="UTF-8"?> <CreateNicResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com"> <responseMessage>[メッセージ]</responseMessage> <responseStatus>[ステータス]</responseStatus> </CreateNicResponse>
《要素》
要素名 | 項目 | 項目説明 |
---|---|---|
CreateNicResponse | 説明 | レスポンスの情報を持つ要素 |
型 | なし | |
出現回数 | 1 | |
responseMessage | 説明 | メッセージ。リクエストが正しく処理されたかどうかを表します。 |
型 | string UTF-8 | |
出現回数 | 1 | |
responseStatus | 説明 | ステータス。リクエストが正常に処理されたかどうかを表します。正常に処理された場合は "SUCCESS" が返却されます。それ以外の場合はエラーコードが返却されます。 |
型 | string ASCII | |
出現回数 | 1 |
サンプルレスポンス
<?xml version="1.0" encoding="UTF-8"?> <CreateNicResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com"> <responseMessage>PAPI00000 Processing was completed.</responseMessage> <responseStatus>SUCCESS</responseStatus> </CreateNicResponse>