Exportar (0) Imprimir
Expandir Tudo

Obter implantação

Atualizado: agosto de 2014

A operação Get Deployment retorna informações de configuração, de status e de propriedades do sistema para uma implantação.

A solicitação Get Deployment pode ser usada para recuperar informações para uma implantação específica ou para todas as implantações no ambiente de preparo ou de produção. Se você desejar recuperar informações sobre uma implantação específica, primeiro deverá obter o nome exclusivo da implantação. Esse nome exclusivo faz parte da resposta quando você faz uma solicitação para obter todas as implantações em um ambiente.

Por exemplo, se você tiver um serviço de nuvem implantado no ambiente de produção, poderá obter o nome exclusivo fazendo uma solicitação a …/deploymentslots/production. A resposta inclui uma lista de todos os serviços de nuvem implantados no ambiente de produção, além de incluir um elemento Name para cada serviço de nuvem. Esse valor do elemento Name pode ser usado para fazer uma solicitação a …/deployments/<Name> se você quiser recuperar informações sobre essa implantação específica.

Para gerar o URI da solicitação, substitua <subscription-id> por sua ID de assinatura, <cloudservice-name> pelo nome do serviço em nuvem, <deployment-slot> por staging ou production ou <deployment-name> pelo nome da sua implantação.

 

Método URI de solicitação

GET

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>

GET

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>

Verifique se a solicitação feita ao serviço de gerenciamento é segura. Para obter mais detalhes, consulte Autenticando solicitações do gerenciamento de serviços.

A tabela a seguir descreve os cabeçalhos da solicitação.

 

Cabeçalho de solicitação Descrição

x-ms-version

Obrigatória. Especifica a versão da operação a ser usada para esta solicitação. Este cabeçalho deve ser definido como 01/10/2009 ou posterior. Para obter mais informações sobre cabeçalhos de controle de versão, consulte Controle de versão de gerenciamento de serviço.

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 200 (OK). Para obter informações sobre códigos de status, consulte Status de Gerenciamento de Serviço e códigos de erro.

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem à especificação de protocolo HTTP/1.1.

 

Cabeçalho de resposta Descrição

x-ms-request-id

Um valor que identifica exclusivamente uma solicitação feita no serviço de gerenciamento.

O exemplo de código a seguir mostra o formato do corpo da resposta:


