前のトピック: removeAttachment

次のトピック: CRUD 操作用のサンプル URI パス

REST HTTP メソッド

REST API は、リソースを操作する以下の HTTP メソッドをサポートします。

このメソッドの基本的なセットを CRUD と呼びます。 各メソッドはすべての CA SDM リソース上で同じように動作します。 HTTP クライアント ライブラリが必要ですが、これはほとんどのプログラミング言語で利用できます。 以下のタスクを行う場合、HTML クライアント ライブラリを使用します。

Majic オブジェクト定義を更新し、CA SDM をリサイクルしたら、製品は該当する POJO (Plain Old Java Objects)を自動的に再生成し、REST Tomcat webapps ディレクトリに再展開します。

注: pdm_rest_util コマンド ライン ユーティリティを使用すると、REST Web サービスが必要とする Java コードを、手動で生成、コンパイル、および展開できます。

重要: 応答しない属性リクエストは、NULL 属性値を示します。 REST の応答では、NULL 属性値が表示されないため、クライアント コードを適宜変更してください。

REST Web サービスは、ローカル サーバ上の専用 domsrvr への接続を可能にすることで、ユーザに拡張性のある構成とさらなる柔軟性を提供します。 デフォルトでは、CA SDM リリース 12.7 での domsrvr 変数は NX_REST_WEBSERVICE_DOMSRVR です。 NX.env を編集することでこの設定を変更できます。

CA SDM では REST のサンプル モバイル ユーザ インターフェースは無効にされており、REST Web サービスを介して Majic ファクトリがデフォルトで公開されています。

重要: REST API は、DOUBLE タイプの Majic 属性をサポートしません。

以下の表に、REST API がリソースに対して HTTP メソッドを使用する方法を説明します。

リソース

CREATE

READ

UPDATE

DELETE

コレクション URL

例: http://mywebsite.com/resources/

コレクションにエントリを作成します。 新しいエントリに自動的に URL を割り当て、操作によってそれを返します。

URL およびコレクション メンバの他の詳細をリスト表示します。

N/A

N/A

エレメント URL

例: http://mywebsite.com/resources/item1

N/A

アドレス指定されたコレクション メンバの表現を取得します。

コレクションのアドレス指定されたメンバを更新し、メンバが存在しない場合は作成します。

アドレス指定されたコレクション メンバを削除します。