Partager via

Microsoft.Compute cloudServices 2022-09-04

  • Article

Définition de ressource Bicep

Le type de ressource cloudServices peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Compute/cloudServices, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Compute/cloudServices@2022-09-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: {}
  zones: [
    'string' or int
  ]
}

Valeurs de propriété

cloudServices

Nom Description Valeur
nom Nom de la ressource chaîne (obligatoire)

Limite de caractères : 1 à 15



Caractères valides :
Impossible d’utiliser des espaces, des caractères de contrôle ou des caractères suivants :
~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?

Impossible de commencer par le trait de soulignement. Impossible de se terminer par un point ou un trait d’union.
emplacement Emplacement des ressources. chaîne (obligatoire)
étiquettes Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
Propriétés Propriétés du service cloud CloudServiceProperties
systemData Métadonnées système relatives à cette ressource. SystemData
zones Liste de la zone de disponibilité logique de la ressource. La liste ne doit contenir que 1 zone où le service cloud doit être approvisionné. Ce champ est facultatif. Tableau de zones de disponibilité sous forme de chaîne ou d’int.

CloudServiceProperties

Nom Description Valeur
allowModelOverride (Facultatif) Indique si les propriétés de la référence sku de rôle (roleProfile.roles.sku) spécifiées dans le modèle/modèle doivent remplacer respectivement le nombre d’instances de rôle et la taille de machine virtuelle spécifiées dans .cscfg et .csdef.
La valeur par défaut est false.		 Bool
configuration Spécifie la configuration du service XML (.cscfg) pour le service cloud. corde
configurationUrl Spécifie une URL qui fait référence à l’emplacement de la configuration du service dans le service Blob. L’URL du package de service peut être un URI de signature d’accès partagé (SAP) à partir de n’importe quel compte de stockage.
Il s’agit d’une propriété en écriture seule et n’est pas retournée dans les appels GET.		 corde
extensionProfile Décrit un profil d’extension de service cloud. CloudServiceExtensionProfile
networkProfile Profil réseau pour le service cloud. CloudServiceNetworkProfile
osProfile Décrit le profil du système d’exploitation pour le service cloud. CloudServiceOsProfile
packageUrl Spécifie une URL qui fait référence à l’emplacement du package de service dans le service Blob. L’URL du package de service peut être un URI de signature d’accès partagé (SAP) à partir de n’importe quel compte de stockage.
Il s’agit d’une propriété en écriture seule et n’est pas retournée dans les appels GET.		 corde
roleProfile Décrit le profil de rôle pour le service cloud. CloudServiceRoleProfile
startCloudService (Facultatif) Indique s’il faut démarrer le service cloud immédiatement après sa création. La valeur par défaut est true.
Si la valeur est false, le modèle de service est toujours déployé, mais le code n’est pas exécuté immédiatement. Au lieu de cela, le service est PoweredOff jusqu’à ce que vous appeliez Démarrer, au moment où le service sera démarré. Un service déployé entraîne toujours des frais, même s’il est alimenté.		 Bool
upgradeMode Mode de mise à jour pour le service cloud. Les instances de rôle sont allouées aux domaines de mise à jour lorsque le service est déployé. Les mises à jour peuvent être lancées manuellement dans chaque domaine de mise à jour ou lancées automatiquement dans tous les domaines de mise à jour.
Les valeurs possibles sont

automatique

manuel

simultanée


S’il n’est pas spécifié, la valeur par défaut est Auto. Si la valeur est Manuelle, PUT UpdateDomain doit être appelée pour appliquer la mise à jour. Si la valeur est Automatique, la mise à jour est automatiquement appliquée à chaque domaine de mise à jour en séquence.
 'Auto'
'Manuel'
'Simultané'

CloudServiceExtensionProfile

Nom Description Valeur
Extensions Liste des extensions pour le service cloud. extension[]

Extension

Nom Description Valeur
nom Nom de l’extension. corde
Propriétés Propriétés de l’extension. CloudServiceExtensionProperties

