Cloud function

Note

When calling cloud storage-related APIs, version v3 uses the open capability of [cloud function HTTP API](/HTTP-API/functions/cloud function). Before using, please go to [cloud Development Platform/identity Authentication/Permission control](tcb.cloud.tencent.com/dev? envId=#/identity/auth-control/detail? roleIdentity=registerUser&tab=strategy) Verify that the policy management configuration for FunctionsHttpApiAllow is as expected. For more information, see Policy Management Documentation.

callFunction

callFunction<T = any>(object: Object): Promise<Result<ICallFunctionResponse<T>>>

1. API Description

API feature: Execute a cloud function.

GATEWAY channel

In GATEWAY mode, success or failure is decided by HTTP statusCode: 2xx is success even if the body contains a code field. Non-2xx responses parse JSON / HTML / plain-text error bodies. With init({ throw: false }) the SDK returns {code, message, requestId}; by default it throws.

2. Input Parameters

object

Object

namestring

SCF name

dataOptionalobject

SCF function parameters

callbackOptionalfunction

callback function

parseOptionalboolean

When set to true, if the function return is an object, the API request will return the object to be resolved rather than a JSON string, suitable for directly viewing returned results in browser debug.

Functional cloud hosting can also pass parameters. After inputting the type:'cloudrun' parameter, it will invoke the functional cloud hosting service.

object

Object

typeOptionalcloudrun

whether to call the functional cloud hosting based on cloud hosting

methodOptionalstring

HTTP request method

pathOptionalstring

HTTP request path

headerOptionalRecord<string, string>

HTTP request header

dataOptionalobject

HTTP request body

3. Output Parameters

Promise

Object

codeOptionalstring

Status code, do not return if operation succeeded

messageOptionalstring

Error description

resultOptionalobject

SCF execution result

requestIdOptionalstring

Request Serial Number, used for fault troubleshooting

4. Example code

Basic SCF Function Call

import cloudbase from "@cloudbase/js-sdk";
// Initialize SDK instance
const app = cloudbase.init({
  env: "xxxx-yyy",
});

app
  .callFunction({
    name: "test",
    data: { a: 1 },
  })
  .then((res) => {
const result = res.result; //SCF execution result
  });

Functional cloud hosting call

import cloudbase from "@cloudbase/js-sdk";
// Initialize SDK instance
const app = cloudbase.init({
  env: "xxxx-yyy",
});

app
  .callFunction({
    name: "test",
// Functional cloud hosting parameter
    type: "cloudrun",
    method: "POST",
    path: "/abc",
    data: {
      key1: "test value 1",
      key2: "test value 2",
    },
  })
  .then((res) => {
const result = res.result; //SCF execution result
  });