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

ID Verification:顔ライブラリからの顔画像の削除

最終更新日:Jul 07, 2026

FACE_IDU は顔検索モードをサポートし、顔ライブラリ管理機能を提供します。ID Verification コンソールでユーザー ID を使用するか、この API を呼び出すことで、特定の顔画像を削除できます。

操作詳細

  • 操作:DeleteFaceRecordV2

  • リクエストメソッド:POST

  • プロトコル:HTTPS

  • QPS 制限:単一テナントの最大リクエストレートは 50 QPS です。

  • エンドポイント:

    説明
    • ID Verification のソリューションごとにサポートされるリージョンは異なり、データはリージョン間で分離されています。データにアクセスするには、データが保存されているリージョンの API ドメイン名を使用する必要があります。

    シンガポール

    • パブリックエンドポイント:cloudauth-intl.ap-southeast-1.aliyuncs.com

    • 内部エンドポイント:cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

    インドネシア (ジャカルタ)

    • パブリックエンドポイント:cloudauth-intl.ap-southeast-5.aliyuncs.com

    • 内部エンドポイント:cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com

    中国 (香港)

    • パブリックエンドポイント:cloudauth-intl.cn-hongkong.aliyuncs.com

    • 内部エンドポイント:cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

    マレーシア (クアラルンプール)

    • パブリックエンドポイント:cloudauth-intl.ap-southeast-3.aliyuncs.com

    • 内部エンドポイント:cloudauth-intl-vpc.ap-southeast-3.aliyuncs.com

オンラインでのデバッグと統合

説明

デバッグまたは統合を行う前に、「OpenAPI を使用したサーバー側 API のデバッグと統合」ガイドを読み、OpenAPI プラットフォームでの API の呼び出し方法と SDK の取得方法を理解してください。

利用して、OpenAPI Explorerでこの API を直接実行してデバッグし、さらにSDK コード例を生成できます。

リクエストパラメーター

名前

タイプ

説明

必須

MerchantUserId

String

一意のユーザー識別子。この値は、AddFaceRecord API を呼び出して顔レコードを追加した際に使用した値と一致している必要があります。登録時に値が指定されなかった場合は、デフォルトの画像名を使用できます。

はい

FaceGroupCode

String

対象の顔ライブラリのコード。このパラメーターが指定されていない場合、ユーザーの顔データはすべての顔ライブラリから削除されます。

いいえ

レスポンスパラメーター

名前

タイプ

説明

HTTP ステータスコード

integer

HTTP ステータスコード。

200

HTTP ボディ

RequestId

String

リクエストの一意の ID。トラブルシューティングに使用されます。

130A2C10-B9EE-4D84-88E3-5384FF03****

Code

String

返されるコード。詳細については、「サーバーサイド HTTP ステータスコード」をご参照ください。

Success

Message

String

返されたコードの詳細な説明。

リクエストは成功しました。

Result.Deleted

String

削除結果。

  • Y:顔画像は削除されます。

  • N:顔画像の削除に失敗しました。

Y

Result.DeletedGroupCodes

String

実際に削除が行われた顔ライブラリのコードのリスト (コンマ区切り)。FaceGroupCode が指定されていない場合、データが削除されたすべてのライブラリが返されます。

10001