CloudServiceExtensionProperties

Nom Description Valeur
autoUpgradeMinorVersion Spécifiez explicitement si la plateforme peut mettre à niveau automatiquement typeHandlerVersion vers des versions mineures supérieures lorsqu’elles deviennent disponibles. Bool
forceUpdateTag Balise pour forcer l’application des paramètres publics et protégés fournis.
La modification de la valeur de balise permet de réexécter l’extension sans modifier les paramètres publics ou protégés.
Si forceUpdateTag n’est pas modifié, les mises à jour des paramètres publics ou protégés sont toujours appliquées par le gestionnaire.
Si ni forceUpdateTag ni aucun des paramètres publics ou protégés ne change, l’extension est transmise à l’instance de rôle avec le même numéro de séquence et
il est à l’implémentation du gestionnaire s’il faut le réexécuter ou non		 corde
protectedSettings Paramètres protégés pour l’extension qui sont chiffrés avant d’être envoyés à l’instance de rôle. Pour Bicep, vous pouvez utiliser la fonction any().
protectedSettingsFromKeyVault Paramètres protégés de l’extension, référencés à l’aide de KeyVault qui sont chiffrés avant d’être envoyés à l’instance de rôle. CloudServiceVaultAndSecretReference
éditeur Nom du serveur de publication du gestionnaire d’extensions. corde
rolesAppliedTo Liste facultative des rôles à appliquer à cette extension. Si la propriété n’est pas spécifiée ou « * » est spécifiée, l’extension est appliquée à tous les rôles du service cloud. string[]
Paramètres Paramètres publics de l’extension. Pour les extensions JSON, il s’agit des paramètres JSON de l’extension. Pour l’extension XML (comme RDP), il s’agit du paramètre XML de l’extension. Pour Bicep, vous pouvez utiliser la fonction any().
type Spécifie le type de l’extension. corde
typeHandlerVersion Spécifie la version de l’extension. Spécifie la version de l’extension. Si cet élément n’est pas spécifié ou si un astérisque (*) est utilisé comme valeur, la dernière version de l’extension est utilisée. Si la valeur est spécifiée avec un numéro de version principal et un astérisque comme numéro de version mineure (X.), la dernière version mineure de la version principale spécifiée est sélectionnée. Si un numéro de version principal et un numéro de version secondaire sont spécifiés (X.Y), la version d’extension spécifique est sélectionnée. Si une version est spécifiée, une mise à niveau automatique est effectuée sur l’instance de rôle. corde

CloudServiceVaultAndSecretReference

Nom Description Valeur
secretUrl URL secrète qui contient les paramètres protégés de l’extension corde
sourceVault ID de ressource ARM du coffre de clés SubResource

Sous-ressource

Nom Description Valeur
id ID de ressource corde

CloudServiceNetworkProfile

Nom Description Valeur
loadBalancerConfigurations Liste des configurations de l’équilibreur de charge. Le service cloud peut avoir jusqu’à deux configurations d’équilibreur de charge, correspondant à un équilibreur de charge public et à un équilibreur de charge interne. LoadBalancerConfiguration[]
slotType Type d’emplacement pour le service cloud.
Les valeurs possibles sont

production

intermédiaire


Si elle n’est pas spécifiée, la valeur par défaut est Production.		 'Production'
'Staging'
swappableCloudService Référence d’ID du service cloud contenant l’adresse IP cible avec laquelle le service cloud sujet peut effectuer un échange. Cette propriété ne peut pas être mise à jour une fois qu’elle est définie. Le service cloud échangeable référencé par cet ID doit être présent dans le cas contraire, une erreur sera levée. SubResource

LoadBalancerConfiguration

Nom Description Valeur
id ID de ressource corde
nom Nom de l’équilibreur de charge chaîne (obligatoire)
Propriétés Propriétés de la configuration de l’équilibreur de charge. LoadBalancerConfigurationProperties (obligatoire)

LoadBalancerConfigurationProperties

