Azure Cloud Services (clássico) Definição WebRole Schema

Artigo
07/25/2024

Importante

Os Serviços na Nuvem (clássicos) foram preteridos para todos os clientes a partir de 1º de setembro de 2024. Todas as implantações em execução existentes serão interrompidas e encerradas pela Microsoft e os dados serão perdidos permanentemente a partir de outubro de 2024. Novas implantações devem usar o novo modelo de implantação baseado no Azure Resource Manager Serviços de Nuvem do Azure (suporte estendido).

A função Web do Azure é uma função personalizada para programação de aplicativos Web com suporte no IIS 7, como ASP.NET, PHP, Windows Communication Foundation e FastCGI.

A extensão padrão para o arquivo de definição de serviço é .csdef.

Esquema de definição de serviço básico para uma função Web

O formato básico de um arquivo de definição de serviço que contém uma função Web é o seguinte.

<ServiceDefinition …>  
  <WebRole name="<web-role-name>" vmsize="<web-role-size>" enableNativeCodeExecution="[true|false]">  
    <Certificates>  
      <Certificate name="<certificate-name>" storeLocation="<certificate-store>" storeName="<store-name>" />  
    </Certificates>      
    <ConfigurationSettings>  
      <Setting name="<setting-name>" />  
    </ConfigurationSettings>  
    <Imports>  
      <Import moduleName="<import-module>"/>  
    </Imports>  
    <Endpoints>  
      <InputEndpoint certificate="<certificate-name>" ignoreRoleInstanceStatus="[true|false]" name="<input-endpoint-name>" protocol="[http|https|tcp|udp]" localPort="<port-number>" port="<port-number>" loadBalancerProbe="<load-balancer-probe-name>" />  
      <InternalEndpoint name="<internal-endpoint-name>" protocol="[http|tcp|udp|any]" port="<port-number>">  
         <FixedPort port="<port-number>"/>  
         <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>  
      </InternalEndpoint>  
     <InstanceInputEndpoint name="<instance-input-endpoint-name>" localPort="<port-number>" protocol="[udp|tcp]">  
         <AllocatePublicPortFrom>  
            <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>  
         </AllocatePublicPortFrom>  
      </InstanceInputEndpoint>  
    </Endpoints>  
    <LocalResources>  
      <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />  
    </LocalResources>  
    <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />  
    <Runtime executionContext="[limited|elevated]">  
      <Environment>  
         <Variable name="<variable-name>" value="<variable-value>">  
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>  
          </Variable>            
      </Environment>  
      <EntryPoint>  
         <NetFxEntryPoint assemblyName="<name-of-assembly-containing-entrypoint>" targetFrameworkVersion="<.net-framework-version>"/>  
      </EntryPoint>  
    </Runtime>  
    <Sites>  
      <Site name="<web-site-name>">  
        <VirtualApplication name="<application-name>" physicalDirectory="<directory-path>"/>  
        <VirtualDirectory name="<directory-path>" physicalDirectory="<directory-path>"/>  
        <Bindings>  
          <Binding name="<binding-name>" endpointName="<endpoint-name-bound-to>" hostHeader="<url-of-the-site>"/>  
        </Bindings>  
      </Site>  
    </Sites>  
    <Startup priority="<for-internal-use-only>">  
      <Task commandLine="<command-to=execute>" executionContext="[limited|elevated]" taskType="[simple|foreground|background]">  
        <Environment>  
         <Variable name="<variable-name>" value="<variable-value>">  
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>  
          </Variable>            
        </Environment>  
      </Task>  
    </Startup>  
    <Contents>  
      <Content destination="<destination-folder-name>" >  
        <SourceDirectory path="<local-source-directory>" />  
      </Content>  
    </Contents>  
  </WebRole>  
</ServiceDefinition>

Elementos do esquema

O arquivo de definição de serviço inclui esses elementos, descritos em detalhes nas seções subsequentes deste artigo:

Função Web

ConfiguraçõesDefinições

Definição

Recursos Locais

Armazenamento local

Parâmetros de avaliação

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

