Hämta distribution

Artikel
07/19/2023

Åtgärden Get Deployment returnerar konfigurationsinformation, status och systemegenskaper för en distribution.

Förfrågan

Begäran Get Deployment kan användas för att hämta distributionshändelser för ett enda distributionsfack (mellanlagring eller produktion) eller för ett specifikt distributionsnamn. Om du vill hämta information efter distributionsnamn måste du först hämta det unika namnet för distributionen. Det här unika namnet är en del av svaret när du gör en begäran om att få distributionen i ett distributionsfack.

Om du till exempel har en molntjänst distribuerad till produktionsmiljön kan du hämta det unika namnet genom att göra en begäran till …/deploymentslots/production. Svaret innehåller ett Name element för molntjänsten. Elementvärdet Name kan användas för att skicka en begäran till …/deployments/<Name> om du vill hämta information om den specifika distributionen.

Om du vill generera begärande-URI:n ersätter <subscription-id> du med ditt prenumerations-ID, <cloudservice-name> med namnet på molntjänsten med <deployment-slot>staging eller productioneller <deployment-name> med namnet på distributionen.

Metod	URI för förfrågan
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>`

URI-parametrar

Inga.

Rubriker för begäran

I följande tabell beskrivs begärandehuvudena.

Begärandehuvud	Description
`x-ms-version`	Krävs. Anger vilken version av åtgärden som ska användas för den här begäran. Det här huvudet ska vara inställt på `2009-10-01` eller högre.

Begärandetext

Inga.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext.

Statuskod

En lyckad åtgärd returnerar statuskod 200 (OK).

Svarsrubriker

Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden.

Svarshuvud	Description
`x-ms-request-id`	Ett värde som unikt identifierar en begäran som görs mot hanteringstjänsten.

Svarstext

I följande exempel visas formatet för svarstexten:

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

I följande tabell beskrivs elementen i svarstexten.

Elementnamn	Beskrivning
Name	Anger namnet på distributionen.
DeploymentSlot	Anger den miljö som molntjänsten distribueras till, antingen `staging` eller `production`.
PrivateID	Anger en unik identifierare som genereras internt för den här distributionen.
Status	Anger status för distributionen. Möjliga värden: - `Running` - `Suspended` - `RunningTransitioning` - `SuspendedTransitioning` - `Starting` - `Suspending` - `Deploying` - `Deleting`
Etikett	Anger en base-64-kodad identifierare för distributionen. Den här identifieraren kan användas i spårningssyfte.
URL	Anger den URL som används för att komma åt molntjänsten. Om tjänstnamnet till exempel är MyService kan du komma åt tjänsten genom att anropa: http:// MyService.cloudapp.net
Konfiguration	Anger den base-64-kodade konfigurationsfilen för distributionen.
RoleInstanceList	Innehåller listan över rollinstanser i distributionen.
UpgradeStatus	Innehåller inställningar för hur distributionen uppgraderas.
UpgradeDomainCount	Innehåller ett heltal som representerar det totala antalet uppgraderingsdomäner för distributionen. Elementet `UpgradeDomainCount` är endast tillgängligt med version 2011-06-01 eller senare.
Rolllista	Innehåller listan över roller i distributionen.
SdkVersion	Anger vilken version av SDK som användes för att generera paketet för distributionen. Elementet `SdkVersion` är endast tillgängligt med version 2011-06-01 eller senare.
Låst	`True` för att förhindra en ny skrivåtgärd för distributionen medan den uppdateras; annars `false`. Elementet `Locked` är endast tillgängligt med version 2011-06-01 eller senare.
RollbackAllowed	`True` om åtgärden `RollbackDeploymentUpdateOrUpgrade` tillåts för distributionen, annars `false`. Elementet `RollbackAllowed` är endast tillgängligt med version 2011-06-01 eller senare.
CreatedTime	Anger den tid då distributionen skapades.
LastModifiedTime	Anger den senaste gången distributionen ändrades.
VirtualNetworkName	Anger namnet på den Virtual Network som den virtuella datorn ansluter till. Elementet `VirtualNetworkName` är endast tillgängligt med version 2012-03-01 eller senare.
Dns	Innehåller de DNS-inställningar som har angetts för distribution. Elementet `Dns` är endast tillgängligt med version 2012-03-01 eller senare.
LoadBalancers	Innehåller en lista över interna lastbalanserare som kan tilldelas till indataslutpunkter. Elementet `LoadBalancers` är endast tillgängligt med version 2014-05-01 eller senare.
ExtendedProperties	Anger de egenskaper som används för att ge mer information om en distribution.
PersistentVMDowntime	Anger information om när den virtuella datorn har startats och stoppats. Elementet `PersistentVMDowntime` är endast tillgängligt med version 2012-03-01 eller senare.
VirtualIPs	Anger de virtuella IP-adresserna för distributionen. Elementet `VirtualIPs` är endast tillgängligt med version 2012-03-01 eller senare.
ExtensionConfiguration	Anger ett tillägg som läggs till i molntjänsten. I Azure kan en process köras som ett tillägg för en molntjänst. Du kan lägga till ett tillägg till en molntjänst med hjälp av Lägg till tillägg och du kan lägga till tillägget i distributionen med hjälp av Uppgraderingsdistribution eller Ändra distributionskonfiguration. Elementet `ExtensionConfiguration` är endast tillgängligt med version 2013-03-01 eller senare.
ReservedIPName	Anger namnet på en reserverad IP-adress som ska tilldelas till distributionen. Elementet `ReservedIPName` är endast tillgängligt med version 2014-05-01 eller senare.
InternalDnsSuffix	Anger domännamnssuffixet för intern namnmatchning som tilldelas automatiskt av Azure. Alla instanser av Virtual Machines i en distribution tilldelas automatiskt domännamnssuffixet. Alla instanser av webbroller eller arbetsroller i en distribution tilldelas automatiskt domännamnssuffixet när minst en roll tilldelas ett datornamn med hjälp `vmName` av attributet . En distribution som finns i ett virtuellt nätverk med en KONFIGURERAd DNS-server tilldelas inte ett internt domännamnssuffix. Elementet `InternalDnsSuffix` är endast tillgängligt med version 2013-11-01 eller senare.

RoleInstanceList

Innehåller listan över rollinstanser i distributionen.

Elementnamn	Beskrivning
RoleName	Anger namnet på rollen.
InstanceName	Anger namnet på en specifik rollinstans om en instans av rollen körs.
InstanceStatus	Anger aktuell status för en rollinstans. `Unknown` : – Anger att rolltillståndet för närvarande är okänt. `CreatingVM` : – Anger att resurser skapas för en virtuell dator. `StartingVM` : – Anger att en virtuell dator startas. `CreatingRole` : – Anger att resurser skapas för en rollinstans. `StartingRole` : – Anger att en rollinstans startar. `ReadyRole` : – Anger att en rollinstans har startats och är redo att användas. `BusyRole` : – Anger att en rollinstans inte är tillgänglig för begäranden. Det här tillståndet genereras vanligtvis när rollinstansen skapas eller stoppas. `StoppingRole` : – Anger att en rollinstans stoppas. `StoppingVM` : – Anger att en virtuell dator stoppas. `DeletingVM` : – Anger att en virtuell dator tas bort. `StoppedVM` : – Anger att en virtuell dator inte körs. Det här är det slutliga tillståndet för avstängningsprocessen och inga andra statusmeddelanden ska tas emot efter `StoppedVM`. `RestartingRole` : – Anger att en rollinstans oväntat har stoppats eller inte har startats. Den här statusen anger att det finns ett problem med rollinstansen som gör att den kraschar eller hindrar den från att starta och måste korrigeras innan rollinstansen kan startas. Fälten `InstanceStateDetails` och `InstanceErrorCode` kan innehålla information om rollfelet som orsakade det här tillståndet. `CyclingRole` : – Anger att en roll kontinuerligt har kraschat efter att ha startats av Azure. Den här statusen anger att det finns ett problem med rollen som hindrar den från att starta och kan genereras när de `StartingRole` jämna `ReadyRole` statusarna har tagits emot. Problemet i rollen måste hittas och åtgärdas innan rollen kan startas. Fälten `InstanceStateDetails` och `InstanceErrorCode` kan innehålla information om rollfelet som orsakade det här tillståndet, vilket kan vara användbart för att identifiera och felsöka problemet. Elementet `CyclingRole` returneras endast om versionen är 2014-02-01 eller lägre. `FailedStartingRole` : - Det gick inte att starta rollen. Den här statusen anger att det finns ett problem med rollinstansen som hindrar den från att starta och kan genereras när processen returnerar `StartingRole`. Problemet i rollen måste hittas och åtgärdas innan rollen kan startas. Fälten `InstanceStateDetails` och `InstanceErrorCode` kan innehålla information om rollfelet som orsakade det här tillståndet, vilket kan vara användbart för att identifiera och felsöka problemet. `FailedStartingVM` : – Anger att en virtuell dator kontinuerligt inte kunde starta. Den här statusen genereras av Azure och anger inget fel med rollen. Den kan genereras efter tillståndet `StartingRole` . `UnresponsiveRole` : – Anger att en rollinstans har överskriden tidsgräns innan ett statusmeddelande tas emot och inte svarar på begäranden. `StoppedDeallocated` : – Anger att en rollinstans har stoppats och att alla allokerade resurser har släppts. Detta stoppar faktureringen för rollinstansen. Rollinstanser som har statusen `StoppedDeallocated` returneras endast i rollinstanslistan om versionen är 2013-06-01 eller senare. Om alla rollinstanser i distributionen har statusen `StoppedDeallocated`returneras inte distributionen om versionen är lägre än 2013-06-01. `Preparing` : – Anger att bloben kopieras från fjärrkällans plats. Den här statusen returneras endast om versionen är 2014-05-01 eller senare.
ExtendedInstanceStatus	Anger ytterligare statusinformation om det är tillgängligt för distributionen. Om en blob kopieras från en fjärrkälla till ett lagringskonto innehåller värdet för det här elementet procentandelen av den blob som har kopierats. Elementet `ExtendedInstanceStatus` är endast tillgängligt med version 2015-05-01 eller senare.
InstanceUpgradeDomain	Anger den uppgraderingsdomän som rollinstansen tillhör. Under en uppgraderingsdistribution uppgraderas alla roller i samma uppgraderingsdomän samtidigt. Elementet `InstanceUpgradeDomain` är endast tillgängligt med version 2011-06-01 eller senare.
InstanceFaultDomain	Anger den feldomän som rollinstansen tillhör. Rollinstanser i samma feldomän kan vara sårbara för fel på en enskild maskinvarudel. Elementet `InstanceFaultDomain` är endast tillgängligt med version 2011-06-01 eller senare.
InstanceSize	Anger storleken på rollinstansen. Elementet `InstanceSize` är endast tillgängligt med version 2011-06-01 eller senare.
InstanceStateDetails	Ger en ögonblicksbild av rollinstansens tillstånd när åtgärden anropades. Elementet `InstanceStateDetails` är endast tillgängligt med version 2011-10-01 eller senare.
InstanceErrorCode	Felkoden för den senaste rollstarten. För Virtual Machines felkoderna är: - WaitTimeout – Rollinstansen kommunicerade inte inom 25 minuter. Detta indikerar vanligtvis att den inte startades eller att gästagenten inte är installerad. – VhdTooLarge – Den valda VHD-avbildningen var för stor för rollinstansen. – AzureInternalError – Ett internt fel har inträffat som har orsakat att rollinstansen inte startar. Kontakta supporten för ytterligare hjälp. För webb- och arbetsroller returnerar det här fältet en felkod som kan anges för Azure Support för att hjälpa till att lösa fel. Det här fältet är vanligtvis tomt. Elementet `InstanceErrorCode` är endast tillgängligt med version 2011-10-01 eller senare.
Ip	Anger IP-adressen för rollinstansen (DIP). Elementet `IpAddress` är endast tillgängligt med version 2012-03-01 eller senare.
InstanceEndpoints	Innehåller listan över instansslutpunkter för rollen.
PowerState	Den virtuella datorns körningstillstånd. Följande är möjliga värden: - `Starting` - `Started` - `Stopping` - `Stopped` - `Unknown`
HostName	Anger DNS-värdnamnet för den molntjänst där rollinstansen körs. Det här elementet visas endast för distributioner av virtuella datorer.
RemoteAccessCertificateThumbprint	Anger tumavtrycket för RDP-servercertifikatet (i Windows) eller SSH-servercertifikatet (i Linux). Tumavtrycket används bara för Virtual Machines som har skapats från en bild. Elementet `RemoteAccessCertificateThumbprint` är endast tillgängligt med version 2012-08-01 eller senare.
GuestAgentStatus	Anger information om agenten som är installerad på en instans. Elementet `GuestAgentStatus` är endast tillgängligt med version 2014-04-01 eller senare.
ResourceExtensionStatusList	Anger information om de tillägg som är installerade på en instans. Elementet `ResourceExtensionStatusList` är endast tillgängligt med version 2014-04-01 eller senare.
PublicIPs	Valfritt. Innehåller en offentlig IP-adress som kan användas utöver den virtuella ip-standardadressen för den virtuella datorn. Elementet `PublicIPs` är endast tillgängligt med version 2014-05-01 eller senare.
NetworkInterfaces	Valfritt, En uppsättning sekundära nätverksgränssnitt. Antalet sekundära nätverksgränssnitt som tillåts beror på storleken på den virtuella datorn. NetworkInterfaces-elementet är endast tillgängligt med version 2014-08-01 eller senare.

InstanceEndpoints

Innehåller listan över instansslutpunkter för rollen.

Elementnamn	Beskrivning
Name	Anger namnet på slutpunkten.
Vip	Anger slutpunktens virtuella IP-adress. Elementet `Vip` är endast tillgängligt med version 2011-06-01 eller senare.
PublicPort	Anger den externa port som används av slutpunkten.
LocalPort	Anger den interna port som används av slutpunkten.
Protokoll	Anger trafikprotokollet på slutpunkten.

UpgradeStatus

Anger information om en uppgradering som sker i distributionen.

Elementnamn	Beskrivning
UpgradeType	Anger typen av uppgradering. Möjliga värden: - `Auto` - `Manual` - `Simultaneous`
CurrentUpgradeDomainState	Anger uppgraderingens aktuella tillstånd. Möjliga värden är `Before` och `During`.
CurrentUpgradeDomain	Innehåller ett heltalsvärde som identifierar den aktuella uppgraderingsdomänen. Uppgraderingsdomäner identifieras med ett nollbaserat index: den första uppgraderingsdomänen har ett ID på 0, den andra har ett ID på 1 och så vidare.

Rolllista

Innehåller listan över roller i distributionen.

Elementnamn	Beskrivning
RoleName	Anger namnet på rollen.
OsVersion	Anger vilken version av operativsystemet som rollinstanserna körs på.
RoleType	Anger typen av roll. Det här elementet visas endast för distributioner av virtuella datorer och är `PersistentVMRole`som standard .
Licenstyp	Anger att avbildningen eller disken som används har licensierats lokalt. Det här elementet används endast för avbildningar som innehåller Windows Server-operativsystemet. Möjliga värden: - Windows_Client - Windows_Server
ConfigurationSets	Innehåller en samling värden som representerar system- eller programkonfigurationsinställningar.
AvailabilitySetName	Anger namnet på en samling virtuella datorer.
DataVirtualHardDisks	Innehåller de parametrar som används för att lägga till en datadisk i en virtuell dator.
OSVirtualHardDisk	Innehåller de parametrar som används för att skapa operativsystemdisken för en virtuell dator.
RoleSize	Anger storleken på rollinstansen.
ProvisionGuestAgent	Valfritt. Anger om VM-agenten är installerad på den virtuella datorn. Om du vill köra ett resurstillägg på en virtuell dator måste den här tjänsten vara installerad. Möjliga värden: - `true` - `false`
ResourceExtensionReferences	Valfritt. Innehåller en samling resurstillägg som ska installeras på den virtuella datorn. Det här elementet används om ProvisionGuestAgent är inställt på `true`.

ConfigurationSets

Innehåller en samling objekt som tillhandahåller system- eller programdata.

Elementnamn	Beskrivning
ConfigurationSetType	Anger konfigurationstypen för konfigurationsuppsättningen. Detta är för närvarande alltid inställt på NetworkConfiguration.
InputEndpoints	Innehåller en samling externa slutpunkter för en virtuell dator.
Undernätnamn	Innehåller en lista över Virtual Network undernätsnamn som distributionen tillhör.
PublicIPs	Valfritt. Innehåller en offentlig IP-adress som kan användas utöver den virtuella ip-standardadressen för den virtuella datorn. Elementet `PublicIPs` är endast tillgängligt med version 2014-05-01 eller senare.
NetworkInterfaces	Valfritt, En uppsättning sekundära nätverksgränssnitt. Antalet sekundära nätverksgränssnitt som tillåts beror på storleken på den virtuella datorn. NetworkInterfaces-elementet är endast tillgängligt med version 2014-08-01 eller senare.
StaticVirtualNetworkIPAddress	Anger den interna IP-adressen för den virtuella datorn i en Virtual Network. Om det här elementet anges innehåller subnetNames-elementet bara ett undernät. IP-adressen som anges i det här elementet tillhör det undernät som har definierats i SubnetNames. Elementet `StaticVirtualNetworkIPAddress` är endast tillgängligt med version 2013-11-01 eller senare.

InputEndpoints

Innehåller en samling externa slutpunkter för en virtuell dator.

Elementnamn	Beskrivning
LoadBalancedEndpointSetName	Anger ett namn på en uppsättning belastningsutjämningsslutpunkter. Det här elementet visas bara för distributioner av virtuella datorer.
LocalPort	Anger den interna porten som den virtuella datorn lyssnar på för att hantera slutpunkten. Det här elementet visas bara för distributioner av virtuella datorer.
Name	Anger namnet på den externa slutpunkten. Det här elementet visas bara för distributioner av virtuella datorer.
Port	Anger den externa port som ska användas för slutpunkten.
LoadBalancerProbe	Innehåller de slutpunktsinställningar som Azure-lastbalanseraren använder för att övervaka tillgängligheten för en virtuell dator innan trafik vidarebefordras till slutpunkten.
LoadBalancerName	Valfritt. Anger namnet på den interna lastbalanseraren som är associerad med den här slutpunkten. Det interna lastbalanserarens namn anges i LoadBalancers. Elementet `LoadBalancerName` är endast tillgängligt med version 2014-05-01 eller senare.
IdleTimeoutInMinutes	Valfritt. Anger tidsgränsen för TCP-inaktiv anslutning. Värdet kan anges mellan 4 och 30 minuter. Standardvärdet är 4 minuter. Det här elementet används bara när protokollet är inställt på TCP. Elementet `IdleTimeoutInMinutes` är endast tillgängligt med version 2014-06-01 eller senare.
Protokoll	Anger transportprotokollet för slutpunkten. Möjliga värden är: - `TCP` - `UDP`
Vip	Anger den virtuella IP-adressen för slutpunkten.

LoadBalancerProbe

Innehåller de slutpunktsinställningar som Azure-lastbalanseraren använder för att övervaka tillgängligheten för en virtuell dator innan trafik vidarebefordras till slutpunkten.

Elementnamn	Beskrivning
Sökväg	Anger det relativa sökvägsnamnet som ska kontrolleras för att fastställa tillgänglighetsstatusen. Om Protokoll är inställt på TCP måste det här värdet vara NULL. Exempel: path Avsökningen används `https://example.com/path` för att utföra avsökningen.
Port	Anger vilken port som ska användas för att kontrollera tillgänglighetsstatusen.
Protokoll	Anger vilket protokoll som ska användas för att kontrollera tillgänglighetsstatusen. Möjliga värden: - `HTTP` - `TCP`