Nom Description Valeur
frontendIpConfigurations Spécifie l’adresse IP frontale à utiliser pour l’équilibreur de charge. Seule l’adresse IP frontale IPv4 est prise en charge. Chaque configuration de l’équilibreur de charge doit avoir exactement une configuration IP frontale. LoadBalancerFrontendIpConfiguration[] (obligatoire)

LoadBalancerFrontendIpConfiguration

Nom Description Valeur
nom Nom de la ressource unique dans l’ensemble de configurations IP frontales utilisées par l’équilibreur de charge. Ce nom peut être utilisé pour accéder à la ressource. chaîne (obligatoire)
Propriétés Propriétés de la configuration ip frontale de l’équilibreur de charge. LoadBalancerFrontendIpConfigurationProperties (obligatoire)

LoadBalancerFrontendIpConfigurationProperties

Nom Description Valeur
privateIPAddress Adresse IP privée du réseau virtuel de la configuration IP. corde
publicIPAddress Référence à la ressource d’adresse IP publique. SubResource
sous-réseau Référence à la ressource de sous-réseau de réseau virtuel. SubResource

CloudServiceOsProfile

Nom Description Valeur
Secrets Spécifie le jeu de certificats qui doivent être installés sur les instances de rôle. CloudServiceVaultSecretGroup[]

CloudServiceVaultSecretGroup

Nom Description Valeur
sourceVault URL relative du coffre de clés contenant tous les certificats dans VaultCertificates. SubResource
vaultCertificates Liste des références de coffre de clés dans SourceVault qui contiennent des certificats. CloudServiceVaultCertificate[]

CloudServiceVaultCertificate

Nom Description Valeur
certificateUrl Il s’agit de l’URL d’un certificat qui a été chargé dans Key Vault en tant que secret. corde

CloudServiceRoleProfile

Nom Description Valeur
Rôles Liste des rôles pour le service cloud. CloudServiceRoleProfileProperties[]

CloudServiceRoleProfileProperties

Nom Description Valeur
nom Nom de la ressource. corde
Sku Décrit la référence SKU du rôle de service cloud. cloudServiceRoleSku

CloudServiceRoleSku

Nom Description Valeur
capacité Spécifie le nombre d’instances de rôle dans le service cloud. Int
nom Nom de la référence SKU. REMARQUE : Si la nouvelle référence SKU n’est pas prise en charge sur le matériel sur lequel le service cloud est actuellement activé, vous devez supprimer et recréer le service cloud ou revenir à l’ancienne référence SKU. corde
niveau Spécifie le niveau du service cloud. Les valeurs possibles sont

standard

de base		 corde

SystemData

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

Définition de ressource de modèle ARM

Le type de ressource cloudServices peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Compute/cloudServices, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.Compute/cloudServices",
  "apiVersion": "2022-09-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": {},
  "zones": [ "string" or int ]
}

Valeurs de propriété

cloudServices

Nom Description Valeur
type Type de ressource 'Microsoft.Compute/cloudServices'
apiVersion Version de l’API de ressource '2022-09-04'
nom Nom de la ressource chaîne (obligatoire)

Limite de caractères : 1 à 15



Caractères valides :
Impossible d’utiliser des espaces, des caractères de contrôle ou des caractères suivants :
~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?

Impossible de commencer par le trait de soulignement. Impossible de se terminer par un point ou un trait d’union.
emplacement Emplacement des ressources. chaîne (obligatoire)
étiquettes Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
Propriétés Propriétés du service cloud CloudServiceProperties
systemData Métadonnées système relatives à cette ressource. SystemData
zones Liste de la zone de disponibilité logique de la ressource. La liste ne doit contenir que 1 zone où le service cloud doit être approvisionné. Ce champ est facultatif. Tableau de zones de disponibilité sous forme de chaîne ou d’int.

CloudServiceProperties

