VENTAS: 1-800-867-1389

File Service REST API

Actualizado: noviembre de 2014

The Server Message Block (SMB) protocol is the preferred file share protocol used on premise today. The Microsoft Azure File service enables customers to leverage the availability and scalability of Azure’s Cloud Infrastructure as a Service (IaaS) SMB without having to rewrite SMB client applications.

noteNota
The Azure File service is currently in preview. To request access, see the Azure Preview page.

The Azure File service also offers a compelling alternative to traditional Direct Attached Storage (DAS) and Storage Area Network (SAN) solutions, which are often complex and expensive to install, configure, and operate. Pricing for the new Azure File service is consistent with existing Azure Storage services and is charged in units of storage capacity and transactions. See the Azure Storage Pricing page for details.

Files stored in Azure File service shares are accessible via the SMB protocol, and also via REST APIs, at the endpoint http|https://<account>.file.core.window.net. Note that HTTPS is recommended.

While the Azure File service REST APIs are similar to the Azure Blob service REST APIs, there are minor differences related to how the service models the underlying file system. These differences are noted in the operations table below.

The Azure File service offers the following four resources: the storage account, shares, directories, and files. Shares provide a way to organize sets of files and also can be mounted as an SMB file share that is hosted in the cloud.

The File service REST API provides a way to work with share, directory, and file resources via HTTP/HTTPS operations. File service operations are available only in version 2014-02-14 of the storage services or later.

The File service REST API includes the operations listed in the table below.

 

Operation Resource Type REST Verb Description Differences with Blob service operation

Enumerar recursos compartidos

Storage account

GET

Lists all the file shares in a storage account

None

Create Share

Share

PUT

Creates a new share in a storage account.

Request Header

Get Share Properties

Share

GET HEAD

Returns all user-defined metadata and system properties of a share.

None

Set Share Metadata

Share

PUT

Sets user-defined metadata of a share.

None

Get Share Metadata

Share

GET HEAD

Returns only user-defined metadata of a share.

None

Delete Share

Share

DELETE

Deletes the share and any files and directories that it contains.

None

List Directories and Files

Directory

GET

Lists files and directories within the share or specified directory.

Query String Params, Response Body

Create Directory

Directory

PUT

Creates a directory in the share or parent directory.

New

Get Directory Properties

Directory

GET HEAD

Returns system defined properties of a directory. This allows users to check for directory existence. Only LMT i.e. created date will be returned.

New

Eliminar directorio

Directory

DELETE

Deletes the directory. Only supported for empty directories.

New

Create File

File

PUT

Creates a new file or replaces an existing file within a directory or share.

Name

Request Headers

Get File

File

GET

Reads or downloads a file from the File service, including its user-defined metadata and system properties.

Name, Response Headers

Set File Properties

File

PUT

Sets system properties defined for an existing file.

Name,

Request & Response Headers

Get Container Properties

File

HEAD

Returns all system properties and user-defined metadata on the file.

Name, Response Headers

Get File Metadata

File

GET

HEAD

Retrieves all user-defined metadata on the file.

Name only

Set File Metadata

File

PUT

Sets user-defined metadata of an existing file.

Name only

Delete File

File

DELETE

Deletes the file permanently.

Name only

Put Range

File

PUT

Puts a range of data into a file, or clears a range in the file.

Name,

Query String Param, Response Header & Body

List Ranges

File

GET

Returns a list of active ranges for the file. Active ranges are those that have been populated with data using Put Range API.

Name,

Query String Param, Response Body

Vea también

¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios
Mostrar:
© 2014 Microsoft