WebRole

O WebRole elemento descreve uma função personalizada para programação de aplicativos Web, conforme suportado pelo IIS 7 e ASP.NET. Um serviço pode conter zero ou mais funções Web.

A tabela a seguir descreve os atributos do WebRole elemento .

Atributo	Tipo	Description
nome	string	Obrigatório. O nome da função Web. O nome da função deve ser exclusivo.
enableNativeCodeExecution	boolean	Opcional. O valor padrão é `true`; a execução de código nativo e a confiança total são ativadas por padrão. Defina esse atributo como `false` para desabilitar a execução de código nativo para a função Web e use a confiança parcial do Azure.
vmsize	string	Opcional. Defina esse valor para alterar o tamanho da máquina virtual alocada à função. O valor predefinido é `Small`. Para obter mais informações, consulte Tamanhos de máquinas virtuais para serviços de nuvem.

ConfiguraçõesDefinições

O ConfigurationSettings elemento descreve a coleção de definições de configuração para uma função Web. Este elemento é o pai do Setting elemento .

Definição

O Setting elemento descreve um par de nome e valor que especifica uma definição de configuração para uma instância de uma função.

A tabela a seguir descreve os atributos do Setting elemento .

Atributo	Tipo	Description
nome	string	Obrigatório. Um nome exclusivo para a definição de configuração.

As definições de configuração para uma função são pares de nome e valor que são declarados no arquivo de definição de serviço e definidos no arquivo de configuração de serviço.

Recursos Locais

O LocalResources elemento descreve a coleção de recursos de armazenamento local para uma função Web. Este elemento é o pai do LocalStorage elemento .

Armazenamento local

O LocalStorage elemento identifica um recurso de armazenamento local que fornece espaço do sistema de arquivos para o serviço em tempo de execução. Uma função pode definir zero ou mais recursos de armazenamento local.

Nota

O LocalStorage elemento pode aparecer como um filho do WebRole elemento para dar suporte à compatibilidade com versões anteriores do SDK do Azure.

A tabela a seguir descreve os atributos do LocalStorage elemento .

Atributo	Tipo	Description
nome	string	Obrigatório. Um nome exclusivo para a loja local.
cleanOnRoleRecycle	boolean	Opcional. Indica se o armazenamento local deve ser limpo quando a função é reiniciada. O valor predefinido é `true`.
tamanhoInMb	número inteiro	Opcional. A quantidade desejada de espaço de armazenamento para alocar para o armazenamento local, em MB. Se não for especificado, o espaço de armazenamento padrão alocado é de 100 MB. A quantidade mínima de espaço de armazenamento que pode ser alocada é de 1 MB. O tamanho máximo dos recursos locais depende do tamanho da máquina virtual. Para obter mais informações, consulte Tamanhos de máquinas virtuais para serviços de nuvem.

O nome do diretório alocado para o recurso de armazenamento local corresponde ao valor fornecido para o atributo name.

Pontos finais

O Endpoints elemento descreve a coleção de pontos de extremidade de entrada (externos), internos e de instância para uma função. Este elemento é o pai dos InputEndpointelementos , InternalEndpointe InstanceInputEndpoint .

Os pontos finais internos e de entrada são alocados separadamente. Um serviço pode ter um total de 25 pontos de extremidade de entrada, internos e de instância, que podem ser alocados entre as 25 funções permitidas em um serviço. Por exemplo, se você tiver cinco funções, poderá alocar cinco pontos de extremidade de entrada por função, alocar 25 pontos de extremidade de entrada para uma única função ou alocar um ponto de extremidade de entrada cada para 25 funções.

Nota

Cada função implantada requer uma instância por função. O provisionamento padrão para uma assinatura é limitado a 20 núcleos e, portanto, é limitado a 20 instâncias de uma função. Se o seu aplicativo exigir mais instâncias do que as fornecidas pelo provisionamento padrão, consulte Cobrança, gerenciamento de assinatura e suporte a cotas para obter mais informações sobre como aumentar sua cota.

InputEndpoint

