Paramètres de l'environnement de calcul

Les environnements informatiques sont divisés en plusieurs composants de base : le nom, le type et l'état de l'environnement informatique, la définition des ressources de calcul (s'il s'agit d'un environnement informatique géré), la configuration Amazon EKS (s'il utilise les ressources Amazon EKS), le rôle de service à utiliser pour fournir des autorisations IAM et les balises de l'environnement de calcul. AWS Batch

Nom de l'environnement de calcul

computeEnvironmentName

Nom de votre environnement de calcul. Le nom peut comporter jusqu'à 128 caractères. Il peut contenir des lettres majuscules et minuscules, des chiffres, des traits d'union (-) et des traits de soulignement (_).

Type : chaîne

Obligatoire : oui

Type

type

Type d'environnement de calcul. Choisissez MANAGED de AWS Batch gérer les ressources de calcul EC2 ou Fargate que vous définissez. Pour plus d’informations, consultez Ressources informatiques. Choisissez UNMANAGED de gérer vos propres ressources de calcul EC2.

Type : chaîne

Valeurs valides : MANAGED | UNMANAGED

Obligatoire : oui

État

state

État de l'environnement de calcul.

Si c'est le casENABLED, le AWS Batch planificateur tente de placer les tâches dans l'environnement. Ces tâches proviennent d'une file d'attente de tâches associée sur les ressources informatiques. Si l'environnement informatique est géré, les instances augmentent ou augmentent automatiquement en fonction de la demande de la file d'attente des tâches.

Si c'est le casDISABLED, le AWS Batch planificateur ne tente pas de placer les tâches dans l'environnement. Les emplois en cours STARTING d'RUNNINGexécution continuent de progresser normalement. Les environnements informatiques gérés qui sont dans DISABLED cet état ne sont pas évolutifs.

Note

Les environnements informatiques d'un DISABLED État peuvent continuer à entraîner des frais de facturation. Pour éviter des frais supplémentaires, désactivez puis supprimez l'environnement informatique. Pour plus d'informations, consultez le Guide DeleteComputeEnvironmentde référence des AWS Batch API et Éviter les frais imprévus dans le Guide de AWS Billing l'utilisateur.

Lorsqu'une instance est inactive, elle est réduite à sa minvCpus valeur. Cependant, la taille de l'instance ne change pas. Par exemple, considérez une c5.8xlarge instance avec une minvCpus valeur de 4 et une desiredvCpus valeur de36. Cette instance ne se réduit pas à une c5.large instance.

Type : chaîne

Valeurs valides : ENABLED | DISABLED

Obligatoire : non

Ressources informatiques

computeResources

Détails des ressources de calcul gérées par l'environnement de calcul. Pour plus d’informations, consultez Environnement de calcul.

Type : objet ComputeResource

Obligatoire : ce paramètre est obligatoire pour les environnements informatiques gérés

type

Type d'environnement de calcul. Vous pouvez choisir d'utiliser des instances EC2 On-Demand (EC2) et des instances Spot EC2 (SPOT), ou d'utiliser la capacité Fargate () FARGATE et la capacité Fargate Spot () dans votre environnement informatique géré. FARGATE_SPOT Si vous choisissez SPOT, vous devez également spécifier un rôle pour le parc Spot Amazon EC2 avec le paramètre spotIamFleetRole. Pour plus d’informations, consultez Rôle de la flotte Amazon EC2 Spot.

Valeurs valides : EC2 | SPOT | FARGATE | FARGATE_SPOT

Obligatoire : oui

allocationStrategy

La stratégie d'allocation à utiliser pour la ressource de calcul si un nombre insuffisant d'instances du type d'instance EC2 le mieux adapté ne peut être allouée. Cela peut être dû à la disponibilité du type d'instance dans les limites du service Amazon EC2 Région AWS ou à celles du service Amazon EC2. Pour plus d’informations, consultez Stratégies d’allocation.

Note

Ce paramètre ne s'applique pas aux tâches exécutées sur les ressources Fargate.

