공유 키 권한 부여를 사용하여 REST API 작업 호출

이 문서에서는 C#을 사용하여 권한 있는 REST 요청을 만들어 Azure Storage REST API 작업을 호출하는 방법을 보여 줍니다. Blob Storage에 대한 REST API 작업을 호출하는 방법을 알아보면 다른 Azure Storage REST 작업에 유사한 단계를 사용할 수 있습니다.

필수 조건

샘플 애플리케이션은 스토리지 계정에 대한 Blob 컨테이너를 나열합니다. 이 문서의 코드를 사용해 보려면 다음 항목이 필요합니다.

Visual Studio를 설치하고 Azure 개발 워크로드를 포함합니다. 이 예제는 Visual Studio 2019를 사용하여 빌드되었습니다. 다른 버전을 사용하는 경우 지침이 약간 다를 수 있습니다.
Azure 구독. Azure 구독이 없는 경우, 시작하기 전에 무료 계정을 만드십시오.
범용 스토리지 계정입니다. 스토리지 계정이 아직 없는 경우 스토리지 계정 만들기를 참조하세요.
이 문서의 예제에서는 스토리지 계정의 컨테이너를 나열하는 방법을 보여 줍니다. 출력을 보려면 시작하기 전에 스토리지 계정에 일부 Blob 컨테이너를 추가합니다.

샘플 애플리케이션 다운로드

샘플 애플리케이션은 C#으로 작성된 콘솔 애플리케이션입니다.

git을 사용하여 개발 환경에 애플리케이션의 복사본을 다운로드합니다.

git clone https://github.com/Azure-Samples/storage-dotnet-rest-api-with-auth.git

이 명령은 리포지토리를 로컬 git 폴더에 복제합니다. Visual Studio 솔루션을 열려면 storage-dotnet-rest-api-with-auth 폴더로 이동하여 StorageRestApiAuth.sln 엽니다.

REST에 대한 정보

REST(표현 상태 전송)는 HTTP/HTTPS와 같은 인터넷 프로토콜을 통해 서비스와 상호 작용할 수 있는 아키텍처입니다. REST는 서버 또는 클라이언트에서 실행되는 소프트웨어와 독립적입니다. REST API는 HTTP/HTTPS를 지원하는 모든 플랫폼에서 호출할 수 있습니다. Mac, Windows, Linux, Android 휴대폰 또는 태블릿, iPhone, iPod 또는 웹 사이트에서 실행되는 애플리케이션을 작성하고 모든 플랫폼에 대해 동일한 REST API를 사용할 수 있습니다.

REST API에 대한 호출은 클라이언트의 요청과 서비스에서 반환된 응답으로 구성됩니다. 요청에서 호출할 작업, 수행할 리소스, 쿼리 매개 변수 및 헤더 및 호출된 작업에 따라 데이터 페이로드에 대한 정보가 포함된 URL을 보냅니다. 서비스의 응답에는 상태 코드, 응답 헤더 집합 및 호출된 작업에 따라 데이터 페이로드가 포함됩니다.

샘플 애플리케이션 정보

샘플 애플리케이션은 스토리지 계정의 컨테이너를 나열합니다. REST API 설명서의 정보가 실제 코드와 어떻게 연관되는지 이해하면 다른 REST 호출을 더 쉽게 파악할 수 있습니다.

Blob Service REST API를 살펴보면 Blob Storage에서 수행할 수 있는 모든 작업이 표시됩니다. 스토리지 클라이언트 라이브러리는 REST API를 중심으로 하는 래퍼이므로 REST API를 직접 사용하지 않고도 스토리지 리소스에 쉽게 액세스할 수 있습니다. 그러나 스토리지 클라이언트 라이브러리 대신 REST API를 사용하는 것이 좋습니다.

컨테이너 목록화 작업

이 문서에서는 컨테이너 나열 작업에 중점을 둡니다 . 다음 정보는 요청 및 응답의 일부 필드를 이해하는 데 도움이 됩니다.