<?xml version="1.0" encoding="utf-8"?>
<Deployment xmlns="http://schemas.microsoft.com/windowsazure">
  <Name>name-of-deployment</Name>
  <DeploymentSlot>current-deployment-environment</DeploymentSlot>
  <PrivateID>identifier-of-deployment</PrivateID>
  <Status>status-of-deployment</Status>
  <Label>base64-encoded-name-of-deployment</Label>
  <Url>url-of-deployment</Url>
  <Configuration>base-64-encoded-configuration-file</Configuration>
  <RoleInstanceList>
    <RoleInstance>
      <RoleName>name-of-role</RoleName>
      <InstanceName>name-of-role-instance</InstanceName>
      <InstanceStatus>status-of-role-instance</InstanceStatus>
      <ExtendedInstanceStatus>additional-status-details</ExtendedInstanceStatus>
      <InstanceUpgradeDomain>update-domain-of-role-instance</InstanceUpgradeDomain>
      <InstanceFaultDomain>fault-domain-of-role-instance</InstanceFaultDomain>
      <InstanceSize>size-of-role-instance</InstanceSize>
      <InstanceStateDetails>state-of-role-instance</InstanceStateDetails>
      <InstanceErrorCode>error-code-returned-for-role-instance</InstanceErrorCode>
      <IpAddress>ip-address-of-role-instance</IpAddress>
      <InstanceEndpoints>
        <InstanceEndpoint>
          <Name>name-of-endpoint</Name>
          <Vip>virtual-ip-address-of-instance-endpoint</Vip>
          <PublicPort>public-facing-port-of-instance-endpoint</PublicPort>
          <LocalPort>internal-facing-port-of-instance-endpoint</LocalPort>
          <Protocol>protocol-of-instance-endpoint</Protocol>
        </InstanceEndpoint>
      </InstanceEndpoints>
      <PowerState>state-of-role-instance</PowerState>
      <HostName>dns-name-of-service</HostName>
      <RemoteAccessCertificateThumbprint>cert-thumbprint-for-remote-access</RemoteAccessCertificateThumbprint>
      <GuestAgentStatus>
        <ProtocolVersion>version-of-protocol</ProtocolVersion>
        <Timestamp>status-report-time</Timestamp>
        <GuestAgentVersion>version-of-agent</GuestAgentVersion>
        <Status>status-of-agent</Status>
        <FormattedMessage>
          <Language>language-of-message</Language>
          <Message>agent-message</Message>
        </FormattedMessage>
      </GuestAgentStatus>
      <ResourceExtensionStatusList>
        <ResourceExtensionStatus>
          <HandlerName>name-of-extension</HandlerName>
          <Version>version-of-extension</Version>
          <Status>status-of-extension</Status>
          <Code>status-code-of-extension</Code>
          <FormattedMessage>
            <Language>language-of-message</Language>
            <Message>extension-message</Message>
          </FormattedMessage>
        </ResourceExtensionStatus>
      </ResourceExtensionStatusList>
      <PublicIPs>
        <PublicIP>
          <Name>name-of-public-ip</Name>
        <PublicIP>
      <PublicIPs>
    </RoleInstance>
  </RoleInstanceList>
  <UpgradeStatus>
    <UpgradeType>type-of-upgrade</UpgradeType>
    <CurrentUpgradeDomainState>current-status-of-upgrade</CurrentUpgradeDomainState>
    <CurrentUpgradeDomain>n</CurrentUpgradeDomain>
  </UpgradeStatus>
  <UpgradeDomainCount>number-of-upgrade-domains-in-deployment</UpgradeDomainCount>
  <RoleList>
    <Role>
      <RoleName>name-of-role</RoleName>
      <OsVersion>operating-system-version</OsVersion>
      <ConfigurationSets>
        <ConfigurationSet>
          <ConfigurationSetType>NetworkConfiguration</ConfigurationSetType>
          <InputEndpoints>
            <InputEndpoint>
              <Port>port-number-of-input-endpoint-in-network</Port>
              <Protocol>protocol-of-input-endpoint-in-network</Protocol>
              <Vip>virtual-ip-address-of-input-endpoint-in-network</Vip>
            </InputEndpoint>
          </InputEndpoints>
        </NetworkConfigurationSet>
      </ConfigurationSets>
    </Role>
    <Role>
      <RoleName>name-of-role</RoleName>
      <OsVersion>operating-system-version</OsVersion>
      <RoleType>PersistentVMRole</RoleType>
      <ConfigurationSets>
        <ConfigurationSet>
          <ConfigurationSetType>NetworkConfiguration</ConfigurationSetType>
          <InputEndpoints>
            <InputEndpoint>
              <LoadBalancedEndpointSetName>name-of-load-balanced-endpoint-set</LoadBalancedEndpointSetName>
              <LocalPort>internal-facing-port-of-input-endpoint</LocalPort>
              <Name>name-of-input-endpoint</Name>
              <Port>external-facing-port-of-input-endpoint</Port>
              <LoadBalancerProbe>
                <Path>path-of-probe</Path>
                <Port>port-assigned-to-probe</Port>
                <Protocol>protocol-of-probe-port</Protocol>
              </LoadBalancerProbe>
              <LoadBalancerName>name-of-internal-loadbalancer</LoadBalancerName>
              <Protocol>protocol-of-input-endpoint</Protocol>
              <Vip>virtual-ip-address-of-input-endpoint</Vip>
            </InputEndpoint>
          <InputEndpoints>
          <SubnetNames>
            <SubnetName>name-of-subnet</SubnetName>
          </SubnetNames>
          <StaticVirtualNetworkIPAddress>ip-address</StaticVirtualNetworkIPAddress>
        </ConfigurationSet>
      </ConfigurationSets>
      <ResourceExtensionReferences>
        <ResourceExtensionReference>
          <ReferenceName>name-of-reference</ReferenceName>
          <Publisher>name-of-publisher</Publisher>
          <Name>name-of-extension</Name>
          <Version>version-of-extension</Version>
          <ResourceExtensionParameterValues>
            <ResourceExtensionParameterValue>
              <Key>name-of-parameter-key</Key>
              <Value>parameter-value</Value>
              <Type>type-of-parameter</Type>
            </ResourceExtensionParameterValue>
          </ResourceExtensionParameterValues>
          <State>state-of-resource</State>
        </ResourceExtensionReference>
      </ResourceExtensionReferences>
      <AvailabilitySetName>name-of-availability-set</AvailabilitySetName>
      <DataVirtualHardDisks>
        <DataVirtualHardDisk>
          <HostCaching>host-caching-mode-of-data-disk</HostCaching>
          <DiskName>name-of-data-disk</DiskName>
          <Lun>logical-unit-number-of-data-disk</Lun>
          <LogicalDiskSizeInGB>size-of-data-disk</LogicalDiskSizeInGB>
          <MediaLink>path-to-vhd</MediaLink>
        </DataVirtualHardDisk>
      </DataVirtualHardDisks>
      <OSVirtualHardDisk>
        <HostCaching>host-caching-mode-of-os-disk</HostCaching>
        <DiskName>name-of-os-disk</DiskName>
        <MediaLink>path-to-vhd</MediaLink>
        <SourceImageName>image-used-to-create-os-disk</SourceImageName>
        <RemoteSourceImageLink>path-to-source-image</RemoteSourceImageLink>
        <OS>operating-system-on-os-disk</OS>
      </OSVirtualHardDisk>
      <RoleSize>size-of-instance</RoleSize>
      <ProvisionGuestAgent>install-an-agent</ProvisionGuestAgent>
    </Role>
  </RoleList>
  <SdkVersion>sdk-version-used-to-create-package</SdkVersion>
  <Locked>status-of-deployment-write-allowed</Locked>
  <RollbackAllowed>rollback-operation-allowed</RollbackAllowed>
  <VirtualNetworkName>name-of-virtual-network</VirtualNetworkName>
  <Dns>
    <DnsServers>
      <DnsServer>
        <Name>name-of-dns-server</Name>
        <Address>address-of-dns-server</Address>
      </DnsServer>
    </DnsServers>
  </Dns>
  <LoadBalancers>
    <LoadBalancer>
      <Name>name-of-internal-load-balancer</Name>
      <FrontendIpConfiguration>
        <Type>type-of-ip-address</Type>
        <SubnetName>name-of-subnet</SubnetName>
        <StaticVirtualNetworkIPAddress>static-ip-address</StaticVirtualNetworkIPAddress>
      </FrontendIpConfiguration>
    </LoadBalancer>
  </LoadBalancers>
  <ExtendedProperties>
    <ExtendedProperty>
      <Name>name-of-property</Name>
      <Value>value-of-property</Value>
    </ExtendedProperty>
  </ExtendedProperties>
  <PersistentVMDowntime>
    <StartTime>start-of-downtime</StartTime>
    <EndTime>end-of-downtime</EndTime>
    <Status>status-of-downtime</Status>
  </PersistentVMDowntime>
  <VirtualIPs>
    <VirtualIP>
      <Address>virtual-ip-address-of-deployment</Address>
      <IsReserved>indicator-of-ip-reservation</IsReserved>
      <ReservedIPName>name-of-reserved-ip</ReservedIpName>
      <Type>type-of-ip</Type>
    </VirtualIP>
  </VirtualIPs>
  <ExtensionConfiguration>
    <AllRoles>
      <Extension>
        <Id>identifier-of-extension</Id>
      </Extension>
    </AllRoles>
    <NamedRoles>
      <Role>
        <RoleName>role_name1</RoleName>
        <Extensions>
          <Extension>
            <Id>identifier-of-extension</Id>
          </Extension>
        </Extensions>
      </Role>
    </NamedRoles>
  </ExtensionConfiguration>
  <ReservedIPName>name-of-reserved-ip</ReservedIpName>
  <InternalDnsSuffix>dns-suffix</InternalDnsSuffix>
