Získání nasazení

Článek
07/19/2023

Operace Get Deployment vrátí informace o konfiguraci, stav a systémové vlastnosti pro nasazení.

Žádost

Požadavek Get Deployment lze použít k načtení událostí nasazení pro jeden slot nasazení (přípravný nebo produkční) nebo pro konkrétní název nasazení. Pokud chcete načíst informace podle názvu nasazení, musíte nejprve získat jedinečný název nasazení. Tento jedinečný název je součástí odpovědi, když vytvoříte požadavek na získání nasazení ve slotu nasazení.

Pokud máte například cloudovou službu nasazenou v produkčním prostředí, můžete jedinečný název získat zadáním požadavku na …/deploymentslots/productionadresu . Odpověď obsahuje Name element pro cloudovou službu. Tato Name hodnota prvku se dá použít k vytvoření požadavku na …/deployments/<Name> , pokud chcete načíst informace o konkrétním nasazení.

Pokud chcete vygenerovat identifikátor URI požadavku, nahraďte <subscription-id> názvem vašeho předplatného, <cloudservice-name> názvem cloudové služby <deployment-slot>staging nebo productionnebo <deployment-name> názvem nasazení.

Metoda	Identifikátor URI žádosti
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>`

Parametry identifikátoru URI

Žádné

Hlavičky požadavku

Následující tabulka popisuje hlavičky požadavku.

Hlavička požadavku	Description
`x-ms-version`	Povinná hodnota. Určuje verzi operace, která se má pro tento požadavek použít. Tato hlavička by měla být nastavená na `2009-10-01` hodnotu nebo vyšší.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi a tělo odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK).

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP.

Hlavička odpovědi	Description
`x-ms-request-id`	Hodnota, která jednoznačně identifikuje požadavek provedený na službu správy.

Text odpovědi

Následující příklad ukazuje formát textu odpovědi:

<?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>

Následující tabulka popisuje prvky v textu odpovědi.

Název elementu	Popis
Název	Určuje název nasazení.
DeploymentSlot	Určuje prostředí, do kterého je cloudová služba nasazená, buď `staging` , nebo `production`.
Privátní ID	Určuje jedinečný identifikátor vygenerovaný interně pro toto nasazení.
Stav	Určuje stav nasazení. Možné hodnoty: - `Running` - `Suspended` - `RunningTransitioning` - `SuspendedTransitioning` - `Starting` - `Suspending` - `Deploying` - `Deleting`
Popisek	Určuje identifikátor nasazení s kódováním base-64. Tento identifikátor lze použít pro účely sledování.
URL	Určuje adresu URL, která se používá pro přístup ke cloudové službě. Pokud je například název služby MyService, můžete získat přístup ke službě voláním: http:// MyService.cloudapp.net
Konfigurace	Určuje konfigurační soubor nasazení s kódováním base-64.
RoleInstanceList	Obsahuje seznam instancí rolí v nasazení.
UpgradeStatus	Obsahuje nastavení způsobu upgradu nasazení.
UpgradeDomainCount	Obsahuje celé číslo, které představuje celkový počet upgradovaných domén pro nasazení. Element `UpgradeDomainCount` je k dispozici pouze ve verzi 2011-06-01 nebo vyšší.
Seznam rolí	Obsahuje seznam rolí v nasazení.
SdkVersion	Určuje verzi sady SDK, která se použila k vygenerování balíčku pro nasazení. Element `SdkVersion` je k dispozici pouze ve verzi 2011-06-01 nebo vyšší.
Uzamčeno	`True` aby se zabránilo nové operaci zápisu v nasazení během jeho aktualizace; jinak `false`. Element `Locked` je k dispozici pouze ve verzi 2011-06-01 nebo vyšší.
RollbackAllowed	`TrueRollbackDeploymentUpdateOrUpgrade` pokud je operace v nasazení povolená, jinak `false`. Element `RollbackAllowed` je k dispozici pouze ve verzi 2011-06-01 nebo vyšší.
CreatedTime	Určuje čas vytvoření nasazení.
LastModifiedTime	Určuje čas poslední změny nasazení.
VirtualNetworkName	Určuje název Virtual Network, ke kterým se virtuální počítač připojuje. Element `VirtualNetworkName` je k dispozici pouze ve verzi 2012-03-01 nebo novější.
Dns	Obsahuje nastavení DNS, která jsou určená pro nasazení. Element `Dns` je k dispozici pouze ve verzi 2012-03-01 nebo novější.
Nástroje pro vyrovnávání zatížení	Obsahuje seznam interních nástrojů pro vyrovnávání zatížení, které je možné přiřadit ke vstupním koncovým bodům. Element `LoadBalancers` je k dispozici pouze ve verzi 2014-05-01 nebo novější.
Rozšířené vlastnosti	Určuje vlastnosti, které se používají k poskytování dalších informací o nasazení.
PersistentVMDowntime	Určuje informace o tom, kdy se virtuální počítač spustil a zastavil. Element `PersistentVMDowntime` je k dispozici pouze ve verzi 2012-03-01 nebo novější.
Virtuální IP adresy	Určuje virtuální IP adresy pro nasazení. Element `VirtualIPs` je k dispozici pouze ve verzi 2012-03-01 nebo novější.
Konfigurace rozšíření	Určuje rozšíření, které se přidá do cloudové služby. V Azure může proces běžet jako rozšíření cloudové služby. Rozšíření můžete přidat do cloudové služby pomocí možnosti Přidat rozšíření a rozšíření můžete přidat do nasazení pomocí příkazu Upgradovat nasazení nebo Změnit konfiguraci nasazení. Element `ExtensionConfiguration` je k dispozici pouze ve verzi 2013-03-01 nebo vyšší.
ReservedIPName	Určuje název rezervované IP adresy, která se má přiřadit k nasazení. Element `ReservedIPName` je k dispozici pouze ve verzi 2014-05-01 nebo vyšší.
InternalDnsSuffix	Určuje příponu názvu domény pro interní překlad ip adres, kterou automaticky přiřadí Azure. Všem instancím Virtual Machines v nasazení se automaticky přiřadí přípona názvu domény. Všem instancím webových rolí nebo rolí pracovních procesů v nasazení se automaticky přiřadí přípona názvu domény, pokud je alespoň jedna role přiřazena k názvu počítače pomocí atributu `vmName` . Nasazení, které je ve virtuální síti s nakonfigurovaným serverem DNS, nemá přiřazenou interní příponu názvu domény. Element `InternalDnsSuffix` je k dispozici pouze ve verzi 2013-11-01 nebo vyšší.

RoleInstanceList

Obsahuje seznam instancí rolí v nasazení.

Název elementu	Popis
RoleName (Název role)	Určuje název role.
InstanceName	Určuje název konkrétní instance role, pokud je instance role spuštěná.
InstanceStatus	Určuje aktuální stav instance role. `Unknown` : – Označuje, že stav role je aktuálně neznámý. `CreatingVM` : – Označuje, že se pro virtuální počítač vytvářejí prostředky. `StartingVM` : – Označuje, že se spouští virtuální počítač. `CreatingRole` : – Označuje, že se pro instanci role vytvářejí prostředky. `StartingRole` : – Označuje, že se spouští instance role. `ReadyRole` : – Označuje, že instance role se spustila a je připravená k použití. `BusyRole` : – Označuje, že instance role není pro požadavky k dispozici. Tento stav se obvykle generuje při vytváření nebo zastavování instance role. `StoppingRole` : – Označuje, že se instance role zastavuje. `StoppingVM` : – Označuje, že se virtuální počítač zastavuje. `DeletingVM` : – Označuje, že se odstraňuje virtuální počítač. `StoppedVM` : – Označuje, že virtuální počítač není spuštěný. Toto je konečný stav procesu vypnutí a po `StoppedVM`ukončení by se neměly přijímat žádné další stavové zprávy. `RestartingRole` : – Označuje, že se instance role neočekávaně zastavila nebo se nepodařilo spustit. Tento stav značí, že došlo k problému s instancí role, který způsobuje její chybové ukončení nebo brání jejímu spuštění, a musí být opraven před spuštěním instance role. Pole `InstanceStateDetails` a `InstanceErrorCode` mohou obsahovat informace o chybě role, která způsobila tento stav. `CyclingRole` : – Označuje, že po spuštění Azure došlo k neustálému chybovému ukončení role. Tento stav značí, že došlo k problému s rolí, který brání jejímu spuštění, a může být vygenerován po `StartingRole` přijetí sudých `ReadyRole` stavů. Před spuštěním role je nutné problém v roli najít a opravit. Pole `InstanceStateDetails` a `InstanceErrorCode` mohou obsahovat informace o chybě role, která způsobila tento stav, což může být užitečné pro identifikaci a ladění problému. Element `CyclingRole` je vrácen pouze v případě, že je verze 2014-02-01 nebo nižší. `FailedStartingRole` : – Role se neustále nespustí. Tento stav značí, že došlo k problému s instancí role, který brání jejímu spuštění, a může být vygenerován poté, co proces vrátí `StartingRole`. Před spuštěním role je nutné problém v roli najít a opravit. Pole `InstanceStateDetails` a `InstanceErrorCode` mohou obsahovat informace o chybě role, která způsobila tento stav, což může být užitečné pro identifikaci a ladění problému. `FailedStartingVM` : – Označuje, že virtuální počítač se neustále nespustí. Tento stav vygeneruje Azure a neindikuje chybu s rolí. Může se vygenerovat po stavu `StartingRole` . `UnresponsiveRole` : – Označuje, že u instance role vypršel časový limit před přijetím stavové zprávy a nereaguje na požadavky. `StoppedDeallocated` : – Označuje, že instance role byla zastavena a všechny přidělené prostředky byly uvolněny. Tím se zastaví fakturace instance role. Instance rolí, které mají stav `StoppedDeallocated` role, se v seznamu instancí rolí vrátí jenom v případě, že je verze 2013-06-01 nebo vyšší. Pokud všechny instance rolí v nasazení mají stav `StoppedDeallocated`, nasazení se nevrátí, pokud je verze nižší než 1. 6. 2013. `Preparing` : – Označuje, že objekt blob se kopíruje ze vzdáleného zdrojového umístění. Tento stav se vrátí jenom v případě, že verze je 2014-05-01 nebo vyšší.
ExtendedInstanceStatus	Určuje další podrobnosti o stavu, pokud jsou k dispozici pro nasazení. Pokud se objekt blob kopíruje ze vzdáleného zdrojového umístění do účtu úložiště, hodnota tohoto prvku obsahuje procento zkopírovaného objektu blob. Element `ExtendedInstanceStatus` je k dispozici pouze ve verzi 2015-05-01 nebo vyšší.
InstanceUpgradeDomain	Určuje doménu upgradu, do které instance role patří. Během nasazení upgradu se upgradují všechny role ve stejné upgradované doméně současně. Element `InstanceUpgradeDomain` je k dispozici pouze ve verzi 2011-06-01 nebo vyšší.
InstanceFaultDomain	Určuje doménu selhání, do které instance role patří. Instance rolí ve stejné doméně selhání můžou být ohrožené selháním jedné části hardwaru. Element `InstanceFaultDomain` je k dispozici pouze ve verzi 2011-06-01 nebo vyšší.
InstanceSize	Určuje velikost instance role. Element `InstanceSize` je k dispozici pouze ve verzi 2011-06-01 nebo vyšší.
InstanceStateDetails	Poskytuje snímek stavu instance role v době, kdy byla operace volána. Element `InstanceStateDetails` je k dispozici pouze ve verzi 2011-10-01 nebo vyšší.
InstanceErrorCode	Kód chyby posledního spuštění role Kódy chyb Virtual Machines: – WaitTimeout – instance role nekomunikovala během 25 minut. Obvykle to znamená, že se nespustí nebo že agent hosta není nainstalovaný. – VhdTooLarge – Vybraná image virtuálního pevného disku byla pro instanci role příliš velká. – AzureInternalError – došlo k vnitřní chybě, která způsobila selhání spuštění instance role. Pokud potřebujete další pomoc, obraťte se na podporu. U webových rolí a rolí pracovních procesů toto pole vrátí kód chyby, který lze poskytnout podpora Azure, který pomáhá při řešení chyb. Toto pole bude obvykle prázdné. Element `InstanceErrorCode` je k dispozici pouze ve verzi 2011-10-01 nebo vyšší.
IpAddress	Určuje IP adresu instance role (DIP). Element `IpAddress` je k dispozici pouze ve verzi 2012-03-01 nebo vyšší.
InstanceEndpoints	Obsahuje seznam koncových bodů instance pro roli.
PowerState	Stav, kdy je virtuální počítač spuštěný. Možné hodnoty jsou následující: - `Starting` - `Started` - `Stopping` - `Stopped` - `Unknown`
Název hostitele	Určuje název hostitele DNS cloudové služby, ve které je instance role spuštěná. Tento prvek je uvedený pouze pro nasazení virtuálních počítačů.
RemoteAccessCertificateThumbprint	Určuje kryptografický otisk certifikátu serveru RDP (ve Windows) nebo certifikátu serveru SSH (v Linuxu). Kryptografický otisk se používá jenom pro Virtual Machines, které byly vytvořeny z obrázku. Element `RemoteAccessCertificateThumbprint` je k dispozici pouze ve verzi 2012-08-01 nebo vyšší.
GuestAgentStatus	Určuje informace o agentu nainstalovaném v instanci. Element `GuestAgentStatus` je k dispozici pouze ve verzi 2014-04-01 nebo vyšší.
ResourceExtensionStatusList	Určuje informace o rozšířeních nainstalovaných v instanci. Element `ResourceExtensionStatusList` je k dispozici pouze ve verzi 2014-04-01 nebo vyšší.
Veřejné IP adresy	Nepovinný parametr. Obsahuje veřejnou IP adresu, kterou je možné použít společně s výchozí virtuální IP adresou pro virtuální počítač. Element `PublicIPs` je k dispozici pouze ve verzi 2014-05-01 nebo novější.
NetworkInterfaces	Volitelné: Sada sekundárních síťových rozhraní. Počet povolených sekundárních síťových rozhraní závisí na velikosti virtuálního počítače. Element NetworkInterfaces je k dispozici pouze ve verzi 2014-08-01 nebo vyšší.

Koncové body instance

Obsahuje seznam koncových bodů instance pro roli.

Název elementu	Popis
Název	Určuje název koncového bodu.
Vip	Určuje virtuální IP adresu koncového bodu. Element `Vip` je k dispozici pouze ve verzi 2011-06-01 nebo vyšší.
PublicPort	Určuje externí port používaný koncovým bodem.
LocalPort	Určuje interní port, který koncový bod používá.
Protokol	Určuje protokol provozu na koncovém bodu.

UpgradeStatus

Určuje informace o upgradu, ke kterému dochází v nasazení.

Název elementu	Popis
Typ upgradu	Určuje typ upgradu. Možné hodnoty: - `Auto` - `Manual` - `Simultaneous`
CurrentUpgradeDomainState	Určuje aktuální stav upgradu. Možné hodnoty jsou `Before` a `During`.
CurrentUpgradeDomain	Obsahuje celočíselnou hodnotu, která identifikuje aktuální doménu upgradu. Upgradovací domény se identifikují indexem založeným na nule: první upgradovací doména má ID 0, druhá ID 1 atd.

Seznam rolí

Obsahuje seznam rolí v nasazení.

Název elementu	Popis
RoleName (Název role)	Určuje název role.
OsVersion	Určuje verzi operačního systému, na kterém jsou spuštěné instance rolí.
Typ role	Určuje typ role. Tento prvek je uvedený pouze pro nasazení virtuálních počítačů a ve výchozím nastavení je `PersistentVMRole`.
Typ licence	Určuje, že image nebo disk, který používáte, byly licencovány místně. Tento prvek se používá pouze pro image, které obsahují operační systém Windows Server. Možné hodnoty: - Windows_Client - Windows_Server
Konfigurační sady	Obsahuje kolekci hodnot, které představují nastavení konfigurace systému nebo aplikace.
AvailabilitySetName	Určuje název kolekce virtuálních počítačů.
DataVirtualHardDisks	Obsahuje parametry, které se používají k přidání datového disku do virtuálního počítače.
OSVirtualHardDisk	Obsahuje parametry, které se používají k vytvoření disku operačního systému pro virtuální počítač.
Velikost role	Určuje velikost instance role.
ProvisionGuestAgent	Nepovinný parametr. Určuje, jestli je na virtuálním počítači nainstalovaný agent virtuálního počítače. Pokud chcete spustit rozšíření prostředků na virtuálním počítači, musí být tato služba nainstalovaná. Možné hodnoty: - `true` - `false`
ResourceExtensionReferences	Nepovinný parametr. Obsahuje kolekci rozšíření prostředků, která se mají nainstalovat na virtuální počítač. Tento element se používá, pokud je ProvisionGuestAgent nastavený na `true`hodnotu .

Konfigurační sady

Obsahuje kolekci objektů, které poskytují systémová nebo aplikační data.

Název elementu	Popis
Typ konfigurační sady	Určuje typ konfigurace pro sadu konfigurace. Tato možnost je aktuálně vždy nastavená na NetworkConfiguration.
Vstupní koncové body	Obsahuje kolekci externích koncových bodů pro virtuální počítač.
Názvy podsítí	Obsahuje seznam názvů Virtual Network podsítí, do kterých nasazení patří.
Veřejné IP adresy	Nepovinný parametr. Obsahuje veřejnou IP adresu, kterou je možné použít společně s výchozí virtuální IP adresou pro virtuální počítač. Element `PublicIPs` je k dispozici pouze ve verzi 2014-05-01 nebo novější.
NetworkInterfaces	Volitelné: Sada sekundárních síťových rozhraní. Počet povolených sekundárních síťových rozhraní závisí na velikosti virtuálního počítače. Element NetworkInterfaces je k dispozici pouze ve verzi 2014-08-01 nebo vyšší.
StaticVirtualNetworkIPAddress	Určuje interní IP adresu virtuálního počítače v Virtual Network. Pokud je tento element zadaný, bude element SubnetNames obsahovat pouze jednu podsíť. IP adresa zadaná v tomto elementu patří do podsítě, která je definovaná v podsíti SubnetNames. Element `StaticVirtualNetworkIPAddress` je k dispozici pouze ve verzi 2013-11-01 nebo novější.

Vstupní koncové body

Obsahuje kolekci externích koncových bodů pro virtuální počítač.

Název elementu	Popis
LoadBalancedEndpointSetName	Určuje název sady koncových bodů s vyrovnáváním zatížení. Tento prvek je uvedený pouze pro nasazení virtuálních počítačů.
LocalPort	Určuje interní port, na kterém virtuální počítač naslouchá a obsluhuje koncový bod. Tento prvek je uvedený pouze pro nasazení virtuálních počítačů.
Name	Určuje název externího koncového bodu. Tento prvek je uvedený pouze pro nasazení virtuálních počítačů.
Port	Určuje externí port, který se má použít pro koncový bod.
LoadBalancerProbe	Obsahuje nastavení koncového bodu, které nástroj pro vyrovnávání zatížení Azure používá k monitorování dostupnosti virtuálního počítače před přesměrováním provozu do koncového bodu.
LoadBalancerName	Nepovinný parametr. Určuje název interního nástroje pro vyrovnávání zatížení, který je přidružený k tomuto koncovému bodu. Název interního nástroje pro vyrovnávání zatížení se zadává v nástrojích pro vyrovnávání zatížení. Element `LoadBalancerName` je k dispozici pouze ve verzi 2014-05-01 nebo novější.
IdleTimeoutInMinutes	Nepovinný parametr. Určuje časový limit pro nečinné připojení TCP. Hodnotu je možné nastavit mezi 4 a 30 minut. Výchozí hodnota je 4 minuty. Tento prvek se používá pouze v případě, že je protokol nastaven na TCP. Element `IdleTimeoutInMinutes` je k dispozici pouze ve verzi 2014-06-01 nebo novější.
Protokol	Určuje přenosový protokol pro koncový bod. Možné hodnoty jsou: - `TCP` - `UDP`
Vip	Určuje virtuální IP adresu koncového bodu.

LoadBalancerProbe

Obsahuje nastavení koncového bodu, které nástroj pro vyrovnávání zatížení Azure používá k monitorování dostupnosti virtuálního počítače před přesměrováním provozu do koncového bodu.

Název elementu	Popis
Cesta	Určuje relativní název cesty, který se má zkontrolovat, aby se zjistil stav dostupnosti. Pokud je protokol nastaven na TCP, musí být tato hodnota NULL. Příklad: program Sonda použije `https://example.com/path` k provedení sondy .
Port	Určuje port, který se má použít ke kontrole stavu dostupnosti.
Protokol	Určuje protokol, který se má použít ke kontrole stavu dostupnosti. Možné hodnoty: - `HTTP` - `TCP`

