Partager via

Microsoft.Compute cloudServices

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@2024-11-04' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  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'
              isBootstrapCertificate: bool
            }
          ]
        }
      ]
    }
    packageUrl: 'string'
    roleProfile: {
      roles: [
        {
          name: 'string'
          sku: {
            capacity: int
            name: 'string'
            tier: 'string'
          }
        }
      ]
    }
    startCloudService: bool
    upgradeMode: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
  zones: [
    'string'
  ]
}

Valeurs de propriété

Microsoft.Compute/cloudServices

Nom Descriptif Valeur
emplacement Emplacement des ressources. chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés du service cloud CloudServiceProperties
portée Utilisez-la lors de la création d’une ressource dans une étendue différente de l’étendue de déploiement. Définissez cette propriété sur le nom symbolique d’une ressource pour appliquer la ressource d’extension .
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
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. chaîne de caractères[]

CloudServiceExtensionProfile

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

CloudServiceExtensionProperties

Nom Descriptif 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. quelconque
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
rôlesAppliedTo 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. chaîne de caractères[]
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. quelconque
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

CloudServiceNetworkProfile

Nom Descriptif 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

Préproduction


Si elle n’est pas spécifiée, la valeur par défaut est Production.		 « Production »
'Mise en scène'
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. Sous-ressource

CloudServiceOsProfile

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

CloudServiceProperties

Nom Descriptif 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
paramétrage 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
URL du paquet 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é'

CloudServiceRoleProfile

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

CloudServiceRoleProfileProperties

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

CloudServiceRoleSku

Nom Descriptif 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

CloudServiceTags

Nom Descriptif Valeur

CloudServiceVaultAndSecretReference

Nom Descriptif 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 Sous-ressource

CloudServiceVaultCertificate

Nom Descriptif Valeur
certificateUrl Il s’agit de l’URL d’un certificat qui a été chargé dans Key Vault en tant que secret. corde
isBootstrapCertificate Indicateur indiquant si le certificat fourni est un certificat de démarrage à utiliser par l’extension Key Vault pour extraire les certificats restants. Bool

CloudServiceVaultSecretGroup

Nom Descriptif Valeur
sourceVault URL relative du coffre de clés contenant tous les certificats dans VaultCertificates. Sous-ressource
vaultCertificats Liste des références de coffre de clés dans SourceVault qui contiennent des certificats. CloudServiceVaultCertificate[]

Extension

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

LoadBalancerConfiguration

Nom Descriptif Valeur
pièce d'identité 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 Descriptif 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 Descriptif 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 Descriptif 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. Sous-ressource
sous-réseau Référence à la ressource de sous-réseau de réseau virtuel. Sous-ressource

Sous-ressource

Nom Descriptif Valeur
pièce d'identité ID de ressource corde

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": "2024-11-04",
  "name": "string",
  "location": "string",
  "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",
              "isBootstrapCertificate": "bool"
            }
          ]
        }
      ]
    },
    "packageUrl": "string",
    "roleProfile": {
      "roles": [
        {
          "name": "string",
          "sku": {
            "capacity": "int",
            "name": "string",
            "tier": "string"
          }
        }
      ]
    },
    "startCloudService": "bool",
    "upgradeMode": "string"
  },
  "tags": {
    "{customized property}": "string"
  },
  "zones": [ "string" ]
}

Valeurs de propriété

Microsoft.Compute/cloudServices

Nom Descriptif Valeur
apiVersion Version de l’API '2024-11-04'
emplacement Emplacement des ressources. chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés du service cloud CloudServiceProperties
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource « Microsoft.Compute/cloudServices »
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. chaîne de caractères[]

CloudServiceExtensionProfile

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

CloudServiceExtensionProperties

Nom Descriptif 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. quelconque
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
rôlesAppliedTo 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. chaîne de caractères[]
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. quelconque
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

CloudServiceNetworkProfile

Nom Descriptif 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

Préproduction


Si elle n’est pas spécifiée, la valeur par défaut est Production.		 « Production »
'Mise en scène'
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. Sous-ressource

CloudServiceOsProfile

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

CloudServiceProperties

Nom Descriptif 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
paramétrage 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
URL du paquet 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é'

