Sdílet prostřednictvím


Microsoft.Compute cloudServices 4. 4. 2022

Definice prostředku Bicep

Typ prostředku cloudServices je možné nasadit s operacemi, které cílí na:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Compute/cloudServices, přidejte do šablony následující bicep.

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: {}
}

Hodnoty vlastností

cloudServices

Název Popis Hodnota
name Název prostředku string (povinné)

Limit počtu znaků: 1–15



Platné znaky:
Nelze použít mezery, řídicí znaky ani tyto znaky:
~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?

Nejde začínat podtržítkem. Nemůže končit tečkou nebo spojovníkem.
location Umístění prostředku. string (povinné)
tags Značky prostředků. Slovník názvů značek a hodnot. Viz Značky v šablonách
properties Vlastnosti cloudové služby CloudServiceProperties
systemData Systémová metadata týkající se tohoto prostředku. SystemData

CloudServiceProperties

Název Popis Hodnota
allowModelOverride (Volitelné) Určuje, jestli vlastnosti SKU role (roleProfile.roles.sku) zadané v modelu nebo šabloně mají přepsat počet instancí role a velikost virtuálního počítače zadaná v souborech .cscfg a .csdef v uvedeném pořadí.
Výchozí hodnota je false.
bool
konfigurace Určuje konfiguraci služby XML (.cscfg) pro cloudovou službu. řetězec
configurationUrl Určuje adresu URL, která odkazuje na umístění konfigurace služby ve službě Blob Service. Adresa URL balíčku služby může být identifikátor URI sdíleného přístupového podpisu (SAS) z libovolného účtu úložiště.
Jedná se o vlastnost jen pro zápis a nevrácená ve voláníCH GET.
řetězec
extensionProfile Popisuje profil rozšíření cloudové služby. CloudServiceExtensionProfile
networkProfile Profil sítě pro cloudovou službu. CloudServiceNetworkProfile
osProfile Popisuje profil operačního systému pro cloudovou službu. CloudServiceOsProfile
packageUrl Určuje adresu URL, která odkazuje na umístění balíčku služby ve službě Blob Service. Adresa URL balíčku služby může být identifikátor URI sdíleného přístupového podpisu (SAS) z libovolného účtu úložiště.
Jedná se o vlastnost jen pro zápis a nevrácená ve voláníCH GET.
řetězec
roleProfile Popisuje profil role pro cloudovou službu. CloudServiceRoleProfile
startCloudService (Volitelné) Určuje, jestli se má cloudová služba spustit okamžitě po jejím vytvoření. Výchozí hodnota je true.
Pokud je false, model služby je stále nasazený, ale kód se nespustí okamžitě. Místo toho je služba PoweredOff, dokud nevoláte Start, kdy se služba spustí. Za nasazenou službu se stále účtují poplatky, i když je vypnutá.
bool
upgradeMode Režim aktualizace pro cloudovou službu. Instance rolí se při nasazení služby přidělují k aktualizaci domén. Aktualizace je možné zahájit ručně v každé aktualizační doméně nebo automaticky ve všech aktualizačních doménách.
Možné hodnoty jsou

Auto

Ruční

Současné


Pokud není zadán, výchozí hodnota je Automaticky. Pokud je nastavena na Ručně, put UpdateDomain musí být volána, aby se aktualizace použila. Pokud je nastavená možnost Automaticky, aktualizace se automaticky aplikuje na každou aktualizační doménu v pořadí.
'Automaticky'
'Ruční'
"Simultánní"

CloudServiceExtensionProfile

Název Popis Hodnota
rozšíření Seznam rozšíření pro cloudovou službu Rozšíření[]

Rozšíření

Název Popis Hodnota
name Název rozšíření. řetězec
properties Vlastnosti rozšíření. CloudServiceExtensionProperties

CloudServiceExtensionProperties

