Obter Implementação

Artigo
07/19/2023

A Get Deployment operação devolve as informações de configuração, o estado e as propriedades do sistema para uma implementação.

Pedir

O Get Deployment pedido pode ser utilizado para obter eventos de implementação para um único bloco de implementação (teste ou produção) ou para um nome de implementação específico. Se quiser obter informações por nome de implementação, primeiro tem de obter o nome exclusivo da implementação. Este nome exclusivo faz parte da resposta quando faz um pedido para obter a implementação num bloco de implementação.

Por exemplo, se tiver um serviço cloud implementado no ambiente de produção, pode obter o nome exclusivo ao fazer um pedido para …/deploymentslots/production. A resposta inclui um Name elemento para o serviço cloud. Esse Name valor de elemento pode ser utilizado para fazer um pedido para …/deployments/<Name> se pretender obter informações sobre essa implementação específica.

Para gerar o URI do pedido, substitua <subscription-id> pelo seu ID de subscrição, <cloudservice-name> pelo nome do serviço cloud, <deployment-slot> por staging ou production, ou <deployment-name> pelo nome da implementação.

Método	URI do pedido
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>`

Parâmetros do URI

Nenhum.

Cabeçalhos de Pedido

A tabela seguinte descreve os cabeçalhos do pedido.

Cabeçalho do Pedido	Description
`x-ms-version`	Obrigatório. Especifica a versão da operação a utilizar para este pedido. Este cabeçalho deve ser definido como `2009-10-01` ou superior.

Corpo do Pedido

Nenhum.

Resposta

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

Código de Estado

Uma operação bem-sucedida devolve o código de estado 200 (OK).

Cabeçalhos de Resposta

A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão adicionais.

Cabeçalho de Resposta	Description
`x-ms-request-id`	Um valor que identifica exclusivamente um pedido feito relativamente ao serviço de gestão.

Corpo da Resposta

O exemplo seguinte 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>  
          <ExtensionSettingStatus>  
            <Timestamp>status-report-time</Timestamp>  
            <Name>name-of-setting</Name>  
            <Operation>operation-performed</Operation>  
            <Status>status-of-setting</Status>  
            <Code>status-code</Code>  
            <FormattedMessage>  
              <Language>language-of-status-message</Language>  
              <Message>status-message</Message>  
            </FormattedMessage>  
            <SubStatusList>  
              <SubStatus>  
                <Name>name-of-substatus-object</Name>  
                <Status>status-of-object</Status>  
                <FormattedMessage>  
                  <Language>language-of-message</Language>  
                  <Message>status-message</Message>  
                </FormattedMessage>  
              </SubStatus>                     
            </SubStatusList>  
          </ExtensionSettingStatus>  
        </ResourceExtensionStatus>  
      </ResourceExtensionStatusList>  
      <PublicIPs>  
        <PublicIP>  
          <Name>name-of-public-ip</Name>  
          <Address>ip-address</Address>  
          <IdleTimeoutInMinutes>timeout-for-tcp-idle-connection</IdleTimeoutInMinutes>  
          <DomainNameLabel>domain-label</DomainNameLabel>  
          <Fqdns>  
            <Fqdn>fqdn</Fqdn>  
          </Fqdns>  
        <PublicIP>  
      <PublicIPs>  
      <NetworkInterfaces>  
        <NetworkInterface>  
          <Name>interface-name</Name>  
          <MacAddress>mac-address</MacAddress>  
          <IPConfigurations>  
            <IPConfiguration>  
              <SubnetName>subnet-name</SubnetName>  
              <Address>ip-address</Address>  
            </IPConfiguration>  
          <IPConfigurations>  
        </NetworkInterface>  
      </NetworkInterfaces>  
    </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>  
          <PublicIPs>  
            <PublicIP>  
              <Name>PublicIPName</Name>  
              <StaticVirtualNetworkIPAddress></StaticVirtualNetworkIPAddress>  
              <IdleTimeoutInMinutes></IdleTimeoutInMinutes>  
              <DomainNameLabel>domain-name</DomainNameLabel>  
            </PublicIP>  
          </PublicIPs>  
          <NetworkInterfaces>  
            <NetworkInterface>  
              <Name>interface-name</Name>  
              <IPConfigurations>  
                <IPConfiguration>  
                  <SubnetName>subnet-name</SubnetName>  
                  <StaticVirtualNetworkIPAddress>ip-address</StaticVirtualNetworkIPAddress>  
                </IPConfiguration>  
              </IPConfigurations>  
            </NetworkInterface>  
          <NetworkInterfaces>  
        </ConfigurationSet>  
      </ConfigurationSets>  
    </Role>  
    <Role>  
      <RoleName>name-of-role</RoleName>  
      <OsVersion>operating-system-version</OsVersion>  
      <RoleType>PersistentVMRole</RoleType>  
      <LicenseType>type-of-license</LicenseType>  
      <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>  
              <IdleTimeoutInMinutes>timeout-for-tcp-idle-connection</IdleTimeoutInMinutes>  
              <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>  
          <IOType>IO-Type<IOType>  
        </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>  
        <OS>operating-system-on-os-disk</OS>  
        <RemoteSourceImageLink>path-to-source-image</RemoteSourceImageLink>  
         <IOType>IO-Type<IOType>  
      </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>  
        <SequenceNumber>configuration-sequence</SequenceNumber>  
        <State>state-of-extension</State>  
      </Extension>  
    </AllRoles>  
    <NamedRoles>  
      <Role>  
        <RoleName>role_name1</RoleName>  
        <Extensions>  
          <Extension>  
            <Id>identifier-of-extension</Id>  
            <SequenceNumber>configuration-sequence</SequenceNumber>  
            <State>state-of-extension</State>  
          </Extension>  
        </Extensions>  
      </Role>  
    </NamedRoles>  
  </ExtensionConfiguration>  
  <ReservedIPName>name-of-reserved-ip</ReservedIpName>  
  <InternalDnsSuffix>dns-suffix</InternalDnsSuffix>  
</Deployment>

A tabela seguinte descreve os elementos no corpo da resposta.

Nome do elemento	Descrição
Nome	Especifica o nome da implementação.
DeploymentSlot	Especifica o ambiente no qual o serviço cloud é implementado ou `stagingproduction`.
PrivateID	Especifica um identificador exclusivo gerado internamente para esta implementação.
Estado	Especifica o estado da implementação. Os valores possíveis são: - `Running` - `Suspended` - `RunningTransitioning` - `SuspendedTransitioning` - `Starting` - `Suspending` - `Deploying` - `Deleting`
Etiqueta	Especifica um identificador codificado com base 64 da implementação. Este identificador pode ser utilizado para fins de controlo.
Url	Especifica o URL que é utilizado para aceder ao serviço cloud. Por exemplo, se o nome do serviço for MyService, poderá aceder ao serviço ao chamar: http:// MyService.cloudapp.net
Configuração	Especifica o ficheiro de configuração com codificação base 64 da implementação.
RoleInstanceList	Contém a lista de instâncias de função na implementação.
UpgradeStatus	Contém definições de como a implementação é atualizada.
UpgradeDomainCount	Contém um número inteiro que representa o número total de domínios de atualização para a implementação. O `UpgradeDomainCount` elemento só está disponível com a versão 2011-06-01 ou superior.
Lista de Funções	Contém a lista de funções na implementação.
SdkVersion	Especifica a versão do SDK que foi utilizada para gerar o pacote para a implementação. O `SdkVersion` elemento só está disponível com a versão 2011-06-01 ou superior.
Bloqueado	`True` para impedir uma nova operação de escrita na implementação enquanto está a ser atualizada; caso contrário `false`, . O `Locked` elemento só está disponível com a versão 2011-06-01 ou superior.
RollbackAllowed	`True` se a `RollbackDeploymentUpdateOrUpgrade` operação for permitida na implementação; caso contrário `false`, . O `RollbackAllowed` elemento só está disponível com a versão 2011-06-01 ou superior.
CreatedTime	Especifica a hora em que a implementação foi criada.
LastModifiedTime	Especifica a última vez que a implementação foi modificada.
VirtualNetworkName	Especifica o nome do Rede Virtual ao qual a Máquina Virtual se liga. O `VirtualNetworkName` elemento só está disponível através da versão 2012-03-01 ou superior.
DNS	Contém as definições de DNS especificadas para implementação. O `Dns` elemento só está disponível através da versão 2012-03-01 ou superior.
Balanceadores de Carga	Contém uma lista de balanceadores de carga internos que podem ser atribuídos a pontos finais de entrada. O `LoadBalancers` elemento só está disponível com a versão 2014-05-01 ou superior.
Propriedades Expandidas	Especifica as propriedades que são utilizadas para fornecer mais informações sobre uma implementação.
PersistentVMDowntime	Especifica informações sobre quando a máquina virtual foi iniciada e parada. O `PersistentVMDowntime` elemento só está disponível através da versão 2012-03-01 ou superior.
VirtualIPs	Especifica os endereços IP virtuais para a implementação. O `VirtualIPs` elemento só está disponível através da versão 2012-03-01 ou superior.
ExtensionConfiguration	Especifica uma extensão que é adicionada ao serviço cloud. No Azure, um processo pode ser executado como uma extensão de um serviço cloud. Pode adicionar uma extensão a um serviço cloud utilizando Adicionar Extensão e pode adicionar a extensão à implementação com a Implementação de Atualização ou Alterar a Configuração de Implementação. O `ExtensionConfiguration` elemento só está disponível com a versão 2013-03-01 ou superior.
ReservedIPName	Especifica o nome de um endereço IP reservado que deve ser atribuído à implementação. O `ReservedIPName` elemento só está disponível com a versão 2014-05-01 ou superior.
InternalDnsSuffix	Especifica o sufixo de nome de domínio para a resolução de nomes internos atribuída automaticamente pelo Azure. Todas as instâncias de Máquinas Virtuais numa implementação são automaticamente atribuídas ao sufixo de nome de domínio. Todas as instâncias de funções Web ou funções de trabalho numa implementação são automaticamente atribuídas ao sufixo de nome de domínio quando, pelo menos, uma função é atribuída a um nome de computador com o `vmName` atributo . Uma implementação que esteja numa VNET com um servidor DNS configurado não tem um sufixo de nome de domínio interno. O `InternalDnsSuffix` elemento só está disponível com a versão 2013-11-01 ou superior.

RoleInstanceList

Contém a lista de instâncias de função na implementação.

Nome do elemento	Descrição
RoleName	Especifica o nome da função.
InstanceName	Especifica o nome de uma instância de função específica, se uma instância da função estiver em execução.
InstanceStatus	Especifica o estado atual de uma instância de função. `Unknown` : - Indica que o estado da função é atualmente desconhecido. `CreatingVM` : - Indica que estão a ser criados recursos para uma Máquina Virtual. `StartingVM` : - Indica que está a ser iniciada uma Máquina Virtual. `CreatingRole` : - Indica que estão a ser criados recursos para uma instância de função. `StartingRole` : - Indica que está a ser iniciada uma instância de função. `ReadyRole` : - Indica que uma instância de função foi iniciada e está pronta para ser utilizada. `BusyRole` : - Indica que uma instância de função não está disponível para pedidos. Normalmente, este estado é gerado enquanto a instância de função está a ser criada ou parada. `StoppingRole` : - Indica que uma instância de função está a parar. `StoppingVM` : - Indica que uma Máquina Virtual está a parar. `DeletingVM` : - Indica que uma Máquina Virtual está a ser eliminada. `StoppedVM` : - Indica que uma Máquina Virtual não está em execução. Este é o estado final do processo de encerramento e não devem ser recebidas outras mensagens de estado após `StoppedVM`. `RestartingRole` : - Indica que uma instância de função parou inesperadamente ou não conseguiu iniciar. Este estado indica que existe um problema com a instância de função que está a causar a falha ou a impedi-la de iniciar e tem de ser corrigido antes de a instância de função poder ser iniciada. Os `InstanceStateDetails` campos e `InstanceErrorCode` podem conter informações sobre o erro de função que causou este estado. `CyclingRole` : - Indica que uma função falhou continuamente depois de ter sido iniciada pelo Azure. Este estado indica que existe um problema com a função que o impede de ser iniciado e pode ser gerado depois de os `StartingRoleReadyRole` estados pares serem recebidos. O problema na função tem de ser encontrado e corrigido antes de a função poder ser iniciada. Os `InstanceStateDetails` campos e `InstanceErrorCode` podem conter informações sobre o erro de função que causou este estado, o que pode ser útil para identificar e depurar o problema. O `CyclingRole` elemento só é devolvido se a versão for 2014-02-01 ou inferior. `FailedStartingRole` : - A função falhou continuamente ao iniciar. Este estado indica que existe um problema com a instância de função que o impede de iniciar e pode ser gerado após o processo devolver `StartingRole`. O problema na função tem de ser encontrado e corrigido antes de a função poder ser iniciada. Os `InstanceStateDetails` campos e `InstanceErrorCode` podem conter informações sobre o erro de função que causou este estado, o que pode ser útil para identificar e depurar o problema. `FailedStartingVM` : - Indica que uma Máquina Virtual falhou continuamente ao iniciar. Este estado é gerado pelo Azure e não indica um erro com a função. Pode ser gerado após o `StartingRole` estado. `UnresponsiveRole` : - Indica que uma instância de função excedeu o tempo limite antes de receber uma mensagem de estado e não está a responder aos pedidos. `StoppedDeallocated` : - Indica que uma instância de função foi parada e todos os recursos alocados foram libertados. Esta ação para a faturação da instância de função. As instâncias de função que têm um estado de `StoppedDeallocated` só são devolvidas na lista de instâncias de função se a versão for 2013-06-01 ou superior. Se todas as instâncias de função na implementação tiverem um estado de `StoppedDeallocated`, a implementação não será devolvida se a versão for inferior a 2013-06-01. `Preparing` : - Indica que o blob está a ser copiado da localização de origem remota. Este estado só é devolvido se a versão for 2014-05-01 ou superior.
ExtendedInstanceStatus	Especifica detalhes de estado adicionais se estiverem disponíveis para a implementação. Se um blob estiver a ser copiado de uma localização de origem remota para uma conta de armazenamento, o valor deste elemento contém a percentagem do blob que foi copiado. O `ExtendedInstanceStatus` elemento só está disponível com a versão 2015-05-01 ou superior.
InstanceUpgradeDomain	Especifica o domínio de atualização ao qual pertence a instância de função. Durante uma implementação de atualização, todas as funções no mesmo domínio de atualização são atualizadas ao mesmo tempo. O `InstanceUpgradeDomain` elemento só está disponível com a versão 2011-06-01 ou superior.
InstanceFaultDomain	Especifica o domínio de falha ao qual pertence a instância de função. As instâncias de função no mesmo domínio de falha podem ser vulneráveis à falha de uma única peça de hardware. O `InstanceFaultDomain` elemento só está disponível com a versão 2011-06-01 ou superior.
InstanceSize	Especifica o tamanho da instância de função. O `InstanceSize` elemento só está disponível com a versão 2011-06-01 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 `InstanceStateDetails` elemento só está disponível com a versão 2011-10-01 ou superior.
InstanceErrorCode	O código de erro do início da função mais recente. Para Máquinas Virtuais os códigos de erro são: - WaitTimeout - A instância de função não comunicou no prazo de 25 minutos. Normalmente, isto indica que não foi iniciado ou que o agente convidado não está instalado. - VhdTooLarge – a imagem do VHD selecionada era demasiado grande para a instância de função. - AzureInternalError – ocorreu um erro interno que fez com que a instância da função não iniciasse. Contacte o suporte para obter assistência adicional. Para funções Web e de trabalho, este campo devolve um código de erro que pode ser fornecido ao suporte do Azure para ajudar na resolução de erros. Normalmente, este campo estará vazio. O `InstanceErrorCode` elemento só está disponível com a versão 2011-10-01 ou superior.
IpAddress	Especifica o endereço IP da instância de função (DIP). O `IpAddress` elemento só está disponível com a versão 2012-03-01 ou superior.
InstanceEndpoints	Contém a lista de pontos finais de instância para a função.
PowerState	O estado de execução da máquina virtual. Seguem-se valores possíveis: - `Starting` - `Started` - `Stopping` - `Stopped` - `Unknown`
Nome do Anfitrião	Especifica o nome do anfitrião DNS do serviço cloud no qual a instância de função está em execução. Este elemento só está listado para implementações de Máquinas Virtuais.
RemoteAccessCertificateThumbprint	Especifica o thumbprint do certificado de servidor RDP (no Windows) ou do certificado de servidor SSH (no Linux). O thumbprint só é utilizado para Máquinas Virtuais que foram criadas a partir de uma imagem. O `RemoteAccessCertificateThumbprint` elemento só está disponível com a versão 2012-08-01 ou superior.
GuestAgentStatus	Especifica informações sobre o agente que está instalado numa instância. O `GuestAgentStatus` elemento só está disponível com a versão 2014-04-01 ou superior.
ResourceExtensionStatusList	Especifica informações sobre as extensões instaladas numa instância. O `ResourceExtensionStatusList` elemento só está disponível com a versão 2014-04-01 ou superior.
PublicIPs	Opcional. Contém um endereço IP público que pode ser utilizado para além do endereço IP virtual predefinido para a Máquina Virtual. O `PublicIPs` elemento só está disponível com a versão 2014-05-01 ou superior.
NetworkInterfaces	Opcional, um conjunto de interfaces de rede secundárias. O número de interfaces de rede secundárias permitidas depende do tamanho da máquina virtual. O elemento NetworkInterfaces só está disponível com a versão 2014-08-01 ou superior.

InstanceEndpoints

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

Nome do elemento	Descrição
Nome	Especifica o nome do ponto final.
Vip	Especifica o endereço IP virtual do ponto final. O `Vip` elemento só está disponível com a versão 2011-06-01 ou superior.
PublicPort	Especifica a porta externa utilizada pelo ponto final.
LocalPort	Especifica a porta interna utilizada pelo ponto final.
Protocolo	Especifica o protocolo de tráfego no ponto final.

UpgradeStatus

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

Nome do elemento	Descrição
UpgradeType	Especifica o tipo de atualização. Os valores possíveis 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 um ID de 0, o segundo tem um ID de 1, etc.

RoleList

Contém a lista de funções na implementação.

Nome do elemento	Descrição
RoleName	Especifica o nome da função.
OsVersion	Especifica a versão do sistema operativo na qual as instâncias de função estão em execução.
RoleType	Especifica o tipo de função. Este elemento só está listado para implementações de Máquinas Virtuais e, por predefinição, é `PersistentVMRole`.
LicenseType	Especifica que a imagem ou o disco que está a ser utilizado foi licenciado no local. Este elemento só é utilizado para imagens que contenham o sistema operativo Windows Server. Os valores possíveis são: - Windows_Client - Windows_Server
ConfigurationSets	Contém uma coleção de valores que representa as definições de configuração do sistema ou da aplicação.
AvailabilitySetName	Especifica o nome de uma coleção de máquinas virtuais.
DataVirtualHardDisks	Contém os parâmetros que são utilizados para adicionar um disco de dados a uma Máquina Virtual.
OSVirtualHardDisk	Contém os parâmetros que são utilizados para criar o disco do sistema operativo para uma Máquina Virtual.
RoleSize	Especifica o tamanho da instância de função.
ProvisionGuestAgent	Opcional. Indica se o Agente da VM está instalado na Máquina Virtual. Para executar uma extensão de recurso numa Máquina Virtual, este serviço tem de ser instalado. Os valores possíveis são: - `true` - `false`
ResourceExtensionReferences	Opcional. Contém uma coleção de extensões de recursos que devem ser instaladas na Máquina Virtual. Este elemento é utilizado se ProvisionGuestAgent estiver definido como `true`.

ConfigurationSets

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

Nome do elemento	Descrição
ConfigurationSetType	Especifica o tipo de configuração do conjunto de configuração. Atualmente, está sempre definido como NetworkConfiguration.
InputEndpoints	Contém uma coleção de pontos finais externos para uma Máquina Virtual.
Sub-redes	Contém uma lista de nomes de sub-redes Rede Virtual aos quais a implementação pertence.
PublicIPs	Opcional. Contém um endereço IP público que pode ser utilizado para além do endereço IP virtual predefinido para a Máquina Virtual. O `PublicIPs` elemento só está disponível com a versão 2014-05-01 ou superior.
NetworkInterfaces	Opcional, um conjunto de interfaces de rede secundárias. O número de interfaces de rede secundárias permitidas depende do tamanho da máquina virtual. O elemento NetworkInterfaces só está disponível com a versão 2014-08-01 ou superior.
StaticVirtualNetworkIPAddress	Especifica o endereço IP interno da Máquina Virtual numa Rede Virtual. Se este elemento for especificado, o elemento SubnetNames conterá apenas uma sub-rede. O endereço IP especificado neste elemento pertence à sub-rede definida em Sub-redesNames. O `StaticVirtualNetworkIPAddress` elemento só está disponível com a versão 2013-11-01 ou superior.

InputEndpoints

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

Nome do elemento	Descrição
LoadBalancedEndpointSetName	Especifica um nome de um conjunto de pontos finais com balanceamento de carga. Este elemento só está listado para implementações de Máquinas Virtuais.
LocalPort	Especifica a porta interna na qual a Máquina Virtual está a escutar para servir o ponto final. Este elemento só está listado para implementações de Máquinas Virtuais.
Name	Especifica o nome do ponto final externo. Este elemento só está listado para implementações de Máquinas Virtuais.
Porta	Especifica a porta externa a utilizar para o ponto final.
LoadBalancerProbe	Contém as definições de ponto final que o balanceador de carga do Azure utiliza para monitorizar a disponibilidade de uma Máquina Virtual antes de reencaminhar o tráfego para o ponto final.
LoadBalancerName	Opcional. Especifica o nome do balanceador de carga interno associado a este ponto final. O nome do balanceador de carga interno é especificado em LoadBalancers. O `LoadBalancerName` elemento só está disponível com a versão 2014-05-01 ou superior.
IdleTimeoutInMinutes	Opcional. Especifica o tempo limite para a ligação inativa TCP. O valor pode ser definido entre 4 e 30 minutos. O valor predefinido é 4 minutos. Este elemento só é utilizado quando o protocolo está definido como TCP. O `IdleTimeoutInMinutes` elemento só está disponível com a versão 2014-06-01 ou superior.
Protocolo	Especifica o protocolo de transporte para o ponto final. Os Valores Possíveis são: - `TCP` - `UDP`
Vip	Especifica o endereço IP virtual do ponto final.

LoadBalancerProbe

Contém as definições de ponto final que o balanceador de carga do Azure utiliza para monitorizar a disponibilidade de uma Máquina Virtual antes de reencaminhar o tráfego para o ponto final.

Nome do elemento	Descrição
Caminho	Especifica o nome do caminho relativo a inspecionar para determinar o estado de disponibilidade. Se o Protocolo estiver definido como TCP, este valor tem de ser NULO. Exemplo: caminho A sonda será utilizada `https://example.com/path` para efetuar a pesquisa.
Porta	Especifica a porta a utilizar para inspecionar o estado de disponibilidade.
Protocolo	Especifica o protocolo a utilizar para inspecionar o estado de disponibilidade. Os valores possíveis são: - `HTTP` - `TCP`

