Momento Cache の HTTP API リファレンス
Momentoは、私たちのSDKを使用できないアプリケーションや、curlやfetchのようなものを使用したいアプリケーションのためにHTTP APIインターフェイスを提供します。例えば、Cloudflare Workers、Fastly Compute@Edgeなどのエッジコンピュートサービスにデプロイする場合、このAPIはあなたのためにあります。その他のアプリケーションは、Momento's SDK clients を使用する必要があります。
私たちのPostmanの公開ワークスペースでもOpen API Specificationを見ることができます。
このドキュメントでは、HTTPリクエスト構文の実装方法については説明しません。
認証
各接続には、Momento コンソール または ホスティングしているトークン "自動販売機" マイクロサービス を介して生成された Momento 認証トークンが必要です。Momento auth トークンは、Momento サービスへのアクセスを制御し、有効期限を設定したり、特定のリソースへのアクセスを許可/制限することができます。
リージョン
Momento HTTP API にアクセスするには、API トークンとキャッシュのリージョンで以下のエンドポイントのいずれかを使用します。必要なリージョンが見つからない場合は、ご相談ください。サポートまでご連絡ください。
値の取得
キャッシュからスカラー値を取得する。
Request
- Path: /cache/{cacheName}
- HTTP Method: GET
Path Parameters
Parameter name | Required? | Type | Description |
---|---|---|---|
cacheName | yes | URL-safe string | 操作するキャッシュの名前。 |
Query Parameters
Parameter name | Required? | Type | Description |
---|---|---|---|
key | no** | URL-safe string | キャッシュから取得するキー。 |
key_base64 | no** | Base64 URL-encoded binary key | キャッシュから取得するキー。 |
token | no*** | URL-safe string | リクエストの認証/認可に使用する Momento 認証トークン (文字列形式)。 |
** キャッシュにアクセスするキーを指定する必要があります。これは、URLセーフ文字列を指定するkey queryパラメータか、Base64でURLエンコードされたキーを指定するkey_base64パラメータのどちらかになります。
*** リクエストの認証/認可に使用する Momento auth トークンを指定する必要があります。これは、トークンクエリパラメータか Authorization ヘッダで指定します。
Headers
Header name | Required? | Type | Description |
---|---|---|---|
Authorization | no*** | URL-safe string | 文字列形式の Momento auth トークンは、リクエストの認証/認可に使用されます。 |
*** リクエストの認証/認可に使用する Momento auth トークンを指定する必要があります。これは、トークンクエリパラメータか Authorization ヘッダで指定します。
Responses
Hit
Status Code: 200 OK
- Content-Type: octet-stream
- Body: 指定したキーに格納されているバイナリ値。
Miss
Status Code: 404 Not Found
- 「キーが見つかりません」は、そのキーがキャッシュに存在しないことを示し、「キャッシュが見つかりません」は、指定されたキャッシュが存在しないことを示します。
Error
Status Code: 400 Bad Request
- このエラータイプは通常、リクエストの指定が正しくないことを示します。詳細はメッセージ本文を参照ください。
Status Code: 401 Unauthorized
- このエラータイプは通常、渡された Momento 認証トークンが無効か期限切れであることを示します。詳細はメッセージ本文を参照ください。
Status Code: 403 Forbidden
- このエラータイプは通常、渡された Momento 認証トークンが、試行したリソースへの必要なアクセスを許可していないことを 示します。詳細はメッセージ本文を参照ください。
Status Code: 429 Too Many Requests
- このエラータイプは通常、アカウントの上限を超えたことを示します。詳細はメッセージの本文を参照するか、Momento サポートに連絡して限度額の引き上げを依頼してください。
Status Code: 500 Internal Server Error
- このエラータイプは通常、サービスに問題が発生していることを示します。Momentoサポートにお問い合わせください。
Set Value
キャッシュにスカラー値を設定します。
Request
- Path: /cache/{cacheName}
- HTTP Method: PUT
Body
- Content-Type: octet-stream
- リクエストのボディは、指定されたキーのキャッシュに格納されるバイナリ値を含むべきです。
Path Parameters
Parameter name | Required? | Type | Description |
---|---|---|---|
cacheName | yes | URL-safe string | 操作するキャッシュの名前 |
Query Parameters
Parameter name | Required? | Type | Description |
---|---|---|---|
key | no** | URL-safe string | キャッシュから取得するキー。 |
key_base64 | no** | Base64 URL-encoded binary key | キャッシュから取得するキー。 |
token | no*** | URL-safe string | リクエストの認証/認可に使用する Momento 認証トークン (文字列形式)。 |
ttl_seconds | yes | Integer | キーに設定するTTLを秒単位で指定する。TTLについては、Expire Data with Time-to-Liveを参照ください。 |
** キャッシュにアクセスするキーを指定する必要があります。これは、URLセーフ文字列を指定するkey queryパラメータか、Base64でURLエンコードされたキーを指定するkey_base64パラメータのどちらかになります。
*** リクエストの認証/認可に使用する Momento auth トークンを指定する必要があります。これは、トークンクエリパラメータか Authorization ヘッダで指定します。
Headers
Header name | Required? | Type | Description |
---|---|---|---|
Authorization | no*** | URL-safe string | 文字列形式の Momento auth トークンは、リクエストの認証/認可に使用されます。 |
*** リクエストの認証/認可 に使用する Momento auth トークンを指定する必要があります。これは、トークンクエリパラメータか Authorization ヘッダで指定します。
Responses
Ok
Status Code: 204 No Content
- キーと値のペアはキャッシュに保存されたが、コンテンツは返されなかった(設計上の仕様)。
Error
Status Code: 400 Bad Request
- このエラータイプは通常、リクエストの指定が正しくないことを示します。詳細はメッセージ本文を参照してください。
Status Code: 401 Unauthorized
- このエラータイプは通常、渡された Momento 認証トークンが無効か期限切れであることを示します。詳細はメッセージの本文を参照してください。
Status Code: 403 Forbidden
- このエラータイプは通常、渡された Momento 認証トークンが、試行したリソースへの必要なアクセスを許可していないことを示します。詳細はメッセージの本文を参照してください。
Status Code: 404 Not Found
- 「Cache Not Found」は、指定されたキャッシュが存在しないことを示します。
Status Code: 429 Too Many Requests
- このエラー タイプは通常、アカウントの上 限を超えたことを示します。詳細についてはメッセージ本文を参照するか、Momento サポートに連絡して限度額の引き上げを依頼してください。
Status Code: 500 Internal Server Error
- このエラータイプは通常、サービスに問題が発生していることを示します。Momentoサポートにお問い合わせください。
Delete Value
キャッシュからスカラー値を削除します。
Request
- Path: /cache/{cacheName}
- HTTP Method: DELETE
Path Parameters
Parameter name | Required? | Type | Description |
---|---|---|---|
cacheName | yes | URL-safe string | 操作するキャッシュの名前 |
Query Parameters
Parameter name | Required? | Type | Description |
---|---|---|---|
key | no** | URL-safe string | キャッシュから取得するキー |
key_base64 | no** | Base64 URL-encoded binary key | キャッシュから取得するキー |
token | no*** | URL-safe string | リクエストの認証/認可に使用する Momento 認証トークン (文字列形式) |
** キャッシュにアクセスするキーを指定する必要があります。これは、URLセーフ文字列を指定するkey queryパラメータか、Base64でURLエンコードされたキーを指定するkey_base64パラメータのどちらかになります。
*** リクエストの認証/認可に使用する Momento auth トークンを指定する必要があります。これは、トークンクエリパラメータか Authorization ヘッダで指定します。
Headers
Header name | Required? | Type | Description |
---|---|---|---|
Authorization | no*** | URL-safe string | 文字列形式の Momento auth トークンは、リクエストの認証/認可に使用されます。 |
*** リクエストの認証/認可に使用する Momento auth トークンを指定する必要があります。これは、トークンクエリパラメータか Authorization ヘッダで指定します。
Responses
Ok
Status Code: 204 No Content
- キーと値のペアはキャッシュに保存されたが、コンテンツは返されなかった(設計上の正しい動作です)。
Error
Status Code: 400 Bad Request
- このエラータイプは通常、リクエストの指定が正しくないことを示します。詳細はメッセージ本文を参照してください。
Status Code: 401 Unauthorized
- このエラータイプは通常、渡された Momento 認証トークンが無効か期限切れであることを示します。詳細はメッセージの本文を参照してください。
Status Code: 403 Forbidden
- このエラータイプは通常、渡された Momento 認証トークンが、試行したリソースへの必要なアクセスを許可していないことを示します。詳細はメッセージの本文を参照してください。
Status Code: 404 Not Found
- 「Cache Not Found」は、指定されたキャッシュが存在しないことを示します。
Status Code: 429 Too Many Requests
- このエラー タイプは通常、アカウントの上限を超えたことを示します。詳細についてはメッセージ本文を参照するか、Momento サポートに連絡して限度額の引き上げを依頼してください。
Status Code: 500 Internal Server Error
- このエラータイプは通常、サービスに問題が発生していることを示します。Momentoサポートにお問い合わせください。