New-PveNodesStorageOciRegistryPull

Pull an OCI image from a registry.

API: POST /nodes/{node}/storage/{storage}/oci-registry-pull, Proxmox VE API viewer

Syntax

New-PveNodesStorageOciRegistryPull
    [-PveTicket <PveTicket>]
    [-Filename <string>]
    -Node <string>
    -Reference <string>
    -Storage <string>
    [<CommonParameters>]

Parameters

Parameter	Type	Required	Description
-PveTicket	PveTicket	No	Ticket data connection.
-Filename	string	No	Custom destination file name of the OCI image. Caution: This will be normalized!
-Node	string	Yes	The cluster node name.
-Reference	string	Yes	The reference to the OCI image to download.
-Storage	string	Yes	The storage identifier.

Every parameter also binds by property name from the pipeline, so an object with node and vmid properties (the output of Get-PveGuest, for one) fills -Node and -Vmid. Without -PveTicket the cmdlet uses the last connection, see Connection.

Output

A PveResponse: the data returned by Proxmox VE is in .Response.data, the outcome in .IsSuccessStatusCode. See Results and Errors.