</Deployment>

A tabela a seguir descreve os elementos no corpo da resposta.

 

Nome do elemento Descrição

Nome

Especifica o nome da implantação.

DeploymentSlot

Especifica o ambiente no qual o serviço de nuvem é implantado, staging ou production.

PrivateID

Especifica um identificador exclusivo gerado internamente pelo Azure para essa implantação.

Status

Especifica o status da implantação.

Os possíveis valores são:

  • Running

  • Suspended

  • RunningTransitioning

  • SuspendedTransitioning

  • Starting

  • Suspending

  • Deploying

  • Deleting

Rótulo

Especifica um identificador codificado em base 64 da implantação. Este identificador pode ser usado para suas finalidades de acompanhamento.

Url

Especifica a URL que é usada para acessar o serviço de nuvem.

Por exemplo, se o nome do serviço for MyService, você poderá acessar o serviço chamando: http:// MyService.cloudapp.net

Configuração

Especifica o arquivo de configuração codificado em base 64 da implantação.

RoleInstanceList

Contém a lista de instâncias de função da implantação.

UpgradeStatus

Contém configurações que definem como a implantação é atualizada.

UpgradeDomainCount

Contém um inteiro que representa o número total de domínios de atualização para a implantação.

O elemento UpgradeDomainCount só estará disponível com a versão 01/06/2011 ou superior.

RoleList

Contém a lista de funções da implantação.

SdkVersion

Especifica a versão do SDK usada para gerar o pacote para a implantação.

O elemento SdkVersion só estará disponível com a versão 01/06/2011 ou superior.

Bloqueado

True para impedir uma nova operação de gravação na implantação enquanto ela estiver sendo atualizada; caso contrário, false.

O elemento Locked só estará disponível com a versão 01/06/2011 ou superior.

RollbackAllowed

True se a operação RollbackDeploymentUpdateOrUpgrade for permitida na implantação; caso contrário, false.

O elemento RollbackAllowed só estará disponível com a versão 01/06/2011 ou superior.

CreatedTime

Especifica a hora em que a implantação foi criada.

LastModifiedTime

Especifica a última hora em que a implantação foi modificada.

VirtualNetworkName

Especifica o nome da Rede Virtual à qual a Máquina Virtual se conecta.

O elemento VirtualNetworkName só estará disponível com a versão 01.03.12 ou superior.

Dns