Dns

Určuje vlastní nastavení DNS, která se zadají pro nasazení.

Název elementu	Popis
Název	Určuje název serveru DNS.
Adresa	Určuje IP adresu serveru DNS.

Rozšířené vlastnosti

Určuje vlastnosti, které se používají k poskytování dalších informací o nasazení.

Název elementu	Popis
Název	Určuje název vlastnosti, která je přidružená k nasazení.
Hodnota	Určuje hodnotu vlastnosti, která je přidružena k nasazení.

PersistentVMDowntime

Určuje informace o tom, kdy se virtuální počítač spustil a zastavil.

Název elementu	Popis
StartTime	Určuje čas spuštění virtuálního počítače.
EndTime	Určuje čas zastavení virtuálního počítače.
Stav	Určuje stav virtuálního počítače.

Virtuální IP adresy

Obsahuje virtuální IP adresy zadané pro nasazení.

Název elementu	Popis
Adresa	Určuje virtuální IP adresu nasazení.
IsReserved	Určuje, jestli je virtuální IP adresa vyhrazená. Možné hodnoty: - `true` - `false`
ReservedIPName	Určuje název rezervované IP adresy, která byla přiřazena k nasazení.
Typ	Určuje hodnotu, `Private` pokud je virtuální IP adresa přidružená k internímu nástroji pro vyrovnávání zatížení.