DNS

Anger de anpassade DNS-inställningar som har angetts för distribution.

Elementnamn	Beskrivning
Name	Anger namnet på DNS-servern.
Adress	Anger IP-adressen för DNS-servern.

ExtendedProperties

Anger de egenskaper som används för att ge mer information om en distribution.

Elementnamn	Beskrivning
Name	Anger namnet på en egenskap som är associerad med distributionen.
Värde	Anger värdet för en egenskap som är associerad med distributionen.

PersistentVMDowntime

Anger information om när den virtuella datorn har startats och stoppats.

Elementnamn	Beskrivning
StartTime	Anger den tid då den virtuella datorn startades.
EndTime	Anger den tid då den virtuella datorn stoppades.
Status	Anger status för den virtuella datorn.

VirtualIPs

Innehåller de virtuella IP-adresser som har angetts för distributionen.

Elementnamn	Beskrivning
Adress	Anger distributionens virtuella IP-adress.
IsReserved	Anger om den virtuella IP-adressen är reserverad. Möjliga värden: - `true` - `false`
ReservedIPName	Anger namnet på en reserverad IP-adress som har tilldelats distributionen.
Typ	Anger värdet `Private` om den virtuella IP-adressen är associerad med en intern lastbalanserare.

Undernätsnamn

Innehåller en lista över undernät som den virtuella datorn ska tillhöra.