Název Popis Hodnota
autoUpgradeMinorVersion Explicitně určete, jestli platforma může automaticky upgradovat typeHandlerVersion na vyšší podverze, jakmile budou k dispozici. bool
forceUpdateTag Značka, která vynutí použití poskytnutého veřejného a chráněného nastavení.
Změna hodnoty značky umožňuje opětovné spuštění rozšíření beze změny veřejného nebo chráněného nastavení.
Pokud se forceUpdateTag nezmění, obslužná rutina bude nadále používat aktualizace veřejného nebo chráněného nastavení.
Pokud se nezmění ani forceUpdateTag ani žádné z veřejných nebo chráněných nastavení, rozšíření přejde do instance role se stejným pořadovým číslem a
je na implementaci obslužné rutiny, jestli ji znovu spustíte nebo ne.
řetězec
protectedSettings Chráněná nastavení pro rozšíření, která jsou před odesláním do instance role zašifrovaná. Pro Bicep můžete použít funkci any().
protectedSettingsFromKeyVault Chráněná nastavení pro rozšíření, na která se odkazuje pomocí služby KeyVault, která jsou před odesláním do instance role zašifrovaná. CloudServiceVaultAndSecretReference
vydavatel Název vydavatele obslužné rutiny rozšíření. řetězec
rolesAppliedTo Volitelný seznam rolí pro použití tohoto rozšíření Pokud vlastnost není zadána nebo je zadána hodnota *, použije se rozšíření pro všechny role v cloudové službě. string[]
nastavení Veřejná nastavení rozšíření. U rozšíření JSON se jedná o nastavení JSON pro rozšíření. Pro rozšíření XML (například RDP) se jedná o nastavení XML pro rozšíření. Pro Bicep můžete použít funkci any().
typ Určuje typ rozšíření. řetězec
typeHandlerVersion Určuje verzi rozšíření. Určuje verzi rozšíření. Pokud tento prvek není zadán nebo se jako hodnota použije hvězdička (*), použije se nejnovější verze rozšíření. Pokud je hodnota zadána s číslem hlavní verze a hvězdičkou jako číslo podverze (X), je vybrána nejnovější podverze zadané hlavní verze. Pokud je zadané číslo hlavní verze a číslo podverze (X.Y), vybere se konkrétní verze rozšíření. Pokud je zadaná verze, provede se automatický upgrade instance role. řetězec

CloudServiceVaultAndSecretReference

Název Popis Hodnota
secretUrl Adresa URL tajného kódu, která obsahuje chráněné nastavení rozšíření řetězec
sourceVault ID prostředku ARM Key Vault Dílčí zdroj

Dílčí zdroj

Název Popis Hodnota
id ID prostředku řetězec

CloudServiceNetworkProfile

Název Popis Hodnota
loadBalancerConfigurations Seznam konfigurací nástroje pro vyrovnávání zatížení Cloudová služba může mít až dvě konfigurace nástroje pro vyrovnávání zatížení, které odpovídají veřejnému Load Balancer a internímu Load Balancer. LoadBalancerConfiguration[]
slotType Typ slotu pro cloudovou službu
Možné hodnoty jsou:

Produkční

Příprava


Pokud není zadáno, výchozí hodnota je Production.If not specified, the default value is Production.
'Production'
'Přípravný'
swappableCloudService Odkaz NA ID cloudové služby obsahující cílovou IP adresu, se kterou může předmětná cloudová služba provést prohození. Tuto vlastnost nelze po nastavení aktualizovat. Musí existovat prohoditelná cloudová služba, na kterou odkazuje toto ID, jinak dojde k chybě. Dílčí zdroj

LoadBalancerConfiguration

Název Popis Hodnota
id ID prostředku řetězec
name Název nástroje pro vyrovnávání zatížení string (povinné)
properties Vlastnosti konfigurace nástroje pro vyrovnávání zatížení. LoadBalancerConfigurationProperties (povinné)

LoadBalancerConfigurationProperties

Název Popis Hodnota
frontendIPConfigurations Určuje IP adresu front-endu, která se má použít pro nástroj pro vyrovnávání zatížení. Podporuje se jenom ip adresa front-endu IPv4. Každá konfigurace nástroje pro vyrovnávání zatížení musí mít přesně jednu konfiguraci front-endové IP adresy. LoadBalancerFrontendIPConfiguration[] (povinné)

