VM 역할에 대한 URL 참고 자료 [SPFSDK][VMROLE]

아티클
08/24/2015

적용 대상: Windows Azure Pack

서비스 관리 API는 HTTP REST 기반 서비스입니다. VM 역할과 관련된 기능을 사용하려면 특정 URL 구조로 작업합니다. 이 항목에서는 VM 역할로 작업할 때 사용할 수 있는 모든 URL에 대한 가이드를 제공합니다. 각 URL에서 작동하는 개체 유형과 URL을 통해 해당 개체에 사용할 수 있는 작업이 있는 경우 설명합니다.

중요

갤러리 및 클라우드 서비스에서 URL을 사용할 때마다 api-version=2013-03 쿼리 문자열을 추가해야 합니다. 쿼리 문자열은 항상 URL 뒤의 ? 문자로 시작합니다. 예를 들어 TestService라는 클라우드 서비스에 액세스하려면 https:// server-name:server-port/subscription-id/CloudServices/TestService?api-version=2013-03 URL을 사용합니다.

일반 URL 자리 표시자

이 프로그래밍 가이드 전체에서 서버 이름 또는 이전에 만든 개체의 이름과 같은 인프라에 대한 정보가 필요한 URL이 사용됩니다. 다음 목록에서는 사용된 모든 자리 표시자를 설명합니다.

자리 표시자 이름	Description
서버 이름	서비스 관리 API 서버의 서버 이름입니다.
server-port	서비스 관리 API 서버의 인증 포트입니다.
subscription-id	VM 역할을 호스트하는 클라우드 서비스의 이름입니다.
cloudservice-name	VM 역할을 호스트하는 클라우드 서비스의 이름입니다.
vmrole-name	VM 역할의 이름입니다.
vm-id	가상 머신의 식별자입니다.
disk-id	가상 하드 디스크의 식별자입니다.
nic-id	가상 네트워크 어댑터의 식별자입니다.

갤러리

subscription-id/Gallery/GalleryItems
지원되는 HTTP 작업: GET.

지정된 구독에 사용할 수 있는 갤러리 항목에 대한 액세스를 제공합니다. 반환되는 항목은 VM 역할로 제한되지 않지만 형식에 관계없이 모든 갤러리 항목입니다.
subscription-id/Gallery/GalleryItems(publisher,name,version)
지원되는 HTTP 작업: GET.

지정된 구독에 사용할 수 있는 특정 갤러리 항목에 대한 액세스를 제공합니다.
subscription-id/Gallery/GalleryItems/$/MicrosoftCompute.VMRoleGalleryItem
지원되는 HTTP 작업: GET.

지정된 구독에 사용할 수 있는 VM 역할 갤러리 항목에 대한 액세스를 제공합니다.

이 URL을 사용하는 예제는 다음을 참조하세요.
- VM 역할 갤러리 항목에 대한 참조 가져오기
- VM 역할 갤러리 항목에서 리소스 정의 가져오기
subscription-id/Gallery/GalleryItems/$/MicrosoftCompute.VMRoleGalleryItem(publisher,name,version)
지원되는 HTTP 작업: GET.

지정된 구독에 사용할 수 있는 특정 VM 역할 갤러리 항목에 대한 액세스를 제공합니다.

이 URL을 사용하는 예제는 다음을 참조하세요.
- VM 역할 갤러리 항목에서 리소스 정의 가져오기

클라우드 서비스

subscription-id/CloudServices
지원되는 HTTP 작업: GET, POST.

지정된 구독에 대해 만들어진 클라우드 서비스에 대한 액세스를 제공합니다. POST 작업을 사용하여 클라우드 서비스를 만들 수 있습니다.

이 URL을 사용하는 예제는 다음을 참조하세요.
- VM 역할을 호스트하는 클라우드 서비스 만들기 [SPFSDK][VMROLE]
subscription-id/CloudServices/cloudservice-name
지원되는 HTTP 작업: GET, PUT, PATCH, DELETE.

