Create Base Image

Create Base Image

Create a new private base image in a registry for the organization

Request
URI
POST
https://{api_host}/v1/base-images
COPY
Request Body
BaseImageRequest of type(s) application/json
Optional 
{
    "name": "Debian 11",
    "description": "Debian 11 base image",
    "registry_id": "549cfa79-352c-4555-9d28-4442de551829",
    "container_image": "base-images/debian:buster",
    "operating_system_id": "2a4ed7c4-e94f-4cb5-a567-eae98e8efc49"
}
string
name
Required

Name of the base image

string
description
Required

Description of the base image

string
registry_id
Required

Identifier of the registry

string
container_image
Required

The container image described by REPOSITORY_NAME/IMAGE_NAME:TAG

string
operating_system_id
Required

The operating system id used in the base image

Authentication
This operation uses the following authentication methods.
Responses
201

The base image has been created

Operation doesn't return any data structure

Response Headers

string
Location

Url to request the base image that has been created.


400

An error related to the request

Returns ConstraintsViolationsError of type(s) application/problem+json
This response body class contains all of the following: InlineConstraintsViolationsError0 
"ConstraintsViolationsError Object"
array of object
violations
Required

It represents a constraints violation error


403

The requesting user is not authorized to create new base image

Returns Error403 of type(s) application/problem+json
This response body class contains all of the following: InlineError4030 
"Error403 Object"

500

An internal server error object

Returns Error500 of type(s) application/problem+json
This response body class contains all of the following: InlineError5000 
"Error500 Object"

503

The server is temporarily unavailable

Returns Error503 of type(s) application/problem+json
This response body class contains all of the following: InlineError5030 
"Error503 Object"

Code Samples
COPY 
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"container_image:"string","description:"string","name:"string","operating_system_id:"string","registry_id:"string"}' https://{api_host}/v1/base-images
On This Page
Base Images Operations
GET
Get Base Images
POST
Create Base Image
GET
Get Base Image
DELETE
Delete Base Image
PATCH
Update Base Image