요청 메서드: GET. 이 동사는 요청 개체의 속성으로 지정하는 HTTP 메서드입니다. 이 동사의 다른 값에는 호출하는 API에 따라 HEAD, PUT 및 DELETE가 포함됩니다.

요청 URI: https://myaccount.blob.core.windows.net/?comp=list. 요청 URI는 Blob Storage 계정 엔드포인트 https://myaccount.blob.core.windows.net 및 리소스 문자열 /?comp=list에서 만들어집니다.

URI 매개 변수: ListContainers를 호출할 때 사용할 수 있는 추가 쿼리 매개 변수가 있습니다. 이러한 매개 변수 중 몇 가지는 호출에 대한 시간 제한(초 단위) 및 필터링에 사용되는 접두사입니다.

또 다른 유용한 매개 변수는 maxresults입니다. 이 값보다 더 많은 컨테이너를 사용할 수 있는 경우 응답 본문에는 다음 요청에 반환할 다음 컨테이너를 나타내는 NextMarker 요소가 포함됩니다. 이 기능을 사용하려면 다음 요청을 수행할 때 NextMarker 값을 URI의 표식 매개 변수로 제공합니다. 이 기능을 사용하는 경우 결과를 페이징하는 것과 유사합니다.

추가 매개 변수를 사용하려면 다음 예제와 같이 값을 사용하여 리소스 문자열에 추가합니다.

/?comp=list&timeout=60&maxresults=100

요청 헤더: 이 섹션에는 필수 및 선택적 요청 헤더가 나열되어 있습니다. 세 가지 헤더가 필요합니다. 권한 부여 헤더, x-ms-date (요청에 대한 UTC 시간 포함) 및 x-ms-version (사용할 REST API의 버전을 지정함). 헤더에 x-ms-client-request-id 를 포함하는 것은 선택 사항입니다. 이 필드의 값을 모든 값으로 설정할 수 있으며 로깅을 사용하도록 설정할 때 스토리지 분석 로그에 기록됩니다.

요청 본문: ListContainers에 대한 요청 본문이 없습니다. 요청 본문은 SetContainerAccessPolicy를 포함하여 Blob을 업로드할 때 모든 PUT 작업에 사용됩니다. 요청 본문을 사용하면 적용할 저장된 액세스 정책의 XML 목록을 보낼 수 있습니다. 저장된 액세스 정책은 SAS(공유 액세스 서명) 사용 문서에서 설명합니다.

응답 상태 코드: 알아야 할 상태 코드를 알려줍니다. 이 예제에서는 HTTP 상태 코드 200이 정상입니다. HTTP 상태 코드의 전체 목록은 상태 코드 정의를 확인하세요. Storage REST API와 관련된 오류 코드를 보려면 일반 REST API 오류 코드를 참조하세요.

응답 헤더: 여기에는 콘텐츠 형식이 포함됩니다. 전달한 요청 ID인 x-ms-request-id입니다. 사용된 Blob 서비스의 버전을 나타내는 x-ms-version 및 날짜는 UTC로, 요청이 이루어진 시간을 알려줍니다.

응답 본문: 이 필드는 요청된 데이터를 제공하는 XML 구조입니다. 이 예제에서 응답은 컨테이너 및 해당 속성의 목록입니다.

REST 요청 만들기

프로덕션 환경에서 실행할 때 보안을 위해 항상 HTTP 대신 HTTPS를 사용합니다. 이 연습에서는 요청 및 응답 데이터를 볼 수 있도록 HTTP를 사용합니다. 실제 REST 호출에서 요청 및 응답 정보를 보려면 Fiddler 또는 유사한 애플리케이션을 다운로드할 수 있습니다. Visual Studio 솔루션에서 스토리지 계정 이름 및 키는 클래스에서 하드 코딩됩니다. ListContainersAsyncREST 메서드는 스토리지 계정 이름 및 스토리지 계정 키를 REST 요청의 다양한 구성 요소를 만드는 데 사용되는 메서드에 전달합니다. 실제 애플리케이션에서 스토리지 계정 이름 및 키는 구성 파일, 환경 변수에 상주하거나 Azure Key Vault에서 검색됩니다.

