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

BizTalk Services 만들기 또는 업데이트

업데이트 날짜: 2014년 5월

이 항목에서는 지정된 구독 및 클라우드 서비스에서 Службы BizTalk을 새로 만들거나 업데이트하는 방법을 설명합니다.

이 섹션에서는 Службы BizTalk 배포를 만들거나 업데이트하기 위한 요청 작업에 대해 설명합니다.

 

방법 요청 URI HTTP 버전

PUT

https://management.core.windows.net/{subscription-id}/cloudservices/{cloud-service-name}/resources/biztalkservices/biztalk/{resource-name}

여기서

  • subscription-id는 구독 ID입니다.

  • cloud-service-name은 BizTalk Services를 호스팅하는 클라우드 서비스의 고유한 이름입니다. 이름의 길이는 최대 64자입니다.

  • resource-name은 Службы BizTalk 구독의 이름입니다. 이 이름은 6~20자 사이의 고유한 이름이어야 합니다.

HTTP/1.1

 

헤더 설명

Content-Type

필수 사항입니다. application/xml로 설정합니다.

x-ms-version

필수 사항입니다. 이 요청에 사용할 작업의 버전을 지정합니다. 이 헤더의 값은 01.08.12 이후로 설정해야 합니다.

x-ms-client-request-id

선택적 요소입니다. 요청을 식별하는 ID를 지정합니다. 전반적인 클라이언트 문제를 해결하는 데 유용할 수 있으며, Службы BizTalk 리소스 공급자로 전달됩니다.

If-Match

만들기 작업의 경우에는 옵션이지만 업데이트 작업의 경우에는 필수입니다. 업데이트 작업용으로 이 헤더에 Etag 값이 전달되면 에서는 이 값이 리소스의 Etag와 일치하는지 확인합니다.

PUT https://management.core.windows.net/<subscription-id>/cloudservices/mycloudservice1/resources/biztalkservices/biztalk/mybiztalkservice HTTP/1.1
Content-Type: application/xml; charset=utf-8 
x-ms-version: 2013-04-26
If-Match: <Etag>

<Resource xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <SchemaVersion>1.0</SchemaVersion>
  <Plan></Plan>
  <IntrinsicSettings>
    <ServiceSettings>
      <CustomDomainUrl>example.com</CustomDomainUrl>
      <ServiceVersion>1.1.0</ServiceVersion>
      <Edition>premium</Edition>
      <UnitCount>1</UnitCount>
      <ServiceCertificate>
        <Data>{certificate-in-serialized-form}</Data>
        <Password>{password}</Password>
      </ServiceCertificate>

<TrackingStoreConnectionString>Data Source=tcp:databaseservername.database.windows.net;Initial Catalog=databasename;Integrated Security=False;User ID=user1@databaseservername;Password=mypassword;Asynchronous Processing=True;Encrypt=True;TrustServerCertificate=False</TrackingStoreConnectionString>
<ArchivingStoreConnectionString>BlobEndpoint=blobendpoint;QueueEndpoint=queueendpoint;TableEndpoint=tableendpoint;AccountName=accountname;AccountKey=accountkey;DefaultEndpointsProtocol=https</ArchivingStoreConnectionString>
<MonitoringStoreConnectionString>BlobEndpoint=blobendpoint;QueueEndpoint=queueendpoint;TableEndpoint=tableendpoint;AccountName=accountname;AccountKey=accountkey;DefaultEndpointsProtocol=https</MonitoringStoreConnectionString>
      <ServiceAcsParameters>
        <Namespace>acssample</Namespace>
        <ManagementUserName>user</ManagementUserName>
        <ManagementPassword>password</ManagementPassword>
      </ServiceAcsParameters> 
    </ServiceSettings>
  </IntrinsicSettings>
</Resource> 

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

Important중요
Службы BizTalk Free 버전의 경우에는 ServiceVersion, EditionUnitCount 요소만 있으면 됩니다.

 

요소 이름 설명

SchemaVersion

내부 설정의 스키마 버전입니다. 1.0으로 설정합니다.

계획

필수 사항입니다. 이 요소는 비워 둡니다.

IntrinsicSettings(Службы BizTalk 프로비전 또는 구성에 사용되는 설정)

CustomDomainUrl

선택적 요소입니다. 메시지 처리용 사용자 지정 끝점을 나타내며 길이는 256자 이하여야 합니다. 값을 제공하지 않으면 <BizTalkServiceName>.biztalk.windows.net으로 설정됩니다.

ServiceVersion

필수 사항입니다. BizTalk Services의 주 버전과 부 버전을 나타냅니다.

1.1.0으로 설정합니다.

버전

필수 사항입니다. Службы BizTalk의 버전을 나타냅니다. Basic, Standard, Developer, Premium 또는 Free로 설정합니다. 이 값은 대/소문자를 구분합니다.

UnitCount

필수 사항입니다. Службы BizTalk을 배포하는 단위 수를 나타냅니다. 각 버전에 대한 자세한 내용은 BizTalk Services: Developer, Basic, Standard 및 Premium Edition 차트를 참조하십시오.

ServiceCertificate/Data

선택적 요소입니다. 직렬화된 형식의 Службы BizTalk 인증서(.pfx 형식)를 나타냅니다.

ServiceCertificate/Password

선택적 요소입니다. Службы BizTalk 인증서 개인 키 암호를 나타냅니다.

TrackingStoreConnectionString

필수 사항입니다. Службы BizTalk에서 추적 레코드를 쓰는 데 사용하는 Microsoft Azure SQL 데이터베이스 연결 문자열을 나타냅니다. 지정한 데이터베이스가 Службы BizTalk 리소스와 같은 영역에 이미 포함되어 있어야 합니다.

