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

배포 가져오기

업데이트 날짜: 2014년 10월

Get Deployment 작업은 배포의 구성 정보, 상태 및 시스템 속성을 반환합니다.

Get Deployment 요청을 사용하여 단일 배포 슬롯(스테이징 또는 프로덕션) 또는 특정 배포 이름에 대한 배포 이벤트를 검색할 수 있습니다. 배포 이름으로 정보를 검색하려는 경우 먼저 배포의 고유한 이름을 가져와야 합니다. 배포 슬롯의 배포를 가져오기 위한 요청을 수행하면 응답에 이 고유 이름이 포함됩니다.

예를 들어 프로덕션 환경에 배포된 클라우드 서비스가 있는 경우 …/deploymentslots/production에 대해 요청을 수행하여 고유 이름을 가져올 수 있습니다. 응답에는 클라우드 서비스에 대한 Name 요소가 포함됩니다. 특정 배포에 대한 정보를 검색하려는 경우 해당 Name 요소 값을 사용하여 …/deployments/<Name>에 대해 요청을 수행하면 됩니다.

요청 URI를 생성하려면 <subscription-id>를 구독 ID로 바꾸거나, <cloudservice-name>을 클라우드 서비스 이름으로 바꾸거나, <deployment-slot>staging 또는 production으로 바꾸거나, <deployment-name>을 배포 이름으로 바꾸십시오.

 

방법 요청 URI

GET

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

GET

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

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

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

 

요청 헤더 설명

x-ms-version

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

없음.

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

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

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

 

응답 헤더 설명

x-ms-request-id

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

다음 예에서는 응답 본문의 형식을 보여줍니다.