샘플 프로젝트에서 권한 부여 헤더를 만드는 코드는 별도의 클래스에 있습니다. 아이디어는 전체 클래스를 가져와서 자신의 솔루션에 추가하고 "있는 그대로"사용할 수 있다는 것입니다. 권한 부여 헤더 코드는 Azure Storage에 대한 대부분의 REST API 호출에서 작동합니다.

HttpRequestMessage 개체인 요청을 빌드하려면 Program.cs ListContainersAsyncREST로 이동합니다. 요청을 빌드하는 단계는 다음과 같습니다.

서비스를 호출하는 데 사용할 URI를 만듭니다.
HttpRequestMessage 개체를 만들고 페이로드를 설정합니다. 아무것도 전달하지 않으므로 ListContainersAsyncREST의 페이로드는 null입니다.
x-ms-date 및 x-ms-version에 대한 요청 헤더를 추가합니다.
권한 부여 헤더를 가져와서 추가합니다.

필요한 몇 가지 기본 정보는 다음과 같습니다.

ListContainers의 경우 메서드는 GET입니다. 이 값은 요청을 인스턴스화할 때 설정됩니다.
리소스는 호출되는 API를 나타내는 URI의 쿼리 부분이므로 값은 다음과 입니다/?comp=list. 앞에서 설명한 것처럼 리소스는 ListContainers API에 대한 정보를 보여 주는 참조 설명서 페이지에 있습니다.
URI는 해당 스토리지 계정에 대한 Blob 서비스 엔드포인트를 만들고 리소스를 연결하여 생성됩니다. 요청 URI의 값은 http://contosorest.blob.core.windows.net/?comp=list로 결정됩니다.
ListContainers의 경우 requestBody 가 null이고 추가 헤더가 없습니다.

다른 API에는 ifMatch와 같이 전달할 다른 매개 변수가 있을 수 있습니다. ifMatch를 사용할 수 있는 위치의 예는 PutBlob을 호출하는 경우입니다. 이 경우 ifMatch를 eTag로 설정하고 제공하는 eTag가 Blob의 현재 eTag와 일치하는 경우에만 Blob을 업데이트합니다. eTag를 검색한 후 다른 사람이 Blob을 업데이트한 경우 해당 변경 내용은 재정의되지 않습니다.

먼저 uri와 requestPayload을 설정합니다.

// Construct the URI. It will look like this:
//   https://myaccount.blob.core.windows.net/resource
String uri = string.Format("http://{0}.blob.core.windows.net?comp=list", storageAccountName);

// Provide the appropriate payload, in this case null.
//   we're not passing anything in.
Byte[] requestPayload = null;

다음으로, 요청을 인스턴스화하고 메서드 GET 를 설정하고 URI를 제공합니다.