Elementnamn	Beskrivning
Undernätnamn	Krävs. Anger namnet på ett undernät som den virtuella datorn tillhör.

DataVirtualHardDisks

Innehåller de parametrar som används för att lägga till en datadisk till en virtuell dator.

Elementnamn	Beskrivning
HostCaching	Anger plattformscachelagringsbeteendet för datadiskbloben för läs-/skriveffektivitet. Möjliga värden: - `None` - `ReadOnly` - `ReadWrite` Standardvalvet är `ReadOnly`.
DiskName	Anger namnet på den virtuella hårddisk som ska användas för att skapa datadisken för den virtuella datorn.
Lun	Anger LUN (Logical Unit Number) för datadisken. LUN anger det fack där dataenheten visas när den monteras för användning av den virtuella datorn. Det här elementet visas bara när mer än en datadisk är ansluten till en virtuell dator. Giltiga värden är 0–31.
LogicalDiskSizeInGB	Anger storleken i GB på disken som ska anslutas till den virtuella datorn.
MediaLink	Anger platsen i Azure Storage för den virtuella hårddisk som är associerad med disken. Exempel: http://example.blob.core.windows.net/disks/mydatadisk.vhd\|
IOType	Den här egenskapen identifierar typen av lagringskonto för den säkerhetskopierade virtuella hårddisken. Om den säkerhetskopierade virtuella hårddisken finns i ett etablerat lagringskonto returneras "Etablerad" annars returneras "Standard". Obs! Det här värdet fylls i av Azure-plattformen när disken skapas, inte av användaren. Den här egenskapen returneras endast med ett versionshuvud för 2014-10-01 eller senare.