<?xml version="1.0" encoding="utf-8"?>
<Deployment xmlns="http://schemas.microsoft.com/windowsazure">
  <Name>name-of-deployment</Name>
  <DeploymentSlot>current-deployment-environment</DeploymentSlot>
  <PrivateID>identifier-of-deployment</PrivateID>
  <Status>status-of-deployment</Status>
  <Label>base64-encoded-name-of-deployment</Label>
  <Url>url-of-deployment</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>
      <ExtendedInstanceStatus>additional-status-details</ExtendedInstanceStatus>
      <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>
      <GuestAgentStatus>
        <ProtocolVersion>version-of-protocol</ProtocolVersion>
        <Timestamp>status-report-time</Timestamp>
        <GuestAgentVersion>version-of-agent</GuestAgentVersion>
        <Status>status-of-agent</Status>
        <FormattedMessage>
          <Language>language-of-message</Language>
          <Message>agent-message</Message>
        </FormattedMessage>
      </GuestAgentStatus>
      <ResourceExtensionStatusList>
        <ResourceExtensionStatus>
          <HandlerName>name-of-extension</HandlerName>
          <Version>version-of-extension</Version>
          <Status>status-of-extension</Status>
          <Code>status-code-of-extension</Code>
          <FormattedMessage>
            <Language>language-of-message</Language>
            <Message>extension-message</Message>
          </FormattedMessage>
          <ExtensionSettingStatus>
            <Timestamp>status-report-time</Timestamp>
            <Name>name-of-setting</Name>
            <Operation>operation-performed</Operation>
            <Status>status-of-setting</Status>
            <Code>status-code</Code>
            <FormattedMessage>
              <Language>language-of-status-message</Language>
              <Message>status-message</Message>
            </FormattedMessage>
            <SubStatusList>
              <SubStatus>
                <Name>name-of-substatus-object</Name>
                <Status>status-of-object</Status>
                <FormattedMessage>
                  <Language>language-of-message</Language>
                  <Message>status-message</Message>
                </FormattedMessage>
              </SubStatus>                   
            </SubStatusList>
          </ExtensionSettingStatus>
        </ResourceExtensionStatus>
      </ResourceExtensionStatusList>
      <PublicIPs>
        <PublicIP>
          <Name>name-of-public-ip</Name>
          <IdleTimeoutInMinutes>timeout-for-tcp-idle-connection</IdleTimeoutInMinutes>
        <PublicIP>
      <PublicIPs>
    </RoleInstance>
  </RoleInstanceList>
  <UpgradeStatus>
    <UpgradeType>type-of-upgrade</UpgradeType>
    <CurrentUpgradeDomainState>current-status-of-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>
              <LoadBalancerName>name-of-internal-loadbalancer</LoadBalancerName>
              <IdleTimeoutInMinutes>timeout-for-tcp-idle-connection</IdleTimeoutInMinutes>
              <Protocol>protocol-of-input-endpoint</Protocol>
              <Vip>virtual-ip-address-of-input-endpoint</Vip>
            </InputEndpoint>
          <InputEndpoints>
          <SubnetNames>
            <SubnetName>name-of-subnet</SubnetName>
          </SubnetNames>
          <StaticVirtualNetworkIPAddress>ip-address</StaticVirtualNetworkIPAddress>
        </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>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>
        <RemoteSourceImageLink>path-to-source-image</RemoteSourceImageLink>
      </OSVirtualHardDisk>
      <RoleSize>size-of-instance</RoleSize>
      <ProvisionGuestAgent>install-an-agent</ProvisionGuestAgent>
    </Role>
  </RoleList>
  <SdkVersion>sdk-version-used-to-create-package</SdkVersion>
  <Locked>status-of-deployment-write-allowed</Locked>
  <RollbackAllowed>rollback-operation-allowed</RollbackAllowed>
  <VirtualNetworkName>name-of-virtual-network</VirtualNetworkName>
  <Dns>
    <DnsServers>
      <DnsServer>
        <Name>name-of-dns-server</Name>
        <Address>address-of-dns-server</Address>
      </DnsServer>
    </DnsServers>
  </Dns>
  <LoadBalancers>
    <LoadBalancer>
      <Name>name-of-internal-load-balancer</Name>
      <FrontendIpConfiguration>
        <Type>type-of-ip-address</Type>
        <SubnetName>name-of-subnet</SubnetName>
        <StaticVirtualNetworkIPAddress>static-ip-address</StaticVirtualNetworkIPAddress>
      </FrontendIpConfiguration>
    </LoadBalancer>
  </LoadBalancers>
  <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>
      <IsReserved>indicator-of-ip-reservation</IsReserved>
      <ReservedIPName>name-of-reserved-ip</ReservedIpName>
      <Type>type-of-ip</Type>
    </VirtualIP>
  </VirtualIPs>
  <ExtensionConfiguration>
    <AllRoles>
      <Extension>
        <Id>identifier-of-extension</Id>
        <SequenceNumber>configuration-sequence</SequenceNumber>
        <State>state-of-extension</State>
      </Extension>
    </AllRoles>
    <NamedRoles>
      <Role>
        <RoleName>role_name1</RoleName>
        <Extensions>
          <Extension>
            <Id>identifier-of-extension</Id>
            <SequenceNumber>configuration-sequence</SequenceNumber>
            <State>state-of-extension</State>
          </Extension>
        </Extensions>
      </Role>
    </NamedRoles>
  </ExtensionConfiguration>
  <ReservedIPName>name-of-reserved-ip</ReservedIpName>
  <InternalDnsSuffix>dns-suffix</InternalDnsSuffix>
</Deployment>

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

 

요소 이름 설명

Name

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

DeploymentSlot

클라우드 서비스가 배포된 환경(staging 또는 production)을 지정합니다.

PrivateID

Azure에서 이 배포에 대해 내부적으로 생성된 고유 식별자를 지정합니다.

상태

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

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

  • 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

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

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

Locked

True이면 배포가 업데이트되는 동안 배포에 대해 새 쓰기 작업이 금지되고, 그렇지 않으면 false입니다.

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

RollbackAllowed

True이면 배포에 대해 RollbackDeploymentUpdateOrUpgrade 작업이 허용되고, 그렇지 않으면 false입니다.

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

CreatedTime

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

LastModifiedTime

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

VirtualNetworkName

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

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

Dns

배포에 대해 지정된 DNS 설정을 포함합니다.

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

LoadBalancers

입력 끝점에 할당할 수 있는 내부 부하 분산 장치의 목록을 포함합니다.

LoadBalancers 요소는 버전 2014-05-01 이후인 경우에만 사용할 수 있습니다.

ExtendedProperties

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

PersistentVMDowntime

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

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

VirtualIPs

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

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

ExtensionConfiguration

