Create a new application
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.
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
Create a new application
import os
from cloudflare import Cloudflare
client = Cloudflare(
api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted
)
application = client.containers.applications.create(
account_id="account-123",
configuration={
"image": "image"
},
instances=0,
max_instances=0,
name="name",
scheduling_policy="default",
)
print(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
}