Microsoft.App travaux 2022-11-01-preview

Article
12/09/2024

Définition de ressource Bicep

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

groupes de ressources - Consultez commandes de déploiement de 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.App/jobs, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.App/jobs@2022-11-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    configuration: {
      manualTriggerConfig: {
        parallelism: int
        replicaCompletionCount: int
      }
      registries: [
        {
          identity: 'string'
          passwordSecretRef: 'string'
          server: 'string'
          username: 'string'
        }
      ]
      replicaRetryLimit: int
      replicaTimeout: int
      scheduleTriggerConfig: {
        cronExpression: 'string'
        parallelism: int
        replicaCompletionCount: int
      }
      secrets: [
        {
          identity: 'string'
          keyVaultUrl: 'string'
          name: 'string'
          value: 'string'
        }
      ]
      triggerType: 'string'
    }
    environmentId: 'string'
    template: {
      containers: [
        {
          args: [
            'string'
          ]
          command: [
            'string'
          ]
          env: [
            {
              name: 'string'
              secretRef: 'string'
              value: 'string'
            }
          ]
          image: 'string'
          name: 'string'
          probes: [
            {
              failureThreshold: int
              httpGet: {
                host: 'string'
                httpHeaders: [
                  {
                    name: 'string'
                    value: 'string'
                  }
                ]
                path: 'string'
                port: int
                scheme: 'string'
              }
              initialDelaySeconds: int
              periodSeconds: int
              successThreshold: int
              tcpSocket: {
                host: 'string'
                port: int
              }
              terminationGracePeriodSeconds: int
              timeoutSeconds: int
              type: 'string'
            }
          ]
          resources: {
            cpu: int
            memory: 'string'
          }
          volumeMounts: [
            {
              mountPath: 'string'
              volumeName: 'string'
            }
          ]
        }
      ]
      initContainers: [
        {
          args: [
            'string'
          ]
          command: [
            'string'
          ]
          env: [
            {
              name: 'string'
              secretRef: 'string'
              value: 'string'
            }
          ]
          image: 'string'
          name: 'string'
          resources: {
            cpu: int
            memory: 'string'
          }
          volumeMounts: [
            {
              mountPath: 'string'
              volumeName: 'string'
            }
          ]
        }
      ]
      volumes: [
        {
          name: 'string'
          secrets: [
            {
              path: 'string'
              secretRef: 'string'
            }
          ]
          storageName: 'string'
          storageType: 'string'
        }
      ]
    }
    workloadProfileName: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valeurs de la propriété

Conteneur

Nom	Description	Valeur
args	Arguments de commande de démarrage du conteneur.	string[]
commander	Commande de démarrage du conteneur.	string[]
Env	Variables d’environnement de conteneur.	EnvironmentVar[]
image	Balise d’image conteneur.	corde
nom	Nom du conteneur personnalisé.	corde
Sondes	Liste des sondes pour le conteneur.	containerAppProbe[]
ressources	Exigences en matière de ressources de conteneur.	ContainerResources
volumeMounts	Montages de volumes de conteneurs.	VolumeMount[]

ContainerAppProbe

Nom	Description	Valeur
failureThreshold	Échecs consécutifs minimum pour que la sonde soit considérée comme ayant échoué après avoir réussi. La valeur par défaut est 3. La valeur minimale est 1. La valeur maximale est 10.	Int
httpGet	HTTPGet spécifie la requête http à effectuer.	ContainerAppProbeHttpGet
initialDelaySeconds	Nombre de secondes après le démarrage du conteneur avant l’initialisation des sondes liveness. La valeur minimale est 1. La valeur maximale est 60.	Int
periodSeconds	Fréquence (en secondes) d’exécution de la sonde. La valeur par défaut est de 10 secondes. La valeur minimale est 1. La valeur maximale est 240.	Int
successThreshold	Nombre minimal de réussites consécutives pour que la sonde soit considérée comme réussie après avoir échoué. La valeur par défaut est 1. Doit être 1 pour la vie et le démarrage. La valeur minimale est 1. La valeur maximale est 10.	Int
tcpSocket	TCPSocket spécifie une action impliquant un port TCP. Les hooks TCP ne sont pas encore pris en charge.	ContainerAppProbeTcpSocket
terminationGracePeriodSeconds	Durée facultative en secondes, le pod doit se terminer correctement lors de l’échec de la sonde. La période de grâce est la durée en secondes après que les processus en cours d’exécution dans le pod soient envoyés un signal d’arrêt et le moment où les processus sont arrêtés de force avec un signal de destruction. Définissez cette valeur plus longtemps que l’heure de nettoyage attendue pour votre processus. Si cette valeur est nulle, l’arrêt du podGracePeriodSeconds est utilisé. Dans le cas contraire, cette valeur remplace la valeur fournie par la spécification de pod. La valeur doit être un entier non négatif. La valeur zéro indique l’arrêt immédiatement via le signal de destruction (aucune occasion d’arrêter). Il s’agit d’un champ alpha et nécessite l’activation de la porte de fonctionnalité ProbeTerminationGracePeriod. La valeur maximale est de 3600 secondes (1 heure)	Int
timeoutSeconds	Nombre de secondes après lesquelles la sonde expire. La valeur par défaut est 1 seconde. La valeur minimale est 1. La valeur maximale est 240.	Int
type	Type de sonde.	'Liveness' 'Readiness' 'Startup'