BEST_FIT (default)

AWS Batch sélectionne le type d'instance qui répond le mieux aux besoins des tâches, en privilégiant le type d'instance le moins coûteux. Si des instances supplémentaires du type d'instance sélectionné ne sont pas disponibles, AWS Batch attend qu'elles soient disponibles. Si le nombre d'instances disponibles est insuffisant ou si vous atteignez les limites du service Amazon EC2, les tâches supplémentaires ne sont exécutées qu'une fois les tâches en cours d'exécution terminées. Cette stratégie d'allocation permet de réduire les coûts mais peut limiter la mise à l'échelle. Si vous utilisez Spot Fleets avecBEST_FIT, le rôle Spot Fleet IAM doit être spécifié. Les ressources de calcul qui utilisent une stratégie d'BEST_FITallocation ne prennent pas en charge les mises à jour de l'infrastructure et ne peuvent pas mettre à jour certains paramètres. Pour plus d’informations, consultez Mise à jour des environnements informatiques.

Note

BEST_FITn'est pas pris en charge pour les environnements informatiques utilisant les ressources Amazon EKS.

BEST_FIT_PROGRESSIVE

Utilisez des types d'instances supplémentaires suffisamment grands pour répondre aux exigences des tâches de la file d'attente. Préférez les types d'instance dont le coût par unité de vCPU est inférieur. Si des instances supplémentaires des types d'instance précédemment sélectionnés ne sont pas disponibles, AWS Batch sélectionne de nouveaux types d'instance.

SPOT_CAPACITY_OPTIMIZED

(Disponible uniquement pour les ressources de calcul des instances Spot) Utilisez des types d'instances supplémentaires suffisamment grands pour répondre aux exigences des tâches de la file d'attente. Préférez les types d'instance moins susceptibles d'être interrompus.

SPOT_PRICE_CAPACITY_OPTIMIZED

(Disponible uniquement pour les ressources de calcul des instances ponctuelles) La stratégie d'allocation optimisée en termes de prix et de capacité tient compte à la fois du prix et de la capacité afin de sélectionner les pools d'instances ponctuels les moins susceptibles d'être interrompus et dont le prix est le plus bas possible.

Note

Nous vous recommandons d'utiliser SPOT_PRICE_CAPACITY_OPTIMIZED plutôt que SPOT_CAPACITY_OPTIMIZED dans la plupart des cas.

Avec BEST_FIT_PROGRESSIVESPOT_CAPACITY_OPTIMIZED, et les SPOT_PRICE_CAPACITY_OPTIMIZED stratégies utilisant des instances à la demande ou ponctuelles et la BEST_FIT stratégie utilisant des instances ponctuelles, il AWS Batch peut être nécessaire maxvCpus de dépasser vos exigences en matière de capacité. Dans ce cas, AWS Batch ne maxvCpus dépassez jamais plus d'une instance.

Valeurs valides : BEST_FIT | BEST_FIT_PROGRESSIVE | SPOT_CAPACITY_OPTIMIZED | SPOT_PRICE_CAPACITY_OPTIMIZED

Obligatoire : non

minvCpus

Le nombre minimal de vCPU qu'un environnement gère, même si c'est le cas d'un environnement informatique. DISABLED

Note

Ce paramètre ne s'applique pas aux tâches exécutées sur les ressources Fargate.

Type : entier

Obligatoire : non

maxvCpus

Nombre maximal de vCPU que l'environnement de AWS Batch calcul peut prendre en charge.

Note

Les stratégies d'BEST_FIT_PROGRESSIVESPOT_PRICE_CAPACITY_OPTIMIZEDallocation utilisant des instances à la demande ou ponctuelles et la BEST_FIT stratégie utilisant des instances ponctuelles AWS Batch peuvent devoir être dépassées maxvCpus pour répondre à vos besoins de capacité. SPOT_CAPACITY_OPTIMIZED Dans ce cas, AWS Batch ne maxvCpus dépassez jamais plus d'une instance. Par exemple, n' AWS Batch utilise qu'une seule instance parmi celles spécifiées dans votre environnement informatique.

