華為云計(jì)算 云知識(shí) 同步執(zhí)行函數(shù)InvokeFunction
同步執(zhí)行函數(shù)InvokeFunction

 

功能介紹

同步調(diào)用指的是客戶端請(qǐng)求需要明確等到響應(yīng)結(jié)果,也就是說這樣的請(qǐng)求必須得調(diào)用到用戶的函數(shù),并且等到調(diào)用完成才返回。

調(diào)試

您可以在API Explorer中調(diào)試該接口,支持自動(dòng)認(rèn)證鑒權(quán)。API Explorer可以自動(dòng)生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。

URI

POST /v2/{project_id}/fgs/functions/{function_urn}/invocations

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

租戶項(xiàng)目 ID,獲取方式請(qǐng)參見獲取項(xiàng)目ID。

function_urn

String

函數(shù)的URN,詳細(xì)解釋見FunctionGraph函數(shù)模型的描述。

請(qǐng)求參數(shù)

表2 請(qǐng)求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。

通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲取(響應(yīng)消息頭中X-Subject-Token的值)。

X-Cff-Log-Type

String

取值為:tail(返回函數(shù)執(zhí)行后的4K日志),或者為空(不返回日志)。

X-CFF-Request-Version

String

返回體格式,取值v0,v1。 v0:默認(rèn)返回文本格式 v1:默認(rèn)返回json格式,sdk需要使用此值。

表3 請(qǐng)求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

{自定義key}

Object

執(zhí)行函數(shù)請(qǐng)求體

響應(yīng)參數(shù)

狀態(tài)碼: 200

表4 響應(yīng)Header參數(shù)

參數(shù)

參數(shù)類型

描述

X-Cff-Invoke-Summary

String

-

X-Cff-Request-Id

String

-

表5 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

request_id

String

請(qǐng)求ID。

result

String

函數(shù)執(zhí)行結(jié)果

log

String

函數(shù)執(zhí)行返回日志

status

Integer

函數(shù)執(zhí)行返回狀態(tài)

狀態(tài)碼: 400

表6 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error_code

String

錯(cuò)誤碼

error_msg

String

錯(cuò)誤信息

狀態(tài)碼: 401

表7 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error_code

String

錯(cuò)誤碼

error_msg

String

錯(cuò)誤信息

狀態(tài)碼: 403

表8 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error_code

String

錯(cuò)誤碼

error_msg

String

錯(cuò)誤信息

狀態(tài)碼: 404

表9 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error_code

String

錯(cuò)誤碼

error_msg

String

錯(cuò)誤信息

狀態(tài)碼: 500

表10 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error_code

String

錯(cuò)誤碼

error_msg

String

錯(cuò)誤信息

狀態(tài)碼: 503

表11 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error_code

String

錯(cuò)誤碼

error_msg

String

錯(cuò)誤信息

請(qǐng)求示例

同步執(zhí)行函數(shù),請(qǐng)求參數(shù)為鍵值對(duì)“k”:“v”。

POST /v2/{project_id}/fgs/functions/{function_urn}/invocations

{
  "body" : {
    "k" : "v"
  }
}

響應(yīng)示例

狀態(tài)碼: 200

OK

{
  "status" : 200,
  "request_id" : "1cbe80f3-3c65-475e-ad88-76ac518d386x"
}

狀態(tài)碼

狀態(tài)碼

描述

200

OK

400

Bad Request 請(qǐng)求錯(cuò)誤。

401

Unauthorized 鑒權(quán)失敗。

403

Forbidden 沒有操作權(quán)限。

404

Not Found 找不到資源。

500

Internal Server Error 服務(wù)內(nèi)部錯(cuò)誤。

503

Service Unavailable 服務(wù)不可用。

錯(cuò)誤碼

請(qǐng)參見錯(cuò)誤碼。