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

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. Thông tin

Phiên bản 2.0.2

Gọi Cloud Functions được triển khai thông qua dự án Google Cloud của bạn.

Hiện tại, tiện ích này hỗ trợ việc gọi các hàm kích hoạt HTTP.

Điều kiện tiên quyết

Nội dung này cung cấp thông tin tham khảo để định cấu hình và sử dụng tiện ích này. Trước khi sử dụng tiện ích từ một proxy API bằng chính sách ExtensionCallout, bạn phải:

1. Bật Cloud Functions API.

2. Xác định và triển khai các hàm trong Cloud Functions cho dự án của bạn trên Google Cloud.

3. Cấp quyền truy cập cho người dùng thông qua IAM cho cấp truy cập mà bạn muốn cho hàm. Ví dụ: bạn có thể giới hạn quyền truy cập vào hàm chỉ cho tài khoản dịch vụ mà bạn dùng để định cấu hình tiện ích.

4. Sử dụng GCP Console để tạo khoá cho tài khoản dịch vụ.

5. Sử dụng nội dung của tệp JSON khoá thu được khi thêm và định cấu hình tiện ích bằng cách sử dụng tài liệu tham khảo về cấu hình.

Giới thiệu về Cloud Functions

Với Google Cloud Functions, bạn có thể tạo và triển khai các hàm trên Google Cloud, sau đó gọi các hàm đó từ mã khác. Để tìm hiểu về Cloud Functions, hãy thử một trong các hướng dẫn bắt đầu nhanh.

Mẫu

Ví dụ sau minh hoạ cách gọi các hàm trong Cloud Functions bằng cách sử dụng chính sách ExtensionCallout.

/**
 * 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);
};

<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>

<?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>

Hello yourself!

Thao tác

gọi

Gọi một hàm trên đám mây.

Hiện tại, tiện ích này hỗ trợ việc gọi các hàm kích hoạt HTTP.

<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>

<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>

Tham số yêu cầu

Phản hồi

Giá trị phản hồi của hàm được chỉ định (nếu có).

Thuộc tính phản hồi

Không có.

Tài liệu tham khảo về cấu hình

Hãy sử dụng những thông tin sau khi bạn định cấu hình và triển khai tiện ích này để sử dụng trong các proxy API. Để biết các bước định cấu hình một tiện ích bằng bảng điều khiển Apigee, hãy xem phần Thêm và định cấu hình tiện ích.

Thuộc tính mở rộng chung

Các thuộc tính sau có sẵn cho mỗi tiện ích.

Các thuộc tính cho gói tiện ích này

Chỉ định các giá trị cho các thuộc tính cấu hình sau đây dành riêng cho tiện ích này.