ContainerAppProbeHttpGet

Nom	Description	Valeur
hôte	Nom d’hôte à connecter, par défaut à l’adresse IP du pod. Vous souhaitez probablement définir « Host » dans httpHeaders à la place.	corde
httpHeaders	En-têtes personnalisés à définir dans la requête. HTTP autorise les en-têtes répétés.	ContainerAppProbeHttpGetHttpHeadersItem[]
chemin	Chemin d’accès au serveur HTTP.	corde
port	Nom ou numéro du port à accéder au conteneur. Le nombre doit être compris entre 1 et 65535. Le nom doit être un IANA_SVC_NAME.	int (obligatoire)
schéma	Schéma à utiliser pour la connexion à l’hôte. La valeur par défaut est HTTP.	'HTTP' 'HTTPS'

ContainerAppProbeHttpGetHttpHeadersItem

Nom	Description	Valeur
nom	Nom du champ d’en-tête	chaîne (obligatoire)
valeur	Valeur du champ d’en-tête	chaîne (obligatoire)

ContainerAppProbeTcpSocket

Nom	Description	Valeur
hôte	Facultatif : nom d’hôte auquel se connecter, par défaut à l’adresse IP du pod.	corde
port	Numéro ou nom du port à accéder au conteneur. Le nombre doit être compris entre 1 et 65535. Le nom doit être un IANA_SVC_NAME.	int (obligatoire)

ContainerResources

Nom	Description	Valeur
CPU	Processeur requis dans les cœurs, par exemple 0,5	Int
mémoire	Mémoire requise, par exemple « 250 Mo »	corde

EnvironmentVar

Nom	Description	Valeur
nom	Nom de la variable d’environnement.	corde
secretRef	Nom du secret de l’application conteneur à partir duquel extraire la valeur de la variable d’environnement.	corde
valeur	Valeur de variable d’environnement non secrète.	corde

InitContainer

Nom	Description	Valeur
args	Arguments de commande de démarrage du conteneur.	string[]
commander	Commande de démarrage du conteneur.	string[]
Env	Variables d’environnement de conteneur.	EnvironmentVar[]
image	Balise d’image conteneur.	corde
nom	Nom du conteneur personnalisé.	corde
ressources	Exigences en matière de ressources de conteneur.	ContainerResources
volumeMounts	Montages de volumes de conteneurs.	VolumeMount[]

JobConfiguration

Nom	Description	Valeur
manualTriggerConfig	Configuration manuelle du déclencheur pour un travail d’exécution unique. Properties replicaCompletionCount et parallélisme sont définis sur 1 par défaut	JobConfigurationManualTriggerConfig
Registres	Collection d’informations d’identification de registre de conteneurs privées utilisées par un travail d’application conteneur	RegistryCredentials[]
replicaRetryLimit	Nombre maximal de nouvelles tentatives avant l’échec du travail.	Int
replicaTimeout	Nombre maximal de secondes qu’un réplica est autorisé à s’exécuter.	int (obligatoire)
scheduleTriggerConfig	Planification de déclencheur répétitif mise en forme Cron (« * * * * * ») pour cronjobs. Les achèvements et le parallélisme des propriétés sont définis sur 1 par défaut	JobConfigurationScheduleTriggerConfig
Secrets	Collection de secrets utilisés par un travail Container Apps	secret[]
triggerType	Type de déclencheur du travail	'Event' 'Manuel' 'Schedule' (obligatoire)

JobConfigurationManualTriggerConfig

Nom	Description	Valeur
parallélisme	Nombre de réplicas parallèles d’un travail pouvant s’exécuter à un moment donné.	Int
replicaCompletionCount	Nombre minimal d’achèvements de réplica réussis avant la fin globale du travail.	Int

JobConfigurationScheduleTriggerConfig

Nom	Description	Valeur
cronExpression	Cron a mis en forme une planification répétée (« * * * * * ») d’un travail Cron.	chaîne (obligatoire)
parallélisme	Nombre de réplicas parallèles d’un travail pouvant s’exécuter à un moment donné.	Int
replicaCompletionCount	Nombre minimal d’achèvements de réplica réussis avant la fin globale du travail.	Int

JobProperties

Nom	Description	Valeur
configuration	Propriétés de configuration du travail Container Apps.	JobConfiguration
environmentId	ID de ressource de l’environnement.	corde
modèle	Définition du travail Container Apps.	JobTemplate
workloadProfileName	Nom du profil de charge de travail à épingler pour l’exécution du travail des applications conteneur.	corde

JobTemplate

Nom	Description	Valeur
Conteneurs	Liste des définitions de conteneur pour l’application conteneur.	conteneur[]
initContainers	Liste des conteneurs spécialisés qui s’exécutent avant les conteneurs d’applications.	InitContainer[]
Volumes	Liste des définitions de volume pour l’application conteneur.	de volume []

ManagedServiceIdentity

Nom	Description	Valeur
type	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obligatoire)
userAssignedIdentities	Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes.	UserAssignedIdentities

Microsoft.App/jobs

