Tiện ích mở rộng chức năng của Google Cloud

Gọi hàm Node.js

Ví dụ sau đây mô tả Chính sách chú thích tiện ích gọi một tiện ích Google Cloud Functions. Tiện ích này sẽ gọi hàm "xin chào thế giới" mặc định khi bạn bật Cloud Functions API.

JavaScript Node.js sau đây được triển khai trong Hàm đám mây cho một tài khoản GCP. Nếu yêu cầu có chứa một thuộc tính tin nhắn, thì mã sẽ trả về thuộc tính đó. Nếu không, hệ thống sẽ trả về "Hello World!" (Xin chào mọi người!)

/**
 * Responds to any HTTP request.
 *
 * @param {!express:Request} req HTTP request context.
 * @param {!express:Response} res HTTP response context.
 */
exports.helloWorld = (req, res) => {
  let message = req.query.message || req.body.message || 'Hello World!';
  res.status(200).send(message);
};

Ví dụ này bao gồm một tiện ích Google Cloud Functions được định cấu hình bằng thông tin xác thực cần thiết để xác thực và được uỷ quyền gọi mã trên Cloud Functions.

Mã hàm trước đó được lưu trong Cloud Functions dưới dạng helloWorld. Mã cấu hình chính sách ExtensionAnnotation sau đây sử dụng tên này, cùng với các giá trị mã khu vực và mã dự án khớp với thông tin cụ thể của môi trường Hàm đám mây nơi triển khai chức năng.

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "us-central1",
    "projectId" : "my-project",
    "functionName" : "hello-world",
    "method" : "POST",
    "payload" : { "message" : "Hello yourself!" }
  }
]]></Input>
<Output parsed="false">function.response</Output>

Chính sáchAssignMessage sau đây ghi lại giá trị phản hồi cho mục đích gỡ lỗi.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Get-Function-Response">
    <DisplayName>Get Function Response</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{function.response}</Payload>
    </Set>
</AssignMessage>

Phản hồi cho yêu cầu trên sẽ có dạng như sau:

Hello yourself!

Giá trị mặc định của parsed là true. Ví dụ này đặt parsed="false" trong thẻ <Output> của chính sách, để ngăn chính sách phân tích cú pháp phản hồi JSON. Đối với hầu hết các trường hợp khi sử dụng tiện ích Cloud Functions, bạn sẽ đặt parsed="false". Xem phần tử<Output> để biết thêm thông tin.

Nếu Hàm Cloud trả về phản hồi JSON và bạn đặt parsed="true", thì phản hồi qua tiện ích sẽ là tham chiếu đối tượng. Để trích xuất phản hồi từ tham chiếu, hãy sử dụng cú pháp sau: {objectName}.{jsonKey}. Ví dụ:

function.response.message

Cú pháp

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "deployment-region",
    "projectId" : "project-id",
    "functionName" : "function-name",
    "method" : "http-method",
    "payload" : { json-payload }
  }
]]></Input>
<Output>function.response</Output>

Ví dụ:

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "us-central1",
    "projectId" : "my-project",
    "functionName" : "hello-world",
    "method" : "POST",
    "payload" : { "message" : "Hello yourself!" }
  }
]]></Input>
<Output>function.response</Output>