Dns

Especifica as definições DNS personalizadas especificadas para implementação.

Nome do elemento	Descrição
Nome	Especifica o nome do servidor DNS.
Endereço	Especifica o endereço IP do servidor DNS.

ExtendedProperties

Especifica as propriedades que são utilizadas para fornecer mais informações sobre uma implementação.

Nome do elemento	Descrição
Nome	Especifica o nome de uma propriedade associada à implementação.
Valor	Especifica o valor de uma propriedade associada à implementação.

PersistentVMDowntime

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.
Estado	Especifica o estado da Máquina Virtual.

VirtualIPs

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

Nome do elemento	Descrição
Endereço	Especifica o endereço IP virtual da implementação.
IsReserved	Indica se o endereço IP virtual está reservado. Os valores possíveis são: - `true` - `false`
ReservedIPName	Especifica o nome de um endereço IP reservado que foi atribuído à implementação.
Tipo	Especifica um valor de `Private` se o endereço IP virtual estiver associado a um balanceador de carga interno.

Sub-redes

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

Nome do elemento	Descrição
SubnetName	Obrigatório. Especifica o nome de uma sub-rede à qual a Máquina Virtual pertence.

DataVirtualHardDisks

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

Nome do elemento	Descrição
HostCaching	Especifica o comportamento de colocação em cache da plataforma do blob do disco de dados para eficiência de leitura/escrita. Os valores possíveis são: - `None` - `ReadOnly` - `ReadWrite` O cofre predefinido é `ReadOnly`.
DiskName	Especifica o nome do VHD a utilizar 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 bloco no qual a unidade de dados é apresentada quando montada para utilização pela Máquina Virtual. Este elemento só é listado quando mais de um disco de dados é anexado a uma Máquina Virtual. Os valores válidos são 0 a 31.
LogicalDiskSizeInGB	Especifica o tamanho, em GB, do disco a anexar à Máquina Virtual.
MediaLink	Especifica a localização no armazenamento do Azure do VHD que está associado ao disco. Exemplo: http://example.blob.core.windows.net/disks/mydatadisk.vhd\|
IOType	Esta propriedade identifica o tipo da conta de armazenamento para o VHD de cópia de segurança. Se o VHD de cópia de segurança estiver numa conta de Armazenamento Aprovisionado, será devolvido "Aprovisionado", caso contrário, será devolvido "Standard". Nota: este valor é preenchido pela plataforma do Azure quando o disco é criado e não pelo utilizador. Esta propriedade só é devolvida com um cabeçalho de versão de 2014-10-01 ou mais recente.

