Skip to main content

Azure Files Component

Manage files and folders within Azure Files

Component key: azure-files

Description#

Azure Files is Microsoft's cloud file sharing platform. While similar to Azure Blob Storage, Azure Files is geared towards creating SMB file shares that groups of users (rather than applications) can use. This component lets you manage files and shares within Azure Files.

Information about Azure Files can be found on their documentation site.

A common integration pattern involves listing files in a file store, and performing a series of actions on the array of files that are returned. See our looping over files quickstart for information about how to create a loop over an array of files.

Authorization Notes#

Azure components use storageSharedKeyCredential authentication, which involves an account / key pair. You can obtain an account name / account key pair through the Azure Portal. Enter the account name as your Username, and account key as your Password.

Actions#

Copy File#

Copy a file | key: copyFile

InputKeyNotesExample

From Path

string
/ Required
fromPathAn object in Azure Files is a file that is saved in a 'share'. This represents the source object's file path. Do not include a leading /path/to/source/file.txt

Share Name

string
/ Required
shareNameAn Azure Files 'share' is a container where files are stored. You can create a share from within the Azure console. Share names contain only letters, numbers, and dashes.my-file-share

To Path

string
/ Required
toPathAn object in Azure Files is a file that is saved in a 'share'. This represents the destination object's file path. Do not include a leading /path/to/destination/file.txt

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
Basic AuthbasicBasic authorization using a username/password combination

Username |  username

Password |  password

Output Example Payload#

{  "data": {    "_response": {      "parsedHeaders": {},      "status": 200,      "request": {        "url": "www.prismatic.io",        "method": "POST",        "withCredentials": false,        "timeout": 500,        "requestId": "exampleID"      }    }  }}

Create Folder#

Create a folder under an existing path | key: createFolder

InputKeyNotesExample

Path

string
/ Required
pathAn object in Azure Files is a file that is saved in a 'share'. This represents the object's file path. Do not include a leading /path/to/file.txt

Share Name

string
/ Required
shareNameAn Azure Files 'share' is a container where files are stored. You can create a share from within the Azure console. Share names contain only letters, numbers, and dashes.my-file-share

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
Basic AuthbasicBasic authorization using a username/password combination

Username |  username

Password |  password

Output Example Payload#

{  "data": {    "_response": {      "parsedHeaders": {},      "status": 200,      "request": {        "url": "www.prismatic.io",        "method": "POST",        "withCredentials": false,        "timeout": 500,        "requestId": "exampleID"      }    }  }}

Create Share#

Create a file share | key: createShare

InputKeyNotesExample

Share Name

string
/ Required
shareNameAn Azure Files 'share' is a container where files are stored. You can create a share from within the Azure console. Share names contain only letters, numbers, and dashes.my-file-share

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
Basic AuthbasicBasic authorization using a username/password combination

Username |  username

Password |  password

Output Example Payload#

{  "data": {    "_response": {      "parsedHeaders": {},      "status": 200,      "request": {        "url": "www.prismatic.io",        "method": "POST",        "withCredentials": false,        "timeout": 500,        "requestId": "exampleID"      }    },    "shareCreateResponse": {      "_response": {        "parsedHeaders": {}      }    }  }}

Delete File#

Delete a file | key: deleteFile

InputKeyNotesExample

Path

string
/ Required
pathAn object in Azure Files is a file that is saved in a 'share'. This represents the object's file path. Do not include a leading /path/to/file.txt

Share Name

string
/ Required
shareNameAn Azure Files 'share' is a container where files are stored. You can create a share from within the Azure console. Share names contain only letters, numbers, and dashes.my-file-share

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
Basic AuthbasicBasic authorization using a username/password combination

Username |  username

Password |  password

Output Example Payload#

{  "data": {    "_response": {      "parsedHeaders": {},      "status": 200,      "request": {        "url": "www.prismatic.io",        "method": "POST",        "withCredentials": false,        "timeout": 500,        "requestId": "exampleID"      }    }  }}

Delete Folder#

Delete an empty folder under an existing path | key: deleteFolder

InputKeyNotesExample

Path

string
/ Required
pathAn object in Azure Files is a file that is saved in a 'share'. This represents the object's file path. Do not include a leading /path/to/file.txt

