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

역할 가져오기

업데이트 날짜: 2014년 5월

Get Role 작업은 지정한 가상 컴퓨터에 대한 정보를 검색합니다.

다음과 같이 Get Role 요청을 지정할 수 있습니다. <subscription-id>를 구독 ID로 바꾸고, <cloudservice-name>을 클라우드 서비스 이름으로 바꾸고, <deployment-name>을 배포 이름으로 바꾸고, <role-name>을 가상 컴퓨터의 이름으로 바꾸십시오.

 

메서드 요청 URI

GET

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/roles/<role-name>

관리 서비스에 대한 요청이 안전한지 확인해야 합니다. 자세한 내용은 서비스 관리 요청 인증을 참조하십시오.

다음 표에서는 요청 헤더에 대해 설명합니다.

 

요청 헤더 설명

x-ms-version

필수 사항입니다. 이 요청에 사용할 작업의 버전을 지정합니다. 이 헤더는 01.03.12 이후로 설정되어야 합니다. 버전 관리 헤더에 대한 자세한 내용은 서비스 관리 버전 관리를 참조하십시오.

없음.

응답에는 HTTP 상태 코드, 응답 헤더 집합 및 응답 본문이 포함되어 있습니다.

작업에 성공하면 상태 코드 200(정상)이 반환됩니다. 상태 코드에 대한 자세한 내용은 서비스 관리 상태 및 오류 코드를 참조하십시오.

이 작업의 응답에는 다음과 같은 헤더가 포함됩니다. 응답에는 추가 표준 HTTP 헤더가 포함될 수도 있습니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 따릅니다.

 

응답 헤더 설명

x-ms-request-id

관리 서비스에 대해 수행된 요청을 고유하게 식별하는 값입니다.

응답 본문의 형식은 다음과 같습니다.


<PersistentVMRole xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <RoleName>name-of-the-virtual-machine</RoleName>
  <RoleType>PersistentVMRole</RoleType>
  <VMImage>name-of-vm-image</VMImage>
  <MediaLocation>path-to-vhds</MediaLocation>      
  <ConfigurationSets>
    <ConfigurationSet>
      <ConfigurationSetType>NetworkConfiguration</ConfigurationSetType>          
      <InputEndpoints>
        <InputEndpoint>                
          <LoadBalancedEndpointSetName>name-of-load-balanced-set</LoadBalancedEndpointSetName>
          <LocalPort>local-port-number</LocalPort>
          <Name>name-of-endpoint</Name>
          <Port>external-port-number</Port>
          <LoadBalancerProbe>
            <Path>path-of-probe</Path>
            <Port>port-assigned-to-probe</Port>
            <Protocol>probe-protocol</Protocol>                    
          </LoadBalancerProbe>
          <LoadBalancerName>name-of-internal-loadbalancer</LoadBalancerName>
          <Protocol>endpoint-protocol</Protocol>
          <EnableDirectServerReturn>enable-direct-server-return</EnableDirectServerReturn>                    
          <Vip>virtual-ip-address-of-input-endpoint</Vip>
        </InputEndpoint>
      </InputEndpoints>
      <SubnetNames>
        <SubnetName>name-of-subnet</SubnetName>
      </SubnetNames>
      <StaticVirtualNetworkIPAddress>ip-address</StaticVirtualNetworkIPAddress>
      <PublicIPs>
        <PublicIP>
          <Name>name-of-public-ip</Name>
        <PublicIP>
      <PublicIPs>
    </ConfigurationSet>
  </ConfigurationSets>
  <ResourceExtensionReferences>
    <ResourceExtensionReference>
      <ReferenceName>name-of-reference</ReferenceName>
      <Publisher>name-of-publisher</Publisher>
      <Name>name-of-extension</Name>
      <Version>version-of-extension</Version>
      <ResourceExtensionParameterValues>
        <ResourceExtensionParameterValue>
          <Key>name-of-parameter-key</Key>
          <Value>parameter-value</Value>
          <Type>type-of-parameter</Type>
        </ResourceExtensionParameterValue>
      </ResourceExtensionParameterValues>
      <State>state-of-resource</State>
    </ResourceExtensionReference>
  </ResourceExtensionReferences>
  <AvailabilitySetName>name-of-availability-set</AvailabilitySetName>
  <DataVirtualHardDisks>
    <DataVirtualHardDisk>
      <HostCaching>host-caching-mode-of-data-disk</HostCaching> 
      <DiskName>new-or-existing-disk-name</DiskName>
      <Lun>logical-unit-number-of-data-disk</Lun>
      <LogicalDiskSizeInGB>size-of-data-disk</LogicalDiskSizeInGB>            
      <MediaLink>path-to-vhd</MediaLink>
    </DataVirtualHardDisk>
  </DataVirtualHardDisks>
  <OSVirtualHardDisk>
    <HostCaching>host-caching-mode-of-os-disk</HostCaching>    
    <DiskName>name-of-os-disk</DiskName>                    
    <MediaLink>path-to-vhd</MediaLink>
    <SourceImageName>image-used-to-create-os-disk</SourceImageName>
    <OS>operating-system-on-os-disk</OS>
  </OSVirtualHardDisk>      
  <RoleSize>size-of-instance</RoleSize>
  <ProvisionGuestAgent>install-an-agent</ProvisionGuestAgent>
  <DefaultWinRmCertificateThumbprint>winrm-cert-thumbprint</DefaultWinRmCertificateThumbprint>     
