영업: 1-800-867-1380

클라우드 서비스 속성 가져오기

업데이트 날짜: 2014년 8월

Get Cloud Service Properties 작업은 지정된 클라우드 서비스의 속성을 검색합니다. 이러한 속성에는 다음과 같은 값이 있습니다.

  • 클라우드 서비스의 이름 및 설명입니다.

  • 클라우드 서비스가 속한 선호도 그룹의 이름 또는 클라우드 서비스 위치입니다(클라우드 서비스가 선호도 그룹의 일부가 아닌 경우).

  • 클라우드 서비스를 추적하는 데 사용되는 레이블입니다.

  • 클라우드 서비스를 만들거나 수정한 날짜 및 시간입니다.

  • 세부 정보가 필요한 경우 클라우드 서비스의 배포에 대한 정보가 반환됩니다.

다음과 같이 Get Cloud Service Properties 요청을 지정할 수 있습니다. <subscription-id>를 구독 ID로 바꾸고, <cloudservice-name>을 클라우드 서비스의 이름으로 바꾸십시오.

 

메서드 요청 URI

GET

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

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

 

URI 매개 변수 설명

embed-detail=true

선택 사항입니다. 클라우드 서비스의 모든 배포에 대해 속성을 반환하도록 지정합니다. 기본값은 false입니다.

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

 

요청 헤더 설명

x-ms-version

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

없음.

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

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

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

 

응답 헤더 설명

x-ms-request-id

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

요청에 embed-detail이 포함되지 않은 경우 응답 본문의 기본 형식은 다음과 같습니다.


<?xml version="1.0" encoding="utf-8"?>
<HostedService xmlns="http://schemas.microsoft.com/windowsazure">
  <Url>hosted-service-url</Url>
  <ServiceName>hosted-service-name</ServiceName>
  <HostedServiceProperties>
    <Description>description</Description>
    <AffinityGroup>name-of-affinity-group</AffinityGroup> 
    <Location>location-of-service</Location >
    <Label>base-64-encoded-name-of-service</Label>
    <Status>current-status-of-service</Status>
    <DateCreated>creation-date-of-service</DateCreated>
    <DateLastModified>last-modification-date-of-service</DateLastModified>
    <ExtendedProperties>
      <ExtendedProperty>
        <Name>name-of-property</Name>
        <Value>value-of-property</Value>
      </ExtendedProperty>
    </ExtendedProperties>
    <GuestAgentType>type-of-guest-agent</GuestAgentType>
  </HostedServiceProperties>
  <DefaultWinRmCertificateThumbprint>thumbprint-of-winrm-certificate</DefaultWinRmCertificateThumbprint>
</HostedService>

embed-detailtrue로 설정된 경우 다음 요소가 반환됩니다.

