指定された名前空間に複数のキーと値のペアを設定します。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Namespace |
string |
必須 |
CreateKvNamespace を呼び出すときに指定する名前空間です。 |
test_namespace |
| KvList |
array<object> |
必須 |
設定するキーと値のペアのリストです。合計サイズは 2 MB (2 × 1,000 × 1,000) を超過できません。 |
|
|
object |
必須 |
|||
| Key |
string |
必須 |
キーの名前です。キーは最大 512 文字で、スペースまたはバックスラッシュ (/) を含めることはできません。 |
test_key |
| Value |
string |
必須 |
キーの値です。 |
test_value |
| Expiration |
integer |
任意 |
有効期限です。これは秒単位の UNIX タイムスタンプであり、現在時刻より前であってはなりません。Expiration と ExpirationTtl の両方を設定した場合、ExpirationTtl が優先されます。 |
1690081381 |
| ExpirationTtl |
integer |
任意 |
生存時間 (TTL) です。これは秒単位の相対時間です。Expiration と ExpirationTtl の両方を設定した場合、ExpirationTtl が優先されます。 |
3600 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答のスキーマ |
||
| RequestId |
string |
リクエスト ID です。 |
EEEBE525-F576-1196-8DAF-2D70CA3F4D2F |
| FailKeys |
array |
書き込みに失敗したキーのリストです。 |
|
|
string |
書き込みに失敗したキーの名前です。 |
test_key1 |
|
| SuccessKeys |
array |
正常に書き込まれたキーのリストです。 |
|
|
string |
正常に書き込まれたキーの名前です。 |
test_key2 |
例
成功レスポンス
JSONJSON
{
"RequestId": "EEEBE525-F576-1196-8DAF-2D70CA3F4D2F",
"FailKeys": [
"test_key1"
],
"SuccessKeys": [
"test_key2"
]
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidAccount.Malformed | The specified account is invalid. | |
| 400 | InvalidNameSpace.Malformed | The specified namespace is invalid. | |
| 400 | InvalidKey.Malformed | The specified key is invalid. | |
| 400 | InvalidKey.ExceedsMaximum | The size of the key cannot exceed 512 bytes. | |
| 400 | InvalidValue.ExceedsMaximum | The size of the value cannot exceed 2,000,000 bytes. | |
| 403 | InvalidKey.ExceedsCapacity | The maximum capacity of a single namespace cannot exceed 1 GB. | |
| 403 | Unauthorized.InvalidParameters | The specified authentication parameters are invalid. | |
| 403 | Unauthorized.InvalidTime | The specified authentication time is invalid. | |
| 403 | Unauthorized.InvalidToken | Token authentication failed. | |
| 404 | InvalidAccount.NotFound | The specified account does not exist. | |
| 404 | InvalidNameSpace.NotFound | The specified namespace does not exist. | |
| 404 | InvalidKey.NotFound | The specified key does not exist. | |
| 406 | InvalidNameSpace.Duplicate | The specified namespace already exists. | |
| 406 | InvalidNameSpace.QuotaFull | The maximum number of namespaces is exceeded. | |
| 429 | TooManyRequests | Too many requests are submitted. | |
| 429 | TooQuickRequests | Request for putting or deleting keys are frequently submitted. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。