Názvy podsítí

Obsahuje seznam podsítí, do kterých bude virtuální počítač patřit.

Název elementu	Popis
SubnetName	Povinná hodnota. Určuje název podsítě, do které virtuální počítač patří.

DataVirtualHardDisks

Obsahuje parametry, které se používají k přidání datového disku do virtuálního počítače.

Název elementu	Popis
HostCaching	Určuje chování platformy ukládání objektu blob datového disku do mezipaměti pro efektivitu čtení a zápisu. Možné hodnoty: - `None` - `ReadOnly` - `ReadWrite` Výchozí trezor je `ReadOnly`.
DiskName	Určuje název virtuálního pevného disku, který se má použít k vytvoření datového disku pro virtuální počítač.
Lun	Určuje logickou jednotku (LUN) datového disku. LOGICKÁ JEDNOTKA určuje slot, ve kterém se datová jednotka zobrazí po připojení pro použití virtuálním počítačem. Tento prvek je uveden pouze v případě, že je k virtuálnímu počítači připojeno více než jeden datový disk. Platné hodnoty jsou 0 – 31.
LogicalDiskSizeInGB	Určuje velikost disku v GB, který se má připojit k virtuálnímu počítači.
MediaLink	Určuje umístění virtuálního pevného disku přidruženého k disku v úložišti Azure. Příklad: http://example.blob.core.windows.net/disks/mydatadisk.vhd\|
IoType	Tato vlastnost určuje typ účtu úložiště pro záložní virtuální pevný disk. Pokud se záložní virtuální pevný disk nachází ve zřízeném účtu úložiště, vrátí se hodnota Zřízeno, jinak se vrátí hodnota Standard. Poznámka: Tuto hodnotu vyplní platforma Azure při vytvoření disku, nikoli uživatel. Tato vlastnost je vrácena pouze s hlavičkou verze 2014-10-01 nebo novější.

