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

웹 사이트 관리 REST API 참조

업데이트 날짜: 2014년 1월

이 문서에서는 Windows Azure 웹 사이트 관리 REST API를 사용하여 Windows Azure 웹 사이트에서 일반적인 작업을 수행하는 방법을 설명합니다.

note참고
REST API를 사용하여 기존 구독을 검색(HTTP GET)하려면 구독 가져오기를 참조하십시오.

  • 유효한 Azure 계정 및 활성 Azure 구독이 필요합니다. 이 설명서에서는 활성 구독과 관련 구독 ID를 이미 가지고 있다고 가정합니다.

  • Azure 구독의 관리 인증서입니다. 관리 인증서는 구독에서 리소스에 대한 클라이언트 액세스를 인증하는 데 필요합니다. 공개 키를 포함하고 파일 이름 확장명이 .cer인 X-509 v3 인증서를 사용해야 합니다. 관리 인증서를 만드는 방법에 대한 자세한 내용은 Windows Azure용 관리 인증서 만들기를 참조하십시오. 관리 인증서는 로컬 컴퓨터의 기본 개인 인증서 저장소에 있어야 하며 Azure 계정에 업로드해야 합니다. 관리 인증서를 Azure에 업로드하려면 주 관리 포털의 왼쪽에 있는 창에서 설정 페이지를 선택합니다. 페이지 아래쪽의 관리 인증서에서 업로드를 선택하여 .cert 파일을 계정에 업로드합니다.

    note참고
    둘 이상의 관리 인증서를 Azure 구독에 업로드할 수 있습니다. 각 관리 인증서는 구독과 연결되고 클라우드 서비스 또는 배포와 독립적입니다. 간단하게 관리하려면 관리 인증서의 수를 제한하고 기존 관리 인증서를 다시 사용하는 것이 좋습니다.

Windows Azure 웹 사이트 관리 API에서는 Windows Azure 웹 사이트 서비스와 상호 작용하여 웹 사이트를 관리하는 RESTful 웹 서비스 집합이 제공됩니다. API에는 최종 사용자와 Windows Azure 웹 사이트 서비스 간의 관계를 캡처하는 엔터티가 있습니다.

웹 사이트 관리 API를 통해 다음과 같은 일련의 핵심 사이트 관리 시나리오가 가능합니다.

  1. 웹 사이트를 만들고, 삭제하고, 구성합니다.

  2. 웹 사이트의 상태를 쿼리합니다.

  3. 리소스 사용, 할당량 및 제한과 같은 메트릭을 쿼리합니다.

  4. 게시 프로필과 같은 메타데이터를 검색합니다.

  5. 웹 사이트의 크기를 구성합니다.

다음과 같은 두 주요 범주의 Windows Azure 웹 사이트 관리 REST API 최종 사용자가 있습니다.

  1. Web site administrator는 Windows Azure 웹 사이트에서 사이트 및 추가 리소스를 만들고 관리합니다. 이 역할은 Windows Azure 구독의 관리자 또는 공동 관리자에 해당됩니다.

  2. Publisher는 FTP 또는 WebDeploy와 같은 프로토콜을 사용하여 사이트의 콘텐츠에 액세스하고 콘텐츠를 게시합니다. 호스팅 공급자의 관점에서 게시자는 FTP 사용자입니다. 게시자는 사이트에 대한 관리 작업을 수행할 수 없습니다.

Windows Azure 웹 사이트 REST API에는 서비스 및 배포를 관리할 수 있도록 다음과 같은 리소스 계층 구조가 표시됩니다.

/subscriptions

   /WebSpaces

      /sites

         /config

         /publishxml

         /usages

         /metrics

         /repository

   /ServerFarm

다음 표에서는 위의 리소스 각각에 대해 설명합니다.

 

리소스 설명

Subscriptions

Windows Azure 웹 사이트를 사용하려면 Windows Azure 구독이 필요합니다.

Webspaces

웹 공간은 지정된 지리적 영역의 사용자 구독과 연결된 논리적 엔터티입니다. 지정된 지역의 모든 사이트는 지정된 웹 공간과 연결됩니다.

Sites

