Microsoft.Compute cloudServices 2022-04-04
Definizione di risorsa Bicep
Il tipo di risorsa cloudServices può essere distribuito con operazioni destinate a:
- Gruppi di risorse - Vedere i comandi di distribuzione dei gruppi di risorse
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.Compute/cloudServices, aggiungere il bicep seguente al modello.
resource symbolicname 'Microsoft.Compute/cloudServices@2022-04-04' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
properties: {
allowModelOverride: bool
configuration: 'string'
configurationUrl: 'string'
extensionProfile: {
extensions: [
{
name: 'string'
properties: {
autoUpgradeMinorVersion: bool
forceUpdateTag: 'string'
protectedSettings: any()
protectedSettingsFromKeyVault: {
secretUrl: 'string'
sourceVault: {
id: 'string'
}
}
publisher: 'string'
rolesAppliedTo: [
'string'
]
settings: any()
type: 'string'
typeHandlerVersion: 'string'
}
}
]
}
networkProfile: {
loadBalancerConfigurations: [
{
id: 'string'
name: 'string'
properties: {
frontendIPConfigurations: [
{
name: 'string'
properties: {
privateIPAddress: 'string'
publicIPAddress: {
id: 'string'
}
subnet: {
id: 'string'
}
}
}
]
}
}
]
slotType: 'string'
swappableCloudService: {
id: 'string'
}
}
osProfile: {
secrets: [
{
sourceVault: {
id: 'string'
}
vaultCertificates: [
{
certificateUrl: 'string'
}
]
}
]
}
packageUrl: 'string'
roleProfile: {
roles: [
{
name: 'string'
sku: {
capacity: int
name: 'string'
tier: 'string'
}
}
]
}
startCloudService: bool
upgradeMode: 'string'
}
systemData: {}
}
Valori delle proprietà
cloudServices
| Nome | Descrizione | valore |
|---|---|---|
| name | Nome della risorsa | stringa (obbligatorio) Limite di caratteri: 1-15 Caratteri validi: Non è possibile usare spazi, caratteri di controllo o questi caratteri: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?Non può iniziare con un carattere di sottolineatura. Non può terminare con un punto o un trattino. |
| posizione | Percorso della risorsa. | stringa (obbligatorio) |
| tags | Tag delle risorse. | Dizionario di nomi e valori di tag. Vedere Tag nei modelli |
| properties | Proprietà del servizio cloud | CloudServiceProperties |
| systemData | Metadati di sistema relativi a questa risorsa. | SystemData |
CloudServiceProperties
| Nome | Descrizione | Valore |
|---|---|---|
| allowModelOverride | (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. |
bool |
| configurazione | Specifica la configurazione del servizio XML (con estensione cscfg) per il servizio cloud. | string |
| configurationUrl | 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. |
string |
| extensionProfile | Descrive un profilo di estensione del servizio cloud. | CloudServiceExtensionProfile |
| networkProfile | Profilo di rete per il servizio cloud. | CloudServiceNetworkProfile |
| osProfile | Descrive il profilo del sistema operativo per il servizio cloud. | CloudServiceOsProfile |
| packageUrl | 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. |
string |
| roleProfile | Descrive il profilo del ruolo per il servizio cloud. | CloudServiceRoleProfile |
| startCloudService | (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. |
bool |
| 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. |
'Auto' 'Manual' 'Simultaneo' |
CloudServiceExtensionProfile
| Nome | Descrizione | Valore |
|---|---|---|
| Estensioni | Elenco di estensioni per il servizio cloud. | Estensione[] |
Estensione
| Nome | Descrizione | valore |
|---|---|---|
| name | Nome dell'estensione. | string |
| properties | Proprietà dell'estensione. | CloudServiceExtensionProperties |
CloudServiceExtensionProperties
| Nome | Descrizione | Valore |
|---|---|---|
| autoUpgradeMinorVersion | Specificare in modo esplicito se la piattaforma può aggiornare automaticamente typeHandlerVersion a versioni secondarie superiori quando diventano disponibili. | bool |
| forceUpdateTag | 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 nel ripetere o meno l'implementazione del gestore |
string |
| protectedSettings | Impostazioni protette per l'estensione crittografata prima dell'invio all'istanza del ruolo. | Per Bicep è possibile usare la funzione any(). |
| protectedSettingsFromKeyVault | Impostazioni protette per l'estensione, a cui fa riferimento l'uso di KeyVault che vengono crittografati prima dell'invio all'istanza del ruolo. | CloudServiceVaultAndSecretReference |
| publisher | Nome dell'autore del gestore dell'estensione. | string |
| ruoliAppliedTo | 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. | string[] |
| impostazioni | 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. | Per Bicep è possibile usare la funzione any(). |
| tipo | Specifica il tipo dell'estensione. | string |
| typeHandlerVersion | 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. | string |
CloudServiceVaultAndSecretReference
| Nome | Descrizione | Valore |
|---|---|---|
| secretUrl | URL segreto che contiene le impostazioni protette dell'estensione | string |
| sourceVault | ID risorsa ARM del Key Vault | SottoResource |
SottoResource
| Nome | Descrizione | Valore |
|---|---|---|
| id | ID risorsa | string |
CloudServiceNetworkProfile
| Nome | Descrizione | Valore |
|---|---|---|
| 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. | LoadBalancerConfiguration[] |
| slotType | Tipo di slot per il servizio cloud. I possibili valori sono i seguenti: Produzione Gestione temporanea Se non specificato, il valore predefinito è Production. |
'Produzione' 'Staging' |
| 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 altrimenti verrà generato un errore. | SottoResource |
LoadBalancerConfiguration
| Nome | Descrizione | Valore |
|---|---|---|
| id | ID risorsa | string |
| name | Nome del servizio di bilanciamento del carico | stringa (obbligatoria) |
| properties | Proprietà della configurazione del servizio di bilanciamento del carico. | LoadBalancerConfigurationProperties (obbligatorio) |
LoadBalancerConfigurationProperties
| Nome | Descrizione | Valore |
|---|---|---|
| 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[] (obbligatorio) |
LoadBalancerFrontendIPConfiguration
| Nome | Descrizione | valore |
|---|---|---|
| name | 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. | stringa (obbligatoria) |
| properties | Proprietà della configurazione ip front-end del servizio di bilanciamento del carico. | LoadBalancerFrontendIPConfigurationProperties (obbligatorio) |
LoadBalancerFrontendIPConfigurationProperties
| Nome | Descrizione | Valore |
|---|---|---|
| privateIPAddress | Indirizzo IP privato della rete virtuale della configurazione IP. | string |
| publicIPAddress | Riferimento alla risorsa indirizzo IP pubblico. | SottoResource |
| Subnet | Riferimento alla risorsa subnet di rete virtuale. | SottoResource |
CloudServiceOsProfile
| Nome | Descrizione | Valore |
|---|---|---|
| chiavi private | Specifica il set di certificati che devono essere installati nelle istanze del ruolo. | CloudServiceVaultSecretGroup[] |
CloudServiceVaultSecretGroup
| Nome | Descrizione | Valore |
|---|---|---|
| sourceVault | URL relativo della Key Vault contenente tutti i certificati in VaultCertificates. | SottoResource |
| VaultCertificates | Elenco di riferimenti all'insieme di credenziali delle chiavi in SourceVault che contengono certificati. | CloudServiceVaultCertificate[] |
CloudServiceVaultCertificate
| Nome | Descrizione | Valore |
|---|---|---|
| certificateUrl | Questo è l'URL di un certificato caricato in Key Vault come segreto. | string |
CloudServiceRoleProfile
| Nome | Descrizione | Valore |
|---|---|---|
| Ruoli | Elenco dei ruoli per il servizio cloud. | CloudServiceRoleProfileProperties[] |
CloudServiceRoleProfileProperties
| Nome | Descrizione | valore |
|---|---|---|
| name | Nome risorsa. | string |
| sku | Descrive lo sku del ruolo del servizio cloud. | CloudServiceRoleSku |
CloudServiceRoleSku
| Nome | Descrizione | Valore |
|---|---|---|
| capacità | Specifica il numero di istanze di ruolo nel servizio cloud. | INT |
| name | 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. | string |
| Livello | Specifica il livello del servizio cloud. I valori possibili sono Standard Base |
string |
SystemData
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
Definizione della risorsa modello di Resource Manager
Il tipo di risorsa cloudServices può essere distribuito con operazioni destinate:
- Gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.Compute/cloudServices, aggiungere il codice JSON seguente al modello.
{
"type": "Microsoft.Compute/cloudServices",
"apiVersion": "2022-04-04",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"allowModelOverride": "bool",
"configuration": "string",
"configurationUrl": "string",
"extensionProfile": {
"extensions": [
{
"name": "string",
"properties": {
"autoUpgradeMinorVersion": "bool",
"forceUpdateTag": "string",
"protectedSettings": {},
"protectedSettingsFromKeyVault": {
"secretUrl": "string",
"sourceVault": {
"id": "string"
}
},
"publisher": "string",
"rolesAppliedTo": [ "string" ],
"settings": {},
"type": "string",
"typeHandlerVersion": "string"
}
}
]
},
"networkProfile": {
"loadBalancerConfigurations": [
{
"id": "string",
"name": "string",
"properties": {
"frontendIPConfigurations": [
{
"name": "string",
"properties": {
"privateIPAddress": "string",
"publicIPAddress": {
"id": "string"
},
"subnet": {
"id": "string"
}
}
}
]
}
}
],
"slotType": "string",
"swappableCloudService": {
"id": "string"
}
},
"osProfile": {
"secrets": [
{
"sourceVault": {
"id": "string"
},
"vaultCertificates": [
{
"certificateUrl": "string"
}
]
}
]
},
"packageUrl": "string",
"roleProfile": {
"roles": [
{
"name": "string",
"sku": {
"capacity": "int",
"name": "string",
"tier": "string"
}
}
]
},
"startCloudService": "bool",
"upgradeMode": "string"
},
"systemData": {}
}
Valori delle proprietà
cloudServices
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di risorsa | 'Microsoft.Compute/cloudServices' |
| apiVersion | Versione dell'API risorsa | '2022-04-04' |
| name | Nome della risorsa | stringa (obbligatoria) Limite di caratteri: 1-15 Caratteri validi: Non è possibile usare spazi, caratteri di controllo o caratteri seguenti: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?Non può iniziare con un carattere di sottolineatura. Non può terminare con un punto o un trattino. |
| posizione | Percorso della risorsa. | stringa (obbligatoria) |
| tags | Tag di risorse. | Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli |
| properties | Proprietà del servizio cloud | CloudServiceProperties |
| systemData | Metadati di sistema relativi a questa risorsa. | SystemData |
CloudServiceProperties
| Nome | Descrizione | Valore |
|---|---|---|
| allowModelOverride | (Facoltativo) Indica se le proprietà dello sku del ruolo (roleProfile.role.sku) specificate nel modello/modello devono eseguire l'override rispettivamente del conteggio delle istanze del ruolo e delle dimensioni della macchina virtuale specificate rispettivamente in .cscfg e .csdef. Il valore predefinito è false. |
bool |
| configurazione | Specifica la configurazione del servizio XML (con estensione cscfg) per il servizio cloud. | string |
| configurationUrl | Specifica un URL che fa riferimento alla posizione della configurazione del servizio nel servizio BLOB. L'URL del pacchetto di servizio può essere URI firma di accesso condiviso da qualsiasi account di archiviazione. Questa è una proprietà di sola scrittura e non viene restituita nelle chiamate GET. |
string |
| extensionProfile | Descrive un profilo di estensione del servizio cloud. | CloudServiceExtensionProfile |
| networkProfile | Profilo di rete per il servizio cloud. | CloudServiceNetworkProfile |
| osProfile | Descrive il profilo del sistema operativo per il servizio cloud. | CloudServiceOsProfile |
| packageUrl | Specifica un URL che fa riferimento alla posizione del pacchetto del servizio nel servizio BLOB. L'URL del pacchetto di servizio può essere URI firma di accesso condiviso da qualsiasi account di archiviazione. Questa è una proprietà di sola scrittura e non viene restituita nelle chiamate GET. |
string |
| roleProfile | Descrive il profilo di ruolo per il servizio cloud. | CloudServiceRoleProfile |
| startCloudService | (Facoltativo) Indica se avviare il servizio cloud immediatamente dopo la creazione. Il valore predefinito è true.Se false, il modello di servizio è ancora distribuito, ma il codice non viene eseguito immediatamente. Al contrario, il servizio è PoweredOff fino a quando non si chiama Start, al momento in cui verrà avviato il servizio. Un servizio distribuito comporta ancora addebiti, anche se viene generato. |
bool |
| 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. |
'Auto' 'Manuale' 'Simultaneo' |
CloudServiceExtensionProfile
| Nome | Descrizione | Valore |
|---|---|---|
| Estensioni | Elenco di estensioni per il servizio cloud. | Estensione[] |
Estensione
| Nome | Descrizione | valore |
|---|---|---|
| name | Nome dell'estensione. | string |
| properties | Proprietà dell'estensione. | CloudServiceExtensionProperties |
CloudServiceExtensionProperties
| Nome | Descrizione | Valore |
|---|---|---|
| autoUpgradeMinorVersion | Specificare in modo esplicito se la piattaforma può aggiornare automaticamente typeHandlerVersion a versioni secondarie superiori quando diventano disponibili. | bool |
| forceUpdateTag | 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 nel ripetere o meno l'implementazione del gestore |
string |
| protectedSettings | 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. | CloudServiceVaultAndSecretReference |
| publisher | Nome dell'autore del gestore dell'estensione. | string |
| ruoliAppliedTo | 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. | string[] |
| impostazioni | 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. | |
| tipo | Specifica il tipo dell'estensione. | string |
| typeHandlerVersion | 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. | string |
CloudServiceVaultAndSecretReference
| Nome | Descrizione | Valore |
|---|---|---|
| secretUrl | URL segreto che contiene le impostazioni protette dell'estensione | string |
| sourceVault | ID risorsa ARM del Key Vault | SottoResource |
SottoResource
| Nome | Descrizione | Valore |
|---|---|---|
| id | ID risorsa | string |
CloudServiceNetworkProfile
| Nome | Descrizione | Valore |
|---|---|---|
| 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. | LoadBalancerConfiguration[] |
| slotType | Tipo di slot per il servizio cloud. I possibili valori sono i seguenti: Produzione Gestione temporanea Se non specificato, il valore predefinito è Production. |
'Produzione' 'Staging' |
| 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 altrimenti verrà generato un errore. | SottoResource |
LoadBalancerConfiguration
| Nome | Descrizione | Valore |
|---|---|---|
| id | ID risorsa | string |
| name | Nome del servizio di bilanciamento del carico | stringa (obbligatoria) |
| properties | Proprietà della configurazione del servizio di bilanciamento del carico. | LoadBalancerConfigurationProperties (obbligatorio) |
LoadBalancerConfigurationProperties
| Nome | Descrizione | Valore |
|---|---|---|
| frontendIPConfigurations | Specifica l'indirizzo 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[] (obbligatorio) |
LoadBalancerFrontendIPConfiguration
| Nome | Descrizione | valore |
|---|---|---|
| name | 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. | stringa (obbligatorio) |
| properties | Proprietà della configurazione ip front-end del servizio di bilanciamento del carico. | LoadBalancerFrontendIPConfigurationProperties (obbligatorio) |
LoadBalancerFrontendIPConfigurationProperties
| Nome | Descrizione | Valore |
|---|---|---|
| privateIPAddress | Indirizzo IP privato della rete virtuale della configurazione IP. | string |
| publicIPAddress | Riferimento alla risorsa indirizzo IP pubblico. | Sottorisorsa |
| Subnet | Riferimento alla risorsa subnet della rete virtuale. | Sottorisorsa |
CloudServiceOsProfile
| Nome | Descrizione | Valore |
|---|---|---|
| chiavi private | Specifica il set di certificati che devono essere installati nelle istanze del ruolo. | CloudServiceVaultSecretGroup[] |
CloudServiceVaultSecretGroup
| Nome | Descrizione | Valore |
|---|---|---|
| sourceVault | URL relativo del Key Vault contenente tutti i certificati in VaultCertificates. | Sottorisorsa |
| vaultCertificates | Elenco di riferimenti all'insieme di credenziali delle chiavi in SourceVault che contengono certificati. | CloudServiceVaultCertificate[] |
CloudServiceVaultCertificate
| Nome | Descrizione | Valore |
|---|---|---|
| certificateUrl | Si tratta dell'URL di un certificato caricato in Key Vault come segreto. | string |
CloudServiceRoleProfile
| Nome | Descrizione | Valore |
|---|---|---|
| Ruoli | Elenco dei ruoli per il servizio cloud. | CloudServiceRoleProfileProperties[] |
CloudServiceRoleProfileProperties
| Nome | Descrizione | valore |
|---|---|---|
| name | Nome risorsa. | string |
| sku | Descrive lo SKU del ruolo del servizio cloud. | CloudServiceRoleSku |
CloudServiceRoleSku
| Nome | Descrizione | Valore |
|---|---|---|
| capacità | Specifica il numero di istanze del ruolo nel servizio cloud. | INT |
| name | Nome sku. NOTA: se il nuovo SKU non è supportato nell'hardware in cui è attualmente attivo il servizio cloud, è necessario eliminare e ricreare il servizio cloud o tornare allo SKU precedente. | string |
| Livello | Specifica il livello del servizio cloud. I valori possibili sono Standard Base |
string |
SystemData
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
Definizione della risorsa Terraform (provider AzAPI)
Il tipo di risorsa cloudServices può essere distribuito con operazioni destinate a:
- Gruppi di risorse
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.Compute/cloudServices, aggiungere il codice Terraform seguente al modello.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/cloudServices@2022-04-04"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
allowModelOverride = bool
configuration = "string"
configurationUrl = "string"
extensionProfile = {
extensions = [
{
name = "string"
properties = {
autoUpgradeMinorVersion = bool
forceUpdateTag = "string"
protectedSettingsFromKeyVault = {
secretUrl = "string"
sourceVault = {
id = "string"
}
}
publisher = "string"
rolesAppliedTo = [
"string"
]
type = "string"
typeHandlerVersion = "string"
}
}
]
}
networkProfile = {
loadBalancerConfigurations = [
{
id = "string"
name = "string"
properties = {
frontendIPConfigurations = [
{
name = "string"
properties = {
privateIPAddress = "string"
publicIPAddress = {
id = "string"
}
subnet = {
id = "string"
}
}
}
]
}
}
]
slotType = "string"
swappableCloudService = {
id = "string"
}
}
osProfile = {
secrets = [
{
sourceVault = {
id = "string"
}
vaultCertificates = [
{
certificateUrl = "string"
}
]
}
]
}
packageUrl = "string"
roleProfile = {
roles = [
{
name = "string"
sku = {
capacity = int
name = "string"
tier = "string"
}
}
]
}
startCloudService = bool
upgradeMode = "string"
}
systemData = {}
})
}
Valori delle proprietà
cloudServices
| Nome | Descrizione | Valore |
|---|---|---|
| tipo | Tipo di risorsa | "Microsoft.Compute/cloudServices@2022-04-04" |
| name | Nome della risorsa | stringa (obbligatoria) Limite di caratteri: 1-15 Caratteri validi: Non è possibile usare spazi, caratteri di controllo o caratteri seguenti: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?Non può iniziare con un carattere di sottolineatura. Non può terminare con un punto o un trattino. |
| posizione | Percorso della risorsa. | stringa (obbligatoria) |
| parent_id | Per distribuire in un gruppo di risorse, usare l'ID del gruppo di risorse. | stringa (obbligatoria) |
| tags | Tag di risorse. | Dizionario dei nomi e dei valori dei tag. |
| properties | Proprietà del servizio cloud | CloudServiceProperties |
| systemData | Metadati di sistema relativi a questa risorsa. | SystemData |
CloudServiceProperties
| Nome | Descrizione | Valore |
|---|---|---|
| allowModelOverride | (Facoltativo) Indica se le proprietà dello sku del ruolo (roleProfile.role.sku) specificate nel modello/modello devono eseguire l'override rispettivamente del conteggio delle istanze del ruolo e delle dimensioni della macchina virtuale specificate rispettivamente in .cscfg e .csdef. Il valore predefinito è false. |
bool |
| configurazione | Specifica la configurazione del servizio XML (con estensione cscfg) per il servizio cloud. | string |
| configurationUrl | Specifica un URL che fa riferimento alla posizione della configurazione del servizio nel servizio BLOB. L'URL del pacchetto di servizio può essere URI firma di accesso condiviso da qualsiasi account di archiviazione. Questa è una proprietà di sola scrittura e non viene restituita nelle chiamate GET. |
string |
| extensionProfile | Descrive un profilo di estensione del servizio cloud. | CloudServiceExtensionProfile |
| networkProfile | Profilo di rete per il servizio cloud. | CloudServiceNetworkProfile |
| osProfile | Descrive il profilo del sistema operativo per il servizio cloud. | CloudServiceOsProfile |
| packageUrl | Specifica un URL che fa riferimento alla posizione del pacchetto del servizio nel servizio BLOB. L'URL del pacchetto di servizio può essere URI firma di accesso condiviso da qualsiasi account di archiviazione. Questa è una proprietà di sola scrittura e non viene restituita nelle chiamate GET. |
string |
| roleProfile | Descrive il profilo di ruolo per il servizio cloud. | CloudServiceRoleProfile |
| startCloudService | (Facoltativo) Indica se avviare il servizio cloud immediatamente dopo la creazione. Il valore predefinito è true.Se false, il modello di servizio è ancora distribuito, ma il codice non viene eseguito immediatamente. Al contrario, il servizio è PoweredOff fino a quando non si chiama Start, al momento in cui verrà avviato il servizio. Un servizio distribuito comporta ancora addebiti, anche se viene generato. |
bool |
| 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. |
"Auto" "Manuale" "Simultaneo" |
CloudServiceExtensionProfile
| Nome | Descrizione | Valore |
|---|---|---|
| Estensioni | Elenco di estensioni per il servizio cloud. | Estensione[] |
Estensione
| Nome | Descrizione | valore |
|---|---|---|
| name | Nome dell'estensione. | string |
| properties | Proprietà dell'estensione. | CloudServiceExtensionProperties |
CloudServiceExtensionProperties
| Nome | Descrizione | Valore |
|---|---|---|
| autoUpgradeMinorVersion | Specificare in modo esplicito se la piattaforma può aggiornare automaticamente typeHandlerVersion a versioni secondarie superiori quando diventano disponibili. | bool |
| forceUpdateTag | Tag per forzare l'applicazione delle impostazioni pubbliche e protette fornite. La modifica del valore del tag consente di eseguire di nuovo 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é nessuna delle impostazioni pubbliche o protette cambia, l'estensione passa all'istanza del ruolo con lo stesso numero di sequenza e spetta all'implementazione del gestore se eseguirla di nuovo o meno |
string |
| protectedSettings | Impostazioni protette per l'estensione crittografata prima dell'invio all'istanza del ruolo. | |
| protectedSettingsFromKeyVault | Impostazioni protette per l'estensione, a cui si fa riferimento usando KeyVault che vengono crittografate prima dell'invio all'istanza del ruolo. | CloudServiceVaultAndSecretReference |
| publisher | Nome del server di pubblicazione del gestore dell'estensione. | string |
| rolesAppliedTo | Elenco facoltativo di ruoli da applicare a questa estensione. Se la proprietà non è specificata o viene specificato '*', l'estensione viene applicata a tutti i ruoli nel servizio cloud. | string[] |
| impostazioni | Impostazioni pubbliche per l'estensione. Per le estensioni JSON, si tratta delle impostazioni JSON per l'estensione. Per l'estensione XML (ad esempio RDP), si tratta dell'impostazione XML per l'estensione. | |
| tipo | Specifica il tipo dell'estensione. | string |
| typeHandlerVersion | Specifica la versione dell'estensione. Specifica la versione dell'estensione. Se questo elemento non viene specificato o viene usato un asterisco (*) come valore, viene utilizzata 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 vengono specificati 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. | string |
CloudServiceVaultAndSecretReference
| Nome | Descrizione | Valore |
|---|---|---|
| secretUrl | URL segreto che contiene le impostazioni protette dell'estensione | string |
| sourceVault | ID risorsa ARM del Key Vault | Sottorisorsa |
Sottorisorsa
| Nome | Descrizione | Valore |
|---|---|---|
| id | ID risorsa | string |
CloudServiceNetworkProfile
| Nome | Descrizione | Valore |
|---|---|---|
| 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. | LoadBalancerConfiguration[] |
| slotType | Tipo di slot per il servizio cloud. I possibili valori sono i seguenti: Produzione Gestione temporanea Se non specificato, il valore predefinito è Production. |
"Produzione" "Staging" |
| 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. | Sottorisorsa |
LoadBalancerConfiguration
| Nome | Descrizione | Valore |
|---|---|---|
| id | ID risorsa | string |
| name | Nome del servizio di bilanciamento del carico | stringa (obbligatorio) |
| properties | Proprietà della configurazione del servizio di bilanciamento del carico. | LoadBalancerConfigurationProperties (obbligatorio) |
LoadBalancerConfigurationProperties
| Nome | Descrizione | Valore |
|---|---|---|
| frontendIPConfigurations | Specifica l'indirizzo 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[] (obbligatorio) |
LoadBalancerFrontendIPConfiguration
| Nome | Descrizione | valore |
|---|---|---|
| name | 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. | stringa (obbligatorio) |
| properties | Proprietà della configurazione ip front-end del servizio di bilanciamento del carico. | LoadBalancerFrontendIPConfigurationProperties (obbligatorio) |
LoadBalancerFrontendIPConfigurationProperties
| Nome | Descrizione | Valore |
|---|---|---|
| privateIPAddress | Indirizzo IP privato della rete virtuale della configurazione IP. | string |
| publicIPAddress | Riferimento alla risorsa indirizzo IP pubblico. | Sottorisorsa |
| Subnet | Riferimento alla risorsa subnet della rete virtuale. | Sottorisorsa |
CloudServiceOsProfile
| Nome | Descrizione | Valore |
|---|---|---|
| chiavi private | Specifica il set di certificati che devono essere installati nelle istanze del ruolo. | CloudServiceVaultSecretGroup[] |
CloudServiceVaultSecretGroup
| Nome | Descrizione | Valore |
|---|---|---|
| sourceVault | URL relativo del Key Vault contenente tutti i certificati in VaultCertificates. | Sottorisorsa |
| vaultCertificates | Elenco di riferimenti all'insieme di credenziali delle chiavi in SourceVault che contengono certificati. | CloudServiceVaultCertificate[] |
CloudServiceVaultCertificate
| Nome | Descrizione | Valore |
|---|---|---|
| certificateUrl | Si tratta dell'URL di un certificato caricato in Key Vault come segreto. | string |
CloudServiceRoleProfile
| Nome | Descrizione | Valore |
|---|---|---|
| Ruoli | Elenco dei ruoli per il servizio cloud. | CloudServiceRoleProfileProperties[] |
CloudServiceRoleProfileProperties
| Nome | Descrizione | valore |
|---|---|---|
| name | Nome risorsa. | string |
| sku | Descrive lo SKU del ruolo del servizio cloud. | CloudServiceRoleSku |
CloudServiceRoleSku
| Nome | Descrizione | Valore |
|---|---|---|
| capacità | Specifica il numero di istanze del ruolo nel servizio cloud. | INT |
| name | Nome sku. NOTA: se il nuovo SKU non è supportato nell'hardware in cui è attualmente attivo il servizio cloud, è necessario eliminare e ricreare il servizio cloud o tornare allo SKU precedente. | string |
| Livello | Specifica il livello del servizio cloud. I valori possibili sono Standard Base |
string |
SystemData
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.