Microsoft.AwsConnector ecsClusters 2024-12-01

Article
2024-12-21

Définition de ressource Bicep

Le type de ressource ecsClusters 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.AwsConnector/ecsClusters, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.AwsConnector/ecsClusters@2024-12-01' = {
  location: 'string'
  name: 'string'
  properties: {
    arn: 'string'
    awsAccountId: 'string'
    awsProperties: {
      arn: 'string'
      capacityProviders: [
        'string'
      ]
      clusterName: 'string'
      clusterSettings: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      configuration: {
        executeCommandConfiguration: {
          kmsKeyId: 'string'
          logConfiguration: {
            cloudWatchEncryptionEnabled: bool
            cloudWatchLogGroupName: 'string'
            s3BucketName: 'string'
            s3EncryptionEnabled: bool
            s3KeyPrefix: 'string'
          }
          logging: 'string'
        }
      }
      defaultCapacityProviderStrategy: [
        {
          base: int
          capacityProvider: 'string'
          weight: int
        }
      ]
      serviceConnectDefaults: {
        namespace: 'string'
      }
      tags: [
        {
          key: 'string'
          value: 'string'
        }
      ]
    }
    awsRegion: 'string'
    awsSourceSchema: 'string'
    awsTags: {
      {customized property}: 'string'
    }
    publicCloudConnectorsResourceId: 'string'
    publicCloudResourceName: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valeurs de la propriété

AwsEcsClusterProperties

Nom	Description	Valeur
arn	Property arn	corde
capacityProviders	Nom court d’un ou plusieurs fournisseurs de capacité à associer au cluster. Un fournisseur de capacité doit être associé à un cluster avant de pouvoir être inclus dans le cadre de la stratégie de fournisseur de capacité par défaut du cluster ou utilisé dans une stratégie de fournisseur de capacité lors de l’appel de l'CreateService ou Actions RunTask. Si vous spécifiez un fournisseur de capacité qui utilise un groupe de mise à l’échelle automatique, le fournisseur de capacité doit être créé, mais pas associé à un autre cluster. Vous pouvez créer de nouveaux fournisseurs de capacité de groupe de mise à l’échelle automatique avec l’opération d’API CreateCapacityProvider. Pour utiliser un fournisseur de capacité FARGATElong, spécifiez les fournisseurs de capacité `FARGATE` ou `FARGATE_SPOT`. Les fournisseurs de capacité FARGATElong sont disponibles pour tous les comptes et doivent uniquement être associés à un cluster à utiliser. L’opération d’API PutCapacityProvider est utilisée pour mettre à jour la liste des fournisseurs de capacité disponibles pour un cluster une fois le cluster créé.	string[]
clusterName	Chaîne générée par l’utilisateur que vous utilisez pour identifier votre cluster. Si vous ne spécifiez pas de nom, CFNlong génère un ID physique unique pour le nom.	corde
clusterSettings	Paramètres à utiliser lors de la création d’un cluster. Ce paramètre est utilisé pour activer CloudWatch Container Insights pour un cluster.	ClusterSettings[]
configuration	Configuration de commande d’exécution pour le cluster. Configuration de commande d’exécution pour le cluster.	ClusterConfiguration
defaultCapacityProviderStrategy	Stratégie de fournisseur de capacité par défaut pour le cluster. Lorsque des services ou des tâches sont exécutés dans le cluster sans type de lancement ni stratégie de fournisseur de capacité spécifiée, la stratégie de fournisseur de capacité par défaut est utilisée.	CapacityProviderStrategyItem[]
serviceConnectDefaults	Utilisez ce paramètre pour définir un espace de noms Service Connect par défaut. Après avoir défini un espace de noms Service Connect par défaut, tous les nouveaux services avec Service Connect activés qui sont créés dans le cluster sont ajoutés en tant que services clients dans l’espace de noms. Ce paramètre s’applique uniquement aux nouveaux services qui définissent le paramètre `enabled` sur `true` dans le `ServiceConnectConfiguration`. Vous pouvez définir l’espace de noms de chaque service individuellement dans le `ServiceConnectConfiguration` pour remplacer ce paramètre par défaut. Les tâches qui s’exécutent dans un espace de noms peuvent utiliser des noms courts pour se connecter aux services de l’espace de noms. Les tâches peuvent se connecter aux services sur tous les clusters de l’espace de noms. Les tâches se connectent via un conteneur proxy managé qui collecte les journaux et les métriques pour une visibilité accrue. Seules les tâches créées par Amazon ECS services sont prises en charge avec Service Connect. Pour plus d’informations, consultez Service Connect dans le guide du développeur Amazon Elastic Container Service. Utilisez ce paramètre pour définir un espace de noms Service Connect par défaut. Après avoir défini un espace de noms Service Connect par défaut, tous les nouveaux services avec Service Connect activés qui sont créés dans le cluster sont ajoutés en tant que services clients dans l’espace de noms. Ce paramètre s’applique uniquement aux nouveaux services qui définissent le paramètre `enabled` sur `true` dans le `ServiceConnectConfiguration`. Vous pouvez définir l’espace de noms de chaque service individuellement dans le `ServiceConnectConfiguration` pour remplacer ce paramètre par défaut. Les tâches qui s’exécutent dans un espace de noms peuvent utiliser des noms courts pour se connecter aux services de l’espace de noms. Les tâches peuvent se connecter aux services sur tous les clusters de l’espace de noms. Les tâches se connectent via un conteneur proxy managé qui collecte les journaux et les métriques pour une visibilité accrue. Seules les tâches créées par Amazon ECS services sont prises en charge avec Service Connect. Pour plus d’informations, consultez Service Connect dans le guide du développeur Amazon Elastic Container Service.	ServiceConnectDefaults
étiquettes	Métadonnées que vous appliquez au cluster pour vous aider à les classer et à les organiser. Chaque balise se compose d’une clé et d’une valeur facultative. Vous définissez les deux. Les restrictions de base suivantes s’appliquent aux balises : + Nombre maximal d’étiquettes par ressource - 50 + Pour chaque ressource, chaque clé de balise doit être unique et chaque clé de balise ne peut avoir qu’une seule valeur. + Longueur maximale de clé - 128 caractères Unicode dans UTF-8 + Longueur maximale de valeur - 256 caractères Unicode dans UTF-8 + Si votre schéma de balisage est utilisé sur plusieurs services et ressources, n’oubliez pas que d’autres services peuvent avoir des restrictions sur les caractères autorisés. Les caractères généralement autorisés sont les suivants : lettres, chiffres et espaces représentés dans UTF-8, et les caractères suivants : + - = . _ : / @. + Les clés et valeurs d’étiquette respectent la casse. + N’utilisez pas `aws:`, `AWS:`, ou toute combinaison majuscule ou minuscule de type préfixe pour les clés ou les valeurs, car elle est réservée à l’utilisation d’AWS. Vous ne pouvez pas modifier ou supprimer des clés ou des valeurs de balise avec ce préfixe. Les balises avec ce préfixe ne sont pas comptabilisées par rapport à vos balises par limite de ressources.	TagAutoGenerated25[]

CapacityProviderStrategyItem

Nom	Description	Valeur
base	La valeur base désigne le nombre de tâches, au minimum, à exécuter sur le fournisseur de capacité spécifié. Un seul fournisseur de capacité dans une stratégie de fournisseur de capacité peut avoir un base défini. Si aucune valeur n’est spécifiée, la valeur par défaut de `0` est utilisée.	Int
capacityProvider	Nom court du fournisseur de capacité.	corde
poids	La valeur pondération désigne le pourcentage relatif du nombre total de tâches lancées qui doivent utiliser le fournisseur de capacité spécifié. La valeur `weight` est prise en compte après la valeur `base`, si elle est définie, est satisfaite. Si aucune valeur `weight` n’est spécifiée, la valeur par défaut de `0` est utilisée. Lorsque plusieurs fournisseurs de capacité sont spécifiés dans une stratégie de fournisseur de capacité, au moins un des fournisseurs de capacité doit avoir une valeur de pondération supérieure à zéro et tous les fournisseurs de capacité avec un poids de `0` ne peuvent pas être utilisés pour placer des tâches. Si vous spécifiez plusieurs fournisseurs de capacité dans une stratégie qui ont tous un poids de `0`, toutes les actions `RunTask` ou `CreateService` à l’aide de la stratégie de fournisseur de capacité échouent. Un exemple de scénario d’utilisation des pondérations consiste à définir une stratégie qui contient deux fournisseurs de capacité et qui ont tous deux un poids de `1`, puis lorsque le `base` est satisfait, les tâches seront réparties uniformément entre les deux fournisseurs de capacité. En utilisant cette même logique, si vous spécifiez un poids de `1` pour capacityProviderA et un poids de `4` pour capacityProviderB, puis pour chaque tâche exécutée à l’aide de capacityProviderA, quatre tâches utiliseraient capacityProviderB.	Int

ClusterConfiguration

Nom	Description	Valeur
executeCommandConfiguration	Détails de la configuration de commande d’exécution. Détails de la configuration de commande d’exécution.	ExecuteCommandConfiguration

ClusterSettings

Nom	Description	Valeur
nom	Nom du paramètre de cluster. La valeur est `containerInsights` .	corde
valeur	Valeur à définir pour le paramètre de cluster. Les valeurs prises en charge sont `enabled` et `disabled`. Si vous définissez `name` sur `containerInsights` et `value` sur `enabled`, CloudWatch Container Insights est activé pour le cluster ; sinon, il est désactivé, sauf si le paramètre de compte `containerInsights` est activé. Si une valeur de cluster est spécifiée, elle remplace la valeur `containerInsights` définie par PutAccountSetting ou PutAccountSettingDefault.	corde

EcsClusterProperties

Nom	Description	Valeur
arn	Nom de la ressource Amazon (ARN)	corde
awsAccountId	ID de compte AWS	corde
awsProperties	Propriétés AWS	AwsEcsClusterProperties
awsRegion	Région AWS	corde
awsSourceSchema	Schéma source AWS	corde
awsTags	Balises AWS	EcsClusterPropertiesAwsTags
publicCloudConnectorsResourceId	ID de ressource des connecteurs cloud public	corde
publicCloudResourceName	Nom de la ressource cloud public	corde

EcsClusterPropertiesAwsTags

Nom	Description	Valeur

ExecuteCommandConfiguration

Nom	Description	Valeur
kmsKeyId	Spécifiez un ID de clé KMSlong pour chiffrer les données entre le client local et le conteneur.	corde
logConfiguration	Configuration du journal pour les résultats des actions de commande d’exécution. Les journaux peuvent être envoyés à CloudWatch Logs ou à un compartiment Amazon S3. Lorsque `logging=OVERRIDE` est spécifié, un `logConfiguration` doit être fourni. Configuration du journal pour les résultats des actions de commande d’exécution. Les journaux peuvent être envoyés à CloudWatch Logs ou à un compartiment Amazon S3.	executeCommandLogConfiguration
exploitation forestière	Paramètre de journal à utiliser pour rediriger les journaux pour vos résultats de commande d’exécution. Les paramètres de journal suivants sont disponibles. + `NONE`: la session de commande d’exécution n’est pas journalisée. + `DEFAULT`: la configuration `awslogs` dans la définition de tâche est utilisée. Si aucun paramètre de journalisation n’est spécifié, il est défini par défaut sur cette valeur. Si aucun `awslogs` pilote de journal n’est configuré dans la définition de tâche, la sortie n’est pas journalisée. + `OVERRIDE`: spécifiez les détails de journalisation dans le cadre de `logConfiguration`. Si l’option de journalisation `OVERRIDE` est spécifiée, la `logConfiguration` est requise.	corde

ExecuteCommandLogConfiguration

Nom	Description	Valeur
cloudWatchEncryptionEnabled	Détermine s’il faut utiliser le chiffrement sur les journaux CloudWatch. S’il n’est pas spécifié, le chiffrement est désactivé.	Bool
cloudWatchLogGroupName	Nom du groupe de journaux CloudWatch auquel envoyer des journaux. Le groupe de journaux CloudWatch doit déjà être créé.	corde
s3BucketName	Nom du compartiment S3 à laquelle envoyer des journaux. Le compartiment S3 doit déjà être créé.	corde
s3EncryptionEnabled	Détermine s’il faut utiliser le chiffrement sur les journaux S3. S’il n’est pas spécifié, le chiffrement n’est pas utilisé.	Bool
s3KeyPrefix	Dossier facultatif dans le compartiment S3 dans lequel placer les journaux d’activité.	corde

Microsoft.AwsConnector/ecsClusters

Nom	Description	Valeur
emplacement	Emplacement géographique où réside la ressource	chaîne (obligatoire)
nom	Nom de la ressource	corde Contraintes: Modèle = `^(?=.{0,259}[^\s.]$)(?!.*[<>%&\?/#])` (obligatoire)
Propriétés	Propriétés spécifiques à la ressource pour cette ressource.	EcsClusterProperties
étiquettes	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

ServiceConnectDefaults

Nom	Description	Valeur
Namespace	Nom d’espace de noms ou nom de ressource Amazon complet (ARN) de l’espace de noms CMAPlong utilisé lorsque vous créez un service et ne spécifiez pas de configuration Service Connect. Le nom de l’espace de noms peut inclure jusqu’à 1 024 caractères. Le nom respecte la casse. Le nom ne peut pas inclure de traits d’union (-), tilde (~), supérieur à (>), inférieur à (<) ou barre oblique (/). Si vous entrez un nom d’espace de noms existant ou UN ARN, cet espace de noms sera utilisé. Tout type d’espace de noms est pris en charge. L’espace de noms doit se trouver dans ce compte et dans cette région AWS. Si vous entrez un nouveau nom, un espace de noms CMAPlong est créé. Amazon ECS crée un espace de noms CMAP avec la méthode « Appels d’API » de découverte d’instances uniquement. Cette méthode de découverte d’instance est le type d’espace de noms « HTTP » dans le CLIlong. D’autres types de découverte d’instances ne sont pas utilisés par Service Connect. Si vous mettez à jour le cluster avec une chaîne vide `''` pour le nom de l’espace de noms, la configuration du cluster pour Service Connect est supprimée. Notez que l’espace de noms reste dans CMAP et doit être supprimé séparément. Pour plus d’informations sur CMAPlong, consultez Working with Services dans le guide du développeur .	corde

TagAutoGenerated25

Nom	Description	Valeur
clé	Une partie d’une paire clé-valeur qui compose une balise. Un `key` est une étiquette générale qui agit comme une catégorie pour des valeurs d’étiquette plus spécifiques.	corde
valeur	Partie facultative d’une paire clé-valeur qui compose une balise. Un `value` agit en tant que descripteur au sein d’une catégorie de balise (clé).	corde

TrackedResourceTags

Nom	Description	Valeur

Définition de ressource de modèle ARM

Le type de ressource ecsClusters 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.AwsConnector/ecsClusters, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.AwsConnector/ecsClusters",
  "apiVersion": "2024-12-01",
  "name": "string",
  "location": "string",
  "properties": {
    "arn": "string",
    "awsAccountId": "string",
    "awsProperties": {
      "arn": "string",
      "capacityProviders": [ "string" ],
      "clusterName": "string",
      "clusterSettings": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "configuration": {
        "executeCommandConfiguration": {
          "kmsKeyId": "string",
          "logConfiguration": {
            "cloudWatchEncryptionEnabled": "bool",
            "cloudWatchLogGroupName": "string",
            "s3BucketName": "string",
            "s3EncryptionEnabled": "bool",
            "s3KeyPrefix": "string"
          },
          "logging": "string"
        }
      },
      "defaultCapacityProviderStrategy": [
        {
          "base": "int",
          "capacityProvider": "string",
          "weight": "int"
        }
      ],
      "serviceConnectDefaults": {
        "namespace": "string"
      },
      "tags": [
        {
          "key": "string",
          "value": "string"
        }
      ]
    },
    "awsRegion": "string",
    "awsSourceSchema": "string",
    "awsTags": {
      "{customized property}": "string"
    },
    "publicCloudConnectorsResourceId": "string",
    "publicCloudResourceName": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valeurs de la propriété

AwsEcsClusterProperties

Nom	Description	Valeur
arn	Property arn	corde
capacityProviders	Nom court d’un ou plusieurs fournisseurs de capacité à associer au cluster. Un fournisseur de capacité doit être associé à un cluster avant de pouvoir être inclus dans le cadre de la stratégie de fournisseur de capacité par défaut du cluster ou utilisé dans une stratégie de fournisseur de capacité lors de l’appel de l'CreateService ou Actions RunTask. Si vous spécifiez un fournisseur de capacité qui utilise un groupe de mise à l’échelle automatique, le fournisseur de capacité doit être créé, mais pas associé à un autre cluster. Vous pouvez créer de nouveaux fournisseurs de capacité de groupe de mise à l’échelle automatique avec l’opération d’API CreateCapacityProvider. Pour utiliser un fournisseur de capacité FARGATElong, spécifiez les fournisseurs de capacité `FARGATE` ou `FARGATE_SPOT`. Les fournisseurs de capacité FARGATElong sont disponibles pour tous les comptes et doivent uniquement être associés à un cluster à utiliser. L’opération d’API PutCapacityProvider est utilisée pour mettre à jour la liste des fournisseurs de capacité disponibles pour un cluster une fois le cluster créé.	string[]
clusterName	Chaîne générée par l’utilisateur que vous utilisez pour identifier votre cluster. Si vous ne spécifiez pas de nom, CFNlong génère un ID physique unique pour le nom.	corde
clusterSettings	Paramètres à utiliser lors de la création d’un cluster. Ce paramètre est utilisé pour activer CloudWatch Container Insights pour un cluster.	ClusterSettings[]
configuration	Configuration de commande d’exécution pour le cluster. Configuration de commande d’exécution pour le cluster.	ClusterConfiguration
defaultCapacityProviderStrategy	Stratégie de fournisseur de capacité par défaut pour le cluster. Lorsque des services ou des tâches sont exécutés dans le cluster sans type de lancement ni stratégie de fournisseur de capacité spécifiée, la stratégie de fournisseur de capacité par défaut est utilisée.	CapacityProviderStrategyItem[]
serviceConnectDefaults	Utilisez ce paramètre pour définir un espace de noms Service Connect par défaut. Après avoir défini un espace de noms Service Connect par défaut, tous les nouveaux services avec Service Connect activés qui sont créés dans le cluster sont ajoutés en tant que services clients dans l’espace de noms. Ce paramètre s’applique uniquement aux nouveaux services qui définissent le paramètre `enabled` sur `true` dans le `ServiceConnectConfiguration`. Vous pouvez définir l’espace de noms de chaque service individuellement dans le `ServiceConnectConfiguration` pour remplacer ce paramètre par défaut. Les tâches qui s’exécutent dans un espace de noms peuvent utiliser des noms courts pour se connecter aux services de l’espace de noms. Les tâches peuvent se connecter aux services sur tous les clusters de l’espace de noms. Les tâches se connectent via un conteneur proxy managé qui collecte les journaux et les métriques pour une visibilité accrue. Seules les tâches créées par Amazon ECS services sont prises en charge avec Service Connect. Pour plus d’informations, consultez Service Connect dans le guide du développeur Amazon Elastic Container Service. Utilisez ce paramètre pour définir un espace de noms Service Connect par défaut. Après avoir défini un espace de noms Service Connect par défaut, tous les nouveaux services avec Service Connect activés qui sont créés dans le cluster sont ajoutés en tant que services clients dans l’espace de noms. Ce paramètre s’applique uniquement aux nouveaux services qui définissent le paramètre `enabled` sur `true` dans le `ServiceConnectConfiguration`. Vous pouvez définir l’espace de noms de chaque service individuellement dans le `ServiceConnectConfiguration` pour remplacer ce paramètre par défaut. Les tâches qui s’exécutent dans un espace de noms peuvent utiliser des noms courts pour se connecter aux services de l’espace de noms. Les tâches peuvent se connecter aux services sur tous les clusters de l’espace de noms. Les tâches se connectent via un conteneur proxy managé qui collecte les journaux et les métriques pour une visibilité accrue. Seules les tâches créées par Amazon ECS services sont prises en charge avec Service Connect. Pour plus d’informations, consultez Service Connect dans le guide du développeur Amazon Elastic Container Service.	ServiceConnectDefaults
étiquettes	Métadonnées que vous appliquez au cluster pour vous aider à les classer et à les organiser. Chaque balise se compose d’une clé et d’une valeur facultative. Vous définissez les deux. Les restrictions de base suivantes s’appliquent aux balises : + Nombre maximal d’étiquettes par ressource - 50 + Pour chaque ressource, chaque clé de balise doit être unique et chaque clé de balise ne peut avoir qu’une seule valeur. + Longueur maximale de clé - 128 caractères Unicode dans UTF-8 + Longueur maximale de valeur - 256 caractères Unicode dans UTF-8 + Si votre schéma de balisage est utilisé sur plusieurs services et ressources, n’oubliez pas que d’autres services peuvent avoir des restrictions sur les caractères autorisés. Les caractères généralement autorisés sont les suivants : lettres, chiffres et espaces représentés dans UTF-8, et les caractères suivants : + - = . _ : / @. + Les clés et valeurs d’étiquette respectent la casse. + N’utilisez pas `aws:`, `AWS:`, ou toute combinaison majuscule ou minuscule de type préfixe pour les clés ou les valeurs, car elle est réservée à l’utilisation d’AWS. Vous ne pouvez pas modifier ou supprimer des clés ou des valeurs de balise avec ce préfixe. Les balises avec ce préfixe ne sont pas comptabilisées par rapport à vos balises par limite de ressources.	TagAutoGenerated25[]

CapacityProviderStrategyItem

Nom	Description	Valeur
base	La valeur base désigne le nombre de tâches, au minimum, à exécuter sur le fournisseur de capacité spécifié. Un seul fournisseur de capacité dans une stratégie de fournisseur de capacité peut avoir un base défini. Si aucune valeur n’est spécifiée, la valeur par défaut de `0` est utilisée.	Int
capacityProvider	Nom court du fournisseur de capacité.	corde
poids	La valeur pondération désigne le pourcentage relatif du nombre total de tâches lancées qui doivent utiliser le fournisseur de capacité spécifié. La valeur `weight` est prise en compte après la valeur `base`, si elle est définie, est satisfaite. Si aucune valeur `weight` n’est spécifiée, la valeur par défaut de `0` est utilisée. Lorsque plusieurs fournisseurs de capacité sont spécifiés dans une stratégie de fournisseur de capacité, au moins un des fournisseurs de capacité doit avoir une valeur de pondération supérieure à zéro et tous les fournisseurs de capacité avec un poids de `0` ne peuvent pas être utilisés pour placer des tâches. Si vous spécifiez plusieurs fournisseurs de capacité dans une stratégie qui ont tous un poids de `0`, toutes les actions `RunTask` ou `CreateService` à l’aide de la stratégie de fournisseur de capacité échouent. Un exemple de scénario d’utilisation des pondérations consiste à définir une stratégie qui contient deux fournisseurs de capacité et qui ont tous deux un poids de `1`, puis lorsque le `base` est satisfait, les tâches seront réparties uniformément entre les deux fournisseurs de capacité. En utilisant cette même logique, si vous spécifiez un poids de `1` pour capacityProviderA et un poids de `4` pour capacityProviderB, puis pour chaque tâche exécutée à l’aide de capacityProviderA, quatre tâches utiliseraient capacityProviderB.	Int

ClusterConfiguration

Nom	Description	Valeur
executeCommandConfiguration	Détails de la configuration de commande d’exécution. Détails de la configuration de commande d’exécution.	ExecuteCommandConfiguration

ClusterSettings

Nom	Description	Valeur
nom	Nom du paramètre de cluster. La valeur est `containerInsights` .	corde
valeur	Valeur à définir pour le paramètre de cluster. Les valeurs prises en charge sont `enabled` et `disabled`. Si vous définissez `name` sur `containerInsights` et `value` sur `enabled`, CloudWatch Container Insights est activé pour le cluster ; sinon, il est désactivé, sauf si le paramètre de compte `containerInsights` est activé. Si une valeur de cluster est spécifiée, elle remplace la valeur `containerInsights` définie par PutAccountSetting ou PutAccountSettingDefault.	corde

EcsClusterProperties

Nom	Description	Valeur
arn	Nom de la ressource Amazon (ARN)	corde
awsAccountId	ID de compte AWS	corde
awsProperties	Propriétés AWS	AwsEcsClusterProperties
awsRegion	Région AWS	corde
awsSourceSchema	Schéma source AWS	corde
awsTags	Balises AWS	EcsClusterPropertiesAwsTags
publicCloudConnectorsResourceId	ID de ressource des connecteurs cloud public	corde
publicCloudResourceName	Nom de la ressource cloud public	corde

EcsClusterPropertiesAwsTags

Nom	Description	Valeur

ExecuteCommandConfiguration

Nom	Description	Valeur
kmsKeyId	Spécifiez un ID de clé KMSlong pour chiffrer les données entre le client local et le conteneur.	corde
logConfiguration	Configuration du journal pour les résultats des actions de commande d’exécution. Les journaux peuvent être envoyés à CloudWatch Logs ou à un compartiment Amazon S3. Lorsque `logging=OVERRIDE` est spécifié, un `logConfiguration` doit être fourni. Configuration du journal pour les résultats des actions de commande d’exécution. Les journaux peuvent être envoyés à CloudWatch Logs ou à un compartiment Amazon S3.	executeCommandLogConfiguration
exploitation forestière	Paramètre de journal à utiliser pour rediriger les journaux pour vos résultats de commande d’exécution. Les paramètres de journal suivants sont disponibles. + `NONE`: la session de commande d’exécution n’est pas journalisée. + `DEFAULT`: la configuration `awslogs` dans la définition de tâche est utilisée. Si aucun paramètre de journalisation n’est spécifié, il est défini par défaut sur cette valeur. Si aucun `awslogs` pilote de journal n’est configuré dans la définition de tâche, la sortie n’est pas journalisée. + `OVERRIDE`: spécifiez les détails de journalisation dans le cadre de `logConfiguration`. Si l’option de journalisation `OVERRIDE` est spécifiée, la `logConfiguration` est requise.	corde

ExecuteCommandLogConfiguration

Nom	Description	Valeur
cloudWatchEncryptionEnabled	Détermine s’il faut utiliser le chiffrement sur les journaux CloudWatch. S’il n’est pas spécifié, le chiffrement est désactivé.	Bool
cloudWatchLogGroupName	Nom du groupe de journaux CloudWatch auquel envoyer des journaux. Le groupe de journaux CloudWatch doit déjà être créé.	corde
s3BucketName	Nom du compartiment S3 à laquelle envoyer des journaux. Le compartiment S3 doit déjà être créé.	corde
s3EncryptionEnabled	Détermine s’il faut utiliser le chiffrement sur les journaux S3. S’il n’est pas spécifié, le chiffrement n’est pas utilisé.	Bool
s3KeyPrefix	Dossier facultatif dans le compartiment S3 dans lequel placer les journaux d’activité.	corde

Microsoft.AwsConnector/ecsClusters

Nom	Description	Valeur
apiVersion	Version de l’API	'2024-12-01'
emplacement	Emplacement géographique où réside la ressource	chaîne (obligatoire)
nom	Nom de la ressource	corde Contraintes: Modèle = `^(?=.{0,259}[^\s.]$)(?!.*[<>%&\?/#])` (obligatoire)
Propriétés	Propriétés spécifiques à la ressource pour cette ressource.	EcsClusterProperties
étiquettes	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type	Type de ressource	'Microsoft.AwsConnector/ecsClusters'

ServiceConnectDefaults

Nom	Description	Valeur
Namespace	Nom d’espace de noms ou nom de ressource Amazon complet (ARN) de l’espace de noms CMAPlong utilisé lorsque vous créez un service et ne spécifiez pas de configuration Service Connect. Le nom de l’espace de noms peut inclure jusqu’à 1 024 caractères. Le nom respecte la casse. Le nom ne peut pas inclure de traits d’union (-), tilde (~), supérieur à (>), inférieur à (<) ou barre oblique (/). Si vous entrez un nom d’espace de noms existant ou UN ARN, cet espace de noms sera utilisé. Tout type d’espace de noms est pris en charge. L’espace de noms doit se trouver dans ce compte et dans cette région AWS. Si vous entrez un nouveau nom, un espace de noms CMAPlong est créé. Amazon ECS crée un espace de noms CMAP avec la méthode « Appels d’API » de découverte d’instances uniquement. Cette méthode de découverte d’instance est le type d’espace de noms « HTTP » dans le CLIlong. D’autres types de découverte d’instances ne sont pas utilisés par Service Connect. Si vous mettez à jour le cluster avec une chaîne vide `''` pour le nom de l’espace de noms, la configuration du cluster pour Service Connect est supprimée. Notez que l’espace de noms reste dans CMAP et doit être supprimé séparément. Pour plus d’informations sur CMAPlong, consultez Working with Services dans le guide du développeur .	corde

TagAutoGenerated25

Nom	Description	Valeur
clé	Une partie d’une paire clé-valeur qui compose une balise. Un `key` est une étiquette générale qui agit comme une catégorie pour des valeurs d’étiquette plus spécifiques.	corde
valeur	Partie facultative d’une paire clé-valeur qui compose une balise. Un `value` agit en tant que descripteur au sein d’une catégorie de balise (clé).	corde

TrackedResourceTags

Nom	Description	Valeur

Exemples d’utilisation

Définition de ressource Terraform (fournisseur AzAPI)

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.AwsConnector/ecsClusters@2024-12-01"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      arn = "string"
      awsAccountId = "string"
      awsProperties = {
        arn = "string"
        capacityProviders = [
          "string"
        ]
        clusterName = "string"
        clusterSettings = [
          {
            name = "string"
            value = "string"
          }
        ]
        configuration = {
          executeCommandConfiguration = {
            kmsKeyId = "string"
            logConfiguration = {
              cloudWatchEncryptionEnabled = bool
              cloudWatchLogGroupName = "string"
              s3BucketName = "string"
              s3EncryptionEnabled = bool
              s3KeyPrefix = "string"
            }
            logging = "string"
          }
        }
        defaultCapacityProviderStrategy = [
          {
            base = int
            capacityProvider = "string"
            weight = int
          }
        ]
        serviceConnectDefaults = {
          namespace = "string"
        }
        tags = [
          {
            key = "string"
            value = "string"
          }
        ]
      }
      awsRegion = "string"
      awsSourceSchema = "string"
      awsTags = {
        {customized property} = "string"
      }
      publicCloudConnectorsResourceId = "string"
      publicCloudResourceName = "string"
    }
  }
}