O InputEndpoint elemento descreve um ponto de extremidade externo para uma função Web.

Você pode definir vários pontos de extremidade que são uma combinação de pontos de extremidade HTTP, HTTPS, UDP e TCP. Você pode especificar qualquer número de porta escolhido para um ponto de extremidade de entrada, mas os números de porta especificados para cada função no serviço devem ser exclusivos. Por exemplo, se você especificar que uma função Web usa a porta 80 para HTTP e a porta 443 para HTTPS, poderá especificar que uma segunda função Web use a porta 8080 para HTTP e a porta 8043 para HTTPS.

A tabela a seguir descreve os atributos do InputEndpoint elemento .

Atributo	Tipo	Description
nome	string	Obrigatório. Um nome exclusivo para o ponto de extremidade externo.
protocolo	string	Obrigatório. O protocolo de transporte para o ponto de extremidade externo. Para uma função Web, os valores possíveis são `HTTP`, `HTTPS`, `UDP`, ou `TCP`.
porta	número inteiro	Obrigatório. A porta para o ponto de extremidade externo. Você pode especificar qualquer número de porta escolhido, mas os números de porta especificados para cada função no serviço devem ser exclusivos. Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1.7 ou superior).
certificado	string	Necessário para um ponto de extremidade HTTPS. O nome de um certificado definido por um `Certificate` elemento.
localPort	número inteiro	Opcional. Especifica uma porta usada para conexões internas no ponto de extremidade. O `localPort` atributo mapeia a porta externa no ponto de extremidade para uma porta interna em uma função. Esse atributo é útil em cenários em que uma função deve se comunicar com um componente interno em uma porta diferente daquela que é exposta externamente. Se não for especificado, o valor de `localPort` é o mesmo que o `port` atributo. Defina o valor de "*" para atribuir automaticamente uma porta não alocada que possa ser detetada usando a API de tempo de `localPort` execução. Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1.7 ou superior). O `localPort` atributo só está disponível usando o SDK do Azure versão 1.3 ou superior.
ignoreRoleInstanceStatus	boolean	Opcional. Quando o valor desse atributo é definido como `true`, o status de um serviço é ignorado, o balanceador de carga não remove o ponto de extremidade. Definir esse valor como `true` útil para depurar instâncias ocupadas de um serviço. O valor predefinido é `false`. Observação: um ponto de extremidade ainda pode receber tráfego mesmo quando a função não está no estado Pronto.
loadBalancerProbe	string	Opcional. O nome da sonda do balanceador de carga associada ao ponto de extremidade de entrada. Para obter mais informações, consulte Esquema LoadBalancerProbe.

InternalEndpoint

O InternalEndpoint elemento descreve um ponto de extremidade interno para uma função Web. Um ponto de extremidade interno está disponível apenas para outras instâncias de função em execução no serviço; não está disponível para clientes fora do serviço. As funções Web que não incluem o Sites elemento só podem ter um único ponto de extremidade interno HTTP, UDP ou TCP.

A tabela a seguir descreve os atributos do InternalEndpoint elemento .

Atributo	Tipo	Description
nome	string	Obrigatório. Um nome exclusivo para o ponto de extremidade interno.
protocolo	string	Obrigatório. O protocolo de transporte para o ponto de extremidade interno. Os valores possíveis são `HTTP`, `TCP`, `UDP`, ou `ANY`. Um valor de `ANY` especifica que qualquer protocolo, qualquer porta é permitido.
porta	número inteiro	Opcional. A porta usada para conexões internas com balanceamento de carga no ponto de extremidade. Um ponto de extremidade com balanceamento de carga usa duas portas. A porta usada para o endereço IP público e a porta usada no endereço IP privado. Normalmente, esses valores são definidos como os mesmos, mas você pode optar por usar portas diferentes. Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1.7 ou superior). O `Port` atributo só está disponível usando o SDK do Azure versão 1.3 ou superior.

InstanceInputEndpoint

