Cloud Services - List

Ottiene un elenco di tutti i servizi cloud in un gruppo di risorse. Utilizzare la proprietà nextLink nella risposta per ottenere la pagina successiva di Servizi cloud. Eseguire questa operazione fino a quando nextLink è null per recuperare tutte le Servizi cloud.

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

Parametri dell'URI

Name In Required Type Description
resourceGroupName
path True
  • string

Nome del gruppo di risorse.

subscriptionId
path True
  • string

Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.

api-version
query True
  • string

Versione dell'API client.

Risposte

Name Type Description
200 OK

OK

Other Status Codes

Errore

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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

Scopes

Name Description
user_impersonation rappresentare l'account utente

Esempio

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

Sample Response

{
  "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"
      }
    }
  ]
}

Definizioni

ApiError

Errore dell'API.

ApiErrorBase

Base degli errori api.

CloudError

Risposta di errore dal servizio di calcolo.

CloudService

Descrive il servizio cloud.

CloudServiceExtensionProfile

Descrive un profilo di estensione del servizio cloud.

CloudServiceExtensionProperties

Proprietà dell'estensione.

CloudServiceListResult

Risultato dell'operazione di elenco.

CloudServiceNetworkProfile

Profilo di rete per il servizio cloud.

CloudServiceOsProfile

Descrive il profilo del sistema operativo per il servizio cloud.

CloudServiceProperties

Proprietà del servizio cloud

CloudServiceRoleProfile

Descrive il profilo del ruolo per il servizio cloud.

CloudServiceRoleProfileProperties

Descrive le proprietà del ruolo.

CloudServiceRoleSku

Descrive lo sku del ruolo del servizio cloud.

CloudServiceSlotType

Tipo di slot per il servizio cloud. I possibili valori sono i seguenti:

Produzione

Gestione temporanea

Se non specificato, il valore predefinito è Production.

CloudServiceUpgradeMode

Modalità di aggiornamento per il servizio cloud. Le istanze del ruolo vengono allocate a domini di aggiornamento quando il servizio viene distribuito. Gli aggiornamenti possono essere avviati manualmente in ogni dominio di aggiornamento o avviati automaticamente in tutti i domini di aggiornamento. I valori possibili sono

Auto

Manuale

Simultanea

Se non specificato, il valore predefinito è Auto. Se impostato su Manuale, PUT UpdateDomain deve essere chiamato per applicare l'aggiornamento. Se impostato su Auto, l'aggiornamento viene applicato automaticamente a ogni dominio di aggiornamento in sequenza.

CloudServiceVaultAndSecretReference

Impostazioni protette per l'estensione, a cui fa riferimento l'uso di KeyVault che vengono crittografati prima dell'invio all'istanza del ruolo.

CloudServiceVaultCertificate

Descrive un singolo riferimento al certificato in un Key Vault e dove risiede il certificato nell'istanza del ruolo.

CloudServiceVaultSecretGroup

Descrive un set di certificati che si trovano tutti nella stessa Key Vault.

Extension

Descrive un'estensione del servizio cloud.

InnerError

Dettagli dell'errore interno.

LoadBalancerConfiguration

Descrive la configurazione del servizio di bilanciamento del carico.

LoadBalancerConfigurationProperties

Descrive le proprietà della configurazione del servizio di bilanciamento del carico.

LoadBalancerFrontendIPConfiguration

Specifica l'IP front-end da usare per il servizio di bilanciamento del carico. È supportato solo l'indirizzo IP front-end IPv4. Ogni configurazione del servizio di bilanciamento del carico deve avere esattamente una configurazione IP front-end.

LoadBalancerFrontendIPConfigurationProperties

Descrive una configurazione IP del servizio cloud

SubResource
SystemData

Metadati di sistema relativi a questa risorsa.

ApiError

Errore dell'API.

Name Type Description
code
  • string

Codice di errore.

details

Dettagli dell'errore dell'API

innererror

Errore interno dell'API

message
  • string

Messaggio di errore.

target
  • string

Destinazione dell'errore specifico.

ApiErrorBase

Base degli errori api.

Name Type Description
code
  • string

Codice di errore.

message
  • string

Messaggio di errore.

target
  • string

Destinazione dell'errore specifico.