Type : entier

Obligatoire : non

desiredvCpus

Nombre de vCPU souhaités dans l'environnement informatique. AWS Batch modifie cette valeur entre les valeurs minimale et maximale en fonction de la demande de la file d'attente des tâches.

Note

Ce paramètre ne s'applique pas aux tâches exécutées sur les ressources Fargate.

Type : entier

Obligatoire : non

instanceTypes

Les types d'instances qui peuvent être lancés. Ce paramètre ne s'applique pas aux tâches exécutées sur les ressources Fargate. Ne le spécifiez pas. Vous pouvez spécifier des familles d'instances pour lancer n'importe quel type d'instance au sein de ces familles (par exemple c5c5n,, oup3). Vous pouvez également spécifier des tailles spécifiques au sein d'une famille (par exemplec5.8xlarge). Notez que les types d'instances de métal ne figurent pas dans les familles d'instances (par exemple, c5 ils ne sont pas inclus)c5.metal. Vous pouvez également choisir optimal afin de sélectionner des types d'instances (parmi les familles d'instances C4, M4 et R4) qui correspondent à la demande de vos files d'attente de tâches.

Note

Quand vous créez un environnement de calcul, les types d'instances que vous sélectionnez pour cet environnement doivent partager la même architecture. Par exemple, vous ne pouvez pas mélanger des instances x86 et ARM dans le même environnement de calcul.

Note

Actuellement, optimal utilise les types d'instances des familles d'instances C4, M4 et R4. Si Régions AWS aucun type d'instance ne provient de ces familles d'instances, les types d'instance des familles d'instances C5, M5 et R5 sont utilisés.

Type : tableau de chaînes

Obligatoire : oui

imageId

Ce paramètre est obsolète.

ID d'Amazon Machine Image (AMI) utilisé pour les instances lancées dans l'environnement de calcul. Ce paramètre est remplacé par le membre imageIdOverride de la structure Ec2Configuration.

Note

Ce paramètre ne s'applique pas aux tâches exécutées sur les ressources Fargate.

Note

L'AMI que vous choisissez pour un environnement de calcul doit correspondre à l'architecture des types d'instances que vous souhaitez utiliser pour cet environnement de calcul. Par exemple, si votre environnement informatique utilise des types d'A1instances, l'AMI de ressources de calcul que vous choisissez doit prendre en charge Arm les instances. Amazon ECS vend à la fois des Arm versions x86 et des versions de l'AMI Amazon Linux 2 optimisée pour Amazon ECS. Pour plus d'informations, consultez l'AMI Amazon Linux 2 optimisée pour Amazon ECS dans le manuel Amazon Elastic Container Service Developer Guide.

Type : chaîne

Obligatoire : non

subnets

Sous-réseaux VPC dans lesquels les ressources de calcul sont lancées. Ces sous-réseaux doivent se trouver dans le même VPC. Les ressources de calcul de Fargate peuvent contenir un maximum de 16 sous-réseaux. Pour plus d'informations, consultez VPC et sous-réseaux dans le Guide de l'utilisateur Amazon VPC.

Note

AWS Batch sur Amazon EC2 et sur AWS Batch Amazon EKS supportent les Zones Locales. Pour plus d'informations, consultez les sections Zones locales dans le guide de l'utilisateur Amazon EC2, Amazon EKS et zones AWS locales dans le guide de l'utilisateur Amazon EKS et les clusters Amazon ECS dans les zones locales, les zones de longueur d'onde et AWS Outposts dans le guide du développeur Amazon Elastic Container Service.

AWS Batch sur Fargate ne prend actuellement pas en charge les Zones Locales.