// Instantiate the request message with a null payload.
using (var httpRequestMessage = new HttpRequestMessage(HttpMethod.Get, uri)
{ Content = (requestPayload == null) ? null : new ByteArrayContent(requestPayload) })
{

x-ms-date 및 x-ms-version에 대한 요청 헤더를 추가합니다. 코드의 이 위치는 호출에 필요한 추가 요청 헤더를 추가하는 위치이기도 합니다. 이 예제에서는 추가 헤더가 없습니다. 추가 헤더를 전달하는 API의 예는 컨테이너 ACL 설정 작업입니다. 이 API 호출은 "x-ms-blob-public-access"라는 헤더와 액세스 수준에 대한 값을 추가합니다.

// Add the request headers for x-ms-date and x-ms-version.
DateTime now = DateTime.UtcNow;
httpRequestMessage.Headers.Add("x-ms-date", now.ToString("R", CultureInfo.InvariantCulture));
httpRequestMessage.Headers.Add("x-ms-version", "2017-07-29");
// If you need any additional headers, add them here before creating
//   the authorization header.

권한 부여 헤더를 만드는 메서드를 호출하고 요청 헤더에 추가합니다. 권한 부여 헤더는 문서의 뒷부분에서 만들어집니다. 메서드 이름은 이 코드 조각에서 볼 수 있는 GetAuthorizationHeader입니다.

// Get the authorization header and add it.
httpRequestMessage.Headers.Authorization = AzureStorageAuthenticationHelper.GetAuthorizationHeader(
    storageAccountName, storageAccountKey, now, httpRequestMessage);

이 시점에서 httpRequestMessage 권한 부여 헤더가 포함된 REST 요청을 포함합니다.

요청 보내기

이제 요청을 생성했으므로 SendAsync 메서드를 호출하여 Azure Storage로 보낼 수 있습니다. 응답 상태 코드의 값이 200인지 확인합니다. 즉, 작업이 성공했음을 의미합니다. 다음으로, 응답을 구문 분석합니다. 이 경우 컨테이너의 XML 목록을 가져옵니다. GetRESTRequest 메서드를 호출하여 요청을 만들고, 요청을 실행한 다음, 컨테이너 목록에 대한 응답을 검사하는 코드를 살펴보겠습니다.

    // Send the request.
    using (HttpResponseMessage httpResponseMessage =
      await new HttpClient().SendAsync(httpRequestMessage, cancellationToken))
    {
        // If successful (status code = 200),
        //   parse the XML response for the container names.
        if (httpResponseMessage.StatusCode == HttpStatusCode.OK)
        {
            String xmlString = await httpResponseMessage.Content.ReadAsStringAsync();
            XElement x = XElement.Parse(xmlString);
            foreach (XElement container in x.Element("Containers").Elements("Container"))
            {
                Console.WriteLine("Container name = {0}", container.Element("Name").Value);
            }
        }
    }
}

SendAsync를 호출할 때 Fiddler 와 같은 네트워크 스니퍼를 실행하는 경우 요청 및 응답 정보를 볼 수 있습니다. 살펴보겠습니다. 스토리지 계정의 이름은 contosorest입니다.

요청:

GET /?comp=list HTTP/1.1

요청 헤더:

x-ms-date: Thu, 16 Nov 2017 23:34:04 GMT
x-ms-version: 2014-02-14
Authorization: SharedKey contosorest:1dVlYJWWJAOSHTCPGiwdX1rOS8B4fenYP/VrU0LfzQk=
Host: contosorest.blob.core.windows.net
Connection: Keep-Alive

실행 후 반환된 상태 코드 및 응답 헤더:

HTTP/1.1 200 OK
Content-Type: application/xml
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: 3e889876-001e-0039-6a3a-5f4396000000
x-ms-version: 2017-07-29
Date: Fri, 17 Nov 2017 00:23:42 GMT
Content-Length: 1511

응답 본문(XML): 컨테이너 목록 작업의 경우 컨테이너 목록과 해당 속성이 표시됩니다.