CloudError

Risposta di errore dal servizio di calcolo.

Name Type Description
error

Errore dell'API.

CloudService

Descrive il servizio cloud.

Name Type Description
id
  • string

ID risorsa.

location
  • string

Percorso della risorsa.

name
  • string

Nome risorsa.

properties

Proprietà del servizio cloud

systemData

Metadati di sistema relativi a questa risorsa.

tags
  • object

Tag delle risorse.

type
  • string

Tipo di risorsa.

CloudServiceExtensionProfile

Descrive un profilo di estensione del servizio cloud.

Name Type Description
extensions

Elenco di estensioni per il servizio cloud.

CloudServiceExtensionProperties

Proprietà dell'estensione.

Name Type Description
autoUpgradeMinorVersion
  • boolean

Specificare in modo esplicito se la piattaforma può aggiornare automaticamente typeHandlerVersion a versioni secondarie superiori quando diventano disponibili.

forceUpdateTag
  • string

Tag per forzare l'applicazione delle impostazioni pubbliche e protette fornite. La modifica del valore del tag consente di eseguire nuovamente l'estensione senza modificare le impostazioni pubbliche o protette. Se forceUpdateTag non viene modificato, gli aggiornamenti alle impostazioni pubbliche o protette verranno comunque applicati dal gestore. Se né forceUpdateTag né alcuna delle impostazioni pubbliche o protette cambiano, l'estensione scorrerà all'istanza del ruolo con lo stesso numero di sequenza e l'implementazione del gestore consiste nell'implementare se eseguirla nuovamente o meno

protectedSettings
  • object

Impostazioni protette per l'estensione crittografata prima dell'invio all'istanza del ruolo.

protectedSettingsFromKeyVault

Impostazioni protette per l'estensione, a cui fa riferimento l'uso di KeyVault che vengono crittografati prima dell'invio all'istanza del ruolo.

provisioningState
  • string

Stato di provisioning, che viene visualizzato solo nella risposta.

publisher
  • string

Nome dell'autore del gestore dell'estensione.

rolesAppliedTo
  • string[]

Elenco facoltativo di ruoli per applicare questa estensione. Se la proprietà non è specificata o '*' viene specificata, l'estensione viene applicata a tutti i ruoli nel servizio cloud.

settings
  • object

Impostazioni pubbliche per l'estensione. Per le estensioni JSON, si tratta delle impostazioni JSON per l'estensione. Per estensione XML (ad esempio RDP), si tratta dell'impostazione XML per l'estensione.

type
  • string

Specifica il tipo dell'estensione.

typeHandlerVersion
  • string

Specifica la versione dell'estensione. Specifica la versione dell'estensione. Se questo elemento non è specificato o un asterisco (*) viene usato come valore, viene usata la versione più recente dell'estensione. Se il valore viene specificato con un numero di versione principale e un asterisco come numero di versione secondaria (X.), viene selezionata la versione secondaria più recente della versione principale specificata. Se viene specificato un numero di versione principale e un numero di versione secondaria (X.Y), viene selezionata la versione dell'estensione specifica. Se è specificata una versione, viene eseguito un aggiornamento automatico sull'istanza del ruolo.

CloudServiceListResult

Risultato dell'operazione di elenco.

Name Type Description
nextLink
  • string

URI per recuperare la pagina successiva delle risorse. Usare questa opzione per ottenere la pagina successiva delle risorse. Eseguire questa operazione fino a nextLink è Null per recuperare tutte le risorse.

value

Elenco di risorse.

CloudServiceNetworkProfile

Profilo di rete per il servizio cloud.

Name Type Description
loadBalancerConfigurations

Elenco delle configurazioni del servizio di bilanciamento del carico. Il servizio cloud può avere fino a due configurazioni del servizio di bilanciamento del carico, corrispondenti a un Load Balancer pubblico e a un Load Balancer interno.

slotType

Tipo di slot per il servizio cloud. I possibili valori sono i seguenti:

Produzione

Gestione temporanea

Se non specificato, il valore predefinito è Production.

swappableCloudService