Valeurs de la propriété

AwsEcsClusterProperties

Nom	Description	Valeur
arn	Property arn	corde
capacityProviders	Nom court d’un ou plusieurs fournisseurs de capacité à associer au cluster. Un fournisseur de capacité doit être associé à un cluster avant de pouvoir être inclus dans le cadre de la stratégie de fournisseur de capacité par défaut du cluster ou utilisé dans une stratégie de fournisseur de capacité lors de l’appel de l'CreateService ou Actions RunTask. Si vous spécifiez un fournisseur de capacité qui utilise un groupe de mise à l’échelle automatique, le fournisseur de capacité doit être créé, mais pas associé à un autre cluster. Vous pouvez créer de nouveaux fournisseurs de capacité de groupe de mise à l’échelle automatique avec l’opération d’API CreateCapacityProvider. Pour utiliser un fournisseur de capacité FARGATElong, spécifiez les fournisseurs de capacité `FARGATE` ou `FARGATE_SPOT`. Les fournisseurs de capacité FARGATElong sont disponibles pour tous les comptes et doivent uniquement être associés à un cluster à utiliser. L’opération d’API PutCapacityProvider est utilisée pour mettre à jour la liste des fournisseurs de capacité disponibles pour un cluster une fois le cluster créé.	string[]
clusterName	Chaîne générée par l’utilisateur que vous utilisez pour identifier votre cluster. Si vous ne spécifiez pas de nom, CFNlong génère un ID physique unique pour le nom.	corde
clusterSettings	Paramètres à utiliser lors de la création d’un cluster. Ce paramètre est utilisé pour activer CloudWatch Container Insights pour un cluster.	ClusterSettings[]
configuration	Configuration de commande d’exécution pour le cluster. Configuration de commande d’exécution pour le cluster.	ClusterConfiguration
defaultCapacityProviderStrategy	Stratégie de fournisseur de capacité par défaut pour le cluster. Lorsque des services ou des tâches sont exécutés dans le cluster sans type de lancement ni stratégie de fournisseur de capacité spécifiée, la stratégie de fournisseur de capacité par défaut est utilisée.	CapacityProviderStrategyItem[]
serviceConnectDefaults	Utilisez ce paramètre pour définir un espace de noms Service Connect par défaut. Après avoir défini un espace de noms Service Connect par défaut, tous les nouveaux services avec Service Connect activés qui sont créés dans le cluster sont ajoutés en tant que services clients dans l’espace de noms. Ce paramètre s’applique uniquement aux nouveaux services qui définissent le paramètre `enabled` sur `true` dans le `ServiceConnectConfiguration`. Vous pouvez définir l’espace de noms de chaque service individuellement dans le `ServiceConnectConfiguration` pour remplacer ce paramètre par défaut. Les tâches qui s’exécutent dans un espace de noms peuvent utiliser des noms courts pour se connecter aux services de l’espace de noms. Les tâches peuvent se connecter aux services sur tous les clusters de l’espace de noms. Les tâches se connectent via un conteneur proxy managé qui collecte les journaux et les métriques pour une visibilité accrue. Seules les tâches créées par Amazon ECS services sont prises en charge avec Service Connect. Pour plus d’informations, consultez Service Connect dans le guide du développeur Amazon Elastic Container Service. Utilisez ce paramètre pour définir un espace de noms Service Connect par défaut. Après avoir défini un espace de noms Service Connect par défaut, tous les nouveaux services avec Service Connect activés qui sont créés dans le cluster sont ajoutés en tant que services clients dans l’espace de noms. Ce paramètre s’applique uniquement aux nouveaux services qui définissent le paramètre `enabled` sur `true` dans le `ServiceConnectConfiguration`. Vous pouvez définir l’espace de noms de chaque service individuellement dans le `ServiceConnectConfiguration` pour remplacer ce paramètre par défaut. Les tâches qui s’exécutent dans un espace de noms peuvent utiliser des noms courts pour se connecter aux services de l’espace de noms. Les tâches peuvent se connecter aux services sur tous les clusters de l’espace de noms. Les tâches se connectent via un conteneur proxy managé qui collecte les journaux et les métriques pour une visibilité accrue. Seules les tâches créées par Amazon ECS services sont prises en charge avec Service Connect. Pour plus d’informations, consultez Service Connect dans le guide du développeur Amazon Elastic Container Service.	ServiceConnectDefaults
étiquettes	Métadonnées que vous appliquez au cluster pour vous aider à les classer et à les organiser. Chaque balise se compose d’une clé et d’une valeur facultative. Vous définissez les deux. Les restrictions de base suivantes s’appliquent aux balises : + Nombre maximal d’étiquettes par ressource - 50 + Pour chaque ressource, chaque clé de balise doit être unique et chaque clé de balise ne peut avoir qu’une seule valeur. + Longueur maximale de clé - 128 caractères Unicode dans UTF-8 + Longueur maximale de valeur - 256 caractères Unicode dans UTF-8 + Si votre schéma de balisage est utilisé sur plusieurs services et ressources, n’oubliez pas que d’autres services peuvent avoir des restrictions sur les caractères autorisés. Les caractères généralement autorisés sont les suivants : lettres, chiffres et espaces représentés dans UTF-8, et les caractères suivants : + - = . _ : / @. + Les clés et valeurs d’étiquette respectent la casse. + N’utilisez pas `aws:`, `AWS:`, ou toute combinaison majuscule ou minuscule de type préfixe pour les clés ou les valeurs, car elle est réservée à l’utilisation d’AWS. Vous ne pouvez pas modifier ou supprimer des clés ou des valeurs de balise avec ce préfixe. Les balises avec ce préfixe ne sont pas comptabilisées par rapport à vos balises par limite de ressources.	TagAutoGenerated25[]