<?xml version="1.0" encoding="utf-8"?>
<EnumerationResults
  ServiceEndpoint="http://contosorest.blob.core.windows.net/">
  <Containers>
    <Container>
      <Name>container-1</Name>
      <Properties>
        <Last-Modified>Thu, 16 Mar 2017 22:39:48 GMT</Last-Modified>
        <Etag>"0x8D46CBD5A7C301D"</Etag>
        <LeaseStatus>unlocked</LeaseStatus>
        <LeaseState>available</LeaseState>
      </Properties>
    </Container>
    <Container>
      <Name>container-2</Name>
      <Properties>
        <Last-Modified>Thu, 16 Mar 2017 22:40:50 GMT</Last-Modified>
        <Etag>"0x8D46CBD7F49E9BD"</Etag>
        <LeaseStatus>unlocked</LeaseStatus>
        <LeaseState>available</LeaseState>
      </Properties>
    </Container>
    <Container>
      <Name>container-3</Name>
      <Properties>
        <Last-Modified>Thu, 16 Mar 2017 22:41:10 GMT</Last-Modified>
        <Etag>"0x8D46CBD8B243D68"</Etag>
        <LeaseStatus>unlocked</LeaseStatus>
        <LeaseState>available</LeaseState>
      </Properties>
    </Container>
    <Container>
      <Name>container-4</Name>
      <Properties>
        <Last-Modified>Thu, 16 Mar 2017 22:41:25 GMT</Last-Modified>
        <Etag>"0x8D46CBD93FED46F"</Etag>
        <LeaseStatus>unlocked</LeaseStatus>
        <LeaseState>available</LeaseState>
        </Properties>
      </Container>
      <Container>
        <Name>container-5</Name>
        <Properties>
          <Last-Modified>Thu, 16 Mar 2017 22:41:39 GMT</Last-Modified>
          <Etag>"0x8D46CBD9C762815"</Etag>
          <LeaseStatus>unlocked</LeaseStatus>
          <LeaseState>available</LeaseState>
        </Properties>
      </Container>
  </Containers>
  <NextMarker />
</EnumerationResults>

이제 요청을 만들고, 서비스를 호출하고, 결과를 구문 분석하는 방법을 이해했으므로 권한 부여 헤더를 만드는 방법을 살펴보겠습니다.

권한 부여 헤더 만들기

팁 (조언)

Azure Storage는 Blob 및 큐에 대한 Microsoft Entra 통합을 지원합니다. Microsoft Entra ID는 Azure Storage에 대한 요청 권한을 부여하기 위한 훨씬 간단한 환경을 제공합니다. Microsoft Entra ID를 사용하여 REST 작업에 권한을 부여하는 방법에 대한 자세한 내용은 Microsoft Entra ID로 권한 부여를 참조하세요. Azure Storage와 Microsoft Entra 통합에 대한 개요는 Microsoft Entra ID를 사용하여 Azure Storage에 대한 액세스 인증을 참조하세요.

권한 부여 개념에 대한 자세한 내용은 Azure Storage에 대한 요청 권한 부여를 참조하세요.

해당 문서를 정확히 필요한 것으로 증류하고 코드를 보여 봅시다.

먼저 공유 키 권한 부여를 사용합니다. 권한 부여 헤더 형식은 다음과 같습니다.

Authorization="SharedKey <storage account name>:<signature>"

서명 필드는 요청에서 만들어지고 SHA256 알고리즘을 사용하여 계산된 다음 Base64 인코딩을 사용하여 인코딩된 해시 기반 HMAC(메시지 인증 코드)입니다.

이 코드 조각은 공유 키 서명 문자열의 형식을 보여줍니다.

StringToSign = VERB + "\n" +  
               Content-Encoding + "\n" +  
               Content-Language + "\n" +  
               Content-Length + "\n" +  
               Content-MD5 + "\n" +  
               Content-Type + "\n" +  
               Date + "\n" +  
               If-Modified-Since + "\n" +  
               If-Match + "\n" +  
               If-None-Match + "\n" +  
               If-Unmodified-Since + "\n" +  
               Range + "\n" +  
               CanonicalizedHeaders +  
               CanonicalizedResource;

Blob Storage의 경우 VERB, md5, 콘텐츠 길이, 정식화된 헤더 및 정식화된 리소스를 지정합니다. 이 예제에서는 다른 항목을 비워 둘 수 있지만 \n 비워 두도록 지정합니다.

정식화는 둘 이상의 가능한 표현이 있는 데이터를 표준화하는 프로세스입니다. 이 경우 헤더와 리소스를 표준화합니다. 정식화된 헤더는 "x-ms-"로 시작하는 헤더입니다. 정식화된 리소스는 스토리지 계정 이름 및 모든 쿼리 매개 변수(예: ?comp=list)를 포함하여 리소스의 URI입니다. 정식화된 리소스에는 추가한 추가 쿼리 매개 변수도 포함됩니다(예: 예: timeout=60).

