Azure Pack Websites Service REST API Windows
적용 대상: Windows Azure Pack
이 설명서에서는 Windows Azure Pack 웹 사이트 관리 REST API를 사용하여 웹 사이트에서 일반적인 작업을 수행하는 방법을 설명합니다.
개요
Windows Azure Pack 웹 사이트 관리 API는 Windows Azure Pack 웹 사이트 서비스와 상호 작용하여 웹 사이트를 관리하는 RESTful 웹 서비스 집합을 제공합니다. API에는 최종 사용자와 Windows Azure Pack 웹 사이트 서비스 간의 관계를 캡처하는 엔터티가 있습니다.
웹 사이트 관리 API를 사용하면 사이트 관리 시나리오의 핵심 집합을 사용할 수 있습니다.
웹 사이트를 만들고, 삭제하고, 구성합니다.
웹 사이트의 상태를 쿼리합니다.
리소스 사용, 할당량 및 제한과 같은 메트릭을 쿼리합니다.
게시 프로필과 같은 메타데이터를 검색합니다.
웹 사이트의 규모를 구성합니다.
최종 사용자
Windows Azure Pack 웹 사이트 관리 REST API의 최종 사용자의 두 가지 주요 범주가 있습니다.
웹 사이트 관리자는 Windows Azure Pack 웹 사이트에서 사이트 및 추가 리소스를 만들고 관리합니다. 이 역할은 Windows Azure Pack 구독의 관리자 또는 공동 관리자에 해당합니다.
Publisher 사이트의 콘텐츠에 액세스하고 FTP 또는 WebDeploy와 같은 프로토콜을 사용하여 콘텐츠를 게시합니다. 호스팅 공급자의 관점에서 게시자는 FTP 사용자입니다. 게시자는 사이트에 대한 관리 작업을 수행할 수 없습니다.
리소스
Microsoft Azure 웹 사이트 REST API는 서비스 및 배포를 관리하기 위해 다음과 같은 리소스 계층 구조를 노출합니다.
/subscriptions
/WebSpaces
/sites
/config
/publishxml
/usages
/metrics
/repository
/ServerFarm
다음 표에서는 이전 리소스에 대해 설명합니다.
리소스 |
Description |
|---|---|
Subscriptions |
Windows Azure 웹 사이트를 사용하는 데 필요한 Windows Azure Pack 구독입니다. |
웹스페이스 |
지정된 지역에서 사용자의 구독과 연결된 논리 엔터티인 웹스페이스입니다. 지정된 지역의 모든 사이트는 지정된 웹 공간과 연결됩니다. |
사이트 |
Windows Azure 웹 사이트 서비스에서 제공하는 핵심 리소스 엔터티인 사이트입니다. |
Config |
AppSettings, ConnectionStrings, ErrorLogging 및 FrameworkVersions와 같은 사이트 구성 속성을 포함하는 리소스입니다. |
Publishxml |
웹 애플리케이션을 게시할 사용자의 설정이 포함된 XML 형식의 파일로, Azure 웹 사이트를 Windows. 이 파일을 가져오고 Microsoft Visual Studio 또는 Web Matrix에서 사용할 수 있습니다. |
사용 |
현재 웹 사이트 사용에 대한 정보가 포함된 리소스입니다. |
메트릭 |
사용량에 대한 보고서의 기록 정보를 포함하는 리소스입니다. |
리포지토리 |
사이트와 연결된 소스 제어 관리 리포지토리입니다. |
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가 반환됩니다.
API 버전 관리
Windows Azure 서비스와 마찬가지로 Windows Azure Pack 웹 사이트는 azure REST API 버전 Windows 준수합니다. Windows Azure Pack 웹 사이트 REST API에서 제공하는 작업에는 여러 버전이 있습니다. x-ms-version 요청 헤더를 설정하여 사용할 작업의 버전을 지정해야 합니다. x-ms-version 헤더가 없는 요청은 거부되고 (400) 잘못된 요청 응답을 반환합니다. 서비스가 이전 버전의 작업을 호출하고 최신 버전이 있는 경우 이전 버전을 계속 호출하거나 코드를 계속 수정하여 최신 버전을 호출하도록 선택할 수 있습니다.
참고
API 버전은 변경할 수 있지만 Windows Azure Pack 웹 사이트는 최신 API 버전과 바로 이전 버전을 모두 지원합니다.
x-ms-version 요청 헤더 값은 YYYY-MM-DD 형식으로 지정해야 합니다. 코드 예제에는 필요한 형식이 표시됩니다.
요청 헤더:
x-ms-version: 2012-10-10