已弃用

旧版 v1/deploy API 端点是 过时的，已被 v2 API 取代 - 请参见 专用服务器.

Deprecated

⚠️ Deploy Server

post

DEPRECATED. [Rate Limit: 40 req/s] Create a new deployment - containerized instance of an application version.

授权

apiKey

Authorizationstring必填

Manage API tokens in dashboard.

头参数

Acceptstring可选Example: */*

Content-Typestring可选Example: application/json

请求体

application/json

app_namestring必填

Application to deploy.

Example: my-game-server

version_namestring可选

Version to deploy. If omitted, last created version will be deployed.

Example: 2024.01.30-16.23.00-UTC

ip_liststring[]可选

Mutually exclusive with geo_ip_list. List of user IPs, determining server location choice.

Example: 162.254.141.66

tagsstring[]可选

List of tags to mark your deployments for easy filtering.

Example: production

webhook_urlstring可选

URL to receive simple HTTP notifications in your game backend when the new deployment becomes Ready.

Example: https://www.webhook.com/

commandstring · 可为 null可选

Overrides container command for the deployment, use with caution.

Example: null | 'string'

argumentsstring · 可为 null可选

Overrides container arguments for the deployment, use with caution.

Example: null | 'string'

响应

200

Success

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

404错误

application/json

409

Conflict

application/json

422

Unprocessable

application/json

500错误

application/json

post

/v1/deploy

HTTPcURLJavaScriptPython

POST /v1/deploy HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 86

{
  "app_name": "my-game-server",
  "version_name": "production",
  "ip_list": [
    "162.254.141.66"
  ]
}

{
  "request_id": "61b1be8f54d9",
  "request_dns": "61b1be8f54d9.pr.edgegap.net",
  "request_app": "my-game-server",
  "request_version": "2024.01.30-16.23.00-UTC",
  "request_user_count": 4,
  "filters": [
    {
      "field": "city",
      "values": [
        "Montreal"
      ],
      "filter_type": "any"
    }
  ],
  "tags": [
    "production"
  ],
  "container_log_storage": null
}

Deprecated

⚠️ Updates properties of a deployment

patch

DEPRECATED. Updates properties of a deployment. Currently only the is_joinable_by_session property can be updated.

授权

apiKey

Authorizationstring必填

Manage API tokens in dashboard.

路径参数

request_idstring必填

头参数

Acceptstring可选Example: */*

Content-Typestring可选Example: application/json

请求体

application/json

is_joinable_by_sessionboolean可选

Whether a session can connect to this deployment or not.

响应

200

Success

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

patch

/v1/deployments/{request_id}

HTTPcURLJavaScriptPython

PATCH /v1/deployments/{request_id} HTTP/1.1
Host: api.edgegap.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 31

{
  "is_joinable_by_session": true
}

{
  "is_joinable_by_session": true
}