CapacityProviderStrategyItem

Nom	Description	Valeur
base	La valeur base désigne le nombre de tâches, au minimum, à exécuter sur le fournisseur de capacité spécifié. Un seul fournisseur de capacité dans une stratégie de fournisseur de capacité peut avoir un base défini. Si aucune valeur n’est spécifiée, la valeur par défaut de `0` est utilisée.	Int
capacityProvider	Nom court du fournisseur de capacité.	corde
poids	La valeur pondération désigne le pourcentage relatif du nombre total de tâches lancées qui doivent utiliser le fournisseur de capacité spécifié. La valeur `weight` est prise en compte après la valeur `base`, si elle est définie, est satisfaite. Si aucune valeur `weight` n’est spécifiée, la valeur par défaut de `0` est utilisée. Lorsque plusieurs fournisseurs de capacité sont spécifiés dans une stratégie de fournisseur de capacité, au moins un des fournisseurs de capacité doit avoir une valeur de pondération supérieure à zéro et tous les fournisseurs de capacité avec un poids de `0` ne peuvent pas être utilisés pour placer des tâches. Si vous spécifiez plusieurs fournisseurs de capacité dans une stratégie qui ont tous un poids de `0`, toutes les actions `RunTask` ou `CreateService` à l’aide de la stratégie de fournisseur de capacité échouent. Un exemple de scénario d’utilisation des pondérations consiste à définir une stratégie qui contient deux fournisseurs de capacité et qui ont tous deux un poids de `1`, puis lorsque le `base` est satisfait, les tâches seront réparties uniformément entre les deux fournisseurs de capacité. En utilisant cette même logique, si vous spécifiez un poids de `1` pour capacityProviderA et un poids de `4` pour capacityProviderB, puis pour chaque tâche exécutée à l’aide de capacityProviderA, quatre tâches utiliseraient capacityProviderB.	Int