LoadBalancerFrontendIPConfiguration

Název Popis Hodnota
name Název prostředku, který je jedinečný v rámci sady konfigurací front-endových IP adres používaných nástrojem pro vyrovnávání zatížení. Tento název se dá použít pro přístup k prostředku. string (povinné)
properties Vlastnosti konfigurace front-endové IP adresy nástroje pro vyrovnávání zatížení LoadBalancerFrontendIPConfigurationProperties (povinné)

LoadBalancerFrontendIPConfigurationVlastnosti

Název Popis Hodnota
privateIPAddress Privátní IP adresa virtuální sítě konfigurace IP adresy. řetězec
publicIPAddress Odkaz na prostředek veřejné IP adresy. Dílčí zdroj
podsíť Odkaz na prostředek podsítě virtuální sítě. Dílčí zdroj

CloudServiceOsProfile

Název Popis Hodnota
Tajemství Určuje sadu certifikátů, které se mají nainstalovat do instancí rolí. CloudServiceVaultSecretGroup[]

CloudServiceVaultSecretGroup

Název Popis Hodnota
sourceVault Relativní adresa URL Key Vault obsahující všechny certifikáty v trezoruCertificates. Dílčí zdroj
vaultCertificates Seznam odkazů na trezor klíčů ve službě SourceVault, které obsahují certifikáty. CloudServiceVaultCertificate[]

CloudServiceVaultCertificate

Název Popis Hodnota
certificateUrl Toto je adresa URL certifikátu, který se nahrál do Key Vault jako tajný kód. řetězec

CloudServiceRoleProfile

Název Popis Hodnota
Role Seznam rolí pro cloudovou službu CloudServiceRoleProfileProperties[]

CloudServiceRoleProfileProperties

Název Popis Hodnota
name Název prostředku. řetězec
Sku Popisuje skladovou položku role cloudové služby. CloudServiceRoleSku

CloudServiceRoleSku

Název Popis Hodnota
capacity Určuje počet instancí rolí v cloudové službě. int
name Název skladové položky. POZNÁMKA: Pokud se nová skladová položka nepodporuje na hardwaru, na které se cloudová služba aktuálně nachází, musíte cloudovou službu odstranit a znovu vytvořit nebo přejít zpět na starou skladovou položku. řetězec
tier Určuje úroveň cloudové služby. Možné hodnoty jsou

Standard

Basic
řetězec

SystemData

Tento objekt neobsahuje žádné vlastnosti, které by se nastavily během nasazování. Všechny vlastnosti jsou Jen pro čtení.

Definice prostředku šablony ARM

Typ prostředku cloudServices je možné nasadit s operacemi, které cílí na:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Compute/cloudServices, přidejte do šablony následující kód JSON.

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

Hodnoty vlastností

cloudServices

Název Popis Hodnota
typ Typ prostředku Microsoft.Compute/cloudServices
apiVersion Verze rozhraní API prostředků '2022-04-04'
name Název prostředku string (povinné)

Limit počtu znaků: 1–15



Platné znaky:
Nelze použít mezery, řídicí znaky ani tyto znaky:
~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?

Nejde začínat podtržítkem. Nemůže končit tečkou nebo spojovníkem.
location Umístění prostředku. string (povinné)
tags Značky prostředků. Slovník názvů značek a hodnot. Viz Značky v šablonách
properties Vlastnosti cloudové služby CloudServiceProperties
systemData Systémová metadata týkající se tohoto prostředku. SystemData

CloudServiceProperties