Nom	Description	Valeur
identité	Identités managées nécessaires par un travail d’application conteneur pour interagir avec d’autres services Azure pour ne pas conserver de secrets ou d’informations d’identification dans le code.	ManagedServiceIdentity
emplacement	Emplacement géographique où réside la ressource	chaîne (obligatoire)
nom	Nom de la ressource	chaîne (obligatoire)
Propriétés	Propriétés spécifiques de la ressource de travail Container Apps.	JobProperties
étiquettes	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

RegistryCredentials

Nom	Description	Valeur
identité	Identité managée à utiliser pour s’authentifier auprès d’Azure Container Registry. Pour les identités affectées par l’utilisateur, utilisez l’ID complet de ressource d’identité affectée par l’utilisateur. Pour les identités affectées par le système, utilisez « système »	corde
passwordSecretRef	Nom du secret qui contient le mot de passe de connexion au Registre	corde
serveur	Container Registry Server	corde
nom d’utilisateur	Nom d’utilisateur du registre de conteneurs	corde

Secret

Nom	Description	Valeur
identité	ID de ressource d’une identité managée pour s’authentifier auprès d’Azure Key Vault ou système pour utiliser une identité affectée par le système.	corde
keyVaultUrl	URL Azure Key Vault pointant vers le secret référencé par l’application conteneur.	corde
nom	Nom du secret.	corde
valeur	Valeur secrète.	corde Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé.

SecretVolumeItem

Nom	Description	Valeur
chemin	Chemin d’accès au secret de projet vers. Si aucun chemin d’accès n’est fourni, le chemin d’accès est défini par défaut sur le nom du secret répertorié dans secretRef.	corde
secretRef	Nom du secret de l’application conteneur à partir duquel extraire la valeur du secret.	corde

TrackedResourceTags

Nom	Description	Valeur

UserAssignedIdentities

Nom	Description	Valeur

UserAssignedIdentity

Nom	Description	Valeur

Volume

Nom	Description	Valeur
nom	Nom du volume.	corde
Secrets	Liste des secrets à ajouter en volume. Si aucun secret n’est fourni, tous les secrets de la collection sont ajoutés au volume.	SecretVolumeItem[]
storageName	Nom de la ressource de stockage. Il n’est pas nécessaire de fournir EmptyDir et Secret.	corde
storageType	Type de stockage pour le volume. Si ce n’est pas le cas, utilisez EmptyDir.	'AzureFile' 'EmptyDir' 'Secret'

VolumeMount

Nom	Description	Valeur
mountPath	Chemin d’accès au sein du conteneur auquel le volume doit être monté. Ne doit pas contenir ' :'.	corde
volumeName	Cela doit correspondre au nom d’un volume.	corde

Exemples d’utilisation

Modules vérifiés Azure

Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.

Module	Description
du travail d’application	Module de ressources AVM pour le travail d’application

Définition de ressource de modèle ARM

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

groupes de ressources - Consultez commandes de déploiement de 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.App/jobs, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.App/jobs",
  "apiVersion": "2022-11-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "configuration": {
      "manualTriggerConfig": {
        "parallelism": "int",
        "replicaCompletionCount": "int"
      },
      "registries": [
        {
          "identity": "string",
          "passwordSecretRef": "string",
          "server": "string",
          "username": "string"
        }
      ],
      "replicaRetryLimit": "int",
      "replicaTimeout": "int",
      "scheduleTriggerConfig": {
        "cronExpression": "string",
        "parallelism": "int",
        "replicaCompletionCount": "int"
      },
      "secrets": [
        {
          "identity": "string",
          "keyVaultUrl": "string",
          "name": "string",
          "value": "string"
        }
      ],
      "triggerType": "string"
    },
    "environmentId": "string",
    "template": {
      "containers": [
        {
          "args": [ "string" ],
          "command": [ "string" ],
          "env": [
            {
              "name": "string",
              "secretRef": "string",
              "value": "string"
            }
          ],
          "image": "string",
          "name": "string",
          "probes": [
            {
              "failureThreshold": "int",
              "httpGet": {
                "host": "string",
                "httpHeaders": [
                  {
                    "name": "string",
                    "value": "string"
                  }
                ],
                "path": "string",
                "port": "int",
                "scheme": "string"
              },
              "initialDelaySeconds": "int",
              "periodSeconds": "int",
              "successThreshold": "int",
              "tcpSocket": {
                "host": "string",
                "port": "int"
              },
              "terminationGracePeriodSeconds": "int",
              "timeoutSeconds": "int",
              "type": "string"
            }
          ],
          "resources": {
            "cpu": "int",
            "memory": "string"
          },
          "volumeMounts": [
            {
              "mountPath": "string",
              "volumeName": "string"
            }
          ]
        }
      ],
      "initContainers": [
        {
          "args": [ "string" ],
          "command": [ "string" ],
          "env": [
            {
              "name": "string",
              "secretRef": "string",
              "value": "string"
            }
          ],
          "image": "string",
          "name": "string",
          "resources": {
            "cpu": "int",
            "memory": "string"
          },
          "volumeMounts": [
            {
              "mountPath": "string",
              "volumeName": "string"
            }
          ]
        }
      ],
      "volumes": [
        {
          "name": "string",
          "secrets": [
            {
              "path": "string",
              "secretRef": "string"
            }
          ],
          "storageName": "string",
          "storageType": "string"
        }
      ]
    },
    "workloadProfileName": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valeurs de la propriété

