指定されたキー名のリストに基づいて、指定された KV 名前空間からキーと値のペアをバッチ削除します。最大リクエストボディサイズは 100 MB です。
操作説明
この操作は 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
}.
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Namespace |
string |
必須 |
CreateKvNamespace を呼び出したときに指定した名前空間名。 |
test_namespace |
| Url |
string |
必須 |
バッチ削除するキーと値のペアを含むダウンロード URL。読み取り権限を持つ OSS ダウンロード 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 | キーの登録または削除のリクエストが頻繁に送信されています。 | キーと値のペアに対する変更または削除操作が頻繁すぎます。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。