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

Edge Security Acceleration:BatchDeleteKvWithHighCapacity

最終更新日:Jun 22, 2026

指定されたキー名のリストに基づいて、指定された KV 名前空間からキーと値のペアをバッチ削除します。最大リクエストボディサイズは 100 MB です。

操作説明

重要 非 SDK 呼び出しの前提条件: (1) 読み取りおよび書き込み権限を持つ OSS バケットが必要です。(2) OSS SDK または API を使用して署名付き HTTPS GET URL を生成できる必要があります。(3) アップロードする JSON ファイルは BatchDeleteKv リクエストボディと同じフォーマットを使用する必要があります。

この操作は BatchDeleteKv と同じ機能を提供しますが、より large なリクエストボディを許可します。リクエストボディが small の場合は、 BatchDeleteKv 操作を使用してサーバー側の処理時間を短縮してください。この操作は SDK を使用して呼び出す必要があります。たとえば、Golang SDK を使用する場合は、BatchDeleteKvWithHighCapacityAdvance 関数を呼び出します。

func TestBatchDeleteWithHighCapacity() error {
	// 構成を初期化します
	cfg := new(openapi.Config)
	cfg.SetAccessKeyId("xxxxxxxxx")
	cfg.SetAccessKeySecret("xxxxxxxxxx")
	cli, err := NewClient(cfg)
	if err != nil {
		return err
	}
	runtime := &util.RuntimeOptions{}.

	// キーと値のペアのバッチ削除リクエストを構築します
	namespace := "test_batch_put"
	rawReq := BatchDeleteKvRequest{
		Namespace: &namespace,
	}
	for i := 0; i < 10000; i++ {
		key := fmt.Sprintf("test_key_%d", i)
		rawReq.Keys = append(rawReq.Keys, &key)
	}
	payload, err := json.Marshal(rawReq)
	if err != nil {
		return err
	}.

	// ペイロードが 2 MB より large の場合、大容量操作を呼び出してキーと値のペアを削除します
	reqHighCapacity := BatchDeleteKvWithHighCapacityAdvanceRequest{
		Namespace: &namespace,
		UrlObject: bytes.NewReader(payload),
	}
	resp, err := cli.BatchDeleteKvWithHighCapacityAdvance(&reqHighCapacity, runtime)
	if err != nil {
		return err
	}
	return nil
}.

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター

必須 / 任意

説明

Namespace

string

必須

CreateKvNamespace を呼び出したときに指定した名前空間名。

test_namespace

Url

string

必須

バッチ削除するキーと値のペアを含むダウンロード URL。読み取り権限を持つ OSS ダウンロード URL などです。

  • SDK を使用してこの操作を呼び出す場合、SDK が自動的にコンテンツを OSS にアップロードし、対応する URL を渡します。

  • この操作を直接呼び出す場合は、JSON ペイロード (BatchDeleteKv 本文と同じフォーマット: {"Namespace":"...","Keys":[...]}) を OSS バケットにアップロードし、署名付き HTTPS GET URL を生成してください。

https://xxxobject.oss-cn-region.aliyuncs.com/9d91_xxxxxxxxxxx_158bb6e0f97c477791209bb46bd599f7

レスポンスフィールド

フィールド

説明

object

レスポンスのスキーマ。

RequestId

string

リクエスト ID。

EEEBE525-F576-1196-8DAF-2D70CA3F4D2F

FailKeys

array

削除に失敗したキーのリスト。

string

削除に失敗したキー名。

test_key1

SuccessKeys

array

正常に削除されたキーのリスト。

string

正常に削除されたキー名。

test_key1

成功レスポンス

JSONJSON

{
  "RequestId": "EEEBE525-F576-1196-8DAF-2D70CA3F4D2F",
  "FailKeys": [
    "test_key1"
  ],
  "SuccessKeys": [
    "test_key1"
  ]
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidAccount.Malformed 指定されたアカウントは無効です。 アカウントの入力が無効です。たとえば、入力が空です。
400 InvalidNameSpace.Malformed 指定された名前空間は無効です。 名前空間名の入力が無効です。たとえば、入力が空の文字列です。
400 InvalidKey.Malformed 指定されたキーは無効です。 キー名の入力が無効です。たとえば、入力が空の文字列です。
400 InvalidKey.ExceedsMaximum キーのサイズは512バイトを超えることはできません。 リクエストされたキーの長さが大きすぎます。
400 InvalidValue.ExceedsMaximum 値のサイズは2,000,000バイトを超えることはできません。 格納される値が大きすぎます。
403 InvalidKey.ExceedsCapacity 単一の名前空間の最大容量は1 GBを超えることはできません。 名前空間の容量が制限を超えています。
403 Unauthorized.InvalidParameters 指定された認証パラメータは無効です。 認証パラメータの入力が無効です。
403 Unauthorized.InvalidTime 指定された認証時刻は無効です。 入力した認証時刻パラメータは無効です。パラメータ値を確認して、もう一度お試しください。
403 Unauthorized.InvalidToken トークン認証に失敗しました。 入力したトークンは無効です。確認して正しいトークンを入力し、もう一度お試しください。
404 InvalidAccount.NotFound 指定されたアカウントは存在しません。 指定されたアカウントは存在しません。
404 InvalidNameSpace.NotFound 指定された名前空間は存在しません。 指定された名前空間は存在しません。
404 InvalidKey.NotFound 指定されたキーは存在しません。 指定されたキーと値のペアは存在しません。
406 InvalidNameSpace.Duplicate 指定された名前空間はすでに存在します。 指定された名前空間はすでに存在します。
406 InvalidNameSpace.QuotaFull 名前空間の最大数を超えています。 名前空間の数が容量制限を超えています。
429 TooManyRequests 送信されたリクエストが多すぎます。 リクエストが頻繁に送信されています。後でもう一度お試しください。
429 TooQuickRequests キーの登録または削除のリクエストが頻繁に送信されています。 キーと値のペアに対する変更または削除操作が頻繁すぎます。

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

変更履歴

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