ClusterConfiguration

Nom	Description	Valeur
executeCommandConfiguration	Détails de la configuration de commande d’exécution. Détails de la configuration de commande d’exécution.	ExecuteCommandConfiguration

ClusterSettings

Nom	Description	Valeur
nom	Nom du paramètre de cluster. La valeur est `containerInsights` .	corde
valeur	Valeur à définir pour le paramètre de cluster. Les valeurs prises en charge sont `enabled` et `disabled`. Si vous définissez `name` sur `containerInsights` et `value` sur `enabled`, CloudWatch Container Insights est activé pour le cluster ; sinon, il est désactivé, sauf si le paramètre de compte `containerInsights` est activé. Si une valeur de cluster est spécifiée, elle remplace la valeur `containerInsights` définie par PutAccountSetting ou PutAccountSettingDefault.	corde

EcsClusterProperties

Nom	Description	Valeur
arn	Nom de la ressource Amazon (ARN)	corde
awsAccountId	ID de compte AWS	corde
awsProperties	Propriétés AWS	AwsEcsClusterProperties
awsRegion	Région AWS	corde
awsSourceSchema	Schéma source AWS	corde
awsTags	Balises AWS	EcsClusterPropertiesAwsTags
publicCloudConnectorsResourceId	ID de ressource des connecteurs cloud public	corde
publicCloudResourceName	Nom de la ressource cloud public	corde