OSVirtualHardDisk

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

Nome do elemento	Descrição
HostCaching	Especifica o comportamento de colocação em cache da plataforma do blob de disco do sistema operativo para eficiência de leitura/escrita. Os valores possíveis são: - `ReadOnly` - `ReadWrite`
DiskName	Especifica o nome de uma imagem do sistema operativo no repositório de imagens.
MediaLink	Especifica a localização no armazenamento do Azure do VHD que está associado ao disco do sistema operativo.
SourceImageName	Especifica o nome da imagem de origem que foi utilizada para criar o disco do sistema operativo.
SO	Especifica o sistema operativo em execução na Máquina Virtual. Os valores possíveis são: - `Windows` - `Linux`
RemoteSourceImageLink	Especifica um URI para a localização onde está armazenada uma imagem do SO que foi utilizada para criar a Máquina Virtual. Esta localização pode ser uma localização diferente dos repositórios de utilizadores ou plataformas no Azure. Uma imagem está sempre associada a um VHD, que é um ficheiro .vhd armazenado como um blob de página numa conta de armazenamento. Se especificar o caminho para uma imagem com este elemento, é criado um VHD associado e tem de utilizar o elemento MediaLink para especificar a localização no armazenamento onde o VHD estará localizado. Se este elemento for utilizado, SourceImageName não é utilizado. O `RemoteSourceImageLink` elemento só está disponível com a versão 2014-05-01 ou superior.
IOType	Esta propriedade identifica o tipo da conta de armazenamento para o VHD de cópia de segurança. Se o VHD de cópia de segurança estiver numa conta de Armazenamento Aprovisionado, será devolvido "Aprovisionado", caso contrário, será devolvido "Standard". Nota: este valor é preenchido pela plataforma do Azure quando o disco é criado e não pelo utilizador. Esta propriedade só é devolvida com um cabeçalho de versão de 2014-10-01 ou mais recente

