統合ガイド › Web サービス API リファレンス ガイド › 有効なオブジェクト › group オブジェクト › create メソッド（group オブジェクト）

create メソッド（group オブジェクト）

説明

グループをグリッド コントローラのローカル ディレクトリ サービス データベースに追加します。 新しいグループはメンバなしで作成されます。

構文

/api/v2/group/create?group=group&vdc=controller-name 

引数

group

作成するローカル グループの名前

vdc

ターゲットの仮想データ センターの名前

トランザクション タイプ

同期

リクエスト タイプ

GET

例

mygroup という名前のローカル グループを作成します

GET
http://192.168.123.200/api/v2/group/create?group=mygroup&vdc=mygrid
 

サンプル出力

JSON：

{
   "message" : "Creating group mygroup...¥n"
} 

XML：

<message>Creating group mygroup...
</message>

HTTP エラー コード

400

エンティティ vdc mygrid が見つかりません
WS_API アプリケーションに設定されていない VDC 名が指定されていました。

400.4

必要な引数（app）がありません。
- 引数 group=group がありません。

注： この API は WS_API_r6-1.0.6-1 以降で使用できます。