지정된 구독에서 만든 특정 클라우드 서비스에 대한 액세스를 제공합니다. URL로 식별된 클라우드 서비스를 업데이트하고 삭제할 수 있습니다.
subscription-id/CloudServices/cloudservice-name/Resources
지원되는 HTTP 작업: GET.

지정된 클라우드 서비스에 사용할 수 있는 리소스 공급자에 대한 액세스를 제공합니다.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute
지원되는 HTTP 작업: GET.

VM 역할을 호스트하는 MicrosoftCompute 리소스 공급자에 대한 액세스를 제공합니다.

VM 역할

subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles
지원되는 HTTP 작업: GET, POST.

생성된 VM 역할 인스턴스에 대한 액세스를 제공합니다. 이 URL은 새 VM 역할 인스턴스를 서버에 제출하는 데도 사용됩니다.

이 URL을 사용하는 예제는 다음을 참조하세요.
- VM 역할 인스턴스 JSON 개체 빌드 및 제출
- 프로비전 오류에 대한 VM 역할 검사 [SPFSDK][VMROLE]
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name
지원되는 HTTP 작업: GET, PUT, PATCH, DELETE.

이름으로 특정 VM 역할에 대한 액세스를 제공합니다. 이 URL은 VM 역할을 삭제하고 업데이트하는 데 사용됩니다.

이 URL을 사용하는 예제는 다음을 참조하세요.
- VM 역할 인스턴스 가져오기 [SPFSDK][VMROLE]
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/Scale
지원되는 HTTP 작업: POST.

지정된 VM 역할에 대한 크기 조정 작업을 시작합니다.

이 URL을 사용하는 예제는 다음을 참조하세요.
- VM 역할 크기 조정 [SPFSDK][VMROLE]
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/Repair
지원되는 HTTP 작업: POST.

지정된 VM 역할에 대한 복구 작업을 시작합니다.

이 URL을 사용하는 예제는 다음을 참조하세요.
- VM 역할 복구 [SPFSDK][VMROLE]

가상 머신

subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs
지원되는 HTTP 작업: GET.

특정 VM 역할에서 호스트되는 가상 머신에 대한 액세스를 제공합니다.

이 URL을 사용하는 예제는 다음을 참조하세요.
- 모든 Virtual Machines [SPFSDK][VMROLE] 가져오기
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id
지원되는 HTTP 작업: GET, DELETE.

특정 VM 역할에서 호스트되는 식별자를 통해 가상 머신에 대한 액세스를 제공합니다. 이 URL은 VM 역할에서 특정 가상 머신을 삭제하는 데 사용할 수 있습니다.

이 URL을 사용하는 예제는 다음을 참조하세요.
- 단일 가상 머신 가져오기 [SPFSDK][VMROLE]
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Stop
지원되는 HTTP 작업: POST.

식별된 가상 머신을 중지합니다.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Start
지원되는 HTTP 작업: POST.

식별된 가상 머신을 시작합니다.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Restart
지원되는 HTTP 작업: POST.

식별된 가상 머신을 다시 시작합니다.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Shutdown
지원되는 HTTP 작업: POST.

식별된 가상 머신을 종료합니다.

가상 디스크 및 가상 네트워크 어댑터

subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Disks
지원되는 HTTP 작업: GET, POST.

식별된 가상 머신의 가상 디스크에 대한 액세스를 제공합니다. 이 URL은 POST 작업을 사용하여 가상 디스크를 가상 머신에 연결하는 데 사용할 수도 있습니다.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Disks/disk-id
지원되는 HTTP 작업: GET, PUT, PATCH, DELETE.

지정된 가상 디스크에 대한 액세스를 제공합니다.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Nics
지원되는 HTTP 작업: GET.

식별된 가상 머신의 가상 네트워크 어댑터에 대한 액세스를 제공합니다.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Nics/nic-id
지원되는 HTTP 작업: GET.

지정된 가상 네트워크 어댑터에 대한 액세스를 제공합니다.

다음을 통해 공유