사이트는 Windows Azure 웹 사이트 서비스에서 제공되는 핵심 리소스 엔터티입니다.

Config

AppSettings, ConnectionStrings, 오류 로깅 및 FrameworkVersions와 같은 사이트 구성 속성을 노출합니다.

Publishxml

웹 응용 프로그램을 Windows Azure 웹 사이트에 게시하는 사용자 설정이 포함된 XML 형식의 파일입니다. 이 파일은 Visual Studio 또는 Web Matrix에서 가져와 사용할 수 있습니다.

Usages

현재 웹 사이트 사용에 대한 정보를 포함합니다.

Metrics

사용에 대한 기록 정보(보고서)를 포함합니다.

Repository

사이트와 연결된 원본 제어 관리 리포지토리입니다.

Serverfarm

지정된 지역의 특정 테넌트에 대한 사이트를 호스팅하는 전용 서버 집합입니다. 현재 데이터 센터당 하나의 서버 팜만 지원됩니다.

새 리소스는 HTTP POST 동사로 만들어집니다. 리소스 이름은 요청 본문에서 전달됩니다. 리소스가 만들어지면 HTTP 201(생성됨) 상태 코드가 반환되고 직렬화된 리소스 개체가 응답 본문에 포함됩니다. 클라이언트가 이미 있는 리소스를 만들려고 하면 HTTP 409(충돌) 상태 코드가 반환됩니다.

기존 리소스의 현재 상태를 읽으려면 HTTP GET 동사가 사용됩니다. 리소스가 있으면 응답 상태 코드는 200이고 응답 본문은 직렬화된 개체를 포함하게 됩니다. 리소스가 없으면 응답 상태 코드가 404(찾을 수 없음)입니다.

기존 리소스는 HTTP PUT 동사로 업데이트됩니다. 개체 이름이 URL 문자열에 전달되고 개체의 새로운 상태가 요청 본문에 전달됩니다. 리소스가 업데이트되면 HTTP 200 상태 코드가 반환됩니다. 업데이트할 리소스가 없는 경우 HTTP 404(찾을 수 없음) 상태 코드가 반환됩니다.

기존 리소스는 HTTP DELETE 동사로 삭제됩니다. 개체 이름이 URL 문자열에 전달됩니다. 리소스가 삭제되면 HTTP 200 상태 코드가 반환됩니다. 개체가 이미 삭제되었거나 존재하지 않으면 HTTP 404가 반환됩니다.

모든 Windows Azure 웹 사이트 관리 API는 두 가지 데이터 형식인 "Plain Old Xml"(POX) 또는 JSON을 지원합니다. API 호출자는 다음과 같이 요청에서 적절한 HTTP 헤더를 설정하여 형식을 선택할 수 있습니다.

 

데이터 형식 HTTP 헤더

XML

"Content-Type: text/xml", "Accept: text/xml"

JSON

"Content-Type: application/json", "Accept: application/json"

다른 Windows Azure 서비스와 마찬가지로 Windows Azure 웹 사이트도 Windows Azure REST API 버전 관리 방식을 따릅니다. Windows Azure 웹 사이트 REST API에서 제공되는 작업의 경우 버전이 여러 개일 수 있습니다. x-ms-version 요청 헤더를 설정하여 사용하려는 작업의 버전을 지정할 수 있습니다. x-ms-version 헤더를 생략하는 경우 기본 버전이 사용됩니다. 서비스가 이전 버전의 작업을 호출하고 새 버전이 존재하는 경우 이전 버전을 계속 호출하도록 선택하거나 코드를 수정하여 새 버전을 호출할 수 있습니다.

Warning경고
지정하는 버전이 더 이상 사용되지 않는 경우 대신 기본 버전이 사용됩니다.

x-ms-version 요청 헤더 값은 YYYY-MM-DD 형식으로 지정해야 합니다. 예를 들면 다음과 같습니다.

Request Headers:

x-ms-version: 2013-08-01

Windows Azure 웹 사이트 API를 호출하려면 구독에 연결할 관리 인증서가 필요합니다. 자세한 내용은 서비스 관리 요청 인증을 참조하십시오.

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

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