Cloud Services - List

Referenz

Service:: Compute

API Version:: 2022-09-04

Ruft eine Liste aller Clouddienste unter einer Ressourcengruppe ab. Verwenden Sie die nextLink-Eigenschaft in der Antwort, um die nächste Seite von Cloud Services abzurufen. Führen Sie dies aus, bis nextLink null ist, um alle Cloud Services abzurufen.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/cloudServices?api-version=2022-09-04

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Name der Ressourcengruppe
subscriptionId	path	True	string	Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.
api-version	query	True	string	Client-API-Version.

Antworten

Name	Typ	Beschreibung
200 OK	CloudServiceListResult	OK
Other Status Codes	CloudError	Fehler

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Beschreibung
user_impersonation	Annehmen der Identität Ihres Benutzerkontos

Beispiele

List Cloud Services in a Resource Group

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Compute/cloudServices?api-version=2022-09-04

/** Samples for CloudServices ListByResourceGroup. */
public final class Main {
    /*
     * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/CloudserviceRP/stable/2022-09-04/examples/CloudService_List_ByResourceGroup.json
     */
    /**
     * Sample code: List Cloud Services in a Resource Group.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listCloudServicesInAResourceGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure
            .virtualMachines()
            .manager()
            .serviceClient()
            .getCloudServices()
            .listByResourceGroup("ConstosoRG", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v5"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/c78b5d8bd3aff2d82a5f034d9164b1a9ac030e09/specification/compute/resource-manager/Microsoft.Compute/CloudserviceRP/stable/2022-09-04/examples/CloudService_List_ByResourceGroup.json
func ExampleCloudServicesClient_NewListPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewCloudServicesClient().NewListPager("ConstosoRG", nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.CloudServiceListResult = armcompute.CloudServiceListResult{
		// 	Value: []*armcompute.CloudService{
		// 		{
		// 			Name: to.Ptr("{cs-name}"),
		// 			Type: to.Ptr("Microsoft.Compute/cloudServices"),
		// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Compute/cloudServices/{cs-name}"),
		// 			Location: to.Ptr("eastus2euap"),
		// 			Properties: &armcompute.CloudServiceProperties{
		// 				Configuration: to.Ptr("{ServiceConfiguration}"),
		// 				ExtensionProfile: &armcompute.CloudServiceExtensionProfile{
		// 					Extensions: []*armcompute.Extension{
		// 						{
		// 							Name: to.Ptr("RDPExtension"),
		// 							Properties: &armcompute.CloudServiceExtensionProperties{
		// 								Type: to.Ptr("RDP"),
		// 								AutoUpgradeMinorVersion: to.Ptr(false),
		// 								ProvisioningState: to.Ptr("Succeeded"),
		// 								Publisher: to.Ptr("Microsoft.Windows.Azure.Extensions"),
		// 								RolesAppliedTo: []*string{
		// 									to.Ptr("*")},
		// 									Settings: "<PublicConfig><UserName>userazure</UserName><Expiration>01/12/2022 16:29:02</Expiration></PublicConfig>",
		// 									TypeHandlerVersion: to.Ptr("1.2"),
		// 								},
		// 						}},
		// 					},
		// 					NetworkProfile: &armcompute.CloudServiceNetworkProfile{
		// 						LoadBalancerConfigurations: []*armcompute.LoadBalancerConfiguration{
		// 							{
		// 								Name: to.Ptr("contosolb"),
		// 								Properties: &armcompute.LoadBalancerConfigurationProperties{
		// 									FrontendIPConfigurations: []*armcompute.LoadBalancerFrontendIPConfiguration{
		// 										{
		// 											Name: to.Ptr("contosofe"),
		// 											Properties: &armcompute.LoadBalancerFrontendIPConfigurationProperties{
		// 												PublicIPAddress: &armcompute.SubResource{
		// 													ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Network/publicIPAddresses/contosopublicip"),
		// 												},
		// 											},
		// 									}},
		// 								},
		// 						}},
		// 					},
		// 					OSProfile: &armcompute.CloudServiceOsProfile{
		// 						Secrets: []*armcompute.CloudServiceVaultSecretGroup{
		// 						},
		// 					},
		// 					ProvisioningState: to.Ptr("Succeeded"),
		// 					RoleProfile: &armcompute.CloudServiceRoleProfile{
		// 						Roles: []*armcompute.CloudServiceRoleProfileProperties{
		// 							{
		// 								Name: to.Ptr("ContosoFrontend"),
		// 								SKU: &armcompute.CloudServiceRoleSKU{
		// 									Name: to.Ptr("Standard_D1_v2"),
		// 									Capacity: to.Ptr[int64](2),
		// 									Tier: to.Ptr("Standard"),
		// 								},
		// 							},
		// 							{
		// 								Name: to.Ptr("ContosoBackend"),
		// 								SKU: &armcompute.CloudServiceRoleSKU{
		// 									Name: to.Ptr("Standard_D1_v2"),
		// 									Capacity: to.Ptr[int64](2),
		// 									Tier: to.Ptr("Standard"),
		// 								},
		// 						}},
		// 					},
		// 					UniqueID: to.Ptr("4ccb4323-4740-4545-bb81-780b27375947"),
		// 					UpgradeMode: to.Ptr(armcompute.CloudServiceUpgradeModeAuto),
		// 				},
		// 		}},
		// 	}
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Gets a list of all cloud services under a resource group. Use nextLink property in the response to get the next page of Cloud Services. Do this till nextLink is null to fetch all the Cloud Services.
 *
 * @summary Gets a list of all cloud services under a resource group. Use nextLink property in the response to get the next page of Cloud Services. Do this till nextLink is null to fetch all the Cloud Services.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/CloudserviceRP/stable/2022-09-04/examples/CloudService_List_ByResourceGroup.json
 */
async function listCloudServicesInAResourceGroup() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "ConstosoRG";
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.cloudServices.list(resourceGroupName)) {
    resArray.push(item);
  }
  console.log(resArray);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Compute;
