container_registry_blob

Creates, updates, deletes, gets or lists a container_registry_blob resource.

Overview

Name	container_registry_blob
Type	Resource
Id	azure.container_registry_dataplane.container_registry_blob

Fields

The following fields are returned by SELECT queries:

SELECT not supported for this resource, use SHOW METHODS to view available operations for the resource.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
cancel_upload	delete	next_blob_uuid_link, endpoint		Cancel outstanding upload processes, releasing associated resources. If this is not called, the unfinished uploads will eventually timeout.
get_blob	exec	name, digest, endpoint		Retrieve the blob from the registry identified by digest.
check_blob_exists	exec	name, digest, endpoint		Same as GET, except only the headers are returned.
delete_blob	exec	name, digest, endpoint		Removes an already uploaded blob.
get_upload_status	exec	next_blob_uuid_link, endpoint		Retrieve status of upload identified by uuid. The primary purpose of this endpoint is to resolve the current status of a resumable upload.
upload_chunk	exec	next_blob_uuid_link, endpoint		Upload a stream of data without completing the upload.
complete_upload	exec	next_blob_uuid_link, digest, endpoint		Complete the upload, providing all the data in the body, if necessary. A request without a body will just complete the upload with previously uploaded content.
mount_blob	exec	name, from, mount, endpoint		Mount a blob identified by the mount parameter from another repository.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
digest	string	Digest of a BLOB. Required.
endpoint	string	The service endpoint host (no scheme), e.g. myaccount.table.cosmos.azure.com:443 - value of the client endpoint parameter. (default: )
from	string	Name of the source repository. Required.
mount	string	Digest of blob to mount from the source repository. Required.
name	string	Name of the image (including the namespace). Required.
next_blob_uuid_link	string	Link acquired from upload start or previous chunk. Note, do not include initial / (must do substring(1) ). Required.

DELETE examples

cancel_upload

Cancel outstanding upload processes, releasing associated resources. If this is not called, the unfinished uploads will eventually timeout.

DELETE FROM azure.container_registry_dataplane.container_registry_blob
WHERE next_blob_uuid_link = '{{ next_blob_uuid_link }}' --required
AND endpoint = '{{ endpoint }}' --required
;

Lifecycle Methods

get_blob

Retrieve the blob from the registry identified by digest.

EXEC azure.container_registry_dataplane.container_registry_blob.get_blob 
@name='{{ name }}' --required, 
@digest='{{ digest }}' --required, 
@endpoint='{{ endpoint }}' --required
;

check_blob_exists

Same as GET, except only the headers are returned.

EXEC azure.container_registry_dataplane.container_registry_blob.check_blob_exists 
@name='{{ name }}' --required, 
@digest='{{ digest }}' --required, 
@endpoint='{{ endpoint }}' --required
;

delete_blob

Removes an already uploaded blob.

EXEC azure.container_registry_dataplane.container_registry_blob.delete_blob 
@name='{{ name }}' --required, 
@digest='{{ digest }}' --required, 
@endpoint='{{ endpoint }}' --required
;

get_upload_status

Retrieve status of upload identified by uuid. The primary purpose of this endpoint is to resolve the current status of a resumable upload.

EXEC azure.container_registry_dataplane.container_registry_blob.get_upload_status 
@next_blob_uuid_link='{{ next_blob_uuid_link }}' --required, 
@endpoint='{{ endpoint }}' --required
;

upload_chunk

Upload a stream of data without completing the upload.

EXEC azure.container_registry_dataplane.container_registry_blob.upload_chunk 
@next_blob_uuid_link='{{ next_blob_uuid_link }}' --required, 
@endpoint='{{ endpoint }}' --required
;

complete_upload

Complete the upload, providing all the data in the body, if necessary. A request without a body will just complete the upload with previously uploaded content.

EXEC azure.container_registry_dataplane.container_registry_blob.complete_upload 
@next_blob_uuid_link='{{ next_blob_uuid_link }}' --required, 
@digest='{{ digest }}' --required, 
@endpoint='{{ endpoint }}' --required
;

mount_blob

Mount a blob identified by the mount parameter from another repository.

EXEC azure.container_registry_dataplane.container_registry_blob.mount_blob 
@name='{{ name }}' --required, 
@from='{{ from }}' --required, 
@mount='{{ mount }}' --required, 
@endpoint='{{ endpoint }}' --required
;