---
title: "Introduction"
slug: "api-nds-azure-introduction"
updated: 2025-07-23T14:22:44Z
published: 2025-07-23T14:22:44Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nasuni.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

## **Nasuni Data Service (NDS) API**

**Version 1.0.0**

### Overview

Welcome to Nasuni Data Service (NDS) API Documentation.

NDS provides an Azure Blob Storage–compatible endpoint for accessing data stored in Nasuni volumes. This enables direct, read-only interaction with cloud object storage, without requiring a Nasuni Edge Appliance (NEA).

### Authentication

The API supports two authentication methods:

1. **SAS Token Authentication**  
Use a Shared Access Signature (SAS) token to authorize requests. You can generate SAS tokens during NDS deployment. Required query parameters include:
  - `sv`: Storage service version
  - `ss`: Accessible services
  - `srt`: Accessible resource types
  - `sp`: Permissions granted
  - `se`: Expiration time
  - `st`: Start time
  - `sig`: Token signature
2. **Shared Key Authentication**  
Authenticate by signing your requests using a shared key. Include the key in the `Authorization` header to sign your requests. Use one of the two shared keys generated during NDS deployment.

### Available Operations

- **List Containers**  
Retrieve all containers (Nasuni Volumes)
registered with NDS.
- **List Blobs**  
Retrieve all blobs (files) in a specified container
(Nasuni Volume).
- **Get Blob**  
Download a specific blob (file) from a container.
- **Get Blob Properties**  
Retrieve metadata and properties of a specific blob without downloading its contents.
