Freigeben über

Abrufen von Cloud-Diensteigenschaften

  • Artikel

Der Vorgang Get Cloud Service Properties ruft Eigenschaften für den angegebenen Cloud-Dienst ab. Diese Eigenschaften umfassen die folgenden Werte:

  • Den Namen und die Beschreibung des Cloud-Diensts.

  • Den Namen der Affinitätsgruppe, der der Cloud-Dienst angehört, oder dessen Speicherort, falls er nicht Mitglied einer Affinitätsgruppe ist.

  • Die Bezeichnung, die zum Nachverfolgen des Cloud-Diensts verwendet werden kann.

  • Das Datum und die Uhrzeit, zu denen der Cloud-Dienst erstellt oder geändert wurde.

  • Falls Details angefordert werden, werden Informationen zu den Bereitstellungen im Cloud-Dienst zurückgegeben.

Anforderung

Die Get Cloud Service Properties-Anforderung kann wie folgt angegeben werden. Ersetzen Sie <subscription-id> durch die Abonnement-ID und <cloudservice-name> durch den Namen des Cloud-Diensts.

Methode Anforderungs-URI
GET https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>

URI-Parameter

URI-Parameter BESCHREIBUNG
embed-detail=true Optional. Gibt an, dass für alle Bereitstellungen im Cloud-Dienst Eigenschaften zurückgegeben werden sollen. Standardwert: false.

Anforderungsheader

In der folgenden Tabelle werden die Anforderungsheader beschrieben.

Anforderungsheader BESCHREIBUNG
x-ms-version Erforderlich. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Dieser Header muss auf 2009-10-01 oder höher festgelegt werden.

Anforderungstext

Keine.

Antwort

Die Antwort enthält den HTTP-Statuscode, einen Satz von Antwortheadern und einen Antworttext.

Statuscode

Bei einem erfolgreichen Vorgang wird der Statuscode 200 (OK) zurückgegeben.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten.

Antwortheader BESCHREIBUNG
x-ms-request-id Ein Wert, der eine für den Verwaltungsdienst ausgeführte Anforderung eindeutig identifiziert.

Antworttext

Das Grundformat für den Antworttext, wenn die Anforderung embed-detail nicht einschließt, wird unten angezeigt:

  
<?xml version="1.0" encoding="utf-8"?>  
<HostedService xmlns="http://schemas.microsoft.com/windowsazure">  
  <Url>hosted-service-url</Url>  
  <ServiceName>hosted-service-name</ServiceName>  
  <HostedServiceProperties>  
    <Description>description</Description>  
    <AffinityGroup>name-of-affinity-group</AffinityGroup>   
    <Location>location-of-service</Location >  
    <Label>base-64-encoded-name-of-service</Label>  
    <Status>current-status-of-service</Status>  
    <DateCreated>creation-date-of-service</DateCreated>  
    <DateLastModified>last-modification-date-of-service</DateLastModified>  
    <ExtendedProperties>  
      <ExtendedProperty>  
        <Name>name-of-property</Name>  
        <Value>value-of-property</Value>  
      </ExtendedProperty>  
    </ExtendedProperties>  
    <ReverseDnsFqdn>reverse-dns-fqdn</ReverseDnsFqdn>  
  </HostedServiceProperties>  
  <DefaultWinRmCertificateThumbprint>thumbprint-of-winrm-certificate</DefaultWinRmCertificateThumbprint>  
</HostedService>

Die folgenden Elemente werden zurückgegeben, wenn embed-detail auf true festgelegt ist:

<?xml version="1.0" encoding="utf-8"?>  
<HostedService xmlns="http://schemas.microsoft.com/windowsazure">  
  <Url>hosted-service-url</Url>  
  <ServiceName>hosted-service-name</ServiceName>  
  <HostedServiceProperties>  
    <Description>description-of-service</Description>  
    <AffinityGroup>name-of-affinity-group</AffinityGroup>  
    <Location>location-of-service</Location>  
    <Label>base-64-encoded-name-of-service</Label>  
    <Status>current-status-of-service</Status>  
    <DateCreated>creation-date-of-service</DateCreated>  
    <DateLastModified>last-modification-date-of-service</DateLastModified>  
    <ExtendedProperties>  
      <ExtendedProperty>  
        <Name>name-of-property</Name>  
        <Value>value-of-property</Value>  
      </ExtendedProperty>  
    </ExtendedProperties>  
    <ReverseDnsFqdn>reverse-dns-fqdn</ReverseDnsFqdn>  
  </HostedServiceProperties>  
  <Deployments>  
    <Deployment xmlns=”http://schemas.microsoft.com/windowsazure”>  
      <Name>name-of-deployment</Name>  
      <DeploymentSlot>current-deployment-environment</DeploymentSlot>  
      <PrivateID>deployment-id</PrivateID>  
      <Status>status-of-deployment</Status>  
      <Label>base64-encoded-name-of-deployment</Label>  
      <Url>deployment-url</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>  
          <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>  
        </RoleInstance>  
      </RoleInstanceList>  
      <UpgradeStatus>  
        <UpgradeType>type-of-upgrade</UpgradeType>  
        <CurrentUpgradeDomainState>status-of-current-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>  
            </ConfigurationSet>  
          </ConfigurationSets>  
        </Role>  
        <Role>  
          <RoleName>name-of-role</RoleName>  
          <OSVersion>operating-system-version</OSVersion>  
          <RoleType>PersistentVMRole</RoleType>  
          <ConfigurationSets>  
            <ConfigurationSet>  
              <ConfigurationSetType>NetworkConfiguration</ConfigurationSetType>  
              <InputEndpoints>  
                <InputEndpoint>  
                  <LoadBalancedEndpointSetName>name-of-load-balanced-endpoint-set</LoadBalancedEndpointSetName>  
                  <LocalPort>internal-facing-port-of-input-endpoint</LocalPort>  
                  <Name>name-of-input-endpoint</Name>  
                  <Port>external-facing-port-of-input-endpoint</Port>  
                  <LoadBalancerProbe>  
                    <Path>path-of-probe</Path>  
                    <Port>port-assigned-to-probe</Port>  
                    <Protocol>protocol-of-probe-port</Protocol>  
                  </LoadBalancerProbe>  
                  <Protocol>protocol-of-input-endpoint</Protocol>  
                  <Vip>virtual-ip-address-of-input-endpoint</Vip>  
                </InputEndpoint>  
              </InputEndpoints>  
              <SubnetNames>  
                <SubnetName>name-of-subnet</SubnetName>  
              </SubnetNames>  
            </ConfigurationSet>  
          </ConfigurationSets>  
          <AvailabilitySetName>name-of-availability-set</AvailabilitySetName>  
          <DataVirtualHardDisks>  
            <DataVirtualHardDisk>  
              <HostCaching>host-caching-mode-of-data-disk</HostCaching>  
              <DiskName>name-of-data-disk</DiskName>  
              <Lun>logical-unit-number-of-data-disk</Lun>  
              <LogicalDiskSizeInGB>size-of-data-disk</LogicalDiskSizeInGB>  
              <MediaLink>path-to-vhd</MediaLink>  
            </DataVirtualHardDisk>  
          </DataVirtualHardDisks>  
          <OSVirtualHardDisk>  
            <HostCaching>host-caching-mode-of-os-disk</HostCaching>  
            <DiskName>name-of-os-disk</DiskName>  
            <MediaLink>path-to-vhd</MediaLink>  
            <SourceImageName>image-used-to-create-os-disk</SourceImageName>  
            <OS>operating-system-on-os-disk</OS>  
          </OSVirtualHardDisk>  
          <RoleSize>size-of-role-instance</RoleSize>  
        </Role>  
      </RoleList>  
      <SdkVersion>sdk-version-used-to-create-package</SdkVersion>  
      <Locked>status-of-deployment-write-allowed</Locked>  
      <RollbackAllowed>rollback-operation-allowed</RollbackAllowed>  
      <CreatedTime>time-of-deployment-creation</CreatedTime>  
      <LastModifiedTime>time-of-last-deployment-modification</LastModifiedTime>  
      <VirtualNetworkName>name-of-virtual-network</VirtualNetworkName>  
      <Dns>  
        <DnsServers>  
          <DnsServer>  
            <Name>name-of-dns-server</Name>  
            <Address>address-of-dns-server</Address>  
          </DnsServer>  
        </DnsServers>  
      </Dns>  
      <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>  
        </VirtualIP>  
      </VirtualIPs>  
    </Deployment>  
  </Deployments>  
  <DefaultWinRmCertificateThumbprint>thumbprint-of-winrm-certificate</DefaultWinRmCertificateThumbprint>  