OSVirtualHardDisk

Innehåller de parametrar som används för att skapa operativsystemdisken för en virtuell dator.

Elementnamn	Beskrivning
HostCaching	Anger plattformscachelagringsbeteendet för operativsystemets diskblob för läs-/skriveffektivitet. Möjliga värden: - `ReadOnly` - `ReadWrite`
DiskName	Anger namnet på en operativsystemavbildning på avbildningslagringsplatsen.
MediaLink	Anger platsen i Azure Storage för den virtuella hårddisk som är associerad med operativsystemdisken.
SourceImageName	Anger namnet på källavbildningen som användes för att skapa operativsystemdisken.
Operativsystem	Anger det operativsystem som körs på den virtuella datorn. Möjliga värden: - `Windows` - `Linux`
RemoteSourceImageLink	Anger en URI till den plats där en OS-avbildning lagras som användes för att skapa den virtuella datorn. Den här platsen kan vara en annan plats än användarens eller plattformens lagringsplatser i Azure. En avbildning är alltid associerad med en virtuell hårddisk, som är en VHD-fil som lagras som en sidblob i ett lagringskonto. Om du anger sökvägen till en avbildning med det här elementet skapas en associerad virtuell hårddisk och du måste använda MediaLink-elementet för att ange den plats i lagringen där den virtuella hårddisken ska finnas. Om det här elementet används används inte SourceImageName. Elementet `RemoteSourceImageLink` är endast tillgängligt med version 2014-05-01 eller senare.
IOType	Den här egenskapen identifierar typen av lagringskonto för den säkerhetskopierade virtuella hårddisken. Om den säkerhetskopierade virtuella hårddisken finns i ett etablerat lagringskonto returneras "Etablerad" annars returneras "Standard". Obs! Det här värdet fylls i av Azure-plattformen när disken skapas, inte av användaren. Den här egenskapen returneras endast med ett versionshuvud för 2014-10-01 eller senare