ResourceExtensionReferences

Contém uma coleção de extensões de recursos que devem ser instaladas na Máquina Virtual. Uma extensão de recurso é um componente de software instalado na Máquina Virtual. O Agente da VM tem de estar instalado na Máquina Virtual para instalar extensões de recursos.

Nome do elemento	Descrição
ResourceExtensionReference	Obrigatório. Especifica as propriedades de uma extensão de recurso que deve ser instalada na Máquina Virtual.
ReferenceName	Obrigatório. Especifica o nome de referência da extensão de recurso.
Publisher	Obrigatório. Especifica o nome do publicador que criou a extensão de recurso. Pode utilizar a opção Listar Extensões de Recursos para encontrar o nome do publicador de uma extensão de recurso.
Name	Obrigatório. Especifica o nome da extensão de recurso. Pode utilizar a opção Listar Extensões de Recursos para encontrar os nomes das extensões de recursos disponíveis.
Versão	Obrigatório. Especifica a versão da extensão de recurso. Pode utilizar As Versões da Extensão de Recurso de Lista para encontrar a versão da extensão de recursos.
ResourceExtensionParameterValues	Opcional. Contém uma coleção de parâmetros que são transmitidos para a extensão de recurso quando é instalada.
Estado	Opcional. Especifica o estado da extensão de recurso. Os valores possíveis são: - `Enable` - `Disable` O valor predefinido é `Enable`.