Contém as configurações de DNS especificadas para a implantação.

O elemento Dns só estará disponível com a versão 01.03.12 ou superior.

LoadBalancers

Contém uma lista de balanceadores de carga internos que podem ser atribuídos a pontos de extremidade de entrada.

O elemento LoadBalancers só estará disponível com a versão 01.05.14 ou superior.

ExtendedProperties

Especifica as propriedades usadas para fornecer mais informações sobre uma implantação.

PersistentVMDowntime

Especifica informações sobre quando a máquina virtual foi iniciada e parada.

O elemento PersistentVMDowntime só estará disponível com a versão 01.03.12 ou superior.

VirtualIPs

Especifica os endereços IP virtuais para a implantação.

O elemento VirtualIPs só estará disponível com a versão 01.03.12 ou superior.

ExtensionConfiguration

Especifica uma extensão que é adicionada ao serviço de nuvem. No Azure, um processo pode ser executado como uma extensão de um serviço de nuvem. Você pode adicionar uma extensão a um serviço de nuvem usando Adicionar extensão e pode adicionar a extensão à implantação usando Atualizar implantação ou Alterar configuração de implantação.

O elemento ExtensionConfiguration só estará disponível com a versão 01.03.13 ou superior.

ReservedIPName

Especifica o nome de um endereço IP reservado que deve ser atribuído à implantação.

O elemento ReservedIPName só estará disponível com a versão 01.05.14 ou superior.

InternalDnsSuffix

Especifica o sufixo de nome de domínio para resolução de nomes internos automaticamente atribuído pelo Azure. Todas as instâncias de máquinas virtuais em uma implantação automaticamente recebem um sufixo de nome de domínio. Todas as instâncias de funções Web e funções de trabalho de uma implantação automaticamente recebem o sufixo de nome de domínio quando pelo menos uma função recebe um nome de computador com o atributo vmName. Uma implantação em uma VNET com um servidor DNS configurado não recebe um sufixo de nome de domínio interno. Para obter mais informações, consulte Resolução de nomes.

O elemento InternalDnsSuffix só estará disponível com a versão 01.11.13 ou superior.

Contém a lista de instâncias de função da implantação.

 

Nome do elemento Descrição

RoleName

Especifica o nome da função.

InstanceName

Especifica o nome de uma instância de função em particular, caso uma instância da função esteja em execução.

InstanceStatus

Especifica o status atual de uma instância de função.

 

Mensagem de status Descrição

Unknown

Indica que o estado da função é desconhecido no momento.

CreatingVM

Indica que recursos estão sendo criados para uma Máquina Virtual.

StartingVM

Indica que uma Máquina Virtual está iniciando.

CreatingRole

Indica que recursos estão sendo criados para uma instância de função.

StartingRole

Indica que uma instância de função está iniciando.

ReadyRole

Indica que uma instância de função foi iniciada e está pronta para ser usada.

BusyRole

Indica que uma instância de função não está disponível para solicitações. Geralmente, este estado é gerado quando a instância de função está sendo criada ou parada.

StoppingRole

Indica que uma instância de função está parando.

StoppingVM

Indica que uma Máquina Virtual está parando.

DeletingVM

Indica que uma Máquina Virtual está sendo excluída.

StoppedVM

Indica que uma Máquina Virtual não está sendo executada. Este é o estado final do processo de desligamento, e nenhuma outra mensagem de status deverá ser recebida depois de StoppedVM.

RestartingRole

Indica que uma instância de função foi parada inesperadamente ou falhou ao ser iniciada. Este status indica que há um problema com a instância de função que está causando a falha ou está impedindo seu início, e deve ser corrigido para que a instância de função possa ser iniciada. Os campos InstanceStateDetails e InstanceErrorCode podem conter informações sobre o erro de função que causou esse estado.

CyclingRole

Indica que uma função falhou continuamente após ser iniciada pelo Azure. Este status indica que há um problema com a função que a está impedindo de iniciar, e pode ser gerado após o recebimento dos status StartingRole e ReadyRole. O problema na função deve ser encontrado e corrigido antes que a função possa ser iniciada. Os campos InstanceStateDetails e InstanceErrorCode podem conter informações sobre o erro da função que causou este estado, que podem ser úteis na identificação e na depuração do problema. O elemento CyclingRole só será retornado se a versão for 2014-02-01 ou inferior.

FailedStartingRole

A função falhou continuamente ao iniciar. Este status indica que há um problema com a instância de função que a está impedindo de iniciar, e talvez seja gerado depois que o processo retorna StartingRole. O problema na função deve ser encontrado e corrigido antes que a função possa ser iniciada. Os campos InstanceStateDetails e InstanceErrorCode podem conter informações sobre o erro da função que causou este estado, que podem ser úteis na identificação e na depuração do problema.

FailedStartingVM

Indica que uma Máquina Virtual falhou continuamente ao ser iniciada. Este status é gerado pelo Azure e não indica um erro com a função. Pode ser gerado após o estado StartingRole.