Nom Description Valeur
allowModelOverride (Facultatif) Indique si les propriétés de la référence sku de rôle (roleProfile.roles.sku) spécifiées dans le modèle/modèle doivent remplacer respectivement le nombre d’instances de rôle et la taille de machine virtuelle spécifiées dans .cscfg et .csdef.
La valeur par défaut est false.		 Bool
configuration Spécifie la configuration du service XML (.cscfg) pour le service cloud. corde
configurationUrl Spécifie une URL qui fait référence à l’emplacement de la configuration du service dans le service Blob. L’URL du package de service peut être un URI de signature d’accès partagé (SAP) à partir de n’importe quel compte de stockage.
Il s’agit d’une propriété en écriture seule et n’est pas retournée dans les appels GET.		 corde
extensionProfile Décrit un profil d’extension de service cloud. CloudServiceExtensionProfile
networkProfile Profil réseau pour le service cloud. CloudServiceNetworkProfile
osProfile Décrit le profil du système d’exploitation pour le service cloud. CloudServiceOsProfile
packageUrl Spécifie une URL qui fait référence à l’emplacement du package de service dans le service Blob. L’URL du package de service peut être un URI de signature d’accès partagé (SAP) à partir de n’importe quel compte de stockage.
Il s’agit d’une propriété en écriture seule et n’est pas retournée dans les appels GET.		 corde
roleProfile Décrit le profil de rôle pour le service cloud. CloudServiceRoleProfile
startCloudService (Facultatif) Indique s’il faut démarrer le service cloud immédiatement après sa création. La valeur par défaut est true.
Si la valeur est false, le modèle de service est toujours déployé, mais le code n’est pas exécuté immédiatement. Au lieu de cela, le service est PoweredOff jusqu’à ce que vous appeliez Démarrer, au moment où le service sera démarré. Un service déployé entraîne toujours des frais, même s’il est alimenté.		 Bool
upgradeMode Mode de mise à jour pour le service cloud. Les instances de rôle sont allouées aux domaines de mise à jour lorsque le service est déployé. Les mises à jour peuvent être lancées manuellement dans chaque domaine de mise à jour ou lancées automatiquement dans tous les domaines de mise à jour.
Les valeurs possibles sont

automatique

manuel

simultanée


S’il n’est pas spécifié, la valeur par défaut est Auto. Si la valeur est Manuelle, PUT UpdateDomain doit être appelée pour appliquer la mise à jour. Si la valeur est Automatique, la mise à jour est automatiquement appliquée à chaque domaine de mise à jour en séquence.
 'Auto'
'Manuel'
'Simultané'

CloudServiceExtensionProfile

Nom Description Valeur
Extensions Liste des extensions pour le service cloud. extension[]

Extension

Nom Description Valeur
nom Nom de l’extension. corde
Propriétés Propriétés de l’extension. CloudServiceExtensionProperties

CloudServiceExtensionProperties

Nom Description Valeur
autoUpgradeMinorVersion Spécifiez explicitement si la plateforme peut mettre à niveau automatiquement typeHandlerVersion vers des versions mineures supérieures lorsqu’elles deviennent disponibles. Bool
forceUpdateTag Balise pour forcer l’application des paramètres publics et protégés fournis.
La modification de la valeur de balise permet de réexécter l’extension sans modifier les paramètres publics ou protégés.
Si forceUpdateTag n’est pas modifié, les mises à jour des paramètres publics ou protégés sont toujours appliquées par le gestionnaire.
Si ni forceUpdateTag ni aucun des paramètres publics ou protégés ne change, l’extension est transmise à l’instance de rôle avec le même numéro de séquence et
il est à l’implémentation du gestionnaire s’il faut le réexécuter ou non		 corde
protectedSettings Paramètres protégés pour l’extension qui sont chiffrés avant d’être envoyés à l’instance de rôle.
protectedSettingsFromKeyVault Paramètres protégés de l’extension, référencés à l’aide de KeyVault qui sont chiffrés avant d’être envoyés à l’instance de rôle. CloudServiceVaultAndSecretReference
éditeur Nom du serveur de publication du gestionnaire d’extensions. corde
rolesAppliedTo Liste facultative des rôles à appliquer à cette extension. Si la propriété n’est pas spécifiée ou « * » est spécifiée, l’extension est appliquée à tous les rôles du service cloud. string[]
Paramètres Paramètres publics de l’extension. Pour les extensions JSON, il s’agit des paramètres JSON de l’extension. Pour l’extension XML (comme RDP), il s’agit du paramètre XML de l’extension.
type Spécifie le type de l’extension. corde
typeHandlerVersion Spécifie la version de l’extension. Spécifie la version de l’extension. Si cet élément n’est pas spécifié ou si un astérisque (*) est utilisé comme valeur, la dernière version de l’extension est utilisée. Si la valeur est spécifiée avec un numéro de version principal et un astérisque comme numéro de version mineure (X.), la dernière version mineure de la version principale spécifiée est sélectionnée. Si un numéro de version principal et un numéro de version secondaire sont spécifiés (X.Y), la version d’extension spécifique est sélectionnée. Si une version est spécifiée, une mise à niveau automatique est effectuée sur l’instance de rôle. corde

