已弃用

旧版 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.

授权

Authorizationstring必填

Manage API tokens in dashboard.

头参数

Acceptstring可选Example: */*

Content-Typestring必填Example: 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

request_idstring必填

ID of your deployment, also referred to as request ID.

Example: 61b1be8f54d9

request_dnsstring必填

FQDN (URL) to connect to the deployment.

Example: 61b1be8f54d9.pr.edgegap.net

request_appstring必填

Application which has been deployed.

Example: my-game-server

request_versionstring必填

App version which has been deployed.

Example: 2024.01.30-16.23.00-UTC

request_user_countinteger · 最小值: 1必填

Number of users included in the deployment request.

Example: 4

tagsstring[]可选

List of tags to mark your deployments for easy filtering.

Example: production

container_log_storageany可选

Object storage to upload deployment logs.

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

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.

授权

Authorizationstring必填

Manage API tokens in dashboard.

路径参数

request_idstring必填

头参数

Acceptstring可选Example: */*

Content-Typestring必填Example: application/json

请求体

is_joinable_by_sessionboolean可选

Whether a session can connect to this deployment or not.

响应

200

Success

application/json

is_joinable_by_sessionboolean必填

If the deployment is joinable by sessions

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}

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
}