Název Popis Hodnota
allowModelOverride (Volitelné) Určuje, jestli vlastnosti SKU role (roleProfile.roles.sku) zadané v modelu nebo šabloně mají přepsat počet instancí role a velikost virtuálního počítače zadaná v souborech .cscfg a .csdef v uvedeném pořadí.
Výchozí hodnota je false.
bool
konfigurace Určuje konfiguraci služby XML (.cscfg) pro cloudovou službu. řetězec
configurationUrl Určuje adresu URL, která odkazuje na umístění konfigurace služby ve službě Blob Service. Adresa URL balíčku služby může být identifikátor URI sdíleného přístupového podpisu (SAS) z libovolného účtu úložiště.
Jedná se o vlastnost jen pro zápis a nevrácená ve voláníCH GET.
řetězec
extensionProfile Popisuje profil rozšíření cloudové služby. CloudServiceExtensionProfile
networkProfile Profil sítě pro cloudovou službu. CloudServiceNetworkProfile
osProfile Popisuje profil operačního systému pro cloudovou službu. CloudServiceOsProfile
packageUrl Určuje adresu URL, která odkazuje na umístění balíčku služby ve službě Blob Service. Adresa URL balíčku služby může být identifikátor URI sdíleného přístupového podpisu (SAS) z libovolného účtu úložiště.
Jedná se o vlastnost jen pro zápis a nevrácená ve voláníCH GET.
řetězec
roleProfile Popisuje profil role pro cloudovou službu. CloudServiceRoleProfile
startCloudService (Volitelné) Určuje, jestli se má cloudová služba spustit okamžitě po jejím vytvoření. Výchozí hodnota je true.
Pokud je false, model služby je stále nasazený, ale kód se nespustí okamžitě. Místo toho je služba PoweredOff, dokud nevoláte Start, kdy se služba spustí. Za nasazenou službu se stále účtují poplatky, i když je vypnutá.
bool
upgradeMode Režim aktualizace pro cloudovou službu. Instance rolí se při nasazení služby přidělují k aktualizaci domén. Aktualizace je možné zahájit ručně v každé aktualizační doméně nebo automaticky ve všech aktualizačních doménách.
Možné hodnoty jsou

Auto

Ruční

Současné


Pokud není zadán, výchozí hodnota je Automaticky. Pokud je nastavena na Ručně, put UpdateDomain musí být volána, aby se aktualizace použila. Pokud je nastavená možnost Automaticky, aktualizace se automaticky aplikuje na každou aktualizační doménu v pořadí.
'Automaticky'
'Ruční'
"Simultánní"

CloudServiceExtensionProfile

Název Popis Hodnota
rozšíření Seznam rozšíření pro cloudovou službu Rozšíření[]

Rozšíření

Název Popis Hodnota
name Název rozšíření. řetězec
properties Vlastnosti rozšíření. CloudServiceExtensionProperties

CloudServiceExtensionProperties

Název Popis Hodnota
autoUpgradeMinorVersion Explicitně určete, jestli platforma může automaticky upgradovat typeHandlerVersion na vyšší podverze, jakmile budou k dispozici. bool
forceUpdateTag Značka, která vynutí použití poskytnutého veřejného a chráněného nastavení.
Změna hodnoty značky umožňuje opětovné spuštění rozšíření beze změny veřejného nebo chráněného nastavení.
Pokud se forceUpdateTag nezmění, obslužná rutina stále použije aktualizace veřejného nebo chráněného nastavení.
Pokud se nezmění ani forceUpdateTag, ani žádné veřejné nebo chráněné nastavení, rozšíření bude přitékat do instance role se stejným pořadovým číslem a
záleží na implementaci obslužné rutiny, jestli ji znovu spustíte nebo ne.
řetězec
protectedSettings Chráněná nastavení rozšíření, která se před odesláním do instance role zašifrují.
protectedSettingsFromKeyVault Chráněná nastavení rozšíření, na která se odkazuje pomocí služby Key Vault, která jsou před odesláním do instance role zašifrovaná. CloudServiceVaultAndSecretReference
vydavatel Název vydavatele obslužné rutiny rozšíření. řetězec
roleAppliedTo Volitelný seznam rolí pro použití tohoto rozšíření Pokud není zadaná vlastnost nebo je zadána hodnota *, použije se rozšíření pro všechny role v cloudové službě. string[]
nastavení Veřejná nastavení rozšíření. U rozšíření JSON se jedná o nastavení JSON pro rozšíření. Pro rozšíření XML (například RDP) se jedná o nastavení XML pro rozšíření.
typ Určuje typ rozšíření. řetězec
typeHandlerVersion Určuje verzi rozšíření. Určuje verzi rozšíření. Pokud tento prvek není zadán nebo se jako hodnota použije hvězdička (*), použije se nejnovější verze rozšíření. Pokud je hodnota zadána číslem hlavní verze a hvězdičkou jako číslo podverze (X.), je vybrána nejnovější podverze zadané hlavní verze. Pokud je zadáno číslo hlavní verze a číslo podverze (X.Y), je vybrána konkrétní verze rozšíření. Pokud je zadaná verze, provede se automatický upgrade instance role. řetězec