using Azure.ResourceManager.Compute.Models;
using Azure.ResourceManager.Resources;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/CloudserviceRP/stable/2022-09-04/examples/CloudService_List_ByResourceGroup.json
// this example is just showing the usage of "CloudServices_List" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "ConstosoRG";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this CloudServiceResource
CloudServiceCollection collection = resourceGroupResource.GetCloudServices();

// invoke the operation and iterate over the result
await foreach (CloudServiceResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    CloudServiceData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine($"Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "value": [
    {
      "name": "{cs-name}",
      "id": "/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Compute/cloudServices/{cs-name}",
      "type": "Microsoft.Compute/cloudServices",
      "location": "eastus2euap",
      "properties": {
        "configuration": "{ServiceConfiguration}",
        "upgradeMode": "Auto",
        "roleProfile": {
          "roles": [
            {
              "name": "ContosoFrontend",
              "sku": {
                "name": "Standard_D1_v2",
                "tier": "Standard",
                "capacity": 2
              }
            },
            {
              "name": "ContosoBackend",
              "sku": {
                "name": "Standard_D1_v2",
                "tier": "Standard",
                "capacity": 2
              }
            }
          ]
        },
        "osProfile": {
          "secrets": []
        },
        "networkProfile": {
          "loadBalancerConfigurations": [
            {
              "name": "contosolb",
              "properties": {
                "frontendIpConfigurations": [
                  {
                    "name": "contosofe",
                    "properties": {
                      "publicIPAddress": {
                        "id": "/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Network/publicIPAddresses/contosopublicip"
                      }
                    }
                  }
                ]
              }
            }
          ]
        },
        "extensionProfile": {
          "extensions": [
            {
              "name": "RDPExtension",
              "properties": {
                "autoUpgradeMinorVersion": false,
                "provisioningState": "Succeeded",
                "rolesAppliedTo": [
                  "*"
                ],
                "publisher": "Microsoft.Windows.Azure.Extensions",
                "type": "RDP",
                "typeHandlerVersion": "1.2",
                "settings": "<PublicConfig><UserName>userazure</UserName><Expiration>01/12/2022 16:29:02</Expiration></PublicConfig>"
              }
            }
          ]
        },
        "provisioningState": "Succeeded",
        "uniqueId": "4ccb4323-4740-4545-bb81-780b27375947"
      }
    }
  ]
}