<?xml version="1.0" encoding="utf-8"?>
<HostedService xmlns="http://schemas.microsoft.com/windowsazure">
  <Url>hosted-service-url</Url>
  <ServiceName>hosted-service-name</ServiceName>
  <HostedServiceProperties>
    <Description>description-of-service</Description>
    <AffinityGroup>name-of-affinity-group</AffinityGroup>
    <Location>location-of-service</Location>
    <Label>base-64-encoded-name-of-service</Label>
    <Status>current-status-of-service</Status>
    <DateCreated>creation-date-of-service</DateCreated>
    <DateLastModified>last-modification-date-of-service</DateLastModified>
    <ExtendedProperties>
      <ExtendedProperty>
        <Name>name-of-property</Name>
        <Value>value-of-property</Value>
      </ExtendedProperty>
    </ExtendedProperties>
    <GuestAgentType>type-of-guest-agent</GuestAgentType>
  </HostedServiceProperties>
  <Deployments>
    <Deployment xmlns=”http://schemas.microsoft.com/windowsazure”>
      <Name>name-of-deployment</Name>
      <DeploymentSlot>current-deployment-environment</DeploymentSlot>
      <PrivateID>deployment-id</PrivateID>
      <Status>status-of-deployment</Status>
      <Label>base64-encoded-name-of-deployment</Label>
      <Url>deployment-url</Url>
      <Configuration>base-64-encoded-configuration-file</Configuration>
      <RoleInstanceList>
        <RoleInstance>
          <RoleName>name-of-role</RoleName>
          <InstanceName>name-of-role-instance</InstanceName>
          <InstanceStatus>status-of-role-instance</InstanceStatus>
          <InstanceUpgradeDomain>update-domain-of-role-instance</InstanceUpgradeDomain>
          <InstanceFaultDomain>fault-domain-of-role-instance</InstanceFaultDomain>
          <InstanceSize>size-of-role-instance</InstanceSize>
          <InstanceStateDetails>state-of-role-instance</InstanceStateDetails>
          <InstanceErrorCode>error-code-returned-for-role-instance</InstanceErrorCode>
          <IpAddress>ip-address-of-role-instance</IpAddress>
          <InstanceEndpoints>
            <InstanceEndpoint>
              <Name>name-of-endpoint</Name>
              <Vip>virtual-ip-address-of-instance-endpoint</Vip>
              <PublicPort>public-facing-port-of-instance-endpoint</PublicPort>
              <LocalPort>internal-facing-port-of-instance-endpoint</LocalPort>
              <Protocol>protocol-of-instance-endpoint</Protocol>
            </InstanceEndpoint>
          </InstanceEndpoints>
          <PowerState>state-of-role-instance</PowerState>
          <HostName>dns-name-of-service</HostName>
          <RemoteAccessCertificateThumbprint>cert-thumbprint-for-remote-access</RemoteAccessCertificateThumbprint>
        </RoleInstance>
      </RoleInstanceList>
      <UpgradeStatus>
        <UpgradeType>type-of-upgrade</UpgradeType>
        <CurrentUpgradeDomainState>status-of-current-upgrade</CurrentUpgradeDomainState>
        <CurrentUpgradeDomain>n</CurrentUpgradeDomain>
      </UpgradeStatus>
      <UpgradeDomainCount>number-of-upgrade-domains-in-deployment</UpgradeDomainCount>
      <RoleList>
        <Role>
          <RoleName>name-of-role</RoleName>
          <OSVersion>operating-system-version</OSVersion>
          <ConfigurationSets>
            <ConfigurationSet>
              <ConfigurationSetType>NetworkConfiguration</ConfigurationSetType>
              <InputEndpoints>
                <InputEndpoint>
                  <Port>port-number-of-input-endpoint-in-network</Port>
                  <Protocol>protocol-of-input-endpoint-in-network</Protocol>
                  <Vip>virtual-ip-address-of-input-endpoint-in-network</Vip>
                </InputEndpoint>
              </InputEndpoints>
            </ConfigurationSet>
          </ConfigurationSets>
        </Role>
        <Role>
          <RoleName>name-of-role</RoleName>
          <OSVersion>operating-system-version</OSVersion>
          <RoleType>PersistentVMRole</RoleType>
          <ConfigurationSets>
            <ConfigurationSet>
              <ConfigurationSetType>NetworkConfiguration</ConfigurationSetType>
              <InputEndpoints>
                <InputEndpoint>
                  <LoadBalancedEndpointSetName>name-of-load-balanced-endpoint-set</LoadBalancedEndpointSetName>
                  <LocalPort>internal-facing-port-of-input-endpoint</LocalPort>
                  <Name>name-of-input-endpoint</Name>
                  <Port>external-facing-port-of-input-endpoint</Port>
                  <LoadBalancerProbe>
                    <Path>path-of-probe</Path>
                    <Port>port-assigned-to-probe</Port>
                    <Protocol>protocol-of-probe-port</Protocol>
                  </LoadBalancerProbe>
                  <Protocol>protocol-of-input-endpoint</Protocol>
                  <Vip>virtual-ip-address-of-input-endpoint</Vip>
                </InputEndpoint>
              </InputEndpoints>
              <SubnetNames>
                <SubnetName>name-of-subnet</SubnetName>
              </SubnetNames>
            </ConfigurationSet>
          </ConfigurationSets>
          <AvailabilitySetName>name-of-availability-set</AvailabilitySetName>
          <DataVirtualHardDisks>
            <DataVirtualHardDisk>
              <HostCaching>host-caching-mode-of-data-disk</HostCaching>
              <DiskName>name-of-data-disk</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-role-instance</RoleSize>
        </Role>
      </RoleList>
      <SdkVersion>sdk-version-used-to-create-package</SdkVersion>
      <Locked>status-of-deployment-write-allowed</Locked>
      <RollbackAllowed>rollback-operation-allowed</RollbackAllowed>
      <CreatedTime>time-of-deployment-creation</CreatedTime>
      <LastModifiedTime>time-of-last-deployment-modification</LastModifiedTime>
      <VirtualNetworkName>name-of-virtual-network</VirtualNetworkName>
      <Dns>
        <DnsServers>
          <DnsServer>
            <Name>name-of-dns-server</Name>
            <Address>address-of-dns-server</Address>
          </DnsServer>
        </DnsServers>
      </Dns>
      <ExtendedProperties>
        <ExtendedProperty>
          <Name>name-of-property</Name>
          <Value>value-of-property</Value>
        </ExtendedProperty>
      </ExtendedProperties>
      <PersistentVMDowntime>
        <StartTime>start-of-downtime</StartTime>
        <EndTime>end-of-downtime</EndTime>
        <Status>status-of-downtime</Status>
      </PersistentVMDowntime>
      <VirtualIPs>
        <VirtualIP>
          <Address>virtual-ip-address-of-deployment</Address>
        </VirtualIP>
      </VirtualIPs>
    </Deployment>
  </Deployments>
  <DefaultWinRmCertificateThumbprint>thumbprint-of-winrm-certificate</DefaultWinRmCertificateThumbprint>