Conteneur

Nom	Description	Valeur
args	Arguments de commande de démarrage du conteneur.	string[]
commander	Commande de démarrage du conteneur.	string[]
Env	Variables d’environnement de conteneur.	EnvironmentVar[]
image	Balise d’image conteneur.	corde
nom	Nom du conteneur personnalisé.	corde
Sondes	Liste des sondes pour le conteneur.	containerAppProbe[]
ressources	Exigences en matière de ressources de conteneur.	ContainerResources
volumeMounts	Montages de volumes de conteneurs.	VolumeMount[]

ContainerAppProbe

Nom	Description	Valeur
failureThreshold	Échecs consécutifs minimum pour que la sonde soit considérée comme ayant échoué après avoir réussi. La valeur par défaut est 3. La valeur minimale est 1. La valeur maximale est 10.	Int
httpGet	HTTPGet spécifie la requête http à effectuer.	ContainerAppProbeHttpGet
initialDelaySeconds	Nombre de secondes après le démarrage du conteneur avant l’initialisation des sondes liveness. La valeur minimale est 1. La valeur maximale est 60.	Int
periodSeconds	Fréquence (en secondes) d’exécution de la sonde. La valeur par défaut est de 10 secondes. La valeur minimale est 1. La valeur maximale est 240.	Int
successThreshold	Nombre minimal de réussites consécutives pour que la sonde soit considérée comme réussie après avoir échoué. La valeur par défaut est 1. Doit être 1 pour la vie et le démarrage. La valeur minimale est 1. La valeur maximale est 10.	Int
tcpSocket	TCPSocket spécifie une action impliquant un port TCP. Les hooks TCP ne sont pas encore pris en charge.	ContainerAppProbeTcpSocket
terminationGracePeriodSeconds	Durée facultative en secondes, le pod doit se terminer correctement lors de l’échec de la sonde. La période de grâce est la durée en secondes après que les processus en cours d’exécution dans le pod soient envoyés un signal d’arrêt et le moment où les processus sont arrêtés de force avec un signal de destruction. Définissez cette valeur plus longtemps que l’heure de nettoyage attendue pour votre processus. Si cette valeur est nulle, l’arrêt du podGracePeriodSeconds est utilisé. Dans le cas contraire, cette valeur remplace la valeur fournie par la spécification de pod. La valeur doit être un entier non négatif. La valeur zéro indique l’arrêt immédiatement via le signal de destruction (aucune occasion d’arrêter). Il s’agit d’un champ alpha et nécessite l’activation de la porte de fonctionnalité ProbeTerminationGracePeriod. La valeur maximale est de 3600 secondes (1 heure)	Int
timeoutSeconds	Nombre de secondes après lesquelles la sonde expire. La valeur par défaut est 1 seconde. La valeur minimale est 1. La valeur maximale est 240.	Int
type	Type de sonde.	'Liveness' 'Readiness' 'Startup'

ContainerAppProbeHttpGet

Nom	Description	Valeur
hôte	Nom d’hôte à connecter, par défaut à l’adresse IP du pod. Vous souhaitez probablement définir « Host » dans httpHeaders à la place.	corde
httpHeaders	En-têtes personnalisés à définir dans la requête. HTTP autorise les en-têtes répétés.	ContainerAppProbeHttpGetHttpHeadersItem[]
chemin	Chemin d’accès au serveur HTTP.	corde
port	Nom ou numéro du port à accéder au conteneur. Le nombre doit être compris entre 1 et 65535. Le nom doit être un IANA_SVC_NAME.	int (obligatoire)
schéma	Schéma à utiliser pour la connexion à l’hôte. La valeur par défaut est HTTP.	'HTTP' 'HTTPS'

ContainerAppProbeHttpGetHttpHeadersItem

Nom	Description	Valeur
nom	Nom du champ d’en-tête	chaîne (obligatoire)
valeur	Valeur du champ d’en-tête	chaîne (obligatoire)

ContainerAppProbeTcpSocket

Nom	Description	Valeur
hôte	Facultatif : nom d’hôte auquel se connecter, par défaut à l’adresse IP du pod.	corde
port	Numéro ou nom du port à accéder au conteneur. Le nombre doit être compris entre 1 et 65535. Le nom doit être un IANA_SVC_NAME.	int (obligatoire)

ContainerResources

Nom	Description	Valeur
CPU	Processeur requis dans les cœurs, par exemple 0,5	Int
mémoire	Mémoire requise, par exemple « 250 Mo »	corde

EnvironmentVar

Nom	Description	Valeur
nom	Nom de la variable d’environnement.	corde
secretRef	Nom du secret de l’application conteneur à partir duquel extraire la valeur de la variable d’environnement.	corde
valeur	Valeur de variable d’environnement non secrète.	corde

InitContainer

Nom	Description	Valeur
args	Arguments de commande de démarrage du conteneur.	string[]
commander	Commande de démarrage du conteneur.	string[]
Env	Variables d’environnement de conteneur.	EnvironmentVar[]
image	Balise d’image conteneur.	corde
nom	Nom du conteneur personnalisé.	corde
ressources	Exigences en matière de ressources de conteneur.	ContainerResources
volumeMounts	Montages de volumes de conteneurs.	VolumeMount[]