Definitionen

Name	Beschreibung
ApiError	API-Fehler.
ApiErrorBase	API-Fehlerbasis.
CloudError	Eine Fehlerantwort des Computediensts.
CloudService	Beschreibt den Clouddienst.
CloudServiceExtensionProfile	Beschreibt ein Clouddiensterweiterungsprofil.
CloudServiceExtensionProperties	Erweiterungseigenschaften.
CloudServiceListResult	Das Ergebnis des Listenvorgangs.
CloudServiceNetworkProfile	Netzwerkprofil für den Clouddienst.
CloudServiceOsProfile	Beschreibt das Betriebssystemprofil für den Clouddienst.
CloudServiceProperties	Clouddiensteigenschaften
CloudServiceRoleProfile	Beschreibt das Rollenprofil für den Clouddienst.
CloudServiceRoleProfileProperties	Beschreibt die Rolleneigenschaften.
CloudServiceRoleSku	Beschreibt die Clouddienstrollensku.
CloudServiceSlotType	Slottyp für den Clouddienst. Mögliche Werte: Produktion Staging Falls nicht angegeben, lautet der Standardwert Production.
CloudServiceUpgradeMode	Updatemodus für den Clouddienst. Rolleninstanzen werden den Aktualisierungsdomänen zugeordnet, wenn der Dienst bereitgestellt wird. Updates können in jeder Aktualisierungsdomäne manuell initiiert oder in allen Updatedomänen automatisch initiiert werden. Mögliche Werte sind: Automatisch Manuell Gleichzeitige Wenn nicht angegeben, lautet der Standardwert Auto. Wenn diese Einstellung auf Manuell festgelegt ist, muss PUT UpdateDomain aufgerufen werden, um das Update anzuwenden. Bei Festlegung auf Auto wird das Update automatisch nacheinander auf jede Updatedomäne angewendet.
CloudServiceVaultAndSecretReference	Geschützte Einstellungen für die Erweiterung, auf die mithilfe von KeyVault verwiesen wird, die verschlüsselt werden, bevor sie an die Rolle instance gesendet werden.
CloudServiceVaultCertificate	Beschreibt einen einzelnen Zertifikatverweis in einem Key Vault und den Speicherort des Zertifikats für die Rolle instance.
CloudServiceVaultSecretGroup	Beschreibt eine Gruppe von Zertifikaten, die sich alle im gleichen Key Vault befinden.
Extension	Beschreibt eine Clouddiensterweiterung.
InnerError	Details zu inneren Fehlern.
LoadBalancerConfiguration	Beschreibt die Konfiguration des Lastenausgleichs.
LoadBalancerConfigurationProperties	Beschreibt die Eigenschaften der Lastenausgleichskonfiguration.
LoadBalancerFrontendIpConfiguration	Gibt die Front-End-IP an, die für den Lastenausgleich verwendet werden soll. Es wird nur die IPv4-Front-End-IP-Adresse unterstützt. Jede Lastenausgleichskonfiguration muss genau eine Front-End-IP-Konfiguration aufweisen.
LoadBalancerFrontendIpConfigurationProperties	Beschreibt die IP-Konfiguration eines Clouddiensts
SubResource
SystemData	Die Systemmetadaten zu dieser Ressource.

ApiError

API-Fehler.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
details	ApiErrorBase[]	Details zu API-Fehlern
innererror	InnerError	Innerer API-Fehler
message	string	Die Fehlermeldung.
target	string	Das Ziel des bestimmten Fehlers.

ApiErrorBase

API-Fehlerbasis.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
message	string	Die Fehlermeldung.
target	string	Das Ziel des bestimmten Fehlers.