UnresponsiveRole

Indica que uma instância de função atingiu o tempo limite antes de receber uma mensagem de status e não está respondendo às solicitações.

StoppedDeallocated

Indica que uma instância de função foi parada e todos os recursos alocados foram liberados. Isso interrompe a cobrança da instância de função. Instâncias de função com um status StoppedDeallocated são retornadas apenas na lista de instâncias de função quando a versão é 2013-06-01 ou posterior. Se todas as instâncias de função na implantação tiverem um status StoppedDeallocated, a implantação não será retornada se a versão for inferior a 2013-06-01.

Preparing

Indica que o blob está sendo copiado do local de origem remota. Este status só é devolvido se a versão for de 01.05.14 ou superior.

ExtendedInstanceStatus

Especifica detalhes de status adicionais, se disponíveis para a implantação. Se uma blob estiver sendo copiado a partir de uma localização da origem remota para uma conta de armazenamento, o valor deste elemento contém a porcentagem do blob que foi copiado.

O elemento ExtendedInstanceStatus só estará disponível com a versão 01.05.15 ou superior.

InstanceUpgradeDomain

Especifica o domínio de atualização ao qual a instância de função pertence. Durante uma implantação de atualização, todas as funções no mesmo domínio de atualização são atualizadas ao mesmo tempo.

O elemento InstanceUpgradeDomain só estará disponível com a versão 01/06/2011 ou superior.

InstanceFaultDomain

Especifica o domínio de falha ao qual a instância de função pertence. As instâncias de função no mesmo domínio de falha podem estar vulneráveis à falha de um único hardware.

O elemento InstanceFaultDomain só estará disponível com a versão 01/06/2011 ou superior.

InstanceSize

Especifica o tamanho da instância de função.

O elemento InstanceSize só estará disponível com a versão 01/06/2011 ou superior.

InstanceStateDetails

Fornece um instantâneo do estado da instância de função no momento em que a operação foi chamada.

O elemento InstanceStateDetails só estará disponível com a versão 01.10.11 ou superior.

InstanceErrorCode

O código de erro do início mais recente da função.

Para Máquinas Virtuais, os códigos de erro são:

  • WaitTimeout - a instância de função não se comunicou em 25 minutos. Normalmente, isso indica que ela não foi iniciada ou que o agente convidado não está instalado.

  • VhdTooLarge - a imagem do VHD selecionada era muito grande para a instância de função.

  • AzureInternalError – ocorreu um erro interno que fez a instância de função falhar ao ser iniciada. Contate o suporte para obter ajuda adicional.

Para funções da Web e de trabalho, esse campo retorna um código de erro que pode ser fornecido ao suporte do Azure para auxiliar na resolução de erros. Tipicamente, este campo estará vazio.

O elemento InstanceErrorCode só estará disponível com a versão 01.10.11 ou superior.

IpAddress

Especifica o endereço IP da instância de função (DIP).

O elemento IpAddress só estará disponível com a versão 01.03.12 ou superior.

InstanceEndpoints

Contém a lista de pontos de extremidade de instância para a função.

PowerState

O estado de execução da máquina virtual.

Os seguintes valores são possíveis:

  • Starting

  • Started

  • Stopping

  • Stopped

  • Unknown

HostName

Especifica o nome do host DNS do serviço de nuvem em que a instância de função está sendo executada. Este elemento é listado apenas para implantações de Máquina Virtual.

RemoteAccessCertificateThumbprint

Especifica a impressão digital do certificado de servidor RDP (no Windows) ou do certificado de servidor SSH (no Linux). A impressão digital é usada apenas para Máquinas Virtuais que foram criadas a partir de uma imagem.

O elemento RemoteAccessCertificateThumbprint só estará disponível com a versão 01.08.12 ou superior.

GuestAgentStatus

Especifica informações sobre o agente instalado em uma instância.

O elemento GuestAgentStatus só estará disponível com a versão 01.04.14 ou superior.

ResourceExtensionStatusList

Especifica informações sobre as extensões instaladas em uma instância.

O elemento ResourceExtensionStatusList só estará disponível com a versão 01.04.14 ou superior.

PublicIPs

Opcional. Contém um endereço IP público que pode ser usado em conjunto com o padrão de endereço IP virtual para a máquina virtual.

O elemento PublicIPs só estará disponível com a versão 01.05.14 ou superior.

Contém a lista de pontos de extremidade de instância para a função.

 

Nome do elemento Descrição

Nome

Especifica o nome do ponto de extremidade.

Vip

Especifica o endereço IP virtual do ponto de extremidade.

O elemento Vip só estará disponível com a versão 01/06/2011 ou superior.

PublicPort

Especifica a porta externa que é usada pelo ponto de extremidade.

LocalPort

Especifica a porta interna que é usada pelo ponto de extremidade.

Protocolo

