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

Gọi hàm Node.js

Ví dụ sau đây giới thiệu chính sách ExtensionAnnotation (Chính sách về tiện ích mở rộng chú thích) gọi một tiện ích của Google Cloud Functions. Tiện ích này gọi lệnh "hello world" mặc định đi kèm khi bạn bật Cloud Functions API.

JavaScript Node.js sau đây được triển khai trong Cloud Functions cho một tài khoản GCP. Nếu yêu cầu có chứa một thuộc tính của tin nhắn, thì mã sẽ trả về thuộc tính đó. Nếu không, hàm này sẽ trả về "Hello World!" (Xin chào thế giới!) làm phản hồ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 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 đơn giản là 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 các thông tin cụ thể của môi trường Hàm đám mây nơi hàm được triển khai.

<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ách chỉ định 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ẽ như sau:

Hello yourself!

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

Nếu Hàm đám mây trả về phản hồi JSON và bạn đặt parsed="true", thì phản hồi của tiện ích là một tham chiếu đối tượng. Để trích xuất phản hồi từ tệp 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>