Skip to content

Commit a600eb5

Browse files
authored
Merge pull request #208454 from tamram/tamram22-0817a
clarify naming rules for containers & blobs
2 parents 218f99e + 4edc2ee commit a600eb5

File tree

1 file changed

+33
-3
lines changed

1 file changed

+33
-3
lines changed

articles/storage/blobs/storage-blobs-introduction.md

Lines changed: 33 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: tamram
77

88
ms.service: storage
99
ms.topic: overview
10-
ms.date: 03/15/2022
10+
ms.date: 08/18/2022
1111
ms.author: tamram
1212
ms.subservice: blobs
1313
---
@@ -54,8 +54,17 @@ To learn how to create a storage account, see [Create a storage account](../comm
5454

5555
A container organizes a set of blobs, similar to a directory in a file system. A storage account can include an unlimited number of containers, and a container can store an unlimited number of blobs.
5656

57-
> [!NOTE]
58-
> The container name must be lowercase. For more information about naming containers, see [Naming and Referencing Containers, Blobs, and Metadata](/rest/api/storageservices/Naming-and-Referencing-Containers--Blobs--and-Metadata).
57+
A container name must be a valid DNS name, as it forms part of the unique URI used to address the container or its blobs. Follow these rules when naming a container:
58+
59+
- Container names can be between 3 and 63 characters long.
60+
- Container names must start with a letter or number, and can contain only lowercase letters, numbers, and the dash (-) character.
61+
- Two or more consecutive dash characters aren't permitted in container names.
62+
63+
The URI for a container is similar to:
64+
65+
`https://myaccount.blob.core.windows.net/mycontainer`
66+
67+
For more information about naming containers, see [Naming and Referencing Containers, Blobs, and Metadata](/rest/api/storageservices/Naming-and-Referencing-Containers--Blobs--and-Metadata).
5968

6069
### Blobs
6170

@@ -67,6 +76,27 @@ Azure Storage supports three types of blobs:
6776

6877
For more information about the different types of blobs, see [Understanding Block Blobs, Append Blobs, and Page Blobs](/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs).
6978

79+
The URI for a blob is similar to:
80+
81+
`https://myaccount.blob.core.windows.net/mycontainer/myblob`
82+
83+
or
84+
85+
`https://myaccount.blob.core.windows.net/mycontainer/myvirtualdirectory/myblob`
86+
87+
Follow these rules when naming a blob:
88+
89+
- A blob name can contain any combination of characters.
90+
- A blob name must be at least one character long and cannot be more than 1,024 characters long, for blobs in Azure Storage.
91+
- Blob names are case-sensitive.
92+
- Reserved URL characters must be properly escaped.
93+
- The number of path segments comprising the blob name cannot exceed 254. A path segment is the string between consecutive delimiter characters (*e.g.*, the forward slash '/') that corresponds to the name of a virtual directory.
94+
95+
> [!NOTE]
96+
> Avoid blob names that end with a dot (.), a forward slash (/), or a sequence or combination of the two. No path segments should end with a dot (.).
97+
98+
For more information about naming blobs, see [Naming and Referencing Containers, Blobs, and Metadata](/rest/api/storageservices/Naming-and-Referencing-Containers--Blobs--and-Metadata).
99+
70100
## Move data to Blob storage
71101

72102
A number of solutions exist for migrating existing data to Blob storage:

0 commit comments

Comments
 (0)