인증 헤더를 만들어야 하기 때문에 정식화된 두 필드로 시작해 보겠습니다.

정식화된 헤더

이 값을 만들려면 "x-ms-"로 시작하는 헤더를 검색하고 정렬한 다음, 하나의 문자열로 연결된 인스턴스 문자열 [key:value\n] 로 서식을 지정합니다. 이 예제의 경우 정식화된 헤더는 다음과 같습니다.

x-ms-date:Fri, 17 Nov 2017 00:44:48 GMT\nx-ms-version:2017-07-29\n

해당 출력을 만드는 데 사용되는 코드는 다음과 같습니다.

private static string GetCanonicalizedHeaders(HttpRequestMessage httpRequestMessage)
{
    var headers = from kvp in httpRequestMessage.Headers
        where kvp.Key.StartsWith("x-ms-", StringComparison.OrdinalIgnoreCase)
        orderby kvp.Key
        select new { Key = kvp.Key.ToLowerInvariant(), kvp.Value };

    StringBuilder headersBuilder = new StringBuilder();

    foreach (var kvp in headers)
    {
        headersBuilder.Append(kvp.Key);
        char separator = ':';

        // Get the value for each header, strip out \r\n if found, then append it with the key.
        foreach (string headerValue in kvp.Value)
        {
            string trimmedValue = headerValue.TrimStart().Replace("\r\n", string.Empty);
            headersBuilder.Append(separator).Append(trimmedValue);

            // Set this to a comma; this will only be used
            // if there are multiple values for one of the headers.
            separator = ',';
        }

        headersBuilder.Append("\n");
    }

    return headersBuilder.ToString();
}

정식화된 리소스

서명 문자열의 이 부분은 요청이 대상으로 하는 스토리지 계정을 나타냅니다. 요청 URI는 http://contosorest.blob.core.windows.net/?comp=list이며, 실제 계정 이름은 이 경우 contosorest입니다. 이 예제에서는 다음이 반환됩니다.

/contosorest/\ncomp:list

쿼리 매개 변수가 있는 경우 이 예제에도 이러한 매개 변수가 포함됩니다. 다음은 여러 값을 가진 추가 쿼리 매개 변수 및 쿼리 매개 변수를 처리하는 코드입니다. 모든 REST API에 대해 작동하도록 이 코드를 빌드하고 있습니다. ListContainers 메서드에 모든 가능성이 필요하지 않더라도 모든 가능성을 포함하려고 합니다.

private static string GetCanonicalizedResource(Uri address, string storageAccountName)
{
    // The absolute path will be "/" because for we're getting a list of containers.
    StringBuilder sb = new StringBuilder("/").Append(storageAccountName).Append(address.AbsolutePath);

    // Address.Query is the resource, such as "?comp=list".
    // This ends up with a NameValueCollection with 1 entry having key=comp, value=list.
    // It will have more entries if you have more query parameters.
    NameValueCollection values = HttpUtility.ParseQueryString(address.Query);

    foreach (var item in values.AllKeys.OrderBy(k => k))
    {
        sb.Append('\n').Append(item.ToLower()).Append(':').Append(values[item]);
    }

    return sb.ToString();
}

정식화된 문자열이 설정되었으므로 권한 부여 헤더 자체를 만드는 방법을 살펴보겠습니다. 먼저 이 문서에 이전에 표시된 StringToSign 형식의 메시지 서명 문자열을 만듭니다. 이 개념은 코드에서 주석을 사용하여 설명하는 것이 더 쉽습니다. 따라서 권한 부여 헤더를 반환하는 최종 메서드는 다음과 같습니다.

