Esquema WebRole de definição dos Serviços de Nuvem do Azure (suporte estendido)

Importante

A partir de 31 de março de 2025, os Serviços de nuvem (suporte estendido) foram preteridos e serão totalmente desativados em 31 de março de 2027. Saiba mais sobre esta depreciação e como migrar.

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

InstanceInputEndpoint

AllocatePublicPortFrom

Função Web

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	Descrição
nome	corda	Obrigatório. O nome da função na web. O nome da função deve ser exclusivo.
ativarExecuçãoDeCódigoNativo	Booleano	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	corda	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çõ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 .

Configuraçã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	Descrição
nome	corda	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	Descrição
nome	corda	Obrigatório. Um nome exclusivo para a loja local.
cleanOnRoleRecycle	Booleano	Opcional. Indica se a loja local deve ser limpa quando o papel é reiniciado. O valor predefinido é `true`.
tamanhoEmMegabaites	Int	Opcional. A quantidade desejada de espaço de armazenamento a alocar no 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 elemento Endpoints 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 de entrada e internos 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 num 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 para cada 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.

Ponto de Entrada de Dados

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	Descrição
nome	corda	Obrigatório. Um nome exclusivo para o ponto de extremidade externo.
protocolo	corda	Obrigatório. Protocolo de transporte para o endpoint externo. Para uma função Web, os valores possíveis são `HTTP`, `HTTPS`, `UDP`, ou `TCP`.
porto	Int	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	corda	Necessário para um endpoint HTTPS. O nome de um certificado definido por um `Certificate` elemento.
Porta Local	Int	Opcional. Especifica uma porta utilizada para ligações internas no ponto terminal. O `localPort` atributo mapeia a porta externa no ponto final para uma porta interna numa 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. Ajuste o valor de `localPort` para "*" para atribuir automaticamente uma porta não alocada que possa ser detetada usando a API de tempo de 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	Booleano	Opcional. Quando o valor desse atributo é definido como `true`, o status de um serviço é ignorado e 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 endpoint ainda pode receber tráfego mesmo quando o papel não está no estado Pronto.
Sonda de Balanceamento de Carga	corda	Opcional. O nome da sonda do balanceador de carga associada ao ponto de extremidade de entrada. Para obter mais informações, consulte LoadBalancerProbe Schema.

Ponto Final Interno

O InternalEndpoint elemento descreve um ponto de extremidade interno para uma função Web. Um endpoint interno está disponível somente para outras instâncias de funções que estão a operar dentro do serviço; não está acessível a 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	Descrição
nome	corda	Obrigatório. Um nome único para o ponto de extremidade interno.
protocolo	corda	Obrigatório. Protocolo de transporte para o endpoint interno. Os valores possíveis são `HTTP`, `TCP`, `UDP`, ou `ANY`. Um valor de `ANY` especifica que qualquer protocolo, qualquer porta é permitido.
porto	Int	Opcional. A porta usada para ligações internas com balanceamento de carga no terminal. Um endpoint com balanceamento de carga utiliza 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.

PontoFinalDeEntradaDaInstância

O InstanceInputEndpoint elemento descreve um ponto de extremidade de entrada instanciado para uma função Web. Um endereço de entrada da instância é associado a uma instância de função específica usando o encaminhamento de portas no balanceador de carga. Cada ponto de extremidade de entrada de instância é mapeado para uma porta específica de um leque 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	Descrição
nome	corda	Obrigatório. Nome único para o ponto de extremidade.
Porta Local	Int	Obrigatório. Especifica a porta interna que todas as instâncias de função ouvem para receber o tráfego de entrada, que é encaminhado pelo balanceador de carga. Os valores possíveis variam entre 1 e 65535, inclusive.
protocolo	corda	Obrigatório. Protocolo de transporte para o endpoint interno. Os valores possíveis são `udp` ou `tcp`. Use `tcp` para tráfego baseado em http/https.