ResourceExtensionReferences

Innehåller en samling resurstillägg som ska installeras på den virtuella datorn. Ett resurstillägg är en programvarukomponent som är installerad på den virtuella datorn. VM-agenten måste vara installerad på den virtuella datorn för att kunna installera resurstillägg.

Elementnamn	Beskrivning
ResourceExtensionReference	Krävs. Anger egenskaperna för ett resurstillägg som ska installeras på den virtuella datorn.
ReferenceName	Krävs. Anger referensnamnet för resurstillägget.
Publisher	Krävs. Anger namnet på utgivaren som skapade resurstillägget. Du kan använda List Resource Extensions för att hitta utgivarnamnet för ett resurstillägg.
Name	Krävs. Anger namnet på resurstillägget. Du kan använda List Resource Extensions för att hitta namnen på tillgängliga resurstillägg.
Version	Krävs. Anger versionen av resurstillägget. Du kan använda listresurstilläggsversioner för att hitta versionen av resurstillägget.
ResourceExtensionParameterValues	Valfritt. Innehåller en samling parametrar som skickas till resurstillägget när det installeras.
Tillstånd	Valfritt. Anger tillståndet för resurstillägget. Möjliga värden: - `Enable` - `Disable` Standardvärdet är `Enable`.

ResourceExtensionParameterValues