ResourceExtensionParameterValues

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

Nome do elemento	Descrição
ResourceExtensionParameterValue	Obrigatório. Especifica a chave, o valor e o tipo do parâmetro.
Chave	Obrigatório. Especifica a chave do parâmetro.
Valor	Obrigatório. Especifica o valor codificado base-64 do parâmetro.
Tipo	Obrigatório. Especifica o tipo para a extensão de recurso. Os valores possíveis são: - `Public` - `Private` Se este valor estiver definido como `Private`, o parâmetro não será devolvido por Obter Implementação. Só pode especificar um parâmetro público e um parâmetro privado para um máximo de dois parâmetros.

ExtensionConfiguration

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

Nome do elemento	Descrição
AllRoles	Especifica uma lista de extensões que são aplicadas a todas as funções numa implementação.
Extensão	Especifica uma extensão que deve ser implementada numa função num serviço cloud.
NamedRoles	Especifica uma lista de extensões que são aplicadas a funções específicas numa implementação.

Extensão

Especifica uma extensão que deve ser implementada numa função num serviço cloud.

Nome do elemento	Descrição
Id	Especifica o identificador da extensão. O identificador é criado quando a extensão é adicionada ao serviço cloud. Pode encontrar o ID de uma extensão que foi adicionada a um serviço cloud com Extensões de Lista.
SequenceNumber	Especifica o número da última configuração aplicada para a extensão. Este número é atribuído pelo Azure e é incrementado com todas as alterações de configuração. O `SequenceNumber` elemento só está disponível com a versão 2014-06-01 ou superior.
Estado	Opcional. Especifica o estado da extensão. Este elemento aplica-se apenas a extensões configuradas por JSON. Os valores possíveis são: - `Enable` - `Disable` - `Uninstall` O valor predefinido é `Enable`. O `State` elemento só está disponível com a versão 2014-06-01 ou superior.