CloudError

Eine Fehlerantwort des Computediensts.

Name	Typ	Beschreibung
error	ApiError	API-Fehler.

CloudService

Beschreibt den Clouddienst.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
location	string	Ressourcenspeicherort
name	string	Name der Ressource.
properties	CloudServiceProperties	Clouddiensteigenschaften
systemData	SystemData	Die Systemmetadaten zu dieser Ressource.
tags	object	Ressourcentags.
type	string	Der Ressourcentyp.
zones	string[]	Liste der logischen Verfügbarkeitszone der Ressource. Die Liste sollte nur eine Zone enthalten, in der der Clouddienst bereitgestellt werden soll. Dieses Feld ist optional.

CloudServiceExtensionProfile

Beschreibt ein Clouddiensterweiterungsprofil.

Name	Typ	Beschreibung
extensions	Extension[]	Liste der Erweiterungen für den Clouddienst.

CloudServiceExtensionProperties

Erweiterungseigenschaften.

Name	Typ	Beschreibung
autoUpgradeMinorVersion	boolean	Geben Sie explizit an, ob die Plattform typeHandlerVersion automatisch auf höhere Nebenversionen aktualisieren kann, wenn sie verfügbar werden.
forceUpdateTag	string	Tag, um das Anwenden der bereitgestellten öffentlichen und geschützten Einstellungen zu erzwingen. Wenn Sie den Tagwert ändern, können Sie die Erweiterung erneut ausführen, ohne die öffentlichen oder geschützten Einstellungen zu ändern. Wenn forceUpdateTag nicht geändert wird, werden Updates auf öffentliche oder geschützte Einstellungen weiterhin vom Handler angewendet. Wenn sich weder forceUpdateTag noch öffentliche oder geschützte Einstellungen ändern, würde die Erweiterung an die Rolle instance mit derselben Sequenznummer fließen, und es liegt bei der Handlerimplementierung, ob sie erneut ausgeführt werden soll oder nicht.
protectedSettings	object	Geschützte Einstellungen für die Erweiterung, die verschlüsselt werden, bevor sie an die Rolle instance gesendet werden.
protectedSettingsFromKeyVault	CloudServiceVaultAndSecretReference	Geschützte Einstellungen für die Erweiterung, auf die mithilfe von KeyVault verwiesen wird, die verschlüsselt werden, bevor sie an die Rolle instance gesendet werden.
provisioningState	string	Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird.
publisher	string	Der Name des Erweiterungshandlerherausgebers.
rolesAppliedTo	string[]	Optionale Liste der Rollen, die diese Erweiterung anwenden sollen. Wenn die Eigenschaft nicht angegeben oder "*" angegeben ist, wird die Erweiterung auf alle Rollen im Clouddienst angewendet.
settings	object	Öffentliche Einstellungen für die Erweiterung. Bei JSON-Erweiterungen sind dies die JSON-Einstellungen für die Erweiterung. Für die XML-Erweiterung (z. B. RDP) ist dies die XML-Einstellung für die Erweiterung.
type	string	Gibt den Typ der Erweiterung an.
typeHandlerVersion	string	Gibt die Version der Erweiterung an. Gibt die Version der Erweiterung an. Wenn dieses Element nicht angegeben oder ein Sternchen (*) als Wert verwendet wird, wird die neueste Version der Erweiterung verwendet. Wenn der Wert mit einer Hauptversionsnummer und einem Sternchen als Nebenversionsnummer (X.) angegeben wird, wird die neueste Nebenversion der angegebenen Hauptversion ausgewählt. Wenn eine Hauptversionsnummer und eine Nebenversionsnummer (X.Y) angegeben werden, wird die spezifische Erweiterungsversion ausgewählt. Wenn eine Version angegeben wird, wird ein automatisches Upgrade für die Rolleninstanz durchgeführt.

CloudServiceListResult

Das Ergebnis des Listenvorgangs.

