Framework Cloud Endpoints

Cloud Endpoints Frameworks adalah framework web untuk lingkungan runtime standar App Engine Python 2.7 dan Java 8. Cloud Endpoints Frameworks menyediakan alat dan library yang memungkinkan Anda 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, Endpoints Frameworks akan merutekan URL permintaan ke fungsi atau metode dalam kode Anda yang memproses permintaan. Endpoints Frameworks 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 contoh kode, the 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 contoh kode, dekorator dimulai dengan karakter @.

Dengan Endpoints Frameworks, Anda tidak perlu men-deploy server web pihak ketiga (seperti Apache Tomcat atau Gunicorn) dengan aplikasi Anda. Anda dapat membuat anotasi 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 Endpoints for OpenAPI dan Endpoints for gRPC. ESP berjalan dalam container bersama setiap instance backend Anda.

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

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

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

Batasan

  • Endpoints Frameworks hanya didukung di lingkungan runtime standar App Engine Python 2.7 dan Java 8.
  • Endpoints Frameworks 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 Run Functions, Compute Engine, dan Google Kubernetes Engine.

Langkah berikutnya