CloudServiceVaultAndSecretReference

Název Popis Hodnota
adresa URL tajného kódu Adresa URL tajného kódu, která obsahuje chráněná nastavení rozšíření řetězec
sourceVault ID prostředku ARM Key Vault Dílčí zdroj

Dílčí zdroj

Název Popis Hodnota
id ID prostředku řetězec

CloudServiceNetworkProfile

Název Popis Hodnota
loadBalancerConfigurations Seznam konfigurací nástroje pro vyrovnávání zatížení Cloudová služba může mít až dvě konfigurace nástroje pro vyrovnávání zatížení, které odpovídají veřejné Load Balancer a internímu Load Balancer. LoadBalancerConfiguration[]
typ slotu Typ slotu pro cloudovou službu.
Možné hodnoty jsou:

Produkční

Příprava


Pokud není zadaný, výchozí hodnota je Production.
'Production'
'Pracovní'
swappableCloudService Odkaz na ID cloudové služby obsahující cílovou IP adresu, se kterou může předmětná cloudová služba provést prohození. Tuto vlastnost nelze po nastavení aktualizovat. Musí existovat prohozená cloudová služba, na kterou odkazuje toto ID, jinak dojde k chybě. Dílčí zdroj

LoadBalancerConfiguration

Název Popis Hodnota
id ID prostředku řetězec
name Název nástroje pro vyrovnávání zatížení string (povinné)
properties Vlastnosti konfigurace nástroje pro vyrovnávání zatížení LoadBalancerConfigurationProperties (povinné)

LoadBalancerConfigurationProperties

Název Popis Hodnota
frontendIPConfigurations Určuje IP adresu front-endu, která se má použít pro nástroj pro vyrovnávání zatížení. Podporuje se jenom ip adresa front-endu IPv4. Každá konfigurace nástroje pro vyrovnávání zatížení musí mít přesně jednu konfiguraci front-endové IP adresy. LoadBalancerFrontendIPConfiguration[] (povinné)

LoadBalancerFrontendIPConfiguration

Název Popis Hodnota
name Název prostředku, který je jedinečný v rámci sady konfigurací front-endových IP adres používaných nástrojem pro vyrovnávání zatížení. Tento název se dá použít pro přístup k prostředku. string (povinné)
properties Vlastnosti konfigurace front-endové IP adresy nástroje pro vyrovnávání zatížení LoadBalancerFrontendIPConfigurationProperties (povinné)

LoadBalancerFrontendIPConfigurationVlastnosti

Název Popis Hodnota
privateIPAddress Privátní IP adresa virtuální sítě konfigurace IP adresy. řetězec
publicIPAddress Odkaz na prostředek veřejné IP adresy. Dílčí zdroj
podsíť Odkaz na prostředek podsítě virtuální sítě. Dílčí zdroj

CloudServiceOsProfile

Název Popis Hodnota
Tajemství Určuje sadu certifikátů, které se mají nainstalovat do instancí rolí. CloudServiceVaultSecretGroup[]

CloudServiceVaultSecretGroup

Název Popis Hodnota
sourceVault Relativní adresa URL Key Vault obsahující všechny certifikáty v trezoruCertificates. Dílčí zdroj
vaultCertificates Seznam odkazů na trezor klíčů ve službě SourceVault, které obsahují certifikáty. CloudServiceVaultCertificate[]

