Exportar (0) Imprimir
Expandir Tudo

Criar ou Atualizar um Serviço BizTalk

Atualizado: maio de 2014

Este tópico fornece informação sobre como criar/atualizar um novo Serviços do BizTalk numa assinatura especificada e num serviço de nuvem.

Esta seção fornece informações sobre a operação de solicitação para cria ou atualizar a implantação do Serviços do BizTalk.

 

Método URI de solicitação Versão de HTTP

PUT

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

em que,

  • subscription-id é o seu ID de assinatura do Azure

  • cloud-service-name é o nome exclusivo do serviço de nuvem que hospeda seu Serviço BizTalk. O nome pode ter até 64 caracteres.

  • resource-name é o nome único da assinatura de Serviços do BizTalk. O nome deve ser exclusivo e deve variar entre 6 e 20 caracteres de comprimento.

HTTP/1.1

 

Cabeçalho Descrição

Content-Type

Obrigatório. Defina isto como application/xml.

x-ms-version

Obrigatório. Especifica a versão da operação a ser usada para esta solicitação. O valor deste cabeçalho deve ser definido como 01.08.12 ou posterior.

x-ms-client-request-id

Opcional. Especifica um ID para identificar a solicitação. Isso pode ser útil na resolução de problemas de ponta a ponta de clientes e é passado ao provedor de recursos dos Serviços do BizTalk.

If-Match

Opcional para a operação de criação mas necessário para uma operação de atualização. Se um valor de Etag for passado para este cabeçalho para uma operação de atualização, o Azure corresponderá ao valor do Etag para o recurso.

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> 

A tabela a seguir descreve os principais elementos no corpo da solicitação.

ImportantImportante
Para uma edição do Serviços do BizTalk Gratuito, apenas são necessários os elementos ServiceVersion, Edition e UnitCount.

 

Nome de elemento Descrição

SchemaVersion

A versão do esquema das configurações intrínsecas. Defina isto para 1.0.

Plano

Obrigatório. Deixe este elemento vazio.

IntrinsicSettings (Configurações usadas para fornecer ou configurar o Serviços do BizTalk)

CustomDomainUrl

Opcional. Isto representa um ponto de extremidade personalizado para processamento de mensagem e não deveria ter de mais de 256 caracteres de comprimento. Se nenhum valor for fornecido, este é definido para <BizTalkServiceName>.biztalk.windows.net.

ServiceVersion

Obrigatório. Representa a versão maior e menor do Serviço BizTalk.

Defina isto para 1.1.0.

Edição

Obrigatório. Representa a edição do Serviços do BizTalk. Defina isto para Basic, Standard, Developer, Premium ou Gratuito. Esses valores diferenciam maiúsculas de minúsculas.

UnitCount

Obrigatório. Representa o número de unidades com que o Serviços do BizTalk é implantado. Consulte Serviços BizTalk: Gráfico de Edições Developer, Basic, Standard e Premium para mais detalhes sobre cada edição.

ServiceCertificate/Data

Opcional. Representa o certificado de Serviços do BizTalk (formato .pfx.) num formato serializado.

ServiceCertificate/Password

Opcional. Representa a senha da chave privada do certificado do Serviços do BizTalk.

TrackingStoreConnectionString

Obrigatório. Representa uma cadeia de caracteres da conexão Banco de dados SQL do Microsoft Azure que o Serviços do BizTalk usa para gravar os registros de rastreamento. O banco de dados especificado já deve existir e deve estar na mesma região que o recurso Serviços do BizTalk.

MonitoringStoreConnectionString

Obrigatório. Representa uma cadeia de caracteres da conexão de armazenamento do Azure que o Serviços do BizTalk usa para gravar os registros de acompanhamento. A conta de armazenamento especificada já deve existir e deve estar na mesma região que o recurso Serviços do BizTalk.

ArchivingStoreConnectionString

Opcional. Representa a cadeia de caracteres de conexão de armazenamento do Azure que o Serviços do BizTalk usa para gravar os registros de arquivo (se a edição o suportar). A conta de armazenamento especificada já deve existir e deve estar na mesma região que o recurso Serviços do BizTalk.

ServiceAcsParameters/Namespace

Opcional. Representa o namespace do ACS com o qual o Serviços do BizTalk é configurado como a terceira parte confiável. O namespace do ACS especificado deve estar na mesma região que o Serviços do BizTalk.

