Экспорт (0) Печать
Развернуть все
Развернуть Свернуть

Создание или обновление службы BizTalk

Обновлено: Май 2014 г.

В этой статье показывается, как можно создать или обновить новую Службы BizTalk в указанной подписке или облачной службе.

В этом разделе рассматривается операция запроса на создание или обновление развертывания Службы BizTalk.

 

Метод URI запроса Версия HTTP

PUT

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

Здесь

  • subscription-id — это идентификатор вашей подписки ;

  • cloud-service-name — уникальное имя облачной службы, в которой размещена ваша служба BizTalk, которое может иметь длину до 64 символов;

  • resource-name — имя подписки Службы BizTalk, которое должно быть уникальным и иметь длину от 6 до 20 символов.

HTTP/1.1

 

Заголовок Описание

Content-Type

Обязательно. Задайте для этого заголовка значение application/xml.

x-ms-version

Обязательно. Задает версию операции, используемой для этого запроса. У этого заголовка должно быть значение 2012-08-01 или более позднее.

x-ms-client-request-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, Edition и UnitCount.

 

Имя элемента Описание

SchemaVersion

Версия схемы встроенных параметров. Задайте значение 1.0.

План

Обязательно. Оставьте этот элемент пустым.

IntrinsicSettings (параметры, используемые для подготовки или настройки Службы BizTalk)

CustomDomainUrl

Необязательно. Представляет настраиваемую конечную точку для обработки сообщений; длина этого элемента не должна превышать 256 символов. Если значение не предоставлено, то устанавливается значение <Имя_службы_BizTalk>.biztalk.windows.net.

ServiceVersion

Обязательно. Представляет основной и дополнительный номер версии службы BizTalk.

Задайте значение 1.1.0.

Выпуск

Обязательно. Представляет выпуск Службы BizTalk. Установите значение Basic, Standard, Developer, Premium или Free. В этих значениях учитывается регистр.

UnitCount

Обязательно. Представляет число единиц, с которыми разворачивается Службы BizTalk. Сведения о каждом выпуске см. в статье Службы BizTalk. Схема выпусков.

ServiceCertificate/Data

Необязательно. Представляет сертификат Службы BizTalk (в формате PFX) в сериализованной форме.

ServiceCertificate/Password

Необязательно. Представляет пароль для закрытого ключа сертификата Службы BizTalk.

TrackingStoreConnectionString

Обязательно. Представляет сроку подключения к База данных SQL Microsoft Azure, которую Службы BizTalk использует для регистрации записей отслеживания. Указанная база данных должна уже существовать и находиться в одном регионе с ресурсом Службы BizTalk.

MonitoringStoreConnectionString

Обязательно. Представляет сроку подключения к хранилищу , которую Службы BizTalk использует для регистрации в этом хранилище записей мониторинга. Указанная учетная запись хранилища должна уже существовать и находиться в одном регионе с ресурсом Службы BizTalk.

ArchivingStoreConnectionString

Необязательно. Представляет строку подключения к хранилищу , которую Службы BizTalk использует для регистрации в этом хранилище записей архивирования (если это поддерживается в текущем выпуске). Указанная учетная запись хранилища должна уже существовать и находиться в одном регионе с ресурсом Службы BizTalk.

ServiceAcsParameters/Namespace

Необязательно. Представляет пространство имен ACS, с которым Службы BizTalk настраивается в качестве отвечающей стороны. Указанное пространство имен ACS должно находиться в одном регионе с Службы BizTalk.

ServiceAcsParameters/ManagementUserName

Необязательно. Представляет администратора указанного пространства имен ACS.

ServiceAcsParameters/ManagementPassword

Необязательно. Представляет пароль администратора указанного пространства имен ACS.

Ответ включает код состояния HTTP, набор заголовков ответа и текст ответа.

Успешная операция возвращает код состояния 202 (ПРИНЯТО).

Дополнительные сведения о кодах состояния см. в разделе Состояния и коды ошибок управления службами.

 

Заголовок Описание

Content-Type

Указывает тип содержимого.

x-ms-request-id

Значение, которое однозначно идентифицирует запрос к службе приложения.

ETag

При успешных изменениях ресурса Service Manager возвращает уникальный увеличенный ETag для идентификации версии ресурса.

Отсутствует.

Если это ответ с ошибкой, то формат текста ответа соответствует показанному в статье Коды состояний и ошибок управления службами.

В этом разделе приведены коды ошибок, которые могут возникнуть при выполнении операций создания или обновления для Службы BizTalk.

 

Код ошибки Строка ошибки Описание

CustomDomainInvalid

Сбой проверки URL-адреса пользовательского домена. URL-адрес пользовательского домена должен иметь длину не более 256 знаков.

Произошел сбой проверки URL-адреса пользовательского домена, поскольку указанное значение нарушает это условие.

ServiceVersionUnsupported

Указанная версия службы не поддерживается.

-

ServiceVersionFormatUnsupported

Указанная версия службы имеет неправильный формат

Указанная версия службы имеет неправильный формат Правильный формат должен быть следующим: 1.1.1, 1.2.1, 1.1.2 или 2.1.1

EditionUnsupported

Указанный выпуск не поддерживается.

Указано неправильное имя выпуска. Дополнительные сведения о выпусках см. в статье Службы BizTalk. Схема выпусков.

UnitCountNotAllowed

Указанное число единиц не разрешено для этого выпуска служб BizTalk.

Указанное число единиц не является положительным целым числом или не попадает в разрешенный диапазон для указанной версии. Дополнительные сведения см. в статье Службы BizTalk. Схема выпусков.

InvalidServiceCertificateDetails

Указанный сертификат службы не соответствует требованиям. Данные сертификата не представляют правильно сформированный PFX-файл или указан неправильный пароль для этого сертификата.

-

InvalidTrackingStore

Недопустимое хранилище данных отслеживания. Убедитесь, что хранилище данных отслеживания существует, и проверьте правильность предоставленной строки подключения. Проверьте, установлен ли флаг асинхронной обработки в значение true.

-

InvalidArchivingStore

Недопустимое хранилище данных архивирования. Убедитесь, что хранилище существует, и проверьте правильность предоставленной строки подключения.

-

InvalidMonitoringStore

Недопустимое хранилище данных архивирования/мониторинга. Убедитесь, что хранилище существует, и проверьте правильность предоставленной строки подключения.

-

InvalidServiceAcsNamespace

Не удается подключиться к учетной записи ACS м указанными учетными данными. Проверьте правильность указанных учетных данных и пространства имен.

-

UpdateSettingsNotAllowed

Сбой обновления. По крайней мере один из указанных параметров службы не разрешен для операции обновления. Разрешенные значения и обновляемые параметры см. в документации по продукту.

Эта ошибка может появиться в результате попытки обновления следующих объектов.

  • Для CustomDomainUrl — указанный URL-адрес отличается от указанного при создании Службы BizTalk.

  • Для Edition — указан неправильный выпуск.

  • Для TrackingStoreConnectionString — в рамках операции обновления изменяется все, кроме пароля.

  • Для ServiecAcsParameters — изменяется какой-либо из параметров ACS (Namespace, ManagementUserName или ManagementPassword).

См. также

Показ:
© 2014 Microsoft