Lors de la mise à jour des environnements de calcul, si vous fournissez une liste vide de sous-réseaux VPC, le comportement qui en résulte est différent entre les ressources de calcul Fargate et EC2. Pour les ressources de calcul Fargate, le fait de fournir une liste vide est traité comme si ce paramètre n'était pas spécifié et qu'aucune modification n'était apportée. Pour les ressources de calcul EC2, le fait de fournir une liste vide supprime les sous-réseaux VPC de la ressource de calcul. Si vous modifiez les sous-réseaux VPC, une mise à jour de l'infrastructure de l'environnement de calcul est requise. C'est le cas pour les ressources de calcul Fargate et EC2. Pour plus d’informations, consultez Mise à jour des environnements informatiques.

Type : tableau de chaînes

Obligatoire : oui

securityGroupIds

Groupe de sécurité Amazon EC2 associé avec les instances lancées dans l'environnement de calcul. Un ou plusieurs groupes de sécurité doivent être spécifiés, dans securityGroupIds ou à l'aide d'un modèle de lancement référencé dans launchTemplate. Ce paramètre est obligatoire pour les tâches exécutées sur les ressources Fargate et doit contenir au moins un groupe de sécurité. (Fargate ne prend pas en charge les modèles de lancement.) Si les groupes de sécurité sont spécifiés à l'aide de securityGroupIds et launchTemplate, les valeurs de securityGroupIds seront utilisées.

Lors de la mise à jour des environnements informatiques, si vous fournissez une liste vide de groupes de sécurité, le comportement qui en résulte diffère entre les ressources de calcul Fargate et EC2. Pour les ressources de calcul Fargate, le fait de fournir une liste vide est traité comme si ce paramètre n'était pas spécifié et qu'aucune modification n'était apportée. Pour les ressources de calcul EC2, le fait de fournir une liste vide supprime les groupes de sécurité de la ressource de calcul. Si vous modifiez les groupes de sécurité, une mise à jour de l'infrastructure de l'environnement informatique est requise. C'est le cas pour les ressources de calcul Fargate et EC2. Pour plus d’informations, consultez Mise à jour des environnements informatiques.

Type : tableau de chaînes

Obligatoire : oui

ec2KeyPair

La paire de clés EC2 utilisée pour les instances lancées dans l'environnement informatique. Vous pouvez utiliser cette paire de clés afin de vous connecter à vos instances avec SSH. Lors de la mise à jour d'un environnement informatique, si vous modifiez la paire de clés EC2, une mise à jour de l'infrastructure de l'environnement informatique est requise. Pour plus d’informations, consultez Mise à jour des environnements informatiques.

Note

Ce paramètre ne s'applique pas aux tâches exécutées sur les ressources Fargate.

Type : chaîne

Obligatoire : non

instanceRole

Le profil d'instance Amazon ECS à associer aux instances Amazon EC2 dans un environnement informatique. Ce paramètre ne s'applique pas aux tâches exécutées sur les ressources Fargate. Ne le spécifiez pas. Vous pouvez spécifier le nom court ou l'Amazon Resource Name (ARN) complet d'un profil d'instance. Par exemple, ecsInstanceRole ou arn:aws:iam::aws_account_id:instance-profile/ecsInstanceRole. Pour plus d’informations, consultez Rôle d'instance Amazon ECS.

Lors de la mise à jour d'un environnement informatique, si vous modifiez ce paramètre, une mise à jour de l'infrastructure de l'environnement informatique est requise. Pour plus d’informations, consultez Mise à jour des environnements informatiques.

Type : chaîne

Obligatoire : non

tags

Balises de paire clé-valeur à appliquer aux instances EC2 lancées dans l'environnement informatique. Par exemple, vous pouvez spécifier "Name": "AWS Batch Instance - C4OnDemand" comme balise de manière à ce que chaque instance dans votre environnement de calcul prenne ce nom. Cela est utile pour reconnaître vos AWS Batch instances dans la console Amazon EC2. Ces balises ne sont pas visibles lors de l'utilisation de l'opération AWS BatchListTagsForResourceAPI.

Lors de la mise à jour d'un environnement informatique, si vous modifiez les balises EC2, une mise à jour de l'infrastructure de l'environnement de calcul est requise. Pour plus d’informations, consultez Mise à jour des environnements informatiques.

