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

イニシエータを作成する

共同作成者
PDF

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

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

パラメータ

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

名前 製品説明 タイプ デフォルト値 必須

イニシエータ

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

  • alias：（オプション）このイニシエータに割り当てるフレンドリ名。文字列

  • attributes：（オプション）このイニシエータに割り当てる一連のJSON属性（ JSON オブジェクト）。

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

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

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

  • requireChap：（オプション）このイニシエータのセッションログイン時にCHAPを必須にする場合はTrueブール値

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

  • virtualNetworkIDs：（オプション）このイニシエータに関連付けられている仮想ネットワーク識別子のリスト。仮想ネットワークを定義した場合、このイニシエータはそれらの仮想ネットワークにしかログインできません。仮想ネットワークを定義しない場合、このイニシエータはすべてのネットワークにログインできます。

  • 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

詳細情報

ListInitiators の 1 つです