클라우드 서비스 만들기

아티클
07/19/2023

Create Cloud Service 비동기 작업은 Microsoft Azure에서 새 클라우드 서비스를 만듭니다.

요청

다음과 같이 Create Cloud Service 요청을 지정합니다. <subscription-id>는 구독 ID로 바꿉니다.

메서드	요청 URI
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices`

URI 매개 변수

없음

요청 헤더

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

요청 헤더	Description
`Content-Type`	필수 요소. 이 헤더를 `application/xml`로 설정합니다.
`x-ms-version`	필수 요소. 이 요청에 사용할 작업의 버전을 지정합니다. 이 헤더의 값은 이상으로 설정 `2010-10-28` 해야 합니다.

요청 본문

요청 본문의 형식은 다음과 같습니다.

<?xml version="1.0" encoding="utf-8"?>  
<CreateHostedService xmlns="http://schemas.microsoft.com/windowsazure">  
  <ServiceName>name-of-cloud-service</ServiceName>  
  <Label>base64-encoded-label-of-cloud-service</Label>  
  <Description>description-of-cloud-service</Description>  
  <Location>location-of-cloud-service</Location>  
  <AffinityGroup>name-of-affinity-group</AffinityGroup>  
  <ExtendedProperties>  
    <ExtendedProperty>  
      <Name>name-of-property</Name>  
      <Value>value-of-property</Value>  
    </ExtendedProperty>  
  </ExtendedProperties>  
  <ReverseDnsFqdn>reverse-dns-fqdn</ReverseDnsFqdn>  
</CreateHostedService>

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

요소 이름	설명
ServiceName	필수 요소. 클라우드 서비스의 이름을 지정합니다. 이 이름은 Azure 내에서 고유해야 합니다. 이 이름은 DNS 접두사 이름이며 서비스에 액세스하는 데 사용됩니다. 이름의 가용성을 확인하려면 클라우드 서비스 이름 가용성 확인을 사용할 수 있습니다.
레이블	필수 요소. Base-64로 인코딩된 클라우드 서비스의 식별자를 지정합니다. 식별자는 최대 100자까지 지정할 수 있습니다. 레이블은 추적용으로 사용할 수 있습니다.
설명	선택 사항입니다. 클라우드 서비스의 설명을 지정합니다. 설명은 최대 1024자까지 입력할 수 있습니다.
위치	`AffinityGroup`이 지정되지 않은 경우 필수 사항입니다. 클라우드 서비스가 생성되는 위치를 지정합니다. `Location` 또는 `AffinityGroup` 중 하나만 지정해야 합니다. 사용 가능한 위치를 보려면 목록 위치를 사용할 수 있습니다.
AffinityGroup	`Location`이 지정되지 않은 경우 필수 사항입니다. 구독에 연결된 기존 선호도 그룹의 이름을 지정합니다. `Location` 또는 `AffinityGroup` 중 하나만 지정해야 합니다. 사용 가능한 선호도 그룹을 보려면 선호도 그룹 나열을 사용할 수 있습니다.
Name	(선택 사항) 확장 클라우드 서비스 속성의 이름을 지정합니다. 이름은 최대 64자일 수 있으며, 영숫자와 밑줄만 포함할 수 있으며, 문자로 시작해야 합니다. 각 확장 속성에는 정의된 이름과 값이 모두 있어야 합니다. 확장 속성은 50개까지 정의할 수 있습니다. `Name` 요소는 버전 01.03.12 이후인 경우에만 사용할 수 있습니다.
값	선택 사항입니다. 확장 클라우드 서비스 속성의 값을 지정합니다. 확장 속성 값은 255자까지 가능합니다. `Value` 요소는 버전 01.03.12 이후인 경우에만 사용할 수 있습니다.
ReverseDnsFqdn	선택 사항입니다. 역방향 DNS 쿼리를 사용하여 쿼리할 때 클라우드 서비스의 IP 주소가 확인될 DNS 주소를 지정합니다. 요소는 `ReverseDnsFqdn` 버전 2014-06-01 이상을 사용하는 경우에만 사용할 수 있습니다.

응답

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

상태 코드

작업에 성공하면 상태 코드 201(만들어짐)이 반환됩니다.

응답 헤더

이 작업의 응답에는 다음과 같은 헤더가 포함됩니다. 응답에는 추가 표준 HTTP 헤더가 포함될 수도 있습니다.

응답 헤더	설명
`x-ms-request-id`	관리 서비스에 대해 수행된 요청을 고유하게 식별하는 값입니다. 비동기 작업의 경우 헤더 값으로 작업 상태 가져오기 를 호출하여 작업이 완료되었는지, 실패했는지 또는 아직 진행 중인지 확인할 수 있습니다.

응답 본문

없음

다음을 통해 공유