NamedRoles

Especifica uma lista de extensões que são aplicadas a funções específicas numa implementaçã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 implementada numa função num serviço cloud.

GuestAgentStatus

Especifica informações sobre o agente que está instalado numa instância.

Nome do elemento	Descrição
ProtocolVersion	Especifica a versão do protocolo que é utilizada pelo agente para relatórios de estado.
CarimboDeDataEHora	Especifica a hora UTC em que o estado foi comunicado.
GuestAgentVersion	Especifica a versão do agente que está instalada na instância.
Estado	Especifica o estado do agente. Os valores possíveis são: - `Ready` - `NotReady`
FormattedMessage	Especifica uma mensagem de estado localizada.

FormattedMessage

Especifica uma mensagem de estado localizada.

Nome do elemento	Descrição
Linguagem	Especifica o idioma da mensagem.
Mensagem	Especifica a mensagem.

ResourceExtensionStatusList

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

Nome do elemento	Descrição
ResourceExtensionStatus	Especifica informações sobre uma extensão específica.

ResourceExtensionStatus

Especifica informações sobre uma extensão específica.

Nome do elemento	Descrição
HandlerName	Especifica o nome da extensão.
Versão	Especifica a versão da extensão.
Estado	Especifica o estado da extensão. Os valores possíveis são: - `Installing` - `Ready` - `NotReady` - `Unresponsive`
Código	Especifica o código de estado devolvido pela extensão.
FormattedMessage	Especifica uma mensagem de estado localizada.
ExtensionSettingStatus	Especifica informações de estado sobre as definições que foram aprovadas para a extensão.