Especifica o protocolo do tráfego no ponto de extremidade.

Especifica informações sobre uma atualização que ocorre na implantação.

 

Nome do elemento Descrição

UpgradeType

Especifica o tipo da atualização.

Os possíveis valores são:

  • Auto

  • Manual

  • Simultaneous

CurrentUpgradeDomainState

Especifica o estado atual da atualização. Os valores possíveis são Before e During.

CurrentUpgradeDomain

Contém um valor inteiro que identifica o domínio de atualização atual. Os domínios de atualização são identificados com um índice baseado em zero: o primeiro domínio de atualização tem a ID "0", o segundo tem a ID "1" e assim por diante.

Contém a lista de funções da implantação.

 

Nome do elemento Descrição

RoleName

Especifica o nome da função.

OsVersion

Especifica a versão do sistema operacional do computador no qual as instâncias de função são executadas.

RoleType

Especifica o tipo da função. Este elemento é listado apenas para implantações de Máquina Virtual e por padrão é PersistentVMRole.

ConfigurationSets

Contém uma coleção de valores que representa parâmetros de configuração do sistema ou do aplicativo.

AvailabilitySetName

Especifica o nome de uma coleção de máquinas virtuais.

DataVirtualHardDisks

Contém os parâmetros que são usados para adicionar um disco de dados a uma Máquina Virtual.

OSVirtualHardDisk

Contém os parâmetros que são usados para criar o disco do sistema operacional para uma Máquina Virtual.

RoleSize

Especifica o tamanho da instância de função.

ProvisionGuestAgent

Opcional. Indica se o VM Agent está instalado na máquina virtual. Para executar uma extensão de recurso em uma Máquina Virtual, esse serviço deverá ser instalado.

Os possíveis valores são:

  • true

  • false

ResourceExtensionReferences

Opcional. Contém uma coleção de extensões de recurso que serão instaladas na Máquina Virtual. Este elemento será usado se ProvisionGuestAgent for definido como true.

Contém uma coleção de objetos que fornecem dados do sistema ou do aplicativo.

 

Nome do elemento Descrição

ConfigurationSetType

Especifica o tipo de configuração para o conjunto de configuração. No momento, isso é sempre definido como NetworkConfiguration.

InputEndpoints

Contém uma coleção de pontos de extremidade externos para uma Máquina Virtual.

SubnetNames

Contém uma lista de nomes de sub-rede de Rede Virtual à qual a implantação pertence.

StaticVirtualNetworkIPAddress

Especifica o endereço IP interno da Máquina Virtual em uma Rede Virtual. Se esse elemento for especificado, o elemento SubnetNames conterá somente uma sub-rede. O endereço IP especificado nesse elemento pertence à sub-rede definida em SubnetNames.

O elemento StaticVirtualNetworkIPAddress só estará disponível com a versão 01.11.13 ou superior.

Contém uma coleção de pontos de extremidade externos para uma Máquina Virtual.

 

Nome do elemento Descrição

LoadBalancedEndpointSetName

Especifica um nome de um conjunto de pontos de extremidade com balanceamento de carga. Este elemento é listado apenas para implantações de Máquina Virtual.

LocalPort

Especifica a porta interna em que a Máquina Virtual está escutando para atender o ponto de extremidade. Este elemento é listado apenas para implantações de Máquina Virtual.

Nome

Especifica o nome para o ponto de extremidade externo. Este elemento é listado apenas para implantações de Máquina Virtual.

Porta

Especifica a porta externa a ser usada para o ponto de extremidade.

LoadBalancerProbe

Contém as configurações de ponto de extremidade que o balanceador de carga do Azure usa para monitorar a disponibilidade de uma Máquina Virtual antes de encaminhar o tráfego para o ponto de extremidade.

LoadBalancerName

Opcional. Especifica o nome do balanceador de carga interno que está associado a este ponto de extremidade. O nome do balanceador de carga interna é especificado no LoadBalancers.

O elemento LoadBalancerName só estará disponível com a versão 01.05.14 ou superior.

Protocolo

Especifica o protocolo de transporte para o ponto de extremidade.

Os possíveis valores são:

  • TCP

  • UDP

Vip

Especifica o endereço IP virtual para o ponto de extremidade.

Contém as configurações de ponto de extremidade que o balanceador de carga do Azure usa para monitorar a disponibilidade de uma Máquina Virtual antes de encaminhar o tráfego para o ponto de extremidade.

 

Nome do elemento Descrição

Caminho

Especifica o nome do caminho relativo a ser inspecionado para determinar o status de disponibilidade. Se Protocolo estiver definido como TCP, esse valor deverá ser NULL.

Exemplo:

path

A sonda usará https://example.com/path para executar a investigação.

Porta

Especifica a porta a ser usada para inspecionar o status de disponibilidade.

Protocolo

Especifica o protocolo a ser usado para inspecionar o status de disponibilidade.

