List blobs in a container

List all containers (i.e. Nasuni Volumes) that are attached to Nasuni Data Service.

SecuritySharedKeyAuthorization or SASAuth_sig or SASAuth_se or SASAuth_sp or SASAuth_sv or SASAuth_ss or SASAuth_srt or SASAuth_sr or SASAuth_st or SASAuth_si or SASAuth_sip or SASAuth_spr or SASAuth_rscc or SASAuth_rscd or SASAuth_rsce or SASAuth_rscl or SASAuth_rsct or SASAuth_rs or SASAuth_ses
Request
path Parameters
container
required
string (Container)
query Parameters
Resource Type (string) or Resource Type (null) (Resource Type)

The type of resource to access, e.g., "container".

Component (string) or Component (null) (Component)

The operation to be performed on the resource, e.g., "list".

Prefix (string) or Prefix (null) (Prefix)

Optional. Filters the results to return only blobs with names that begin with the specified prefix.

Marker (string) or Marker (null) (Marker)

Optional. A string value that identifies the portion of the list to be returned with the next list operation. The operation returns a marker value within the response body if the list returned was not complete. You can then use the marker value in a subsequent call to request the next set of list items.

Max Results (integer) or Max Results (null) (Max Results)

Optional. Specifies the maximum number of blobs to return, including all BlobPrefix elements. If the request doesn't specify maxresults, or specifies a value greater than 5,000, the server will return up to 5,000 items. If there are additional results to return, the service returns a continuation the service might return fewer token in the NextMarker response element. In certain cases, results than specified by maxresults, and also return a NextMarker token.

Delimiter (string) or Delimiter (null) (Delimiter)

Optional. When the request includes this parameter, the operation returns a BlobPrefix element in the response body. This element acts as a placeholder for all blobs with names that begin with the same substring, up to the appearance of the delimiter character. The delimiter can be a single character or a string.

Responses
200

Success. Returns the list of blobs in the container.

400

Bad Request.

403

Forbidden.

404

Not Found. The specified resource does not exist.

get/{container}/
Request samples
Response samples
application/xml
<?xml version="1.0" encoding="UTF-8"?>
<EnumerationResults ServiceEndpoint="https://nds.myapi.myregion.azurecontainerapps.io/" ContainerName="fa4476a0-1234-5678-b801-5e2b153c4677-1"><Blobs><Blob><Name>sample.txt</Name><Properties><AccessTierChangeTime>Fri, 20 Jun 2025 12:00:00 GMT</AccessTierChangeTime><Content-Length>12345</Content-Length><Content-MD5>AbCdEf123456==</Content-MD5><Content-Type>text/plain</Content-Type><Creation-Time>Fri, 20 Jun 2025 12:00:00 GMT</Creation-Time><Last-Modified>Fri, 20 Jun 2025 12:00:00 GMT</Last-Modified><Etag>sample-etag-123</Etag><Cache-Control/><Content-CRC64/><Content-Disposition/><Content-Encoding/><Content-Language/><AccessTier>Hot</AccessTier><AccessTierInferred>true</AccessTierInferred><BlobType>BlockBlob</BlobType><LeaseState>available</LeaseState><LeaseStatus>unlocked</LeaseStatus><ServerEncrypted>true</ServerEncrypted></Properties><Metadata><handle>3.uni3eFa6F0b-738</handle><uid>1000</uid><size>12345</size><mtime>2025-06-20T12:00:00Z</mtime><ctime>2025-06-20T12:00:00Z</ctime><firsthandle>3.uni3eFa6F0b-1</firsthandle></Metadata><OrMetadata/></Blob></Blobs><MaxResults>5000</MaxResults><NextMarker/></EnumerationResults>
Copyright © 2025 Nasuni Corporation. All rights reserved.