PublicIPs

Contém um endereço IP público que pode ser utilizado para além do endereço IP virtual predefinido para a Máquina Virtual.

Nome do elemento	Descrição
PublicIP	Obrigatório. Especifica um endereço público IP adicional que pode ser utilizado para comunicar com a Máquina Virtual.
Name	Obrigatório. Especifica o nome do endereço IP público.
Endereço	Obrigatório. Especifica o endereço IP para o IP público.
IdleTimeoutInMinutes	Opcional. Especifica o tempo limite para a ligação inativa TCP. O valor pode ser definido entre 4 e 30 minutos. O valor predefinido é 4 minutos. Este elemento só é utilizado quando o protocolo está definido como TCP. O `IdleTimeoutInMinutes` elemento só está disponível com a versão 2014-06-01 ou superior.
DomainNameLabel	Opcional. Especifica a etiqueta de nome de domínio para o IP público. O `DomainNameLabel` elemento só está disponível com a versão 2015-03-01 ou superior.
Fqdn	Opcional. Especifica um FQDN registado para este IP público.

NetworkInterfaces

Contém um conjunto de interfaces de rede secundárias.

Nome do elemento	Descrição
NetworkInterface	Obrigatório. Especifica uma interface de rede secundária.
Name	Obrigatório, Especifica o nome da interface de rede secundária.
IPConfigurations	Obrigatório. Especifica um conjunto de configurações de endereços IP para uma interface de rede secundária.