Note

Ce paramètre ne s'applique pas aux tâches exécutées sur les ressources Fargate.

Type : mappage chaîne/chaîne

Obligatoire : non

placementGroup

Groupe de placement Amazon EC2 à associer à vos ressources de calcul. Ce paramètre ne s'applique pas aux tâches exécutées sur les ressources Fargate. Ne le spécifiez pas. Si vous avez l'intention de soumettre des tâches parallèles à nœuds multiples à votre environnement informatique, pensez à créer un groupe de placement de clusters et à l'associer à vos ressources de calcul. Ainsi, votre tâche parallèle à plusieurs nœuds reste sur un groupement logique d'instances au sein d'une zone de disponibilité unique à flux potentiel de réseau élevé. Pour plus d'informations, consultez Groupes de placement dans le Guide de l'utilisateur Amazon EC2 pour les instances Linux.

Note

Ce paramètre ne s'applique pas aux tâches exécutées sur les ressources Fargate.

Type : chaîne

Obligatoire : non

bidPercentage

Pourcentage maximum que le prix d'une instance Spot EC2 peut être comparé au prix à la demande pour ce type d'instance avant le lancement des instances. Par exemple, si votre pourcentage maximum est de 20 %, le prix spot doit être inférieur à 20 % du prix à la demande actuel pour cette instance EC2. Vous payez toujours le prix le plus bas (marché) et jamais plus que votre pourcentage maximal. Si vous laissez ce champ vide, la valeur par défaut est 100 % du prix à la demande. Dans la plupart des cas, nous recommandons de laisser ce champ vide.

Lors de la mise à jour d'un environnement informatique, si vous modifiez le pourcentage d'enchère, une mise à jour de l'infrastructure de l'environnement informatique est requise. Pour plus d’informations, consultez Mise à jour des environnements informatiques.

Note

Ce paramètre ne s'applique pas aux tâches exécutées sur les ressources Fargate.

Obligatoire : non

spotIamFleetRole

L'Amazon Resource Name (ARN) du rôle IAM de parc d'instances Spot Amazon EC2 appliqué à un environnement de calcul SPOT. Ce rôle est requis si la stratégie d'allocation est définie sur BEST_FIT, ou si elle n'est pas spécifiée. Pour plus d’informations, consultez Rôle de la flotte Amazon EC2 Spot.

Note

Ce paramètre ne s'applique pas aux tâches exécutées sur les ressources Fargate.

Important

Pour étiqueter vos instances Spot lors de leur création, le rôle Spot Fleet IAM spécifié ici doit utiliser la nouvelle politique gérée par AmazonEC2 SpotFleet TaggingRole. La politique de gestion des SpotFleetrôles AmazonEC2 précédemment recommandée ne dispose pas des autorisations requises pour baliser les instances Spot. Pour plus d’informations, consultez Instances ponctuelles non étiquetées lors de la création.

Type : chaîne

Obligatoire : ce paramètre est obligatoire pour les environnements de calcul SPOT.

launchTemplate

Un modèle de lancement facultatif à associer à vos ressources de calcul. Ce paramètre ne s'applique pas aux tâches exécutées sur les ressources Fargate. Ne le spécifiez pas. Tous les autres paramètres de ressources de calcul que vous spécifiez dans une opération CreateComputeEnvironmentd'UpdateComputeEnvironmentAPI remplacent les mêmes paramètres dans le modèle de lancement. Pour utiliser un modèle de lancement, vous devez spécifier son ID ou son nom dans la demande, mais pas les deux. Pour plus d’informations, consultez Support de modèle de lancement.