O InstanceInputEndpoint elemento descreve um ponto de extremidade de entrada de instância para uma função Web. Um ponto de extremidade de entrada de instância é associado a uma instância de função específica usando o encaminhamento de porta no balanceador de carga. Cada ponto de extremidade de entrada de instância é mapeado para uma porta específica a partir de um intervalo de portas possíveis. Este elemento é o pai do AllocatePublicPortFrom elemento .

O InstanceInputEndpoint elemento só está disponível usando o SDK do Azure versão 1.7 ou superior.

A tabela a seguir descreve os atributos do InstanceInputEndpoint elemento .

Atributo	Tipo	Description
nome	string	Obrigatório. Um nome exclusivo para o ponto de extremidade.
localPort	número inteiro	Obrigatório. Especifica a porta interna que todas as instâncias de função escutam para receber o tráfego de entrada encaminhado do balanceador de carga. Os valores possíveis variam entre 1 e 65535, inclusive.
protocolo	string	Obrigatório. O protocolo de transporte para o ponto de extremidade interno. Os valores possíveis são `udp` ou `tcp`. Use `tcp` para tráfego baseado em http/https.

AllocatePublicPortFrom

O AllocatePublicPortFrom elemento descreve o intervalo de portas públicas que os clientes externos podem usar para acessar cada ponto de extremidade de entrada da instância. O número da porta pública (VIP) é alocado a partir desse intervalo e atribuído a cada ponto de extremidade de instância de função individual durante a implantação e atualização do locatário. Este elemento é o pai do FixedPortRange elemento .

O AllocatePublicPortFrom elemento só está disponível usando o SDK do Azure versão 1.7 ou superior.

Porta Fixa

O FixedPort elemento especifica a porta para o ponto de extremidade interno, que permite conexões com balanceamento de carga no ponto de extremidade.

O FixedPort elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do FixedPort elemento .

Atributo	Tipo	Description
porta	número inteiro	Obrigatório. A porta para o ponto de extremidade interno. Este atributo tem o mesmo efeito que definir o min e max `FixedPortRange` para a mesma porta. Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1.7 ou superior).

FixedPortRange

O FixedPortRange elemento especifica o intervalo de portas atribuídas ao ponto de extremidade de entrada interno ou ao ponto de extremidade de entrada da instância e define a porta usada para conexões com balanceamento de carga no ponto de extremidade.

Nota

O FixedPortRange elemento funciona de forma diferente dependendo do elemento em que reside. Quando o FixedPortRange elemento está no InternalEndpoint elemento , ele abre todas as portas no balanceador de carga dentro do intervalo dos atributos min e max para todas as máquinas virtuais nas quais a função é executada. Quando o FixedPortRange elemento está no InstanceInputEndpoint elemento , ele abre apenas uma porta dentro do intervalo dos atributos min e max em cada máquina virtual que executa a função.

O FixedPortRange elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do FixedPortRange elemento .

Atributo	Tipo	Description
min	número inteiro	Obrigatório. A porta mínima no intervalo. Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1.7 ou superior).
max	string	Obrigatório. A porta máxima no intervalo. Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1.7 ou superior).

Certificados

O Certificates elemento descreve a coleção de certificados para uma função Web. Este elemento é o pai do Certificate elemento . Uma função pode ter qualquer número de certificados associados. Para obter mais informações sobre como usar o elemento certificates, consulte Modificar o arquivo de definição de serviço com um certificado.

Certificado

O Certificate elemento descreve um certificado associado a uma função Web.

A tabela a seguir descreve os atributos do Certificate elemento .

Atributo	Tipo	Description
nome	string	Obrigatório. Um nome para esse certificado, que é usado para se referir a ele quando está associado a um elemento HTTPS `InputEndpoint` .
storeLocalização	string	Obrigatório. O local do armazenamento de certificados onde esse certificado pode ser encontrado na máquina local. Os valores possíveis são `CurrentUser` e `LocalMachine`.
nome_da_loja	string	Obrigatório. O nome do armazenamento de certificados onde esse certificado reside na máquina local. Os valores possíveis incluem os nomes `My`de loja internos , `Root`, , `CA`, `Trust`, `DisallowedTrustedPeople`, , `TrustedPublisherAuthRoot`, , `AddressBook`ou qualquer nome de loja personalizada. Se um nome de loja personalizado for especificado, o repositório será criado automaticamente.
permissionLevel	string	Opcional. Especifica as permissões de acesso dadas aos processos de função. Se você quiser que apenas processos elevados possam acessar a chave privada, especifique `elevated` a permissão. `limitedOrElevated` permissão permite que todos os processos de função acessem a chave privada. Os valores possíveis são `limitedOrElevated` ou `elevated`. O valor predefinido é `limitedOrElevated`.