OSVirtualHardDisk

Obsahuje parametry, které se používají k vytvoření disku operačního systému pro virtuální počítač.

Název elementu	Popis
HostCaching	Určuje chování platformy ukládání do mezipaměti objektu blob disku operačního systému pro efektivitu čtení a zápisu. Možné hodnoty: - `ReadOnly` - `ReadWrite`
DiskName	Určuje název image operačního systému v úložišti imagí.
MediaLink	Určuje umístění virtuálního pevného disku přidruženého k disku operačního systému v úložišti Azure.
SourceImageName	Určuje název zdrojové image, která byla použita k vytvoření disku operačního systému.
Operační systém	Určuje operační systém, který běží na virtuálním počítači. Možné hodnoty: - `Windows` - `Linux`
RemoteSourceImageLink	Určuje identifikátor URI umístění, kde je uložená image operačního systému, která se použila k vytvoření virtuálního počítače. Toto umístění může být jiné než úložiště uživatelů nebo platforem v Azure. Image je vždy přidružená k VHD, což je soubor .vhd uložený jako objekt blob stránky v účtu úložiště. Pokud zadáte cestu k bitové kopii s tímto prvkem, vytvoří se přidružený virtuální pevný disk a musíte použít element MediaLink k určení umístění v úložišti, kde bude virtuální pevný disk umístěn. Pokud je tento element použit, SourceImageName se nepoužije. Element `RemoteSourceImageLink` je k dispozici pouze ve verzi 2014-05-01 nebo novější.
IoType	Tato vlastnost určuje typ účtu úložiště pro záložní virtuální pevný disk. Pokud se záložní virtuální pevný disk nachází ve zřízeném účtu úložiště, vrátí se hodnota Zřízeno, jinak se vrátí hodnota Standard. Poznámka: Tuto hodnotu vyplní platforma Azure při vytvoření disku, nikoli uživatel. Tato vlastnost se vrátí pouze s hlavičkou verze 2014-10-01 nebo novější.

