# 创建部署 (/docs/api/compatible/cloudflare/createDeployment)



`POST /cloudflare/client/v4/accounts/{account_id}/workers/scripts/{script_name}/deployments`

Deploy one version at 100 percent (no gradual rollout). Deployment is asynchronous; read praxis.status.

**支持状态: partial**

Deploy one version at 100 percent (no gradual rollout). Deployment is asynchronous; read praxis.status.

## 参数 [#参数]

| 名称           | 位置    | 类型      | 必填    | 说明                                                     |
| ------------ | ----- | ------- | ----- | ------------------------------------------------------ |
| account\_id  | path  | string  | true  | Any value; your account comes from the API key.        |
| script\_name | path  | string  | true  | Worker name.                                           |
| force        | query | boolean | false | Deploy even if the last deployment changed in between. |

## 请求体 (application/json) [#请求体-applicationjson]

必填: true

| 名称                          | 类型             | 说明                                                                   |
| --------------------------- | -------------- | -------------------------------------------------------------------- |
| strategy                    | string         | Rollout strategy.                                                    |
| versions                    | array\<object> | Exactly one version at 100 percent.                                  |
| versions\[].version\_id     | string         | Version to deploy.                                                   |
| versions\[].percentage      | number         | Must be 100.                                                         |
| force                       | boolean        | Own face only; on the compatible face use the force query parameter. |
| annotations                 | object         | Free-form annotations.                                               |
| annotations.workers/message | string         | Deployment message.                                                  |

```json
{
  "type": "object",
  "required": [
    "strategy",
    "versions"
  ],
  "properties": {
    "strategy": {
      "type": "string",
      "description": "Rollout strategy.",
      "enum": [
        "percentage"
      ],
      "x-enum-descriptions": {
        "percentage": "Split traffic by percentage; only a single version at 100 is accepted."
      },
      "example": "percentage"
    },
    "versions": {
      "type": "array",
      "description": "Exactly one version at 100 percent.",
      "items": {
        "type": "object",
        "required": [
          "version_id",
          "percentage"
        ],
        "properties": {
          "version_id": {
            "type": "string",
            "description": "Version to deploy."
          },
          "percentage": {
            "type": "number",
            "description": "Must be 100."
          }
        }
      }
    },
    "force": {
      "type": "boolean",
      "description": "Own face only; on the compatible face use the force query parameter."
    },
    "annotations": {
      "type": "object",
      "description": "Free-form annotations.",
      "required": [],
      "properties": {
        "workers/message": {
          "type": "string",
          "description": "Deployment message."
        }
      }
    }
  }
}
```

## 响应 [#响应]

### HTTP 200 [#http-200]

Success

**application/json**

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| success | boolean | Always true on success. |
| errors | array&lt;any&gt; | Always empty on success. |
| messages | array&lt;any&gt; | Always empty on success. |
| result | object |  |
| result.id | string | Deployment ID, prefixed dep_. |
| result.created_on | string | When the deployment was created. |
| result.source | string | Origin: api, sdk, console or rollback. |
| result.strategy | string | Rollout strategy. |
| result.versions | array&lt;object&gt; | Exactly one version at 100 percent. |
| result.annotations | object | Free-form annotations. |
| result.author_email | string &#124; null | Who created the deployment. |
| result.praxis | object | Platform fields: deployments run asynchronously, so track status, progress and error here. |
| result_info | object | Present on list responses. |
| result_info.page | integer | Page number. |
| result_info.per_page | integer | Page size. |
| result_info.count | integer | Items on this page. |