Importações

O Imports elemento descreve uma coleção de módulos de importação para uma função Web que adicionam componentes ao sistema operacional convidado. Este elemento é o pai do Import elemento . Este elemento é opcional e uma função pode ter apenas um bloco de importações.

O Imports elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.

Importar

O Import elemento especifica um módulo a ser adicionado ao sistema operacional convidado.

O Import elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do Import elemento .

Atributo	Tipo	Description
nome_do_módulo	string	Obrigatório. O nome do módulo a ser importado. Os módulos de importação válidos são: - Acesso Remoto - RemoteForwarder - Diagnósticos Os módulos RemoteAccess e RemoteForwarder permitem configurar sua instância de função para conexões de área de trabalho remota. Para obter mais informações, consulte Habilitar conexão de área de trabalho remota. O módulo Diagnóstico permite coletar dados de diagnóstico para uma instância de função.

Runtime

O Runtime elemento descreve uma coleção de configurações de variáveis de ambiente para uma função Web que controlam o ambiente de tempo de execução do processo de host do Azure. Este elemento é o pai do Environment elemento . Esse elemento é opcional e uma função pode ter apenas um bloco de tempo de execução.

O Runtime elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do Runtime elemento :

Atributo	Tipo	Description
executionContext	string	Opcional. Especifica o contexto no qual o Processo de Função é iniciado. O contexto padrão é `limited`. - `limited` – O processo é iniciado sem privilégios de administrador. - `elevated` – O processo é iniciado com privilégios de administrador.

Environment

O Environment elemento descreve uma coleção de configurações de variáveis de ambiente para uma função Web. Este elemento é o pai do Variable elemento . Uma função pode ter qualquer número de variáveis de ambiente definidas.

Variável

O Variable elemento especifica uma variável de ambiente a ser definida na operação convidada.

O Variable elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do Variable elemento :

Atributo	Tipo	Description
nome	string	Obrigatório. O nome da variável de ambiente a ser definida.
valor	string	Opcional. O valor a ser definido para a variável de ambiente. Você deve incluir um atributo value ou um `RoleInstanceValue` elemento .

RoleInstanceValue

O RoleInstanceValue elemento especifica o xPath do qual recuperar o valor da variável.

A tabela a seguir descreve os atributos do RoleInstanceValue elemento .

Atributo	Tipo	Description
XPath	string	Opcional. Caminho de local das configurações de implantação para a instância. Para obter mais informações, consulte Variáveis de configuração com XPath. Você deve incluir um atributo value ou um `RoleInstanceValue` elemento .

EntryPoint

O EntryPoint elemento especifica o ponto de entrada para uma função. Este elemento é o pai dos NetFxEntryPoint elementos. Esses elementos permitem que você especifique um aplicativo diferente do WaWorkerHost.exe padrão para atuar como o ponto de entrada da função.

O EntryPoint elemento só está disponível usando o SDK do Azure versão 1.5 ou superior.

NetFxEntryPoint

O NetFxEntryPoint elemento especifica o programa a ser executado para uma função.

Nota

O NetFxEntryPoint elemento só está disponível usando o SDK do Azure versão 1.5 ou superior.

A tabela a seguir descreve os atributos do NetFxEntryPoint elemento .