JobConfiguration

Nom	Description	Valeur
manualTriggerConfig	Configuration manuelle du déclencheur pour un travail d’exécution unique. Properties replicaCompletionCount et parallélisme sont définis sur 1 par défaut	JobConfigurationManualTriggerConfig
Registres	Collection d’informations d’identification de registre de conteneurs privées utilisées par un travail d’application conteneur	RegistryCredentials[]
replicaRetryLimit	Nombre maximal de nouvelles tentatives avant l’échec du travail.	Int
replicaTimeout	Nombre maximal de secondes qu’un réplica est autorisé à s’exécuter.	int (obligatoire)
scheduleTriggerConfig	Planification de déclencheur répétitif mise en forme Cron (« * * * * * ») pour cronjobs. Les achèvements et le parallélisme des propriétés sont définis sur 1 par défaut	JobConfigurationScheduleTriggerConfig
Secrets	Collection de secrets utilisés par un travail Container Apps	secret[]
triggerType	Type de déclencheur du travail	'Event' 'Manuel' 'Schedule' (obligatoire)

JobConfigurationManualTriggerConfig

Nom	Description	Valeur
parallélisme	Nombre de réplicas parallèles d’un travail pouvant s’exécuter à un moment donné.	Int
replicaCompletionCount	Nombre minimal d’achèvements de réplica réussis avant la fin globale du travail.	Int

JobConfigurationScheduleTriggerConfig

Nom	Description	Valeur
cronExpression	Cron a mis en forme une planification répétée (« * * * * * ») d’un travail Cron.	chaîne (obligatoire)
parallélisme	Nombre de réplicas parallèles d’un travail pouvant s’exécuter à un moment donné.	Int
replicaCompletionCount	Nombre minimal d’achèvements de réplica réussis avant la fin globale du travail.	Int

JobProperties

Nom	Description	Valeur
configuration	Propriétés de configuration du travail Container Apps.	JobConfiguration
environmentId	ID de ressource de l’environnement.	corde
modèle	Définition du travail Container Apps.	JobTemplate
workloadProfileName	Nom du profil de charge de travail à épingler pour l’exécution du travail des applications conteneur.	corde

JobTemplate

Nom	Description	Valeur
Conteneurs	Liste des définitions de conteneur pour l’application conteneur.	conteneur[]
initContainers	Liste des conteneurs spécialisés qui s’exécutent avant les conteneurs d’applications.	InitContainer[]
Volumes	Liste des définitions de volume pour l’application conteneur.	de volume []

ManagedServiceIdentity

Nom	Description	Valeur
type	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obligatoire)
userAssignedIdentities	Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes.	UserAssignedIdentities

Microsoft.App/jobs

Nom	Description	Valeur
apiVersion	Version de l’API	'2022-11-01-preview'
identité	Identités managées nécessaires par un travail d’application conteneur pour interagir avec d’autres services Azure pour ne pas conserver de secrets ou d’informations d’identification dans le code.	ManagedServiceIdentity
emplacement	Emplacement géographique où réside la ressource	chaîne (obligatoire)
nom	Nom de la ressource	chaîne (obligatoire)
Propriétés	Propriétés spécifiques de la ressource de travail Container Apps.	JobProperties
étiquettes	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type	Type de ressource	'Microsoft.App/jobs'

RegistryCredentials

Nom	Description	Valeur
identité	Identité managée à utiliser pour s’authentifier auprès d’Azure Container Registry. Pour les identités affectées par l’utilisateur, utilisez l’ID complet de ressource d’identité affectée par l’utilisateur. Pour les identités affectées par le système, utilisez « système »	corde
passwordSecretRef	Nom du secret qui contient le mot de passe de connexion au Registre	corde
serveur	Container Registry Server	corde
nom d’utilisateur	Nom d’utilisateur du registre de conteneurs	corde

Secret

Nom	Description	Valeur
identité	ID de ressource d’une identité managée pour s’authentifier auprès d’Azure Key Vault ou système pour utiliser une identité affectée par le système.	corde
keyVaultUrl	URL Azure Key Vault pointant vers le secret référencé par l’application conteneur.	corde
nom	Nom du secret.	corde
valeur	Valeur secrète.	corde Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé.

SecretVolumeItem

Nom	Description	Valeur
chemin	Chemin d’accès au secret de projet vers. Si aucun chemin d’accès n’est fourni, le chemin d’accès est défini par défaut sur le nom du secret répertorié dans secretRef.	corde
secretRef	Nom du secret de l’application conteneur à partir duquel extraire la valeur du secret.	corde

TrackedResourceTags

Nom	Description	Valeur

UserAssignedIdentities

Nom	Description	Valeur

UserAssignedIdentity

Nom	Description	Valeur

Volume

Nom	Description	Valeur
nom	Nom du volume.	corde
Secrets	Liste des secrets à ajouter en volume. Si aucun secret n’est fourni, tous les secrets de la collection sont ajoutés au volume.	SecretVolumeItem[]
storageName	Nom de la ressource de stockage. Il n’est pas nécessaire de fournir EmptyDir et Secret.	corde
storageType	Type de stockage pour le volume. Si ce n’est pas le cas, utilisez EmptyDir.	'AzureFile' 'EmptyDir' 'Secret'