</PersistentVMRole>

다음 표에서는 응답 본문의 요소에 대해 설명합니다.

 

요소 이름 설명

RoleName

가상 컴퓨터의 이름을 지정합니다.

RoleType

사용되는 역할 유형을 지정합니다. 가상 컴퓨터의 경우 이 값이 PersistentVMRole이어야 합니다.

VMImage

가상 컴퓨터를 만드는 데 사용된 VM 이미지의 이름을 지정합니다. 자세한 내용은 VM 이미지 캡처를 참조하십시오.

VMImage 요소는 버전 01.02.14 이후인 경우에만 사용할 수 있습니다.

MediaLocation

VM 이미지에 연결된 VHD 파일의 경로를 지정합니다.

MediaLocation 요소는 버전 01.02.14 이후인 경우에만 사용할 수 있습니다.

ConfigurationSets

시스템 및 응용 프로그램 설정을 정의하는 구성 집합 컬렉션을 포함합니다.

ResourceExtensionReferences

선택 사항입니다. 가상 컴퓨터에 설치된 리소스 확장 컬렉션을 포함합니다. 이 요소는 ProvisionGuestAgent가 true로 설정된 경우에 사용됩니다.

AvailabilitySetName

가상 컴퓨터 컬렉션의 이름을 지정합니다. 동일한 가용성 집합에 지정된 가상 컴퓨터는 가용성을 최대화하기 위해 서로 다른 노드에 할당됩니다. 가용성 집합에 대한 자세한 내용은 가상 컴퓨터의 가용성 관리를 참조하십시오.

DataVirtualHardDisks

가상 컴퓨터에 데이터 디스크를 추가하는 데 사용된 매개 변수를 포함합니다. 데이터 디스크에 대한 자세한 내용은 디스크 및 이미지 관리를 참조하십시오.

OSVirtualHardDisk

가상 컴퓨터에 대한 운영 체제 디스크를 만드는 데 사용된 매개 변수를 포함합니다.

RoleSize

가상 컴퓨터의 크기를 지정합니다. 기본 크기는 작음입니다. 가상 컴퓨터 크기에 자세한 내용은 Azure의 가상 컴퓨터 및 클라우드 서비스 크기를 참조하십시오.

ProvisionGuestAgent

선택 사항입니다. VM 에이전트가 가상 컴퓨터에 설치되었는지 여부를 나타냅니다. 가상 컴퓨터에서 리소스 확장을 실행하려면 이 서비스를 설치해야 합니다.

가능한 값은 다음과 같습니다.

  • true

  • false

DefaultWinRmCertificateThumbprint

WinRM용 HTTPS 수신기와 함께 사용되는 인증서의 읽기 전용 지문을 지정합니다.

시스템 및 응용 프로그램 구성 설정을 포함하는 구성 집합 컬렉션을 포함합니다.

 

요소 이름 설명

ConfigurationSetType

구성 집합의 구성 유형을 지정합니다. 현재 이 값은 항상 NetworkConfiguration으로 설정됩니다.

InputEndpoints

가상 컴퓨터에 대한 외부 끝점 컬렉션을 포함합니다.