Share Name

string
/ Required
shareNameAn Azure Files 'share' is a container where files are stored. You can create a share from within the Azure console. Share names contain only letters, numbers, and dashes.my-file-share

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
Basic AuthbasicBasic authorization using a username/password combination

Username |  username

Password |  password

Output Example Payload#

{  "data": {    "_response": {      "parsedHeaders": {},      "status": 200,      "request": {        "url": "www.prismatic.io",        "method": "POST",        "withCredentials": false,        "timeout": 500,        "requestId": "exampleID"      }    }  }}

Delete Share#

Delete a file share | key: deleteShare

InputKeyNotesExample

Share Name

string
/ Required
shareNameAn Azure Files 'share' is a container where files are stored. You can create a share from within the Azure console. Share names contain only letters, numbers, and dashes.my-file-share

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
Basic AuthbasicBasic authorization using a username/password combination

Username |  username

Password |  password

Output Example Payload#

{  "data": {    "_response": {      "parsedHeaders": {},      "status": 200,      "request": {        "url": "www.prismatic.io",        "method": "POST",        "withCredentials": false,        "timeout": 500,        "requestId": "exampleID"      }    }  }}

Download File#

Download a file | key: downloadFile

InputKeyNotesExample

Path

string
/ Required
pathAn object in Azure Files is a file that is saved in a 'share'. This represents the object's file path. Do not include a leading /path/to/file.txt

Share Name

string
/ Required
shareNameAn Azure Files 'share' is a container where files are stored. You can create a share from within the Azure console. Share names contain only letters, numbers, and dashes.my-file-share

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
Basic AuthbasicBasic authorization using a username/password combination

Username |  username

Password |  password

Output Example Payload#

{  "data": {    "type": "Buffer",    "data": [      101,      120,      97,      109,      112,      108,      101    ]  },  "contentType": "application/octet"}

List Folder#

List files and folders in a folder | key: listFolder

InputKeyNotesExample

Path

string
/ Required
pathAn object in Azure Files is a file that is saved in a 'share'. This represents the object's file path. Do not include a leading /path/to/file.txt

Share Name

string
/ Required
shareNameAn Azure Files 'share' is a container where files are stored. You can create a share from within the Azure console. Share names contain only letters, numbers, and dashes.my-file-share

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
Basic AuthbasicBasic authorization using a username/password combination

Username |  username

Password |  password

Output Example Payload#

{  "data": [    {      "_response": {        "parsedHeaders": {},        "status": 200,        "request": {          "url": "www.prismatic.io",          "method": "POST",          "withCredentials": false,          "timeout": 500,          "requestId": "exampleID"        }      },      "shareName": "Example Share",      "serviceEndpoint": "https://example.com",      "directoryPath": "/share/exampleShare",      "continuationToken": "1234abc",      "segment": {        "directoryItems": [],        "fileItems": []      }    }  ]}

List Shares#

Get a list of file shares available in the account | key: listShares

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
Basic AuthbasicBasic authorization using a username/password combination

Username |  username

Password |  password

Output Example Payload#

{  "data": [    {      "name": "example",      "snapshot": "snapshot-v1",      "properties": {}    }  ]}

Upload File#

Upload a file under an existing path | key: uploadFile

InputKeyNotesExample

File Contents

data
/ Required
fileContentsThe contents to write to a file. This can be a string of text, it can be binary data (like an image or PDF) that was generated in a previous step.My File Contents

Path

string
/ Required
pathAn object in Azure Files is a file that is saved in a 'share'. This represents the object's file path. Do not include a leading /path/to/file.txt

Share Name

string
/ Required
shareNameAn Azure Files 'share' is a container where files are stored. You can create a share from within the Azure console. Share names contain only letters, numbers, and dashes.my-file-share

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
Basic AuthbasicBasic authorization using a username/password combination

Username |  username

Password |  password

Output Example Payload#

{  "data": {    "_response": {      "parsedHeaders": {},      "status": 200,      "request": {        "url": "www.prismatic.io",        "method": "POST",        "withCredentials": false,        "timeout": 500,        "requestId": "exampleID"      }    }  }}