VolumeMount

Nom	Description	Valeur
mountPath	Chemin d’accès au sein du conteneur auquel le volume doit être monté. Ne doit pas contenir ' :'.	corde
volumeName	Cela doit correspondre au nom d’un volume.	corde

Exemples d’utilisation

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource de travaux 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.App/jobs, ajoutez le terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.App/jobs@2022-11-01-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      configuration = {
        manualTriggerConfig = {
          parallelism = int
          replicaCompletionCount = int
        }
        registries = [
          {
            identity = "string"
            passwordSecretRef = "string"
            server = "string"
            username = "string"
          }
        ]
        replicaRetryLimit = int
        replicaTimeout = int
        scheduleTriggerConfig = {
          cronExpression = "string"
          parallelism = int
          replicaCompletionCount = int
        }
        secrets = [
          {
            identity = "string"
            keyVaultUrl = "string"
            name = "string"
            value = "string"
          }
        ]
        triggerType = "string"
      }
      environmentId = "string"
      template = {
        containers = [
          {
            args = [
              "string"
            ]
            command = [
              "string"
            ]
            env = [
              {
                name = "string"
                secretRef = "string"
                value = "string"
              }
            ]
            image = "string"
            name = "string"
            probes = [
              {
                failureThreshold = int
                httpGet = {
                  host = "string"
                  httpHeaders = [
                    {
                      name = "string"
                      value = "string"
                    }
                  ]
                  path = "string"
                  port = int
                  scheme = "string"
                }
                initialDelaySeconds = int
                periodSeconds = int
                successThreshold = int
                tcpSocket = {
                  host = "string"
                  port = int
                }
                terminationGracePeriodSeconds = int
                timeoutSeconds = int
                type = "string"
              }
            ]
            resources = {
              cpu = int
              memory = "string"
            }
            volumeMounts = [
              {
                mountPath = "string"
                volumeName = "string"
              }
            ]
          }
        ]
        initContainers = [
          {
            args = [
              "string"
            ]
            command = [
              "string"
            ]
            env = [
              {
                name = "string"
                secretRef = "string"
                value = "string"
              }
            ]
            image = "string"
            name = "string"
            resources = {
              cpu = int
              memory = "string"
            }
            volumeMounts = [
              {
                mountPath = "string"
                volumeName = "string"
              }
            ]
          }
        ]
        volumes = [
          {
            name = "string"
            secrets = [
              {
                path = "string"
                secretRef = "string"
              }
            ]
            storageName = "string"
            storageType = "string"
          }
        ]
      }
      workloadProfileName = "string"
    }
  })
}

Valeurs de la propriété

Conteneur

Nom	Description	Valeur
args	Arguments de commande de démarrage du conteneur.	string[]
commander	Commande de démarrage du conteneur.	string[]
Env	Variables d’environnement de conteneur.	EnvironmentVar[]
image	Balise d’image conteneur.	corde
nom	Nom du conteneur personnalisé.	corde
Sondes	Liste des sondes pour le conteneur.	containerAppProbe[]
ressources	Exigences en matière de ressources de conteneur.	ContainerResources
volumeMounts	Montages de volumes de conteneurs.	VolumeMount[]

ContainerAppProbe

Nom	Description	Valeur
failureThreshold	Échecs consécutifs minimum pour que la sonde soit considérée comme ayant échoué après avoir réussi. La valeur par défaut est 3. La valeur minimale est 1. La valeur maximale est 10.	Int
httpGet	HTTPGet spécifie la requête http à effectuer.	ContainerAppProbeHttpGet
initialDelaySeconds	Nombre de secondes après le démarrage du conteneur avant l’initialisation des sondes liveness. La valeur minimale est 1. La valeur maximale est 60.	Int
periodSeconds	Fréquence (en secondes) d’exécution de la sonde. La valeur par défaut est de 10 secondes. La valeur minimale est 1. La valeur maximale est 240.	Int
successThreshold	Nombre minimal de réussites consécutives pour que la sonde soit considérée comme réussie après avoir échoué. La valeur par défaut est 1. Doit être 1 pour la vie et le démarrage. La valeur minimale est 1. La valeur maximale est 10.	Int
tcpSocket	TCPSocket spécifie une action impliquant un port TCP. Les hooks TCP ne sont pas encore pris en charge.	ContainerAppProbeTcpSocket
terminationGracePeriodSeconds	Durée facultative en secondes, le pod doit se terminer correctement lors de l’échec de la sonde. La période de grâce est la durée en secondes après que les processus en cours d’exécution dans le pod soient envoyés un signal d’arrêt et le moment où les processus sont arrêtés de force avec un signal de destruction. Définissez cette valeur plus longtemps que l’heure de nettoyage attendue pour votre processus. Si cette valeur est nulle, l’arrêt du podGracePeriodSeconds est utilisé. Dans le cas contraire, cette valeur remplace la valeur fournie par la spécification de pod. La valeur doit être un entier non négatif. La valeur zéro indique l’arrêt immédiatement via le signal de destruction (aucune occasion d’arrêter). Il s’agit d’un champ alpha et nécessite l’activation de la porte de fonctionnalité ProbeTerminationGracePeriod. La valeur maximale est de 3600 secondes (1 heure)	Int
timeoutSeconds	Nombre de secondes après lesquelles la sonde expire. La valeur par défaut est 1 seconde. La valeur minimale est 1. La valeur maximale est 240.	Int
type	Type de sonde.	'Liveness' 'Readiness' 'Startup'

