Framework Cloud Endpoints

Framework Cloud Endpoints adalah framework web untuk lingkungan runtime Python 2.7 dan Java 8 standar App Engine. Cloud Endpoints Frameworks menyediakan alat dan library yang dapat digunakan untuk membuat REST API dan library klien untuk aplikasi Anda.

Seperti framework web lainnya, Endpoints Frameworks menangani detail komunikasi tingkat rendah dari permintaan dan respons HTTP untuk aplikasi Anda. Saat klien mengirim permintaan ke API Anda, Framework Endpoint akan mengarahkan URL permintaan ke fungsi atau metode dalam kode Anda yang memproses permintaan tersebut. Framework Endpoint mengonversi nilai yang ditampilkan ke JSON dan mengirim respons. Anda menambahkan metadata (dengan menggunakan anotasi di Java dan dekorator di Python) ke kode sumber Anda. Metadata menentukan platform REST API untuk aplikasi Anda.

Java

@ApiMethod(name = "echo")
public Message echo(Message message, @Named("n") @Nullable Integer n) {
  return doEcho(message, n);
}

Dalam kode contoh, anotasi dimulai dengan karakter @.

Python

@endpoints.method(
    # This method takes a ResourceContainer defined above.
    ECHO_RESOURCE,
    # This method returns an Echo message.
    EchoResponse,
    path="echo",
    http_method="POST",
    name="echo",
)
def echo(self, request):
    output_message = " ".join([request.message] * request.n)
    return EchoResponse(message=output_message)

Dalam kode contoh, dekorator dimulai dengan karakter @.

Dengan Framework Endpoint, Anda tidak perlu men-deploy server web pihak ketiga (seperti Apache Tomcat atau Gunicorn) dengan aplikasi Anda. Anda menganotasi atau mendekorasi kode dan men-deploy aplikasi seperti biasa ke lingkungan standar App Engine.

Pengelolaan API

Extensible Service Proxy (ESP) menyediakan fitur pengelolaan API untuk Endpoint untuk OpenAPI dan Endpoint untuk gRPC. ESP berjalan dalam container bersama setiap instance backend Anda.

Karena lingkungan standar App Engine tidak mendukung deployment multi-container saat Endpoints Frameworks sedang dalam pengembangan, Endpoints Frameworks tidak menggunakan ESP. Sebagai gantinya, Framework Endpoints menyertakan gateway API bawaan yang menyediakan fitur pengelolaan API yang sebanding dengan fitur yang disediakan ESP untuk Endpoint untuk OpenAPI dan Endpoint untuk gRPC.

Framework Endpoint mencegat semua permintaan dan melakukan pemeriksaan yang diperlukan (seperti autentikasi) sebelum meneruskan permintaan ke backend API. Saat backend merespons, Framework Endpoint akan mengumpulkan dan melaporkan telemetri. Anda dapat melihat metrik untuk API di halaman Layanan Endpoint di Konsol Google Cloud.

Anda dapat menggunakan Framework Endpoint dengan atau tanpa fungsi pengelolaan API. Penggunaan Framework Endpoint tanpa fungsi pengelolaan API ditawarkan tanpa biaya. Fungsi pengelolaan API dikenai biaya sesuai dengan halaman harga Endpoint.

Batasan

  • Framework Endpoint hanya didukung di lingkungan runtime Python 2.7 dan Java 8 standar App Engine.
  • Framework Endpoints tidak mendukung lingkungan runtime Node.js, PHP, dan Go di lingkungan standar App Engine.
  • Endpoints Frameworks tidak mendukung lingkungan fleksibel App Engine.
  • Endpoints Frameworks tidak mendukung Cloud Functions, Compute Engine, dan Google Kubernetes Engine.

Langkah selanjutnya