SubnetNames

가상 컴퓨터가 속하게 될 서브넷 목록을 포함합니다.

StaticVirtualNetworkIPAddress

가상 네트워크의 가상 컴퓨터에 대한 내부 IP 주소를 지정합니다. 이 요소를 지정하는 경우 SubnetNames 요소에 하나의 서브넷만 포함됩니다. 이 요소에 지정된 IP 주소는 SubnetNames에 정의된 서브넷에 속합니다.

StaticVirtualNetworkIPAddress 요소는 버전 01.11.13 이후인 경우에만 사용할 수 있습니다.

PublicIPs

선택 사항입니다. 가상 컴퓨터의 기본 가상 IP 주소에 추가로 사용할 수 있는 공유 IP 주소를 포함합니다.

PublicIPs 요소는 버전 01.05.14 이후인 경우에만 사용할 수 있습니다.

가상 컴퓨터에 대한 외부 끝점 컬렉션을 포함합니다.

 

요소 이름 설명

LoadBalancedEndpointSetName

부하 분산된 끝점 집합의 이름을 지정합니다.

LocalPort

가상 컴퓨터에서 수신하는 내부 포트를 지정합니다.

Name

외부 끝점의 이름을 지정합니다.

Port

끝점에 사용할 외부 포트를 지정합니다.

LoadBalancerProbe

부하 분산 장치가 끝점으로 트래픽을 전달하기 전에 가상 컴퓨터의 가용성을 모니터링하기 위해 사용하는 끝점 설정을 정의하는 속성을 포함합니다.

LoadBalancerName

선택 사항입니다. 이 끝점에 연결된 내부 부하 분산 장치의 이름을 지정합니다.

LoadBalancerName 요소는 버전 01.05.14 이후인 경우에만 사용할 수 있습니다.

프로토콜

끝점의 전송 프로토콜을 지정합니다.

가능한 값은 아래와 같습니다.

  • TCP

  • UDP

EnableDirectServerReturn

끝점이 Direct Server Return을 사용하는지 여부를 지정합니다. EnableDirectServerReturn 요소는 RDP, SSH 또는 WinRM 끝점에 대해 지원되지 않으며 끝점의 공용 포트 및 로컬 포트가 다른 경우 지원되지 않습니다. AlwaysOn 가용성 그룹 및 SQL Server용 가상 컴퓨터를 설정할 때만 이 요소를 사용하는 것이 좋습니다. 자세한 내용은 Azure 가상 컴퓨터의 SQL Server에 대한 고가용성 및 재해 복구를 참조하십시오.

가능한 값은 다음과 같습니다.

  • true

  • false

기본값은 false입니다.

Vip

역할의 가상 IP 주소를 지정합니다.

부하 분산 장치가 끝점으로 트래픽을 전달하기 전에 가상 컴퓨터의 가용성을 모니터링하기 위해 사용하는 끝점 설정을 정의하는 속성을 포함합니다.

 

요소 이름 설명

Path

가상 컴퓨터의 가용성 상태를 확인하기 위해 조사할 상대 경로를 지정합니다. Protocol이 TCP로 설정되어 있으면 이 값이 Null이어야 합니다.

예:

path

검색은 검색을 수행하기 위해 https://example.com/path를 사용합니다.

Port

가상 컴퓨터의 가용성 상태를 조사하기 위해 사용할 포트를 지정합니다.

프로토콜

가상 컴퓨터의 가용성 상태를 조사하기 위해 사용할 프로토콜을 지정합니다.

가능한 값은 다음과 같습니다.

  • HTTP

  • TCP

가상 컴퓨터의 기본 가상 IP 주소에 추가로 사용할 수 있는 공유 IP 주소를 포함합니다.

 

요소 이름 설명

PublicIP

필수 사항입니다. 가상 컴퓨터와 통신하는 데 사용할 수 있는 추가 IP 공용 주소를 지정합니다.

Name

필수 사항입니다. 공용 IP 주소의 이름을 지정합니다.

가상 컴퓨터가 속하게 될 서브넷 목록을 포함합니다.

 

요소 이름 설명

SubnetName

가상 컴퓨터가 속하는 서브넷의 이름을 지정합니다.

가상 컴퓨터에 데이터 디스크를 추가하는 데 사용되는 매개 변수를 포함합니다.

 