ContainerAppProbeHttpGet

Nom	Description	Valeur
hôte	Nom d’hôte à connecter, par défaut à l’adresse IP du pod. Vous souhaitez probablement définir « Host » dans httpHeaders à la place.	corde
httpHeaders	En-têtes personnalisés à définir dans la requête. HTTP autorise les en-têtes répétés.	ContainerAppProbeHttpGetHttpHeadersItem[]
chemin	Chemin d’accès au serveur HTTP.	corde
port	Nom ou numéro du port à accéder au conteneur. Le nombre doit être compris entre 1 et 65535. Le nom doit être un IANA_SVC_NAME.	int (obligatoire)
schéma	Schéma à utiliser pour la connexion à l’hôte. La valeur par défaut est HTTP.	'HTTP' 'HTTPS'

ContainerAppProbeHttpGetHttpHeadersItem

Nom	Description	Valeur
nom	Nom du champ d’en-tête	chaîne (obligatoire)
valeur	Valeur du champ d’en-tête	chaîne (obligatoire)

ContainerAppProbeTcpSocket

Nom	Description	Valeur
hôte	Facultatif : nom d’hôte auquel se connecter, par défaut à l’adresse IP du pod.	corde
port	Numéro ou nom du port à accéder au conteneur. Le nombre doit être compris entre 1 et 65535. Le nom doit être un IANA_SVC_NAME.	int (obligatoire)

ContainerResources

Nom	Description	Valeur
CPU	Processeur requis dans les cœurs, par exemple 0,5	Int
mémoire	Mémoire requise, par exemple « 250 Mo »	corde

EnvironmentVar

Nom	Description	Valeur
nom	Nom de la variable d’environnement.	corde
secretRef	Nom du secret de l’application conteneur à partir duquel extraire la valeur de la variable d’environnement.	corde
valeur	Valeur de variable d’environnement non secrète.	corde

InitContainer

Nom	Description	Valeur
args	Arguments de commande de démarrage du conteneur.	string[]
commander	Commande de démarrage du conteneur.	string[]
Env	Variables d’environnement de conteneur.	EnvironmentVar[]
image	Balise d’image conteneur.	corde
nom	Nom du conteneur personnalisé.	corde
ressources	Exigences en matière de ressources de conteneur.	ContainerResources
volumeMounts	Montages de volumes de conteneurs.	VolumeMount[]

JobConfiguration

Nom	Description	Valeur
manualTriggerConfig	Configuration manuelle du déclencheur pour un travail d’exécution unique. Properties replicaCompletionCount et parallélisme sont définis sur 1 par défaut	JobConfigurationManualTriggerConfig
Registres	Collection d’informations d’identification de registre de conteneurs privées utilisées par un travail d’application conteneur	RegistryCredentials[]
replicaRetryLimit	Nombre maximal de nouvelles tentatives avant l’échec du travail.	Int
replicaTimeout	Nombre maximal de secondes qu’un réplica est autorisé à s’exécuter.	int (obligatoire)
scheduleTriggerConfig	Planification de déclencheur répétitif mise en forme Cron (« * * * * * ») pour cronjobs. Les achèvements et le parallélisme des propriétés sont définis sur 1 par défaut	JobConfigurationScheduleTriggerConfig
Secrets	Collection de secrets utilisés par un travail Container Apps	secret[]
triggerType	Type de déclencheur du travail	'Event' 'Manuel' 'Schedule' (obligatoire)

JobConfigurationManualTriggerConfig

Nom	Description	Valeur
parallélisme	Nombre de réplicas parallèles d’un travail pouvant s’exécuter à un moment donné.	Int
replicaCompletionCount	Nombre minimal d’achèvements de réplica réussis avant la fin globale du travail.	Int

JobConfigurationScheduleTriggerConfig

Nom	Description	Valeur
cronExpression	Cron a mis en forme une planification répétée (« * * * * * ») d’un travail Cron.	chaîne (obligatoire)
parallélisme	Nombre de réplicas parallèles d’un travail pouvant s’exécuter à un moment donné.	Int
replicaCompletionCount	Nombre minimal d’achèvements de réplica réussis avant la fin globale du travail.	Int

JobProperties

Nom	Description	Valeur
configuration	Propriétés de configuration du travail Container Apps.	JobConfiguration
environmentId	ID de ressource de l’environnement.	corde
modèle	Définition du travail Container Apps.	JobTemplate
workloadProfileName	Nom du profil de charge de travail à épingler pour l’exécution du travail des applications conteneur.	corde

JobTemplate

Nom	Description	Valeur
Conteneurs	Liste des définitions de conteneur pour l’application conteneur.	conteneur[]
initContainers	Liste des conteneurs spécialisés qui s’exécutent avant les conteneurs d’applications.	InitContainer[]
Volumes	Liste des définitions de volume pour l’application conteneur.	de volume []

ManagedServiceIdentity