EcsClusterPropertiesAwsTags

Nom	Description	Valeur

ExecuteCommandConfiguration

Nom	Description	Valeur
kmsKeyId	Spécifiez un ID de clé KMSlong pour chiffrer les données entre le client local et le conteneur.	corde
logConfiguration	Configuration du journal pour les résultats des actions de commande d’exécution. Les journaux peuvent être envoyés à CloudWatch Logs ou à un compartiment Amazon S3. Lorsque `logging=OVERRIDE` est spécifié, un `logConfiguration` doit être fourni. Configuration du journal pour les résultats des actions de commande d’exécution. Les journaux peuvent être envoyés à CloudWatch Logs ou à un compartiment Amazon S3.	executeCommandLogConfiguration
exploitation forestière	Paramètre de journal à utiliser pour rediriger les journaux pour vos résultats de commande d’exécution. Les paramètres de journal suivants sont disponibles. + `NONE`: la session de commande d’exécution n’est pas journalisée. + `DEFAULT`: la configuration `awslogs` dans la définition de tâche est utilisée. Si aucun paramètre de journalisation n’est spécifié, il est défini par défaut sur cette valeur. Si aucun `awslogs` pilote de journal n’est configuré dans la définition de tâche, la sortie n’est pas journalisée. + `OVERRIDE`: spécifiez les détails de journalisation dans le cadre de `logConfiguration`. Si l’option de journalisation `OVERRIDE` est spécifiée, la `logConfiguration` est requise.	corde