Riferimento ID del servizio cloud contenente l'INDIRIZZO IP di destinazione con cui il servizio cloud soggetto può eseguire uno scambio. Questa proprietà non può essere aggiornata una volta impostata. Il servizio cloud scambiabile a cui fa riferimento questo ID deve essere presente; in caso contrario, verrà generato un errore.

CloudServiceOsProfile

Descrive il profilo del sistema operativo per il servizio cloud.

Name Type Description
secrets

Specifica il set di certificati che devono essere installati nelle istanze del ruolo.

CloudServiceProperties

Proprietà del servizio cloud

Name Type Description
allowModelOverride
  • boolean

(Facoltativo) Indica se le proprietà dello SKU del ruolo (roleProfile.roles.sku) specificate nel modello/modello devono eseguire l'override rispettivamente del numero di istanze del ruolo e delle dimensioni della macchina virtuale specificate rispettivamente in .cscfg e .csdef. Il valore predefinito è false.

configuration
  • string

Specifica la configurazione del servizio XML (con estensione cscfg) per il servizio cloud.

configurationUrl
  • string

Specifica un URL che fa riferimento alla posizione della configurazione del servizio nel servizio BLOB. L'URL del pacchetto di servizio può essere un URI di firma di accesso condiviso (SAS) da qualsiasi account di archiviazione. Si tratta di una proprietà di sola scrittura e non viene restituita nelle chiamate GET.

extensionProfile

Descrive un profilo di estensione del servizio cloud.

networkProfile

Profilo di rete per il servizio cloud.

osProfile

Descrive il profilo del sistema operativo per il servizio cloud.

packageUrl
  • string

Specifica un URL che fa riferimento alla posizione del pacchetto del servizio nel servizio BLOB. L'URL del pacchetto di servizio può essere un URI di firma di accesso condiviso (SAS) da qualsiasi account di archiviazione. Si tratta di una proprietà di sola scrittura e non viene restituita nelle chiamate GET.

provisioningState
  • string

Stato di provisioning, che viene visualizzato solo nella risposta.

roleProfile

Descrive il profilo del ruolo per il servizio cloud.

startCloudService
  • boolean

(Facoltativo) Indica se avviare il servizio cloud immediatamente dopo la creazione. Il valore predefinito è true. Se false, il modello di servizio viene ancora distribuito, ma il codice non viene eseguito immediatamente. Al contrario, il servizio è PoweredOff fino a quando non si chiama Start, al momento dell'avvio del servizio. Un servizio distribuito comporta comunque addebiti, anche se è spento.

uniqueId
  • string

Identificatore univoco per il servizio cloud.

upgradeMode

Modalità di aggiornamento per il servizio cloud. Le istanze del ruolo vengono allocate a domini di aggiornamento quando il servizio viene distribuito. Gli aggiornamenti possono essere avviati manualmente in ogni dominio di aggiornamento o avviati automaticamente in tutti i domini di aggiornamento. I valori possibili sono

Auto

Manuale

Simultanea

Se non specificato, il valore predefinito è Auto. Se impostato su Manuale, PUT UpdateDomain deve essere chiamato per applicare l'aggiornamento. Se impostato su Auto, l'aggiornamento viene applicato automaticamente a ogni dominio di aggiornamento in sequenza.

CloudServiceRoleProfile

Descrive il profilo del ruolo per il servizio cloud.

Name Type Description
roles

Elenco dei ruoli per il servizio cloud.

CloudServiceRoleProfileProperties

Descrive le proprietà del ruolo.

Name Type Description
name
  • string

Nome risorsa.

sku

Descrive lo SKU del ruolo del servizio cloud.

CloudServiceRoleSku

Descrive lo sku del ruolo del servizio cloud.

Name Type Description
capacity
  • integer

Specifica il numero di istanze di ruolo nel servizio cloud.

name
  • string

Nome sku. NOTA: se il nuovo SKU non è supportato nell'hardware in cui è in corso il servizio cloud, è necessario eliminare e ricreare il servizio cloud o tornare alla sku precedente.

tier
  • string

Specifica il livello del servizio cloud. I valori possibili sono

Standard

Base

CloudServiceSlotType

Tipo di slot per il servizio cloud. I possibili valori sono i seguenti:

Produzione

Gestione temporanea

Se non specificato, il valore predefinito è Production.

Name Type Description
Production
  • string
Staging
  • string