Innehåller en samling parametrar som skickas till resurstillägget när det installeras.

Elementnamn	Beskrivning
ResourceExtensionParameterValue	Krävs. Anger parameterns nyckel, värde och typ.
Nyckel	Krävs. Anger nyckeln för parametern.
Värde	Krävs. Anger parameterns base-64-kodade värde.
Typ	Krävs. Anger typen för resurstillägget. Möjliga värden: - `Public` - `Private` Om det här värdet är inställt på `Private`returneras inte parametern av Hämta distribution. Du kan bara ange en offentlig parameter och en privat parameter för högst två parametrar.

ExtensionConfiguration

Innehåller tillägg som läggs till i molntjänsten.

Elementnamn	Beskrivning
AllRoles	Anger en lista över tillägg som tillämpas på alla roller i en distribution.
Förlängning	Anger ett tillägg som ska distribueras till en roll i en molntjänst.
NamedRoles	Anger en lista över tillägg som tillämpas på specifika roller i en distribution.

Filnamnstillägg

Anger ett tillägg som ska distribueras till en roll i en molntjänst.

Elementnamn	Beskrivning
Id	Anger tilläggets identifierare. Identifieraren skapas när tillägget läggs till i molntjänsten. Du hittar ID:t för ett tillägg som har lagts till i en molntjänst med hjälp av Listtillägg.
SequenceNumber	Anger numret för den senast tillämpade konfigurationen för tillägget. Det här numret tilldelas av Azure och ökas med varje konfigurationsändring. Elementet `SequenceNumber` är endast tillgängligt med version 2014-06-01 eller senare.
Tillstånd	Valfritt. Anger tillståndet för tillägget. Det här elementet gäller endast för JSON-konfigurerade tillägg. Möjliga värden: - `Enable` - `Disable` - `Uninstall` Standardvärdet är `Enable`. Elementet `State` är endast tillgängligt med version 2014-06-01 eller senare.

