내보내기(0) 인쇄
모두 확장

루트 컨테이너 작업(REST API)

업데이트 날짜: 2014년 12월

루트 컨테이너는 저장소 계정에 대한 기본 컨테이너 역할을 합니다. 저장소 계정당 하나의 루트 컨테이너를 보유할 수 있습니다. 루트 컨테이너는 명시적으로 생성되어야 하며 이름을 $root로 지정해야 합니다.

루트 컨테이너에 저장된 Blob는 루트 컨테이너 이름을 참조하지 않고 주소를 지정할 수 있으므로 저장소 계정 계층의 최상위 수준에서 Blob 주소를 정할 수 있습니다. 이제 루트 컨테이너에 있는 Blob를 다음과 같은 방식으로 참조할 수 있습니다.

shttps://myaccount.blob.core.windows.net/mywebpage.html

저장소 계정에서 루트 컨테이너를 사용하려면 $root라는 이름의 새 컨테이너를 만듭니다. 다음 요청 예제에서 루트 컨테이너를 만드는 방법을 보여 줍니다.

Request Syntax:
PUT https://myaccount.blob.core.windows.net/$root?restype=container HTTP/1.1

Request Headers:
x-ms-version: 2011-08-18
x-ms-date: Sun, 25 Sep 2011 22:50:32 GMT
x-ms-meta-Name: StorageSample
x-ms-blob-public-access: container
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

또한 더 이상 필요하지 않은 루트 컨테이너는 삭제할 수 있습니다.

다른 컨테이너와 같이 루트 컨테이너에 익명 공용 액세스를 제공할 수 있습니다. 컨테이너를 만들 때 x-ms-blob-public-access 헤더를 설정하거나 컨테이너가 이미 있으면 컨테이너 ACL 설정(REST API)을 호출하여 컨테이너를 공용으로 설정할 수 있습니다. 자세한 내용은 컨테이너 및 Blob에 대한 액세스 제한을 참조하십시오.

루트 컨테이너가 있으면 저장소 계정에 대해 컨테이너 나열(REST API) 작업을 수행할 때 표시됩니다.

루트 컨테이너에 대해 Blob 나열(REST API) 작업을 수행하면 반환된 blob의 리소스 URL에 루트 컨테이너가 표시되지 않습니다. 다음 요청 구문에서는 루트 컨테이너에 대해 List Blobs를 호출하는 방법을 보여줍니다.

GET https://myaccount.blob.core.windows.net/$root?restype=container&comp=list HTTP/1.1
Important중요
루트 컨테이너의 blob는 이름에 슬래시(/)를 포함할 수 없습니다.

다음 예에서는 루트 컨테이너를 포함하여 컨테이너 및 blob 리소스의 사용 방법을 보여줍니다.

저장소 계정에 컨테이너를 나열하려면:

GET https://myaccount.blob.core.windows.net/?comp=list

컨테이너의 속성을 가져오려면:

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=container

mycontainer라는 컨테이너에 있는 blob를 나열하려면:

GET https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list

루트 컨테이너에 있는 blob를 나열하려면:

GET https://myaccount.blob.core.windows.net/$root?restype=container&comp=list

myfile라는 컨테이너에서 mycontainer이라는 blob를 읽으려면:

GET https://myaccount.blob.core.windows.net/mycontainer/myfile

루트 컨테이너에서 myphoto라는 blob를 읽으려면:

GET https://myaccount.blob.core.windows.net/myphoto

다음과 같이 명시적으로 루트 컨테이너를 참조할 수도 있습니다.

GET https://myaccount.blob.core.windows.net/$root/myphoto

루트 컨테이너에 있는 blob에서 blob 메타데이터를 읽으려면:

GET https://myaccount.blob.core.windows.net/myphoto?comp=metadata

다음과 같이 명시적으로 루트 컨테이너를 참조할 수도 있습니다.

GET https://myaccount.blob.core.windows.net/$root/myphoto?comp=metadata
note참고
루트 컨테이너에서 blob를 참조할 때 마지막 슬래시(/)를 포함하지 않도록 주의하십시오. 예를 들어 다음과 같은 URL을 사용하면 상태 코드 400(잘못된 요청)이 나타납니다.

https://myaccount.blob.core.windows.net/myblob/

위 예에서 Blob 서비스는 컨테이너 이름을 myblob라고 인식하고 마지막 슬래시 다음에 blob 이름이 있을 것으로 예상합니다. 이 요청은 Blob 이름이 누락된 잘못된 형식을 사용합니다.

다음 URL은 루트 컨테이너에 있는 blob에서 수행하는 작업에 대해 유효합니다.

https://myaccount.blob.core.windows.net/myblob

mycontainer라는 컨테이너를 만들려면:


PUT https://myaccount.blob.core.windows.net/mycontainer?restype=container

루트 컨테이너에서 myblob라는 blob를 만들려면:


PUT https://myaccount.blob.core.windows.net/myblob

다음과 같이 명시적으로 루트 컨테이너를 지정할 수도 있습니다.


PUT https://myaccount.blob.core.windows.net/$root/myblob

myblob 컨테이너에서 mycontainer라는 blob를 만들려면:

PUT https://myaccount.blob.core.windows.net/mycontainer/myblob

photos/myphoto 컨테이너에서 mycontainer라는 blob를 만들려면:

PUT https://myaccount.blob.core.windows.net/mycontainer/photos/myphoto

루트 컨테이너에서 myblob라는 blob에 메타데이터를 설정하려면:


PUT https://myaccount.blob.core.windows.net/myblob?comp=metadata

mycontainer라는 컨테이너를 삭제하려면:


DELETE https://myaccount.blob.core.windows.net/mycontainer?restype=container

루트 컨테이너를 삭제하려면:


DELETE https://myaccount.blob.core.windows.net/$root?restype=container

루트 컨테이너에서 myblob라는 blob를 삭제하려면:


DELETE https://myaccount.blob.core.windows.net/myblob

다음과 같이 명시적으로 루트 컨테이너를 지정할 수도 있습니다.


DELETE https://myaccount.blob.core.windows.net/$root/myblob

참고 항목

Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2015 Microsoft