CloudServiceVaultAndSecretReference

Nom Description Valeur
secretUrl URL secrète qui contient les paramètres protégés de l’extension corde
sourceVault ID de ressource ARM du coffre de clés SubResource

Sous-ressource

Nom Description Valeur
id ID de ressource corde

CloudServiceNetworkProfile

Nom Description Valeur
loadBalancerConfigurations Liste des configurations de l’équilibreur de charge. Le service cloud peut avoir jusqu’à deux configurations d’équilibreur de charge, correspondant à un équilibreur de charge public et à un équilibreur de charge interne. LoadBalancerConfiguration[]
slotType Type d’emplacement pour le service cloud.
Les valeurs possibles sont

production

intermédiaire


Si elle n’est pas spécifiée, la valeur par défaut est Production.		 'Production'
'Staging'
swappableCloudService Référence d’ID du service cloud contenant l’adresse IP cible avec laquelle le service cloud sujet peut effectuer un échange. Cette propriété ne peut pas être mise à jour une fois qu’elle est définie. Le service cloud échangeable référencé par cet ID doit être présent dans le cas contraire, une erreur sera levée. SubResource

LoadBalancerConfiguration

Nom Description Valeur
id ID de ressource corde
nom Nom de l’équilibreur de charge chaîne (obligatoire)
Propriétés Propriétés de la configuration de l’équilibreur de charge. LoadBalancerConfigurationProperties (obligatoire)

LoadBalancerConfigurationProperties

Nom Description Valeur
frontendIpConfigurations Spécifie l’adresse IP frontale à utiliser pour l’équilibreur de charge. Seule l’adresse IP frontale IPv4 est prise en charge. Chaque configuration de l’équilibreur de charge doit avoir exactement une configuration IP frontale. LoadBalancerFrontendIpConfiguration[] (obligatoire)

LoadBalancerFrontendIpConfiguration

Nom Description Valeur
nom Nom de la ressource unique dans l’ensemble de configurations IP frontales utilisées par l’équilibreur de charge. Ce nom peut être utilisé pour accéder à la ressource. chaîne (obligatoire)
Propriétés Propriétés de la configuration ip frontale de l’équilibreur de charge. LoadBalancerFrontendIpConfigurationProperties (obligatoire)

LoadBalancerFrontendIpConfigurationProperties

Nom Description Valeur
privateIPAddress Adresse IP privée du réseau virtuel de la configuration IP. corde
publicIPAddress Référence à la ressource d’adresse IP publique. SubResource
sous-réseau Référence à la ressource de sous-réseau de réseau virtuel. SubResource

CloudServiceOsProfile

Nom Description Valeur
Secrets Spécifie le jeu de certificats qui doivent être installés sur les instances de rôle. CloudServiceVaultSecretGroup[]

CloudServiceVaultSecretGroup