ExecuteCommandLogConfiguration

Nom	Description	Valeur
cloudWatchEncryptionEnabled	Détermine s’il faut utiliser le chiffrement sur les journaux CloudWatch. S’il n’est pas spécifié, le chiffrement est désactivé.	Bool
cloudWatchLogGroupName	Nom du groupe de journaux CloudWatch auquel envoyer des journaux. Le groupe de journaux CloudWatch doit déjà être créé.	corde
s3BucketName	Nom du compartiment S3 à laquelle envoyer des journaux. Le compartiment S3 doit déjà être créé.	corde
s3EncryptionEnabled	Détermine s’il faut utiliser le chiffrement sur les journaux S3. S’il n’est pas spécifié, le chiffrement n’est pas utilisé.	Bool
s3KeyPrefix	Dossier facultatif dans le compartiment S3 dans lequel placer les journaux d’activité.	corde

Microsoft.AwsConnector/ecsClusters

Nom	Description	Valeur
emplacement	Emplacement géographique où réside la ressource	chaîne (obligatoire)
nom	Nom de la ressource	corde Contraintes: Modèle = `^(?=.{0,259}[^\s.]$)(?!.*[<>%&\?/#])` (obligatoire)
Propriétés	Propriétés spécifiques à la ressource pour cette ressource.	EcsClusterProperties
étiquettes	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes.
type	Type de ressource	« Microsoft.AwsConnector/ecsClusters@2024-12-01 »