CloudServiceUpgradeMode

Modalità di aggiornamento per il servizio cloud. Le istanze del ruolo vengono allocate a domini di aggiornamento quando il servizio viene distribuito. Gli aggiornamenti possono essere avviati manualmente in ogni dominio di aggiornamento o avviati automaticamente in tutti i domini di aggiornamento. I valori possibili sono

Auto

Manuale

Simultanea

Se non specificato, il valore predefinito è Auto. Se impostato su Manuale, PUT UpdateDomain deve essere chiamato per applicare l'aggiornamento. Se impostato su Auto, l'aggiornamento viene applicato automaticamente a ogni dominio di aggiornamento in sequenza.

Name Type Description
Auto
  • string
Manual
  • string
Simultaneous
  • string

CloudServiceVaultAndSecretReference

Impostazioni protette per l'estensione, a cui fa riferimento l'uso di KeyVault che vengono crittografati prima dell'invio all'istanza del ruolo.

Name Type Description
secretUrl
  • string

URL segreto che contiene le impostazioni protette dell'estensione

sourceVault

ID risorsa ARM del Key Vault

CloudServiceVaultCertificate

Descrive un singolo riferimento al certificato in un Key Vault e dove risiede il certificato nell'istanza del ruolo.

Name Type Description
certificateUrl
  • string

Questo è l'URL di un certificato caricato in Key Vault come segreto.

CloudServiceVaultSecretGroup

Descrive un set di certificati che si trovano tutti nella stessa Key Vault.

Name Type Description
sourceVault

URL relativo del Key Vault contenente tutti i certificati in VaultCertificates.

vaultCertificates

Elenco di riferimenti all'insieme di credenziali delle chiavi in SourceVault che contengono certificati.

Extension

Descrive un'estensione del servizio cloud.

Name Type Description
name
  • string

Nome dell'estensione.

properties

Proprietà dell'estensione.

InnerError

Dettagli dell'errore interno.

Name Type Description
errordetail
  • string

Messaggio di errore interno o dump delle eccezioni.

exceptiontype
  • string

Tipo di eccezione.

LoadBalancerConfiguration

Descrive la configurazione del servizio di bilanciamento del carico.

Name Type Description
id
  • string

ID risorsa

name
  • string

Nome del servizio di bilanciamento del carico

properties

Proprietà della configurazione del servizio di bilanciamento del carico.

LoadBalancerConfigurationProperties

Descrive le proprietà della configurazione del servizio di bilanciamento del carico.

Name Type Description
frontendIPConfigurations

Specifica l'IP front-end da usare per il servizio di bilanciamento del carico. È supportato solo l'indirizzo IP front-end IPv4. Ogni configurazione del servizio di bilanciamento del carico deve avere esattamente una configurazione IP front-end.

LoadBalancerFrontendIPConfiguration

Specifica l'IP front-end da usare per il servizio di bilanciamento del carico. È supportato solo l'indirizzo IP front-end IPv4. Ogni configurazione del servizio di bilanciamento del carico deve avere esattamente una configurazione IP front-end.

Name Type Description
name
  • string

Nome della risorsa univoca all'interno del set di configurazioni IP front-end usate dal servizio di bilanciamento del carico. Questo nome può essere usato per accedere alla risorsa.

properties

Proprietà della configurazione ip front-end del servizio di bilanciamento del carico.

LoadBalancerFrontendIPConfigurationProperties

Descrive una configurazione IP del servizio cloud

Name Type Description
privateIPAddress
  • string

Indirizzo IP privato della rete virtuale della configurazione IP.

publicIPAddress

Riferimento alla risorsa indirizzo IP pubblico.

subnet

Riferimento alla risorsa subnet di rete virtuale.

SubResource

Name Type Description
id
  • string

ID risorsa

SystemData

Metadati di sistema relativi a questa risorsa.

Name Type Description
createdAt
  • string

Specifica l'ora in formato UTC in cui è stata creata la risorsa servizio cloud (supporto esteso).
Versione minima api: 2022-04-04.

lastModifiedAt
  • string

Specifica l'ora in formato UTC in cui la risorsa servizio cloud (supporto esteso) è stata modificata per l'ultima volta.
Versione minima api: 2022-04-04.