associations
内容
casp1032jp
内容
Associations/Relationリソースを使用して、関連付けを作成、読み取り、削除します。
注:
Associationsは更新できません。任意の association を変更するには、既存の association を削除して新しい関連付けを作成します。Association の操作は、一度に 1 つの SpectroSERVER
に制限されます。- ベース URLhttp://<hostname><:portnumber>/spectrum/restful/associations/relation注:Associations 名詞はパススルー名詞です。また、associations の作成、読み取り、削除を行う Relation 名詞を指定する必要もあります。
POST associations
POST associations は関連付けを作成します。以下の 2 つのモデル間で、特定の関係が作成されます。同じ
SpectroSERVER
上のモデルのみ関連付けることができます。- URLhttp://<hostname><:portnumber>/spectrum/restful/associations/relation/<rel_handle>/leftmodel/<LMhandle>/rightmodel/<RMhandle>
- HTTP メソッドPOST
- ボディなし
- ボディ コンテンツ使用されません
- ヘッダapplication/xml、application/json
- 出力関連付け情報をリストする XML または JSON
URL パラメータ
- rel_handle関係ハンドルを指定します。
- LMhandle関係の左のモデルのハンドルを指定します。
- RMhandle関係の右のモデルのハンドルを指定します。
注:
左または右のモデル ハンドルを取得するには、CLI の show associations コマンドを以下のように使用できます。show associations mh=<model_handle_of_device/port>
このコマンドの詳細については、「」セクションを参照してください。
GET associations
GET associations は特定の関係とモデルの関連付けを返します。関連付けは、モデル ハンドルがある関連付け側に基づいて読み取られます。
- URLhttp://<hostname><:portnumber>/spectrum/restful/associations/relation/<rel_handle>/model/<model_handle>?side=[left|right]
- HTTP メソッドGET
- ボディなし
- ボディ コンテンツ使用されません
- ヘッダapplication/xml、application/json
- 出力関連付け情報をリストする XML または JSON
URL パラメータ
- rel_handle関係ハンドルを指定します。
- model_handle関係のモデルのハンドルを指定します。
- side=[left|right]モデル ハンドルがある関連付けの側を指定します。
DELETE associations
DELETE associations は、2 つのモデル間の特定の関係を削除することによって、関連付けを削除します。
- URLhttp://<hostname><:portnumber>/spectrum/restful/associations/relation/<rel_handle>/leftmodel/<LMhandle>/rightmodel/<RMhandle>
- HTTP メソッドDELETE
- ボディなし
- ボディ コンテンツ使用されません
- ヘッダapplication/xml、application/json
- 出力成功または失敗を示す XML または JSON のリスト
URL パラメータ
- rel_handle関係ハンドルを指定します。
- LMhandle関係の左のモデルのハンドルを指定します。
- RMhandle関係の右のモデルのハンドルを指定します。