</HostedService>

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

 

요소 이름 설명

Url

클라우드 서비스에 할당된 URL을 지정합니다.

ServiceName

클라우드 서비스의 이름을 지정합니다. 이 이름은 DNS 접두사 이름이며 클라우드 서비스에 액세스하는 데 사용할 수 있습니다.

예를 들어 클라우드 서비스 이름이 MyService인 경우 다음을 호출하여 클라우드 서비스에 액세스할 수 있습니다. http://MyService.cloudapp.net을 호출하여 서비스에 액세스할 수 있습니다.

HostedServiceProperties

클라우드 서비스에 할당된 속성을 지정합니다.

DefaultWinRmCertificateThumbprint

WinRM이 HTTPS 수신기로 정의되었고 인증서가 정의에 포함되지 않았을 때 생성된 SSL 인증서 지문을 지정합니다. 이 속성의 값은 읽기 전용이며 새 SSL 인증서를 사용하도록 실행 중인 역할 인스턴스가 업데이트되는 경우 이 속성의 값은 변경되지 않습니다.

Deployments

클라우드 서비스의 배포를 지정합니다.

클라우드 서비스에 할당된 속성을 지정합니다.

 

요소 이름 설명

설명

클라우드 서비스의 설명을 지정합니다.

AffinityGroup

클라우드 서비스에 연결되어 있는 선호도 그룹의 이름을 지정합니다. 클라우드 서비스에 선호도 그룹이 연결되어 있으면 Location 요소가 반환되지 않습니다.

위치

Azure에서 클라우드 서비스의 지리적 위치를 지정합니다(클라우드 서비스에 선호도 그룹이 연결되지 않은 경우). 위치가 지정된 경우에는 AffinityGroup 요소가 반환되지 않습니다.

Label

Base-64로 인코딩된 클라우드 서비스의 식별자를 지정합니다. 클라우드 서비스를 식별하는 데 추적용으로 사용할 수 있는 레이블입니다.

상태

클라우드 서비스의 상태를 지정합니다.

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

  • Creating

  • Created

  • Deleting

  • Deleted

  • Changing

  • ResolvingDns

Status 요소는 버전 2012-03-01 이후인 경우에만 사용할 수 있습니다.

DateCreated