CloudServiceRoleProfile

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

CloudServiceRoleProfileProperties

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

CloudServiceRoleSku

Nom Descriptif 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

CloudServiceTags

Nom Descriptif Valeur

CloudServiceVaultAndSecretReference

Nom Descriptif 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 Sous-ressource

CloudServiceVaultCertificate

Nom Descriptif Valeur
certificateUrl Il s’agit de l’URL d’un certificat qui a été chargé dans Key Vault en tant que secret. corde
isBootstrapCertificate Indicateur indiquant si le certificat fourni est un certificat de démarrage à utiliser par l’extension Key Vault pour extraire les certificats restants. Bool

CloudServiceVaultSecretGroup

Nom Descriptif Valeur
sourceVault URL relative du coffre de clés contenant tous les certificats dans VaultCertificates. Sous-ressource
vaultCertificats Liste des références de coffre de clés dans SourceVault qui contiennent des certificats. CloudServiceVaultCertificate[]

Extension

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

LoadBalancerConfiguration

Nom Descriptif Valeur
pièce d'identité 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 Descriptif 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 Descriptif 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 Descriptif 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. Sous-ressource
sous-réseau Référence à la ressource de sous-réseau de réseau virtuel. Sous-ressource

Sous-ressource

Nom Descriptif Valeur
pièce d'identité ID de ressource corde

Exemples d’utilisation

Définition de ressource Terraform (fournisseur AzAPI)

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 terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/cloudServices@2024-11-04"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    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"
                isBootstrapCertificate = bool
              }
            ]
          }
        ]
      }
      packageUrl = "string"
      roleProfile = {
        roles = [
          {
            name = "string"
            sku = {
              capacity = int
              name = "string"
              tier = "string"
            }
          }
        ]
      }
      startCloudService = bool
      upgradeMode = "string"
    }
    zones = [
      "string"
    ]
  }
}

Valeurs de propriété

Microsoft.Compute/cloudServices

Nom Descriptif Valeur
emplacement Emplacement des ressources. chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
parent_id ID de la ressource à laquelle appliquer cette ressource d’extension. chaîne (obligatoire)
Propriétés Propriétés du service cloud CloudServiceProperties
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.Compute/cloudServices@2024-11-04 »
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. chaîne de caractères[]

CloudServiceExtensionProfile

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

CloudServiceExtensionProperties

Nom Descriptif 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. quelconque
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
rôlesAppliedTo 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. chaîne de caractères[]
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. quelconque
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

CloudServiceNetworkProfile

Nom Descriptif 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

Préproduction


Si elle n’est pas spécifiée, la valeur par défaut est Production.		 « Production »
'Mise en scène'
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. Sous-ressource

CloudServiceOsProfile

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

CloudServiceProperties

Nom Descriptif 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
paramétrage 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
URL du paquet 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é'

CloudServiceRoleProfile

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

CloudServiceRoleProfileProperties

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

CloudServiceRoleSku

Nom Descriptif 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

CloudServiceTags

Nom Descriptif Valeur

CloudServiceVaultAndSecretReference

Nom Descriptif 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 Sous-ressource

CloudServiceVaultCertificate

Nom Descriptif Valeur
certificateUrl Il s’agit de l’URL d’un certificat qui a été chargé dans Key Vault en tant que secret. corde
isBootstrapCertificate Indicateur indiquant si le certificat fourni est un certificat de démarrage à utiliser par l’extension Key Vault pour extraire les certificats restants. Bool

CloudServiceVaultSecretGroup

Nom Descriptif Valeur
sourceVault URL relative du coffre de clés contenant tous les certificats dans VaultCertificates. Sous-ressource
vaultCertificats Liste des références de coffre de clés dans SourceVault qui contiennent des certificats. CloudServiceVaultCertificate[]

Extension

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

LoadBalancerConfiguration

Nom Descriptif Valeur
pièce d'identité 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 Descriptif 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 Descriptif 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 Descriptif 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. Sous-ressource
sous-réseau Référence à la ressource de sous-réseau de réseau virtuel. Sous-ressource

Sous-ressource

Nom Descriptif Valeur
pièce d'identité ID de ressource corde
  • Last updated on