Skip to content

Commit 712d66a

Browse files
authored
Merge pull request #53747 from JeffKoMS/patch-160708
Fix for SE Bug 160708 - URI syntax update
2 parents 514b3bf + 4c320f7 commit 712d66a

1 file changed

Lines changed: 22 additions & 22 deletions

File tree

learn-pr/wwl-azure/work-azure-blob-storage/includes/6-set-retrieve-properties-metadata-rest.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,60 +1,60 @@
1-
Containers and blobs support custom metadata, represented as HTTP headers. Metadata headers can be set on a request that creates a new container or blob resource, or on a request that explicitly creates a property on an existing resource.
1+
Containers and blobs support custom metadata, represented as HTTP headers. Metadata headers can be set on a request that creates a new container or blob resource, or on a request that explicitly creates a property on an existing resource.
22

33
## Metadata header format
44

5-
Metadata headers are name/value pairs. The format for the header is:
6-
5+
Metadata headers are name/value pairs. The format for the header is:
6+
7+
```
8+
x-ms-meta-name:string-value
79
```
8-
x-ms-meta-name:string-value
9-
```
1010

11-
Beginning with version 2009-09-19, metadata names must adhere to the naming rules for C# identifiers.
11+
Beginning with version 2009-09-19, metadata names must adhere to the naming rules for C# identifiers.
1212

13-
Names are case-insensitive. Metadata names preserve the case with which they were created, but are case-insensitive when set or read. If two or more metadata headers with the same name are submitted for a resource, the Blob service returns status code `400 (Bad Request)`.
13+
Names are case-insensitive. Metadata names preserve the case with which they were created, but are case-insensitive when set or read. If two or more metadata headers with the same name are submitted for a resource, the Blob service returns status code `400 (Bad Request)`.
1414

15-
The metadata consists of name/value pairs. The total size of all metadata pairs can be up to 8 KB in size.
15+
The metadata consists of name/value pairs. The total size of all metadata pairs can be up to 8 KB in size.
1616

17-
Metadata name/value pairs are valid HTTP headers, and so they adhere to all restrictions governing HTTP headers.
17+
Metadata name/value pairs are valid HTTP headers, and so they adhere to all restrictions governing HTTP headers.
1818

1919
## Operations on metadata
2020

21-
Metadata on a blob or container resource can be retrieved or set directly, without returning or altering the content of the resource.
21+
Metadata on a blob or container resource can be retrieved or set directly, without returning or altering the content of the resource.
2222

23-
Metadata values can only be read or written in full; partial updates aren't supported. Setting metadata on a resource overwrites any existing metadata values for that resource.
23+
Metadata values can only be read or written in full; partial updates aren't supported. Setting metadata on a resource overwrites any existing metadata values for that resource.
2424

2525
### Retrieving properties and metadata
2626

27-
The GET/HEAD operation retrieves metadata headers for the specified container or blob. These operations return headers only; they don't return a response body. The URI syntax for retrieving metadata headers on a container is as follows:
28-
27+
The GET/HEAD operation retrieves metadata headers for the specified container or blob. These operations return headers only; they don't return a response body. The URI syntax for retrieving metadata headers on a container is as follows:
28+
2929
```
30-
GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=metadata
30+
GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=metadata
3131
```
3232

33-
The URI syntax for retrieving metadata headers on a blob is as follows:
34-
33+
The URI syntax for retrieving metadata headers on a blob is as follows:
34+
3535
```
3636
GET/HEAD https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata
3737
```
3838

3939
### Setting Metadata Headers
4040

41-
The PUT operation sets metadata headers on the specified container or blob, overwriting any existing metadata on the resource. Calling PUT without any headers on the request clears all existing metadata on the resource.
41+
The PUT operation sets metadata headers on the specified container or blob, overwriting any existing metadata on the resource. Calling PUT without any headers on the request clears all existing metadata on the resource.
42+
43+
The URI syntax for setting metadata headers on a container is as follows:
4244

43-
The URI syntax for setting metadata headers on a container is as follows:
44-
4545
```
4646
PUT https://myaccount.blob.core.windows.net/mycontainer?comp=metadata&restype=container
4747
```
4848

49-
The URI syntax for setting metadata headers on a blob is as follows:
50-
49+
The URI syntax for setting metadata headers on a blob is as follows:
50+
5151
```
5252
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata
5353
```
5454

5555
## Standard HTTP properties for containers and blobs
5656

57-
Containers and blobs also support certain standard HTTP properties. Properties and metadata are both represented as standard HTTP headers; the difference between them is in the naming of the headers. Metadata headers are named with the header prefix `x-ms-meta-` and a custom name. Property headers use standard HTTP header names, as specified in the Header Field Definitions section 14 of the HTTP/1.1 protocol specification.
57+
Containers and blobs also support certain standard HTTP properties. Properties and metadata are both represented as standard HTTP headers; the difference between them is in the naming of the headers. Metadata headers are named with the header prefix `x-ms-meta-` and a custom name. Property headers use standard HTTP header names, as specified in the Header Field Definitions section 14 of the HTTP/1.1 protocol specification.
5858

5959
The standard HTTP headers supported on containers include:
6060

0 commit comments

Comments
 (0)