リソースの操作

RESTful APIはステートレスです。リソースマネージャーは、報告されるリソースの状態をリソースの説明として保持します。クライアントはアプリケーションの状態を保持します。クライアントはリソースをローカルで操作する可能性がありますが、PUTまたはPOSTが実行されるまで、リソースマネージャーが把握しているリソースは変更されません。

操作

HTTP動詞

説明

作成

POST

リソースのURI(ペイロード=リソースデータ)

新しいリソースを作成します。同期POSTは、新しく作成したリソースを返します。非同期POSTは、LocationヘッダーのTaskResource URIを返します。このURIは、POST操作の進行状況を追跡します。

読み取り

GET

リソースのURI

要求されたリソースの表現を返します。

更新

PUT

リソースのURI(ペイロード=更新データ)

既存のリソースを更新します。

PATCH

リソースのURI(ペイロード=更新データ)

リソースの一部を更新します。たとえば、リソースの1つのフィールドのみを更新する必要がある場合です。

削除

DELETE

リソースのURI

指定されたリソースを削除します。