# Azure Files Share API

**Canonical:** https://apis.io/apis/azure-file-storage/azure-file-storage-share-api/  
**Provider:** Azure Files — https://apis.io/providers/azure-file-storage/  
**Base URL:** https://{account-name}.file.core.windows.net  
**Documentation:** https://learn.microsoft.com/en-us/rest/api/storageservices/file-service-rest-api

Azure Files Share API is one of 10 APIs that [Azure Files](https://apis.io/providers/azure-file-storage/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Share. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

The share API from Azure Files — 13 operation(s) for share.

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| PUT | `/{shareName}?restype=share` | Share create |
| GET | `/{shareName}?restype=share` | Share get properties |
| DELETE | `/{shareName}?restype=share` | Share delete |
| PUT | `/{shareName}?restype=share&comp=lease&acquire` | Share acquire lease |
| PUT | `/{shareName}?restype=share&comp=lease&release` | Share release lease |
| PUT | `/{shareName}?restype=share&comp=lease&change` | Share change lease |
| PUT | `/{shareName}?restype=share&comp=lease&renew` | Share renew lease |
| PUT | `/{shareName}?restype=share&comp=lease&break` | Share break lease |
| PUT | `/{shareName}?restype=share&comp=snapshot` | Share create snapshot |
| PUT | `/{shareName}?restype=share&comp=filepermission` | Share create permission |
| GET | `/{shareName}?restype=share&comp=filepermission` | Share get permission |
| PUT | `/{shareName}?restype=share&comp=properties` | Share set properties |
| PUT | `/{shareName}?restype=share&comp=metadata` | Share set metadata |
| GET | `/{shareName}?restype=share&comp=acl` | Share get access policy |
| PUT | `/{shareName}?restype=share&comp=acl` | Share set access policy |
| GET | `/{shareName}?restype=share&comp=stats` | Share get statistics |
| PUT | `/{shareName}?restype=share&comp=undelete` | Share restore |

## Machine-readable artifacts (10)

- **OpenAPI** — https://artifacts.apis.io/azure-file-storage/openapi/azure-file-storage-share-api-openapi.yml
- **Documentation** — https://learn.microsoft.com/en-us/rest/api/storageservices/file-service-rest-api
- **Operations on Shares** — https://learn.microsoft.com/en-us/rest/api/storageservices/operations-on-shares--file-service-
- **Operations on Files** — https://learn.microsoft.com/en-us/rest/api/storageservices/operations-on-files
- **JSONSchema** — https://artifacts.apis.io/azure-file-storage/json-schema/azure-file-storage-user-delegation-key-schema.json
- **JSONSchema** — https://artifacts.apis.io/azure-file-storage/json-schema/azure-file-storage-list-files-and-directories-segment-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/azure-file-storage/json-schema/azure-file-storage-storage-service-properties-schema.json
- **JSONSchema** — https://artifacts.apis.io/azure-file-storage/json-schema/azure-file-storage-list-shares-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/azure-file-storage/json-schema/azure-file-storage-key-info-schema.json
- **JSONSchema** — https://artifacts.apis.io/azure-file-storage/json-schema/azure-file-storage-share-permission-schema.json

## Other Azure Files APIs (9)

- [Azure Storage Resource Provider API (File Services / Shares)](https://apis.io/apis/azure-file-storage/storage-rp-api/)
- [Azure Files Account API](https://apis.io/apis/azure-file-storage/azure-file-storage-account-api/)
- [Azure Files Directories API](https://apis.io/apis/azure-file-storage/azure-file-storage-directories-api/)
- [Azure Files API](https://apis.io/apis/azure-file-storage/azure-file-storage-files-api/)
- [Azure Files Shares API](https://apis.io/apis/azure-file-storage/azure-file-storage-shares-api/)
- [Azure File Storage Shares API](https://apis.io/apis/azure-file-storage/microsoft-azure-file-storage-shares-api/)
- [Azure Files Directory API](https://apis.io/apis/azure-file-storage/azure-file-storage-directory-api/)
- [Azure Files File API](https://apis.io/apis/azure-file-storage/azure-file-storage-file-api/)
- [Azure Files Service API](https://apis.io/apis/azure-file-storage/azure-file-storage-service-api/)

## Tags

Share

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/azure-file-storage/azure-file-storage-share-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/azure-file-storage/.