KV 名前空間に単一の large 容量キーと値のペアを設定します。値の最大サイズは 25 MB です。
操作説明
この操作は PutKv と同じ機能を提供しますが、より large なリクエストボディをアップロードできます。リクエストボディが small の場合は、 PutKv 操作を使用してサーバー側の処理時間を短縮してください。この操作は SDK を使用して呼び出す必要があります。たとえば、Golang SDK を使用する場合は、PutKvWithHighCapacityAdvance 関数を呼び出します。
func TestPutKvWithHighCapacity() {
// 構成の初期化
cfg := new(openapi.Config)
cfg.SetAccessKeyId("xxxxxxxxx")
cfg.SetAccessKeySecret("xxxxxxxxxx")
cli, err := NewClient(cfg)
if err != nil {
return err
}
runtime := &util.RuntimeOptions{}.
// アップロードするキーと値のペアのリクエストを構築
namespace := "test-put-kv"
key := "test_PutKvWithHighCapacity_0"
value := strings.Repeat("t", 10*1024*1024)
rawReq := &PutKvRequest{
Namespace: &namespace,
Key: &key,
Value: &value,
}
payload, err := json.Marshal(rawReq)
if err != nil {
return err
}.
// ペイロードが 2 MB を超える場合、large 容量操作を呼び出してアップロード
reqHighCapacity := &PutKvWithHighCapacityAdvanceRequest{
Namespace: &namespace,
Key: &key,
UrlObject: bytes.NewReader([]byte(payload)),
}.
resp, err := cli.PutKvWithHighCapacityAdvance(reqHighCapacity, runtime)
if err != nil {
return err
}
return nil
}.
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Namespace |
string |
必須 |
CreateKvNamespace 操作を呼び出したときに指定した名前。 |
test_namesapce |
| Key |
string |
必須 |
設定するキー名。キー名は最大 512 文字で、スペースやバックスラッシュ (/) を含めることはできません。 |
test_key |
| Url |
string |
必須 |
設定するキーと値のペアを含む JSON ファイルを指すパブリックアクセス可能な HTTP または HTTPS URL。サーバーはこの URL からコンテンツを能動的にダウンロードします。
URL が指すファイルの内容は、次の JSON フォーマットである必要があります: {"Namespace":"<名前空間>","Key":"<キー>","Value":"<値>"}。 |
https://xxxobject.oss-cn-reginon.aliyuncs.com/9d91_xxxxxxxxxxx_158bb6e0f97c477791209bb46bd599f7 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答のスキーマ。 |
||
| RequestId |
string |
リクエスト ID。 |
EEEBE525-F576-1196-8DAF-2D70CA3F4D2F |
| Length |
string |
キーと値のペアにおける値の長さ。 |
4 |
| Value |
string |
キーの内容。内容が 256 文字を超える場合、最初の 100 文字と最後の 100 文字が返され、中間部分は省略されます。 |
test |
例
成功レスポンス
JSONJSON
{
"RequestId": "EEEBE525-F576-1196-8DAF-2D70CA3F4D2F",
"Length": "4",
"Value": "test"
}
エラーコード
|
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. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。