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

Image Search:DeleteImage

最終更新日:Jan 20, 2025

Image Search インスタンスから画像を削除します。

使用方法

この操作を呼び出して、Image Search インスタンスから画像を削除できます。

説明
  • 指定した画像がインスタンスに存在しない場合でも、成功応答が返されます。そのため、応答に基づいて画像がインスタンスに存在するかどうかを判断することはできません。

QPS 制限

デフォルトでは、この操作の同時実行制限は 20 です。これは、システムが毎秒最大 20 件の画像削除リクエストを処理できることを意味します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター

タイプ

必須

説明

Action

String

はい

DeleteImage

実行する操作。値を DeleteImage に設定します。

InstanceName

String

はい

demoinstance1

Image Search インスタンスの名前。名前は最大 20 文字まで使用できます。

Image Search インスタンスを購入した場合は、Image Search コンソール にログインしてインスタンスを表示できます。

Image Search インスタンスを購入していない場合は、インスタンスを購入する必要があります。詳細については、「Image Search をアクティブにする」および「インスタンスを作成する」をご参照ください。

説明

インスタンス名はインスタンス ID ではありません。インスタンス名はリージョン内で一意である必要があります。

ProductId

String

はい

2092061_1

プロダクト ID。

説明

1 つのプロダクトに複数の画像が含まれる場合があります。

PicName

String

いいえ

2092061_1.jpg

画像の名前。

  • このパラメーターを指定しない場合、システムは ProductId で指定されたプロダクト ID に関連するすべての画像を削除します。

  • このパラメーターを指定した場合、システムは ProductId と PicName で指定された画像のみを削除します。

レスポンスパラメーター

パラメーター

タイプ

説明

Message

String

success

返されたメッセージ。

RequestId

String

0703956F-9BCC-48FA-99F7-96C0BF449C69

リクエスト ID。

Code

Integer

0

レスポンスコード。

  • 値 0 は、リクエストが成功したことを示します。

  • 0 以外の値は、リクエストが失敗したことを示します。

Success

Boolean

true

リクエストが成功したかどうかを示します。

Data

Object

削除された画像に関する情報。

PicNames

String の配列

xxx.jpg

削除された画像の名前。

リクエストの例

{
        "InstanceName": "demoinstance",
        "PicName": "test",
        "ProductId": "test"
    }

成功レスポンスの例

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Message" : "success",
  "RequestId" : "1F59AE0A-8B57-14A6-BCE8-E2592CA5FA0F",
  "Data" : {
    "PicNames" : [ "5555.jpg" ]
  },
  "Code" : 0,
  "Success" : true
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400

BadRequest

リクエストに無効なパラメーターが含まれています。

1 つ以上のパラメーターが無効です。

400

InvalidInstance

指定されたインスタンス名が無効です。

インスタンス名が無効です。

400

NoCaretSeperator

本文コンテンツに ^ 区切り文字がありません。

リクエスト本文に特定の記号がありません。

400

EmptyMeta

本文コンテンツに空のメタフィールドがあります。

リクエスト本文に空のメタパラメーターが含まれています。

400

InvalidMetaItem

メタフィールドが無効です。

メタパラメーターが無効な値に設定されています。

400

InvalidPicList

指定された pic_list パラメーターが無効です。

pic_list パラメーターが無効な値に設定されています。

400

NoSpecifiedPic

HTTP POST 本文で画像のコンテンツが指定されていません。

画像が指定されていません。

400

InvalidCategory

指定されたカテゴリが無効です。

カテゴリ ID が無効です。

400

OverflowMaxResultNum

指定された合計結果数が最大値 500 を超えています。

指定された合計返却エントリ数が上限 500 を超えています。

400

OverflowMaxReturnNum

リクエストごとに指定された結果数が最大値 100 を超えています。

1 つのリクエストで指定された返却エントリ数が上限 100 を超えています。

400

InvalidIntAttr

指定された int_attr フィールドが無効です。

IntAttr パラメーターが無効な値に設定されています。

400

UnsupportedPicFormat

指定された画像形式が無効です。

画像形式が無効です。

400

InvalidFilterClause

指定されたフィルタリング条件が無効です。

フィルター条件が無効です。

400

InstanceOverQuota

アイテム数が制限を超えています。

インスタンス内の画像数が上限を超えています。

400

IncorrectOrientation

画像のメタデータに不正な回転フラグが含まれています。

画像に回転設定が含まれています。回転設定はサポートされていません。

400

UnsupportedPicPixels

指定されたピクセルはサポートされていません。

指定された画像の画素値はサポートされていません。

403

NoPermission

この操作を実行する権限がありません。

必要な権限がありません。管理者に権限の付与を依頼してください。

403

DeniedRequest

インスタンスのフロー制御によりリクエストが拒否されました。

速度制限によりリクエストが拒否されました。

500

NetworkException

ネットワークエラーが発生しました。

ネットワークエラーが発生しました。

500

UnsupportedInstanceType

インスタンスタイプはサポートされていません。

インスタンスタイプはサポートされていません。

500

UnsupportedOperationType

指定された操作はサポートされていません。

指定された操作はサポートされていません。

500

AccessEngineFailed

検索エンジンへのアクセス中にエラーが発生しました。

検索エンジンでエラーが発生しました。

500

InternalOssError

内部 OAS エラーが発生しました。

内部アルゴリズムエラーが発生しました。

500

InternalSwiftError

内部 SWIFT エラーが発生しました。

内部メッセージキューエラーが発生しました。

500

InternalTableStoreError

内部 Table Store エラーが発生しました。

内部ストレージエラーが発生しました。

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

エラーコード

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