IPConfigurations

Especifica um conjunto de configurações de endereços IP para uma interface de rede secundária.

Nome do elemento	Descrição
IPConfiguration	Obrigatório. Especifica uma configuração de endereço IP para uma interface de rede secundária. Atualmente, apenas é suportada uma configuração de endereço IP para uma interface de rede secundária.
SubnetName	Obrigatório. Especifica o nome da sub-rede de rede virtual a que esta configuração de endereço IP pertence.
Endereço	Obrigatório, Especifica o endereço IP interno configurado para uma interface de rede secundária.

LoadBalancers

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

Nome do elemento	Descrição
LoadBalancer	Obrigatório. Especifica os atributos de um balanceador de carga interno.
Name	Obrigatório. Especifica o nome do balanceador de carga interno.
FrontendIpConfiguration	Obrigatório. Especifica a configuração do endereço IP virtual fornecido pelo balanceador de carga.
Tipo	Obrigatório. Especifica o tipo de endereço IP virtual fornecido pelo balanceador de carga. O único valor permitido é `Private`.
SubnetName	Necessário se a implementação existir numa rede virtual e for atribuída uma StaticVirtualNetworkIPAddress. Especifica a sub-rede da rede virtual que o balanceador de carga utiliza. O endereço IP virtual 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 utiliza a partir da sub-rede na rede virtual.

ExtensionSettingStatus

Especifica informações de estado sobre as definições que foram aprovadas para a extensão.

Nome do elemento	Descrição
CarimboDeDataEHora	Especifica a hora UTC em que o estado foi comunicado.
Name	Especifica o nome da definição que foi transmitida à extensão.
Operação	Especifica a operação que foi efetuada pela extensão com a definição.
Estado	Especifica o estado da operação. Os valores possíveis são: - `transitioning` - `error` - `success` - `warning`
Código	Especifica o código de estado da operação.
FormattedMessage	Especifica uma mensagem de estado localizada.
SubStatusList	Contém uma lista de informações de estado adicionais, caso existam.

SubStatusList

Contém uma lista de informações de estado adicionais, caso existam.

Nome do elemento	Descrição
Subestado	Contém informações sobre mensagens de estado adicionais devolvidas pela extensão.
Name	Especifica o identificador de estado.
Estado	Especifica o estado da operação. Os valores possíveis são: - `transitioning` - `error` - `success` - `warning`
FormattedMessage	Especifica uma mensagem de estado localizada.

Observações

Para obter os nomes dos serviços cloud na sua subscrição, pode utilizar Lista Serviços Cloud.