AtribuirPortaPúblicaDe

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 deste intervalo e atribuído a cada ponto de extremidade da instância de função específica durante a implementaçã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	Descrição
porto	Int	Obrigatório. A porta para o ponto final 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	Descrição
minuto	Int	Obrigatório. A porta mínima do intervalo. Os valores possíveis variam entre 1 e 65535, inclusive (SDK do Azure versão 1.7 ou superior).
máximo	corda	Obrigatório. A porta máxima do 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	Descrição
nome	corda	Obrigatório. Um nome para esse certificado, que é usado para se referir a ele quando está associado a um elemento HTTPS `InputEndpoint` .
localização da loja	corda	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	corda	Obrigatório. O nome do armazenamento de certificados onde esse certificado reside na máquina local. Os valores possíveis incluem os nomes de loja internos `My`, `Root`, `CA`, `Trust`, `Disallowed`, `TrustedPeople`, `TrustedPublisher`, `AuthRoot`, `AddressBook` ou qualquer nome de loja personalizada. Se um nome de loja personalizado for especificado, o repositório será criado automaticamente.
nível de permissão	corda	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 relacionados a funções 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	Descrição
nome_do_módulo	corda	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 Extensões. O módulo Diagnóstico permite coletar dados de diagnóstico para uma instância de função.

Tempo de execução

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	Descrição
contexto de execução	corda	Opcional. Especifica o contexto no qual o Processo de Cargo é iniciado. O contexto padrão é `limited`. - `limited` – O processo é iniciado sem privilégios de administrador. - `elevated` – O processo é iniciado com privilégios de administrador.

Ambiente

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	Descrição
nome	corda	Obrigatório. O nome da variável de ambiente a ser definida.
valor	corda	Opcional. O valor a ser definido para a variável de ambiente. Você deve incluir um atributo value ou um elemento `RoleInstanceValue`.

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	Descrição
XPath	corda	Opcional. Caminho de localização das configurações de implementaçã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 elemento `RoleInstanceValue`.

Ponto de Entrada

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	Descrição
nome da montagem	corda	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 na linha de comando; 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.
versão de framework alvo	corda	Obrigatório. A versão do .NET Framework na qual o assembly foi criado. Por exemplo, `targetFrameworkVersion="v4.0"`.

Sítios

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. Este 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.

Sítio

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	Descrição
nome	corda	Obrigatório. Nome do site ou aplicativo.
Diretório físico	corda	A localização do diretório de conteúdo da 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	Descrição
nome	corda	Obrigatório. Especifica um nome para identificar o aplicativo virtual.
Diretório físico	corda	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. Quando implantado 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	Descrição
nome	corda	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. Quando implantado 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.

Vínculos

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 Ativar 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.

Vinculativo

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	Descrição
nome	corda	Obrigatório. Especifica um nome para identificar a associação.
endpointName	corda	Obrigatório. Especifica o nome do ponto de extremidade ao qual se ligar.
cabeçalho do host	corda	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	Descrição
prioridade	Int	Apenas para uso interno.

Tarefa

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	Descrição
linha de comando	corda	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. Formatos de arquivo que definem um marcador de ordem de bytes no início são processados incorretamente.
contexto de execução	corda	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	corda	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 termine. - `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	Descrição
destino	corda	Obrigatório. Local na máquina virtual do Azure na qual o conteúdo é colocado. Esta localização é relativa à 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	Descrição
caminho	corda	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.

Próximos passos

Esquema de definição do serviço de nuvem (suporte estendido).

Feedback

Esta página foi útil?

Last updated on 2025-05-22

Partilhar via

Esquema WebRole de definição dos Serviços de Nuvem do Azure (suporte estendido)

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

Elementos do esquema

Função Web

Configurações

Configuração

Recursos Locais

Armazenamento local

Pontos finais

Ponto de Entrada de Dados

Ponto Final Interno

PontoFinalDeEntradaDaInstância

AtribuirPortaPúblicaDe

Porta Fixa

FixedPortRange

Certificados

Certificado

Importações

Importar

Tempo de execução

Ambiente

Variável

RoleInstanceValue

Ponto de Entrada

NetFxEntryPoint

Sítios

Sítio

Aplicação virtual

Diretório virtual

Vínculos

Vinculativo

Arranque

Tarefa

Conteúdos

Conteúdo

Diretório de fontes

Próximos passos

Feedback

Recursos adicionais