CloudServiceVaultCertificate

Název Popis Hodnota
certificateUrl Toto je adresa URL certifikátu, který se nahrál do Key Vault jako tajný kód. řetězec

CloudServiceRoleProfile

Název Popis Hodnota
Role Seznam rolí pro cloudovou službu CloudServiceRoleProfileProperties[]

CloudServiceRoleProfileProperties

Název Popis Hodnota
name Název prostředku. řetězec
Sku Popisuje skladovou položku role cloudové služby. CloudServiceRoleSku

CloudServiceRoleSku

Název Popis Hodnota
capacity Určuje počet instancí rolí v cloudové službě. int
name Název skladové položky. POZNÁMKA: Pokud se nová skladová položka nepodporuje na hardwaru, na které se cloudová služba aktuálně nachází, musíte cloudovou službu odstranit a znovu vytvořit nebo přejít zpět na starou skladovou položku. řetězec
tier Určuje úroveň cloudové služby. Možné hodnoty jsou

Standard

Basic
řetězec

SystemData

Tento objekt neobsahuje žádné vlastnosti, které by se nastavily během nasazování. Všechny vlastnosti jsou Jen pro čtení.

Definice prostředku Terraformu (zprostředkovatele AzAPI)

Typ prostředku cloudServices je možné nasadit s operacemi, které cílí na:

  • Skupiny prostředků

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Compute/cloudServices, přidejte do šablony následující Terraform.

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 = {}
  })
}

Hodnoty vlastností

cloudServices

Název Popis Hodnota
typ Typ prostředku Microsoft.Compute/cloudServices@2022-04-04
name Název prostředku string (povinné)

Limit počtu znaků: 1–15



Platné znaky:
Nelze použít mezery, řídicí znaky ani tyto znaky:
~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?

Nejde začínat podtržítkem. Nemůže končit tečkou nebo spojovníkem.
location Umístění prostředku. string (povinné)
parent_id K nasazení do skupiny prostředků použijte ID této skupiny prostředků. string (povinné)
tags Značky prostředků. Slovník názvů značek a hodnot.
properties Vlastnosti cloudové služby CloudServiceProperties
systemData Systémová metadata týkající se tohoto prostředku. SystemData

CloudServiceProperties

Název Popis Hodnota
allowModelOverride (Volitelné) Určuje, jestli vlastnosti SKU role (roleProfile.roles.sku) zadané v modelu nebo šabloně mají přepsat počet instancí role a velikost virtuálního počítače zadaná v souborech .cscfg a .csdef v uvedeném pořadí.
Výchozí hodnota je false.
bool
konfigurace Určuje konfiguraci služby XML (.cscfg) pro cloudovou službu. řetězec
configurationUrl Určuje adresu URL, která odkazuje na umístění konfigurace služby ve službě Blob Service. Adresa URL balíčku služby může být identifikátor URI sdíleného přístupového podpisu (SAS) z libovolného účtu úložiště.
Jedná se o vlastnost jen pro zápis a nevrácená ve voláníCH GET.
řetězec
extensionProfile Popisuje profil rozšíření cloudové služby. CloudServiceExtensionProfile
networkProfile Profil sítě pro cloudovou službu. CloudServiceNetworkProfile
osProfile Popisuje profil operačního systému pro cloudovou službu. CloudServiceOsProfile
packageUrl Určuje adresu URL, která odkazuje na umístění balíčku služby ve službě Blob Service. Adresa URL balíčku služby může být identifikátor URI sdíleného přístupového podpisu (SAS) z libovolného účtu úložiště.
Jedná se o vlastnost jen pro zápis a nevrácená ve voláníCH GET.
řetězec
roleProfile Popisuje profil role pro cloudovou službu. CloudServiceRoleProfile
startCloudService (Volitelné) Určuje, jestli se má cloudová služba spustit okamžitě po jejím vytvoření. Výchozí hodnota je true.
Pokud je false, model služby je stále nasazený, ale kód se nespustí okamžitě. Místo toho je služba PoweredOff, dokud nevoláte Start, kdy se služba spustí. Za nasazenou službu se stále účtují poplatky, i když je vypnutá.
bool
upgradeMode Režim aktualizace pro cloudovou službu. Instance rolí se při nasazení služby přidělují k aktualizaci domén. Aktualizace je možné zahájit ručně v každé aktualizační doméně nebo automaticky ve všech aktualizačních doménách.
Možné hodnoty jsou