Name	Typ	Beschreibung
nextLink	string	Der URI zum Abrufen der nächsten Ressourcenseite. Verwenden Sie diese Option, um die nächste Seite mit Ressourcen abzurufen. Gehen Sie so vor, bis nextLink null ist, um alle Ressourcen abzurufen.
value	CloudService[]	Die Liste der Ressourcen.

CloudServiceNetworkProfile

Netzwerkprofil für den Clouddienst.

Name	Typ	Beschreibung
loadBalancerConfigurations	LoadBalancerConfiguration[]	Liste der Load Balancer-Konfigurationen. Der Clouddienst kann über bis zu zwei Lastenausgleichskonfigurationen verfügen, die einem öffentlichen Load Balancer und einem internen Load Balancer entsprechen.
slotType	CloudServiceSlotType	Slottyp für den Clouddienst. Mögliche Werte: Produktion Staging Wenn nicht angegeben, lautet der Standardwert Production.
swappableCloudService	SubResource	Der ID-Verweis des Clouddiensts, der die Ziel-IP-Adresse enthält, mit der der antragstellerbasierte Clouddienst einen Austausch durchführen kann. Diese Eigenschaft kann nach dem Festlegen nicht mehr aktualisiert werden. Der austauschbare Clouddienst, auf den diese ID verweist, muss vorhanden sein, andernfalls wird ein Fehler ausgelöst.

CloudServiceOsProfile

Beschreibt das Betriebssystemprofil für den Clouddienst.

Name	Typ	Beschreibung
secrets	CloudServiceVaultSecretGroup[]	Gibt einen Satz von Zertifikaten an, die auf den Rolleninstanzen installiert werden sollen.

CloudServiceProperties

Clouddiensteigenschaften

Name	Typ	Beschreibung
allowModelOverride	boolean	(Optional) Gibt an, ob die im Modell/der Vorlage angegebenen Rollen-SKU-Eigenschaften (roleProfile.roles.sku) die Rolle instance Anzahl und VM-Größe überschreiben sollen, die in CSCFG bzw. CSDEF angegeben sind. Standardwert: `false`.
configuration	string	Gibt die XML-Dienstkonfiguration (.cscfg) für den Clouddienst an.
configurationUrl	string	Gibt eine URL an, die sich auf den Speicherort der Dienstkonfiguration im Blobdienst bezieht. Die Dienstpaket-URL kann ein SAS-URI (Shared Access Signature) eines beliebigen Speicherkontos sein. Dies ist eine schreibgeschützte Eigenschaft, die in GET-Aufrufen nicht zurückgegeben wird.
extensionProfile	CloudServiceExtensionProfile	Beschreibt ein Clouddiensterweiterungsprofil.
networkProfile	CloudServiceNetworkProfile	Netzwerkprofil für den Clouddienst.
osProfile	CloudServiceOsProfile	Beschreibt das Betriebssystemprofil für den Clouddienst.
packageUrl	string	Gibt eine URL an, die auf den Speicherort des Dienstpakets im Blob-Dienst verweist. Die Dienstpaket-URL kann ein SAS-URI (Shared Access Signature) eines beliebigen Speicherkontos sein. Dies ist eine schreibgeschützte Eigenschaft, die in GET-Aufrufen nicht zurückgegeben wird.
provisioningState	string	Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird.
roleProfile	CloudServiceRoleProfile	Beschreibt das Rollenprofil für den Clouddienst.
startCloudService	boolean	(Optional) Gibt an, ob der Clouddienst unmittelbar nach der Erstellung gestartet werden soll. Standardwert: `true`. Wenn false, wird das Dienstmodell weiterhin bereitgestellt, aber der Code wird nicht sofort ausgeführt. Stattdessen wird der Dienst so lange poweredOff ausgeführt, bis Sie Start aufrufen. Zu diesem Zeitpunkt wird der Dienst gestartet. Für einen bereitgestellten Dienst fallen weiterhin Gebühren an, auch wenn er ausgeschaltet wird.
uniqueId	string	Der eindeutige Bezeichner für den Clouddienst.
upgradeMode	CloudServiceUpgradeMode	Updatemodus für den Clouddienst. Rolleninstanzen werden den Aktualisierungsdomänen zugeordnet, wenn der Dienst bereitgestellt wird. Updates können in jeder Aktualisierungsdomäne manuell initiiert oder in allen Updatedomänen automatisch initiiert werden. Mögliche Werte sind: Automatisch Manuell Gleichzeitige Wenn nicht angegeben, lautet der Standardwert Auto. Wenn diese Einstellung auf Manuell festgelegt ist, muss PUT UpdateDomain aufgerufen werden, um das Update anzuwenden. Bei Festlegung auf Auto wird das Update automatisch nacheinander auf jede Updatedomäne angewendet.