ResourceExtensionReferences

Obsahuje kolekci rozšíření prostředků, která se mají nainstalovat na virtuální počítač. Rozšíření prostředků je softwarová komponenta, která je nainstalovaná na virtuálním počítači. Agent virtuálního počítače musí být nainstalovaný na virtuálním počítači, aby bylo možné nainstalovat rozšíření prostředků.

Název elementu	Popis
ResourceExtensionReference	Povinná hodnota. Určuje vlastnosti rozšíření prostředků, které by se mělo nainstalovat na virtuální počítač.
Název odkazu	Povinná hodnota. Určuje název odkazu rozšíření prostředků.
Publisher	Povinná hodnota. Určuje název vydavatele, který vytvořil rozšíření prostředků. Pomocí příkazu List Resource Extensions můžete vyhledat název vydavatele rozšíření prostředků.
Name	Povinná hodnota. Určuje název rozšíření prostředků. Pomocí příkazu List Resource Extensions můžete vyhledat názvy dostupných rozšíření prostředků.
Verze	Povinná hodnota. Určuje verzi rozšíření prostředků. Verzi rozšíření prostředků můžete vyhledat pomocí funkce List Resource Extension Versions .
ResourceExtensionParameterValues	Nepovinný parametr. Obsahuje kolekci parametrů, které se předávají rozšíření prostředků při instalaci.
Stav	Nepovinný parametr. Určuje stav rozšíření prostředků. Možné hodnoty: - `Enable` - `Disable` Výchozí hodnota je `Enable`.