요소 이름 설명

DataVirtualHardDisk

데이터 디스크를 만드는 데 사용되는 속성을 지정합니다.

HostCaching

읽기/쓰기 효율성에 대한 데이터 디스크의 캐싱 동작을 지정합니다. 이 속성을 설정하면 디스크 일관성에 영향을 주게 됩니다.

가능한 값은 다음과 같습니다.

  • None

  • ReadOnly

  • ReadWrite

기본값은 None입니다.

DiskName

데이터 디스크의 이름을 지정합니다.

Lun

데이터 디스크에 대한 LUN(논리 단위 번호)을 지정합니다.

유효한 LUN 값은 0에서 15까지입니다.

LogicalDiskSizeInGB

가상 컴퓨터에 연결할 빈 디스크의 크기(GB)를 지정합니다.

MediaLink

데이터 디스크와 연결된 VHD의 위치를 지정합니다.

가상 컴퓨터에 대한 운영 체제 디스크를 만드는 데 사용되는 매개 변수를 포함합니다.

 

요소 이름 설명

HostCaching

운영 체제 디스크의 캐싱 모드를 지정합니다. 이 설정은 디스크의 일관성과 성능에 영향을 줍니다.

가능한 값은 다음과 같습니다.

  • ReadOnly

  • ReadWrite

기본값은 ReadWrite입니다.

DiskName

운영 체제 디스크의 이름을 지정합니다.

MediaLink

운영 체제 디스크와 연결된 VHD의 위치를 지정합니다.

SourceImageName

가상 컴퓨터를 만드는 데 사용된 이미지의 이름을 지정합니다.

OS

가상 컴퓨터에서 실행되는 운영 체제를 지정합니다.

가상 컴퓨터에 설치할 리소스 확장 컬렉션을 포함합니다. 리소스 확장은 가상 컴퓨터에 설치된 소프트웨어 구성 요소입니다. 리소스 확장을 설치하려면 VM 에이전트를 가상 컴퓨터에 설치해야 합니다.

 

요소 이름 설명

ResourceExtensionReference

필수 사항입니다. 가상 컴퓨터에 설치해야 하는 리소스 확장의 속성을 지정합니다.

ReferenceName

필수 사항입니다. 리소스 확장의 참조 이름을 지정합니다.

Publisher

필수 사항입니다. 리소스 확장을 만든 게시자의 이름을 지정합니다. 리소스 확장 나열을 사용하여 리소스 확장의 게시자 이름을 찾을 수 있습니다.

Name

필수 사항입니다. 리소스 확장의 이름을 지정합니다. 리소스 확장 나열을 사용하여 사용 가능한 리소스 확장의 이름을 찾을 수 있습니다.

Version

필수 사항입니다. 리소스 확장의 버전을 지정합니다. 리소스 확장 버전 나열을 사용하여 리소스 확장의 버전을 찾을 수 있습니다.

ResourceExtensionParameterValues

선택 사항입니다. 리소스 확장을 설치할 때 리소스 확장에 전달되는 매개 변수 컬렉션을 포함합니다.

State

선택 사항입니다. 리소스 확장의 상태를 지정합니다.

가능한 값은 다음과 같습니다.

  • Enable

  • Disable

기본값은 Enable입니다.

리소스 확장을 설치할 때 리소스 확장에 전달되는 매개 변수 컬렉션을 포함합니다.

 

요소 이름 설명

ResourceExtensionParameterValue

필수 사항입니다. 키, 값 및 매개 변수 유형을 지정합니다.

Key

필수 사항입니다. 매개 변수의 키를 지정합니다.

필수 사항입니다. Base-64로 인코딩된 매개 변수 값을 지정합니다.

Type

필수 사항입니다. 리소스 확장의 유형을 지정합니다.

가능한 값은 다음과 같습니다.

  • Public

  • Private

이 값을 Private으로 설정하면 배포 가져오기에서 매개 변수가 반환되지 않습니다. 최대 두 개의 매개 변수에 대해 하나의 공용 매개 변수와 하나의 개인 매개 변수만 지정할 수 있습니다.

Get-AzureRole cmdlet을 사용하여 역할에 대한 정보를 검색할 수도 있습니다.

표시:
© 2014 Microsoft