Auto

Ruční

Současné


Pokud není zadán, výchozí hodnota je Automaticky. Pokud je nastavena na Ručně, put UpdateDomain musí být volána, aby se aktualizace použila. Pokud je nastavená možnost Automaticky, aktualizace se automaticky aplikuje na každou aktualizační doménu v pořadí.
"Automaticky"
"Ruční"
"Simultánní"

CloudServiceExtensionProfile

Název Popis Hodnota
rozšíření Seznam rozšíření pro cloudovou službu Rozšíření[]

Rozšíření

Název Popis Hodnota
name Název rozšíření. řetězec
properties Vlastnosti rozšíření. CloudServiceExtensionProperties

CloudServiceExtensionProperties

Název Popis Hodnota
autoUpgradeMinorVersion Explicitně určete, jestli platforma může automaticky upgradovat typeHandlerVersion na vyšší podverze, jakmile budou k dispozici. bool
forceUpdateTag Značka, která vynutí použití poskytnutého veřejného a chráněného nastavení.
Změna hodnoty značky umožňuje opětovné spuštění rozšíření beze změny veřejného nebo chráněného nastavení.
Pokud se forceUpdateTag nezmění, obslužná rutina stále použije aktualizace veřejného nebo chráněného nastavení.
Pokud se nezmění ani forceUpdateTag, ani žádné veřejné nebo chráněné nastavení, rozšíření bude přitékat do instance role se stejným pořadovým číslem a
záleží na implementaci obslužné rutiny, jestli ji znovu spustíte nebo ne.
řetězec
protectedSettings Chráněná nastavení rozšíření, která se před odesláním do instance role zašifrují.
protectedSettingsFromKeyVault Chráněná nastavení rozšíření, na která se odkazuje pomocí služby Key Vault, která jsou před odesláním do instance role zašifrovaná. CloudServiceVaultAndSecretReference
vydavatel Název vydavatele obslužné rutiny rozšíření. řetězec
roleAppliedTo Volitelný seznam rolí pro použití tohoto rozšíření Pokud není zadaná vlastnost nebo je zadána hodnota *, použije se rozšíření pro všechny role v cloudové službě. string[]
nastavení Veřejná nastavení rozšíření. U rozšíření JSON se jedná o nastavení JSON pro rozšíření. Pro rozšíření XML (například RDP) se jedná o nastavení XML pro rozšíření.
typ Určuje typ rozšíření. řetězec
typeHandlerVersion Určuje verzi rozšíření. Určuje verzi rozšíření. Pokud tento prvek není zadán nebo se jako hodnota použije hvězdička (*), použije se nejnovější verze rozšíření. Pokud je hodnota zadána číslem hlavní verze a hvězdičkou jako číslo podverze (X.), je vybrána nejnovější podverze zadané hlavní verze. Pokud je zadáno číslo hlavní verze a číslo podverze (X.Y), je vybrána konkrétní verze rozšíření. Pokud je zadaná verze, provede se automatický upgrade instance role. řetězec

CloudServiceVaultAndSecretReference

Název Popis Hodnota
adresa URL tajného kódu Adresa URL tajného kódu, která obsahuje chráněná nastavení rozšíření řetězec
sourceVault ID prostředku ARM Key Vault Dílčí zdroj

Dílčí zdroj

Název Popis Hodnota
id ID prostředku řetězec

CloudServiceNetworkProfile