NamedRoles

Anger en lista över tillägg som tillämpas på specifika roller i en distribution.

Elementnamn	Beskrivning
Roll	Anger en specifik roll som tillägget läggs till i.
RoleName	Anger namnet på rollen.
Förlängning	Anger ett tillägg som ska distribueras till en roll i en molntjänst.

GuestAgentStatus

Anger information om agenten som är installerad på en instans.

Elementnamn	Beskrivning
ProtocolVersion	Anger vilken version av protokollet som används av agenten för statusrapportering.
Timestamp	Anger UTC-tiden när statusen rapporterades.
GuestAgentVersion	Anger vilken version av agenten som är installerad på instansen.
Status	Anger status för agenten. Möjliga värden: - `Ready` - `NotReady`
FormattedMessage	Anger ett lokaliserat statusmeddelande.

FormattedMessage

Anger ett lokaliserat statusmeddelande.

Elementnamn	Beskrivning
Språk	Anger språket i meddelandet.
Meddelande	Anger meddelandet.

ResourceExtensionStatusList

Anger information om de tillägg som är installerade på en instans.

Elementnamn	Beskrivning
ResourceExtensionStatus	Anger information om ett specifikt tillägg.

ResourceExtensionStatus

Anger information om ett specifikt tillägg.

Elementnamn	Beskrivning
HandlerName	Anger namnet på tillägget.
Version	Anger versionen av tillägget.
Status	Anger status för tillägget. Möjliga värden: - `Installing` - `Ready` - `NotReady` - `Unresponsive`
Kod	Anger statuskoden som returneras av tillägget.
FormattedMessage	Anger ett lokaliserat statusmeddelande.
ExtensionSettingStatus	Anger statusinformation om de inställningar som skickades till tillägget.

Offentliga IP-adresser

Innehåller en offentlig IP-adress som kan användas utöver den virtuella ip-standardadressen för den virtuella datorn.