Os possíveis valores são:

  • HTTP

  • TCP

Especifica as configurações personalizadas de DNS especificadas para a implantação.

 

Nome do elemento Descrição

Nome

Especifica o nome do servidor DNS.

Endereço

Especifica o endereço IP do servidor DNS.

Especifica as propriedades usadas para fornecer mais informações sobre uma implantação.

 

Nome do elemento Descrição

Nome

Especifica o nome de uma propriedade que é associada à implantação.

Valor

Especifica o valor de uma propriedade associada à implantação.

Especifica informações sobre quando a Máquina Virtual foi iniciada e parada.

 

Nome do elemento Descrição

StartTime

Especifica a hora em que a Máquina Virtual foi iniciada.

EndTime

Especifica a hora em que a Máquina Virtual foi parada.

Status

Especifica o status da Máquina Virtual.

Contém os endereços IP virtuais especificados para a implantação.

 

Nome do elemento Descrição

Endereço

Especifica o endereço IP virtual da implantação.

IsReserved

Indica se o endereço IP virtual está reservado.

Os possíveis valores são:

  • true

  • false

ReservedIPName

Especifica o nome de um endereço IP reservado que foi atribuído à implantação.

Tipo

Especifica um valor de Private se o endereço IP virtual estiver associado a um balanceador de carga interno.

Contém uma lista de sub-redes às quais a Máquina Virtual pertencerá.

 

Nome do elemento Descrição

SubnetName

Obrigatória. Especifica o nome de uma sub-rede à qual a Máquina Virtual pertence.

Contém os parâmetros que são usados para adicionar um disco de dados a uma Máquina Virtual.

 

Nome do elemento Descrição

HostCaching

Especifica o comportamento do cache da plataforma de blob de disco de dados para a eficiência de leitura/gravação.

Os possíveis valores são:

  • None

  • ReadOnly

  • ReadWrite

O valor padrão é ReadOnly.

DiskName

Especifica o nome do VHD a ser usado para criar o disco de dados para a Máquina Virtual.

Lun

Especifica o Número de Unidade Lógica (LUN) para o disco de dados. O LUN especifica o local em que a unidade de dados aparece quando montada para uso pela Máquina Virtual. Este elemento só será listado quando mais de um disco de dados for anexado a uma Máquina Virtual.

LogicalDiskSizeInGB

Especifica o tamanho, em GB, do disco a ser anexado à Máquina Virtual.

MediaLink

Especifica a localização do VHD associado ao disco no armazenamento do Azure.

Exemplo:

http://example.blob.core.windows.net/disks/mydatadisk.vhd

Contém os parâmetros que são usados para criar o disco do sistema operacional para uma Máquina Virtual.

 

Nome do elemento Descrição

HostCaching

Especifica o comportamento de cache de plataforma do blob de disco do sistema operacional para a eficiência de leitura/gravação.

Os possíveis valores são:

  • ReadOnly

  • ReadWrite

DiskName

Especifica o nome de uma imagem do sistema operacional no repositório de imagens.

MediaLink

Especifica a localização do VHD associado ao disco do sistema operacional no armazenamento do Azure.

SourceImageName

Especifica o nome da imagem de origem usada para criar o disco do sistema operacional.

RemoteSourceImageLink

Especifica um URI para o local onde uma imagem do sistema operacional foi armazenada que é usada para criar a máquina virtual. Esse local pode ser um local diferente do usuário ou repositórios de plataforma no Azure. Uma imagem é sempre associada a um VHD, que é um arquivo .vhd armazenado como um blob de páginas em uma conta de armazenamento. Se você especificar o caminho para uma imagem com este elemento, um VHD associado será criado e você deverá usar o elemento MediaLink para especificar a localização no armazenamento onde o VHD estará localizado. Se esse elemento for usado, o SourceImageName não será usado.

O elemento RemoteSourceImageLink só estará disponível com a versão 01.05.14 ou superior.

SO

Especifica o sistema operacional que está em execução na Máquina Virtual.

Contém uma coleção de extensões de recurso que serão instaladas na Máquina Virtual. Uma extensão de recurso é um componente de software instalado na Máquina Virtual. O VM Agent deve ser instalado na máquina virtual para instalar as extensões de recursos.

 

Nome do elemento Descrição

ResourceExtensionReference

Obrigatória. Especifica as propriedades de uma extensão de recurso que deve ser instalada na Máquina Virtual.

ReferenceName

Obrigatória. Especifica o nome de referência da extensão de recurso.

Publicador

Obrigatória. Especifica o nome do publicador que criou a extensão de recurso. Você pode usar Listar extensões de recurso para localizar o nome do publicador de uma extensão de recurso.

Nome

Obrigatória. Especifica o nome da extensão de recurso. Você pode usar Listar extensões de recurso para localizar os nomes das extensões de recurso disponíveis.

Versão