Nom Description Valeur
sourceVault URL relative du coffre de clés contenant tous les certificats dans VaultCertificates. SubResource
vaultCertificates Liste des références de coffre de clés dans SourceVault qui contiennent des certificats. CloudServiceVaultCertificate[]

CloudServiceVaultCertificate

Nom Description Valeur
certificateUrl Il s’agit de l’URL d’un certificat qui a été chargé dans Key Vault en tant que secret. corde

CloudServiceRoleProfile

Nom Description Valeur
Rôles Liste des rôles pour le service cloud. CloudServiceRoleProfileProperties[]

CloudServiceRoleProfileProperties

Nom Description Valeur
nom Nom de la ressource. corde
Sku Décrit la référence SKU du rôle de service cloud. cloudServiceRoleSku

CloudServiceRoleSku

Nom Description Valeur
capacité Spécifie le nombre d’instances de rôle dans le service cloud. Int
nom Nom de la référence SKU. REMARQUE : Si la nouvelle référence SKU n’est pas prise en charge sur le matériel sur lequel le service cloud est actuellement activé, vous devez supprimer et recréer le service cloud ou revenir à l’ancienne référence SKU. corde
niveau Spécifie le niveau du service cloud. Les valeurs possibles sont

standard

de base		 corde

SystemData

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource cloudServices peut être déployé avec des opérations qui ciblent :

  • groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Compute/cloudServices, ajoutez terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/cloudServices@2022-09-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 = {}
    zones = [
      "string" or int
    ]
  })
}

Valeurs de propriété

cloudServices

Nom Description Valeur
type Type de ressource « Microsoft.Compute/cloudServices@2022-09-04 »
nom Nom de la ressource chaîne (obligatoire)

Limite de caractères : 1 à 15



Caractères valides :
Impossible d’utiliser des espaces, des caractères de contrôle ou des caractères suivants :
~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?

Impossible de commencer par le trait de soulignement. Impossible de se terminer par un point ou un trait d’union.
emplacement Emplacement des ressources. chaîne (obligatoire)
parent_id Pour effectuer un déploiement sur un groupe de ressources, utilisez l’ID de ce groupe de ressources. chaîne (obligatoire)
étiquettes Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes.
Propriétés Propriétés du service cloud CloudServiceProperties
systemData Métadonnées système relatives à cette ressource. SystemData
zones Liste de la zone de disponibilité logique de la ressource. La liste ne doit contenir que 1 zone où le service cloud doit être approvisionné. Ce champ est facultatif. Tableau de zones de disponibilité sous forme de chaîne ou d’int.

CloudServiceProperties

Nom Description Valeur
allowModelOverride (Facultatif) Indique si les propriétés de la référence sku de rôle (roleProfile.roles.sku) spécifiées dans le modèle/modèle doivent remplacer respectivement le nombre d’instances de rôle et la taille de machine virtuelle spécifiées dans .cscfg et .csdef.
La valeur par défaut est false.		 Bool
configuration Spécifie la configuration du service XML (.cscfg) pour le service cloud. corde
configurationUrl Spécifie une URL qui fait référence à l’emplacement de la configuration du service dans le service Blob. L’URL du package de service peut être un URI de signature d’accès partagé (SAP) à partir de n’importe quel compte de stockage.
Il s’agit d’une propriété en écriture seule et n’est pas retournée dans les appels GET.		 corde
extensionProfile Décrit un profil d’extension de service cloud. CloudServiceExtensionProfile
networkProfile Profil réseau pour le service cloud. CloudServiceNetworkProfile
osProfile Décrit le profil du système d’exploitation pour le service cloud. CloudServiceOsProfile
packageUrl Spécifie une URL qui fait référence à l’emplacement du package de service dans le service Blob. L’URL du package de service peut être un URI de signature d’accès partagé (SAP) à partir de n’importe quel compte de stockage.
Il s’agit d’une propriété en écriture seule et n’est pas retournée dans les appels GET.		 corde
roleProfile Décrit le profil de rôle pour le service cloud. CloudServiceRoleProfile
startCloudService (Facultatif) Indique s’il faut démarrer le service cloud immédiatement après sa création. La valeur par défaut est true.
Si la valeur est false, le modèle de service est toujours déployé, mais le code n’est pas exécuté immédiatement. Au lieu de cela, le service est PoweredOff jusqu’à ce que vous appeliez Démarrer, au moment où le service sera démarré. Un service déployé entraîne toujours des frais, même s’il est alimenté.		 Bool
upgradeMode Mode de mise à jour pour le service cloud. Les instances de rôle sont allouées aux domaines de mise à jour lorsque le service est déployé. Les mises à jour peuvent être lancées manuellement dans chaque domaine de mise à jour ou lancées automatiquement dans tous les domaines de mise à jour.
Les valeurs possibles sont