Lors de la mise à jour d'un environnement informatique, pour supprimer le modèle de lancement personnalisé et utiliser le modèle de lancement par défaut, définissez la spécification launchTemplateId ou le launchTemplateName membre de la spécification du modèle de lancement sur une chaîne vide. La suppression du modèle de lancement d'un environnement informatique ne supprime pas l'AMI spécifiée dans le modèle de lancement, si c'est elle qui a été utilisée. Pour mettre à jour l'AMI sélectionnée à partir d'un modèle de lancement, le updateToLatestImageVersion paramètre doit être défini surtrue. Lors de la mise à jour d'un environnement informatique, si vous modifiez le modèle de lancement, une mise à jour de l'infrastructure de l'environnement informatique est requise. Pour plus d’informations, consultez Mise à jour des environnements informatiques.

Type : LaunchTemplateSpecification

objet

Obligatoire : non

launchTemplateId

ID du modèle de lancement.

Type : chaîne

Obligatoire : non

launchTemplateName

Le nom du modèle de lancement.

Type : chaîne

Obligatoire : non

version

Numéro de version du modèle de lancement, $Latest ou $Default.

Si la valeur est $Latest, la dernière version du modèle de lancement est utilisée. Si la valeur est $Default, la version par défaut du modèle de lancement est utilisée. Lors d'une mise à jour de l'infrastructure, si l'une $Latest ou l'autre $Default a été spécifiée pour l'environnement informatique, AWS Batch réévalue la version du modèle de lancement et peut utiliser une version différente du modèle de lancement. Et ce, même si le modèle de lancement n'a pas été spécifié dans la mise à jour.

Par défaut: $Default.

Type : chaîne

Obligatoire : non

ec2Configuration

Fournit les informations utilisées pour sélectionner Amazon Machine Images (AMI) pour les instances de l'environnement informatique EC2. Si Ec2Configuration ce n'est pas spécifié, la valeur par défaut est Amazon Linux 2 (ECS_AL2). Avant le 31 mars 2021, cette valeur par défaut était Amazon Linux (ECS_AL1) pour les instances autres que le GPU ou AWS Graviton.

Lors de la mise à jour d'un environnement informatique, si vous modifiez ce paramètre, une mise à jour de l'infrastructure de l'environnement informatique est requise. Pour plus d’informations, consultez Mise à jour des environnements informatiques.

Note

Ce paramètre ne s'applique pas aux tâches exécutées sur les ressources Fargate.

Type : tableau d’objets Ec2Configuration

Obligatoire : non

imageIdOverride

ID d'AMI utilisé pour les instances lancées dans l'environnement informatique correspondant au type d'image. Ce paramètre remplace imageId, défini dans l'objet computeResource.

Type : chaîne

Obligatoire : non

imageKubernetesVersion

KubernetesVersion pour l'environnement de calcul. Si vous ne spécifiez pas de valeur, la dernière version prise en charge par AWS Batch est utilisée.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 256.

Obligatoire : non

imageType

Le type d'image devant correspondre au type d'instance afin de sélectionner une AMI. Les valeurs prises en charge sont différentes pour les ressources ECS et EKS.

ECS

Si le paramètre imageIdOverride n'est pas spécifié, une AMI Amazon Linux 2 optimisée pour Amazon ECS (ECS_AL2) récente est utilisée. Si un nouveau type d'image est spécifié dans une mise à jour, mais qu'aucun imageIdOverride paramètre imageId n'est spécifié, l'AMI optimisée Amazon ECS la plus récente pour ce type d'image pris en charge par AWS Batch est utilisée.

ECS_AL2

Amazon Linux 2 : par défaut pour toutes les familles d'instance non GPU.

ECS_AL2_NVIDIA

Amazon Linux 2 (GPU) : par défaut pour toutes les familles d'instances GPU (par exemple P4 etG4) et peut être utilisé pour tous les types d'instances non AWS basés sur Graviton.

ECS_AL1

Amazon Linux. Amazon Linux a atteint le niveau end-of-life de support standard. Pour plus d'informations, consultez AMI Amazon Linux.

EKS

Si le paramètre imageIdOverride n'est pas spécifié, une AMI Amazon Linux optimisée pour Amazon EKS (EKS_AL2) récente est utilisée. Si un nouveau type d'image est spécifié dans une mise à jour, mais qu'aucun imageIdOverride paramètre imageId n'est spécifié, l'AMI optimisée Amazon EKS la plus récente pour ce type d'image AWS Batch compatible est utilisée.