Atributo	Tipo	Description
assemblyName	string	Obrigatório. O caminho e o nome do arquivo do assembly que contém o ponto de entrada. O caminho é relativo à pasta \%ROLEROOT%\Approot (não especifique \%ROLEROOT%\Approot em `commandLine`; presume-se). %ROLEROOT% é uma variável de ambiente mantida pelo Azure e representa o local da pasta raiz para sua função. A pasta \%ROLEROOT%\Approot representa a pasta do aplicativo para sua função. Para funções HWC, o caminho é sempre relativo à pasta \%ROLEROOT%\Approot\bin . Para funções Web completas do IIS e do IIS Express, se o assembly não puder ser encontrado em relação à pasta \%ROLEROOT%\Approot , o \%ROLEROOT%\Approot\bin será pesquisado. Esse comportamento de fallback para o IIS completo não é uma prática recomendada e talvez seja removido em versões futuras.
targetFrameworkVersion	string	Obrigatório. A versão do .NET Framework na qual o assembly foi criado. Por exemplo, `targetFrameworkVersion="v4.0"`.

Sites

O Sites elemento descreve uma coleção de sites e aplicativos Web hospedados em uma função Web. Este elemento é o pai do Site elemento . Se você não especificar um Sites elemento, sua função Web será hospedada como função Web herdada e você só poderá ter um site hospedado em sua função Web. Esse elemento é opcional e uma função pode ter apenas um bloco de sites.

O Sites elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.

Site

O Site elemento especifica um site ou aplicativo Web que faz parte da função Web.

O Site elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do Site elemento .

Atributo	Tipo	Description
nome	string	Obrigatório. Nome do site ou aplicativo.
Diretório físico	string	O local do diretório de conteúdo para a raiz do site. O local pode ser especificado como um caminho absoluto ou relativo ao local .csdef.

Aplicação virtual

O VirtualApplication elemento define um aplicativo no IIS (Serviços de Informações da Internet) 7 é um agrupamento de arquivos que fornece conteúdo ou fornece serviços por meio de protocolos, como HTTP. Quando você cria um aplicativo no IIS 7, o caminho do aplicativo se torna parte da URL do site.

O VirtualApplication elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do VirtualApplication elemento .

Atributo	Tipo	Description
nome	string	Obrigatório. Especifica um nome para identificar o aplicativo virtual.
Diretório físico	string	Obrigatório. Especifica o caminho na máquina de desenvolvimento que contém o aplicativo virtual. No emulador de computação, o IIS é configurado para recuperar conteúdo desse local. Durante a implantação no Azure, o conteúdo do diretório físico é empacotado junto com o restante do serviço. Quando o pacote de serviço é implantado no Azure, o IIS é configurado com o local do conteúdo descompactado.

Diretório virtual

O VirtualDirectory elemento especifica um nome de diretório (também conhecido como caminho) que você especifica no IIS e mapeia para um diretório físico em um servidor local ou remoto.

O VirtualDirectory elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do VirtualDirectory elemento .

Atributo	Tipo	Description
nome	string	Obrigatório. Especifica um nome para identificar o diretório virtual.
valor	Diretório físico	Obrigatório. Especifica o caminho na máquina de desenvolvimento que contém o conteúdo do site ou do diretório virtual. No emulador de computação, o IIS é configurado para recuperar conteúdo desse local. Durante a implantação no Azure, o conteúdo do diretório físico é empacotado junto com o restante do serviço. Quando o pacote de serviço é implantado no Azure, o IIS é configurado com o local do conteúdo descompactado.

Enlaces

O Bindings elemento descreve uma coleção de associações para um site. É o elemento pai do Binding elemento . O elemento é necessário para cada Site elemento. Para obter mais informações sobre como configurar pontos de extremidade, consulte Habilitar comunicação para instâncias de função.

O Bindings elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.

Enlace

O Binding elemento especifica as informações de configuração necessárias para solicitações de comunicação com um site ou aplicativo Web.

O Binding elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.

Atributo	Tipo	Description
nome	string	Obrigatório. Especifica um nome para identificar a associação.
endpointName	string	Obrigatório. Especifica o nome do ponto de extremidade ao qual se ligar.
hostHeader	string	Opcional. Especifica um nome de host que permite hospedar vários sites, com nomes de host diferentes, em uma única combinação de endereço IP/número de porta.