클라우드 서비스에 추가된 확장을 지정합니다. Azure에서는 프로세스가 클라우드 서비스의 확장으로 실행될 수 있습니다. 확장 추가를 사용하여 클라우드 서비스에 확장을 추가하고 업그레이드 배포 또는 Change Deployment Configuration을 사용하여 배포에 확장을 추가할 수 있습니다.

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

ReservedIPName

배포에 할당할 예약된 IP 주소의 이름을 지정합니다.

ReservedIPName 요소는 버전 2014-05-01 이후인 경우에만 사용할 수 있습니다.

InternalDnsSuffix

Azure에서 자동으로 할당하는 내부 이름 확인에 대한 도메인 이름 접미사를 지정합니다. 배포의 모든 가상 컴퓨터 인스턴스에 이 도메인 이름 접미사가 자동으로 할당됩니다. 또한 vmName 특성을 통해 컴퓨터 이름이 할당된 역할이 하나 이상 있는 경우 배포의 모든 웹 역할 또는 작업자 역할에 이 도메인 이름 접미사가 자동으로 할당됩니다. DNS 서버가 구성된 VNET에 있는 배포에는 내부 도메인 이름 접미사가 할당되지 않습니다. 자세한 내용은 이름 확인을 참조하십시오.

InternalDnsSuffix 요소는 버전 2013-11-01 이후인 경우에만 사용할 수 있습니다.

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

 

요소 이름 설명

RoleName

역할 이름을 지정합니다.

InstanceName

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

InstanceStatus

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

 

상태 메시지 설명

Unknown

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

CreatingVM

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

StartingVM

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

CreatingRole

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

StartingRole

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

ReadyRole

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

BusyRole

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

StoppingRole

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

StoppingVM

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

DeletingVM

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

StoppedVM

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

RestartingRole

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

CyclingRole

Azure에서 역할을 시작한 후 역할이 지속적으로 중단됨을 나타냅니다. 이 상태는 역할을 시작할 수 없게 하는 문제가 있음을 나타내며, StartingRole 이후 ReadyRole 상태가 수신된 경우에도 생성될 수 있습니다. 역할을 시작하려면 역할의 문제를 찾아 수정해야 합니다. InstanceStateDetailsInstanceErrorCode 필드에는 이 상태를 야기한 역할 오류에 대한 정보가 포함됩니다. 이 정보는 문제를 식별하고 디버깅하는 데 유용합니다. CyclingRole 요소는 버전이 2014-02-01 이하인 경우에만 반환됩니다.

FailedStartingRole

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

FailedStartingVM

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

UnresponsiveRole

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

StoppedDeallocated

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

Preparing

원격 원본 위치에서 Blob를 복사 중임을 나타냅니다. 이 상태는 버전이 2014-05-01 이상인 경우에만 반환됩니다.

ExtendedInstanceStatus

배포에 대해 사용할 수 있는 경우 추가 상태를 지정합니다. 원격 원본 위치에서 저장소 계정으로 Blob를 복사 중인 경우 이 요소의 값에는 복사된 Blob의 백분율이 포함됩니다.

ExtendedInstanceStatus 요소는 버전 2015-05-01 이후인 경우에만 사용할 수 있습니다.

InstanceUpgradeDomain

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

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

InstanceFaultDomain

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

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

InstanceSize

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

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

InstanceStateDetails

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

InstanceStateDetails 요소는 버전 2011-10-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 이후인 경우에만 사용할 수 있습니다.

GuestAgentStatus

인스턴스에 설치된 에이전트에 대한 정보를 지정합니다.

GuestAgentStatus 요소는 버전 2014-04-01 이후인 경우에만 사용할 수 있습니다.

ResourceExtensionStatusList

인스턴스에 설치된 확장에 대한 정보를 지정합니다.

ResourceExtensionStatusList 요소는 버전 2014-04-01 이후인 경우에만 사용할 수 있습니다.

PublicIPs

선택적 요소입니다. 가상 컴퓨터에 대해 기본 가상 IP 주소와 함께 사용할 수 있는 공용 IP 주소를 포함합니다.

PublicIPs 요소는 버전 2014-05-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

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

ProvisionGuestAgent

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

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

  • true

  • false

ResourceExtensionReferences

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

시스템 또는 응용 프로그램 데이터를 제공하는 개체 컬렉션을 포함합니다.

 

요소 이름 설명

ConfigurationSetType

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