</HostedService>

In der folgenden Tabelle werden die Elemente im Antworttext beschrieben.

Elementname BESCHREIBUNG
url Gibt die URL an, die dem Cloud-Dienst zugewiesen ist.
Dienstname Gibt den Namen des Cloud-Diensts an. Dieser Name ist der DNS-Präfixname und kann verwendet werden, um auf den Cloud-Dienst zuzugreifen.

Wenn der Cloud-Dienstname beispielsweise MyService lautet, können Sie auf den Cloud-Dienst zugreifen, indem Sie http://MyService.cloudapp.net aufrufen.
HostedServiceProperties Gibt die Eigenschaften an, die dem Cloud-Dienst zugewiesen sind.
DefaultWinRmCertificateThumbprint Gibt den Fingerabdruck des SSL-Zertifikats an, der generiert wurde, als WinRM mit einem HTTPS-Listener definiert wurde und kein Zertifikat in die Definition enthalten war. Der Wert dieser Eigenschaft ist schreibgeschützt und ändert sich nicht, wenn eine ausgeführte Rolleninstanz für die Verwendung eines neuen SSL-Zertifikats aktualisiert wird.
Bereitstellungen Gibt die Bereitstellungen im Cloud-Dienst an.

HostedServiceProperties

Gibt die Eigenschaften an, die dem Cloud-Dienst zugewiesen sind.

Elementname BESCHREIBUNG
BESCHREIBUNG Gibt die Beschreibung des Cloud-Diensts an.
AffinityGroup Gibt den Namen der Affinitätsgruppe an, der der Cloud-Dienst zugeordnet ist. Wenn der Cloud-Dienst einer Affinitätsgruppe zugeordnet ist, wird das Location-Element nicht zurückgegeben.
Standort Gibt den geografischen Standort des Cloud-Diensts in Azure an, wenn der Cloud-Dienst keiner Affinitätsgruppe zugeordnet ist. Wenn ein Standort angegeben wurde, wird das AffinityGroup-Element nicht zurückgegeben.
Bezeichnung Gibt den Base-64-codierten Bezeichner des Cloud-Diensts an. Die Bezeichnung kann verwendet werden, um den Cloud-Dienst für die Nachverfolgung zu identifizieren.
Status Gibt den Status des Cloud-Diensts an.

Mögliche Werte:

- Creating

- Created

- Deleting

- Deleted

- Changing

- ResolvingDns