Nom	Description	Valeur
type	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obligatoire)
userAssignedIdentities	Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes.	UserAssignedIdentities

Microsoft.App/jobs

Nom	Description	Valeur
identité	Identités managées nécessaires par un travail d’application conteneur pour interagir avec d’autres services Azure pour ne pas conserver de secrets ou d’informations d’identification dans le code.	ManagedServiceIdentity
emplacement	Emplacement géographique où réside la ressource	chaîne (obligatoire)
nom	Nom de la ressource	chaîne (obligatoire)
Propriétés	Propriétés spécifiques de la ressource de travail Container Apps.	JobProperties
étiquettes	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes.
type	Type de ressource	« Microsoft.App/jobs@2022-11-01-preview »

RegistryCredentials

Nom	Description	Valeur
identité	Identité managée à utiliser pour s’authentifier auprès d’Azure Container Registry. Pour les identités affectées par l’utilisateur, utilisez l’ID complet de ressource d’identité affectée par l’utilisateur. Pour les identités affectées par le système, utilisez « système »	corde
passwordSecretRef	Nom du secret qui contient le mot de passe de connexion au Registre	corde
serveur	Container Registry Server	corde
nom d’utilisateur	Nom d’utilisateur du registre de conteneurs	corde

Secret

Nom	Description	Valeur
identité	ID de ressource d’une identité managée pour s’authentifier auprès d’Azure Key Vault ou système pour utiliser une identité affectée par le système.	corde
keyVaultUrl	URL Azure Key Vault pointant vers le secret référencé par l’application conteneur.	corde
nom	Nom du secret.	corde
valeur	Valeur secrète.	corde Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé.

SecretVolumeItem

Nom	Description	Valeur
chemin	Chemin d’accès au secret de projet vers. Si aucun chemin d’accès n’est fourni, le chemin d’accès est défini par défaut sur le nom du secret répertorié dans secretRef.	corde
secretRef	Nom du secret de l’application conteneur à partir duquel extraire la valeur du secret.	corde

TrackedResourceTags

Nom	Description	Valeur

UserAssignedIdentities

Nom	Description	Valeur

UserAssignedIdentity

Nom	Description	Valeur

Volume

Nom	Description	Valeur
nom	Nom du volume.	corde
Secrets	Liste des secrets à ajouter en volume. Si aucun secret n’est fourni, tous les secrets de la collection sont ajoutés au volume.	SecretVolumeItem[]
storageName	Nom de la ressource de stockage. Il n’est pas nécessaire de fournir EmptyDir et Secret.	corde
storageType	Type de stockage pour le volume. Si ce n’est pas le cas, utilisez EmptyDir.	'AzureFile' 'EmptyDir' 'Secret'

VolumeMount

Nom	Description	Valeur
mountPath	Chemin d’accès au sein du conteneur auquel le volume doit être monté. Ne doit pas contenir ' :'.	corde
volumeName	Cela doit correspondre au nom d’un volume.	corde

Exemples d’utilisation

Modules vérifiés Azure

Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.

Module	Description
du travail d’application	Module de ressources AVM pour le travail d’application

Partager via

Microsoft.App travaux 2022-11-01-preview

Définition de ressource Bicep

Format de ressource

Valeurs de la propriété

Conteneur

ContainerAppProbe

ContainerAppProbeHttpGet

ContainerAppProbeHttpGetHttpHeadersItem

ContainerAppProbeTcpSocket

ContainerResources

EnvironmentVar

InitContainer

JobConfiguration

JobConfigurationManualTriggerConfig

JobConfigurationScheduleTriggerConfig

JobProperties

JobTemplate

ManagedServiceIdentity

Microsoft.App/jobs

RegistryCredentials

Secret

SecretVolumeItem

TrackedResourceTags

UserAssignedIdentities

UserAssignedIdentity

Volume

VolumeMount

Exemples d’utilisation

Modules vérifiés Azure

Définition de ressource de modèle ARM

Format de ressource

Valeurs de la propriété

Conteneur

ContainerAppProbe

ContainerAppProbeHttpGet

ContainerAppProbeHttpGetHttpHeadersItem

ContainerAppProbeTcpSocket

ContainerResources

EnvironmentVar

InitContainer

JobConfiguration

JobConfigurationManualTriggerConfig

JobConfigurationScheduleTriggerConfig

JobProperties

JobTemplate

ManagedServiceIdentity

Microsoft.App/jobs

RegistryCredentials

Secret

SecretVolumeItem

TrackedResourceTags

UserAssignedIdentities

UserAssignedIdentity

Volume

VolumeMount

Exemples d’utilisation

Définition de ressource Terraform (fournisseur AzAPI)

Format de ressource

Valeurs de la propriété

Conteneur

ContainerAppProbe

ContainerAppProbeHttpGet

ContainerAppProbeHttpGetHttpHeadersItem

ContainerAppProbeTcpSocket

ContainerResources

EnvironmentVar

InitContainer

JobConfiguration

JobConfigurationManualTriggerConfig

JobConfigurationScheduleTriggerConfig

JobProperties

JobTemplate

ManagedServiceIdentity

Microsoft.App/jobs

RegistryCredentials

Secret

SecretVolumeItem

TrackedResourceTags

UserAssignedIdentities