Název Popis Hodnota
loadBalancerConfigurations Seznam konfigurací nástroje pro vyrovnávání zatížení Cloudová služba může mít až dvě konfigurace nástroje pro vyrovnávání zatížení, které odpovídají veřejné Load Balancer a internímu Load Balancer. LoadBalancerConfiguration[]
typ slotu Typ slotu pro cloudovou službu.
Možné hodnoty jsou:

Produkční

Příprava


Pokud není zadaný, výchozí hodnota je Production.
"Produkční"
"Pracovní"
swappableCloudService Odkaz na ID cloudové služby obsahující cílovou IP adresu, se kterou může předmětná cloudová služba provést prohození. Tuto vlastnost nelze po nastavení aktualizovat. Musí existovat prohozená cloudová služba, na kterou odkazuje toto ID, jinak dojde k chybě. Dílčí zdroj

LoadBalancerConfiguration

Název Popis Hodnota
id ID prostředku řetězec
name Název nástroje pro vyrovnávání zatížení string (povinné)
properties Vlastnosti konfigurace nástroje pro vyrovnávání zatížení LoadBalancerConfigurationProperties (povinné)

LoadBalancerConfigurationProperties

Název Popis Hodnota
konfigurace IP adres front-endu Určuje IP adresu front-endu, která se má použít pro nástroj pro vyrovnávání zatížení. Podporuje se pouze IP adresa front-endu IPv4. Každá konfigurace nástroje pro vyrovnávání zatížení musí mít přesně jednu konfiguraci IP adresy front-endu. LoadBalancerFrontendIPConfiguration[] (povinné)

LoadBalancerFrontendIPConfiguration

Název Popis Hodnota
name Název prostředku, který je jedinečný v rámci sady konfigurací front-endových IP adres používaných nástrojem pro vyrovnávání zatížení. Tento název se dá použít pro přístup k prostředku. string (povinné)
properties Vlastnosti konfigurace front-endové IP adresy nástroje pro vyrovnávání zatížení LoadBalancerFrontendIPConfigurationProperties (povinné)

LoadBalancerFrontendIPConfigurationVlastnosti

Název Popis Hodnota
privateIPAddress Privátní IP adresa virtuální sítě konfigurace IP adresy. řetězec
publicIPAddress Odkaz na prostředek veřejné IP adresy. Dílčí zdroj
podsíť Odkaz na prostředek podsítě virtuální sítě. Dílčí zdroj

CloudServiceOsProfile

Název Popis Hodnota
Tajemství Určuje sadu certifikátů, které se mají nainstalovat do instancí rolí. CloudServiceVaultSecretGroup[]

CloudServiceVaultSecretGroup

Název Popis Hodnota
sourceVault Relativní adresa URL Key Vault obsahující všechny certifikáty v trezoruCertificates. Dílčí zdroj
vaultCertificates Seznam odkazů na trezor klíčů ve službě SourceVault, které obsahují certifikáty. CloudServiceVaultCertificate[]

CloudServiceVaultCertificate

Název Popis Hodnota
certificateUrl Toto je adresa URL certifikátu, který se nahrál do Key Vault jako tajný kód. řetězec

CloudServiceRoleProfile

Název Popis Hodnota
Role Seznam rolí pro cloudovou službu CloudServiceRoleProfileProperties[]

CloudServiceRoleProfileProperties

Název Popis Hodnota
name Název prostředku. řetězec
Sku Popisuje skladovou položku role cloudové služby. CloudServiceRoleSku

CloudServiceRoleSku

Název Popis Hodnota
capacity Určuje počet instancí rolí v cloudové službě. int
name Název skladové položky. POZNÁMKA: Pokud se nová skladová položka nepodporuje na hardwaru, na které se cloudová služba aktuálně nachází, musíte cloudovou službu odstranit a znovu vytvořit nebo přejít zpět na starou skladovou položku. řetězec
tier Určuje úroveň cloudové služby. Možné hodnoty jsou

Standard

Basic
řetězec

SystemData

Tento objekt neobsahuje žádné vlastnosti, které by se nastavily během nasazování. Všechny vlastnosti jsou Jen pro čtení.