Create a new application
client.Containers.Applications.New(ctx, params) (*ApplicationNewResponse, error)
POST/accounts/{account_id}/containers/applications
Create a Containers application.
Use scheduling_policy: "default" for a scheduler-backed application. The
Containers scheduler maintains the requested instance count and manages
deployment configuration, placement, scaling, versions, and rollouts.
Use scheduling_policy: "durable_object" for a Durable Object-managed
application. Each Durable Object creates and manages the lifecycle of its
container instance. Supply name, scheduling_policy, and durable_objects,
with optional configuration and optional top-level observability settings.
Deployment configuration, scaling, constraints, versions, and rollouts do not apply.
Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
Example:
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
Example:
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
Example:
Create a new application
package main
import (
"context"
"fmt"
"github.com/cloudflare/cloudflare-go"
"github.com/cloudflare/cloudflare-go/containers"
"github.com/cloudflare/cloudflare-go/option"
)
func main() {
client := cloudflare.NewClient(
option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
)
application, err := client.Containers.Applications.New(context.TODO(), containers.ApplicationNewParams{
AccountID: cloudflare.F("account-123"),
Body: containers.ApplicationNewParamsBodyCcContainersCreateScheduledApplicationRequest{
Configuration: cloudflare.F(containers.ApplicationNewParamsBodyCcContainersCreateScheduledApplicationRequestConfiguration{
Image: cloudflare.F("image"),
}),
Instances: cloudflare.F(int64(0)),
MaxInstances: cloudflare.F(int64(0)),
Name: cloudflare.F("name"),
SchedulingPolicy: cloudflare.F(containers.ApplicationNewParamsBodyCcContainersCreateScheduledApplicationRequestSchedulingPolicyDefault),
},
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", application)
}
{
"errors": [
{
"code": 1000,
"message": "message",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"messages": [
{
"code": 1000,
"message": "message",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"result": {
"id": "id",
"account_id": "account_id",
"configuration": {
"image": "image",
"authorized_keys": [
{
"public_key": "public_key",
"name": "name"
}
],
"command": [
"myapp",
"--default-option"
],
"entrypoint": [
"/bin/bash"
],
"environment_variables": [
{
"name": "name",
"value": "value"
}
],
"instance_type": "lite",
"observability": {
"logs": {
"enabled": true
}
}
},
"created_at": "2021-04-01T12:32:41.488Z",
"instances": 0,
"name": "name",
"scheduling_policy": "default",
"updated_at": "2021-04-01T12:32:41.488Z",
"version": 0,
"active_rollout_id": "active_rollout_id",
"constraints": {
"jurisdiction": "jurisdiction",
"regions": [
"WNAM"
]
},
"durable_objects": {
"namespace_id": "14758f1afd44c09b7992073ccf00b43d"
},
"health": {
"errors": [
{
"event": {
"id": "id",
"details": {
"foo": "bar"
},
"message": "message",
"name": "SchedulerPlaced",
"statusChange": {
"foo": "bar"
},
"time": "2021-04-01T12:32:41.488Z",
"type": "Info"
},
"instance_id": "instance_id"
}
],
"instances": {
"active": 0,
"assigned": 0
},
"summary": "healthy"
},
"max_instances": 0,
"observability": {
"logs": {
"enabled": true
}
},
"rollout_active_grace_period": 0
},
"success": true
}Returns Examples
{
"errors": [
{
"code": 1000,
"message": "message",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"messages": [
{
"code": 1000,
"message": "message",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"result": {
"id": "id",
"account_id": "account_id",
"configuration": {
"image": "image",
"authorized_keys": [
{
"public_key": "public_key",
"name": "name"
}
],
"command": [
"myapp",
"--default-option"
],
"entrypoint": [
"/bin/bash"
],
"environment_variables": [
{
"name": "name",
"value": "value"
}
],
"instance_type": "lite",
"observability": {
"logs": {
"enabled": true
}
}
},
"created_at": "2021-04-01T12:32:41.488Z",
"instances": 0,
"name": "name",
"scheduling_policy": "default",
"updated_at": "2021-04-01T12:32:41.488Z",
"version": 0,
"active_rollout_id": "active_rollout_id",
"constraints": {
"jurisdiction": "jurisdiction",
"regions": [
"WNAM"
]
},
"durable_objects": {
"namespace_id": "14758f1afd44c09b7992073ccf00b43d"
},
"health": {
"errors": [
{
"event": {
"id": "id",
"details": {
"foo": "bar"
},
"message": "message",
"name": "SchedulerPlaced",
"statusChange": {
"foo": "bar"
},
"time": "2021-04-01T12:32:41.488Z",
"type": "Info"
},
"instance_id": "instance_id"
}
],
"instances": {
"active": 0,
"assigned": 0
},
"summary": "healthy"
},
"max_instances": 0,
"observability": {
"logs": {
"enabled": true
}
},
"rollout_active_grace_period": 0
},
"success": true
}