Blob Service REST API
The Blob service stores text and binary data. The Blob service offers the following three resources: the storage account, containers, and blobs. Within your storage account, containers provide a way to organize sets of blobs.
You can store text and binary data in either of two types of blobs:
-
Block blobs, which are optimized for streaming.
-
Page blobs, which are optimized for random read/write operations and which provide the ability to write to a range of bytes in a blob.
For more information about block blobs and page blobs, see Understanding Block Blobs and Page Blobs.
The REST API for the Blob service provides a way to work with container and blob resources via HTTP operations. The API includes the operations listed in the following table.
| Operation | Resource Type | Description |
|---|---|---|
|
Account |
Lists all of the containers in a storage account. |
|
|
Account |
Sets the properties of the Blob service, including logging and metrics settings, and the default service version. |
|
|
Account |
Gets the properties of the Blob service, including logging and metrics settings, and the default service version. |
|
|
Container |
Creates a new container in a storage account. |
|
|
Container |
Returns all user-defined metadata and system properties of a container. |
|
|
Container |
Returns only user-defined metadata of a container. |
|
|
Container |
Sets user-defined metadata of a container. |
|
|
Container |
Gets the public access policy and any stored access policies for the container. |
|
|
Container |
Sets the public access policy and any stored access policies for the container. |
|
|
Container |
Establishes and manages a lock on a container for delete operations. |
|
|
Container |
Deletes the container and any blobs that it contains. |
|
|
Container |
Lists all of the blobs in a container. |
|
|
Block and page blobs |
Creates a new blob or replaces an existing blob within a container. |
|
|
Block and page blobs |
Reads or downloads a blob from the Blob service, including its user-defined metadata and system properties. |
|
|
Block and page blobs |
Returns all system properties and user-defined metadata on the blob. |
|
|
Block and page blobs |
Sets system properties defined for an existing blob. |
|
|
Block and page blobs |
Retrieves all user-defined metadata of an existing blob or snapshot. |
|
|
Block and page blobs |
Sets user-defined metadata of an existing blob. |
|
|
Block and page blobs |
Marks a blob for deletion. |
|
|
Block and page blobs |
Establishes and manages a lock on write and delete operations. To delete or write to a locked blob, a client must provide the lease ID. |
|
|
Block and page blobs |
Creates a read-only snapshot of a blob. |
|
|
Block and page blobs |
Copies a source blob to a destination blob in this storage account. |
|
|
Block and page blobs |
Aborts a pending Copy Blob operation, and leaves a destination blob with zero length and full metadata. |
|
|
Block blobs only |
Creates a new block to be committed as part of a block blob. |
|
|
Block blobs only |
Commits a blob by specifying the set of block IDs that comprise the block blob. |
|
|
Block blobs only |
Retrieves the list of blocks that have been uploaded as part of a block blob. |
|
|
Page blobs only |
Writes a range of pages into a page blob. |
|
|
Page blobs only |
Returns a list of valid page ranges for a page blob or a snapshot of a page blob. |
Note |
|---|
| You can also access the Blobs service using types in the Microsoft.WindowsAzure.StorageClient namespace in Windows Azure SDK for .NET. |
In This Section
See Also
Note