ServiceAcsParameters/ManagementUserName

Opcional. Representa o usuário de gerenciamento do namespace do ACS especificado.

ServiceAcsParameters/ManagementPassword

Opcional. Representa a senha do usuário de gerenciamento do namespace do ACS especificado.

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Uma operação bem-sucedida retorna o código de status 202 (ACEITO).

Para obter informações sobre códigos de status, consulte Status e códigos de erro de gerenciamento de serviços.

 

Cabeçalho Descrição

Content-Type

Especifica o tipo de conteúdo.

x-ms-request-id

Um valor que identifica, de maneira exclusiva, uma solicitação feita no serviço do aplicativo.

ETag

Em mutações bem-sucedidas ao recurso, o Gerenciador de Serviços retorna um ETag crescente exclusivo para identificar a revisão no recurso

Nenhuma.

Se existir um erro de resposta, o formato do corpo da resposta será o mesmo mostrado no Status de gerenciamento de serviço e códigos de erro.

Esta seção lista os códigos de erro que possa encontrar enquanto realiza as operações de criação ou atualização para o Serviços do BizTalk.

 

Código do erro Cadeia de Caracteres de Erro Descrição

CustomDomainInvalid

Validação da URL de Domínio Personalizado falhou. Espera-se que a URL do Domínio Personalizado seja inferior a ou igual a 256 caracteres de comprimento.

A validação da URL de domínio personalizado falhou porque o valor especificado não satisfaz os critérios.

ServiceVersionUnsupported

A versão do serviço especificada não é suportada.

-

ServiceVersionFormatUnsupported

A versão do serviço especificada não está no formato correto

A versão especificada não está no formato correto O formato correto deve ser similar a 1.1.1, 1.2.1, 1.1.2 ou 2.1.1

EditionUnsupported

A edição especificada não é suportada.

Um nome de edição válido não especificado. Para obter informações sobre as edições, consulte Serviços BizTalk: Gráfico de Edições Developer, Basic, Standard e Premium.

UnitCountNotAllowed

A contagem de unidades especificada não é permitida para a edição dos Serviços BizTalk.

A contagem de unidades especificada não é um inteiro positivo ou não encaixa dentro da margem mínima/máxima para a edição especificada. Para obter mais informações, consulte Serviços BizTalk: Gráfico de Edições Developer, Basic, Standard e Premium.

InvalidServiceCertificateDetails

O certificado de serviço especificado não satisfaz os requisitos. Os dados do certificado não representam um .pfx bem formado ou a senha especificada não está correta para o certificado especificado.

-

InvalidTrackingStore

A memória de rastreamento especificada é inválida. Assegure-se de que a memória de rastreamento existe e que a cadeia de caracteres da conexão fornecida está correta. Além disso, assegure-se de que o sinalizador de Processamento Assíncrono está definido para verdadeiro.

-

InvalidArchivingStore

A memória de arquivado especificada é inválida. Assegure-se de que a memória existe e que a cadeia de caracteres da conexão fornecida está correta.

-

InvalidMonitoringStore

A memória de acompanhamento/arquivamento especificada é inválida. Assegure-se de que a memória existe e que a cadeia de caracteres da conexão fornecida está correta.

-

InvalidServiceAcsNamespace

Não foi possível conectar à conta do ACS com as credenciais especificadas. Assegure-se de que as credenciais especificadas e o namespace são válidos.

-

UpdateSettingsNotAllowed

A atualização falhou. Uma ou mais configurações do serviço especificadas não são permitidas na Atualização. Por favor consulte a documentação do produto nos valores permitidos e configurações atualizáveis.

Pode encontrar este erro quando tenta atualizar qualquer dos seguintes:

  • Para o CustomDomainUrl – A URL especificada é diferente da que foi especificada durante a criação do Serviços do BizTalk.

  • Para Edição – A edição especificada não está correta.

  • Para TrackingStoreConnectionString – Qualquer coisa exceto a senha é alterada como parte da operação de atualização.

  • Para o ServiceAcsParameters – Qualquer dos parâmetros do ACS (Namespace, ManagementuserName ou ManegementPassword) é alterado.

Consulte também

Mostrar:
© 2015 Microsoft