Application
创建 Worker
创建 Worker
POST /application/v1/workers
Create a Worker. It serves nothing until a version is deployed.
支持状态: supported
请求体 (application/json)
必填: true
| 名称 | 类型 | 说明 |
|---|---|---|
| name | string | Worker name, unique in your account: 3–40 lowercase letters, digits or hyphens, starting and ending with a letter or digit, with no two hyphens in a row. The names www, api, admin, app, canary, canary-probe, status, docs and console are reserved. |
| tags | array<string> | Up to 8 tags. |
| observability | object | Observability settings. |
| observability.enabled | boolean | Collect logs. |
| subdomain | object | Subdomain settings. |
| subdomain.enabled | boolean | Serve the Worker on its public subdomain (default true). |
| praxis | object | Praxis settings. |
| praxis.labels | object | Up to 16 labels. |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Worker name, unique in your account: 3–40 lowercase letters, digits or hyphens, starting and ending with a letter or digit, with no two hyphens in a row. The names www, api, admin, app, canary, canary-probe, status, docs and console are reserved.",
"pattern": "^(?!(?:www|api|admin|app|canary|canary-probe|status|docs|console)$)(?!.*--)[a-z0-9][a-z0-9-]{1,38}[a-z0-9]$",
"example": "my-app"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 8,
"description": "Up to 8 tags."
},
"observability": {
"type": "object",
"description": "Observability settings.",
"required": [
"enabled"
],
"properties": {
"enabled": {
"type": "boolean",
"description": "Collect logs."
}
}
},
"subdomain": {
"type": "object",
"description": "Subdomain settings.",
"required": [
"enabled"
],
"properties": {
"enabled": {
"type": "boolean",
"description": "Serve the Worker on its public subdomain (default true)."
}
}
},
"praxis": {
"type": "object",
"description": "Praxis settings.",
"required": [],
"properties": {
"labels": {
"type": "object",
"additionalProperties": {
"type": "string"
},
"description": "Up to 16 labels."
}
}
}
}
}响应
HTTP 200
Success
application/json
| 名称 | 类型 | 说明 |
|---|---|---|
| id | string | Worker ID, prefixed wkr_. |
| name | string | Unique per account; lowercase letters, digits and single hyphens. |
| subdomain | object | Public address of the Worker. |
| subdomain.enabled | boolean | Whether the public subdomain serves this Worker. |
| subdomain.url | string | Public URL of the Worker. |
| tags | array<string> | Up to 8 tags. |
| observability | object | Observability settings. |
| observability.enabled | boolean | Whether logs are collected. |
| logpush | boolean | Always false: unlike Cloudflare, Logpush is not offered. |
| created_on | string | When the Worker was created. |
| updated_on | string | When the Worker last changed. |
| deployed_on | string | null | When the current deployment became active; null before the first deployment. |
| praxis | object | Platform fields: lifecycle status, labels, and soft-delete timestamps. |
| praxis.status | string | Worker status: draft (no deployment yet), active (serving), suspended (stopped by an administrator), deleted (soft-deleted, restorable for 7 days), purging (resources being removed), purged (gone). |
| praxis.current_deployment_id | string | null | ID of the active deployment. |
| praxis.labels | object | Up to 16 key-value labels for your own grouping. |
| praxis.deleted_on | string | null | When the Worker was deleted. |
| praxis.purge_on | string | null | When a deleted Worker is permanently removed. |
| praxis.suspended_reason | string | null | Why an administrator suspended the Worker. |