InputEndpoints

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

SubnetNames

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

StaticVirtualNetworkIPAddress

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

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

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

 

요소 이름 설명

LoadBalancedEndpointSetName

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

LocalPort

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

Name

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

포트

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

LoadBalancerProbe

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

LoadBalancerName

선택적 요소입니다. 끝점과 연관된 내부 부하 분산 장치의 이름을 지정합니다. 내부 부하 분산 장치의 이름이 LoadBalancers에서 지정됩니다.

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

IdleTimeoutInMinutes

선택적 요소입니다. TCP 유휴 연결의 제한 시간을 지정합니다. 값은 4분에서 30분 사이로 설정할 수 있습니다. 기본값은 4분입니다. 이 요소는 프로토콜이 TCP로 설정된 경우에만 사용됩니다.

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

프로토콜

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

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

  • TCP

  • UDP

Vip

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

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

 

요소 이름 설명

Path

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

예:

path

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

포트

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

프로토콜

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

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

  • HTTP

  • TCP

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

 

요소 이름 설명

Name

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

Address

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

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

 

요소 이름 설명

Name

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

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

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

 

요소 이름 설명

StartTime

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

EndTime

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

상태

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

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

 

요소 이름 설명

Address

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

IsReserved

가상 IP 주소가 예약되었는지 여부를 나타냅니다.

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

  • true

  • false

ReservedIPName

배포에 할당되었던 예약된 IP 주소의 이름을 지정합니다.

Type

가상 IP 주소가 내부 부하 분산 장치와 연결된 경우 Private의 값을 지정합니다.

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

 

요소 이름 설명

SubnetName

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

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

 

요소 이름 설명

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

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

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

  • Windows

  • Linux

RemoteSourceImageLink

가상 컴퓨터를 만드는 데 사용된 OS 이미지가 저장된 위치로 URI를 지정합니다. 이 위치는 Azure 사용자 또는 플랫폼 리포지토리와는 다른 위치일 수 있습니다. 이미지는 항상 VHD(저장소 계정에 페이지 Blob으로 저장되는 .vhd 파일)와 연결됩니다. 이 요소가 포함된 이미지의 경로를 지정하는 경우 연결된 VHD가 생성되며 MediaLink 요소를 사용하여 VHD를 저장할 저장소의 위치를 지정해야 합니다. 이 요소를 사용하는 경우 SourceImageName은 사용되지 않습니다.

RemoteSourceImageLink 요소는 버전 2014-05-01 이후인 경우에만 사용할 수 있습니다.

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

 

요소 이름 설명

ResourceExtensionReference

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

ReferenceName

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

Publisher

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

Name

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

Version

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

ResourceExtensionParameterValues

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

State

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

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

  • Enable

  • Disable

기본값은 Enable입니다.

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

 

요소 이름 설명

ResourceExtensionParameterValue

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

Key

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

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

Type

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

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

  • Public

  • Private

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

클라우드 서비스에 추가된 확장을 포함합니다.

 

요소 이름 설명

AllRoles

배포의 모든 역할에 적용되는 확장 목록을 지정합니다.

Extension

클라우드 서비스의 역할에 배포될 확장을 지정합니다.

NamedRoles

배포의 특정 역할에 적용될 확장 목록을 지정합니다.

클라우드 서비스의 역할에 배포될 확장을 지정합니다.

 

요소 이름 설명

Id

확장의 식별자를 지정합니다. 클라우드 서비스에 확장을 추가할 때 ID가 생성됩니다. 확장 나열을 사용하여 클라우드 서비스에 추가된 확장의 ID를 찾을 수 있습니다.

SequenceNumber

확장에 마지막으로 적용된 구성의 번호를 지정합니다. 이 번호는 Azure에서 할당하며 구성이 변경될 때마다 증분됩니다.

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

State

선택적 요소입니다. 확장의 상태를 지정합니다. 이 요소는 JSON으로 구성된 확장에만 적용됩니다.

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

  • Enable

  • Disable

  • Uninstall

기본값은 Enable입니다.

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

배포의 특정 역할에 적용될 확장 목록을 지정합니다.

 

요소 이름 설명

역할

확장이 추가되는 특정 역할을 지정합니다.

RoleName

역할 이름을 지정합니다.

Extension

