API7 Docs

Generate a Docker Compose file to install an AI Gateway instance

GET /api/ai_gateway_groups/{ai_gateway_group_id}/deployment/docker-compose

GET /api/ai_gateway_groups/{ai_gateway_group_id}/deployment/docker-compose

Interactive request editor loads with JavaScript.

Authorization

X-API-KEY<token>

In: header

Path Parameters

ai_gateway_group_id*string

AI Gateway group ID.

Length1 <= length

Query Parameters

dp_manager_address?string

The IP address of the control plane.

Length1 <= length
validity_period?integer

The validity period of the certificate in days.

Range1 <= value <= 10950
Default3650
image?string

Docker image.

Length1 <= length
http_port?integer

The HTTP port of the gateway.

Default9080
name?string

The name of the docker compose container and service.

Length1 <= length
Default"api7-ee-3-gateway"
extra_args[]?array<string>

Additional docker run arguments.

Response Body

text/plain

application/json

curl -X GET "$API_BASE_URL/api/ai_gateway_groups/abc1234567890/deployment/docker-compose?image=api7%2Fapi7-ee-3-gateway&extra_args%5B%5D=a%3Db&extra_args%5B%5D=c%3Dd"

Successfully generated the Docker Compose configuration for AI Gateway installation.

"services:\n  ai-gateway:\n    image: api7/aisix:latest\n    container_name: ai-gateway\n    restart: always\n    ports:\n      - \"3000:3000\"\n    environment:\n      API7_CONTROL_PLANE_ENDPOINTS: '[\"https://10.0.0.1:31344\"]'\n"
Complete operation details and schema variants

GET /api/ai_gateway_groups/{ai_gateway_group_id}/deployment/docker-compose

Generate a Docker Compose file to install an AI Gateway instance

IAM Action: ai_gateway:GetAIGatewayGroup, Resource: arn:api7:ai_gateway:aigatewaygroup/%s Generates a Docker Compose configuration that starts an AISIX AI Gateway instance connected to the specified AI Gateway group.

Parameters

  • ai_gateway_group_id (path, string, required): AI Gateway group ID.
  • dp_manager_address (query, string, optional):
  • validity_period (query, integer, optional):
  • image (query, string, optional): Docker image.
  • http_port (query, integer, optional): The HTTP port of the gateway.
  • name (query, string, optional): The name of the docker compose container and service.
  • extra_args[] (query, array, optional): Additional docker run arguments.

Responses

  • 200: Successfully generated the Docker Compose configuration for AI Gateway installation.
  • 400: Bad Request — The request was malformed or contained invalid parameters. Check the error_msg field for details.
  • value (object, optional): The specific resource.
  • error_msg (string, optional): The error message.

cURL

curl -X GET '$API_BASE_URL/api/ai_gateway_groups/{ai_gateway_group_id}/deployment/docker-compose'