Submit a durable command

POST/api/box/v1/{boxId}/executions

Send at most 1 MiB of JSON. The executionId identifies the exact original command, normalized environment, network and authority; changing input under the same identity conflicts. Retries inspect existing work and never replay an uncertain dispatch. Lite reserves credits against the maximum command duration and bills measured wall time (maximum 120 seconds). Sandbox requires a funded running lease with enough remaining time, caps commands at 300 seconds, and requires the lease network policy; it charges only allocated VM time at lease level. Successful HTTP status can contain nonzero exitCode, reconciliation or unavailable output. Preserve executionId and inspect status before any retry.

组织 API Key 鉴权

Authorization: Bearer $SINECLOUD_API_KEY

所需权限: boxRun

参数

boxId · path · 必填

Existing Box resource ID selected in Console, not its parent product activation ID.

请求体

必填

application/json

响应

200

Current command result or durable in-progress/uncertain state.

400

Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.

401

Missing, invalid, expired or revoked organization credential.

402

Insufficient available organization credits for the reservation.

403

Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.

404

Resource, execution, snapshot, restore or file not found within the authorized organization.

409

State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.

413

JSON body exceeds its byte limit.

415

Use Content-Type: application/json.

429

Admission concurrency, rate or budget limit reached.

500

The request could not be completed. Preserve any durable identity before retrying.

503

Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.