클라우드 서비스의 역할에 배포될 확장을 지정합니다.

인스턴스에 설치된 에이전트에 대한 정보를 지정합니다.

 

요소 이름 설명

ProtocolVersion

에이전트가 상태 보고에 사용하는 프로토콜의 버전을 지정합니다.

타임스탬프

상태가 보고된 UTC 시간을 지정합니다.

GuestAgentVersion

인스턴스에 설치된 에이전트의 버전을 지정합니다.

상태

에이전트의 상태를 지정합니다.

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

  • Ready

  • NotReady

FormattedMessage

지역화된 상태 메시지를 지정합니다.

지역화된 상태 메시지를 지정합니다.

 

요소 이름 설명

Language

메시지의 언어를 지정합니다.

메시지

메시지를 지정합니다.

인스턴스에 설치된 확장에 대한 정보를 지정합니다.

 

요소 이름 설명

ResourceExtensionStatus

특정 확장에 대한 정보를 지정합니다.

특정 확장에 대한 정보를 지정합니다.

 

요소 이름 설명

HandlerName

확장의 이름을 지정합니다.

Version

확장의 버전을 지정합니다.

상태

확장의 상태를 지정합니다.

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

  • Installing

  • Ready

  • NotReady

  • Unresponsive

코드

확장에서 반환되는 상태 코드를 지정합니다.

FormattedMessage

지역화된 상태 메시지를 지정합니다.

ExtensionSettingStatus

확장으로 전달된 설정에 대한 상태 정보를 지정합니다.

가상 컴퓨터에 대해 기본 가상 IP 주소와 함께 사용할 수 있는 공용 IP 주소를 포함합니다.

 

요소 이름 설명

PublicIP

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

Name

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

IdleTimeoutInMinutes

선택적 요소입니다. TCP 유휴 연결의 제한 시간을 지정합니다. 값은 4분에서 30분 사이로 설정할 수 있습니다. 기본값은 4분입니다. 이 요소는 프로토콜이 TCP로 설정된 경우에만 사용됩니다.

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

입력 끝점에 할당할 수 있는 내부 부하 분산 장치의 목록을 포함합니다.

 

요소 이름 설명

부하 분산 장치

필수 사항입니다. 내부 부하 분산 장치의 특성을 지정합니다.

Name

필수 사항입니다. 내부 부하 분산 장치의 이름을 지정합니다.

FrontendIpConfiguration

필수 사항입니다. 부하 분산 장치가 제공하는 가상 IP 주소의 구성을 지정합니다.

Type

필수 사항입니다. 부하 분산 장치가 제공하는 가상 IP 주소의 형식을 지정합니다. Private 값만 허용됩니다.

SubnetName

배포가 가상 네트워크에 있으며 StaticVirtualNetworkIPAddress가 할당된 경우 필수 사항입니다. 부하 분산 장치가 사용하는 가상 네트워크의 서브넷을 지정합니다. 부하 분산 장치가 관리하는 가상 IP 주소가 이 서브넷에 포함됩니다.

StaticVirtualNetworkIPAddress

선택적 요소입니다. 부하 분산 장치가 가상 네트워크의 서브넷에서 사용하는 특정 가상 IP 주소를 지정합니다.

확장으로 전달된 설정에 대한 상태 정보를 지정합니다.

 

요소 이름 설명

타임스탬프

상태가 보고된 UTC 시간을 지정합니다.

Name

확장으로 전달된 설정의 이름을 지정합니다.

작업

설정을 사용하여 확장에서 수행한 작업을 지정합니다.

상태

작업 상태를 지정합니다.

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

  • transitioning

  • error

  • success

  • warning

코드

작업의 상태 코드를 지정합니다.

FormattedMessage

지역화된 상태 메시지를 지정합니다.

SubStatusList

추가 상태 정보(있는 경우)의 목록을 포함합니다.

추가 상태 정보(있는 경우)의 목록을 포함합니다.

 

요소 이름 설명

SubStatus

확장이 반환하는 추가 상태 메시지에 대한 정보를 포함합니다.

Name

상태 식별자를 지정합니다.

상태

작업 상태를 지정합니다.

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

  • transitioning

  • error

  • success

  • warning

FormattedMessage

지역화된 상태 메시지를 지정합니다.

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

표시:
© 2014 Microsoft