internal static AuthenticationHeaderValue GetAuthorizationHeader(
    string storageAccountName, string storageAccountKey, DateTime now,
    HttpRequestMessage httpRequestMessage, string ifMatch = "", string md5 = "")
{
    // This is the raw representation of the message signature.
    HttpMethod method = httpRequestMessage.Method;
    String MessageSignature = String.Format("{0}\n\n\n{1}\n{5}\n\n\n\n{2}\n\n\n\n{3}{4}",
                method.ToString(),
                (method == HttpMethod.Get || method == HttpMethod.Head) ? String.Empty
                  : httpRequestMessage.Content.Headers.ContentLength.ToString(),
                ifMatch,
                GetCanonicalizedHeaders(httpRequestMessage),
                GetCanonicalizedResource(httpRequestMessage.RequestUri, storageAccountName),
                md5);

    // Now turn it into a byte array.
    byte[] SignatureBytes = Encoding.UTF8.GetBytes(MessageSignature);

    // Create the HMACSHA256 version of the storage key.
    HMACSHA256 SHA256 = new HMACSHA256(Convert.FromBase64String(storageAccountKey));

    // Compute the hash of the SignatureBytes and convert it to a base64 string.
    string signature = Convert.ToBase64String(SHA256.ComputeHash(SignatureBytes));

    // This is the actual header that will be added to the list of request headers.
    AuthenticationHeaderValue authHV = new AuthenticationHeaderValue("SharedKey",
        storageAccountName + ":" + signature);
    return authHV;
}

이 코드를 실행하면 결과 MessageSignature는 다음 예제와 같습니다.

GET\n\n\n\n\n\n\n\n\n\n\n\nx-ms-date:Fri, 17 Nov 2017 01:07:37 GMT\nx-ms-version:2017-07-29\n/contosorest/\ncomp:list

AuthorizationHeader의 최종 값은 다음과 같습니다.

SharedKey contosorest:Ms5sfwkA8nqTRw7Uury4MPHqM6Rj2nfgbYNvUKOa67w=

AuthorizationHeader는 응답을 게시하기 전에 요청 헤더에 배치된 마지막 헤더입니다.

스토리지 서비스 REST API를 호출하는 요청을 만들 수 있는 클래스를 함께 배치하기 위해 알아야 할 모든 사항을 다룹니다.

예: BLOB 나열

컨테이너 컨테이너-1에 대한 Blob 나열 작업을 호출하도록 코드를 변경하는 방법을 살펴보겠습니다. 이 코드는 컨테이너를 나열하는 코드와 거의 동일하며, 유일한 차이점은 URI이고 응답을 구문 분석하는 방법입니다.

ListBlobs에 대한 참조 설명서를 보면 메서드가 GET이고 RequestURI는 다음과 같습니다.

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

ListContainersAsyncREST에서 URI를 ListBlobs의 API로 설정하는 코드를 변경합니다. 컨테이너 이름은 container-1입니다.

String uri =
    string.Format("http://{0}.blob.core.windows.net/container-1?restype=container&comp=list",
      storageAccountName);

그런 다음 응답을 처리하는 위치에서 컨테이너 대신 Blob을 찾으도록 코드를 변경합니다.

foreach (XElement container in x.Element("Blobs").Elements("Blob"))
{
    Console.WriteLine("Blob name = {0}", container.Element("Name").Value);
}

이 샘플을 실행하면 다음과 같은 결과가 표시됩니다.

정식화된 헤더:

x-ms-date:Fri, 17 Nov 2017 05:16:48 GMT\nx-ms-version:2017-07-29\n

정식화된 리소스:

/contosorest/container-1\ncomp:list\nrestype:container

메시지 서명:

GET\n\n\n\n\n\n\n\n\n\n\n\nx-ms-date:Fri, 17 Nov 2017 05:16:48 GMT
  \nx-ms-version:2017-07-29\n/contosorest/container-1\ncomp:list\nrestype:container

권한 부여 헤더:

SharedKey contosorest:uzvWZN1WUIv2LYC6e3En10/7EIQJ5X9KtFQqrZkxi6s=

다음 값은 Fiddler에서 가져옵니다.