すべてのプロダクト
Search
ドキュメントセンター

Edge Security Acceleration:PutKvWithHighCapacity

最終更新日:Jun 22, 2026

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
}.

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

Namespace

string

必須

CreateKvNamespace 操作を呼び出したときに指定した名前。

test_namesapce

Key

string

必須

設定するキー名。キー名は最大 512 文字で、スペースやバックスラッシュ (/) を含めることはできません。

test_key

Url

string

必須

設定するキーと値のペアを含む JSON ファイルを指すパブリックアクセス可能な HTTP または HTTPS URL。サーバーはこの URL からコンテンツを能動的にダウンロードします。

  • SDK を使用する場合、SDK が自動的にファイルをアップロードし、URL を生成します。

  • SDK 以外のシナリオでは、JSON ペイロードをパブリックアクセス可能な任意の HTTP サービスにアップロードし、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.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。