Skip to content

Resource: proxmox_oci_image

Manages OCI images pulled from OCI registries using PVE oci-registry-pull API. Pulls OCI container images and stores them as tar files in Proxmox VE datastores.

Schema

Required

Optional

  • file_name (String) The file name for the pulled OCI image. If not provided, it will be generated automatically. The file will be stored as a .tar file.
  • overwrite (Boolean) By default true. If true and the OCI image size has changed in the datastore, it will be replaced. If false, there will be no check.
  • overwrite_unmanaged (Boolean) If true and an OCI image with the same name already exists in the datastore, it will be deleted and the new image will be pulled. If false and the image already exists, an error will be returned.
  • upload_timeout (Number) The OCI image pull timeout in seconds. Default is 600 (10min).

Read-Only

  • id (String) The unique identifier of this resource.
  • size (Number) The image size in PVE.