Update a service
/v1.33
/v1.33
/v1.33
/v1.33
POST
/services/{id}/update
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1.33/services//update?version=' \
--header 'Content-Type: application/json' \
--data-raw '{
"EndpointSpec": {
"Mode": "vip",
"Ports": [
{
"Name": "string",
"Protocol": "tcp",
"PublishedPort": 0,
"TargetPort": 0
}
]
},
"Labels": {
"property1": "string",
"property2": "string"
},
"Mode": {
"Global": {},
"Replicated": {
"Replicas": 1
}
},
"Name": "top",
"Networks": [
{
"Aliases": [
"string"
],
"Target": "string"
}
],
"RollbackConfig": {
"Delay": 1000000000,
"FailureAction": "pause",
"MaxFailureRatio": 0.15,
"Monitor": 15000000000,
"Order": "stop-first",
"Parallelism": 1
},
"TaskTemplate": {
"ContainerSpec": {
"Args": [
"top"
],
"Command": [
"string"
],
"Configs": [
{
"ConfigID": "string",
"ConfigName": "string",
"File": {
"GID": "string",
"Mode": 0,
"Name": "string",
"UID": "string"
}
}
],
"DNSConfig": {
"Nameservers": [
"string"
],
"Options": [
"string"
],
"Search": [
"string"
]
},
"Dir": "string",
"Env": [
"string"
],
"Groups": [
"string"
],
"HealthCheck": {
"Interval": 0,
"Retries": 0,
"StartPeriod": 0,
"Test": [
"string"
],
"Timeout": 0
},
"Hostname": "string",
"Hosts": [
"string"
],
"Image": "busybox",
"Labels": {
"property1": "string",
"property2": "string"
},
"Mounts": [
{
"BindOptions": {
"Propagation": "private"
},
"Consistency": "string",
"ReadOnly": true,
"Source": "string",
"Target": "string",
"TmpfsOptions": {
"Mode": 0,
"SizeBytes": 0
},
"Type": "bind",
"VolumeOptions": {
"DriverConfig": {
"Name": "string",
"Options": {
"property1": "string",
"property2": "string"
}
},
"Labels": {
"property1": "string",
"property2": "string"
},
"NoCopy": false
}
}
],
"OpenStdin": true,
"Privileges": {
"CredentialSpec": {
"File": "string",
"Registry": "string"
},
"SELinuxContext": {
"Disable": true,
"Level": "string",
"Role": "string",
"Type": "string",
"User": "string"
}
},
"ReadOnly": true,
"Secrets": [
{
"File": {
"GID": "string",
"Mode": 0,
"Name": "string",
"UID": "string"
},
"SecretID": "string",
"SecretName": "string"
}
],
"StopGracePeriod": 0,
"StopSignal": "string",
"TTY": true,
"User": "string"
},
"ForceUpdate": 0,
"LogDriver": {
"Name": "string",
"Options": {
"property1": "string",
"property2": "string"
}
},
"Networks": [
{
"Aliases": [
"string"
],
"Target": "string"
}
],
"Placement": {
"Constraints": [
"node.hostname!=node3.corp.example.com",
"node.role!=manager",
"node.labels.type==production"
],
"Platforms": [
{
"Architecture": "x86_64",
"OS": "linux"
}
],
"Preferences": [
{
"Spread": {
"SpreadDescriptor": "node.labels.datacenter"
}
},
{
"Spread": {
"SpreadDescriptor": "node.labels.rack"
}
}
]
},
"PluginSpec": {
"Disabled": true,
"Name": "string",
"PluginPrivilege": [
{
"Description": "string",
"Name": "string",
"Value": [
"string"
]
}
],
"Remote": "string"
},
"Resources": {
"Limits": {
"GenericResources": [
{
"DiscreteResourceSpec": {
"Kind": "SSD",
"Value": 3
}
},
{
"NamedResourceSpec": {
"Kind": "GPU",
"Value": "UUID1"
}
},
{
"NamedResourceSpec": {
"Kind": "GPU",
"Value": "UUID2"
}
}
],
"MemoryBytes": 8272408576,
"NanoCPUs": 4000000000
},
"Reservation": {
"GenericResources": [
{
"DiscreteResourceSpec": {
"Kind": "SSD",
"Value": 3
}
},
{
"NamedResourceSpec": {
"Kind": "GPU",
"Value": "UUID1"
}
},
{
"NamedResourceSpec": {
"Kind": "GPU",
"Value": "UUID2"
}
}
],
"MemoryBytes": 8272408576,
"NanoCPUs": 4000000000
},
"Reservations": {}
},
"RestartPolicy": {
"Condition": "any",
"Delay": 0,
"MaxAttempts": 0,
"Window": 0
},
"Runtime": "string"
},
"UpdateConfig": {
"Delay": 1000000000,
"FailureAction": "pause",
"MaxFailureRatio": 0.15,
"Monitor": 15000000000,
"Order": "stop-first",
"Parallelism": 2
}
}'Response Response Example
200 - Example 1
{
"Warning": "unable to pin image doesnotexist:latest to digest: image library/doesnotexist:latest not found"
}Request
Path Params
Query Params
Header Params
Body Params application/json
Responses
Modified at 2022-09-10 17:56:07