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

선호도 그룹 속성 가져오기

업데이트 날짜: 2015년 4월

Get Affinity Group Properties 작업은 지정된 선호도 그룹에 연결된 시스템 속성을 반환합니다. 선호도 그룹 나열을 사용하여 선호도 그룹 목록을 가져올 수 있습니다.

다음과 같이 Get Affinity Group Properties 요청을 지정할 수 있습니다. <subscription-id>를 구독 ID로 바꾸고, <affinity-group-name>을 선호도 그룹의 이름으로 바꾸십시오.

 

방법 요청 URI

GET

https://management.core.windows.net/<subscription-id>/affinitygroups/<affinity-group-name>

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

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

 

요청 헤더 설명

x-ms-version

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

없음.

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

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

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

 

응답 헤더 설명

x-ms-request-id

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

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


<?xml version="1.0" encoding="utf-8"?>
<AffinityGroup xmlns="http://schemas.microsoft.com/windowsazure">
  <Name>name-of-affinity-group</Name>
  <Label>base64-encoded-label</Label>
  <Description>description</Description>
  <Location>location</Location>  
  <HostedServices>
    <HostedService>
      <Url>hosted-service-address</Url>
      <ServiceName>hosted-service-name</ServiceName>
    </HostedService>
  </HostedServices>
  <StorageServices>
    <StorageService>
      <Url>storage-account-address</Url>
      <ServiceName>storage-account-name</ServiceName>
    </StorageService>
  </StorageServices>
  <Capabilities>
    <Capability>affinity-group-capability</Capability>
  </Capabilities>
  <CreatedTime>creation-time-of-affinity-group</CreatedTime>
</AffinityGroup>  

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

 

요소 이름 설명

Name

선호도 그룹의 사용자 이름을 지정합니다.

Label

Base-64로 인코딩된 선호도 그룹의 식별자를 지정합니다.

설명

이 선호도 그룹의 설명을 지정합니다.

위치

선호도 그룹이 연결된 데이터 센터의 위치를 지정합니다.

Url

선호도 그룹과 연결된 클라우드 서비스의 URL입니다.

ServiceName

선호도 그룹과 연결된 클라우드 서비스의 이름입니다.

Url

선호도 그룹과 연결된 저장소 계정의 URL입니다.

ServiceName

선호도 그룹과 연결된 저장소 계정의 이름입니다.

Capability

선호도 그룹의 기능을 지정합니다.

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

  • PersistentVMRole

  • HighMemory

선호도 그룹의 기능은 일반적으로 그 위치에서 파생됩니다. 선호도 그룹을 지원하는 데 할당된 특정 리소스 집합이 기능을 지원하지 않는 경우(예: 고용량 가상 컴퓨터) 선호도 그룹은 기능 중 일부만 표시할 수 있습니다. PersistentVMRole 기능을 사용하면 선호도 그룹이 가상 컴퓨터를 지원할 수 있습니다. HighMemory 기능을 사용하면 선호도 그룹이 CPU 수에 비해 고용량 메모리를 사용하는 가상 컴퓨터를 지원할 수 있습니다. 가상 컴퓨터 크기에 자세한 내용은 Azure의 가상 컴퓨터 및 클라우드 서비스 크기를 참조하십시오.

CreatedTime

선호도 그룹을 만든 시간을 UTC 형식으로 지정합니다.

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

선호도 그룹 관리를 위해 다음과 같은 리소스를 사용할 수도 있습니다.

표시:
© 2015 Microsoft