클라우드 서비스가 만들어진 날짜를 [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z 형식으로 지정합니다. 예를 들어 2011-05-11T16:15:26Z는 DateCreated 또는 DateLastModified 요소에 의해 반환될 수 있는 날짜입니다.

DateCreated 요소는 버전 2012-03-01 이후인 경우에만 사용할 수 있습니다.

DateLastModified

클라우드 서비스가 마지막으로 업데이트된 날짜를 [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z 형식으로 지정합니다. 예를 들어 2011-05-11T16:15:26Z는 DateCreated 또는 DateLastModified 요소에 의해 반환될 수 있는 날짜입니다.

DateLastModified 요소는 버전 2012-03-01 이후인 경우에만 사용할 수 있습니다.

Name

확장 클라우드 서비스 속성의 이름을 지정합니다.

Name 요소는 버전 2012-03-01 이후인 경우에만 사용할 수 있습니다.

확장 클라우드 서비스 속성의 값을 지정합니다.

Value 요소는 버전 2012-03-01 이후인 경우에만 사용할 수 있습니다.

GuestAgentType

역할 인스턴스에 설치된 게스트 에이전트의 유형을 지정합니다. 게스트 에이전트는 역할 인스턴스를 구성하고 Azure에서 통신할 수 있도록 역할 인스턴스를 설정합니다. 이 요소는 구독에서 게스트 에이전트의 새 버전을 테스트할 수 있는지 여부를 나타냅니다.

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

  • ProdGA

  • TestGA

클라우드 서비스의 배포를 지정합니다.

 

요소 이름 설명

Name

배포의 이름을 지정합니다.

DeploymentSlot

이 배포가 실행되는 환경(staging 또는 production)을 지정합니다.

PrivateID

배포의 고유 식별자를 지정합니다.

상태

배포의 상태를 지정합니다.

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

  • Running

  • Suspended

  • RunningTransitioning

  • SuspendedTransitioning

  • Starting

  • Suspending

  • Deploying

  • Deleting

Label

Base-64로 인코딩된 배포의 식별자를 지정합니다. 레이블은 추적용으로 사용할 수 있습니다.

Url

클라우드 서비스에 액세스하는 데 사용할 수 있는 URL을 지정합니다.

예를 들어 서비스 이름이 MyService인 경우 http://MyService.cloudapp.net을 호출하여 서비스에 액세스할 수 있습니다.

구성

Base-64로 인코딩된 배포 구성 파일을 지정합니다.

RoleInstanceList

배포에 있는 역할 인스턴스의 목록을 포함합니다.

UpgradeStatus

배포에 대해 수행되는 업그레이드에 대한 정보를 지정합니다.

UpgradeDomainCount

클라우드 서비스에 사용할 수 있는 업그레이드 도메인의 수를 지정합니다.

UpgradeDomainCount 요소는 버전 2011-06-01 이후인 경우에만 사용할 수 있습니다.

RoleList

배포에 있는 역할 목록을 포함합니다.

SdkVersion

배포에 대한 패키지를 만드는 데 사용된 Azure SDK의 버전을 지정합니다.

반환되는 버전에서 처음 두 숫자 부분은 패키지를 만드는 데 사용된 SDK의 버전을 나타냅니다.

SdkVersion 요소는 버전 2011-06-01 이후인 경우에만 사용할 수 있습니다.

Locked

새 쓰기 작업에 대해 배포가 잠겨 있는지 여부를 나타냅니다. True이면 기존 작업에서 배포를 업데이트하는 중이므로 배포가 잠겨 있는 것이고, false이면 해당 상태가 아닙니다.

Locked 요소는 버전 2011-06-01 이후인 경우에만 사용할 수 있습니다.

RollbackAllowed

현재 업데이트 또는 업그레이드 롤백 작업이 허용되는지 여부를 나타냅니다. True이면 작업이 허용되는 것이고, false이면 작업이 허용되지 않습니다.

note참고
RollbackAllowed 요소는 버전 2011-06-01 이후인 경우에만 사용할 수 있습니다.

CreatedTime

배포를 만든 시간을 지정합니다.

LastModifiedTime

배포를 마지막으로 수정한 시간을 지정합니다.

VirtualNetworkName

가상 컴퓨터가 연결되는 가상 네트워크의 이름을 지정합니다.

VirtualNetworkName 요소는 버전 2012-03-01 이후인 경우에만 사용할 수 있습니다.

Dns

배포에 대해 지정된 사용자 지정 DNS 설정을 지정합니다.

Dns 요소는 버전 2012-03-01 이후인 경우에만 사용할 수 있습니다.

ExtendedProperties

배포에 대한 자세한 정보를 제공하는 데 사용되는 속성을 지정합니다.

PersistentVMDowntime

가상 컴퓨터가 시작 및 중지된 시간에 대한 정보를 지정합니다.

PersistentVMDowntime 요소는 버전 2012-03-01 이후인 경우에만 사용할 수 있습니다.

VirtualIPs

배포에 대해 지정된 가상 IP 주소를 포함합니다.

VirtualIPs 요소는 버전 2012-03-01 이후인 경우에만 사용할 수 있습니다.

배포에 있는 역할 인스턴스의 목록을 포함합니다.

 

요소 이름 설명

RoleName

역할 이름을 지정합니다.

InstanceName

역할 인스턴스가 실행 중인 경우 특정 역할 인스턴스의 이름을 지정합니다.

InstanceStatus

역할 인스턴스의 현재 상태를 지정합니다.

 

상태 메시지 설명

RoleStateUnknown

역할 상태를 현재 알 수 없음을 나타냅니다.

CreatingVM

가상 컴퓨터에 대한 리소스가 생성되고 있음을 나타냅니다.

StartingVM

가상 컴퓨터를 시작했음을 나타냅니다.

CreatingRole

역할 인스턴스에 대한 리소스가 생성되고 있음을 나타냅니다.

StartingRole

역할 인스턴스를 시작했음을 나타냅니다.

ReadyRole

역할 인스턴스가 시작되었고 사용할 준비가 되었음을 나타냅니다.

BusyRole

역할 인스턴스를 요청할 수 없음을 나타냅니다. 이 상태는 일반적으로 역할을 만들거나 중지하는 동안 생성됩니다.

StoppingRole

역할 인스턴스를 중지하고 있음을 나타냅니다.

StoppingVM

가상 컴퓨터를 중지하고 있음을 나타냅니다.

DeletingVM

가상 컴퓨터가 삭제되고 있음을 나타냅니다.

StoppedVM

가상 컴퓨터가 실행 중이 아님을 나타냅니다. 이 상태는 종료 프로세스의 최종 상태이며 StoppedVM 후에는 어떤 상태 메시지도 수신되지 않아야 합니다.

RestartingRole

역할 인스턴스가 예기치 않게 중지되었거나 역할을 시작하지 못했음을 나타냅니다. 이 상태는 역할 인스턴스가 중단되거나 역할 인스턴스를 시작할 수 없게 하는 문제가 있으며 역할 인스턴스를 시작하려면 문제를 해결해야 함을 나타냅니다. InstanceStateDetailsInstanceErrorCode 필드에는 이 상태를 야기한 오류에 대한 정보가 포함됩니다.

CyclingRole

역할 인스턴스가 올바르게 시작하지 않음을 나타냅니다. 이 상태는 역할 인스턴스를 시작할 수 없게 하는 문제가 있음을 나타내며, StartingRole 상태 또는 ReadyRole 상태가 수신된 경우에도 생성될 수 있습니다. 역할을 시작하려면 역할 인스턴스의 문제를 찾아 수정해야 합니다. InstanceStateDetailsInstanceErrorCode 필드에는 이 상태를 야기한 역할 오류에 대한 정보가 포함됩니다.

FailedStartingRole

역할 인스턴스를 시작하지 못했음을 나타냅니다. 이 상태는 역할 인스턴스를 시작할 수 없게 하는 문제가 있음을 나타내며, 프로세스에서 StartingRole을 반환한 후에도 생성될 수 있습니다. 역할을 시작하려면 역할의 문제를 찾아 수정해야 합니다. InstanceStateDetailsInstanceErrorCode 필드에는 이 상태를 야기한 역할 오류에 대한 정보가 포함됩니다. 이 정보는 문제를 식별하고 디버깅하는 데 유용합니다.

FailedStartingVM

가상 컴퓨터를 지속적으로 시작하지 못했음을 나타냅니다. 이 상태는 Azure에서 생성하며 역할 인스턴스에 오류가 있음을 나타내지 않습니다. StartingRole 상태가 반환된 후에도 생성될 수 있습니다.

UnresponsiveRole

상태 메시지를 받기 전에 역할 인스턴스 제한 시간이 초과되었으며 요청에 응답하고 있지 않음을 나타냅니다.

StoppedDeallocated

역할 인스턴스가 중지되었고 모든 할당된 리소스가 해제되었음을 나타냅니다. 이렇게 하면 역할 인스턴스에 대한 청구가 중지됩니다. StoppedDeallocated 상태의 역할 인스턴스는 버전 2013-06-01 이후인 경우에만 역할 인스턴스 목록에 반환됩니다. 배포의 모든 역할 인스턴스가 StoppedDeallocated 상태인 경우 배포가 반환되지 않습니다.

InstanceUpgradeDomain

역할 인스턴스가 속한 업데이트 도메인을 지정합니다. 업그레이드 배포 중 동일한 업데이트 도메인에 있는 모든 역할 인스턴스가 동시에 업데이트됩니다.

InstanceUpgradeDomain 요소는 버전 2011-06-01 이후인 경우에만 사용할 수 있습니다.

InstanceFaultDomain

역할 인스턴스가 속한 오류 도메인을 지정합니다. 동일한 오류 도메인에 속한 역할 인스턴스는 동일한 공유 하드웨어 오류에 취약할 수 있습니다.

InstanceFaultDomain 요소는 버전 2011-06-01 이후인 경우에만 사용할 수 있습니다.

InstanceSize

역할 인스턴스의 크기를 지정합니다.

InstanceSize 요소는 버전 2011-06-01 이후인 경우에만 사용할 수 있습니다.

InstanceStateDetails

작업이 호출된 시점의 역할 인스턴스 상태에 대한 스냅숏을 제공합니다.

InstanceStateDetails 요소는 버전 2011-06-01 이후인 경우에만 사용할 수 있습니다.

InstanceErrorCode

가상 컴퓨터의 경우 오류 코드는 다음과 같습니다.

  • WaitTimeout - 역할 인스턴스가 25분 내에 통신하지 않습니다. 일반적으로 이는 역할 인스턴스가 시작되지 않았거나 게스트 에이전트가 설치되지 않았음을 나타냅니다.

  • VhdTooLarge - 선택한 VHD 이미지가 역할 인스턴스에 너무 큽니다.

  • AzureInternalError – 내부 오류가 발생하여 역할 인스턴스를 시작하지 못했습니다. 기술 지원 서비스에 문의하여 도움을 받으십시오.

웹 및 작업자 역할의 경우 이 필드에는 오류 해결을 위해 Azure 기술 지원에 제공할 수 있는 오류 코드가 반환됩니다. 일반적으로 이 필드는 비어 있습니다.

InstanceErrorCode 요소는 버전 2011-10-01 이후인 경우에만 사용할 수 있습니다.

IpAddress

역할 인스턴스의 IP 주소(DIP)를 지정합니다.

IpAddress 요소는 버전 2012-03-01 이후인 경우에만 사용할 수 있습니다.

InstanceEndpoints

역할의 인스턴스 끝점 목록을 포함합니다.

PowerState

역할 인스턴스의 실행 상태를 나타냅니다.

다음은 가능한 값입니다.

  • Starting

  • Started

  • Stopping

  • Stopped

  • Unknown

HostName

역할 인스턴스가 실행되고 있는 클라우드 서비스의 DNS 호스트 이름을 지정합니다. 이 요소는 가상 컴퓨터 배포에 대해서만 나열됩니다.

RemoteAccessCertificateThumbprint

RDP 서버 인증서(Windows) 또는 SSH 서버 인증서(Linux)의 지문을 지정합니다. 이 지문은 이미지에서 만들어진 가상 컴퓨터 전용입니다.

RemoteAccessCertificateThumbprint 요소는 버전 2012-08-01 이후인 경우에만 사용할 수 있습니다.

역할의 인스턴스 끝점 목록을 포함합니다.

 

요소 이름 설명

Name

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

Vip

끝점의 가상 IP 주소를 지정합니다.

Vip 요소는 버전 2011-06-01 이후인 경우에만 사용할 수 있습니다.

PublicPort

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

LocalPort

끝점에서 사용되는 내부 포트를 지정합니다.

프로토콜

끝점에 대한 트래픽의 프로토콜을 지정합니다.

배포에 대해 수행되는 업그레이드에 대한 정보를 지정합니다.

 

요소 이름 설명

UpgradeType

업그레이드 유형을 지정합니다.

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

  • Auto

  • Manual

  • Simultaneous

CurrentUpgradeDomainState

업그레이드의 현재 상태를 지정합니다. 가능한 값은 BeforeDuring입니다.

CurrentUpgradeDomain

현재 업그레이드 도메인을 식별하는 정수 값을 포함합니다. 업그레이드 도메인은 0부터 시작하는 인덱스로 식별됩니다. 첫 번째 업그레이드 도메인은 ID가 0이고 두 번째 업그레이드 도메인은 ID가 1이 됩니다.

배포에 있는 역할 목록을 포함합니다.

 

요소 이름 설명

RoleName

역할 이름을 지정합니다.

OSVersion

역할 인스턴스를 실행 중인 운영 체제 버전을 지정합니다.

RoleType

역할 유형을 지정합니다. 이 요소는 가상 컴퓨터 배포에 대해서만 나열되고 기본적으로 PersistentVMRole입니다.

ConfigurationSets

시스템 또는 응용 프로그램 구성 설정을 나타내는 값 컬렉션을 포함합니다.

AvailabilitySetName

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

DataVirtualHardDisks

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

OSVirtualHardDisk

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

RoleSize

역할 인스턴스의 크기를 지정합니다.

시스템 또는 응용 프로그램 구성 설정을 나타내는 값 컬렉션을 포함합니다.

 

요소 이름 설명

ConfigurationSetType

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

InputEndpoints

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

SubnetNames

배포가 속한 가상 네트워크 서브넷 이름 목록을 포함합니다.

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

 

요소 이름 설명

LoadBalancedEndpointSetName

부하 분산된 끝점 집합의 이름을 지정합니다. 이 요소는 가상 컴퓨터 배포에 대해서만 나열됩니다.

LocalPort

가상 컴퓨터에서 끝점을 제공하기 위해 수신하는 내부 포트를 지정합니다. 이 요소는 가상 컴퓨터 배포에 대해서만 나열됩니다.

Name

외부 끝점에 대한 네임스페이스를 지정합니다. 이 요소는 가상 컴퓨터 배포에 대해서만 나열됩니다.

Port

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

LoadBalancerProbe

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

프로토콜

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

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

  • TCP

  • UDP

Vip

끝점의 가상 IP 주소를 지정합니다.

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

 

요소 이름 설명

Path

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

예:

path

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

Port

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

프로토콜

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

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

  • HTTP

  • TCP

배포에 대해 지정된 사용자 지정 DNS 설정을 지정합니다.

 

요소 이름 설명

Name

DNS 서버의 이름을 지정합니다.

Address

DNS 서버의 IP 주소를 지정합니다.

배포에 대한 자세한 정보를 제공하는 데 사용되는 속성을 지정합니다.

 

요소 이름 설명

Name

배포에 연결된 속성의 이름을 지정합니다.

배포에 연결된 속성의 값을 지정합니다.

가상 컴퓨터가 시작 및 중지된 시간에 대한 정보를 지정합니다.

 

요소 이름 설명

StartTime

가상 컴퓨터가 시작된 시간을 지정합니다.

EndTime

가상 컴퓨터가 중지된 시간을 지정합니다.

상태

가상 컴퓨터의 상태를 지정합니다.

배포에 대해 지정된 가상 IP 주소를 포함합니다.

 

요소 이름 설명

Address

배포의 가상 IP 주소를 지정합니다.

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

 

요소 이름 설명

HostCaching

읽기/쓰기 효율성에 대한 데이터 디스크 Blob의 플랫폼 캐싱 동작을 지정합니다.

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

  • None

  • ReadOnly

  • ReadWrite

기본값은 ReadOnly입니다.

DiskName

가상 컴퓨터에 대한 데이터 디스크를 만드는 데 사용할 VHD의 이름을 지정합니다.

Lun

데이터 디스크에 대한 LUN(논리 단위 번호)을 지정합니다. LUN은 가상 컴퓨터에서 사용할 수 있도록 장착할 때 데이터 드라이브가 나타나는 슬롯을 지정합니다. 이 요소는 가상 컴퓨터에 둘 이상의 데이터 디스크가 연결된 경우에만 나열됩니다.

LogicalDiskSizeInGB

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

MediaLink

디스크와 연결된 VHD의 Azure 저장소에 위치를 지정합니다.

예:

http://example.blob.core.windows.net/disks/mydatadisk.vhd

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

 

요소 이름 설명

HostCaching

읽기/쓰기 효율성에 대한 운영 체제 디스크 Blob의 플랫폼 캐싱 동작을 지정합니다.

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

  • ReadOnly

  • ReadWrite

DiskName

이미지 리포지토리에 있는 운영 체제 이미지의 이름을 지정합니다.

MediaLink

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

SourceImageName

운영 체제 디스크를 만드는 데 사용된 원본 이미지의 이름을 지정합니다.

OS

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

구독에서 클라우드 서비스의 이름을 가져오려면 클라우드 서비스 나열을 사용합니다.

이 정보가 도움이 되었습니까?
(1500자 남음)
의견을 주셔서 감사합니다.
표시:
© 2014 Microsoft