Создание API-шлюза

Консоль управления

CLI

В консоли управления выберите каталог, в котором необходимо создать API-шлюз.
В списке сервисов выберите API Gateway.
Нажмите кнопку Создать API-шлюз.
В поле Имя введите numbers.
(опционально) В поле Описание введите описание.

В блок Спецификация добавьте спецификацию:

openapi: "3.0.0"
info:
  version: 1.0.0
  title: Test API
paths:
  /hello:
    get:
      summary: Say hello
      operationId: hello
      parameters:
        - name: user
          in: query
          description: User name to appear in greetings
          required: false
          schema:
            type: string
            default: 'world'
      responses:
        '200':
          description: Greeting
          content:
            'text/plain':
               schema:
                 type: "string"
      x-yc-apigateway-integration:
        type: dummy
        http_code: 200
        http_headers:
          'Content-Type': "text/plain"
        content:
          'text/plain': "Hello, {user}!\n"

Нажмите кнопку Создать.

Чтобы создать API-шлюз:

Сохраните следующую спецификацию в файл hello-world.yaml:

openapi: "3.0.0"
info:
  version: 1.0.0
  title: Test API
paths:
  /hello:
    get:
      summary: Say hello
      operationId: hello
      parameters:
        - name: user
          in: query
          description: User name to appear in greetings
          required: false
          schema:
            type: string
            default: 'world'
      responses:
        '200':
          description: Greeting
          content:
            'text/plain':
               schema:
                 type: "string"
      x-yc-apigateway-integration:
        type: dummy
        http_code: 200
        http_headers:
          'Content-Type': "text/plain"
        content:
          'text/plain': "Hello, {user}!\n"

Выполните команду со следующими параметрами:

name — имя API-шлюза.
spec — файл со спецификацией.
description — описание API-шлюза.

yc serverless api-gateway create --name hello-world --spec=hello-world.yaml --description "hello world"

done (29s)
id: d5dug9gkmu187iojcrtr
folder_id: b1g55tflru0ek7omtfu0
created_at: "2020-06-17T09:20:22.929Z"
name: hello-world
description: hello world
status: ACTIVE
domain: d5dug9gkmu187iojcpvp.apigw.yandexcloud.net
log_group_id: ckghq1hm19q7ek5sjnh5