ServiceConnectDefaults

Nom	Description	Valeur
Namespace	Nom d’espace de noms ou nom de ressource Amazon complet (ARN) de l’espace de noms CMAPlong utilisé lorsque vous créez un service et ne spécifiez pas de configuration Service Connect. Le nom de l’espace de noms peut inclure jusqu’à 1 024 caractères. Le nom respecte la casse. Le nom ne peut pas inclure de traits d’union (-), tilde (~), supérieur à (>), inférieur à (<) ou barre oblique (/). Si vous entrez un nom d’espace de noms existant ou UN ARN, cet espace de noms sera utilisé. Tout type d’espace de noms est pris en charge. L’espace de noms doit se trouver dans ce compte et dans cette région AWS. Si vous entrez un nouveau nom, un espace de noms CMAPlong est créé. Amazon ECS crée un espace de noms CMAP avec la méthode « Appels d’API » de découverte d’instances uniquement. Cette méthode de découverte d’instance est le type d’espace de noms « HTTP » dans le CLIlong. D’autres types de découverte d’instances ne sont pas utilisés par Service Connect. Si vous mettez à jour le cluster avec une chaîne vide `''` pour le nom de l’espace de noms, la configuration du cluster pour Service Connect est supprimée. Notez que l’espace de noms reste dans CMAP et doit être supprimé séparément. Pour plus d’informations sur CMAPlong, consultez Working with Services dans le guide du développeur .	corde