Arranque

O Startup elemento descreve uma coleção de tarefas que são executadas quando a função é iniciada. Este elemento pode ser o pai do Variable elemento . Para obter mais informações sobre como usar as tarefas de inicialização de função, consulte Como configurar tarefas de inicialização. Esse elemento é opcional e uma função pode ter apenas um bloco de inicialização.

A tabela a seguir descreve o atributo do Startup elemento .

Atributo	Tipo	Description
prioridade	número inteiro	Apenas para uso interno.

Task

O Task elemento especifica a tarefa de inicialização que ocorre quando a função é iniciada. As tarefas de inicialização podem ser usadas para executar tarefas que preparam a função para executar tais componentes de software de instalação ou executar outros aplicativos. As tarefas são executadas na ordem em que aparecem dentro do bloco de Startup elementos.

O Task elemento só está disponível usando o SDK do Azure versão 1.3 ou superior.

A tabela a seguir descreve os atributos do Task elemento .

Atributo	Tipo	Description
linha de comando	string	Obrigatório. Um script, como um arquivo CMD, contendo os comandos a serem executados. O comando de inicialização e os arquivos em lote devem ser salvos no formato ANSI. Os formatos de arquivo definem um marcador de ordem de bytes no início do processo de arquivo incorretamente.
executionContext	string	Especifica o contexto no qual o script é executado. - `limited` [Padrão] – Execute com os mesmos privilégios da função que hospeda o processo. - `elevated` – Executar com privilégios de administrador.
Tipo de tarefa	string	Especifica o comportamento de execução do comando. - `simple` [Padrão] – O sistema aguarda a saída da tarefa antes que qualquer outra tarefa seja iniciada. - `background` – O sistema não espera que a tarefa saia. - `foreground` – Semelhante ao plano de fundo, exceto que a função não é reiniciada até que todas as tarefas em primeiro plano sejam encerradas.

Conteúdos

O Contents elemento descreve a coleção de conteúdo para uma função Web. Este elemento é o pai do Content elemento .

O Contents elemento só está disponível usando o SDK do Azure versão 1.5 ou superior.

Conteúdo

O Content elemento define o local de origem do conteúdo a ser copiado para a máquina virtual do Azure e o caminho de destino para o qual ele copia.

O Content elemento só está disponível usando o SDK do Azure versão 1.5 ou superior.

A tabela a seguir descreve os atributos do Content elemento .

Atributo	Tipo	Description
destination	string	Obrigatório. Local na máquina virtual do Azure na qual o conteúdo é colocado. Esse local é relativo à pasta %ROLEROOT%\Approot.

Este elemento é o elemento pai do SourceDirectory elemento .

Diretório de fontes

O SourceDirectory elemento define o diretório local do qual o conteúdo é copiado. Use este elemento para especificar o conteúdo local a ser copiado para a máquina virtual do Azure.

O SourceDirectory elemento só está disponível usando o SDK do Azure versão 1.5 ou superior.

A tabela a seguir descreve os atributos do SourceDirectory elemento .

Atributo	Tipo	Description
path	string	Obrigatório. Caminho relativo ou absoluto de um diretório local cujo conteúdo é copiado para a máquina virtual do Azure. A expansão de variáveis de ambiente no caminho do diretório é suportada.

Consulte Também

Esquema de definição do serviço de nuvem (clássico)

Partilhar via

Azure Cloud Services (clássico) Definição WebRole Schema

Esquema de definição de serviço básico para uma função Web

Elementos do esquema

WebRole

ConfiguraçõesDefinições

Definição

Recursos Locais

Armazenamento local

Pontos finais

InputEndpoint

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

Porta Fixa

FixedPortRange

Certificados

Certificado

Importações

Importar

Runtime

Environment

Variável

RoleInstanceValue

EntryPoint

NetFxEntryPoint

Sites

Site

Aplicação virtual

Diretório virtual

Enlaces

Enlace

Arranque

Task

Conteúdos

Conteúdo

Diretório de fontes

Consulte Também

Comentários

Recursos adicionais