EKS_AL2

Amazon Linux 2 : par défaut pour toutes les familles d'instance non GPU.

EKS_AL2_NVIDIA

Amazon Linux 2 (accéléré) : par défaut pour toutes les familles d'instances GPU (par exemple, P4 etG4) et peut être utilisé pour tous les types d'instances non AWS basés sur Graviton.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 256.

Obligatoire : oui

Configuration d'Amazon EKS

Configuration pour le cluster Amazon EKS qui prend en charge l'environnement AWS Batch informatique. Le cluster doit exister pour permettre la création de l'environnement de calcul.

eksClusterArn

Amazon Resource Name (ARN) du cluster Amazon EKS. Par exemple : arn:aws:eks:us-east-1:123456789012:cluster/ClusterForBatch.

Type : chaîne

Obligatoire : oui

kubernetesNamespace

L'espace de noms du cluster Amazon EKS. AWS Batch gère les pods dans cet espace de noms. La valeur ne peut pas être vide ou null. Elle doit comporter moins de 64 caractères, ne peut pas être définie sur default, ne peut pas commencer par «kube- » et doit correspondre à cette expression régulière : ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$. Pour plus d'informations, consultez Espaces de noms dans la documentation Kubernetes.

Type : chaîne

Obligatoire : oui

Type : EksConfigurationObjet

Obligatoire : non

Rôle de service

serviceRole

Nom de ressource Amazon (ARN) complet du rôle IAM qui permet de passer des appels AWS Batch vers d'autres AWS services en votre nom. Pour plus d’informations, consultez Utilisation de rôles liés à un service pour AWS Batch. Nous vous recommandons de ne pas spécifier le rôle du service. De cette façon, AWS Batch utilise le rôle AWSServiceRoleForBatchlié au service.

Important

Si votre compte a déjà créé le rôle AWS Batch lié au service (AWSServiceRoleForBatch), ce rôle est utilisé par défaut pour votre environnement informatique, sauf si vous spécifiez un rôle ici. Si le rôle AWS Batch lié au service n'existe pas dans votre compte et qu'aucun rôle n'est spécifié ici, le service essaie de créer le rôle AWS Batch lié au service dans votre compte. Pour de plus amples informations sur le rôle lié à un service AWSServiceRoleForBatch, consultez Autorisations de rôle liées à un service pour AWS Batch.

Si l'environnement de calcul est créé à l'aide du rôle AWSServiceRoleForBatchlié au service, il ne peut pas être modifié pour utiliser un rôle IAM normal. De même, si l'environnement informatique est créé avec un rôle IAM normal, il ne peut pas être modifié pour utiliser le rôle lié à un AWSServiceRoleForBatchservice. Pour mettre à jour les paramètres de l'environnement informatique qui nécessitent une mise à jour de l'infrastructure pour être modifiés, le rôle AWSServiceRoleForBatchlié au service doit être utilisé. Pour plus d’informations, consultez Mise à jour des environnements informatiques.

Si le rôle que vous avez spécifié possède un chemin autre que/, assurez-vous de spécifier l'ARN complet du rôle (recommandé) ou de préfixer le nom du rôle avec le chemin.

Note

Selon la façon dont vous avez créé votre rôle de AWS Batch service, son Amazon Resource Name (ARN) peut contenir le préfixe de service-role chemin. Lorsque vous spécifiez uniquement le nom du rôle de service, cela AWS Batch suppose que votre ARN n'utilise pas le préfixe de service-role chemin. De ce fait, nous vous recommandons de spécifier l'ARN complet de votre rôle de service lorsque vous créez des environnements de calcul.

Type : chaîne

Obligatoire : non

Balises

tags

Balises de paires clé-valeur à associer à l'environnement informatique. Pour plus d’informations, consultez Balisage de vos ressources AWS Batch.

Type : mappage chaîne/chaîne

Obligatoire : non