automatique

manuel

simultanée


S’il n’est pas spécifié, la valeur par défaut est Auto. Si la valeur est Manuelle, PUT UpdateDomain doit être appelée pour appliquer la mise à jour. Si la valeur est Automatique, la mise à jour est automatiquement appliquée à chaque domaine de mise à jour en séquence.
 « Auto »
« Manuel »
« Simultané »

CloudServiceExtensionProfile

Nom Description Valeur
Extensions Liste des extensions pour le service cloud. extension[]

Extension

Nom Description Valeur
nom Nom de l’extension. corde
Propriétés Propriétés de l’extension. CloudServiceExtensionProperties

CloudServiceExtensionProperties

Nom Description Valeur
autoUpgradeMinorVersion Spécifiez explicitement si la plateforme peut mettre à niveau automatiquement typeHandlerVersion vers des versions mineures supérieures lorsqu’elles deviennent disponibles. Bool
forceUpdateTag Balise pour forcer l’application des paramètres publics et protégés fournis.
La modification de la valeur de balise permet de réexécter l’extension sans modifier les paramètres publics ou protégés.
Si forceUpdateTag n’est pas modifié, les mises à jour des paramètres publics ou protégés sont toujours appliquées par le gestionnaire.
Si ni forceUpdateTag ni aucun des paramètres publics ou protégés ne change, l’extension est transmise à l’instance de rôle avec le même numéro de séquence et
il est à l’implémentation du gestionnaire s’il faut le réexécuter ou non		 corde
protectedSettings Paramètres protégés pour l’extension qui sont chiffrés avant d’être envoyés à l’instance de rôle.
protectedSettingsFromKeyVault Paramètres protégés de l’extension, référencés à l’aide de KeyVault qui sont chiffrés avant d’être envoyés à l’instance de rôle. CloudServiceVaultAndSecretReference
éditeur Nom du serveur de publication du gestionnaire d’extensions. corde
rolesAppliedTo Liste facultative des rôles à appliquer à cette extension. Si la propriété n’est pas spécifiée ou « * » est spécifiée, l’extension est appliquée à tous les rôles du service cloud. string[]
Paramètres Paramètres publics de l’extension. Pour les extensions JSON, il s’agit des paramètres JSON de l’extension. Pour l’extension XML (comme RDP), il s’agit du paramètre XML de l’extension.
type Spécifie le type de l’extension. corde
typeHandlerVersion Spécifie la version de l’extension. Spécifie la version de l’extension. Si cet élément n’est pas spécifié ou si un astérisque (*) est utilisé comme valeur, la dernière version de l’extension est utilisée. Si la valeur est spécifiée avec un numéro de version principal et un astérisque comme numéro de version mineure (X.), la dernière version mineure de la version principale spécifiée est sélectionnée. Si un numéro de version principal et un numéro de version secondaire sont spécifiés (X.Y), la version d’extension spécifique est sélectionnée. Si une version est spécifiée, une mise à niveau automatique est effectuée sur l’instance de rôle. corde

CloudServiceVaultAndSecretReference

Nom Description Valeur
secretUrl URL secrète qui contient les paramètres protégés de l’extension corde
sourceVault ID de ressource ARM du coffre de clés SubResource

