HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityDoc feedbackLog In
GitHubNuGetDev CommunityDoc feedback


Storage accounts are provisioned as part of a DXP project and are used for various purposes (for example, access logs or to download site contents). The storage container API allows access to the BLOB storage containers and contents. The API has the following operations.

  1. **List** – Lists the available BLOB storage containers.

  2. **Generate SAS link** – Generates a read-only SAS link for a blob container with a dynamic link expiration time

The storage containers API uses an authentication mechanism similar to other deployment APIs. See [Deployment API authentication](🔗).

## Get containers list

### Request

**GET** api/v1.0/projects/{projectId:guid}/environments/{environment}/storagecontainers

### Parameters

NameTypeDescription
projectIdGuidThe identifier of the project.
environmentstringThe name of the environment for which the BLOB storage containers are to be listed.

### Response



## Generate SAS link

### Request

**POST** api/v1.0/projects/{projectId:guid}/environments/{environment}/storagecontainers/{containerName}/saslink

### Parameters

NameTypeDescription
projectIdGuidThe identifier of the project.
environmentstringThe name of the environment for which the BLOB storage containers are to be listed.
containerNamestringName of the container for which a SAS link to be generated.

### Body


NameTypeDescription
retentionHoursintTotal hours until the SAS link is valid to access after which it will expire. Default value is 24 if no body is included with the POST request.

### Response



## Epicloud Module

The [EpiCloud PowerShell module](🔗) adds the **Get-EpiStorageContainer** and **Get-EpiStorageContainerSasLink** cmdlets to perform the storage containers API operations using PowerShell. To install the module and connect with the authentication mechanism, see [Deploy Using PowerShell](🔗) for information about how to install the EpiCloud module.

### Get-EpiStorageContainer

Fetches the list of BLOB storage containers for an environment in the project.



### Get-EpiStorageContainerSasLink

Generates a new read-only SAS link for a specific BLOB storage container. The parameter, **-RetentionHours** takes a dynamic value for the SAS link expiry; if it is not provided, a default 24 hours is used to generate the link.