Chapter 7. Base Image Service V2


7.1. Base Image Service V2

7.1.1. CreateBaseImageReference

POST /v2/baseimages

CreateBaseImageReference creates a new base image reference.

7.1.1.1. Description

7.1.1.2. Parameters

7.1.1.2.1. Body Parameter
Expand
NameDescriptionRequiredDefaultPattern

body

V2CreateBaseImageReferenceRequest

X

  

7.1.1.3. Return Type

V2CreateBaseImageReferenceResponse

7.1.1.4. Content Type

  • application/json

7.1.1.5. Responses

Expand
Table 7.1. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V2CreateBaseImageReferenceResponse

0

An unexpected error response.

RpcStatus

7.1.1.6. Samples

7.1.2. DeleteBaseImageReference

DELETE /v2/baseimages/{id}

DeleteBaseImageReference deletes a base image reference.

7.1.2.1. Description

7.1.2.2. Parameters

7.1.2.2.1. Path Parameters
Expand
NameDescriptionRequiredDefaultPattern

id

 

X

null

 

7.1.2.3. Return Type

Object

7.1.2.4. Content Type

  • application/json

7.1.2.5. Responses

Expand
Table 7.2. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

Object

0

An unexpected error response.

RpcStatus

7.1.2.6. Samples

7.1.3. GetBaseImageReferences

GET /v2/baseimages

GetBaseImageReferences returns all base image references.

7.1.3.1. Description

7.1.3.2. Parameters

7.1.3.3. Return Type

V2GetBaseImageReferenceResponse

7.1.3.4. Content Type

  • application/json

7.1.3.5. Responses

Expand
Table 7.3. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V2GetBaseImageReferenceResponse

0

An unexpected error response.

RpcStatus

7.1.3.6. Samples

7.1.4. UpdateBaseImageTagPattern

PUT /v2/baseimages/{id}

UpdateBaseImageTagPattern updates the tag pattern of an existing base image reference.

7.1.4.1. Description

7.1.4.2. Parameters

7.1.4.2.1. Path Parameters
Expand
NameDescriptionRequiredDefaultPattern

id

 

X

null

 
7.1.4.2.2. Body Parameter
Expand
NameDescriptionRequiredDefaultPattern

body

BaseImageServiceV2UpdateBaseImageTagPatternBody

X

  

7.1.4.3. Return Type

Object

7.1.4.4. Content Type

  • application/json

7.1.4.5. Responses

Expand
Table 7.4. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

Object

0

An unexpected error response.

RpcStatus

7.1.4.6. Samples

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat Documentation

Legal Notice

Theme

© 2026 Red Hat
Back to top