ResourceExtensionParameterValues

Obsahuje kolekci parametrů, které se předávají rozšíření prostředků při instalaci.

Název elementu	Popis
ResourceExtensionParameterValue	Povinná hodnota. Určuje klíč, hodnotu a typ parametru.
Klíč	Povinná hodnota. Určuje klíč parametru .
Hodnota	Povinná hodnota. Určuje hodnotu parametru v kódování base-64.
Typ	Povinná hodnota. Určuje typ rozšíření prostředků. Možné hodnoty: - `Public` - `Private` Pokud je tato hodnota nastavená na `Private`, funkce Get Deployment nevrátí parametr . Můžete zadat pouze jeden veřejný a jeden privátní parametr pro maximálně dva parametry.

Konfigurace rozšíření

Obsahuje rozšíření přidaná do cloudové služby.

Název elementu	Popis
AllRoles	Určuje seznam rozšíření, která se použijí pro všechny role v nasazení.
Rozšíření	Určuje rozšíření, které se má nasadit do role v cloudové službě.
Pojmenované role	Určuje seznam rozšíření, která se použijí na konkrétní role v nasazení.

Rozšíření

Určuje rozšíření, které se má nasadit do role v cloudové službě.

Název elementu	Popis
Id	Určuje identifikátor rozšíření. Identifikátor se vytvoří při přidání rozšíření do cloudové služby. ID rozšíření, které bylo přidáno do cloudové služby, najdete pomocí seznamu rozšíření.
SequenceNumber	Určuje počet naposledy použitých konfigurací rozšíření. Toto číslo přiřazuje Azure a s každou změnou konfigurace se zvýší. Element `SequenceNumber` je k dispozici pouze ve verzi 2014-06-01 nebo vyšší.
Stav	Nepovinný parametr. Určuje stav rozšíření. Tento prvek platí jenom pro rozšíření nakonfigurovaná ve formátu JSON. Možné hodnoty: - `Enable` - `Disable` - `Uninstall` Výchozí hodnota je `Enable`. Element `State` je k dispozici pouze ve verzi 2014-06-01 nebo vyšší.