Das Status Element ist nur mit Version 2012-03-01 oder höher verfügbar.
DateCreated Gibt das Erstellungsdatum des Cloud-Dienst im Format [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z an. Das Datum 2011-05-11T16:15:26Z ist ein Beispiel, das von den Elementen DateCreated oder DateLastModified zurückgegeben werden könnte.

Das DateCreated Element ist nur mit Version 2012-03-01 oder höher verfügbar.
DateLastModified Gibt das letzte Updatedatum des Cloud-Diensts im Format [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z an. Das Datum 2011-05-11T16:15:26Z ist ein Beispiel, das von den Elementen DateCreated oder DateLastModified zurückgegeben werden könnte.

Das DateLastModified Element ist nur mit Version 2012-03-01 oder höher verfügbar.
Name Gibt den Namen einer erweiterten Eigenschaft des Cloud-Diensts an.

Das Name Element ist nur mit Version 2012-03-01 oder höher verfügbar.
Wert Gibt den Wert einer erweiterten Eigenschaft eines Cloud-Diensts an.

Das Value Element ist nur mit Version 2012-03-01 oder höher verfügbar.
ReverseDnsFqdn Optional. Gibt die DNS-Adresse an, in die die IP-Adresse des Cloud-Diensts aufgelöst wird, wenn eine Abfrage mithilfe einer DNS-Rückwärtsabfrage erfolgt.

Das ReverseDnsFqdn Element ist nur mit Version 2014-06-01 oder höher verfügbar.

Bereitstellungen

Gibt die Bereitstellungen im Cloud-Dienst an.

Elementname BESCHREIBUNG
Name Gibt den Namen der Bereitstellung an.
DeploymentSlot Gibt die Umgebung an, in der diese Bereitstellung ausgeführt wird, entweder staging oder production.
PrivateID Gibt den eindeutigen Bezeichner für die Bereitstellung an.
Status Gibt den Status der Bereitstellung an.

Mögliche Werte:

- Running

- Suspended

- RunningTransitioning

- SuspendedTransitioning

- Starting

- Suspending

- Deploying

- Deleting
Bezeichnung Gibt den Base-64-codierten Bezeichner der Bereitstellung an. Die Bezeichnung kann für die Nachverfolgung verwendet werden.
url Gibt die URL an, die für den Zugriff auf den Cloud-Dienst verwendet werden kann.

Wenn der Dienstname beispielsweise MyService lautet, können Sie auf den Dienst zugreifen, indem Sie http://MyService.cloudapp.net aufrufen.
Konfiguration Gibt die Base-64-codierte Konfigurationsdatei der Bereitstellung an.
RoleInstanceList Enthält die Liste der Rolleninstanzen in der Bereitstellung.
UpgradeStatus Gibt Informationen über ein Upgrade an, das für die Bereitstellung ausgeführt wird.
UpgradeDomainCount Gibt die Anzahl der Upgradedomänen an, die für den Cloud-Dienst verfügbar sind.

Das UpgradeDomainCount Element ist nur mit Version 2011-06-01 oder höher verfügbar.
RoleList Enthält die Liste der Rollen in der Bereitstellung.
SdkVersion Gibt die Version des SDKs an, das zum Generieren des Pakets für die Bereitstellung verwendet wurde.

Die ersten beiden numerischen Komponenten der zurückgegebenen Version stellen die Version des SDKs dar, mit dem das Paket erstellt wurde.

Das SdkVersion Element ist nur mit Version 2011-06-01 oder höher verfügbar.
Gesperrt Gibt an, ob die Bereitstellung für neue Schreibvorgänge gesperrt ist. True, falls die Bereitstellung gesperrt ist, weil diese durch einen laufenden Vorgang aktualisiert wird; ansonsten false.

Das Locked Element ist nur mit Version 2011-06-01 oder höher verfügbar.
RollbackAllowed Gibt an, ob der Rollback-Update- oder Upgradevorgang zu diesem Zeitpunkt zulässig ist. True , wenn der Vorgang zulässig ist; andernfalls false.

Das RollbackAllowed Element ist nur mit Version 2011-06-01 oder höher verfügbar.
CreatedTime Gibt die Uhrzeit an, zu der die Bereitstellung erstellt wurde.
LastModifiedTime Gibt die Uhrzeit an, zu der die Bereitstellung zuletzt geändert wurde.
VirtualNetworkName Gibt den Namen des virtuellen Netzwerks an, mit dem der virtuelle Computer eine Verbindung herstellt.

Das VirtualNetworkName Element ist nur mit Version 2012-03-01 oder höher verfügbar.
Dns Gibt die für eine Bereitstellung festgelegten benutzerdefinierten DNS-Einstellungen an.

Das Dns Element ist nur mit Version 2012-03-01 oder höher verfügbar.
ExtendedProperties Gibt die Eigenschaften an, die verwendet werden, um weitere Informationen zu einer Bereitstellung verfügbar zu machen.
PersistentVMDowntime Enthält Informationen dazu, wann der virtuelle Computer gestartet und beendet wurde.

Das PersistentVMDowntime Element ist nur mit Version 2012-03-01 oder höher verfügbar.
VirtualIPs Enthält die für die Bereitstellung angegebenen virtuellen IP-Adressen.

Das VirtualIPs Element ist nur mit Version 2012-03-01 oder höher verfügbar.

RoleInstanceList

Enthält die Liste der Rolleninstanzen in der Bereitstellung.

Elementname BESCHREIBUNG
RoleName Gibt den Namen der Rolle an.
InstanceName Gibt den Namen einer spezifischen Rolleninstanz an, wenn eine Instanz der Rolle ausgeführt wird.
InstanceStatus Gibt den aktuellen Status einer Rolleninstanz an.

RoleStateUnknown :

– Gibt an, dass der Rollenstatus derzeit unbekannt ist.

CreatingVM :

– Gibt an, dass Ressourcen für einen virtuellen Computer erstellt werden.

StartingVM :

– Gibt an, dass ein virtueller Computer gestartet wird.

CreatingRole :

– Gibt an, dass Ressourcen für eine Rolle instance erstellt werden.

StartingRole :

– Gibt an, dass eine Rolle instance gestartet wird.

ReadyRole :

– Gibt an, dass eine Rolle instance gestartet wurde und zur Verwendung bereit ist.

BusyRole :

– Gibt an, dass eine Rolle instance für Anforderungen nicht verfügbar ist. Dieser Status wird in der Regel generiert, während die Rolle erstellt oder beendet wird.

StoppingRole :

– Gibt an, dass eine Rolle instance beendet wird.

StoppingVM :

– Gibt an, dass ein virtueller Computer beendet wird.

DeletingVM :

– Gibt an, dass ein virtueller Computer gelöscht wird.

StoppedVM :

– Gibt an, dass ein virtueller Computer nicht ausgeführt wird. Dies ist der finale Status des Herunterfahrens, und nach StoppedVM sollte keine weitere Statusmeldung empfangen werden.

RestartingRole :

– Gibt an, dass eine Rolle instance unerwartet beendet wurde oder nicht gestartet werden konnte. Dieser Status gibt an, dass ein Problem mit der Rolleninstanz besteht, aufgrund dessen sie abstürzt oder nicht gestartet werden kann. Es muss behoben werden, damit die Rolleninstanz gestartet werden kann. Das InstanceStateDetails-Feld und das InstanceErrorCode-Feld können Informationen zum Fehler enthalten, der diesen Status verursacht hat.

CyclingRole :

– Gibt an, dass die Rolle instance nicht ordnungsgemäß gestartet wird. Dieser Status gibt an, dass ein Problem mit der Rolleninstanz besteht, aufgrund dessen sie nicht gestartet werden kann. Er kann generiert werden, nachdem der StartingRole-Status oder ReadyRole-Status empfangen wurde. Das Problem in der Rolleninstanz muss ermittelt und korrigiert werden, bevor die Rolle gestartet werden kann. Das InstanceStateDetails-Feld und das InstanceErrorCode-Feld können Informationen zum Rollenfehler enthalten, der diesen Status verursacht hat.

FailedStartingRole :

– Gibt an, dass eine Rolle instance nicht gestartet werden konnte. Dieser Status gibt an, dass ein Problem mit der Rolleninstanz besteht, aufgrund dessen sie nicht gestartet werden kann. Es kann verursacht werden, nachdem der Prozess StartingRole zurückgibt. Das Problem in der Rolle muss gefunden und korrigiert werden, bevor die Rolle gestartet werden kann. Die Felder InstanceStateDetails und InstanceErrorCode können Informationen zum Rollenfehler enthalten, der diesen Status verursacht hat. Diese Informationen können hilfreich sein, um das Problem zu identifizieren und zu debuggen.

FailedStartingVM :

– Gibt an, dass ein virtueller Computer kontinuierlich nicht gestartet werden konnte. Dieser Status wird von Azure generiert und weist nicht auf einen Fehler mit der Rolleninstanz hin. Er kann nach dem Status StartingRole generiert werden.

UnresponsiveRole :

– Gibt an, dass für eine Rolle instance ein Timeout aufgetreten ist, bevor eine status Nachricht empfangen wird und nicht auf Anforderungen reagiert.

StoppedDeallocated :

– Gibt an, dass eine Rolle instance beendet und alle zugeordneten Ressourcen freigegeben wurden. Dadurch wird die Abrechnung für die Rolleninstanz beendet. Rolleninstanzen mit dem Status StoppedDeallocated werden nur an die Liste der Rolleninstanzen zurückgegeben, wenn die Version mindestens 2013-06-01 lautet. Wenn alle Rolleninstanzen in der Bereitstellung den Status StoppedDeallocated aufweisen, wird die Bereitstellung nicht zurückgegeben.
InstanceUpgradeDomain Gibt die Updatedomäne an, der die Rolleninstanz angehört. Während einer Upgradebereitstellung werden alle Rolleninstanzen in derselben Updatedomäne gleichzeitig aktualisiert.

Das InstanceUpgradeDomain Element ist nur mit Version 2011-06-01 oder höher verfügbar.
InstanceFaultDomain Gibt die Fehlerdomäne an, der die Rolleninstanz angehört. Alle Rolleninstanzen, die Teil der gleichen Fehlerdomäne sind, sind möglicherweise dem Fehler des gleichen Teils der freigegebenen Hardware ausgesetzt.

Das InstanceFaultDomain Element ist nur mit Version 2011-06-01 oder höher verfügbar.
InstanceSize Gibt die Größe der Rolleninstanz an.

Das InstanceSize Element ist nur mit Version 2011-06-01 oder höher verfügbar.
InstanceStateDetails Stellt eine Momentaufnahme des Status der Rolleninstanz zu dem Zeitpunkt bereit, an dem der Vorgang abgebrochen wurde.

Das InstanceStateDetails Element ist nur mit Version 2011-06-01 oder höher verfügbar.
InstanceErrorCode Virtuelle Computer können die folgenden Fehlercodes aufweisen:

- WaitTimeout: Die Rolle instance nicht innerhalb von 25 Minuten kommuniziert hat. In der Regel bedeutet dies, dass sie nicht gestartet wurde oder dass der Gast-Agent nicht installiert ist.

- VhdTooLarge: Das ausgewählte VHD-Image war zu groß für die Rolle instance.

– AzureInternalError: Es ist ein interner Fehler aufgetreten, der dazu geführt hat, dass die Rolle instance nicht gestartet werden kann. Wenden Sie sich an den Support, um zusätzliche Unterstützung zu erhalten.

Bei Web- und Workerrollen gibt dieses Feld einen Fehlercode zurück, der dem Azure-Support zwecks Fehlerbehebung übermittelt werden kann. In der Regel ist dieses Feld leer.

Das InstanceErrorCode Element ist nur mit Version 2011-10-01 oder höher verfügbar.
IpAddress Gibt die IP-Adresse der Rolleninstanz (DIP) an.

Das IpAddress Element ist nur mit Version 2012-03-01 oder höher verfügbar.
InstanceEndpoints Enthält die Liste der Instanzendpunkte für die Rolle.
PowerState Gibt den Ausführungsstatus der Rolleninstanz an.

Folgende Werte sind möglich:

- Starting

- Started

- Stopping

- Stopped

- Unknown
HostName Gibt den DNS-Hostnamen des Cloud-Diensts an, in dem die Rolleninstanz ausgeführt wird. Dieses Element wird nur für Bereitstellungen des virtuellen Computers aufgeführt.
RemoteAccessCertificateThumbprint Gibt den Fingerabdruck des RDP-Serverzertifikats (in Windows) oder des SSH-Serverzertifikats (in Linux) an. Der Fingerabdruck wird nur für virtuelle Computer verwendet, die aus einem Image erstellt wurden.

Das RemoteAccessCertificateThumbprint Element ist nur mit Version 2012-08-01 oder höher verfügbar.

InstanceEndpoints

Enthält die Liste der Instanzendpunkte für die Rolle.

Elementname BESCHREIBUNG
Name Gibt den Namen des Endpunkts an.
Vip Gibt die virtuelle IP-Adresse des Endpunkts an.

Das Vip Element ist nur mit Version 2011-06-01 oder höher verfügbar.
PublicPort Gibt den vom Endpunkt verwendeten externen Port an.
LocalPort Gibt den vom Endpunkt verwendeten internen Port an.
Protocol Gibt das Protokoll für den Datenverkehr über den Endpunkt an.

UpgradeStatus

Gibt Informationen über ein Upgrade an, das für die Bereitstellung ausgeführt wird.

Elementname BESCHREIBUNG
UpgradeType Gibt den Typ des Upgrades an.

Mögliche Werte:

- Auto

- Manual

- Simultaneous
CurrentUpgradeDomainState Gibt den aktuellen Status des Upgrades an. Mögliche Werte sind Before und During.
CurrentUpgradeDomain Enthält einen ganzzahligen Wert, der die aktuelle Upgradedomäne identifiziert. Upgradedomänen werden anhand eines nullbasierten Index identifiziert: die erste Upgradedomäne hat eine ID von 0, die zweite eine ID von 1 usw.

RoleList

Enthält die Liste der Rollen in der Bereitstellung.

Elementname BESCHREIBUNG
RoleName Gibt den Namen der Rolle an.
OSVersion Gibt die Version des Betriebssystems an, auf dem die Rolleninstanzen ausgeführt werden.
RoleType Gibt den Typ der Rolle an. Dieses Element wird nur für Bereitstellungen des virtuellen Computers aufgelistet und ist standardmäßig PersistentVMRole.
ConfigurationSets Enthält eine Auflistung von Werten, die System- oder Anwendungskonfigurationseinstellungen darstellen.
AvailabilitySetName Gibt den Namen einer Auflistung virtueller Computer an.
DataVirtualHardDisks Enthält die Parameter, mit denen einem virtuellen Computer ein Datenträger hinzugefügt wird.
OSVirtualHardDisk Enthält die Parameter, mit denen der Betriebssystem-Datenträger für einen virtuellen Computer erstellt wird.
RoleSize Gibt die Größe der Rolleninstanz an.

ConfigurationSets

Enthält eine Auflistung von Werten, die System- oder Anwendungskonfigurationseinstellungen darstellen.

Elementname BESCHREIBUNG
ConfigurationSetType Gibt den Konfigurationstyp für den Konfigurationssatz an. Dieser Wert ist derzeit immer auf NetworkConfiguration festgelegt.
InputEndpoints Enthält eine Auflistung externer Endpunkte für einen virtuellen Computer.
SubnetNames Enthält eine Liste mit den Namen der Subnetze des virtuellen Netzwerks, denen die Bereitstellung angehört.

InputEndpoints

Enthält eine Auflistung externer Endpunkte für einen virtuellen Computer.

Elementname BESCHREIBUNG
LoadBalancedEndpointSetName Gibt einen Namen eines Satzes von Endpunkten mit Lastenausgleich an. Dieses Element wird nur für Bereitstellungen des virtuellen Computers aufgeführt.
LocalPort Gibt den internen Port an, an dem der virtuelle Computer für den Endpunkt lauscht. Dieses Element wird nur für Bereitstellungen des virtuellen Computers aufgeführt.
Name Gibt den Namen für den externen Endpunkt an. Dieses Element wird nur für Bereitstellungen des virtuellen Computers aufgeführt.
Port Gibt den für den Endpunkt zu verwendenden externen Port an.
LoadBalancerProbe Enthält die Endpunkteinstellungen, die der Azure-Lastenausgleich zur Überwachung der Verfügbarkeit eines virtuellen Computers verwendet, bevor Datenverkehr an den Endpunkt weitergeleitet wird.
Protocol Gibt das Transportprotokoll für den Endpunkt an.

Folgende Werte sind möglich:

- TCP

- UDP
Vip Gibt die virtuelle IP-Adresse für den Endpunkt an.

LoadBalancerProbe

Enthält die Endpunkteinstellungen, die der Azure-Lastenausgleich zur Überwachung der Verfügbarkeit eines virtuellen Computers verwendet, bevor Datenverkehr an den Endpunkt weitergeleitet wird.

Elementname BESCHREIBUNG
`Path` Gibt den relativen Pfadnamen an, der überprüft werden muss, um den Verfügbarkeitsstatus zu bestimmen. Ist das Protokoll auf TCP festgelegt, muss dieser Wert NULL sein.

Beispiel:

path

Der Test wird verwendet https://example.com/path , um den Test auszuführen.
Port Gibt den Port an, der zur Überprüfung des Verfügbarkeitsstatus verwendet wird.
Protocol Gibt das Protokoll an, das zur Überprüfung des Verfügbarkeitsstatus verwendet wird.

Mögliche Werte:

- HTTP

- TCP

Dns

Gibt die für eine Bereitstellung festgelegten benutzerdefinierten DNS-Einstellungen an.

Elementname BESCHREIBUNG
Name Gibt den Namen des DNS-Servers an.
Adresse Gibt die IP-Adresse des DNS-Servers an.

ExtendedProperties

Gibt die Eigenschaften an, die verwendet werden, um weitere Informationen zu einer Bereitstellung verfügbar zu machen.

Elementname BESCHREIBUNG
Name Gibt den Namen einer Eigenschaft an, die der Bereitstellung zugeordnet ist.
Wert Gibt den Wert einer Eigenschaft an, die der Bereitstellung zugeordnet ist.

PersistentVMDowntime

Enthält Informationen dazu, wann der virtuelle Computer gestartet und beendet wurde.

Elementname BESCHREIBUNG
StartTime Gibt die Startzeit des virtuellen Computers an.
EndTime Gibt die Beendigungszeit des virtuellen Computers an.
Status Gibt den Status des virtuellen Computers an.

VirtualIPs

Enthält die für die Bereitstellung angegebenen virtuellen IP-Adressen.

Elementname Beschreibung
Adresse Gibt die virtuelle IP-Adresse der Bereitstellung an.

DataVirtualHardDisks

Enthält die Parameter, mit denen einem virtuellen Computer ein Datenträger hinzugefügt wird.

Elementname BESCHREIBUNG
HostCaching Gibt das Plattformcachingverhalten des Datenträger-BLOBs für Lese-/Schreibeffizienz an.

Mögliche Werte:

- None

- ReadOnly

- ReadWrite

Der Standardtresor lautet ReadOnly.
DiskName Gibt den Namen der VHD an, die zur Erstellung des Datenträgers für den virtuellen Computer verwendet wird.
Lun Gibt die Nummer der logischen Einheit (LUN) für den Datenträger an. Die LUN gibt den Slot an, in dem das Datenlaufwerk angezeigt wird, wenn es für die Verwendung durch den virtuellen Computer eingebunden wurde. Dieses Element wird nur aufgelistet, wenn mindestens zwei Datenträger an einen virtuellen Computer angefügt sind.
LogicalDiskSizeInGB Gibt die Größe des an den virtuellen Computer anzufügenden Datenträgers in GB an.
MediaLink Gibt an, wo sich die dem Datenträger zugeordnete VHD im Azure-Speicher befindet.

Beispiel:

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

OSVirtualHardDisk

Enthält die Parameter, mit denen der Betriebssystem-Datenträger für einen virtuellen Computer erstellt wird.

Elementname BESCHREIBUNG
HostCaching Gibt das Plattformcachingverhalten des Betriebssystem-Datenträger-BLOBs für Lese-/Schreibeffizienz an.

Mögliche Werte:

- ReadOnly

- ReadWrite
DiskName Gibt den Namen eines Betriebssystemabbilds im Imagerepository an.
MediaLink Gibt an, wo sich die dem Betriebssystem-Datenträger zugeordnete VHD im Azure-Speicher befindet.
SourceImageName Gibt den Namen des Quellimages an, das zum Erstellen des Betriebssystem-Datenträgers verwendet wurde.
OS Gibt das auf dem virtuellen Computer ausgeführte Betriebssystem an.

Hinweise

Um die Namen der Clouddienste in Ihrem Abonnement abzurufen, können Sie List Cloud Services verwenden.