CloudServiceRoleProfile

Beschreibt das Rollenprofil für den Clouddienst.

Name	Typ	Beschreibung
roles	CloudServiceRoleProfileProperties[]	Liste der Rollen für den Clouddienst.

CloudServiceRoleProfileProperties

Beschreibt die Rolleneigenschaften.

Name	Typ	Beschreibung
name	string	Name der Ressource.
sku	CloudServiceRoleSku	Beschreibt die SKU der Clouddienstrolle.

CloudServiceRoleSku

Beschreibt die Clouddienstrollensku.

Name	Typ	Beschreibung
capacity	integer	Gibt die Anzahl der Rolleninstanzen im Clouddienst an.
name	string	Der sku-Name. HINWEIS: Wenn die neue SKU auf der Hardware, auf der sich der Clouddienst derzeit befindet, nicht unterstützt wird, müssen Sie den Clouddienst löschen und neu erstellen oder zur alten SKU zurückkehren.
tier	string	Gibt die Ebene des Clouddiensts an. Mögliche Werte sind Standard Grundlegend

CloudServiceSlotType

Slottyp für den Clouddienst. Mögliche Werte:

Produktion

Staging

Falls nicht angegeben, lautet der Standardwert Production.

Name	Typ	Beschreibung
Production	string
Staging	string

CloudServiceUpgradeMode

Updatemodus für den Clouddienst. Rolleninstanzen werden den Aktualisierungsdomänen zugeordnet, wenn der Dienst bereitgestellt wird. Updates können in jeder Aktualisierungsdomäne manuell initiiert oder in allen Updatedomänen automatisch initiiert werden. Mögliche Werte sind:

Automatisch

Manuell

Gleichzeitige

Wenn nicht angegeben, lautet der Standardwert Auto. Wenn diese Einstellung auf Manuell festgelegt ist, muss PUT UpdateDomain aufgerufen werden, um das Update anzuwenden. Bei Festlegung auf Auto wird das Update automatisch nacheinander auf jede Updatedomäne angewendet.

Name	Typ	Beschreibung
Auto	string
Manual	string
Simultaneous	string

CloudServiceVaultAndSecretReference

Geschützte Einstellungen für die Erweiterung, auf die mithilfe von KeyVault verwiesen wird, die verschlüsselt werden, bevor sie an die Rolle instance gesendet werden.

Name	Typ	Beschreibung
secretUrl	string	Geheime URL, die die geschützten Einstellungen der Erweiterung enthält
sourceVault	SubResource	Die ARM-Ressourcen-ID des Key Vault

CloudServiceVaultCertificate

Beschreibt einen einzelnen Zertifikatverweis in einem Key Vault und den Speicherort des Zertifikats für die Rolle instance.

Name	Typ	Beschreibung
certificateUrl	string	Dies ist die URL eines Zertifikats, das als Geheimnis in Key Vault hochgeladen wurde.

CloudServiceVaultSecretGroup

Beschreibt eine Gruppe von Zertifikaten, die sich alle im gleichen Key Vault befinden.

Name	Typ	Beschreibung
sourceVault	SubResource	Die relative URL der Key Vault, die alle Zertifikate in VaultCertificates enthält.
vaultCertificates	CloudServiceVaultCertificate[]	Die Liste der Schlüsseltresorverweise in SourceVault, die Zertifikate enthalten.