Pojmenované role

Určuje seznam rozšíření, která se použijí na konkrétní role v nasazení.

Název elementu	Popis
Role	Určuje konkrétní roli, ke které je rozšíření přidáno.
RoleName (Název role)	Určuje název role.
Rozšíření	Určuje rozšíření, které se má nasadit do role v cloudové službě.

GuestAgentStatus

Určuje informace o agentu nainstalovaném v instanci.

Název elementu	Popis
Verze protokolu	Určuje verzi protokolu, kterou agent používá pro generování zpráv o stavu.
Timestamp	Určuje čas UTC, kdy byl nahlášen stav.
GuestAgentVersion	Určuje verzi agenta nainstalovaného v instanci.
Stav	Určuje stav agenta. Možné hodnoty: - `Ready` - `NotReady`
Formátovaná zpráva	Určuje lokalizovanou stavovou zprávu.

Formátovaná zpráva

Určuje lokalizovanou stavovou zprávu.

Název elementu	Popis
Jazyk	Určuje jazyk zprávy.
Zpráva	Určuje zprávu.

ResourceExtensionStatusList

Určuje informace o rozšířeních nainstalovaných v instanci.

Název elementu	Popis
ResourceExtensionStatus	Určuje informace o konkrétním rozšíření.

ResourceExtensionStatus

Určuje informace o konkrétním rozšíření.

Název elementu	Popis
Název obslužné rutiny	Určuje název rozšíření.
Verze	Určuje verzi rozšíření.
Stav	Určuje stav rozšíření. Možné hodnoty: - `Installing` - `Ready` - `NotReady` - `Unresponsive`
Kód	Určuje stavový kód vrácený rozšířením.
Formátovaná zpráva	Určuje lokalizovanou stavovou zprávu.
ExtensionSettingStatus	Určuje informace o stavu nastavení, která byla předána rozšíření.

Veřejné IP adresy

Obsahuje veřejnou IP adresu, kterou je možné použít vedle výchozí virtuální IP adresy pro virtuální počítač.

