20.8.3.2.2. POST /{cacheName}/{cacheKey}


PUT と同じですが、キャッシュ/キーの値がすでに存在する場合のみ、Http CONFLICT ステータスが返されます(およびコンテンツは更新されません)。

Headers

  • Key-Content-Type: URL に存在するキーのコンテンツタイプ。
  • Content-Type: 送信される Value の MediaType を指定します。
  • performAsync : OPTIONAL true/false(true の場合)は即座に返され、データを独自のクラスターに複製します。一括データの挿入/拡大クラスターに役立ちます。
  • timeToLiveSeconds : OPTIONAL 番号(このエントリーが自動的に削除されるまでの秒数)。パラメーターが送信されていない場合、Red Hat Data Grid は設定のデフォルト値を想定します。負の値を渡すと、常に存在するエントリーが作成されます。
  • maxIdleTimeSeconds : OPTIONAL 番号(このエントリーの最終使用後の秒数)。パラメーターが送信されていない場合、Red Hat Data Grid 設定のデフォルト値。負の値を渡すと、常に存在するエントリーが作成されます。

timeToLiveSeconds または maxIdleTimeSeconds のパラメーターとして 0 を渡す

  • timeToLiveSeconds および maxIdleTimeSeconds の両方が 0 の場合、キャッシュは XML/プログラムで設定したデフォルト のライフスパン 値および maxIdle 値を使用します。
  • maxIdleTimeSeconds のみ が 0 の場合、これはパラメーターとして渡される timeToLiveSeconds 値を使用します(存在しない場合は -1)、XML/プログラムで設定されるデフォルトの maxIdle を使用します。
  • timeToLiveSeconds のみ が 0 の場合、これは XML/プログラムで設定されるデフォルトの ライフ スパンを使用し、maxIdle はパラメーターとして送信されるすべてのものに設定されます(存在しない場合は -1)。

JSON/Protostream 変換

キャッシュがインデックス化される場合、またはとくに application/x-protostream を保存するように設定されている場合、protostream に自動的に変換される JSON ドキュメントを送受信できます。変換を機能させるには、protobuf スキーマを登録する必要があります。

登録は、REST 経由で登録を行うには、getfacl protobuf_metadata キャッシュで POST/PUT を実行します。cURL の使用例:

curl -u user:password -X POST --data-binary @./schema.proto http://127.0.0.1:8080/rest/___protobuf_metadata/schema.proto
Copy to Clipboard Toggle word wrap

JSON ドキュメントを作成する場合は、ドキュメントに対応する protobuf メッセージ の ID を識別するために、特別なフィールド _型 をドキュメントに存在する必要があります。

たとえば、以下のスキーマについて考えてみましょう。

message Person  {
  required string name = 1;
  required int32 age = 2;
}
Copy to Clipboard Toggle word wrap

準拠 JSON ドキュメントは以下のようになります。

{
   "_type": "Person",
   "name": "user1",
   "age": 32
}
Copy to Clipboard Toggle word wrap
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hat
トップに戻る