Extension

Beschreibt eine Clouddiensterweiterung.

Name	Typ	Beschreibung
name	string	Der Name der Erweiterung.
properties	CloudServiceExtensionProperties	Erweiterungseigenschaften.

InnerError

Details zu inneren Fehlern.

Name	Typ	Beschreibung
errordetail	string	Die interne Fehlermeldung oder das Ausnahmeabbild.
exceptiontype	string	Der Ausnahmetyp.

LoadBalancerConfiguration

Beschreibt die Konfiguration des Lastenausgleichs.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Der Name des Lastenausgleichs
properties	LoadBalancerConfigurationProperties	Eigenschaften der Lastenausgleichskonfiguration.

LoadBalancerConfigurationProperties

Beschreibt die Eigenschaften der Lastenausgleichskonfiguration.

Name	Typ	Beschreibung
frontendIpConfigurations	LoadBalancerFrontendIpConfiguration[]	Gibt die Front-End-IP an, die für den Lastenausgleich verwendet werden soll. Es wird nur die IPv4-Front-End-IP-Adresse unterstützt. Jede Lastenausgleichskonfiguration muss genau eine Front-End-IP-Konfiguration aufweisen.

LoadBalancerFrontendIpConfiguration

Gibt die Front-End-IP an, die für den Lastenausgleich verwendet werden soll. Es wird nur die IPv4-Front-End-IP-Adresse unterstützt. Jede Lastenausgleichskonfiguration muss genau eine Front-End-IP-Konfiguration aufweisen.

Name	Typ	Beschreibung
name	string	Der Name der Ressource, der innerhalb der Vom Lastenausgleich verwendeten Front-End-IP-Konfigurationen eindeutig ist. Dieser Name kann für den Zugriff auf die Ressource verwendet werden.
properties	LoadBalancerFrontendIpConfigurationProperties	Eigenschaften der Front-End-IP-Konfiguration des Lastenausgleichs.

LoadBalancerFrontendIpConfigurationProperties

Beschreibt die IP-Konfiguration eines Clouddiensts

Name	Typ	Beschreibung
privateIPAddress	string	Die private IP-Adresse des virtuellen Netzwerks der IP-Konfiguration.
publicIPAddress	SubResource	Der Verweis auf die öffentliche IP-Adressressource.
subnet	SubResource	Der Verweis auf die Subnetzressource des virtuellen Netzwerks.

SubResource

Name	Typ	Beschreibung
id	string	Ressourcen-ID

SystemData

Die Systemmetadaten zu dieser Ressource.

Name	Typ	Beschreibung
createdAt	string	Gibt den Zeitpunkt in UTC an, zu dem die Clouddienstressource (erweiterter Support) erstellt wurde. Api-Mindestversion: 2022-04-04.
lastModifiedAt	string	Gibt den Zeitpunkt in UTC an, zu dem die Clouddienstressource (erweiterter Support) zuletzt geändert wurde. Api-Mindestversion: 2022-04-04.

Cloud Services - List

URI-Parameter

Antworten

Sicherheit

azure_auth

Scopes

Beispiele

List Cloud Services in a Resource Group

Sample Request

Sample Response

Definitionen

ApiError

ApiErrorBase

CloudError

CloudService

CloudServiceExtensionProfile

CloudServiceExtensionProperties

CloudServiceListResult

CloudServiceNetworkProfile

CloudServiceOsProfile

CloudServiceProperties

CloudServiceRoleProfile

CloudServiceRoleProfileProperties

CloudServiceRoleSku

CloudServiceSlotType

CloudServiceUpgradeMode

CloudServiceVaultAndSecretReference

CloudServiceVaultCertificate

CloudServiceVaultSecretGroup

Extension

InnerError

LoadBalancerConfiguration

LoadBalancerConfigurationProperties

LoadBalancerFrontendIpConfiguration

LoadBalancerFrontendIpConfigurationProperties

SubResource

SystemData

Zusätzliche Ressourcen