Název elementu	Popis
PublicIP	Povinná hodnota. Určuje další veřejnou ip adresu, která se dá použít ke komunikaci s virtuálním počítačem.
Name	Povinná hodnota. Určuje název veřejné IP adresy.
Adresa	Povinná hodnota. Určuje IP adresu veřejné IP adresy.
IdleTimeoutInMinutes	Nepovinný parametr. Určuje časový limit nečinných připojení TCP. Hodnotu je možné nastavit na 4 až 30 minut. Výchozí hodnota je 4 minuty. Tento prvek se používá pouze v případě, že je protokol nastaven na TCP. Element `IdleTimeoutInMinutes` je k dispozici pouze ve verzi 2014-06-01 nebo vyšší.
DomainNameLabel	Nepovinný parametr. Určuje popisek názvu domény pro veřejnou IP adresu. Element `DomainNameLabel` je k dispozici pouze ve verzi 2015-03-01 nebo vyšší.
Fqdn	Nepovinný parametr. Určuje plně kvalifikovaný název domény zaregistrovaný pro tuto veřejnou IP adresu.

NetworkInterfaces

Obsahuje sadu sekundárních síťových rozhraní.

Název elementu	Popis
NetworkInterface	Povinná hodnota. Určuje sekundární síťové rozhraní.
Name	Povinné: Určuje název sekundárního síťového rozhraní.
Konfigurace IP adres	Povinná hodnota. Určuje sadu konfigurací IP adres pro sekundární síťové rozhraní.

Konfigurace IP adres

Určuje sadu konfigurací IP adres pro sekundární síťové rozhraní.

Název elementu	Popis
Konfigurace IP adresy	Povinná hodnota. Určuje konfiguraci IP adresy pro sekundární síťové rozhraní. V současné době je pro sekundární síťové rozhraní podporována pouze jedna konfigurace IP adresy.
SubnetName	Povinná hodnota. Určuje název podsítě virtuální sítě, do které patří tato konfigurace IP adresy.
Adresa	Povinné: Určuje interní IP adresu nakonfigurovanou pro sekundární síťové rozhraní.

Nástroje pro vyrovnávání zatížení

Obsahuje seznam interních nástrojů pro vyrovnávání zatížení, které je možné přiřadit vstupním koncovým bodům.

Název elementu	Popis
LoadBalancer	Povinná hodnota. Určuje atributy interního nástroje pro vyrovnávání zatížení.
Name	Povinná hodnota. Určuje název interního nástroje pro vyrovnávání zatížení.
FrontendIpConfiguration	Povinná hodnota. Určuje konfiguraci virtuální IP adresy poskytované nástrojem pro vyrovnávání zatížení.
Typ	Povinná hodnota. Určuje typ virtuální IP adresy, kterou poskytuje nástroj pro vyrovnávání zatížení. Jediná povolená hodnota je `Private`.
SubnetName	Vyžaduje se, pokud nasazení existuje ve virtuální síti a je přiřazená StaticVirtualNetworkIPAddress. Určuje podsíť virtuální sítě, kterou nástroj pro vyrovnávání zatížení používá. Virtuální IP adresa spravovaná nástrojem pro vyrovnávání zatížení je obsažena v této podsíti.
StaticVirtualNetworkIPAddress	Nepovinný parametr. Určuje konkrétní virtuální IP adresu, kterou nástroj pro vyrovnávání zatížení používá z podsítě ve virtuální síti.

ExtensionSettingStatus

Určuje informace o stavu nastavení, která byla předána rozšíření.

Název elementu	Popis
Timestamp	Určuje čas UTC, kdy byl nahlášen stav.
Name	Určuje název nastavení, které bylo předáno rozšíření.
Operace	Určuje operaci, kterou rozšíření provedlo pomocí nastavení.
Stav	Určuje stav operace. Možné hodnoty: - `transitioning` - `error` - `success` - `warning`
Kód	Určuje stavový kód operace.
Formátovaná zpráva	Určuje lokalizovanou stavovou zprávu.
Seznam dílčích statistik	Obsahuje seznam dalších informací o stavu, pokud existuje.

Seznam dílčích statistik

Obsahuje seznam dalších informací o stavu, pokud existuje.

Název elementu	Popis
Dílčí stav	Obsahuje informace o dalších stavových zprávách vrácených rozšířením.
Name	Určuje identifikátor stavu.
Stav	Určuje stav operace. Možné hodnoty: - `transitioning` - `error` - `success` - `warning`
Formátovaná zpráva	Určuje lokalizovanou stavovou zprávu.

Poznámky

Pokud chcete získat názvy cloudových služeb ve vašem předplatném, můžete použít seznam Cloud Services.

Sdílet prostřednictvím