Face List - Update a Face List 更新一個face list的信息，包括：name ， userData。face list 僅僅存放永久的faces,并且可以在Face - Find Similar作為可搜索資源。 Http Method `PATCH` Request URL `https://api.cognitive.azure.cn/face/v1.0/facelists/{faceListId} ` Request parameters | 參數 |類型 |描述 | | --- | --- | --- | | faceListId | string | 規范字符串包括小寫字母，數字，‘—’，‘_’,字符串最大長度是64 | Request headers | 請求頭 |類型 |描述 | | --- | --- | --- | | Content-Type (optional) |string |Media type of the body sent to the API. | | Ocp-Apim-Subscription-Key | string | Subscription key which provides access to this API. Found in your Cognitive Services accounts. | Request body JSON fields in request body | Fields | Type | Description| | --- | --- | --- | | name| String | Face list 的name，最長為128 | | userData | String | 可選參數，用戶為該face list 定義數據，長度不能超過16KB. | ~~~ { "name":"list1", "userData":"User-provided data attached to the face list." } ~~~ Response 200 請求成功返回空 Response 400 | Error code | message| | --- | --- | | BadArgument | Name過長 | | BadArgument | userData過長 | | BadArgument | 錯誤的或無法解析的json body | Response 401 | Error Code | Error Message Description | | --- | --- | | Unspecified | 無效的subscription Key 或user/plan 被凍結 | ~~~ { "error":{ "code": "Unspecified", "message": "Access denied due to invalid subscription key. Make sure you are subscribed to an API you are trying to call and provide the right key." } } ~~~ Response 403 ~~~ { "error":{ "statusCode": 403, "message": "Out of call volume quota. Quota will be replenished in 2.12 days." } } ~~~ Response 404 | Error Code | Error Message Description | | --- | --- | | FaceListNotFound |Face list 未定義 | | FaceListNotFound | 無效的Face list ID，合法的格式：字符串包括小寫字母，數字，‘—’，‘_’,字符串最大長度是64 | ~~~ { "error":{ "code":"PersistedFaceListNotFound", "message":"Face list 'sample_list' is not found." } } ~~~ Response 409 ~~~ { "error":{ "code": ConcurrentOperationConflict, "message": "There is a conflict operation on resource 'sample_group', please try later." } } ~~~ Response 415 不支持的媒體格式，該API支持application/json. ~~~ { "error":{ "code":"BadArgument", "message":"Invalid Media Type" } } ~~~ Response 429 ~~~ { "error":{ "statusCode": 429, "message": "Rate limit is exceeded. Try again in 26 seconds." } } ~~~