Framework Cloud Endpoints

Framework Cloud Endpoints adalah framework web untuk lingkungan runtime Python 2.7 dan Java 8 standar App Engine. Framework Cloud Endpoints 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. Frameworks Endpoint mengonversi nilai yang ditampilkan ke JSON dan mengirimkan respons. Anda menambahkan metadata (dengan menggunakan anotasi di Java dan dekorator di Python) ke kode sumber Anda. Metadata menentukan permukaan 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, 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, decorator dimulai dengan karakter @.

Dengan Endpoints Frameworks, Anda tidak perlu men-deploy server web pihak ketiga (seperti Apache Tomcat atau Gunicorn) dengan aplikasi Anda. Anda 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-penampung 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 mengumpulkan dan melaporkan telemetri. Anda dapat melihat metrik untuk API di halaman Endpoints Services di konsol Google Cloud .

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

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

Langkah berikutnya