Obrigatória. Especifica a versão da extensão de recurso. Você pode usar Listar versões da extensão de recurso para localizar a versão da extensão de recurso.

ResourceExtensionParameterValues

Opcional. Contém uma coleção de parâmetros que são passados para a extensão de recurso quando ela é instalada.

Estado

Opcional. Especifica o estado da extensão de recurso.

Os possíveis valores são:

  • Enable

  • Disable

O valor padrão é Enable.

Contém uma coleção de parâmetros que são passados para a extensão de recurso quando ela é instalada.

 

Nome do elemento Descrição

ResourceExtensionParameterValue

Obrigatória. Especifica a chave, o valor e o tipo do parâmetro.

Chave

Obrigatória. Especifica a chave do parâmetro.

Valor

Obrigatória. Especifica o valor codificado na base 64 do parâmetro.

Tipo

Obrigatória. Especifica o tipo da extensão de recurso.

Os possíveis valores são:

  • Public

  • Private

Se esse valor for definido como Private, o parâmetro não será retornado por Get Deployment. Você só pode especificar um parâmetro público e um parâmetro privado para um máximo de dois parâmetros.

Contém extensões que são adicionadas ao serviço de nuvem.

 

Nome do elemento Descrição

AllRoles

Especifica uma lista de extensões aplicadas a todas as funções em uma implantação.

Extensão

Especifica uma extensão que deve ser implantada em uma função em um serviço de nuvem.

NamedRoles

Especifica uma lista de extensões aplicadas a funções específicas em uma implantação.

Especifica uma extensão que deve ser implantada em uma função em um serviço de nuvem.

 

Nome do elemento Descrição

Id

Especifica o identificador da extensão. O identificador é criado quando a extensão é adicionada ao serviço de nuvem. Você pode localizar a Id de uma extensão que foi adicionada a um serviço de nuvem usando Listar extensões.

Especifica uma lista de extensões aplicadas a funções específicas em uma implantação.

 

Nome do elemento Descrição

Função

Especifica uma função específica à qual a extensão é adicionada.

RoleName

Especifica o nome da função.

Extensão

Especifica uma extensão que deve ser implantada em uma função em um serviço de nuvem.

Especifica informações sobre o agente instalado em uma instância.

 

Nome do elemento Descrição

ProtocolVersion

Especifica a versão do protocolo usado pelo agente para comunicar o status.

Carimbo de data/hora

Especifica a hora em formato UTC em que o status foi comunicado.

GuestAgentVersion

Especifica a versão do agente instalada na instância.

Status

Especifica o status do agente.

Os possíveis valores são:

  • Ready

  • NotReady

FormattedMessage

Especifica uma mensagem de status localizada.

Especifica uma mensagem de status localizada.

 

Nome do elemento Descrição

Linguagem

Especifica a linguagem da mensagem.

Message

Especifica a mensagem.

Especifica informações sobre as extensões instaladas em uma instância.

 

Nome do elemento Descrição

ResourceExtensionStatus

Especifica informações sobre determinada extensão.

Especifica informações sobre determinada extensão.

 

Nome do elemento Descrição

HandlerName

Especifica o nome da extensão.

Versão

Especifica a versão da extensão.

Status

Especifica o status da extensão.

Os possíveis valores são:

  • Installing

  • Ready

  • NotReady

  • Unresponsive

Código

Especifica o código de status retornado pela extensão.

FormattedMessage

Especifica uma mensagem de status localizada.

Contém um endereço IP público que pode ser usado em conjunto com o padrão de endereço IP virtual para a máquina virtual.

 

Nome do elemento Descrição

PublicIP

Obrigatória. Especifica um endereço IP público adicional que pode ser usado para se comunicar com a máquina virtual.

Nome

Obrigatória. Especifica o nome do endereço IP público.

Contém uma lista de balanceadores de carga internos que podem ser atribuídos a pontos de extremidade de entrada.

 

Nome do elemento Descrição

LoadBalancer

Obrigatória. Especifica os atributos de um balanceador de carga interno.

Nome

Obrigatória. Especifica o nome de um balanceador de carga interno.

FrontendIpConfiguration

Obrigatória. Especifica a configuração para o endereço IP virtual que é fornecido pelo balanceador de carga.

Tipo

Obrigatória. Especifica o tipo de endereço IP virtual que é fornecido pelo balanceador de carga. O único valor permitido é Private.

SubnetName

Necessário se a implantação existir em uma rede virtual e um StaticVirtualNetworkIPAddress for atribuído. Especifica a sub-rede da rede virtual que o balanceador de carga usa. O endereço IP virtual que é gerido pelo balanceador de carga está contido nesta sub-rede.

StaticVirtualNetworkIPAddress

Opcional. Especifica um endereço IP virtual específico que o balanceador de carga usa da sub-rede na rede virtual.

Para obter os nomes de serviços de nuvem em sua assinatura, você pode usar Listar serviços hospedados.

A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2014 Microsoft