---
title: 排程部署
url: https://platform.claude.com/docs/zh-TW/managed-agents/scheduled-deployments
description: 使用 Claude API 建立和管理部署：依照週期性的 cron 排程執行代理程式，並檢查其執行歷史記錄。
featureMetadata:
topic:
title: Managed Agents
url: https://platform.claude.com/docs/en/managed-agents/overview
status: beta
betaHeader: managed-agents-2026-04-01
---
「**scheduled deployment**」（**排程部署**）可讓[代理程式](https://platform.claude.com/docs/zh-TW/managed-agents/agent-setup)自主啟動[工作階段](https://platform.claude.com/docs/zh-TW/managed-agents/sessions)，以可預測的節奏完成任務。您可以使用 Deployments API（Claude API 的一部分）來建立和管理部署。
如需發布背景資訊以及團隊依排程執行哪些工作的範例，請參閱部落格上的 [Claude Managed Agents 中的排程部署與保管庫](https://claude.com/blog/whats-new-in-claude-managed-agents)。
## 建立排程部署
建立部署時，除了 `schedule` (csharp, go: `Schedule`) 之外，您還需傳入執行所需的[工作階段設定](https://platform.claude.com/docs/zh-TW/managed-agents/sessions)。
* 部署需要[代理程式設定](https://platform.claude.com/docs/zh-TW/managed-agents/agent-setup)和[環境設定](https://platform.claude.com/docs/zh-TW/managed-agents/environments)，並可選擇性地接受[檔案](https://platform.claude.com/docs/zh-TW/managed-agents/files)、[GitHub](https://platform.claude.com/docs/zh-TW/managed-agents/github)、[記憶體儲存區](https://platform.claude.com/docs/zh-TW/managed-agents/memory)和[保管庫](https://platform.claude.com/docs/zh-TW/managed-agents/vaults)。以[自行託管環境](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted-sandboxes-memory)為目標的部署可以附加記憶體儲存區；`file` 和 `github_repository` 資源則需要雲端環境。Claude Console 的部署表單目前不提供自行託管環境的記憶體儲存區選項；請改為透過 API 或 SDK 附加。
* 部署還需要至少一個初始事件（`user.message` 或 `user.define_outcome`），用來啟動每個工作階段的工作。在供 `ant apply` 使用的部署檔案中，frontmatter 下方的文字會成為該 `user.message`。
* 在 `schedule` (csharp, go: `Schedule`) 中，您需定義 cron `expression` (csharp, go: `Expression`) 和 `timezone` (csharp, go: `Timezone`)。支援的最細粒度為分鐘層級。
在 [Claude Platform on AWS](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws) 上，每次執行都會以您 AWS 帳戶中的 IAM 角色建立其工作階段。在建立部署之前，請將代理程式上的 `execution_identity` 設定為 `{"type": "aws_role", "role_arn": "arn:aws:iam::123456789012:role/example-role"}`。為沒有此欄位的代理程式建立部署會傳回 400 錯誤。
* **信任政策：** 允許 `aws-external-anthropic.amazonaws.com` 服務主體呼叫 `sts:AssumeRole` 和 `sts:SetSourceIdentity`。
* **角色權限：** 允許 `aws-external-anthropic:CreateSession`、`sts:GetWebIdentityToken` 和 `sts:TagGetWebIdentityToken`。
* **呼叫者權限：** 在代理程式上設定角色的 IAM 主體需要對該角色具有 `iam:PassRole` 權限。該角色必須位於同一個 AWS 帳戶中。沒有任何[受管政策](https://platform.claude.com/docs/zh-TW/api/claude-platform-on-aws-iam-actions#managed-policies)會授予 `iam:PassRole`。
```bash cURL
curl --fail-with-body -sS "https://api.anthropic.com/v1/deployments?beta=true" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01" \
-H "content-type: application/json" \
-d '{
"name": "Weekly compliance scan",
"agent": "'"$AGENT_ID"'",
"environment_id": "'"$ENVIRONMENT_ID"'",
"initial_events": [
{"type": "user.message", "content": [{"type": "text", "text": "Run the weekly compliance scan."}]}
],
"schedule": {
"type": "cron",
"expression": "0 20 * * 5",
"timezone": "America/New_York"
}
}'
```
```bash CLI
ant apply deployment.md
```
```markdown
---
name: Weekly compliance scan
agent: agent_011CYm1BLqPXpQRk5khsSXrs
environment_id: env_01595EKxaaTTGwwY3kyXdtbs
schedule:
type: cron
expression: "0 20 * * 5"
timezone: America/New_York
---
Run the weekly compliance scan.
```
[`ant apply`](https://platform.claude.com/docs/zh-TW/cli-sdks-libraries/cli/apply) 會印出新部署的 ID，並將其記錄在 `claude-lock.json` 中。若要查看部署物件，請執行 `ant beta:deployments retrieve`。
```python Python
deployment = client.beta.deployments.create(
name="Weekly compliance scan",
agent=agent.id,
environment_id=environment.id,
initial_events=[
{
"type": "user.message",
"content": [{"type": "text", "text": "Run the weekly compliance scan."}],
},
],
schedule={
"type": "cron",
"expression": "0 20 * * 5",
"timezone": "America/New_York",
},
)
```
```typescript TypeScript
const deployment = await client.beta.deployments.create({
name: "Weekly compliance scan",
agent: agent.id,
environment_id: environment.id,
initial_events: [
{
type: "user.message",
content: [{ type: "text", text: "Run the weekly compliance scan." }]
}
],
schedule: {
type: "cron",
expression: "0 20 * * 5",
timezone: "America/New_York"
}
});
```
```csharp C#
var deployment = await client.Beta.Deployments.Create(new()
{
Name = "Weekly compliance scan",
Agent = agent.ID,
EnvironmentID = environment.ID,
InitialEvents =
[
new BetaManagedAgentsUserMessageEventParams
{
Type = BetaManagedAgentsUserMessageEventParamsType.UserMessage,
Content =
[
new BetaManagedAgentsTextBlock
{
Type = BetaManagedAgentsTextBlockType.Text,
Text = "Run the weekly compliance scan.",
},
],
},
],
Schedule = new BetaManagedAgentsScheduleParams
{
Type = BetaManagedAgentsScheduleParamsType.Cron,
Expression = "0 20 * * 5",
Timezone = "America/New_York",
},
});
```
```go Go
deployment, err := client.Beta.Deployments.New(ctx, anthropic.BetaDeploymentNewParams{
Name: "Weekly compliance scan",
Agent: anthropic.BetaDeploymentNewParamsAgentUnion{OfString: anthropic.String(agent.ID)},
EnvironmentID: environment.ID,
InitialEvents: []anthropic.BetaManagedAgentsDeploymentInitialEventParamsUnion{{
OfUserMessage: &anthropic.BetaManagedAgentsUserMessageEventParams{
Type: anthropic.BetaManagedAgentsUserMessageEventParamsTypeUserMessage,
Content: []anthropic.BetaManagedAgentsUserMessageEventParamsContentUnion{{
OfText: &anthropic.BetaManagedAgentsTextBlockParam{
Type: anthropic.BetaManagedAgentsTextBlockTypeText,
Text: "Run the weekly compliance scan.",
},
}},
},
}},
Schedule: anthropic.BetaManagedAgentsScheduleParams{
Type: anthropic.BetaManagedAgentsScheduleParamsTypeCron,
Expression: "0 20 * * 5",
Timezone: "America/New_York",
},
})
if err != nil {
panic(err)
}
```
```java Java
var deployment = client.beta().deployments().create(
DeploymentCreateParams.builder()
.name("Weekly compliance scan")
.agent(agent.id())
.environmentId(environment.id())
.addInitialEvent(
BetaManagedAgentsUserMessageEventParams.builder()
.type(BetaManagedAgentsUserMessageEventParams.Type.USER_MESSAGE)
.addTextContent("Run the weekly compliance scan.")
.build()
)
.schedule(
BetaManagedAgentsScheduleParams.builder()
.type(BetaManagedAgentsScheduleParams.Type.CRON)
.expression("0 20 * * 5")
.timezone("America/New_York")
.build()
)
.build()
);
```
```php PHP
$deployment = $client->beta->deployments->create(
name: 'Weekly compliance scan',
agent: $agent->id,
environmentID: $environment->id,
initialEvents: [
[
'type' => 'user.message',
'content' => [['type' => 'text', 'text' => 'Run the weekly compliance scan.']],
],
],
schedule: [
'type' => 'cron',
'expression' => '0 20 * * 5',
'timezone' => 'America/New_York',
],
);
```
```ruby Ruby
deployment = client.beta.deployments.create(
name: "Weekly compliance scan",
agent: agent.id,
environment_id: environment.id,
initial_events: [
{
type: "user.message",
content: [{type: "text", text: "Run the weekly compliance scan."}]
}
],
schedule: {
type: "cron",
expression: "0 20 * * 5",
timezone: "America/New_York"
}
)
```
回應包含一個部署物件，其中的 `schedule.upcoming_runs_at` 已填入接下來的觸發時間，讓您確認排程設定正確。
```json
{
"id": "depl_01xyz",
"status": "active",
"paused_reason": null,
"schedule": {
"type": "cron",
"expression": "0 20 * * 5",
"timezone": "America/New_York",
"last_run_at": null,
"upcoming_runs_at": [
"2026-05-09T00:00:00Z",
"2026-05-16T00:00:00Z",
"2026-05-23T00:00:00Z"
]
}
}
```
即將執行的時間戳記反映所設定的確切排程。不過，為了分散負載，實際執行時會套用最多為執行間隔 15% 的「jitter」（抖動），最小為 5 秒，最大為 9 分鐘。
每個組織最多支援 **1,000 個排程部署**。如需更多，請聯絡 Anthropic 支援團隊。
如需完整參數和回應結構描述，請參閱 [Create Deployment 參考文件](https://platform.claude.com/docs/zh-TW/api/beta/deployments/create)。
### Cron 與時區語意
* **Expression：** 標準 POSIX cron（`minute hour day-of-month month day-of-week`）。您可以在 [Claude Console](https://platform.claude.com/workspaces/default/deployments) 中產生並驗證這些 cron 運算式。
* **Timezone：** IANA 時區識別碼（例如 `"America/Los_Angeles"`）。
* **DST：** Cron 排程使用字面上的牆上時鐘時間比對，因此 `America/New_York` 中的 `"0 20 * * *"` 會在當地時間晚上 8:00 觸發，無論當時實施的是 EST 還是 EDT。
在日光節約時間開始日（時鐘撥快）不存在的牆上時鐘時間（例如凌晨 2 點）不會觸發。在日光節約時間結束日（時鐘撥慢）出現兩次的牆上時鐘時間會觸發兩次。若無法接受遺漏或重複執行，請將排程設在當地時間凌晨 1–3 點以外的時段，或使用 UTC。
### 為每次執行設定預算
建立或更新部署時，請傳入選用的 `budget` (csharp, go: `Budget`) 物件。其格式與[工作階段預算](https://platform.claude.com/docs/zh-TW/managed-agents/budgets)相同。部署會將上限複製到其啟動的每個工作階段上，因此預算會分別限制每次執行，而不是作為跨執行的累計上限：上限為 `"2000"` 的部署每次執行最多可花費約 $20。
由部署啟動的工作階段，其行為與任何其他設有預算的工作階段完全相同：當其自身的定價成本[達到上限](https://platform.claude.com/docs/zh-TW/managed-agents/budgets#when-a-session-reaches-its-budget)時，會以 `budget_reached` 暫停。變更部署的預算會套用至之後啟動的執行；已在執行中的工作階段會保留其啟動時的上限，您可以[透過工作階段本身變更](https://platform.claude.com/docs/zh-TW/managed-agents/session-operations#updating-the-session-budget)。與工作階段預算不同，部署的預算可以使用 `"budget": null` (python: `budget=None`; typescript: `budget: null`; ruby: `budget: nil`; go: `Budget: param.NullStruct[anthropic.BetaManagedAgentsBudgetLimitParam]()`; java: `.budget(Optional.empty())`; csharp: `Budget = null`; php: `requestOptions: ['extraBodyParams' => ['budget' => null]]`; cli: `--budget null`) 移除，之後再重新設定。
以下範例為現有部署設定預算：
```bash cURL
curl --fail-with-body -sS "https://api.anthropic.com/v1/deployments/$DEPLOYMENT_ID?beta=true" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01" \
-H "content-type: application/json" \
-d '{
"budget": {
"type": "limit",
"max_list_cost": {"amount": "2000", "currency": "USD"}
}
}'
```
```bash CLI
ant apply deployment.md
```
```markdown
---
name: Weekly compliance scan
agent: agent_011CYm1BLqPXpQRk5khsSXrs
environment_id: env_01595EKxaaTTGwwY3kyXdtbs
schedule:
type: cron
expression: "0 20 * * 5"
timezone: America/New_York
budget:
type: limit
max_list_cost:
amount: "2000"
currency: USD
---
Run the weekly compliance scan.
```
```python Python
updated_deployment = client.beta.deployments.update(
deployment.id,
budget={
"type": "limit",
"max_list_cost": {"amount": "2000", "currency": "USD"},
},
)
print(updated_deployment.budget.max_list_cost.amount) # 2000
```
```typescript TypeScript
const updatedDeployment = await client.beta.deployments.update(deployment.id, {
budget: {
type: "limit",
max_list_cost: { amount: "2000", currency: "USD" }
}
});
console.log(updatedDeployment.budget?.max_list_cost.amount); // 2000
```
```csharp C#
var updatedDeployment = await client.Beta.Deployments.Update(deployment.ID, new()
{
Budget = new()
{
Type = BetaManagedAgentsBudgetLimitType.Limit,
MaxListCost = new() { Amount = "2000", Currency = BetaCurrency.Usd },
},
});
Console.WriteLine(updatedDeployment.Budget?.MaxListCost.Amount); // 2000
```
```go Go
updatedDeployment, err := client.Beta.Deployments.Update(ctx, deployment.ID, anthropic.BetaDeploymentUpdateParams{
Budget: anthropic.BetaManagedAgentsBudgetLimitParam{
Type: anthropic.BetaManagedAgentsBudgetLimitTypeLimit,
MaxListCost: anthropic.BetaMonetaryAmountParam{
Amount: "2000",
Currency: anthropic.BetaCurrencyUsd,
},
},
})
if err != nil {
panic(err)
}
fmt.Println(updatedDeployment.Budget.MaxListCost.Amount) // 2000
```
```java Java
var updatedDeployment = client.beta().deployments().update(
deployment.id(),
DeploymentUpdateParams.builder()
.budget(BetaManagedAgentsBudgetLimit.builder()
.type(BetaManagedAgentsBudgetLimit.Type.LIMIT)
.maxListCost(BetaMonetaryAmount.builder()
.amount("2000")
.currency(BetaCurrency.USD)
.build())
.build())
.build()
);
IO.println(updatedDeployment.budget().orElseThrow().maxListCost().amount()); // 2000
```
```php PHP
$updatedDeployment = $client->beta->deployments->update(
$deployment->id,
budget: [
'type' => 'limit',
'max_list_cost' => ['amount' => '2000', 'currency' => 'USD'],
],
);
echo "{$updatedDeployment->budget->maxListCost->amount}\n"; // 2000
```
```ruby Ruby
updated_deployment = client.beta.deployments.update(
deployment.id,
budget: {
type: "limit",
max_list_cost: {amount: "2000", currency: "USD"}
}
)
puts updated_deployment.budget.max_list_cost.amount # 2000
```
## 部署執行
部署可能因各種原因而無法觸發：例如 `environment` 資源已被封存，或工作階段建立受到速率限制。每次嘗試執行部署都會產生一筆「**deployment run**」（**部署執行**）記錄，讓您能夠獨立於工作階段生命週期之外追蹤成功與失敗。
成功的部署會產生作用中的工作階段，而成功的部署執行會包含相關聯的 `session_id` (java: `sessionId`; php: `sessionID`; csharp, go: `SessionID`)。若要追蹤工作階段的生命週期，請透過[事件串流](https://platform.claude.com/docs/zh-TW/managed-agents/events-and-streaming)或 [webhooks](https://platform.claude.com/docs/zh-TW/managed-agents/webhooks) 追蹤工作階段事件。部署生命週期變更以及每次排程執行的結果也會以 webhook 事件的形式傳送，列於[支援的事件類型](https://platform.claude.com/docs/zh-TW/managed-agents/webhooks#supported-event-types)中的 Deployment events 和 Deployment run events 分頁。
依下列方式列出某個部署的所有部署執行：
```bash cURL
curl --fail-with-body -sS "https://api.anthropic.com/v1/deployment_runs?beta=true&deployment_id=$DEPLOYMENT_ID" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01"
```
```bash CLI
ant beta:deployment-runs list --deployment-id "$DEPLOYMENT_ID"
```
```python Python
for run in client.beta.deployment_runs.list(
deployment_id=deployment.id,
):
print(run.created_at, run.session_id or run.error.type)
```
```typescript TypeScript
for await (const run of client.beta.deploymentRuns.list({
deployment_id: deployment.id
})) {
console.log(run.created_at, run.session_id ?? run.error?.type);
}
```
```csharp C#
var runs = await client.Beta.DeploymentRuns.List(
new() { DeploymentID = deployment.ID }
);
await foreach (var run in runs.Paginate())
{
// Error 聯合型別直接公開 .Message；在新增通用的 .Type 存取器之前，
// 判別子（discriminator）需從 .Json 讀取。
var outcome = run.SessionID ?? run.Error!.Json.GetProperty("type").GetString();
Console.WriteLine($"{run.CreatedAt} {outcome}");
}
```
```go Go
runs := client.Beta.DeploymentRuns.ListAutoPaging(ctx, anthropic.BetaDeploymentRunListParams{
DeploymentID: anthropic.String(deployment.ID),
})
for runs.Next() {
run := runs.Current()
if run.SessionID != "" {
fmt.Println(run.CreatedAt.Format(time.RFC3339), run.SessionID)
} else {
fmt.Println(run.CreatedAt.Format(time.RFC3339), run.Error.Type)
}
}
if err := runs.Err(); err != nil {
panic(err)
}
```
```java Java
for (var run : client.beta().deploymentRuns().list(
DeploymentRunListParams.builder()
.deploymentId(deployment.id())
.build()).autoPager()) {
// Error 聯集型別尚未公開通用的 .type()/.message()
// 存取器；.toString() 會包含兩者。
IO.println(run.createdAt() + " "
+ run.sessionId().orElseGet(() -> run.error().orElseThrow().toString()));
}
```
```php PHP
foreach ($client->beta->deploymentRuns->list(
deploymentID: $deployment->id,
)->pagingEachItem() as $run) {
$outcome = $run->sessionID ?? $run->error->type;
echo "{$run->createdAt->format(DATE_ATOM)} {$outcome}\n";
}
```
```ruby Ruby
client.beta.deployment_runs.list(
deployment_id: deployment.id
).auto_paging_each do
puts "#{it.created_at} #{it.session_id || it.error.type}"
end
```
您還可以篩選出發生錯誤的部署執行：
```bash cURL
curl --fail-with-body -sS "https://api.anthropic.com/v1/deployment_runs?beta=true&deployment_id=$DEPLOYMENT_ID&has_error=true" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01"
```
```bash CLI
ant beta:deployment-runs list --deployment-id "$DEPLOYMENT_ID" --has-error
```
```python Python
for run in client.beta.deployment_runs.list(
deployment_id=deployment.id,
has_error=True,
):
print(run.created_at, run.error.type, run.error.message)
```
```typescript TypeScript
for await (const run of client.beta.deploymentRuns.list({
deployment_id: deployment.id,
has_error: true
})) {
console.log(run.created_at, run.error?.type, run.error?.message);
}
```
```csharp C#
var failedRuns = await client.Beta.DeploymentRuns.List(
new() { DeploymentID = deployment.ID, HasError = true }
);
await foreach (var failedRun in failedRuns.Paginate())
{
var error = failedRun.Error!;
var errorType = error.Json.GetProperty("type").GetString();
Console.WriteLine($"{failedRun.CreatedAt} {errorType} {error.Message}");
}
```
```go Go
failedRuns := client.Beta.DeploymentRuns.ListAutoPaging(ctx, anthropic.BetaDeploymentRunListParams{
DeploymentID: anthropic.String(deployment.ID),
HasError: anthropic.Bool(true),
})
for failedRuns.Next() {
failedRun := failedRuns.Current()
fmt.Println(failedRun.CreatedAt.Format(time.RFC3339), failedRun.Error.Type, failedRun.Error.Message)
}
if err := failedRuns.Err(); err != nil {
panic(err)
}
```
```java Java
for (var run : client.beta().deploymentRuns().list(
DeploymentRunListParams.builder()
.deploymentId(deployment.id())
.hasError(true)
.build()).autoPager()) {
IO.println(run.createdAt() + " " + run.error().orElseThrow());
}
```
```php PHP
foreach ($client->beta->deploymentRuns->list(
deploymentID: $deployment->id,
hasError: true,
)->pagingEachItem() as $run) {
echo "{$run->createdAt->format(DATE_ATOM)} {$run->error->type} {$run->error->message}\n";
}
```
```ruby Ruby
client.beta.deployment_runs.list(
deployment_id: deployment.id,
has_error: true
).auto_paging_each do
puts "#{it.created_at} #{it.error.type} #{it.error.message}"
end
```
失敗的執行會包含一個 `error`，其 `type` 說明工作階段建立遭拒的原因（例如 `environment_archived_error`、`agent_archived_error` 或 `session_rate_limited_error`）。如需所有篩選參數和回應結構描述，請參閱 [List Deployment Runs 參考文件](https://platform.claude.com/docs/zh-TW/api/beta/deployment_runs/list)。
```json
{
"type": "deployment_run",
"id": "drun_01abc124",
"deployment_id": "depl_01xyz",
"trigger_context": { "type": "schedule", "scheduled_at": "2026-05-09T00:00:00Z" },
"session_id": null,
"error": {
"type": "environment_archived_error",
"message": "environment `env_01abc` is archived"
},
"agent": { "type": "agent", "id": "agent_01ghi789", "version": 3 },
"created_at": "2026-05-09T00:00:01Z"
}
```
若要依 ID 擷取單一執行，請呼叫 [`GET /v1/deployment_runs/{deployment_run_id}`](https://platform.claude.com/docs/zh-TW/api/beta/deployment_runs/retrieve)。[`deployment_run` webhook 事件](https://platform.claude.com/docs/zh-TW/managed-agents/webhooks#supported-event-types)會以其 `data.id` 攜帶執行 ID。
## 管理部署生命週期
每次生命週期變更都會發出一個 [webhook 事件](https://platform.claude.com/docs/zh-TW/managed-agents/webhooks#supported-event-types)，因此您無需輪詢即可對已暫停、已取消暫停或已封存的部署做出反應；請參閱 Deployment events 分頁。
**暫停**會從此刻起停止排程觸發；先前部署執行中正在執行的工作階段會繼續執行。暫停期間仍允許透過 `run` 端點進行手動執行。暫停會將 `paused_reason` 設為 `{"type": "manual"}`；取消暫停則會將其清除。
```bash cURL
curl --fail-with-body -sS -X POST "https://api.anthropic.com/v1/deployments/$DEPLOYMENT_ID/pause?beta=true" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01"
```
```bash CLI
ant beta:deployments pause --deployment-id "$DEPLOYMENT_ID"
```
```python Python
client.beta.deployments.pause(deployment.id)
```
```typescript TypeScript
await client.beta.deployments.pause(deployment.id);
```
```csharp C#
await client.Beta.Deployments.Pause(deployment.ID);
```
```go Go
if _, err := client.Beta.Deployments.Pause(ctx, deployment.ID, anthropic.BetaDeploymentPauseParams{}); err != nil {
panic(err)
}
```
```java Java
client.beta().deployments().pause(deployment.id());
```
```php PHP
$client->beta->deployments->pause($deployment->id);
```
```ruby Ruby
client.beta.deployments.pause(deployment.id)
```
**取消暫停**會從下一個排程時間點恢復排程。錯過的觸發不會補執行。
```bash cURL
curl --fail-with-body -sS -X POST "https://api.anthropic.com/v1/deployments/$DEPLOYMENT_ID/unpause?beta=true" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01"
```
```bash CLI
ant beta:deployments unpause --deployment-id "$DEPLOYMENT_ID"
```
```python Python
client.beta.deployments.unpause(deployment.id)
```
```typescript TypeScript
await client.beta.deployments.unpause(deployment.id);
```
```csharp C#
await client.Beta.Deployments.Unpause(deployment.ID);
```
```go Go
if _, err := client.Beta.Deployments.Unpause(ctx, deployment.ID, anthropic.BetaDeploymentUnpauseParams{}); err != nil {
panic(err)
}
```
```java Java
client.beta().deployments().unpause(deployment.id());
```
```php PHP
$client->beta->deployments->unpause($deployment->id);
```
```ruby Ruby
client.beta.deployments.unpause(deployment.id)
```
**封存**與**暫停**不同，是終止性的：排程會終止，且部署無法再被修改。
```bash cURL
curl --fail-with-body -sS -X POST "https://api.anthropic.com/v1/deployments/$DEPLOYMENT_ID/archive?beta=true" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01"
```
```bash CLI
ant beta:deployments archive --deployment-id "$DEPLOYMENT_ID"
```
```python Python
client.beta.deployments.archive(deployment.id)
```
```typescript TypeScript
await client.beta.deployments.archive(deployment.id);
```
```csharp C#
await client.Beta.Deployments.Archive(deployment.ID);
```
```go Go
if _, err := client.Beta.Deployments.Archive(ctx, deployment.ID, anthropic.BetaDeploymentArchiveParams{}); err != nil {
panic(err)
}
```
```java Java
client.beta().deployments().archive(deployment.id());
```
```php PHP
$client->beta->deployments->archive($deployment->id);
```
```ruby Ruby
client.beta.deployments.archive(deployment.id)
```
### 失敗行為
工作階段建立的速率限制回應會立即記錄為 `session_rate_limited_error` 執行，且不會重試；排程會在下一個排程時間點再次嘗試。工作階段內底層 API 呼叫的速率限制則由工作階段本身處理。
如果部署的代理程式已被封存，該部署會在同一操作中自動封存。如果代理程式已被刪除，下一次排程觸發會偵測到代理程式遺失，並自動封存該部署。在這兩種情況下，都不會記錄部署執行。如果代理程式所參照的子代理程式已被封存，下一次觸發會記錄一筆 `error.type: "agent_archived_error"` 的失敗執行，且部署會自動暫停，讓您可以更新代理程式後再恢復。其他無法復原的工作階段建立錯誤（例如已封存的環境或保管庫）也會有相同行為：觸發會記錄一筆失敗執行，且部署會自動暫停。部署的 `paused_reason.error.type` 會與失敗執行的 `error.type` 相同。
## 觸發手動執行
若要在排程之外執行部署，請呼叫 [`run` 端點](https://platform.claude.com/docs/zh-TW/api/beta/deployments/run)。這會立即建立一個工作階段，並寫入一筆 `trigger_context.type: "manual"` 的部署執行。這讓您可以在正式採用排程之前先測試部署。
```bash cURL
curl --fail-with-body -sS -X POST "https://api.anthropic.com/v1/deployments/$DEPLOYMENT_ID/run?beta=true" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01"
```
```bash CLI
ant beta:deployments run --deployment-id "$DEPLOYMENT_ID"
```
```python Python
run = client.beta.deployments.run(deployment.id)
```
```typescript TypeScript
const run = await client.beta.deployments.run(deployment.id);
```
```csharp C#
var manualRun = await client.Beta.Deployments.Run(deployment.ID);
```
```go Go
manualRun, err := client.Beta.Deployments.Run(ctx, deployment.ID, anthropic.BetaDeploymentRunParams{})
if err != nil {
panic(err)
}
```
```java Java
var run = client.beta().deployments().run(deployment.id());
```
```php PHP
$run = $client->beta->deployments->run($deployment->id);
```
```ruby Ruby
run = client.beta.deployments.run(deployment.id)
```