Sous-ressource

Nom Description Valeur
id ID de ressource corde

CloudServiceNetworkProfile

Nom Description Valeur
loadBalancerConfigurations Liste des configurations de l’équilibreur de charge. Le service cloud peut avoir jusqu’à deux configurations d’équilibreur de charge, correspondant à un équilibreur de charge public et à un équilibreur de charge interne. LoadBalancerConfiguration[]
slotType Type d’emplacement pour le service cloud.
Les valeurs possibles sont

production

intermédiaire


Si elle n’est pas spécifiée, la valeur par défaut est Production.		 « Production »
« Préproduction »
swappableCloudService Référence d’ID du service cloud contenant l’adresse IP cible avec laquelle le service cloud sujet peut effectuer un échange. Cette propriété ne peut pas être mise à jour une fois qu’elle est définie. Le service cloud échangeable référencé par cet ID doit être présent dans le cas contraire, une erreur sera levée. SubResource

LoadBalancerConfiguration

Nom Description Valeur
id ID de ressource corde
nom Nom de l’équilibreur de charge chaîne (obligatoire)
Propriétés Propriétés de la configuration de l’équilibreur de charge. LoadBalancerConfigurationProperties (obligatoire)

LoadBalancerConfigurationProperties

Nom Description Valeur
frontendIpConfigurations Spécifie l’adresse IP frontale à utiliser pour l’équilibreur de charge. Seule l’adresse IP frontale IPv4 est prise en charge. Chaque configuration de l’équilibreur de charge doit avoir exactement une configuration IP frontale. LoadBalancerFrontendIpConfiguration[] (obligatoire)

LoadBalancerFrontendIpConfiguration

Nom Description Valeur
nom Nom de la ressource unique dans l’ensemble de configurations IP frontales utilisées par l’équilibreur de charge. Ce nom peut être utilisé pour accéder à la ressource. chaîne (obligatoire)
Propriétés Propriétés de la configuration ip frontale de l’équilibreur de charge. LoadBalancerFrontendIpConfigurationProperties (obligatoire)

LoadBalancerFrontendIpConfigurationProperties

Nom Description Valeur
privateIPAddress Adresse IP privée du réseau virtuel de la configuration IP. corde
publicIPAddress Référence à la ressource d’adresse IP publique. SubResource
sous-réseau Référence à la ressource de sous-réseau de réseau virtuel. SubResource

CloudServiceOsProfile

Nom Description Valeur
Secrets Spécifie le jeu de certificats qui doivent être installés sur les instances de rôle. CloudServiceVaultSecretGroup[]

CloudServiceVaultSecretGroup

Nom Description Valeur
sourceVault URL relative du coffre de clés contenant tous les certificats dans VaultCertificates. SubResource
vaultCertificates Liste des références de coffre de clés dans SourceVault qui contiennent des certificats. CloudServiceVaultCertificate[]

CloudServiceVaultCertificate

Nom Description Valeur
certificateUrl Il s’agit de l’URL d’un certificat qui a été chargé dans Key Vault en tant que secret. corde

CloudServiceRoleProfile

Nom Description Valeur
Rôles Liste des rôles pour le service cloud. CloudServiceRoleProfileProperties[]

CloudServiceRoleProfileProperties

Nom Description Valeur
nom Nom de la ressource. corde
Sku Décrit la référence SKU du rôle de service cloud. cloudServiceRoleSku

CloudServiceRoleSku

Nom Description Valeur
capacité Spécifie le nombre d’instances de rôle dans le service cloud. Int
nom Nom de la référence SKU. REMARQUE : Si la nouvelle référence SKU n’est pas prise en charge sur le matériel sur lequel le service cloud est actuellement activé, vous devez supprimer et recréer le service cloud ou revenir à l’ancienne référence SKU. corde
niveau Spécifie le niveau du service cloud. Les valeurs possibles sont

standard

de base		 corde

SystemData

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.