Skip to content
Athena User Guide
Esc
↑↓navigate↵open⌘Jpreview

Record a service's verified image digests; refused once the host is allocated

POST/api/admin/services/{id}/image
Authorization
AuthorizationBearer token · headerrequired
Path parameters
idstringrequired
min length 1
Request body
requiredapplication/json
imagestringrequired
min length 1 · max length 512
imageDigeststringrequired
matches ^sha256:[a-f0-9]{64}$
checkerImagestringrequired
min length 1 · max length 512
checkerImageDigeststringrequired
matches ^sha256:[a-f0-9]{64}$
pullCredentialsobject | null
Show properties
Any of:
object
usernamestringrequired
min length 1 · max length 256
passwordstringrequired
min length 1 · max length 4096
null
null
expectedUpdatedAtstring<date-time>
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
Responses
200

Success

idstringrequired
numbernumberrequired
slugstringrequired
namestringrequired
descriptionstringrequired
imagestringrequired
imageDigeststringrequired
checkerImagestringrequired
checkerImageDigeststringrequired
pullUsernamestring | nullrequired
Show properties
Any of:
string
string
null
null
portsobject[]required
Show properties
Array of object
portnumberrequired
protocolstringrequired
Show properties
Any of:
string
string
string
string
checkerTimeoutSecondsnumber | nullrequired
Show properties
Any of:
number
number
null
null
enabledbooleanrequired
positionnumberrequired
sourceFileIdstring | nullrequired
Show properties
Any of:
string
string
null
null
createdBystring | nullrequired
Show properties
Any of:
string
string
null
null
createdAtstring<date-time>required
updatedAtstring<date-time>required
pullCredentialsSetbooleanrequired
401

Unauthorized

errorstringrequired
404

Response for status 404

errorstringrequired
409

Response for status 409

errorstringrequired
422

Validation failed

typestringrequired
onstringrequired
summarystring
messagestring
foundany
propertystring
expectedstring
500

Unhandled server error

errorstringrequired
Try it
Server
Authorization
Parameters
Bodyapplication/json
Request
curl -X POST '/api/admin/services/string/image' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "image": "string",
  "imageDigest": "string",
  "checkerImage": "string",
  "checkerImageDigest": "string",
  "pullCredentials": {
    "username": "string",
    "password": "string"
  },
  "expectedUpdatedAt": "2019-08-24T14:15:22Z"
}'
Response
{
  "id": "string",
  "number": 0,
  "slug": "string",
  "name": "string",
  "description": "string",
  "image": "string",
  "imageDigest": "string",
  "checkerImage": "string",
  "checkerImageDigest": "string",
  "pullUsername": "string",
  "ports": [
    {
      "port": 0,
      "protocol": "tcp"
    }
  ],
  "checkerTimeoutSeconds": 0,
  "enabled": true,
  "position": 0,
  "sourceFileId": "string",
  "createdBy": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "pullCredentialsSet": true
}