영업: 1-800-867-1380

확장 추가

업데이트 날짜: 2014년 4월

Add Extension 작업은 사용 가능한 확장을 클라우드 서비스에 추가합니다. Windows Azure에서는 프로세스가 클라우드 서비스의 확장으로 실행될 수 있습니다. 예를 들어 원격 데스크톱 액세스 또는 Windows Azure 진단 에이전트가 클라우드 서비스의 확장으로 실행될 수 있습니다. 사용 가능한 확장 나열 작업을 사용하여 사용 가능한 확장을 찾을 수 있습니다.

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

 

메서드 요청 URI HTTP 버전

POST

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

HTTP/1.1

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

 

요청 헤더 설명

x-ms-version

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

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


<?xml version="1.0" encoding="utf-8"?>
<Extension xmlns=”http://schemas.microsoft.com/windowsazure”>
  <ProviderNameSpace>namespace-of-extension</ProviderNameSpace>
  <Type>type-of-extension</Type>
  <Id>identifier-of-extension</Id>
  <Thumbprint>thumbprint-of-encryption-certificate</Thumbprint>
  <ThumbprintAlgorithm>thumbprint-algorithm</ThumbprintAlgorithm>
  <PublicConfiguration>base-64-encoded-xsd-for-extension-public-configuration</PublicConfiguration>
  <PrivateConfiguration>base-64-encoded-xsd-for-extension-private-configuration</PrivateConfiguration>
  <Version>version-of-extension</Version>
</Extension>
Important중요
요청 본문에서 요소의 순서는 매우 중요합니다. 요소가 필요한 경우 위에 표시된 순서대로 XML에 표시되어야 합니다.

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

 

요소 이름 설명

필수 사항입니다. ProviderNameSpace

확장의 공급자 네임스페이스를 지정합니다. Windows Azure 확장의 공급자 네임스페이스는 Microsoft.Windows.Azure.Extensions입니다.

Type

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

Id

필수 사항입니다. 확장의 식별자를 지정합니다.

Thumbprint

선택 사항입니다. PrivateConfiguration에 지정된 구성을 암호화하는 데 사용되는 인증서의 지문을 지정합니다. 이 요소를 지정하지 않으면 인증서가 자동으로 생성되어 클라우드 서비스에 추가될 수 있습니다.

ThumbprintAlgorithm

선택 사항입니다. PrivateConfiguration에 지정된 구성을 암호화하는 데 사용되는 인증서의 지문 알고리즘을 지정합니다.

PublicConfiguration

선택 사항입니다. 사용 가능한 확장 나열 작업에서 반환되는 스키마를 사용하여 정의되는 공개 구성을 지정합니다.

PrivateConfiguration

선택 사항입니다. 사용 가능한 확장 나열 작업에서 반환되는 스키마를 사용하여 정의되는 개인 구성을 지정합니다.

Version

선택 사항입니다. 확장의 버전을 지정합니다. 이 요소를 지정하지 않거나 별표(*)를 값으로 사용하면 최신 버전의 확장이 사용됩니다. 주 버전 번호와 별표(부 버전 번호)로 값(X.*)을 지정하면 지정된 주 버전의 최신 부 버전이 선택됩니다. 주 버전 번호와 부 버전 번호(X.Y)를 지정하는 경우에는 특정 확장 버전이 선택됩니다. 버전을 지정하면 역할 인스턴스에서 자동 업그레이드가 수행됩니다.

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

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

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

 

응답 헤더 설명

x-ms-request-id

관리 서비스에 대해 수행된 요청을 고유하게 식별하는 값입니다. 비동기 작업의 경우 헤더 값과 함께 작업 상태 가져오기를 호출하여 작업이 완료되었는지, 실패했는지, 계속 진행 중인지 여부를 확인할 수 있습니다. 자세한 내용은 비동기 서비스 관리 요청 추적을 참조하십시오.

<subscription-id>로 지정된 구독에 연결된 관리 인증서를 사용하여 이 작업을 인증할 수 있습니다. 자세한 내용은 서비스 관리 요청 인증을 참조하십시오.

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