Elementnamn	Beskrivning
PublicIP	Krävs. Anger ytterligare en offentlig IP-adress som kan användas för att kommunicera med den virtuella datorn.
Name	Krävs. Anger namnet på den offentliga IP-adressen.
Adress	Krävs. Anger IP-adressen för den offentliga IP-adressen.
IdleTimeoutInMinutes	Valfritt. Anger tidsgränsen för TCP-inaktiv anslutning. Värdet kan anges mellan 4 och 30 minuter. Standardvärdet är 4 minuter. Det här elementet används bara när protokollet är inställt på TCP. Elementet `IdleTimeoutInMinutes` är endast tillgängligt med version 2014-06-01 eller senare.
DomainNameLabel	Valfritt. Anger domännamnsetiketten för den offentliga IP-adressen. Elementet `DomainNameLabel` är endast tillgängligt med version 2015-03-01 eller senare.
Fqdn	Valfritt. Anger ett FQDN som registrerats för den här offentliga IP-adressen.

NetworkInterfaces

Innehåller en uppsättning sekundära nätverksgränssnitt.

Elementnamn	Beskrivning
Nätverksgränssnitt	Krävs. Anger ett sekundärt nätverksgränssnitt.
Name	Obligatoriskt anger namnet på det sekundära nätverksgränssnittet.
IPConfigurations	Krävs. Anger en uppsättning IP-adresskonfigurationer för ett sekundärt nätverksgränssnitt.

IPConfigurations

Anger en uppsättning IP-adresskonfigurationer för ett sekundärt nätverksgränssnitt.

Elementnamn	Beskrivning
IPConfiguration	Krävs. Anger en IP-adresskonfiguration för ett sekundärt nätverksgränssnitt. För närvarande stöds endast en IP-adresskonfiguration för ett sekundärt nätverksgränssnitt.
Undernätnamn	Krävs. Anger namnet på det virtuella nätverksundernätet som ip-adresskonfigurationen tillhör.
Adress	Obligatoriskt anger den interna IP-adressen som konfigurerats för ett sekundärt nätverksgränssnitt.

LoadBalancers

Innehåller en lista över interna lastbalanserare som kan tilldelas till indataslutpunkter.

Elementnamn	Beskrivning
LoadBalancer	Krävs. Anger attributen för en intern lastbalanserare.
Name	Krävs. Anger namnet på den interna lastbalanseraren.
FrontendIpConfiguration	Krävs. Anger konfigurationen för den virtuella IP-adress som tillhandahålls av lastbalanseraren.
Typ	Krävs. Anger vilken typ av virtuell IP-adress som tillhandahålls av lastbalanseraren. Det enda tillåtna värdet är `Private`.
Undernätnamn	Krävs om distributionen finns i ett virtuellt nätverk och en StaticVirtualNetworkIPAddress tilldelas. Anger undernätet för det virtuella nätverk som lastbalanseraren använder. Den virtuella IP-adressen som hanteras av lastbalanseraren finns i det här undernätet.
StaticVirtualNetworkIPAddress	Valfritt. Anger en specifik virtuell IP-adress som lastbalanseraren använder från undernätet i det virtuella nätverket.

ExtensionSettingStatus

Anger statusinformation om de inställningar som skickades till tillägget.

Elementnamn	Beskrivning
Timestamp	Anger UTC-tiden när statusen rapporterades.
Name	Anger namnet på den inställning som skickades till tillägget.
Åtgärd	Anger den åtgärd som utfördes av tillägget med hjälp av inställningen .
Status	Anger status för åtgärden. Möjliga värden: - `transitioning` - `error` - `success` - `warning`
Kod	Anger statuskoden för åtgärden.
FormattedMessage	Anger ett lokaliserat statusmeddelande.
SubStatusList	Innehåller en lista med ytterligare statusinformation om den finns.

SubStatusList

Innehåller en lista med ytterligare statusinformation om den finns.

Elementnamn	Beskrivning
Understatus-	Innehåller information om ytterligare statusmeddelanden som returneras av tillägget.
Name	Anger statusidentifieraren.
Status	Anger status för åtgärden. Möjliga värden: - `transitioning` - `error` - `success` - `warning`
FormattedMessage	Anger ett lokaliserat statusmeddelande.

Kommentarer

Om du vill hämta namnen på molntjänster i din prenumeration kan du använda List Cloud Services.

Dela via