本文へジャンプします。

ニフクラ APIリファレンス

クラウド トップ>APIのご利用にあたって>ニフクラREST API>NiftyRegisterInstancesWithSeparateInstanceRule

NiftyRegisterInstancesWithSeparateInstanceRule

処理概要

指定したサーバーセパレートを、指定したサーバーへ適用します。1つのサーバーセパレートに適応可能なサーバーの上限数は、2台となります。
サーバーセパレートを指定するためには、サーバーセパレート名が必要です。削除済みのサーバーセパレートを指定した、管理外のサーバーセパレートを指定したなど、無効なサーバーセパレートを指定した場合は、エラーが返されます。

またサーバーを指定するためには、サーバー名またはサーバーユニークIDが必要です。指定したファイアウォールグループに適用されていないサーバーを指定した、削除済みのサーバーを指定した、管理外のサーバーを指定したなど、無効なサーバーを指定した場合は、エラーが返されます。

指定するパラメーター

パラメーター 説明 必須 サンプル値
SeparateInstanceRuleName 対象のサーバーセパレート名
Type : String
separate1
InstanceId.n サーバー名
Type : String

(サーバーユニークIDといずれか)
 
InstanceUniqueId.n サーバーユニークID
Type : String

(サーバー名といずれか)
 

応答フィールド

フィールド 説明 サンプル値
NiftyRegisterInstancesWithSeparateInstanceRuleResponse NiftyRegisterInstancesWithSeparateInstanceRuleResponseレスポンス
Type : NiftyRegisterInstancesWithSeparateInstanceRuleResponseType
Ancestor : なし
Children : requestId, instancesSet
 
requestId リクエスト識別子
Type : xsd : string
Ancestor : NiftyRegisterInstancesWithSeparateInstanceRuleResponse
Children : なし
ac501097-4c8d-475b-b06b-a90048ec181c
instancesSet 追加に成功したサーバー情報セット
Type : InstanceIdSetType
Ancestor : NiftyRegisterInstancesWithSeparateInstanceRuleResponse
Children : item
 
item 追加に成功したサーバー情報
Type : InstanceIdType
Ancestor : instancesSet
Children : instanceId, instanceUniqueId
 
instanceId サーバー名
Type : xsd : string
Ancestor : item
Children : なし
 
instanceUniqueId サーバーユニークID
Type : xsd : string
Ancestor : item
Children : なし
 

リクエストサンプル

https://jp-east-1.computing.api.nifcloud.com/api/?Action=NiftyRegisterInstancesWithSeparateInstanceRule&SeparateInstanceRuleName=separateRule1&InstanceId.1=server001&InstanceId.2=server002&&CommonParams

応答サンプル

<NiftyRegisterInstancesWithSeparateInstanceRuleResponse xmlns="https://cp.cloud.nifty.com/api/">
  <requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
  <instancesSet>
    <item>
      <instanceId>server01</instanceId>
      <instanceUniqueId>i-a1b2c3d4e</instanceUniqueId>
    </item>
    <item>
      <instanceId>server02</instanceId>
      <instanceUniqueId>i-a6b7c8d9e</instanceUniqueId>
    </item>
  </instancesSet>
</NiftyRegisterInstancesWithSeparateInstanceRuleResponse>

ニフティクラウド サイト内検索

APIメニュー

  • ツイッターでフォローしてください
  • ニフクラ公式フェイスブックページ

推奨画面サイズ 1024×768 以上