TagAutoGenerated25

Nom	Description	Valeur
clé	Une partie d’une paire clé-valeur qui compose une balise. Un `key` est une étiquette générale qui agit comme une catégorie pour des valeurs d’étiquette plus spécifiques.	corde
valeur	Partie facultative d’une paire clé-valeur qui compose une balise. Un `value` agit en tant que descripteur au sein d’une catégorie de balise (clé).	corde

TrackedResourceTags

Nom	Description	Valeur

Partager via

Microsoft.AwsConnector ecsClusters 2024-12-01

Définition de ressource Bicep

Format de ressource

Valeurs de la propriété

AwsEcsClusterProperties

CapacityProviderStrategyItem

ClusterConfiguration

ClusterSettings

EcsClusterProperties

EcsClusterPropertiesAwsTags

ExecuteCommandConfiguration

ExecuteCommandLogConfiguration

Microsoft.AwsConnector/ecsClusters

ServiceConnectDefaults

TagAutoGenerated25

TrackedResourceTags

Définition de ressource de modèle ARM

Format de ressource

Valeurs de la propriété

AwsEcsClusterProperties

CapacityProviderStrategyItem

ClusterConfiguration

ClusterSettings

EcsClusterProperties

EcsClusterPropertiesAwsTags

ExecuteCommandConfiguration

ExecuteCommandLogConfiguration

Microsoft.AwsConnector/ecsClusters

ServiceConnectDefaults

TagAutoGenerated25

TrackedResourceTags

Exemples d’utilisation

Définition de ressource Terraform (fournisseur AzAPI)

Format de ressource

Valeurs de la propriété

AwsEcsClusterProperties

CapacityProviderStrategyItem

ClusterConfiguration

ClusterSettings

EcsClusterProperties

EcsClusterPropertiesAwsTags

ExecuteCommandConfiguration

ExecuteCommandLogConfiguration

Microsoft.AwsConnector/ecsClusters

ServiceConnectDefaults

TagAutoGenerated25

TrackedResourceTags

Commentaires

Ressources supplémentaires