MonitoringStoreConnectionString

필수 사항입니다. Службы BizTalk에서 모니터링 레코드를 쓰는 데 사용하는 저장소 연결 문자열을 나타냅니다. 지정한 저장소 계정이 Службы BizTalk 리소스와 같은 영역에 이미 포함되어 있어야 합니다.

ArchivingStoreConnectionString

선택적 요소입니다. Службы BizTalk에서 보관 레코드를 쓰는 데 사용하는 저장소 연결 문자열을 나타냅니다(버전에서 지원하는 경우). 지정한 저장소 계정이 Службы BizTalk 리소스와 같은 영역에 이미 포함되어 있어야 합니다.

ServiceAcsParameters/Namespace

선택적 요소입니다. Службы BizTalk을 신뢰 당사자로 구성하는 데 사용하는 ACS 네임스페이스를 나타냅니다. 지정한 ACS 네임스페이스는 Службы BizTalk과 같은 영역에 있어야 합니다.

ServiceAcsParameters/ManagementUserName

선택적 요소입니다. 지정한 ACS 네임스페이스의 관리 사용자를 나타냅니다.

ServiceAcsParameters/ManagementPassword

선택적 요소입니다. 지정한 ACS 네임스페이스의 관리 사용자 암호를 나타냅니다.

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

작업에 성공하면 상태 코드 202(ACCEPTED)가 반환됩니다.

상태 코드에 대한 자세한 내용은 서비스 관리 상태 및 오류 코드를 참조하십시오.

 

헤더 설명

Content-Type

콘텐츠 유형을 지정합니다.

x-ms-request-id

응용 프로그램 서비스에 대해 수행된 요청을 고유하게 식별하는 값입니다.

ETag

리소스가 정상적으로 변경되면 서비스 관리자가 리소스 수정을 식별할 수 있도록 값이 증가하는 고유 ETag를 반환합니다.

없음.

오류 응답이 반환되는 경우 응답 본문의 형식은 서비스 관리 상태 및 오류 코드에 나와 있는 것과 같습니다.

이 섹션에서는 Службы BizTalk에 대해 만들기 또는 업데이트 작업을 수행하는 중에 발생할 수 있는 오류 코드를 소개합니다.

 

오류 코드 오류 문자열 설명

CustomDomainInvalid

사용자 지정 도메인 URL 유효성 검사가 실패했습니다. 사용자 지정 도메인 URL의 길이는 256자 이하여야 합니다.

지정한 값이 기준을 충족하지 않아 사용자 지정 도메인 URL 유효성 검사가 실패했습니다.

ServiceVersionUnsupported

지정한 서비스 버전이 지원되지 않습니다.

-

ServiceVersionFormatUnsupported

지정한 서비스 버전은 올바른 형식이 아닙니다.

지정한 버전이 올바른 형식이 아닙니다. 올바른 형식은 1.1.1, 1.2.1, 1.1.2, 2.1.1 등이어야 합니다.

EditionUnsupported

지정한 버전이 지원되지 않습니다.

유효한 버전 이름을 지정하지 않았습니다. 버전에 대한 자세한 내용은 BizTalk Services: Developer, Basic, Standard 및 Premium Edition 차트를 참조하십시오.

UnitCountNotAllowed

지정한 단위 개수는 해당 BizTalk Services 버전에 사용할 수 없습니다.

지정한 단위 개수가 양의 정수가 아니거나 지정된 버전의 최소값/최대값 범위 내에 포함되지 않습니다. 자세한 내용은 BizTalk Services: Developer, Basic, Standard 및 Premium Edition 차트를 참조하십시오.

InvalidServiceCertificateDetails

지정한 서비스 인증서가 요구 사항을 충족하지 않습니다. 인증서 데이터가 올바른 형식의 .pfx를 나타내지 않거나 지정한 암호가 지정된 인증서에 대해 올바르지 않습니다.

-

InvalidTrackingStore

지정된 추적 저장소가 잘못되었습니다. 추적 저장소가 있으며 제공한 연결 문자열이 올바른지 확인하십시오. 또한 비동기 처리 플래그가 true로 설정되어 있는지 확인하십시오.

-

InvalidArchivingStore

지정된 보관 저장소가 잘못되었습니다. 저장소가 있으며 제공한 연결 문자열이 올바른지 확인하십시오.

-

InvalidMonitoringStore

지정된 모니터링/보관 저장소가 잘못되었습니다. 저장소가 있으며 제공한 연결 문자열이 올바른지 확인하십시오.

-

InvalidServiceAcsNamespace

지정한 자격 증명을 사용하여 ACS 계정에 연결할 수 없습니다. 지정한 자격 증명과 네임스페이스가 올바른지 확인하십시오.

-

UpdateSettingsNotAllowed

업데이트하지 못했습니다. 지정한 서비스 설정 중 하나 이상이 업데이트에서 허용되지 않습니다. 제품 설명서에서 허용되는 값 및 업데이트 가능한 설정을 참조하십시오.

다음 항목을 업데이트하려고 하면 이 오류가 발생할 수 있습니다.

  • CustomDomainUrl의 경우 - 지정한 URL이 Службы BizTalk을 만드는 중에 지정한 URL과 다릅니다.

  • Edition의 경우 – 지정한 버전이 올바르지 않습니다.

  • TrackingStoreConnectionString의 경우 - 업데이트 작업의 일부분으로 암호 이외의 모든 항목이 변경되었습니다.

  • ServiecAcsParameters의 경우 - ACS 매개 변수(Namespace, ManagementUserName 또는 ManagementPassword)가 변경되었습니다.

참고 항목

Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2014 Microsoft