Skip to main content
12.3
本製品の最新リリースがご利用いただけます。
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

イニシエータを作成する

共同作成者

CreateInitiators を使用すると、複数の新しいイニシエータ IQN または World Wide Port Name ( WWPN )を作成し、オプションでエイリアスと属性を割り当てることができます。CreateInitiators を使用して新しいイニシエータを作成すると、ボリュームアクセスグループに追加することもできます。

パラメータで指定されたイニシエータのいずれかの作成に失敗した場合、メソッドからエラーが返され、イニシエータは作成されません(一部だけを完了することはできません)。

パラメータ

このメソッドの入力パラメータは次のとおりです。

名前 説明 を入力します デフォルト値 必須

イニシエータ

新しい各イニシエータの特性を含むオブジェクトのリスト。オブジェクト:

  • alias :(任意)このイニシエータに割り当てるフレンドリ名。文字列

  • attributes :(任意)このイニシエータに割り当てる一連の JSON 属性。( JSON オブジェクト)。

  • chapUsername :(オプション)このイニシエータの一意の CHAP ユーザ名作成時に指定せず、 requireChap が true の場合、イニシエータ名( IQN )が使用されます文字列

  • initiatorSecret :(オプション)イニシエータの認証に使用する CHAP シークレット作成時に指定せず、 requireChap が true の場合、ランダムに生成されたシークレットが使用されます文字列

  • name :(必須)作成するイニシエータ( IQN または WWPN )の名前。文字列

  • re quireChap: ( オプション ) このイニシエータのセッションログイン時に CHAP が必要な場合は 'Trueブール値

  • targetSecret :(オプション)ターゲットの認証に使用される CHAP シークレット(相互 CHAP 認証を使用する場合)作成時に指定せず、 requireChap が true の場合、ランダムに生成されたシークレットが使用されます文字列

  • 「 virtualNetworkID 」:(任意)このイニシエータに関連付けられた仮想ネットワーク ID のリスト。仮想ネットワークを定義した場合、このイニシエータはそれらの仮想ネットワークにしかログインできません。仮想ネットワークを定義しない場合、このイニシエータはすべてのネットワークにログインできます。

  • volumeAccessGroupID :(オプション)作成した新しいイニシエータを追加するボリュームアクセスグループの ID整数

JSON オブジェクトの配列

なし

はい。

戻り値

このメソッドの戻り値は次のとおりです。

名前

説明

を入力します

イニシエータ

作成された新しいイニシエータの詳細を示すオブジェクトのリスト。

エラー

このメソッドでは、次のエラーが返されることがあります。

名前

説明

xInitiatorExists の一例です

選択したイニシエータ名がすでに存在する場合に返されます。

要求例

このメソッドの要求例を次に示します。

{
  "id": 3291,
  "method": "CreateInitiators",
  "params": {
    "initiators": [
      {
        "name": "iqn.1993-08.org.debian:01:288170452",
        "alias": "example1"
      },
      {
        "name": "iqn.1993-08.org.debian:01:297817012",
        "alias": "example2"
      }
    ]
  }
}

応答例

このメソッドの応答例を次に示します。

{
  "id": 3291,
  "result": {
    "initiators": [
      {
        "alias": "example1",
        "attributes": {},
        "initiatorID": 145,
        "initiatorName": "iqn.1993-08.org.debian:01:288170452",
        "volumeAccessGroups": []
      },
      {
        "alias": "example2",
        "attributes": {},
        "initiatorID": 146,
        "initiatorName": "iqn.1993-08.org.debian:01:297817012",
        "volumeAccessGroups": []
      }
    ]
  }
}

新規導入バージョン

9.6

詳細については、こちらをご覧ください