Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# AWS Glue API
<a name="aws-glue-api"></a>

Cette section décrit les types de données et les primitives utilisés par AWS Glue SDKs et Tools. Il existe trois méthodes générales d'interaction AWS Glue programmatique en dehors du AWS Management Console, chacune avec sa propre documentation : 
+  Les bibliothèques SDK linguistiques vous permettent d'accéder aux ressources AWS provenant de langages de programmation courants. Pour plus d'informations, consultez [Outils pour créer sur AWS](https://aws.amazon.com/tools/). 
+  Vous AWS CLI permet d'accéder aux AWS ressources depuis la ligne de commande. Pour plus d'informations, consultez [Référence des commandes AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/). 
+  CloudFormation vous permet de définir un ensemble de AWS ressources à provisionner ensemble de manière cohérente. Pour plus d'informations, consultez [CloudFormation: référence AWS Glue des types de ressources](https://docs.aws.amazon.com/en_us/AWSCloudFormation/latest/UserGuide/AWS_Glue.html). 

 Cette section documente les primitives partagées indépendamment de celles-ci SDKs et des outils. Les outils utilisent le [AWS Glue Web API Reference](https://docs.aws.amazon.com/glue/latest/webapi/WebAPI_Welcome.html) pour communiquer avec AWS. 

**Contents**
+ [Sécurité APIs dans AWS Glue](aws-glue-api-jobs-security.md)
  + [Types de données](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-objects)
  + [DataCatalogEncryptionSettings structure](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-DataCatalogEncryptionSettings)
  + [EncryptionAtRest structure](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-EncryptionAtRest)
  + [ConnectionPasswordEncryption structure](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-ConnectionPasswordEncryption)
  + [EncryptionConfiguration structure](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-EncryptionConfiguration)
  + [Structure S3Encryption](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-S3Encryption)
  + [CloudWatchEncryption structure](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-CloudWatchEncryption)
  + [JobBookmarksEncryption structure](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-JobBookmarksEncryption)
  + [SecurityConfiguration structure](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-SecurityConfiguration)
  + [GluePolicy structure](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-GluePolicy)
  + [DataQualityEncryption structure](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-DataQualityEncryption)
  + [Opérations](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-actions)
  + [GetDataCatalogEncryptionSettings action (Python : get\$1data\$1catalog\$1encryption\$1settings)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-GetDataCatalogEncryptionSettings)
  + [PutDataCatalogEncryptionSettings action (Python : put\$1data\$1catalog\$1encryption\$1settings)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-PutDataCatalogEncryptionSettings)
  + [PutResourcePolicy action (Python : put\$1resource\$1policy)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-PutResourcePolicy)
  + [GetResourcePolicy action (Python : get\$1resource\$1policy)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-GetResourcePolicy)
  + [DeleteResourcePolicy action (Python : delete\$1resource\$1policy)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-DeleteResourcePolicy)
  + [CreateSecurityConfiguration action (Python : create\$1security\$1configuration)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-CreateSecurityConfiguration)
  + [DeleteSecurityConfiguration action (Python : delete\$1security\$1configuration)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-DeleteSecurityConfiguration)
  + [GetSecurityConfiguration action (Python : get\$1security\$1configuration)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-GetSecurityConfiguration)
  + [GetSecurityConfigurations action (Python : get\$1security\$1configurations)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-GetSecurityConfigurations)
  + [GetResourcePolicies action (Python : get\$1resource\$1policies)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-GetResourcePolicies)
+ [API des objets du catalogue](aws-glue-api-catalog.md)
  + [API de catalogues](aws-glue-api-catalog-catalogs.md)
    + [Types de données](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-objects)
    + [Structure du catalogue](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-Catalog)
    + [CatalogInput structure](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-CatalogInput)
    + [TargetRedshiftCatalog structure](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-TargetRedshiftCatalog)
    + [CatalogProperties structure](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-CatalogProperties)
    + [CatalogPropertiesOutput structure](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-CatalogPropertiesOutput)
    + [DataLakeAccessProperties structure](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-DataLakeAccessProperties)
    + [IcebergOptimizationProperties structure](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-IcebergOptimizationProperties)
    + [DataLakeAccessPropertiesOutput structure](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-DataLakeAccessPropertiesOutput)
    + [IcebergOptimizationPropertiesOutput structure](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-IcebergOptimizationPropertiesOutput)
    + [FederatedCatalog structure](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-FederatedCatalog)
    + [Opérations](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-actions)
    + [CreateCatalog action (Python : create\$1catalog)](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-CreateCatalog)
    + [UpdateCatalog action (Python : update\$1catalog)](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-UpdateCatalog)
    + [DeleteCatalog action (Python : supprimer\$1catalogue)](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-DeleteCatalog)
    + [GetCatalog action (Python : get\$1catalog)](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-GetCatalog)
    + [GetCatalogs action (Python : get\$1catalogs)](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-GetCatalogs)
  + [API d'une base de données](aws-glue-api-catalog-databases.md)
    + [Types de données](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-objects)
    + [Structure Database](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-Database)
    + [DatabaseInput structure](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-DatabaseInput)
    + [PrincipalPermissions structure](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions)
    + [DataLakePrincipal structure](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-DataLakePrincipal)
    + [DatabaseIdentifier structure](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-DatabaseIdentifier)
    + [FederatedDatabase structure](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-FederatedDatabase)
    + [Opérations](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-actions)
    + [CreateDatabase action (Python : créer\$1base de données)](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-CreateDatabase)
    + [UpdateDatabase action (Python : update\$1database)](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-UpdateDatabase)
    + [DeleteDatabase action (Python : supprimer\$1base de données)](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-DeleteDatabase)
    + [GetDatabase action (Python : get\$1database)](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-GetDatabase)
    + [GetDatabases action (Python : get\$1databases)](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-GetDatabases)
  + [API de table](aws-glue-api-catalog-tables.md)
    + [Types de données](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-objects)
    + [Structure de table](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-Table)
    + [TableInput structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-TableInput)
    + [FederatedTable structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-FederatedTable)
    + [Structure de colonne](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-Column)
    + [StorageDescriptor structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-StorageDescriptor)
    + [SchemaReference structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-SchemaReference)
    + [SerDeInfo structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-SerDeInfo)
    + [Structure de tri](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-Order)
    + [SkewedInfo structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-SkewedInfo)
    + [TableVersion structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-TableVersion)
    + [TableError structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-TableError)
    + [TableVersionError structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-TableVersionError)
    + [SortCriterion structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-SortCriterion)
    + [TableIdentifier structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-TableIdentifier)
    + [KeySchemaElement structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-KeySchemaElement)
    + [PartitionIndex structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-PartitionIndex)
    + [PartitionIndexDescriptor structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-PartitionIndexDescriptor)
    + [BackfillError structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-BackfillError)
    + [IcebergInput structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-IcebergInput)
    + [OpenTableFormatInput structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-OpenTableFormatInput)
    + [ViewDefinition structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-ViewDefinition)
    + [ViewDefinitionInput structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-ViewDefinitionInput)
    + [ViewRepresentation structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-ViewRepresentation)
    + [ViewRepresentationInput structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-ViewRepresentationInput)
    + [UpdateOpenTableFormatInput structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-UpdateOpenTableFormatInput)
    + [UpdateIcebergInput structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-UpdateIcebergInput)
    + [CreateIcebergTableInput structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-CreateIcebergTableInput)
    + [UpdateIcebergTableInput structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-UpdateIcebergTableInput)
    + [IcebergSortOrder structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-IcebergSortOrder)
    + [IcebergSortField structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-IcebergSortField)
    + [IcebergPartitionSpec structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-IcebergPartitionSpec)
    + [IcebergPartitionField structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-IcebergPartitionField)
    + [IcebergSchema structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-IcebergSchema)
    + [IcebergStructField structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-IcebergStructField)
    + [IcebergTableUpdate structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-IcebergTableUpdate)
    + [AuditContext structure](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-AuditContext)
    + [Opérations](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-actions)
    + [CreateTable action (Python : créer\$1table)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-CreateTable)
    + [UpdateTable action (Python : update\$1table)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-UpdateTable)
    + [DeleteTable action (Python : supprimer\$1table)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-DeleteTable)
    + [BatchDeleteTable action (Python : batch\$1delete\$1table)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-BatchDeleteTable)
    + [GetTable action (Python : get\$1table)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-GetTable)
    + [GetTables action (Python : get\$1tables)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-GetTables)
    + [GetTableVersion action (Python : get\$1table\$1version)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-GetTableVersion)
    + [GetTableVersions action (Python : get\$1table\$1versions)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-GetTableVersions)
    + [DeleteTableVersion action (Python : supprimer\$1table\$1version)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-DeleteTableVersion)
    + [BatchDeleteTableVersion action (Python : batch\$1delete\$1table\$1version)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-BatchDeleteTableVersion)
    + [SearchTables action (Python : tables de recherche)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-SearchTables)
    + [GetPartitionIndexes action (Python : get\$1partition\$1indexes)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-GetPartitionIndexes)
    + [CreatePartitionIndex action (Python : create\$1partition\$1index)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-CreatePartitionIndex)
    + [DeletePartitionIndex action (Python : delete\$1partition\$1index)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-DeletePartitionIndex)
    + [GetColumnStatisticsForTable action (Python : get\$1column\$1statistics\$1for\$1table)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-GetColumnStatisticsForTable)
    + [UpdateColumnStatisticsForTable action (Python : update\$1column\$1statistics\$1for\$1table)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-UpdateColumnStatisticsForTable)
    + [DeleteColumnStatisticsForTable action (Python : delete\$1column\$1statistics\$1for\$1table)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-DeleteColumnStatisticsForTable)
  + [API de partition](aws-glue-api-catalog-partitions.md)
    + [Types de données](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-objects)
    + [Structure de partition](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-Partition)
    + [PartitionInput structure](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionInput)
    + [PartitionSpecWithSharedStorageDescriptor structure](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor)
    + [PartitionListComposingSpec structure](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionListComposingSpec)
    + [PartitionSpecProxy structure](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionSpecProxy)
    + [PartitionValueList structure](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionValueList)
    + [Structure d'un segment](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-Segment)
    + [PartitionError structure](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionError)
    + [BatchUpdatePartitionFailureEntry structure](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry)
    + [BatchUpdatePartitionRequestEntry structure](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry)
    + [StorageDescriptor structure](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-StorageDescriptor)
    + [SchemaReference structure](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SchemaReference)
    + [SerDeInfo structure](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SerDeInfo)
    + [SkewedInfo structure](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SkewedInfo)
    + [Opérations](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-actions)
    + [CreatePartition action (Python : créer\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-CreatePartition)
    + [BatchCreatePartition action (Python : batch\$1create\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-BatchCreatePartition)
    + [UpdatePartition action (Python : update\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-UpdatePartition)
    + [DeletePartition action (Python : supprimer\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-DeletePartition)
    + [BatchDeletePartition action (Python : batch\$1supprimer\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-BatchDeletePartition)
    + [GetPartition action (Python : get\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-GetPartition)
    + [GetPartitions action (Python : get\$1partitions)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-GetPartitions)
    + [BatchGetPartition action (Python : batch\$1get\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-BatchGetPartition)
    + [BatchUpdatePartition action (Python : batch\$1update\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-BatchUpdatePartition)
    + [GetColumnStatisticsForPartition action (Python : get\$1column\$1statistics\$1for\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-GetColumnStatisticsForPartition)
    + [UpdateColumnStatisticsForPartition action (Python : update\$1column\$1statistics\$1for\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-UpdateColumnStatisticsForPartition)
    + [DeleteColumnStatisticsForPartition action (Python : supprimer\$1column\$1statistics\$1for\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-DeleteColumnStatisticsForPartition)
  + [API de connexions](aws-glue-api-catalog-connections.md)
    + [API de connexion](aws-glue-api-catalog-connections-connections.md)
      + [Types de données](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-objects)
      + [Structure de connexion](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-Connection)
      + [ConnectionInput structure](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-ConnectionInput)
      + [TestConnectionInput structure](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-TestConnectionInput)
      + [PhysicalConnectionRequirements structure](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements)
      + [GetConnectionsFilter structure](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-GetConnectionsFilter)
      + [AuthenticationConfiguration structure](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-AuthenticationConfiguration)
      + [AuthenticationConfigurationInput structure](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput)
      + [OAuth2Structure des propriétés](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-OAuth2Properties)
      + [OAuth2PropertiesInput structure](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput)
      + [OAuth2ClientApplication structure](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication)
      + [AuthorizationCodeProperties structure](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-AuthorizationCodeProperties)
      + [BasicAuthenticationCredentials structure](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-BasicAuthenticationCredentials)
      + [OAuth2Structure des informations d'identification](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-OAuth2Credentials)
      + [Opérations](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-actions)
      + [CreateConnection action (Python : créer\$1connexion)](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-CreateConnection)
      + [DeleteConnection action (Python : supprimer\$1connexion)](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-DeleteConnection)
      + [GetConnection action (Python : get\$1connection)](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-GetConnection)
      + [GetConnections action (Python : get\$1connections)](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-GetConnections)
      + [UpdateConnection action (Python : update\$1connection)](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-UpdateConnection)
      + [TestConnection action (Python : test\$1connection)](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-TestConnection)
      + [BatchDeleteConnection action (Python : batch\$1delete\$1connection)](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-BatchDeleteConnection)
    + [API de types de connexion](aws-glue-api-catalog-connections-connections-type.md)
      + [Gestion des connexions APIs](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-connection-management)
      + [DescribeConnectionType action (Python : describe\$1connection\$1type)](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-DescribeConnectionType)
      + [ListConnectionTypes action (Python : list\$1connection\$1types)](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-ListConnectionTypes)
      + [ConnectionTypeBrief structure](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief)
      + [ConnectionTypeVariant structure](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant)
      + [types de données](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-connection-types)
      + [Structure de validation](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-Validation)
      + [AuthConfiguration structure](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-AuthConfiguration)
      + [Structure des fonctionnalités](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-Capabilities)
      + [Structure de la propriété](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-Property)
      + [AllowedValue structure](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-AllowedValue)
      + [ComputeEnvironmentConfiguration structure](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration)
    + [Métadonnées de connexion et API de prévisualisation](aws-glue-api-catalog-connections-connections-metadata.md)
      + [Types de données](aws-glue-api-catalog-connections-connections-metadata.md#aws-glue-api-catalog-connections-connections-metadata-objects)
      + [Structure de l’entité](aws-glue-api-catalog-connections-connections-metadata.md#aws-glue-api-catalog-connections-connections-metadata-Entity)
      + [Structure de champ](aws-glue-api-catalog-connections-connections-metadata.md#aws-glue-api-catalog-connections-connections-metadata-Field)
      + [Opérations](aws-glue-api-catalog-connections-connections-metadata.md#aws-glue-api-catalog-connections-connections-metadata-actions)
      + [ListEntities action (Python : list\$1entities)](aws-glue-api-catalog-connections-connections-metadata.md#aws-glue-api-catalog-connections-connections-metadata-ListEntities)
      + [DescribeEntity action (Python : describe\$1entity)](aws-glue-api-catalog-connections-connections-metadata.md#aws-glue-api-catalog-connections-connections-metadata-DescribeEntity)
      + [GetEntityRecords action (Python : get\$1entity\$1records)](aws-glue-api-catalog-connections-connections-metadata.md#aws-glue-api-catalog-connections-connections-metadata-GetEntityRecords)
  + [API de fonction définie par l'utilisateur](aws-glue-api-catalog-functions.md)
    + [Types de données](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-objects)
    + [UserDefinedFunction structure](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-UserDefinedFunction)
    + [UserDefinedFunctionInput structure](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-UserDefinedFunctionInput)
    + [Opérations](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-actions)
    + [CreateUserDefinedFunction action (Python : create\$1user\$1defined\$1function)](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-CreateUserDefinedFunction)
    + [UpdateUserDefinedFunction action (Python : update\$1user\$1defined\$1function)](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-UpdateUserDefinedFunction)
    + [DeleteUserDefinedFunction action (Python : delete\$1user\$1defined\$1function)](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-DeleteUserDefinedFunction)
    + [GetUserDefinedFunction action (Python : get\$1user\$1defined\$1function)](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-GetUserDefinedFunction)
    + [GetUserDefinedFunctions action (Python : get\$1user\$1defined\$1functions)](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-GetUserDefinedFunctions)
  + [Importation d'un Athena catalogue dans AWS Glue](aws-glue-api-catalog-migration.md)
    + [Types de données](aws-glue-api-catalog-migration.md#aws-glue-api-catalog-migration-objects)
    + [CatalogImportStatus structure](aws-glue-api-catalog-migration.md#aws-glue-api-catalog-migration-CatalogImportStatus)
    + [Opérations](aws-glue-api-catalog-migration.md#aws-glue-api-catalog-migration-actions)
    + [ImportCatalogToGlue action (Python : import\$1catalog\$1to\$1glue)](aws-glue-api-catalog-migration.md#aws-glue-api-catalog-migration-ImportCatalogToGlue)
    + [GetCatalogImportStatus action (Python : get\$1catalog\$1import\$1status)](aws-glue-api-catalog-migration.md#aws-glue-api-catalog-migration-GetCatalogImportStatus)
+ [API d'optimiseur de table](aws-glue-api-table-optimizers.md)
  + [Types de données](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-objects)
  + [TableOptimizer structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-TableOptimizer)
  + [TableOptimizerConfiguration structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-TableOptimizerConfiguration)
  + [TableOptimizerVpcConfiguration structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-TableOptimizerVpcConfiguration)
  + [CompactionConfiguration structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-CompactionConfiguration)
  + [IcebergCompactionConfiguration structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-IcebergCompactionConfiguration)
  + [TableOptimizerRun structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-TableOptimizerRun)
  + [BatchGetTableOptimizerEntry structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-BatchGetTableOptimizerEntry)
  + [BatchTableOptimizer structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-BatchTableOptimizer)
  + [BatchGetTableOptimizerError structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-BatchGetTableOptimizerError)
  + [RetentionConfiguration structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-RetentionConfiguration)
  + [IcebergRetentionConfiguration structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-IcebergRetentionConfiguration)
  + [OrphanFileDeletionConfiguration structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-OrphanFileDeletionConfiguration)
  + [IcebergOrphanFileDeletionConfiguration structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionConfiguration)
  + [CompactionMetrics structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-CompactionMetrics)
  + [RetentionMetrics structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-RetentionMetrics)
  + [OrphanFileDeletionMetrics structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-OrphanFileDeletionMetrics)
  + [IcebergCompactionMetrics structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-IcebergCompactionMetrics)
  + [IcebergRetentionMetrics structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-IcebergRetentionMetrics)
  + [IcebergOrphanFileDeletionMetrics structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionMetrics)
  + [RunMetrics structure](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-RunMetrics)
  + [Opérations](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-actions)
  + [GetTableOptimizer action (Python : get\$1table\$1optimizer)](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-GetTableOptimizer)
  + [BatchGetTableOptimizer action (Python : batch\$1get\$1table\$1optimizer)](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-BatchGetTableOptimizer)
  + [ListTableOptimizerRuns action (Python : list\$1table\$1optimizer\$1runs)](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-ListTableOptimizerRuns)
  + [CreateTableOptimizer action (Python : create\$1table\$1optimizer)](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-CreateTableOptimizer)
  + [DeleteTableOptimizer action (Python : delete\$1table\$1optimizer)](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-DeleteTableOptimizer)
  + [UpdateTableOptimizer action (Python : update\$1table\$1optimizer)](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-UpdateTableOptimizer)
+ [API de classifieurs et d'crawlers](aws-glue-api-crawler.md)
  + [API du classifieur](aws-glue-api-crawler-classifiers.md)
    + [Types de données](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-objects)
    + [Structure du classifieur](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-Classifier)
    + [GrokClassifier structure](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-GrokClassifier)
    + [XMLClassifier structure](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-XMLClassifier)
    + [JsonClassifier structure](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-JsonClassifier)
    + [CsvClassifier structure](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-CsvClassifier)
    + [CreateGrokClassifierRequest structure](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-CreateGrokClassifierRequest)
    + [UpdateGrokClassifierRequest structure](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-UpdateGrokClassifierRequest)
    + [Créer une structure XMLClassifier de demande](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-CreateXMLClassifierRequest)
    + [Structure de XMLClassifier demande de mise à jour](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-UpdateXMLClassifierRequest)
    + [CreateJsonClassifierRequest structure](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-CreateJsonClassifierRequest)
    + [UpdateJsonClassifierRequest structure](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-UpdateJsonClassifierRequest)
    + [CreateCsvClassifierRequest structure](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-CreateCsvClassifierRequest)
    + [UpdateCsvClassifierRequest structure](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-UpdateCsvClassifierRequest)
    + [Opérations](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-actions)
    + [CreateClassifier action (Python : create\$1classifier)](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-CreateClassifier)
    + [DeleteClassifier action (Python : delete\$1classifier)](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-DeleteClassifier)
    + [GetClassifier action (Python : get\$1classifier)](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-GetClassifier)
    + [GetClassifiers action (Python : get\$1classifiers)](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-GetClassifiers)
    + [UpdateClassifier action (Python : update\$1classifier)](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-UpdateClassifier)
  + [API du crawler](aws-glue-api-crawler-crawling.md)
    + [Types de données](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-objects)
    + [Structure du crawler](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-Crawler)
    + [Structure du planificateur](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-Schedule)
    + [CrawlerTargets structure](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-CrawlerTargets)
    + [Structure de la S3Target](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-S3Target)
    + [DeltaCatalogTarget Structure S3](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-S3DeltaCatalogTarget)
    + [DeltaDirectTarget Structure S3](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-S3DeltaDirectTarget)
    + [JdbcTarget structure](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-JdbcTarget)
    + [Structure Mongo DBTarget](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-MongoDBTarget)
    + [Structure de la dynamo DBTarget](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-DynamoDBTarget)
    + [DeltaTarget structure](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-DeltaTarget)
    + [IcebergTarget structure](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-IcebergTarget)
    + [HudiTarget structure](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-HudiTarget)
    + [CatalogTarget structure](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-CatalogTarget)
    + [CrawlerMetrics structure](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-CrawlerMetrics)
    + [CrawlerHistory structure](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-CrawlerHistory)
    + [CrawlsFilter structure](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-CrawlsFilter)
    + [SchemaChangePolicy structure](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-SchemaChangePolicy)
    + [LastCrawlInfo structure](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-LastCrawlInfo)
    + [RecrawlPolicy structure](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-RecrawlPolicy)
    + [LineageConfiguration structure](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-LineageConfiguration)
    + [LakeFormationConfiguration structure](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-LakeFormationConfiguration)
    + [Opérations](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-actions)
    + [CreateCrawler action (Python : create\$1crawler)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-CreateCrawler)
    + [DeleteCrawler action (Python : delete\$1crawler)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-DeleteCrawler)
    + [GetCrawler action (Python : get\$1crawler)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-GetCrawler)
    + [GetCrawlers action (Python : get\$1crawlers)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-GetCrawlers)
    + [GetCrawlerMetrics action (Python : get\$1crawler\$1metrics)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-GetCrawlerMetrics)
    + [UpdateCrawler action (Python : update\$1crawler)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-UpdateCrawler)
    + [StartCrawler action (Python : start\$1crawler)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-StartCrawler)
    + [StopCrawler action (Python : stop\$1crawler)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-StopCrawler)
    + [BatchGetCrawlers action (Python : batch\$1get\$1crawlers)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-BatchGetCrawlers)
    + [ListCrawlers action (Python : list\$1crawlers)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-ListCrawlers)
    + [ListCrawls action (Python : list\$1crawls)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-ListCrawls)
  + [API de statistiques de colonne](aws-glue-api-crawler-column-statistics.md)
    + [Types de données](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-objects)
    + [ColumnStatisticsTaskRun structure](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRun)
    + [ColumnStatisticsTaskSettings structure](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskSettings)
    + [ExecutionAttempt structure](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-ExecutionAttempt)
    + [Opérations](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-actions)
    + [StartColumnStatisticsTaskRun action (Python : start\$1column\$1statistics\$1task\$1run)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-StartColumnStatisticsTaskRun)
    + [GetColumnStatisticsTaskRun action (Python : get\$1column\$1statistics\$1task\$1run)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskRun)
    + [GetColumnStatisticsTaskRuns action (Python : get\$1column\$1statistics\$1task\$1runs)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskRuns)
    + [ListColumnStatisticsTaskRuns action (Python : list\$1column\$1statistics\$1task\$1runs)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-ListColumnStatisticsTaskRuns)
    + [StopColumnStatisticsTaskRun action (Python : stop\$1column\$1statistics\$1task\$1run)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-StopColumnStatisticsTaskRun)
    + [CreateColumnStatisticsTaskSettings action (Python : create\$1column\$1statistics\$1task\$1settings)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-CreateColumnStatisticsTaskSettings)
    + [UpdateColumnStatisticsTaskSettings action (Python : update\$1column\$1statistics\$1task\$1settings)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-UpdateColumnStatisticsTaskSettings)
    + [GetColumnStatisticsTaskSettings action (Python : get\$1column\$1statistics\$1task\$1settings)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskSettings)
    + [DeleteColumnStatisticsTaskSettings action (Python : delete\$1column\$1statistics\$1task\$1settings)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-DeleteColumnStatisticsTaskSettings)
    + [StartColumnStatisticsTaskRunSchedule action (Python : start\$1column\$1statistics\$1task\$1run\$1schedule)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-StartColumnStatisticsTaskRunSchedule)
    + [StopColumnStatisticsTaskRunSchedule action (Python : stop\$1column\$1statistics\$1task\$1run\$1schedule)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-StopColumnStatisticsTaskRunSchedule)
    + [Exceptions](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-exceptions)
    + [ColumnStatisticsTaskRunningException structure](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRunningException)
    + [ColumnStatisticsTaskNotRunningException structure](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskNotRunningException)
    + [ColumnStatisticsTaskStoppingException structure](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskStoppingException)
    + [ColumnStatisticsTaskAutoConcurrencyLimitException structure](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskAutoConcurrencyLimitException)
    + [InvalidCatalogSettingException structure](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-InvalidCatalogSettingException)
  + [API du planificateur du crawler](aws-glue-api-crawler-scheduler.md)
    + [Types de données](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-objects)
    + [Structure du planificateur](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-Schedule)
    + [Opérations](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-actions)
    + [UpdateCrawlerSchedule action (Python : update\$1crawler\$1schedule)](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-UpdateCrawlerSchedule)
    + [StartCrawlerSchedule action (Python : start\$1crawler\$1schedule)](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-StartCrawlerSchedule)
    + [StopCrawlerSchedule action (Python : stop\$1crawler\$1schedule)](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-StopCrawlerSchedule)
+ [Génération automatique d'API de scripts ETL](aws-glue-api-etl-script-generation.md)
  + [Types de données](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-objects)
  + [CodeGenNode structure](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-CodeGenNode)
  + [CodeGenNodeArg structure](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-CodeGenNodeArg)
  + [CodeGenEdge structure](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-CodeGenEdge)
  + [Structure de l'emplacement](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-Location)
  + [CatalogEntry structure](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-CatalogEntry)
  + [MappingEntry structure](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-MappingEntry)
  + [Opérations](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-actions)
  + [CreateScript action (Python : créer\$1script)](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-CreateScript)
  + [GetDataflowGraph action (Python : get\$1dataflow\$1graph)](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-GetDataflowGraph)
  + [GetMapping action (Python : get\$1mapping)](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-GetMapping)
  + [GetPlan action (Python : get\$1plan)](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-GetPlan)
+ [API Visual Job](aws-glue-api-visual-job-api.md)
  + [Types de données](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-objects)
  + [CodeGenConfigurationNode structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CodeGenConfigurationNode)
  + [JDBCConnectorStructure des options](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-JDBCConnectorOptions)
  + [StreamingDataPreviewOptions structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-StreamingDataPreviewOptions)
  + [AthenaConnectorSource structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AthenaConnectorSource)
  + [JDBCConnectorStructure de la source](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-JDBCConnectorSource)
  + [SparkConnectorSource structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SparkConnectorSource)
  + [CatalogSource structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CatalogSource)
  + [Structure SQLCatalog de ma source](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-MySQLCatalogSource)
  + [Structure de la SQLCatalog source Postgre](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-PostgreSQLCatalogSource)
  + [Structure d'Oracle SQLCatalog Source](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-OracleSQLCatalogSource)
  + [SQLServerCatalogSource Structure de Microsoft](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogSource)
  + [CatalogKinesisSource structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CatalogKinesisSource)
  + [DirectKinesisSource structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DirectKinesisSource)
  + [KinesisStreamingSourceOptions structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-KinesisStreamingSourceOptions)
  + [CatalogKafkaSource structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CatalogKafkaSource)
  + [DirectKafkaSource structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DirectKafkaSource)
  + [KafkaStreamingSourceOptions structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-KafkaStreamingSourceOptions)
  + [RedshiftSource structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-RedshiftSource)
  + [AmazonRedshiftSource structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AmazonRedshiftSource)
  + [AmazonRedshiftNodeData structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AmazonRedshiftNodeData)
  + [AmazonRedshiftAdvancedOption structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AmazonRedshiftAdvancedOption)
  + [Structure de l'option](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Option)
  + [CatalogSource Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3CatalogSource)
  + [SourceAdditionalOptions Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3SourceAdditionalOptions)
  + [CsvSource Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3CsvSource)
  + [JDBCSource Structure directe](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DirectJDBCSource)
  + [DirectSourceAdditionalOptions Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions)
  + [JsonSource Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3JsonSource)
  + [ParquetSource Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3ParquetSource)
  + [DeltaSource Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3DeltaSource)
  + [CatalogDeltaSource Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3CatalogDeltaSource)
  + [CatalogDeltaSource structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CatalogDeltaSource)
  + [HudiSource Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3HudiSource)
  + [CatalogHudiSource Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3CatalogHudiSource)
  + [ExcelSource Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3ExcelSource)
  + [CatalogHudiSource structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CatalogHudiSource)
  + [Structure de Dynamo DBCatalog Source](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DynamoDBCatalogSource)
  + [RelationalCatalogSource structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-RelationalCatalogSource)
  + [JDBCConnectorStructure de la cible](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-JDBCConnectorTarget)
  + [SparkConnectorTarget structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SparkConnectorTarget)
  + [BasicCatalogTarget structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-BasicCatalogTarget)
  + [Structure de My SQLCatalog Target](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-MySQLCatalogTarget)
  + [Structure de SQLCatalog PostgreTarget](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-PostgreSQLCatalogTarget)
  + [Structure d'Oracle SQLCatalog Target](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-OracleSQLCatalogTarget)
  + [SQLServerCatalogTarget Structure de Microsoft](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogTarget)
  + [RedshiftTarget structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-RedshiftTarget)
  + [AmazonRedshiftTarget structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AmazonRedshiftTarget)
  + [UpsertRedshiftTargetOptions structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-UpsertRedshiftTargetOptions)
  + [CatalogTarget Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3CatalogTarget)
  + [GlueParquetTarget Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3GlueParquetTarget)
  + [CatalogSchemaChangePolicy structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy)
  + [DirectTarget Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3DirectTarget)
  + [HudiCatalogTarget Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3HudiCatalogTarget)
  + [HudiDirectTarget Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3HudiDirectTarget)
  + [DeltaCatalogTarget Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3DeltaCatalogTarget)
  + [DeltaDirectTarget Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3DeltaDirectTarget)
  + [HyperDirectTarget Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3HyperDirectTarget)
  + [IcebergDirectTarget Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3IcebergDirectTarget)
  + [DirectSchemaChangePolicy structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DirectSchemaChangePolicy)
  + [ApplyMapping structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-ApplyMapping)
  + [Structure de mappage](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Mapping)
  + [SelectFields structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SelectFields)
  + [DropFields structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DropFields)
  + [RenameField structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-RenameField)
  + [Structure Spigot](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Spigot)
  + [Structure Join](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Join)
  + [JoinColumn structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-JoinColumn)
  + [SplitFields structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SplitFields)
  + [SelectFromCollection structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SelectFromCollection)
  + [FillMissingValues structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-FillMissingValues)
  + [Structure Filtre](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Filter)
  + [FilterExpression structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-FilterExpression)
  + [FilterValue structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-FilterValue)
  + [CustomCode structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CustomCode)
  + [Structure SparkSQL](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SparkSQL)
  + [SqlAlias structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SqlAlias)
  + [DropNullFields structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DropNullFields)
  + [NullCheckBoxList structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-NullCheckBoxList)
  + [NullValueField structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-NullValueField)
  + [Structure Datatype](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Datatype)
  + [Structure Fusion](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Merge)
  + [Structure Union](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Union)
  + [PIIDetection structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-PIIDetection)
  + [Structure Aggregate](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Aggregate)
  + [DropDuplicates structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DropDuplicates)
  + [GovernedCatalogTarget structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-GovernedCatalogTarget)
  + [GovernedCatalogSource structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-GovernedCatalogSource)
  + [AggregateOperation structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AggregateOperation)
  + [GlueSchema structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-GlueSchema)
  + [GlueStudioSchemaColumn structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-GlueStudioSchemaColumn)
  + [GlueStudioColumn structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-GlueStudioColumn)
  + [DynamicTransform structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DynamicTransform)
  + [TransformConfigParameter structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-TransformConfigParameter)
  + [EvaluateDataQuality structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-EvaluateDataQuality)
  + [DQResultsPublishingOptions structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DQResultsPublishingOptions)
  + [DQStopJobOnFailureOptions structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DQStopJobOnFailureOptions)
  + [EvaluateDataQualityMultiFrame structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-EvaluateDataQualityMultiFrame)
  + [Structure de la recette](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Recipe)
  + [RecipeReference structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-RecipeReference)
  + [SnowflakeNodeData structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SnowflakeNodeData)
  + [SnowflakeSource structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SnowflakeSource)
  + [SnowflakeTarget structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SnowflakeTarget)
  + [ConnectorDataSource structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-ConnectorDataSource)
  + [ConnectorDataTarget structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-ConnectorDataTarget)
  + [RecipeStep structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-RecipeStep)
  + [RecipeAction structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-RecipeAction)
  + [ConditionExpression structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-ConditionExpression)
  + [CatalogIcebergSource Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3CatalogIcebergSource)
  + [CatalogIcebergSource structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CatalogIcebergSource)
  + [IcebergCatalogTarget Structure S3](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3IcebergCatalogTarget)
  + [Structure de Dynamo DBELTConnector Source](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DynamoDBELTConnectorSource)
  + [DDBELTConnectionStructure des options](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DDBELTConnectionOptions)
  + [DDBELTCatalogAdditionalOptions structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DDBELTCatalogAdditionalOptions)
  + [Structure de route](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Route)
  + [GroupFilters structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-GroupFilters)
  + [AutoDataQuality structure](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AutoDataQuality)
+ [API de tâches](aws-glue-api-jobs.md)
  + [Tâches](aws-glue-api-jobs-job.md)
    + [Types de données](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-objects)
    + [Structure Job](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-Job)
    + [ExecutionProperty structure](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-ExecutionProperty)
    + [NotificationProperty structure](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-NotificationProperty)
    + [JobCommand structure](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-JobCommand)
    + [ConnectionsList structure](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-ConnectionsList)
    + [JobUpdate structure](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-JobUpdate)
    + [SourceControlDetails structure](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-SourceControlDetails)
    + [Opérations](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-actions)
    + [CreateJob action (Python : create\$1job)](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-CreateJob)
    + [UpdateJob action (Python : update\$1job)](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-UpdateJob)
    + [GetJob action (Python : get\$1job)](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-GetJob)
    + [GetJobs action (Python : get\$1jobs)](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-GetJobs)
    + [DeleteJob action (Python : supprimer\$1tâche)](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-DeleteJob)
    + [ListJobs action (Python : list\$1jobs)](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-ListJobs)
    + [BatchGetJobs action (Python : batch\$1get\$1jobs)](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-BatchGetJobs)
  + [Exécutions de tâches](aws-glue-api-jobs-runs.md)
    + [Types de données](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-objects)
    + [JobRun structure](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-JobRun)
    + [Structure de Predecessor](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-Predecessor)
    + [JobBookmarkEntry structure](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-JobBookmarkEntry)
    + [BatchStopJobRunSuccessfulSubmission structure](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-BatchStopJobRunSuccessfulSubmission)
    + [BatchStopJobRunError structure](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-BatchStopJobRunError)
    + [NotificationProperty structure](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-NotificationProperty)
    + [Opérations](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-actions)
    + [StartJobRun action (Python : start\$1job\$1run)](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-StartJobRun)
    + [BatchStopJobRun action (Python : batch\$1stop\$1job\$1run)](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-BatchStopJobRun)
    + [GetJobRun action (Python : get\$1job\$1run)](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-GetJobRun)
    + [GetJobRuns action (Python : get\$1job\$1runs)](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-GetJobRuns)
    + [GetJobBookmark action (Python : get\$1job\$1bookmark)](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-GetJobBookmark)
    + [GetJobBookmarks action (Python : get\$1job\$1bookmarks)](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-GetJobBookmarks)
    + [ResetJobBookmark action (Python : reset\$1job\$1bookmark)](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-ResetJobBookmark)
  + [Triggers](aws-glue-api-jobs-trigger.md)
    + [Types de données](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-objects)
    + [Structure Trigger](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-Trigger)
    + [TriggerUpdate structure](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-TriggerUpdate)
    + [Structure Predicate](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-Predicate)
    + [Structure Condition](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-Condition)
    + [Structure Action](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-Action)
    + [EventBatchingCondition structure](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-EventBatchingCondition)
    + [Opérations](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-actions)
    + [CreateTrigger action (Python : create\$1trigger)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-CreateTrigger)
    + [StartTrigger action (Python : start\$1trigger)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-StartTrigger)
    + [GetTrigger action (Python : get\$1trigger)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-GetTrigger)
    + [GetTriggers action (Python : get\$1triggers)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-GetTriggers)
    + [UpdateTrigger action (Python : update\$1trigger)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-UpdateTrigger)
    + [StopTrigger action (Python : stop\$1trigger)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-StopTrigger)
    + [DeleteTrigger action (Python : delete\$1trigger)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-DeleteTrigger)
    + [ListTriggers action (Python : list\$1triggers)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-ListTriggers)
    + [BatchGetTriggers action (Python : batch\$1get\$1triggers)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-BatchGetTriggers)
+ [Intégration APIs dans AWS Glue](aws-glue-api-integrations.md)
  + [Types de données](aws-glue-api-integrations.md#aws-glue-api-integrations-objects)
  + [Structure d’intégration](aws-glue-api-integrations.md#aws-glue-api-integrations-Integration)
  + [IntegrationConfig structure](aws-glue-api-integrations.md#aws-glue-api-integrations-IntegrationConfig)
  + [IntegrationPartition structure](aws-glue-api-integrations.md#aws-glue-api-integrations-IntegrationPartition)
  + [IntegrationError structure](aws-glue-api-integrations.md#aws-glue-api-integrations-IntegrationError)
  + [IntegrationFilter structure](aws-glue-api-integrations.md#aws-glue-api-integrations-IntegrationFilter)
  + [InboundIntegration structure](aws-glue-api-integrations.md#aws-glue-api-integrations-InboundIntegration)
  + [SourceProcessingProperties structure](aws-glue-api-integrations.md#aws-glue-api-integrations-SourceProcessingProperties)
  + [TargetProcessingProperties structure](aws-glue-api-integrations.md#aws-glue-api-integrations-TargetProcessingProperties)
  + [SourceTableConfig structure](aws-glue-api-integrations.md#aws-glue-api-integrations-SourceTableConfig)
  + [TargetTableConfig structure](aws-glue-api-integrations.md#aws-glue-api-integrations-TargetTableConfig)
  + [Opérations](aws-glue-api-integrations.md#aws-glue-api-integrations-actions)
  + [CreateIntegration action (Python : create\$1integration)](aws-glue-api-integrations.md#aws-glue-api-integrations-CreateIntegration)
  + [ModifyIntegration action (Python : modifier\$1intégration)](aws-glue-api-integrations.md#aws-glue-api-integrations-ModifyIntegration)
  + [DescribeIntegrations action (Python : describe\$1integrations)](aws-glue-api-integrations.md#aws-glue-api-integrations-DescribeIntegrations)
  + [DeleteIntegration action (Python : delete\$1integration)](aws-glue-api-integrations.md#aws-glue-api-integrations-DeleteIntegration)
  + [DescribeInboundIntegrations action (Python : describe\$1inbound\$1integrations)](aws-glue-api-integrations.md#aws-glue-api-integrations-DescribeInboundIntegrations)
  + [CreateIntegrationTableProperties action (Python : create\$1integration\$1table\$1properties)](aws-glue-api-integrations.md#aws-glue-api-integrations-CreateIntegrationTableProperties)
  + [UpdateIntegrationTableProperties action (Python : update\$1integration\$1table\$1properties)](aws-glue-api-integrations.md#aws-glue-api-integrations-UpdateIntegrationTableProperties)
  + [GetIntegrationTableProperties action (Python : get\$1integration\$1table\$1properties)](aws-glue-api-integrations.md#aws-glue-api-integrations-GetIntegrationTableProperties)
  + [DeleteIntegrationTableProperties action (Python : delete\$1integration\$1table\$1properties)](aws-glue-api-integrations.md#aws-glue-api-integrations-DeleteIntegrationTableProperties)
  + [CreateIntegrationResourceProperty action (Python : create\$1integration\$1resource\$1property)](aws-glue-api-integrations.md#aws-glue-api-integrations-CreateIntegrationResourceProperty)
  + [UpdateIntegrationResourceProperty action (Python : update\$1integration\$1resource\$1property)](aws-glue-api-integrations.md#aws-glue-api-integrations-UpdateIntegrationResourceProperty)
  + [GetIntegrationResourceProperty action (Python : get\$1integration\$1resource\$1property)](aws-glue-api-integrations.md#aws-glue-api-integrations-GetIntegrationResourceProperty)
  + [UntagResource action (Python : untag\$1resource)](aws-glue-api-integrations.md#aws-glue-api-integrations-UntagResource)
  + [ListTagsForResource action (Python : list\$1tags\$1for\$1resource)](aws-glue-api-integrations.md#aws-glue-api-integrations-ListTagsForResource)
  + [Exceptions](aws-glue-api-integrations.md#aws-glue-api-integrations-exceptions)
  + [ResourceNotFoundException structure](aws-glue-api-integrations.md#aws-glue-api-integrations-ResourceNotFoundException)
  + [InternalServerException structure](aws-glue-api-integrations.md#aws-glue-api-integrations-InternalServerException)
  + [IntegrationAlreadyExistsFault structure](aws-glue-api-integrations.md#aws-glue-api-integrations-IntegrationAlreadyExistsFault)
  + [IntegrationConflictOperationFault structure](aws-glue-api-integrations.md#aws-glue-api-integrations-IntegrationConflictOperationFault)
  + [IntegrationQuotaExceededFault structure](aws-glue-api-integrations.md#aws-glue-api-integrations-IntegrationQuotaExceededFault)
  + [KMSKeyNotAccessibleFault structure](aws-glue-api-integrations.md#aws-glue-api-integrations-KMSKeyNotAccessibleFault)
  + [IntegrationNotFoundFault structure](aws-glue-api-integrations.md#aws-glue-api-integrations-IntegrationNotFoundFault)
  + [TargetResourceNotFound structure](aws-glue-api-integrations.md#aws-glue-api-integrations-TargetResourceNotFound)
  + [InvalidIntegrationStateFault structure](aws-glue-api-integrations.md#aws-glue-api-integrations-InvalidIntegrationStateFault)
+ [Séances interactives API](aws-glue-api-interactive-sessions.md)
  + [Types de données](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-objects)
  + [Structure de séance](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-Session)
  + [SessionCommand structure](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-SessionCommand)
  + [Structure de la déclaration](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-Statement)
  + [StatementOutput structure](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-StatementOutput)
  + [StatementOutputData structure](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-StatementOutputData)
  + [ConnectionsList structure](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ConnectionsList)
  + [Opérations](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-actions)
  + [CreateSession action (Python : créer\$1session)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-CreateSession)
  + [StopSession action (Python : stop\$1session)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-StopSession)
  + [DeleteSession action (Python : supprimer\$1session)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-DeleteSession)
  + [GetSession action (Python : get\$1session)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-GetSession)
  + [ListSessions action (Python : list\$1sessions)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ListSessions)
  + [RunStatement action (Python : run\$1statement)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-RunStatement)
  + [CancelStatement action (Python : annuler\$1statement)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-CancelStatement)
  + [GetStatement action (Python : get\$1statement)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-GetStatement)
  + [ListStatements action (Python : list\$1statements)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ListStatements)
  + [GetGlueIdentityCenterConfiguration action (Python : get\$1glue\$1identity\$1center\$1configuration)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-GetGlueIdentityCenterConfiguration)
  + [UpdateGlueIdentityCenterConfiguration action (Python : update\$1glue\$1identity\$1center\$1configuration)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-UpdateGlueIdentityCenterConfiguration)
  + [CreateGlueIdentityCenterConfiguration action (Python : create\$1glue\$1identity\$1center\$1configuration)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-CreateGlueIdentityCenterConfiguration)
  + [DeleteGlueIdentityCenterConfiguration action (Python : delete\$1glue\$1identity\$1center\$1configuration)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-DeleteGlueIdentityCenterConfiguration)
+ [API de points de terminaison de développement](aws-glue-api-dev-endpoint.md)
  + [Types de données](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-objects)
  + [DevEndpoint structure](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-DevEndpoint)
  + [DevEndpointCustomLibraries structure](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-DevEndpointCustomLibraries)
  + [Opérations](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-actions)
  + [CreateDevEndpoint action (Python : create\$1dev\$1endpoint)](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-CreateDevEndpoint)
  + [UpdateDevEndpoint action (Python : update\$1dev\$1endpoint)](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-UpdateDevEndpoint)
  + [DeleteDevEndpoint action (Python : delete\$1dev\$1endpoint)](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-DeleteDevEndpoint)
  + [GetDevEndpoint action (Python : get\$1dev\$1endpoint)](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-GetDevEndpoint)
  + [GetDevEndpoints action (Python : get\$1dev\$1endpoints)](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-GetDevEndpoints)
  + [BatchGetDevEndpoints action (Python : batch\$1get\$1dev\$1endpoints)](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-BatchGetDevEndpoints)
  + [ListDevEndpoints action (Python : list\$1dev\$1endpoints)](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-ListDevEndpoints)
+ [Registre de schémas](aws-glue-api-schema-registry-api.md)
  + [Types de données](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-objects)
  + [RegistryId structure](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-RegistryId)
  + [RegistryListItem structure](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-RegistryListItem)
  + [MetadataInfo structure](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-MetadataInfo)
  + [OtherMetadataValueListItem structure](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-OtherMetadataValueListItem)
  + [SchemaListItem structure](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-SchemaListItem)
  + [SchemaVersionListItem structure](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-SchemaVersionListItem)
  + [MetadataKeyValuePair structure](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-MetadataKeyValuePair)
  + [SchemaVersionErrorItem structure](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-SchemaVersionErrorItem)
  + [ErrorDetails structure](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-ErrorDetails)
  + [SchemaVersionNumber structure](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-SchemaVersionNumber)
  + [SchemaId structure](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-SchemaId)
  + [Opérations](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-actions)
  + [CreateRegistry action (Python : create\$1registry)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-CreateRegistry)
  + [CreateSchema action (Python : créer\$1schéma)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-CreateSchema)
  + [GetSchema action (Python : get\$1schema)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-GetSchema)
  + [ListSchemaVersions action (Python : list\$1schema\$1versions)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-ListSchemaVersions)
  + [GetSchemaVersion action (Python : get\$1schema\$1version)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-GetSchemaVersion)
  + [GetSchemaVersionsDiff action (Python : get\$1schema\$1versions\$1diff)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-GetSchemaVersionsDiff)
  + [ListRegistries action (Python : list\$1registries)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-ListRegistries)
  + [ListSchemas action (Python : list\$1schemas)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-ListSchemas)
  + [RegisterSchemaVersion action (Python : register\$1schema\$1version)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-RegisterSchemaVersion)
  + [UpdateSchema action (Python : update\$1schema)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-UpdateSchema)
  + [CheckSchemaVersionValidity action (Python : check\$1schema\$1version\$1validity)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-CheckSchemaVersionValidity)
  + [UpdateRegistry action (Python : update\$1registry)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-UpdateRegistry)
  + [GetSchemaByDefinition action (Python : get\$1schema\$1by\$1definition)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-GetSchemaByDefinition)
  + [GetRegistry action (Python : get\$1registry)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-GetRegistry)
  + [PutSchemaVersionMetadata action (Python : put\$1schema\$1version\$1metadata)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-PutSchemaVersionMetadata)
  + [QuerySchemaVersionMetadata action (Python : query\$1schema\$1version\$1metadata)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-QuerySchemaVersionMetadata)
  + [RemoveSchemaVersionMetadata action (Python : remove\$1schema\$1version\$1metadata)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-RemoveSchemaVersionMetadata)
  + [DeleteRegistry action (Python : supprimer\$1registre)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-DeleteRegistry)
  + [DeleteSchema action (Python : supprimer\$1schéma)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-DeleteSchema)
  + [DeleteSchemaVersions action (Python : delete\$1schema\$1versions)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-DeleteSchemaVersions)
+ [Flux de travail](aws-glue-api-workflow.md)
  + [Types de données](aws-glue-api-workflow.md#aws-glue-api-workflow-objects)
  + [JobNodeDetails structure](aws-glue-api-workflow.md#aws-glue-api-workflow-JobNodeDetails)
  + [CrawlerNodeDetails structure](aws-glue-api-workflow.md#aws-glue-api-workflow-CrawlerNodeDetails)
  + [TriggerNodeDetails structure](aws-glue-api-workflow.md#aws-glue-api-workflow-TriggerNodeDetails)
  + [Structure Crawl](aws-glue-api-workflow.md#aws-glue-api-workflow-Crawl)
  + [Structure de nœud](aws-glue-api-workflow.md#aws-glue-api-workflow-Node)
  + [Structure Edge](aws-glue-api-workflow.md#aws-glue-api-workflow-Edge)
  + [Structure de flux de travail](aws-glue-api-workflow.md#aws-glue-api-workflow-Workflow)
  + [WorkflowGraph structure](aws-glue-api-workflow.md#aws-glue-api-workflow-WorkflowGraph)
  + [WorkflowRun structure](aws-glue-api-workflow.md#aws-glue-api-workflow-WorkflowRun)
  + [WorkflowRunStatistics structure](aws-glue-api-workflow.md#aws-glue-api-workflow-WorkflowRunStatistics)
  + [StartingEventBatchCondition structure](aws-glue-api-workflow.md#aws-glue-api-workflow-StartingEventBatchCondition)
  + [Structure du plan](aws-glue-api-workflow.md#aws-glue-api-workflow-Blueprint)
  + [BlueprintDetails structure](aws-glue-api-workflow.md#aws-glue-api-workflow-BlueprintDetails)
  + [LastActiveDefinition structure](aws-glue-api-workflow.md#aws-glue-api-workflow-LastActiveDefinition)
  + [BlueprintRun structure](aws-glue-api-workflow.md#aws-glue-api-workflow-BlueprintRun)
  + [Opérations](aws-glue-api-workflow.md#aws-glue-api-workflow-actions)
  + [CreateWorkflow action (Python : create\$1workflow)](aws-glue-api-workflow.md#aws-glue-api-workflow-CreateWorkflow)
  + [UpdateWorkflow action (Python : update\$1workflow)](aws-glue-api-workflow.md#aws-glue-api-workflow-UpdateWorkflow)
  + [DeleteWorkflow action (Python : delete\$1workflow)](aws-glue-api-workflow.md#aws-glue-api-workflow-DeleteWorkflow)
  + [GetWorkflow action (Python : get\$1workflow)](aws-glue-api-workflow.md#aws-glue-api-workflow-GetWorkflow)
  + [ListWorkflows action (Python : list\$1workflows)](aws-glue-api-workflow.md#aws-glue-api-workflow-ListWorkflows)
  + [BatchGetWorkflows action (Python : batch\$1get\$1workflows)](aws-glue-api-workflow.md#aws-glue-api-workflow-BatchGetWorkflows)
  + [GetWorkflowRun action (Python : get\$1workflow\$1run)](aws-glue-api-workflow.md#aws-glue-api-workflow-GetWorkflowRun)
  + [GetWorkflowRuns action (Python : get\$1workflow\$1runs)](aws-glue-api-workflow.md#aws-glue-api-workflow-GetWorkflowRuns)
  + [GetWorkflowRunProperties action (Python : get\$1workflow\$1run\$1properties)](aws-glue-api-workflow.md#aws-glue-api-workflow-GetWorkflowRunProperties)
  + [PutWorkflowRunProperties action (Python : put\$1workflow\$1run\$1properties)](aws-glue-api-workflow.md#aws-glue-api-workflow-PutWorkflowRunProperties)
  + [CreateBlueprint action (Python : créer\$1blueprint)](aws-glue-api-workflow.md#aws-glue-api-workflow-CreateBlueprint)
  + [UpdateBlueprint action (Python : update\$1blueprint)](aws-glue-api-workflow.md#aws-glue-api-workflow-UpdateBlueprint)
  + [DeleteBlueprint action (Python : delete\$1blueprint)](aws-glue-api-workflow.md#aws-glue-api-workflow-DeleteBlueprint)
  + [ListBlueprints action (Python : list\$1blueprints)](aws-glue-api-workflow.md#aws-glue-api-workflow-ListBlueprints)
  + [BatchGetBlueprints action (Python : batch\$1get\$1blueprints)](aws-glue-api-workflow.md#aws-glue-api-workflow-BatchGetBlueprints)
  + [StartBlueprintRun action (Python : start\$1blueprint\$1run)](aws-glue-api-workflow.md#aws-glue-api-workflow-StartBlueprintRun)
  + [GetBlueprintRun action (Python : get\$1blueprint\$1run)](aws-glue-api-workflow.md#aws-glue-api-workflow-GetBlueprintRun)
  + [GetBlueprintRuns action (Python : get\$1blueprint\$1runs)](aws-glue-api-workflow.md#aws-glue-api-workflow-GetBlueprintRuns)
  + [StartWorkflowRun action (Python : start\$1workflow\$1run)](aws-glue-api-workflow.md#aws-glue-api-workflow-StartWorkflowRun)
  + [StopWorkflowRun action (Python : stop\$1workflow\$1run)](aws-glue-api-workflow.md#aws-glue-api-workflow-StopWorkflowRun)
  + [ResumeWorkflowRun action (Python : resume\$1workflow\$1run)](aws-glue-api-workflow.md#aws-glue-api-workflow-ResumeWorkflowRun)
+ [Profils d'utilisation](aws-glue-api-usage-profiles.md)
  + [Types de données](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-objects)
  + [ProfileConfiguration structure](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-ProfileConfiguration)
  + [ConfigurationObject structure](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-ConfigurationObject)
  + [UsageProfileDefinition structure](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-UsageProfileDefinition)
  + [Opérations](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-actions)
  + [CreateUsageProfile action (Python : create\$1usage\$1profile)](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-CreateUsageProfile)
  + [GetUsageProfile action (Python : get\$1usage\$1profile)](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-GetUsageProfile)
  + [UpdateUsageProfile action (Python : update\$1usage\$1profile)](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-UpdateUsageProfile)
  + [DeleteUsageProfile action (Python : delete\$1usage\$1profile)](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-DeleteUsageProfile)
  + [ListUsageProfiles action (Python : list\$1usage\$1profiles)](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-ListUsageProfiles)
+ [API de Machine Learning](aws-glue-api-machine-learning-api.md)
  + [Types de données](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-objects)
  + [TransformParameters structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-TransformParameters)
  + [EvaluationMetrics structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-EvaluationMetrics)
  + [MLTransform structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-MLTransform)
  + [FindMatchesParameters structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-FindMatchesParameters)
  + [FindMatchesMetrics structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-FindMatchesMetrics)
  + [ConfusionMatrix structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-ConfusionMatrix)
  + [GlueTable structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-GlueTable)
  + [TaskRun structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-TaskRun)
  + [TransformFilterCriteria structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-TransformFilterCriteria)
  + [TransformSortCriteria structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-TransformSortCriteria)
  + [TaskRunFilterCriteria structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-TaskRunFilterCriteria)
  + [TaskRunSortCriteria structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-TaskRunSortCriteria)
  + [TaskRunProperties structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-TaskRunProperties)
  + [FindMatchesTaskRunProperties structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-FindMatchesTaskRunProperties)
  + [ImportLabelsTaskRunProperties structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-ImportLabelsTaskRunProperties)
  + [ExportLabelsTaskRunProperties structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-ExportLabelsTaskRunProperties)
  + [LabelingSetGenerationTaskRunProperties structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-LabelingSetGenerationTaskRunProperties)
  + [SchemaColumn structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-SchemaColumn)
  + [TransformEncryption structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-TransformEncryption)
  + [MLUserDataEncryption structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-MLUserDataEncryption)
  + [ColumnImportance structure](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-ColumnImportance)
  + [Opérations](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-actions)
  + [Créer une MLTransform action (Python : create\$1ml\$1transform)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-CreateMLTransform)
  + [MLTransform Action de mise à jour (Python : update\$1ml\$1transform)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-UpdateMLTransform)
  + [MLTransform Action de suppression (Python : delete\$1ml\$1transform)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-DeleteMLTransform)
  + [Obtenir une MLTransform action (Python : get\$1ml\$1transform)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-GetMLTransform)
  + [Obtenir une MLTransforms action (Python : get\$1ml\$1transform)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-GetMLTransforms)
  + [MLTransforms Action de liste (Python : list\$1ml\$1transform)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-ListMLTransforms)
  + [Lancer MLEvaluation TaskRun l'action (Python : start\$1ml\$1evaluation\$1task\$1run)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-StartMLEvaluationTaskRun)
  + [Lancer MLLabeling SetGenerationTaskRun l'action (Python : start\$1ml\$1labeling\$1set\$1generation\$1task\$1run)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-StartMLLabelingSetGenerationTaskRun)
  + [Action Get MLTask Run (Python : get\$1ml\$1task\$1run)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-GetMLTaskRun)
  + [Action Get MLTask Runs (Python : get\$1ml\$1task\$1runs)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-GetMLTaskRuns)
  + [Annuler l'action MLTask Exécuter (Python : cancel\$1ml\$1task\$1run)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-CancelMLTaskRun)
  + [StartExportLabelsTaskRun action (Python : start\$1export\$1labels\$1task\$1run)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-StartExportLabelsTaskRun)
  + [StartImportLabelsTaskRun action (Python : start\$1import\$1labels\$1task\$1run)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-StartImportLabelsTaskRun)
+ [API Qualité des données](aws-glue-api-data-quality-api.md)
  + [Types de données](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-objects)
  + [DataSource structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataSource)
  + [DataQualityRulesetListDetails structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityRulesetListDetails)
  + [DataQualityTargetTable structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityTargetTable)
  + [DataQualityRulesetEvaluationRunDescription structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunDescription)
  + [DataQualityRulesetEvaluationRunFilter structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunFilter)
  + [DataQualityEvaluationRunAdditionalRunOptions structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityEvaluationRunAdditionalRunOptions)
  + [DataQualityRuleRecommendationRunDescription structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunDescription)
  + [DataQualityRuleRecommendationRunFilter structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunFilter)
  + [DataQualityResult structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityResult)
  + [DataQualityAnalyzerResult structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityAnalyzerResult)
  + [DataQualityObservation structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityObservation)
  + [MetricBasedObservation structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-MetricBasedObservation)
  + [DataQualityMetricValues structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityMetricValues)
  + [DataQualityRuleResult structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityRuleResult)
  + [DataQualityResultDescription structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityResultDescription)
  + [DataQualityResultFilterCriteria structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityResultFilterCriteria)
  + [DataQualityRulesetFilterCriteria structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityRulesetFilterCriteria)
  + [DataQualityAggregatedMetrics structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityAggregatedMetrics)
  + [StatisticAnnotation structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-StatisticAnnotation)
  + [TimestampedInclusionAnnotation structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-TimestampedInclusionAnnotation)
  + [AnnotationError structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-AnnotationError)
  + [DatapointInclusionAnnotation structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DatapointInclusionAnnotation)
  + [StatisticSummaryList liste](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-StatisticSummaryList)
  + [StatisticSummary structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-StatisticSummary)
  + [RunIdentifier structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-RunIdentifier)
  + [StatisticModelResult structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-StatisticModelResult)
  + [DataQualityGlueTable structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityGlueTable)
  + [Opérations](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-actions)
  + [StartDataQualityRulesetEvaluationRun action (Python : start\$1data\$1quality\$1ruleset\$1evaluation\$1run)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-StartDataQualityRulesetEvaluationRun)
  + [CancelDataQualityRulesetEvaluationRun action (Python : cancel\$1data\$1quality\$1ruleset\$1evaluation\$1run)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-CancelDataQualityRulesetEvaluationRun)
  + [GetDataQualityRulesetEvaluationRun action (Python : get\$1data\$1quality\$1ruleset\$1evaluation\$1run)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityRulesetEvaluationRun)
  + [ListDataQualityRulesetEvaluationRuns action (Python : list\$1data\$1quality\$1ruleset\$1evaluation\$1runs)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-ListDataQualityRulesetEvaluationRuns)
  + [StartDataQualityRuleRecommendationRun action (Python : start\$1data\$1quality\$1rule\$1recommendation\$1run)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-StartDataQualityRuleRecommendationRun)
  + [CancelDataQualityRuleRecommendationRun action (Python : cancel\$1data\$1quality\$1rule\$1recommendation\$1run)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-CancelDataQualityRuleRecommendationRun)
  + [GetDataQualityRuleRecommendationRun action (Python : get\$1data\$1quality\$1rule\$1recommendation\$1run)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityRuleRecommendationRun)
  + [ListDataQualityRuleRecommendationRuns action (Python : list\$1data\$1quality\$1rule\$1recommendation\$1runs)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-ListDataQualityRuleRecommendationRuns)
  + [GetDataQualityResult action (Python : get\$1data\$1quality\$1result)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityResult)
  + [BatchGetDataQualityResult action (Python : batch\$1get\$1data\$1quality\$1result)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-BatchGetDataQualityResult)
  + [ListDataQualityResults action (Python : list\$1data\$1quality\$1results)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-ListDataQualityResults)
  + [CreateDataQualityRuleset action (Python : create\$1data\$1quality\$1ruleset)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-CreateDataQualityRuleset)
  + [DeleteDataQualityRuleset action (Python : delete\$1data\$1quality\$1ruleset)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DeleteDataQualityRuleset)
  + [GetDataQualityRuleset action (Python : get\$1data\$1quality\$1ruleset)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityRuleset)
  + [ListDataQualityRulesets action (Python : list\$1data\$1quality\$1rulesets)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-ListDataQualityRulesets)
  + [UpdateDataQualityRuleset action (Python : update\$1data\$1quality\$1ruleset)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-UpdateDataQualityRuleset)
  + [ListDataQualityStatistics action (Python : list\$1data\$1quality\$1statistics)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-ListDataQualityStatistics)
  + [TimestampFilter structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-TimestampFilter)
  + [CreateDataQualityRulesetRequest structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-CreateDataQualityRulesetRequest)
  + [GetDataQualityRulesetResponse structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityRulesetResponse)
  + [GetDataQualityResultResponse structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityResultResponse)
  + [StartDataQualityRuleRecommendationRunRequest structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-StartDataQualityRuleRecommendationRunRequest)
  + [GetDataQualityRuleRecommendationRunResponse structure](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityRuleRecommendationRunResponse)
  + [BatchPutDataQualityStatisticAnnotation action (Python : batch\$1put\$1data\$1quality\$1statistic\$1annotation)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-BatchPutDataQualityStatisticAnnotation)
  + [GetDataQualityModel action (Python : get\$1data\$1quality\$1model)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityModel)
  + [GetDataQualityModelResult action (Python : get\$1data\$1quality\$1model\$1result)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityModelResult)
  + [ListDataQualityStatisticAnnotations action (Python : list\$1data\$1quality\$1statistic\$1annotations)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-ListDataQualityStatisticAnnotations)
  + [PutDataQualityProfileAnnotation action (Python : put\$1data\$1quality\$1profile\$1annotation)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-PutDataQualityProfileAnnotation)
+ [API Détection des données sensibles](aws-glue-api-sensitive-data-api.md)
  + [Types de données](aws-glue-api-sensitive-data-api.md#aws-glue-api-sensitive-data-api-objects)
  + [CustomEntityType structure](aws-glue-api-sensitive-data-api.md#aws-glue-api-sensitive-data-api-CustomEntityType)
  + [Opérations](aws-glue-api-sensitive-data-api.md#aws-glue-api-sensitive-data-api-actions)
  + [CreateCustomEntityType action (Python : create\$1custom\$1entity\$1type)](aws-glue-api-sensitive-data-api.md#aws-glue-api-sensitive-data-api-CreateCustomEntityType)
  + [DeleteCustomEntityType action (Python : delete\$1custom\$1entity\$1type)](aws-glue-api-sensitive-data-api.md#aws-glue-api-sensitive-data-api-DeleteCustomEntityType)
  + [GetCustomEntityType action (Python : get\$1custom\$1entity\$1type)](aws-glue-api-sensitive-data-api.md#aws-glue-api-sensitive-data-api-GetCustomEntityType)
  + [BatchGetCustomEntityTypes action (Python : batch\$1get\$1custom\$1entity\$1types)](aws-glue-api-sensitive-data-api.md#aws-glue-api-sensitive-data-api-BatchGetCustomEntityTypes)
  + [ListCustomEntityTypes action (Python : list\$1custom\$1entity\$1types)](aws-glue-api-sensitive-data-api.md#aws-glue-api-sensitive-data-api-ListCustomEntityTypes)
+ [Marquage APIs AWS Glue](aws-glue-api-tags.md)
  + [Types de données](aws-glue-api-tags.md#aws-glue-api-tags-objects)
  + [Structure Tag](aws-glue-api-tags.md#aws-glue-api-tags-Tag)
  + [Opérations](aws-glue-api-tags.md#aws-glue-api-tags-actions)
  + [TagResource action (Python : tag\$1resource)](aws-glue-api-tags.md#aws-glue-api-tags-TagResource)
  + [UntagResource action (Python : untag\$1resource)](aws-glue-api-tags.md#aws-glue-api-tags-UntagResource)
  + [GetTags action (Python : get\$1tags)](aws-glue-api-tags.md#aws-glue-api-tags-GetTags)
+ [Types de données courants](aws-glue-api-common.md)
  + [Structure de balise](aws-glue-api-common.md#aws-glue-api-common-Tag)
  + [DecimalNumber structure](aws-glue-api-common.md#aws-glue-api-common-DecimalNumber)
  + [ErrorDetail structure](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail)
  + [PropertyPredicate structure](aws-glue-api-common.md#aws-glue-api-common-PropertyPredicate)
  + [ResourceUri structure](aws-glue-api-common.md#aws-glue-api-common-ResourceUri)
  + [ColumnStatistics structure](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics)
  + [ColumnStatisticsError structure](aws-glue-api-common.md#aws-glue-api-common-ColumnStatisticsError)
  + [ColumnError structure](aws-glue-api-common.md#aws-glue-api-common-ColumnError)
  + [ColumnStatisticsData structure](aws-glue-api-common.md#aws-glue-api-common-ColumnStatisticsData)
  + [BooleanColumnStatisticsData structure](aws-glue-api-common.md#aws-glue-api-common-BooleanColumnStatisticsData)
  + [DateColumnStatisticsData structure](aws-glue-api-common.md#aws-glue-api-common-DateColumnStatisticsData)
  + [DecimalColumnStatisticsData structure](aws-glue-api-common.md#aws-glue-api-common-DecimalColumnStatisticsData)
  + [DoubleColumnStatisticsData structure](aws-glue-api-common.md#aws-glue-api-common-DoubleColumnStatisticsData)
  + [LongColumnStatisticsData structure](aws-glue-api-common.md#aws-glue-api-common-LongColumnStatisticsData)
  + [StringColumnStatisticsData structure](aws-glue-api-common.md#aws-glue-api-common-StringColumnStatisticsData)
  + [BinaryColumnStatisticsData structure](aws-glue-api-common.md#aws-glue-api-common-BinaryColumnStatisticsData)
  + [Modèles de chaîne](aws-glue-api-common.md#aws-glue-api-common-_string-patterns)
+ [Exceptions](aws-glue-api-exceptions.md)
  + [AccessDeniedException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-AccessDeniedException)
  + [AlreadyExistsException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-AlreadyExistsException)
  + [ConcurrentModificationException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-ConcurrentModificationException)
  + [ConcurrentRunsExceededException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-ConcurrentRunsExceededException)
  + [CrawlerNotRunningException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-CrawlerNotRunningException)
  + [CrawlerRunningException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-CrawlerRunningException)
  + [CrawlerStoppingException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-CrawlerStoppingException)
  + [EntityNotFoundException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-EntityNotFoundException)
  + [FederationSourceException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-FederationSourceException)
  + [FederationSourceRetryableException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-FederationSourceRetryableException)
  + [GlueEncryptionException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-GlueEncryptionException)
  + [IdempotentParameterMismatchException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-IdempotentParameterMismatchException)
  + [IllegalWorkflowStateException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-IllegalWorkflowStateException)
  + [InternalServiceException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-InternalServiceException)
  + [InvalidExecutionEngineException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-InvalidExecutionEngineException)
  + [InvalidInputException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-InvalidInputException)
  + [InvalidStateException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-InvalidStateException)
  + [InvalidTaskStatusTransitionException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-InvalidTaskStatusTransitionException)
  + [JobDefinitionErrorException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-JobDefinitionErrorException)
  + [JobRunInTerminalStateException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-JobRunInTerminalStateException)
  + [JobRunInvalidStateTransitionException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-JobRunInvalidStateTransitionException)
  + [JobRunNotInTerminalStateException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-JobRunNotInTerminalStateException)
  + [LateRunnerException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-LateRunnerException)
  + [NoScheduleException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-NoScheduleException)
  + [OperationTimeoutException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-OperationTimeoutException)
  + [ResourceNotReadyException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-ResourceNotReadyException)
  + [ResourceNumberLimitExceededException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-ResourceNumberLimitExceededException)
  + [SchedulerNotRunningException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-SchedulerNotRunningException)
  + [SchedulerRunningException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-SchedulerRunningException)
  + [SchedulerTransitioningException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-SchedulerTransitioningException)
  + [UnrecognizedRunnerException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-UnrecognizedRunnerException)
  + [ValidationException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-ValidationException)
  + [VersionMismatchException structure](aws-glue-api-exceptions.md#aws-glue-api-exceptions-VersionMismatchException)

# Sécurité APIs dans AWS Glue
<a name="aws-glue-api-jobs-security"></a>

L'API de sécurité décrit les types de données de sécurité et l'API associée à la sécurité dans AWS Glue.

## Types de données
<a name="aws-glue-api-jobs-security-objects"></a>
+ [DataCatalogEncryptionSettings structure](#aws-glue-api-jobs-security-DataCatalogEncryptionSettings)
+ [EncryptionAtRest structure](#aws-glue-api-jobs-security-EncryptionAtRest)
+ [ConnectionPasswordEncryption structure](#aws-glue-api-jobs-security-ConnectionPasswordEncryption)
+ [EncryptionConfiguration structure](#aws-glue-api-jobs-security-EncryptionConfiguration)
+ [Structure S3Encryption](#aws-glue-api-jobs-security-S3Encryption)
+ [CloudWatchEncryption structure](#aws-glue-api-jobs-security-CloudWatchEncryption)
+ [JobBookmarksEncryption structure](#aws-glue-api-jobs-security-JobBookmarksEncryption)
+ [SecurityConfiguration structure](#aws-glue-api-jobs-security-SecurityConfiguration)
+ [GluePolicy structure](#aws-glue-api-jobs-security-GluePolicy)
+ [DataQualityEncryption structure](#aws-glue-api-jobs-security-DataQualityEncryption)

## DataCatalogEncryptionSettings structure
<a name="aws-glue-api-jobs-security-DataCatalogEncryptionSettings"></a>

Contient des informations de configuration sur le maintien de la sécurité du catalogue de données.

**Champs**
+ `EncryptionAtRest` : un objet [EncryptionAtRest](#aws-glue-api-jobs-security-EncryptionAtRest).

  Spécifie la encryption-at-rest configuration du catalogue de données.
+ `ConnectionPasswordEncryption` – Un objet [ConnectionPasswordEncryption](#aws-glue-api-jobs-security-ConnectionPasswordEncryption).

  Lorsque la protection par mot de passe de connexion est activée, le Catalogue de données utilise une clé fournie par le client pour chiffrer le mot de passe dans le cadre de `CreateConnection` ou `UpdateConnection` et le stocke dans le champ `ENCRYPTED_PASSWORD` des propriétés de connexion. Vous pouvez activer le chiffrage de catalogue ou uniquement le chiffrage de mot de passe.

## EncryptionAtRest structure
<a name="aws-glue-api-jobs-security-EncryptionAtRest"></a>

Spécifie la encryption-at-rest configuration du catalogue de données.

**Champs**
+ `CatalogEncryptionMode` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `DISABLED` \$1 `SSE-KMS="SSEKMS"` \$1 `SSE-KMS-WITH-SERVICE-ROLE="SSEKMSWITHSERVICEROLE"`).

   encryption-at-restMode de chiffrement des données du catalogue de données.
+ `SseAwsKmsKeyId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de la AWS KMS clé à utiliser pour le chiffrement au repos.
+ `CatalogEncryptionServiceRole` – Chaîne UTF-8, correspondant au [Custom string pattern #53](aws-glue-api-common.md#regex_53).

  Rôle censé chiffrer et déchiffrer les objets du catalogue de données pour le compte de l'appelant. AWS Glue 

## ConnectionPasswordEncryption structure
<a name="aws-glue-api-jobs-security-ConnectionPasswordEncryption"></a>

La structure des données utilisée par le Catalogue de données pour chiffrer le mot de passe dans le cadre de `CreateConnection` ou `UpdateConnection` et le stocker dans le champ `ENCRYPTED_PASSWORD` des propriétés de connexion. Vous pouvez activer le chiffrage de catalogue ou uniquement le chiffrage de mot de passe.

Lorsqu'une `CreationConnection` demande contenant un mot de passe arrive, le catalogue de données chiffre d'abord le mot de passe à l'aide de votre AWS KMS clé. Il chiffre de nouveau l'objet de connexion entier si le chiffrage de catalogue est également activé.

Ce chiffrement nécessite que vous définissiez des autorisations AWS KMS clés pour activer ou restreindre l'accès à la clé de mot de passe conformément à vos exigences de sécurité. Par exemple, vous pourriez vouloir autoriser uniquement des administrateurs à disposer des autorisations de déchiffrement de la clé de mot de passe.

**Champs**
+ `ReturnConnectionPasswordEncrypted` – *obligatoire :* booléen.

  Lorsque le signalement `ReturnConnectionPasswordEncrypted` est réglé sur « vrai », les mots de passe restent chiffrés dans les réponses de `GetConnection` et de `GetConnections`. Ce chiffrage prend effet indépendamment du chiffrage de catalogue. 
+ `AwsKmsKeyId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

   AWS KMS Clé utilisée pour chiffrer le mot de passe de connexion. 

  Si la protection par mot de passe de connexion est activée, l'`CreateConnection`appelant `UpdateConnection` doit au moins `kms:Encrypt` obtenir une autorisation sur la AWS KMS clé spécifiée pour chiffrer les mots de passe avant de les stocker dans le catalogue de données. 

  Vous pouvez régler l'autorisation de déchiffrage pour activer ou restreindre l'accès à la clé de mot de passe selon vos exigences de sécurité.

## EncryptionConfiguration structure
<a name="aws-glue-api-jobs-security-EncryptionConfiguration"></a>

Spécifie une configuration de chiffrement.

**Champs**
+ `S3Encryption` : un tableau d’objets [S3Encryption](#aws-glue-api-jobs-security-S3Encryption).

  Configuration de chiffrement pour les données Amazon Simple Storage Service (Amazon S3).
+ `CloudWatchEncryption` – Un objet [CloudWatchEncryption](#aws-glue-api-jobs-security-CloudWatchEncryption).

  Configuration du chiffrement pour Amazon CloudWatch.
+ `JobBookmarksEncryption` – Un objet [JobBookmarksEncryption](#aws-glue-api-jobs-security-JobBookmarksEncryption).

  Configuration de chiffrement pour les signets de tâche.
+ `DataQualityEncryption` – Un objet [DataQualityEncryption](#aws-glue-api-jobs-security-DataQualityEncryption).

  Configuration du chiffrement pour les actifs de qualité des AWS Glue données.

## Structure S3Encryption
<a name="aws-glue-api-jobs-security-S3Encryption"></a>

Spécifie la façon dont les données Amazon Simple Storage Service (Amazon S3) doivent être chiffrées.

**Champs**
+ `S3EncryptionMode` – Chaîne UTF-8 (valeurs valides : `DISABLED` \$1 `SSE-KMS="SSEKMS"` \$1 `SSE-S3="SSES3"`).

  Mode de chiffrement à utiliser pour les données Amazon S3.
+ `KmsKeyArn` – Chaîne UTF-8, correspondant au [Custom string pattern #42](aws-glue-api-common.md#regex_42).

  L'Amazon Resource Name (ARN) de la clé KMS à utiliser pour chiffrer les données.

## CloudWatchEncryption structure
<a name="aws-glue-api-jobs-security-CloudWatchEncryption"></a>

Spécifie la manière dont CloudWatch les données Amazon doivent être cryptées.

**Champs**
+ `CloudWatchEncryptionMode` – Chaîne UTF-8 (valeurs valides : `DISABLED` \$1 `SSE-KMS="SSEKMS"`).

  Mode de chiffrement à utiliser pour les CloudWatch données.
+ `KmsKeyArn` – Chaîne UTF-8, correspondant au [Custom string pattern #42](aws-glue-api-common.md#regex_42).

  L'Amazon Resource Name (ARN) de la clé KMS à utiliser pour chiffrer les données.

## JobBookmarksEncryption structure
<a name="aws-glue-api-jobs-security-JobBookmarksEncryption"></a>

Spécifie la manière dont les données de signet de tâche doivent être chiffrées.

**Champs**
+ `JobBookmarksEncryptionMode` – Chaîne UTF-8 (valeurs valides : `DISABLED` \$1 `CSE-KMS="CSEKMS"`).

  Mode de chiffrement à utiliser pour les données de signet de tâche.
+ `KmsKeyArn` – Chaîne UTF-8, correspondant au [Custom string pattern #42](aws-glue-api-common.md#regex_42).

  L'Amazon Resource Name (ARN) de la clé KMS à utiliser pour chiffrer les données.

## SecurityConfiguration structure
<a name="aws-glue-api-jobs-security-SecurityConfiguration"></a>

Spécifie une configuration de sécurité.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la configuration de sécurité.
+ `CreatedTimeStamp` – Horodatage.

  Horodatage de la création de la configuration de sécurité.
+ `EncryptionConfiguration` : un objet [EncryptionConfiguration](#aws-glue-api-jobs-security-EncryptionConfiguration).

  Configuration de chiffrement associée à cette configuration de sécurité.

## GluePolicy structure
<a name="aws-glue-api-jobs-security-GluePolicy"></a>

Structure pour le renvoi d'une politique de ressources.

**Champs**
+ `PolicyInJson` — Chaîne UTF-8, d'une longueur minimale de 2 octets.

  Contient le document de politique demandé, au format JSON.
+ `PolicyHash` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Contient la valeur de hachage associée à cette politique.
+ `CreateTime` – Horodatage.

  Date et heure de création de la politique.
+ `UpdateTime` – Horodatage.

  Date et heure de dernière mise à jour de la politique.

## DataQualityEncryption structure
<a name="aws-glue-api-jobs-security-DataQualityEncryption"></a>

Spécifie la manière dont les ressources de qualité des données de votre compte doivent être chiffrées.

**Champs**
+ `DataQualityEncryptionMode` – Chaîne UTF-8 (valeurs valides : `DISABLED` \$1 `SSE-KMS="SSEKMS"`).

  Mode de chiffrement à utiliser pour chiffrer les ressources de qualité des données. Ces ressources incluent des ensembles de règles de qualité des données, des résultats, des statistiques, des modèles de détection des anomalies et des observations.

  Les valeurs valides sont `SSEKMS` pour le chiffrement à l’aide d’une clé KMS gérée par le client, ou `DISABLED`.
+ `KmsKeyArn` – Chaîne UTF-8, correspondant au [Custom string pattern #42](aws-glue-api-common.md#regex_42).

  L'Amazon Resource Name (ARN) de la clé KMS à utiliser pour chiffrer les données.

## Opérations
<a name="aws-glue-api-jobs-security-actions"></a>
+ [GetDataCatalogEncryptionSettings action (Python : get\$1data\$1catalog\$1encryption\$1settings)](#aws-glue-api-jobs-security-GetDataCatalogEncryptionSettings)
+ [PutDataCatalogEncryptionSettings action (Python : put\$1data\$1catalog\$1encryption\$1settings)](#aws-glue-api-jobs-security-PutDataCatalogEncryptionSettings)
+ [PutResourcePolicy action (Python : put\$1resource\$1policy)](#aws-glue-api-jobs-security-PutResourcePolicy)
+ [GetResourcePolicy action (Python : get\$1resource\$1policy)](#aws-glue-api-jobs-security-GetResourcePolicy)
+ [DeleteResourcePolicy action (Python : delete\$1resource\$1policy)](#aws-glue-api-jobs-security-DeleteResourcePolicy)
+ [CreateSecurityConfiguration action (Python : create\$1security\$1configuration)](#aws-glue-api-jobs-security-CreateSecurityConfiguration)
+ [DeleteSecurityConfiguration action (Python : delete\$1security\$1configuration)](#aws-glue-api-jobs-security-DeleteSecurityConfiguration)
+ [GetSecurityConfiguration action (Python : get\$1security\$1configuration)](#aws-glue-api-jobs-security-GetSecurityConfiguration)
+ [GetSecurityConfigurations action (Python : get\$1security\$1configurations)](#aws-glue-api-jobs-security-GetSecurityConfigurations)
+ [GetResourcePolicies action (Python : get\$1resource\$1policies)](#aws-glue-api-jobs-security-GetResourcePolicies)

## GetDataCatalogEncryptionSettings action (Python : get\$1data\$1catalog\$1encryption\$1settings)
<a name="aws-glue-api-jobs-security-GetDataCatalogEncryptionSettings"></a>

Récupère la configuration de sécurité d'un catalogue spécifié.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données pour lequel extraire la configuration de sécurité. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.

**Réponse**
+ `DataCatalogEncryptionSettings` – Un objet [DataCatalogEncryptionSettings](#aws-glue-api-jobs-security-DataCatalogEncryptionSettings).

  Configuration de sécurité demandée.

**Erreurs**
+ `InternalServiceException`
+ `InvalidInputException`
+ `OperationTimeoutException`

## PutDataCatalogEncryptionSettings action (Python : put\$1data\$1catalog\$1encryption\$1settings)
<a name="aws-glue-api-jobs-security-PutDataCatalogEncryptionSettings"></a>

Définit la configuration de sécurité d'un catalogue spécifié. Une fois la configuration définie, le chiffrement spécifié est appliqué à chaque écriture ultérieure dans le catalogue.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données pour lequel définir la configuration de sécurité. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DataCatalogEncryptionSettings` – *Obligatoire :* un objet [DataCatalogEncryptionSettings](#aws-glue-api-jobs-security-DataCatalogEncryptionSettings).

  Configuration de sécurité à définir.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `InternalServiceException`
+ `InvalidInputException`
+ `OperationTimeoutException`

## PutResourcePolicy action (Python : put\$1resource\$1policy)
<a name="aws-glue-api-jobs-security-PutResourcePolicy"></a>

Définit la politique de ressources du catalogue de données pour le contrôle d'accès.

**Demande**
+ `PolicyInJson` – *Obligatoire :* Chaîne UTF-8, d'une longueur minimale de 2 octets.

  Contient le document de politique à définir, au format JSON.
+ `ResourceArn` – chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant à [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  Ne pas utiliser. Pour utilisation interne uniquement.
+ `PolicyHashCondition` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  La valeur de hachage renvoyée lors de la définition de la politique précédente à l'aide de `PutResourcePolicy`. Son objectif est d'empêcher les modifications simultanées d'une politique. N'utilisez pas ce paramètre si aucune politique précédente n'a été définie.
+ `PolicyExistsCondition` – Chaîne UTF-8 (valeurs valides : `MUST_EXIST` \$1 `NOT_EXIST` \$1 `NONE`).

  La valeur `MUST_EXIST` est utilisée pour mettre à jour une politique. La valeur `NOT_EXIST` est utilisée pour créer une politique. Si une valeur `NONE` ou null est utilisée, l'appel ne dépend pas de l'existence d'une politique.
+ `EnableHybrid` – Chaîne UTF-8 (valeurs valides : `TRUE` \$1 `FALSE`).

  Si la valeur est `'TRUE'`, cela indique que vous utilisez les deux méthodes pour accorder un accès entre comptes aux ressources Data Catalog :
  + En mettant directement à jour la politique de ressources avec `PutResourePolicy`
  + En utilisant la commande **Grant persmissions** (Accorder des autorisations) sur la AWS Management Console.

  Doit être défini sur `'TRUE'` si vous avez déjà utilisé la console de gestion pour accorder l'accès entre comptes, sinon l'appel échoue. La valeur par défaut est 'FALSE'.

**Réponse**
+ `PolicyHash` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Un hachage de la politique vient d'être défini. Cela doit être inclus dans un appel ultérieur qui remplace ou met à jour cette politique.

**Erreurs**
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `ConditionCheckFailureException`

## GetResourcePolicy action (Python : get\$1resource\$1policy)
<a name="aws-glue-api-jobs-security-GetResourcePolicy"></a>

Extrait une politique de ressource spécifiée.

**Demande**
+ `ResourceArn` – chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant à [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  L'ARN de la AWS Glue ressource pour laquelle vous souhaitez récupérer la politique de ressource. Si elle n'est pas fournie, la politique de ressources Data Catalog est renvoyée. Utilisez `GetResourcePolicies` pour afficher toutes les politiques de ressources existantes. Pour plus d'informations, voir [Spécification de AWS Glue la ressource ARNs](https://docs.aws.amazon.com/glue/latest/dg/glue-specifying-resource-arns.html). 

**Réponse**
+ `PolicyInJson` — Chaîne UTF-8, d'une longueur minimale de 2 octets.

  Contient le document de politique demandé, au format JSON.
+ `PolicyHash` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Contient la valeur de hachage associée à cette politique.
+ `CreateTime` – Horodatage.

  Date et heure de création de la politique.
+ `UpdateTime` – Horodatage.

  Date et heure de dernière mise à jour de la politique.

**Erreurs**
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`

## DeleteResourcePolicy action (Python : delete\$1resource\$1policy)
<a name="aws-glue-api-jobs-security-DeleteResourcePolicy"></a>

Supprime une politique spécifiée.

**Demande**
+ `PolicyHashCondition` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Valeur de hachage renvoyée lorsque cette politique a été définie.
+ `ResourceArn` – chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant à [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  L'ARN de la AWS Glue ressource pour la politique de ressources à supprimer.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `ConditionCheckFailureException`

## CreateSecurityConfiguration action (Python : create\$1security\$1configuration)
<a name="aws-glue-api-jobs-security-CreateSecurityConfiguration"></a>

Crée une nouvelle configuration de sécurité. Une configuration de sécurité est un ensemble de paramètres de sécurité pouvant être utilisées par AWS Glue. Vous pouvez utiliser une configuration de sécurité pour chiffrer les données au repos. Pour plus d'informations sur l'utilisation des configurations de sécurité dans AWS Glue, consultez la section [Chiffrement des données écrites par les robots d'exploration, les tâches et les points de terminaison de développement](https://docs.aws.amazon.com/glue/latest/dg/encryption-security-configuration.html).

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la nouvelle configuration de sécurité.
+ `EncryptionConfiguration` – *Obligatoire :* un objet [EncryptionConfiguration](#aws-glue-api-jobs-security-EncryptionConfiguration).

  Configuration de chiffrement associée à la nouvelle configuration de sécurité.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom affecté à la nouvelle configuration de sécurité.
+ `CreatedTimestamp` – Horodatage.

  Horodatage de la création de la nouvelle configuration de sécurité.

**Erreurs**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`

## DeleteSecurityConfiguration action (Python : delete\$1security\$1configuration)
<a name="aws-glue-api-jobs-security-DeleteSecurityConfiguration"></a>

Supprime une configuration de sécurité spécifiée.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la configuration de sécurité à supprimer.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetSecurityConfiguration action (Python : get\$1security\$1configuration)
<a name="aws-glue-api-jobs-security-GetSecurityConfiguration"></a>

Extrait une configuration de sécurité spécifiée.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la configuration de sécurité à récupérer.

**Réponse**
+ `SecurityConfiguration` – Un objet [SecurityConfiguration](#aws-glue-api-jobs-security-SecurityConfiguration).

  Configuration de sécurité demandée.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetSecurityConfigurations action (Python : get\$1security\$1configurations)
<a name="aws-glue-api-jobs-security-GetSecurityConfigurations"></a>

Extrait une liste de toutes les configurations de sécurité.

**Demande**
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximal de résultats à renvoyer.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.

**Réponse**
+ `SecurityConfigurations` : un tableau d’objets [SecurityConfiguration](#aws-glue-api-jobs-security-SecurityConfiguration).

  Liste de configurations de sécurité.
+ `NextToken` – Chaîne UTF-8.

  Jeton de liaison, s'il y a des configurations de sécurité supplémentaires à renvoyer.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetResourcePolicies action (Python : get\$1resource\$1policies)
<a name="aws-glue-api-jobs-security-GetResourcePolicies"></a>

Récupère les politiques de ressources définies pour les ressources individuelles AWS Resource Access Manager lors de l'octroi d'autorisations entre comptes. Récupère également la politique de ressources Data Catalog.

Si vous avez activé le chiffrement des métadonnées dans les paramètres du catalogue de données et que vous n'êtes pas autorisé à utiliser la AWS KMS clé, l'opération ne peut pas renvoyer la politique de ressources du catalogue de données.

**Demande**
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’une requête de continuation.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  La taille maximale d’une liste à renvoyer.

**Réponse**
+ `GetResourcePoliciesResponseList` : un tableau d’objets [GluePolicy](#aws-glue-api-jobs-security-GluePolicy).

  Liste répertoriant chacune des politiques de ressources et politique de ressources au niveau du compte.
+ `NextToken` – Chaîne UTF-8.

  Un jeton de continuation, si la liste renvoyée ne contient pas la dernière politique de ressources disponible.

**Erreurs**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`

# API des objets du catalogue
<a name="aws-glue-api-catalog"></a>

L'API des objets du catalogue décrit les types de données et l'API liés à l'utilisation des catalogues dans AWS Glue.

**Topics**
+ [API de catalogues](aws-glue-api-catalog-catalogs.md)
+ [API d'une base de données](aws-glue-api-catalog-databases.md)
+ [API de table](aws-glue-api-catalog-tables.md)
+ [API de partition](aws-glue-api-catalog-partitions.md)
+ [API de connexions](aws-glue-api-catalog-connections.md)
+ [API de fonction définie par l'utilisateur](aws-glue-api-catalog-functions.md)
+ [Importation d'un Athena catalogue dans AWS Glue](aws-glue-api-catalog-migration.md)

# API de catalogues
<a name="aws-glue-api-catalog-catalogs"></a>

L'API Catalogs décrit comment créer, supprimer, localiser, mettre à jour et répertorier les catalogues. APIs 

## Types de données
<a name="aws-glue-api-catalog-catalogs-objects"></a>
+ [Structure du catalogue](#aws-glue-api-catalog-catalogs-Catalog)
+ [CatalogInput structure](#aws-glue-api-catalog-catalogs-CatalogInput)
+ [TargetRedshiftCatalog structure](#aws-glue-api-catalog-catalogs-TargetRedshiftCatalog)
+ [CatalogProperties structure](#aws-glue-api-catalog-catalogs-CatalogProperties)
+ [CatalogPropertiesOutput structure](#aws-glue-api-catalog-catalogs-CatalogPropertiesOutput)
+ [DataLakeAccessProperties structure](#aws-glue-api-catalog-catalogs-DataLakeAccessProperties)
+ [IcebergOptimizationProperties structure](#aws-glue-api-catalog-catalogs-IcebergOptimizationProperties)
+ [DataLakeAccessPropertiesOutput structure](#aws-glue-api-catalog-catalogs-DataLakeAccessPropertiesOutput)
+ [IcebergOptimizationPropertiesOutput structure](#aws-glue-api-catalog-catalogs-IcebergOptimizationPropertiesOutput)
+ [FederatedCatalog structure](#aws-glue-api-catalog-catalogs-FederatedCatalog)

## Structure du catalogue
<a name="aws-glue-api-catalog-catalogs-Catalog"></a>

L'objet de catalogue représente un regroupement logique de bases de données dans le catalogue de AWS Glue données ou dans une source fédérée. Vous pouvez désormais créer un catalogue fédéré Redshift ou un catalogue contenant des liens de ressources vers des bases de données Redshift d’un autre compte ou d’une autre région.

**Champs**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID du catalogue. Pour autoriser l’accès au catalogue par défaut, ce champ ne doit pas être fourni.
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 64 octets, correspondant au [Custom string pattern #25](aws-glue-api-common.md#regex_25).

  Le nom du catalogue. Il ne peut pas être identique à l’identifiant du compte.
+ `ResourceArn` – Chaîne UTF-8.

  Amazon Resource Name (ARN) affecté à la ressource du catalogue.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au modèle de chaîne à plusieurs lignes d’adresse URI. Une description du catalogue de données.
+ `Parameters` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

   Un tableau de mappage de paires clé-valeur qui définissent les paramètres et les propriétés du catalogue.
+ `CreateTime` – Horodatage.

  Heure à laquelle le catalogue a été créé.
+ `UpdateTime` – Horodatage.

  Heure de dernière mise à jour du catalogue.
+ `TargetRedshiftCatalog` – Un objet [TargetRedshiftCatalog](#aws-glue-api-catalog-catalogs-TargetRedshiftCatalog).

  Objet `TargetRedshiftCatalog` qui décrit un catalogue cible pour la liaison de ressources de la base de données.
+ `FederatedCatalog` – Un objet [FederatedCatalog](#aws-glue-api-catalog-catalogs-FederatedCatalog).

  Un `FederatedCatalog` objet qui pointe vers une entité en dehors du catalogue de AWS Glue données.
+ `CatalogProperties` – Un objet [CatalogPropertiesOutput](#aws-glue-api-catalog-catalogs-CatalogPropertiesOutput).

  Objet `CatalogProperties` qui spécifie les propriétés d’accès au lac de données et d’autres propriétés personnalisées.
+ `CreateTableDefaultPermissions` : un tableau d’objets [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions).

  Tableau d’objets `PrincipalPermissions`. Crée un ensemble d’autorisations par défaut sur la/les table(s) pour les principaux. Utilisé par AWS Lake Formation. Non utilisé dans le cours normal des AWS Glue opérations.
+ `CreateDatabaseDefaultPermissions` : un tableau d’objets [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions).

  Tableau d’objets `PrincipalPermissions`. Crée un ensemble d’autorisations par défaut sur la/les base(s) de données pour les principaux. Utilisé par AWS Lake Formation. Non utilisé dans le cours normal des AWS Glue opérations.
+ `AllowFullTableExternalDataAccess` – Chaîne UTF-8 (valeurs valides : `True` \$1 `False`).

   Permet à des moteurs tiers d'accéder aux données Amazon S3 situées dans des emplacements enregistrés auprès de Lake Formation. 

## CatalogInput structure
<a name="aws-glue-api-catalog-catalogs-CatalogInput"></a>

Structure qui décrit les propriétés du catalogue.

**Champs**
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au modèle de chaîne à plusieurs lignes d’adresse URI. Une description du catalogue de données.
+ `FederatedCatalog` – Un objet [FederatedCatalog](#aws-glue-api-catalog-catalogs-FederatedCatalog).

  Un objet `FederatedCatalog`. `FederatedCatalog`Structure qui fait référence à une entité extérieure au catalogue de AWS Glue données, par exemple une base de données Redshift.
+ `Parameters` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Un tableau de mappage de paires clé-valeur qui définissent les paramètres et les propriétés du catalogue.
+ `TargetRedshiftCatalog` – Un objet [TargetRedshiftCatalog](#aws-glue-api-catalog-catalogs-TargetRedshiftCatalog).

  Objet `TargetRedshiftCatalog` qui décrit un catalogue cible pour la liaison de ressources.
+ `CatalogProperties` – Un objet [CatalogProperties](#aws-glue-api-catalog-catalogs-CatalogProperties).

  Objet `CatalogProperties` qui spécifie les propriétés d’accès au lac de données et d’autres propriétés personnalisées.
+ `CreateTableDefaultPermissions` : un tableau d’objets [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions).

  Tableau d’objets `PrincipalPermissions`. Crée un ensemble d’autorisations par défaut sur la/les table(s) pour les principaux. Utilisé par AWS Lake Formation. Il doit généralement être défini explicitement sous forme de liste vide.
+ `CreateDatabaseDefaultPermissions` : un tableau d’objets [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions).

  Tableau d’objets `PrincipalPermissions`. Crée un ensemble d’autorisations par défaut sur la/les base(s) de données pour les principaux. Utilisé par AWS Lake Formation. Il doit généralement être défini explicitement sous forme de liste vide.
+ `AllowFullTableExternalDataAccess` – Chaîne UTF-8 (valeurs valides : `True` \$1 `False`).

   Permet à des moteurs tiers d'accéder aux données Amazon S3 situées dans des emplacements enregistrés auprès de Lake Formation. 

## TargetRedshiftCatalog structure
<a name="aws-glue-api-catalog-catalogs-TargetRedshiftCatalog"></a>

Structure qui décrit un catalogue cible pour la liaison de ressources.

**Champs**
+ `CatalogArn` – *Obligatoire :* chaîne UTF-8.

  Amazon Resource Name (ARN) de la ressource de catalogue.

## CatalogProperties structure
<a name="aws-glue-api-catalog-catalogs-CatalogProperties"></a>

Structure qui spécifie les propriétés d’accès au lac de données et d’autres propriétés personnalisées.

**Champs**
+ `DataLakeAccessProperties` – Un objet [DataLakeAccessProperties](#aws-glue-api-catalog-catalogs-DataLakeAccessProperties).

  `DataLakeAccessProperties`Objet qui spécifie les propriétés permettant de configurer l'accès au lac de données pour la ressource de votre catalogue dans le catalogue de AWS Glue données.
+ `IcebergOptimizationProperties` : un objet [IcebergOptimizationProperties](#aws-glue-api-catalog-catalogs-IcebergOptimizationProperties).

  Structure qui spécifie les propriétés d’optimisation de table Iceberg pour le catalogue. Cela inclut la configuration des opérations de compactage, de conservation et de suppression de fichiers orphelins qui peuvent être appliquées aux tables Iceberg de ce catalogue.
+ `CustomProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Propriétés clé-valeur supplémentaires pour le catalogue, telles que les optimisations des statistiques de colonne.

## CatalogPropertiesOutput structure
<a name="aws-glue-api-catalog-catalogs-CatalogPropertiesOutput"></a>

Attributs de propriété qui incluent les propriétés de configuration pour la ressource du catalogue.

**Champs**
+ `DataLakeAccessProperties` – Un objet [DataLakeAccessPropertiesOutput](#aws-glue-api-catalog-catalogs-DataLakeAccessPropertiesOutput).

  `DataLakeAccessProperties`Objet doté de propriétés d'entrée permettant de configurer l'accès au lac de données pour les ressources de votre catalogue dans le catalogue de AWS Glue données.
+ `IcebergOptimizationProperties` : un objet [IcebergOptimizationPropertiesOutput](#aws-glue-api-catalog-catalogs-IcebergOptimizationPropertiesOutput).

  Objet `IcebergOptimizationPropertiesOutput` qui spécifie les paramètres d’optimisation des tables Iceberg pour le catalogue, notamment les configurations pour les opérations de compactage, de conservation et de suppression de fichiers orphelins.
+ `CustomProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Propriétés clé-valeur supplémentaires pour le catalogue, telles que les optimisations des statistiques de colonne.

## DataLakeAccessProperties structure
<a name="aws-glue-api-catalog-catalogs-DataLakeAccessProperties"></a>

Entrez des propriétés pour configurer l'accès au lac de données pour la ressource de votre catalogue dans le catalogue de AWS Glue données.

**Champs**
+ `DataLakeAccess` : booléen.

  Active ou désactive l'accès aux lacs de données pour les applications Apache Spark qui accèdent aux bases de données Amazon Redshift dans le catalogue de données à partir d'un moteur autre que Redshift, tel qu'Amazon Athena, Amazon EMR ou ETL. AWS Glue 
+ `DataTransferRole` – Chaîne UTF-8, correspondant au [Custom string pattern #53](aws-glue-api-common.md#regex_53).

  Rôle qui sera assumé par le transfert AWS Glue des données into/out du bucket intermédiaire lors d'une requête.
+ `KmsKey` – Chaîne UTF-8.

  Clé de chiffrement qui sera utilisée pour le compartiment intermédiaire qui sera créé avec le catalogue.
+ `CatalogType` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Spécifie un type de catalogue fédéré pour la ressource de catalogue native. Le type `aws:redshift` est actuellement pris en charge.

## IcebergOptimizationProperties structure
<a name="aws-glue-api-catalog-catalogs-IcebergOptimizationProperties"></a>

Structure qui spécifie les propriétés d’optimisation des tables Iceberg pour le catalogue, y compris les configurations pour les opérations de compactage, de conservation et de suppression de fichiers orphelins.

**Champs**
+ `RoleArn` – Chaîne UTF-8, correspondant au [Custom string pattern #53](aws-glue-api-common.md#regex_53).

  Amazon Resource Name (ARN) du rôle IAM qui sera endossé pour effectuer les opérations d’optimisation des tables Iceberg.
+ `Compaction` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Carte de paires clé-valeur qui spécifient les paramètres de configuration pour les opérations de compactage des tables Iceberg, qui optimisent la disposition des fichiers de données afin d’améliorer les performances des requêtes.
+ `Retention` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Carte de paires clé-valeur qui spécifient les paramètres de configuration pour les opérations de conservation des tables Iceberg, qui gèrent le cycle de vie des instantanés de tables afin de contrôler les coûts de stockage.
+ `OrphanFileDeletion` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Carte de paires clé-valeur qui spécifient les paramètres de configuration pour les opérations de suppression de fichiers orphelins Iceberg, qui identifient et suppriment les fichiers qui ne sont plus référencés par les métadonnées de table.

## DataLakeAccessPropertiesOutput structure
<a name="aws-glue-api-catalog-catalogs-DataLakeAccessPropertiesOutput"></a>

Les propriétés de sortie de la configuration d'accès au lac de données pour votre ressource de catalogue dans le catalogue de AWS Glue données.

**Champs**
+ `DataLakeAccess` : booléen.

  Active ou désactive l’accès au lac de données pour les applications Apache Spark qui accèdent aux bases de données Amazon Redshift dans le catalogue de données.
+ `DataTransferRole` – Chaîne UTF-8, correspondant au [Custom string pattern #53](aws-glue-api-common.md#regex_53).

  Rôle qui sera assumé par le transfert AWS Glue des données into/out du bucket intermédiaire lors d'une requête.
+ `KmsKey` – Chaîne UTF-8.

  Clé de chiffrement qui sera utilisée pour le compartiment intermédiaire qui sera créé avec le catalogue.
+ `ManagedWorkgroupName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du calcul Redshift sans serveur géré qui est créé pour votre ressource de catalogue.
+ `ManagedWorkgroupStatus` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  État du calcul Redshift sans serveur géré.
+ `RedshiftDatabaseName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la ressource de base de données Redshift par défaut dans le calcul géré.
+ `StatusMessage` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Message qui fournit des informations plus détaillées sur l’état du groupe de travail géré.
+ `CatalogType` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Spécifie un type de catalogue fédéré pour la ressource de catalogue native. Le type `aws:redshift` est actuellement pris en charge.

## IcebergOptimizationPropertiesOutput structure
<a name="aws-glue-api-catalog-catalogs-IcebergOptimizationPropertiesOutput"></a>

Structure qui contient les propriétés de sortie de la configuration d'optimisation des tables Iceberg pour votre ressource de catalogue dans le catalogue de AWS Glue données.

**Champs**
+ `RoleArn` – Chaîne UTF-8, correspondant au [Custom string pattern #53](aws-glue-api-common.md#regex_53).

  Amazon Resource Name (ARN) du rôle IAM qui est utilisé pour effectuer les opérations d’optimisation des tables Iceberg.
+ `Compaction` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Carte de paires clé-valeur qui spécifient les paramètres de configuration pour les opérations de compactage des tables Iceberg, qui optimisent la disposition des fichiers de données afin d’améliorer les performances des requêtes.
+ `Retention` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Carte de paires clé-valeur qui spécifient les paramètres de configuration pour les opérations de conservation des tables Iceberg, qui gèrent le cycle de vie des instantanés de tables afin de contrôler les coûts de stockage.
+ `OrphanFileDeletion` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Carte de paires clé-valeur qui spécifient les paramètres de configuration pour les opérations de suppression de fichiers orphelins Iceberg, qui identifient et suppriment les fichiers qui ne sont plus référencés par les métadonnées de table.
+ `LastUpdatedTime` – Horodatage.

  Horodatage de la dernière mise à jour des propriétés d’optimisation Iceberg.

## FederatedCatalog structure
<a name="aws-glue-api-catalog-catalogs-FederatedCatalog"></a>

Catalogue qui pointe vers une entité extérieure au catalogue AWS Glue de données.

**Champs**
+ `Identifier` – Chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique pour le catalogue fédéré.
+ `ConnectionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la connexion à une source de données externe, par exemple un catalogue fédéré par Redshift.
+ `ConnectionType` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Type de connexion utilisé pour accéder au catalogue fédéré, spécifiant le protocole ou la méthode de connexion à la source de données externe.

## Opérations
<a name="aws-glue-api-catalog-catalogs-actions"></a>
+ [CreateCatalog action (Python : create\$1catalog)](#aws-glue-api-catalog-catalogs-CreateCatalog)
+ [UpdateCatalog action (Python : update\$1catalog)](#aws-glue-api-catalog-catalogs-UpdateCatalog)
+ [DeleteCatalog action (Python : supprimer\$1catalogue)](#aws-glue-api-catalog-catalogs-DeleteCatalog)
+ [GetCatalog action (Python : get\$1catalog)](#aws-glue-api-catalog-catalogs-GetCatalog)
+ [GetCatalogs action (Python : get\$1catalogs)](#aws-glue-api-catalog-catalogs-GetCatalogs)

## CreateCatalog action (Python : create\$1catalog)
<a name="aws-glue-api-catalog-catalogs-CreateCatalog"></a>

Crée un nouveau catalogue dans le catalogue AWS Glue de données.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 64 octets, correspondant au [Custom string pattern #25](aws-glue-api-common.md#regex_25).

  Nom du catalogue à créer.
+ `CatalogInput` – *Obligatoire :* un objet [CatalogInput](#aws-glue-api-catalog-catalogs-CatalogInput).

  Objet `CatalogInput` qui définit les métadonnées du catalogue.
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Tableau de mappage de paires valeur-clé, avec 50 paires au maximum. Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets. Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets. Les balises que vous attribuez au catalogue.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `FederatedResourceAlreadyExistsException`
+ `FederationSourceException`

## UpdateCatalog action (Python : update\$1catalog)
<a name="aws-glue-api-catalog-catalogs-UpdateCatalog"></a>

Met à jour les propriétés d'un catalogue existant dans le catalogue de AWS Glue données.

**Demande**
+ `CatalogId` – *Obligatoire :* Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID du catalogue.
+ `CatalogInput` – *Obligatoire :* un objet [CatalogInput](#aws-glue-api-catalog-catalogs-CatalogInput).

  Objet `CatalogInput` spécifiant les nouvelles propriétés d’un catalogue existant.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `AccessDeniedException`
+ `FederationSourceException`

## DeleteCatalog action (Python : supprimer\$1catalogue)
<a name="aws-glue-api-catalog-catalogs-DeleteCatalog"></a>

Supprime le catalogue spécifié du catalogue de AWS Glue données.

Une fois cette opération terminée, vous n'avez plus accès aux bases de données, aux tables (ni à toutes les versions de tables et partitions susceptibles d'appartenir aux tables) ni aux fonctions définies par l'utilisateur dans le catalogue supprimé. AWS Glue supprime ces ressources « orphelines » de manière asynchrone en temps opportun, à la discrétion du service.

Pour garantir la suppression immédiate de toutes les ressources connexes, avant d’appeler l’opération `DeleteCatalog`, utilisez `DeleteTableVersion` (ou `BatchDeleteTableVersion`), `DeletePartition` (ou `BatchDeletePartition`), `DeleteTable` (ou `BatchDeleteTable`) `DeleteUserDefinedFunction` et `DeleteDatabase` pour supprimer les ressources appartenant au catalogue.

**Demande**
+ `CatalogId` – *Obligatoire :* Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID du catalogue.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `AccessDeniedException`
+ `FederationSourceException`

## GetCatalog action (Python : get\$1catalog)
<a name="aws-glue-api-catalog-catalogs-GetCatalog"></a>

Nom du catalogue à extraire. Il doit être entièrement en minuscules.

**Demande**
+ `CatalogId` – *Obligatoire :* Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue parent dans lequel réside le catalogue. Si aucun numéro n'est fourni, le numéro de AWS compte est utilisé par défaut.

**Réponse**
+ `Catalog` – Un objet [Catalogue](#aws-glue-api-catalog-catalogs-Catalog).

  Un objet `Catalog`. Définition du catalogue spécifié dans le catalogue de AWS Glue données.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## GetCatalogs action (Python : get\$1catalogs)
<a name="aws-glue-api-catalog-catalogs-GetCatalogs"></a>

Récupère tous les catalogues définis dans un catalogue dans le catalogue de données AWS Glue . Pour un cas d’utilisation de catalogue fédéré par Redshift, cette opération renvoie la liste des catalogues mappés aux bases de données Redshift dans le catalogue d’espace de noms Redshift.

**Demande**
+ `ParentCatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue parent dans lequel réside le catalogue. Si aucun numéro n'est fourni, le numéro de AWS compte est utilisé par défaut.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximum de catalogues renvoyés par réponse.
+ `Recursive` : booléen.

  Indique s’il faut répertorier tous les catalogues de la hiérarchie des catalogues, en commençant par la valeur `ParentCatalogId`. La valeur par défaut est `false` . Lorsque `true`, tous les objets du catalogue de la hiérarchie `ParentCatalogID` sont énumérés dans la réponse.
+ `IncludeRoot` : booléen.

  Indique s’il faut répertorier le catalogue par défaut dans le compte et la région dans la réponse. La valeur par défaut est `false` . Quand `true` et `ParentCatalogId = NULL | AWS Account ID`, tous les catalogues et le catalogue par défaut sont énumérés dans la réponse.

  Lorsque la valeur `ParentCatalogId` n’est pas égal à null et que cet attribut est transmis en tant que `false` ou `true`, une `InvalidInputException` est émise.

**Réponse**
+ `CatalogList` – *Obligatoire :* un tableau d’objets [Catalogue](#aws-glue-api-catalog-catalogs-Catalog).

  Tableau d’objets `Catalog`. Liste d’objets `Catalog` à partir du catalogue parent spécifié.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation pour la pagination de la liste des jetons renvoyés, renvoyé si le segment actuel de la liste n’est pas le dernier.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

# API d'une base de données
<a name="aws-glue-api-catalog-databases"></a>

L'API de base de données décrit les types de données d'une base de données et comprend l'API permettant de créer, supprimer, localiser, mettre à jour et répertorier des bases de données.

## Types de données
<a name="aws-glue-api-catalog-databases-objects"></a>
+ [Structure Database](#aws-glue-api-catalog-databases-Database)
+ [DatabaseInput structure](#aws-glue-api-catalog-databases-DatabaseInput)
+ [PrincipalPermissions structure](#aws-glue-api-catalog-databases-PrincipalPermissions)
+ [DataLakePrincipal structure](#aws-glue-api-catalog-databases-DataLakePrincipal)
+ [DatabaseIdentifier structure](#aws-glue-api-catalog-databases-DatabaseIdentifier)
+ [FederatedDatabase structure](#aws-glue-api-catalog-databases-FederatedDatabase)

## Structure Database
<a name="aws-glue-api-catalog-databases-Database"></a>

L'objet `Database` représente un groupement logique de tables pouvant résider dans un metastore Hive ou un SGBDR.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données. Pour des raisons de compatibilité avec Hive, ce nom est converti en minuscules lors de son stockage.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de la base de données.
+ `LocationUri` – Identificateur de ressource uniforme (URI), d'une longueur comprise entre 1 et 1024 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Emplacement de la base de données (par exemple, un chemin HDFS).
+ `Parameters` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Ces paires clé-valeur définissent les paramètres et les propriétés de la base de données.
+ `CreateTime` – Horodatage.

  Heure à laquelle la base de données de métadonnées a été créée dans le catalogue.
+ `CreateTableDefaultPermissions` : un tableau d’objets [PrincipalPermissions](#aws-glue-api-catalog-databases-PrincipalPermissions).

  Crée un ensemble d'autorisations par défaut sur le tableau pour les principaux. Utilisé par AWS Lake Formation. Non utilisé dans le cours normal des AWS Glue opérations.
+ `TargetDatabase` – Un objet [DatabaseIdentifier](#aws-glue-api-catalog-databases-DatabaseIdentifier).

  Structure `DatabaseIdentifier` qui décrit une base de données cible pour la liaison de ressources.
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel réside la base de données.
+ `FederatedDatabase` – Un objet [FederatedDatabase](#aws-glue-api-catalog-databases-FederatedDatabase).

  Une structure `FederatedDatabase` qui fait référence à une entité extérieure à AWS Glue Data Catalog.

## DatabaseInput structure
<a name="aws-glue-api-catalog-databases-DatabaseInput"></a>

Structure utilisée pour créer ou mettre à jour une base de données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données. Pour des raisons de compatibilité avec Hive, ce nom est converti en minuscules lors de son stockage.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de la base de données.
+ `LocationUri` – Identificateur de ressource uniforme (URI), d'une longueur comprise entre 1 et 1024 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Emplacement de la base de données (par exemple, un chemin HDFS). 
+ `Parameters` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Ces paires clé-valeur définissent les paramètres et les propriétés de la base de données.

  Ces paires clé-valeur définissent les paramètres et les propriétés de la base de données.
+ `CreateTableDefaultPermissions` : un tableau d’objets [PrincipalPermissions](#aws-glue-api-catalog-databases-PrincipalPermissions).

  Crée un ensemble d'autorisations par défaut sur le tableau pour les principaux. Utilisé par AWS Lake Formation. Non utilisé dans le cours normal des AWS Glue opérations.
+ `TargetDatabase` – Un objet [DatabaseIdentifier](#aws-glue-api-catalog-databases-DatabaseIdentifier).

  Structure `DatabaseIdentifier` qui décrit une base de données cible pour la liaison de ressources.
+ `FederatedDatabase` – Un objet [FederatedDatabase](#aws-glue-api-catalog-databases-FederatedDatabase).

  Une structure `FederatedDatabase` qui fait référence à une entité extérieure à AWS Glue Data Catalog.

## PrincipalPermissions structure
<a name="aws-glue-api-catalog-databases-PrincipalPermissions"></a>

Autorisations accordées à un principal.

**Champs**
+ `Principal` – Un objet [DataLakePrincipal](#aws-glue-api-catalog-databases-DataLakePrincipal).

  Principal à qui les autorisations sont accordées.
+ `Permissions` – Tableau de chaînes UTF-8.

  Autorisations accordées au principal.

## DataLakePrincipal structure
<a name="aws-glue-api-catalog-databases-DataLakePrincipal"></a>

Le AWS Lake Formation directeur.

**Champs**
+ `DataLakePrincipalIdentifier` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets.

  Un identifiant pour le AWS Lake Formation principal.

## DatabaseIdentifier structure
<a name="aws-glue-api-catalog-databases-DatabaseIdentifier"></a>

Structure qui décrit une base de données cible pour la liaison de ressources.

**Champs**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel réside la base de données.
+ `DatabaseName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue.
+ `Region` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Région de la base de données cible.

## FederatedDatabase structure
<a name="aws-glue-api-catalog-databases-FederatedDatabase"></a>

Une base de données qui pointe vers une entité extérieure à AWS Glue Data Catalog.

**Champs**
+ `Identifier` – Chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Un identifiant unique pour la base de données fédérée.
+ `ConnectionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de la connexion au métastore externe.
+ `ConnectionType` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Type de connexion utilisé pour accéder à la base de données fédérée, tel que JDBC, ODBC ou d’autres protocoles de connexion pris en charge.

## Opérations
<a name="aws-glue-api-catalog-databases-actions"></a>
+ [CreateDatabase action (Python : créer\$1base de données)](#aws-glue-api-catalog-databases-CreateDatabase)
+ [UpdateDatabase action (Python : update\$1database)](#aws-glue-api-catalog-databases-UpdateDatabase)
+ [DeleteDatabase action (Python : supprimer\$1base de données)](#aws-glue-api-catalog-databases-DeleteDatabase)
+ [GetDatabase action (Python : get\$1database)](#aws-glue-api-catalog-databases-GetDatabase)
+ [GetDatabases action (Python : get\$1databases)](#aws-glue-api-catalog-databases-GetDatabases)

## CreateDatabase action (Python : créer\$1base de données)
<a name="aws-glue-api-catalog-databases-CreateDatabase"></a>

Crée une nouvelle base de données dans un catalogue de données.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel créer la base de données. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseInput` – *Obligatoire :* un objet [DatabaseInput](#aws-glue-api-catalog-databases-DatabaseInput).

  Métadonnées pour la base de données.
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Les balises que vous attribuez à la base de données.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `FederatedResourceAlreadyExistsException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## UpdateDatabase action (Python : update\$1database)
<a name="aws-glue-api-catalog-databases-UpdateDatabase"></a>

Met à jour une définition de base de données existante dans un catalogue de données.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel réside la base de données de métadonnées. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données à mettre à jour dans le catalogue. Pour la compatibilité Hive, ce nom est converti en minuscules.
+ `DatabaseInput` – *Obligatoire :* un objet [DatabaseInput](#aws-glue-api-catalog-databases-DatabaseInput).

  Objet `DatabaseInput` spécifiant la nouvelle définition de la base de données de métadonnées dans le catalogue.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
+ `AlreadyExistsException`

## DeleteDatabase action (Python : supprimer\$1base de données)
<a name="aws-glue-api-catalog-databases-DeleteDatabase"></a>

Supprime une base de données spécifiée d'un catalogue de données.

**Note**  
Une fois cette opération terminée, vous n'avez plus accès aux tables (ni à toutes les versions de tables et partitions susceptibles d'appartenir aux tables) ni aux fonctions définies par l'utilisateur dans la base de données supprimée. AWS Glue supprime ces ressources « orphelines » de manière asynchrone en temps opportun, à la discrétion du service.  
Pour garantir la suppression immédiate de toutes les ressources connexes, avant d'appeler `DeleteDatabase`, utilisez `DeleteTableVersion` ou `BatchDeleteTableVersion`, `DeletePartition` ou `BatchDeletePartition`, `DeleteUserDefinedFunction`, et `DeleteTable` ou `BatchDeleteTable` pour supprimer les ressources appartenant à la base de données.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel réside la base de données. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données à supprimer. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## GetDatabase action (Python : get\$1database)
<a name="aws-glue-api-catalog-databases-GetDatabase"></a>

Extrait la définition d'une base de données spécifiée.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel réside la base de données. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom la base de données à extraire. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.

**Réponse**
+ `Database` – Un objet [Base de données](#aws-glue-api-catalog-databases-Database).

  Définition de la base de données spécifiée dans le catalogue de données.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## GetDatabases action (Python : get\$1databases)
<a name="aws-glue-api-catalog-databases-GetDatabases"></a>

Extrait toutes les bases de données définies dans un catalogue de données donnée.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données à partir duquel extraire `Databases`. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.
+ `MaxResults` – Nombre (entier), compris entre 1 et 100.

  Nombre maximum de bases de données renvoyées par réponse.
+ `ResourceShareType` – Chaîne UTF-8 (valeurs valides : `FOREIGN` \$1 `ALL` \$1 `FEDERATED`).

  Permet de spécifier que vous souhaitez répertorier les bases de données partagées avec votre compte. Les valeurs autorisées sont `FEDERATED`, `FOREIGN` ou `ALL`. 
  + Si la valeur est définie sur `FEDERATED`, la liste des bases de données fédérées (référençant une entité externe) partagées avec votre compte sera affichée.
  + Si défini sur `FOREIGN`, répertorie les bases de données partagées avec votre compte. 
  + Si défini sur `ALL`, répertorie les bases de données partagées avec votre compte, ainsi que les bases de données dans votre compte local. 
+ `AttributesToGet` – Tableau de chaînes UTF-8.

  Spécifie les champs de base de données renvoyés par l’appel `GetDatabases`. Ce paramètre n’accepte pas une liste vide. La demande doit inclure le `NAME`.

**Réponse**
+ `DatabaseList` – *Obligatoire :* un tableau d’objets [Base de données](#aws-glue-api-catalog-databases-Database).

  Liste d'objets `Database` à partir du catalogue spécifié.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation pour la pagination de la liste des jetons renvoyés, renvoyé si le segment actuel de la liste n’est pas le dernier.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `EntityNotFoundException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

# API de table
<a name="aws-glue-api-catalog-tables"></a>

L'API de tableau décrit les types de données et les opérations associés aux tableaux.

## Types de données
<a name="aws-glue-api-catalog-tables-objects"></a>
+ [Structure de table](#aws-glue-api-catalog-tables-Table)
+ [TableInput structure](#aws-glue-api-catalog-tables-TableInput)
+ [FederatedTable structure](#aws-glue-api-catalog-tables-FederatedTable)
+ [Structure de colonne](#aws-glue-api-catalog-tables-Column)
+ [StorageDescriptor structure](#aws-glue-api-catalog-tables-StorageDescriptor)
+ [SchemaReference structure](#aws-glue-api-catalog-tables-SchemaReference)
+ [SerDeInfo structure](#aws-glue-api-catalog-tables-SerDeInfo)
+ [Structure de tri](#aws-glue-api-catalog-tables-Order)
+ [SkewedInfo structure](#aws-glue-api-catalog-tables-SkewedInfo)
+ [TableVersion structure](#aws-glue-api-catalog-tables-TableVersion)
+ [TableError structure](#aws-glue-api-catalog-tables-TableError)
+ [TableVersionError structure](#aws-glue-api-catalog-tables-TableVersionError)
+ [SortCriterion structure](#aws-glue-api-catalog-tables-SortCriterion)
+ [TableIdentifier structure](#aws-glue-api-catalog-tables-TableIdentifier)
+ [KeySchemaElement structure](#aws-glue-api-catalog-tables-KeySchemaElement)
+ [PartitionIndex structure](#aws-glue-api-catalog-tables-PartitionIndex)
+ [PartitionIndexDescriptor structure](#aws-glue-api-catalog-tables-PartitionIndexDescriptor)
+ [BackfillError structure](#aws-glue-api-catalog-tables-BackfillError)
+ [IcebergInput structure](#aws-glue-api-catalog-tables-IcebergInput)
+ [OpenTableFormatInput structure](#aws-glue-api-catalog-tables-OpenTableFormatInput)
+ [ViewDefinition structure](#aws-glue-api-catalog-tables-ViewDefinition)
+ [ViewDefinitionInput structure](#aws-glue-api-catalog-tables-ViewDefinitionInput)
+ [ViewRepresentation structure](#aws-glue-api-catalog-tables-ViewRepresentation)
+ [ViewRepresentationInput structure](#aws-glue-api-catalog-tables-ViewRepresentationInput)
+ [UpdateOpenTableFormatInput structure](#aws-glue-api-catalog-tables-UpdateOpenTableFormatInput)
+ [UpdateIcebergInput structure](#aws-glue-api-catalog-tables-UpdateIcebergInput)
+ [CreateIcebergTableInput structure](#aws-glue-api-catalog-tables-CreateIcebergTableInput)
+ [UpdateIcebergTableInput structure](#aws-glue-api-catalog-tables-UpdateIcebergTableInput)
+ [IcebergSortOrder structure](#aws-glue-api-catalog-tables-IcebergSortOrder)
+ [IcebergSortField structure](#aws-glue-api-catalog-tables-IcebergSortField)
+ [IcebergPartitionSpec structure](#aws-glue-api-catalog-tables-IcebergPartitionSpec)
+ [IcebergPartitionField structure](#aws-glue-api-catalog-tables-IcebergPartitionField)
+ [IcebergSchema structure](#aws-glue-api-catalog-tables-IcebergSchema)
+ [IcebergStructField structure](#aws-glue-api-catalog-tables-IcebergStructField)
+ [IcebergTableUpdate structure](#aws-glue-api-catalog-tables-IcebergTableUpdate)
+ [AuditContext structure](#aws-glue-api-catalog-tables-AuditContext)

## Structure de table
<a name="aws-glue-api-catalog-tables-Table"></a>

Représente un ensemble de données connexes organisées en colonnes et en lignes.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `DatabaseName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données où résident les métadonnées de table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de la table.
+ `Owner` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Propriétaire de la table.
+ `CreateTime` – Horodatage.

  Date de création de la définition de table dans le catalogue de données.
+ `UpdateTime` – Horodatage.

  Date de la dernière mise à jour de la table.
+ `LastAccessTime` – Horodatage.

  Date du dernier accès à la table. Cette information est généralement extraite de HDFS et peut ne pas être fiable.
+ `LastAnalyzedTime` – Horodatage.

  Dernière date de calcul des statistiques de colonne pour cette table.
+ `Retention` – Nombre (entier), pas plus qu'Aucun.

  Durée de conservation de la table.
+ `StorageDescriptor` – Un Objet [StorageDescriptor](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-StorageDescriptor).

  Descripteur de stockage contenant des informations sur le stockage physique de la table.
+ `PartitionKeys` : un tableau d’objets [Colonne](#aws-glue-api-catalog-tables-Column).

  Liste de colonnes par laquelle la table est partitionnée. Seuls les types primitifs sont pris en charge en tant que clés de partition.

  Lorsque vous créez un tableau utilisé par Amazon Athena et que vous ne spécifiez pas de `partitionKeys`, vous devez au moins régler la valeur de `partitionKeys` à une liste vide. Par exemple : 

  `"PartitionKeys": []`
+ `ViewOriginalText` – Chaîne UTF-8, d’une longueur maximale de 409 600 octets.

  Inclus pour la compatibilité avec Apache Hive. Non utilisé dans le cours normal des AWS Glue opérations. Si la table est une`VIRTUAL_VIEW`, une certaine Athena configuration codée en base64.
+ `ViewExpandedText` – Chaîne UTF-8, d’une longueur maximale de 409 600 octets.

  Inclus pour la compatibilité avec Apache Hive. Non utilisé dans le cours normal des AWS Glue opérations.
+ `TableType` – Chaîne UTF-8, d'une longueur maximale de 255 octets.

  Type de cette table. AWS Glue créera des tables avec le `EXTERNAL_TABLE` type. D'autres services, tels que Athena, peuvent créer des tables avec des types de tables supplémentaires. 

  AWS Glue types de tables associés :  
EXTERNAL\$1TABLE  
Attribut compatible avec Hive : indique une table non gérée par Hive.  
GOVERNED  
Utilisé par AWS Lake Formation. Le catalogue AWS Glue de données comprend`GOVERNED`.
+ `Parameters` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Ces paires clé-valeur définissent les propriétés associées à la table.
+ `CreatedBy` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Personne ou entité qui a créé la table.
+ `IsRegisteredWithLakeFormation` : booléen.

  Indique si la table a été enregistrée auprès de AWS Lake Formation.
+ `TargetTable` – Un objet [TableIdentifier](#aws-glue-api-catalog-tables-TableIdentifier).

  Structure `TableIdentifier` qui décrit une table cible pour la liaison de ressources.
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel réside la table.
+ `VersionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de la version de tableau.
+ `FederatedTable` – Un objet [FederatedTable](#aws-glue-api-catalog-tables-FederatedTable).

  Une structure `FederatedTable` qui fait référence à une entité extérieure à AWS Glue Data Catalog.
+ `ViewDefinition` – Un objet [ViewDefinition](#aws-glue-api-catalog-tables-ViewDefinition).

  Structure contenant toutes les informations qui définissent la vue, y compris le ou les dialectes de la vue, et la requête.
+ `IsMultiDialectView` : booléen.

  Spécifie si la vue prend en charge les dialectes SQL d’un ou de plusieurs différents moteurs de requête et peut donc être lue par ces moteurs.

## TableInput structure
<a name="aws-glue-api-catalog-tables-TableInput"></a>

Structure utilisé pour définir une table.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table. Pour des raisons de compatibilité avec Hive, ce nom est converti en minuscules lors de son stockage.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de la table.
+ `Owner` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Propriétaire de la table. Inclus pour la compatibilité avec Apache Hive. Non utilisé dans le cours normal des AWS Glue opérations.
+ `LastAccessTime` – Horodatage.

  Date du dernier accès à la table.
+ `LastAnalyzedTime` – Horodatage.

  Dernière date de calcul des statistiques de colonne pour cette table.
+ `Retention` – Nombre (entier), pas plus qu'Aucun.

  Durée de conservation de la table.
+ `StorageDescriptor` – Un Objet [StorageDescriptor](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-StorageDescriptor).

  Descripteur de stockage contenant des informations sur le stockage physique de la table.
+ `PartitionKeys` : un tableau d’objets [Colonne](#aws-glue-api-catalog-tables-Column).

  Liste de colonnes par laquelle la table est partitionnée. Seuls les types primitifs sont pris en charge en tant que clés de partition.

  Lorsque vous créez un tableau utilisé par Amazon Athena et que vous ne spécifiez pas de `partitionKeys`, vous devez au moins régler la valeur de `partitionKeys` à une liste vide. Par exemple : 

  `"PartitionKeys": []`
+ `ViewOriginalText` – Chaîne UTF-8, d’une longueur maximale de 409 600 octets.

  Inclus pour la compatibilité avec Apache Hive. Non utilisé dans le cours normal des AWS Glue opérations. Si la table est une`VIRTUAL_VIEW`, une certaine Athena configuration codée en base64.
+ `ViewExpandedText` – Chaîne UTF-8, d’une longueur maximale de 409 600 octets.

  Inclus pour la compatibilité avec Apache Hive. Non utilisé dans le cours normal des AWS Glue opérations.
+ `TableType` – Chaîne UTF-8, d'une longueur maximale de 255 octets.

  Type de cette table. AWS Glue créera des tables avec le `EXTERNAL_TABLE` type. D'autres services, tels que Athena, peuvent créer des tables avec des types de tables supplémentaires. 

  AWS Glue types de tables associés :  
EXTERNAL\$1TABLE  
Attribut compatible avec Hive : indique une table non gérée par Hive.  
GOVERNED  
Utilisé par AWS Lake Formation. Le catalogue AWS Glue de données comprend`GOVERNED`.
+ `Parameters` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Ces paires clé-valeur définissent les propriétés associées à la table.
+ `TargetTable` – Un objet [TableIdentifier](#aws-glue-api-catalog-tables-TableIdentifier).

  Structure `TableIdentifier` qui décrit une table cible pour la liaison de ressources.
+ `ViewDefinition` – Un objet [ViewDefinitionInput](#aws-glue-api-catalog-tables-ViewDefinitionInput).

  Structure contenant toutes les informations qui définissent la vue, y compris le ou les dialectes de la vue, et la requête.

## FederatedTable structure
<a name="aws-glue-api-catalog-tables-FederatedTable"></a>

Une table qui pointe vers une entité extérieure à AWS Glue Data Catalog.

**Champs**
+ `Identifier` – Chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Un identifiant unique pour la table fédérée.
+ `DatabaseIdentifier` – Chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Un identifiant unique pour la base de données fédérée.
+ `ConnectionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de la connexion au métastore externe.
+ `ConnectionType` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Type de connexion utilisé pour accéder à la table fédérée, spécifiant le protocole ou la méthode de connexion à la source de données externe.

## Structure de colonne
<a name="aws-glue-api-catalog-tables-Column"></a>

Colonne d'une `Table`.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de l'`Column`.
+ `Type` – Chaîne UTF-8, d’une longueur maximale de 131 072 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le type de données de `Column`.
+ `Comment` – Chaîne de commentaire, d’une longueur maximale de 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Commentaire au format de texte libre.
+ `Parameters` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Ces paires clé-valeur définissent les propriétés associées à la colonne.

## StorageDescriptor structure
<a name="aws-glue-api-catalog-tables-StorageDescriptor"></a>

Décrit le stockage physique des données de table.

**Champs**
+ `Columns` : un tableau d’objets [Colonne](#aws-glue-api-catalog-tables-Column).

  Liste des `Columns` de la table.
+ `Location` – Chaîne de localisation, d'une longueur maximale de 2 056 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Emplacement physique de la table. Par défaut, il prend la forme de l'emplacement de entrepôt, suivie de l'emplacement de la base de données dans l'entrepôt, suivi du nom de la table.
+ `AdditionalLocations` – Tableau de chaînes UTF-8.

  Liste des emplacements pointant vers le chemin d'accès où se trouve une table Delta.
+ `InputFormat` – Chaîne de format, d'une longueur maximale de 128 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Format d'entrée : `SequenceFileInputFormat` (binaire) ou `TextInputFormat` ou format personnalisé.
+ `OutputFormat` – Chaîne de format, d'une longueur maximale de 128 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Format de sortie : `SequenceFileOutputFormat` (binaire) ou `IgnoreKeyTextOutputFormat` ou format personnalisé.
+ `Compressed` : booléen.

  `True` si les données de la table sont compressées ou `False` si elles ne le sont pas.
+ `NumberOfBuckets` : nombre (entier).

  Doit être spécifié si la table contient des colonnes de dimension.
+ `SerdeInfo` – Un objet [SerDeInfo](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SerDeInfo).

  Les serialization/deserialization (SerDe) informations.
+ `BucketColumns` – Tableau de chaînes UTF-8.

  Liste de colonnes de regroupement de réducteur, de colonnes de clustérisation et de colonnes de mise en compartiment de la table.
+ `SortColumns` : un tableau d’objets [Ordre](#aws-glue-api-catalog-tables-Order).

  Liste spécifiant l'ordre de tri de chaque compartiment de la table.
+ `Parameters` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Propriétés fournies par l'utilisateur sous la forme clé-valeur.
+ `SkewedInfo` – Un objet [SkewedInfo](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SkewedInfo).

  Informations concernant les valeurs qui apparaissent fréquemment dans une colonne (valeurs asymétriques).
+ `StoredAsSubDirectories` : booléen.

  `True` si les données de la table sont stockées dans les sous-répertoires ou `False` dans le cas contraire.
+ `SchemaReference` – Un objet [SchemaReference](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SchemaReference).

  Objet qui fait référence à un schéma stocké dans le registre des AWS Glue schémas.

  Lors de la création d'une table, vous pouvez transmettre une liste vide de colonnes pour le schéma et plutôt utiliser une référence de schéma.

## SchemaReference structure
<a name="aws-glue-api-catalog-tables-SchemaReference"></a>

Objet qui fait référence à un schéma stocké dans le registre des AWS Glue schémas.

**Champs**
+ `SchemaId` – Un objet [SchemaId](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-SchemaId).

  Structure qui contient des champs d'identité de schéma. Ceci ou `SchemaVersionId` doit être fourni.
+ `SchemaVersionId` – Obligatoire : chaîne UTF-8, d'une longueur exacte de 36 octets, correspondant au [Custom string pattern #45](aws-glue-api-common.md#regex_45).

  ID unique affecté à une version du schéma. Ceci ou `SchemaId` doit être fourni.
+ `SchemaVersionNumber` – Nombre (long), compris entre 1 et 100 000.

  Numéro de version du schéma.

## SerDeInfo structure
<a name="aws-glue-api-catalog-tables-SerDeInfo"></a>

Informations sur un serialization/deserialization programme (SerDe) qui sert d'extracteur et de chargeur.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du SerDe.
+ `SerializationLibrary` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Généralement, la classe qui implémente le SerDe. Par exemple : `org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe`.
+ `Parameters` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Ces paires clé-valeur définissent les paramètres d'initialisation pour. SerDe

## Structure de tri
<a name="aws-glue-api-catalog-tables-Order"></a>

Indique l'ordre de tri d'une colonne triée.

**Champs**
+ `Column` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de la colonne.
+ `SortOrder` – *Obligatoire :* Nombre (entier), inférieur ou égal à 1.

  Indique que la colonne est triée en ordre croissant (`== 1`) ou en ordre décroissant(`==0`).

## SkewedInfo structure
<a name="aws-glue-api-catalog-tables-SkewedInfo"></a>

Spécifie les valeurs biaisées d'une table. Les valeurs biaisées sont celles qui se produisent à très haute fréquence.

**Champs**
+ `SkewedColumnNames` – Tableau de chaînes UTF-8.

  Liste des noms de colonnes qui contiennent des valeurs biaisées.
+ `SkewedColumnValues` – Tableau de chaînes UTF-8.

  Liste des valeurs qui apparaissent si fréquemment qu'elles sont considérées comme biaisées.
+ `SkewedColumnValueLocationMaps` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Mappage de valeurs biaisées avec les colonnes qui les contiennent.

## TableVersion structure
<a name="aws-glue-api-catalog-tables-TableVersion"></a>

Spécifie une version d'une table.

**Champs**
+ `Table` – Un objet [Table](#aws-glue-api-catalog-tables-Table).

  Table en question
+ `VersionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Valeur d'ID qui identifie cette version de table. Un `VersionId` est une représentation de chaîne d'un nombre entier. Chaque version est incrémentée par 1.

## TableError structure
<a name="aws-glue-api-catalog-tables-TableError"></a>

Enregistrement d'erreur pour les opérations de table.

**Champs**
+ `TableName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `ErrorDetail` – Un objet [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail).

  Détails relatifs à l'erreur.

## TableVersionError structure
<a name="aws-glue-api-catalog-tables-TableVersionError"></a>

Enregistrement d'erreur pour les opérations de version table.

**Champs**
+ `TableName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table en question.
+ `VersionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Valeur d'ID de la version en question. Un `VersionID` est une représentation de chaîne d'un nombre entier. Chaque version est incrémentée par 1.
+ `ErrorDetail` – Un objet [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail).

  Détails relatifs à l'erreur.

## SortCriterion structure
<a name="aws-glue-api-catalog-tables-SortCriterion"></a>

Spécifie un champ selon lequel trier et un ordre de tri.

**Champs**
+ `FieldName` : chaîne de valeurs, d’une longueur comprise entre 1 et 1 024 octets.

  Nom du champ sur lequel trier.
+ `Sort` – Chaîne UTF-8 (valeurs valides : `ASC="ASCENDING"` \$1 `DESC="DESCENDING"`).

  Tri croissant ou décroissant.

## TableIdentifier structure
<a name="aws-glue-api-catalog-tables-TableIdentifier"></a>

Structure qui décrit une table cible pour la liaison de ressources.

**Champs**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel réside la table.
+ `DatabaseName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue qui contient la table cible.
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table cible.
+ `Region` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Région de la table cible.

## KeySchemaElement structure
<a name="aws-glue-api-catalog-tables-KeySchemaElement"></a>

Une paire de clés de partition composée d'un nom et d'un type.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom d'une clé de partition.
+ `Type` – *Obligatoire :* chaîne UTF-8, d'une longueur comprise entre 1 et 131 072 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Type d'une clé de partition.

## PartitionIndex structure
<a name="aws-glue-api-catalog-tables-PartitionIndex"></a>

Structure pour un index de partition.

**Champs**
+ `Keys` – *Obligatoire :* Tableau de chaînes UTF-8, au moins 1 chaîne.

  Les clés de l'index de partition.
+ `IndexName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'index de partition.

## PartitionIndexDescriptor structure
<a name="aws-glue-api-catalog-tables-PartitionIndexDescriptor"></a>

Descripteur d'un index de partition dans une table.

**Champs**
+ `IndexName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'index de partition.
+ `Keys` – *Obligatoire :* Tableau d'objets [KeySchemaElement](#aws-glue-api-catalog-tables-KeySchemaElement), au moins 1 structure.

  Liste d'une ou plusieurs clés, sous forme de structures `KeySchemaElement`, pour l'index de partition.
+ `IndexStatus` – *Obligatoire* :Chaîne UTF-8 (valeurs valides : `CREATING` \$1 `ACTIVE` \$1 `DELETING` \$1 `FAILED`).

  Statut de l'index de partition. 

  Les statuts possibles sont les suivants :
  + CRÉATION : l'index est en cours de création. Lorsqu'un index est dans un état CRÉATION, l'index ou sa table ne peut pas être supprimé.
  + ACTIVE : la création de l'index a réussi.
  + ÉCHEC : la création de l'index a échoué. 
  + SUPPRESSION : l'index est supprimé de la liste des index.
+ `BackfillErrors` : un tableau d’objets [BackfillError](#aws-glue-api-catalog-tables-BackfillError).

  Liste d'erreurs qui peuvent se produire lors de l'enregistrement d'index de partition pour une table existante.

## BackfillError structure
<a name="aws-glue-api-catalog-tables-BackfillError"></a>

Liste d'erreurs qui peuvent se produire lors de l'enregistrement d'index de partition pour une table existante.

Ces erreurs donnent les détails sur la raison pour laquelle un enregistrement d'index a échoué et fournissent un nombre limité de partitions dans la réponse, de sorte que vous pouvez corriger les partitions défaillantes et essayer d'enregistrer à nouveau l'index. Les erreurs les plus courantes pouvant se produire sont classées comme suit :
+ EncryptedPartitionError: Les partitions sont cryptées.
+ InvalidPartitionTypeDataError: La valeur de la partition ne correspond pas au type de données de cette colonne de partition.
+ MissingPartitionValueError: Les partitions sont cryptées.
+ UnsupportedPartitionCharacterError: Les caractères contenus dans la valeur de partition ne sont pas pris en charge. Par exemple : U\$10000, U\$10001, U\$10002.
+ InternalError: Toute erreur qui n'appartient pas à d'autres codes d'erreur.

**Champs**
+ `Code` – Chaîne UTF-8 (valeurs valides : `ENCRYPTED_PARTITION_ERROR` \$1 `INTERNAL_ERROR` \$1 `INVALID_PARTITION_TYPE_DATA_ERROR` \$1 `MISSING_PARTITION_VALUE_ERROR` \$1 `UNSUPPORTED_PARTITION_CHARACTER_ERROR`).

  Code d'erreur correspondant à une erreur survenue lors de l'enregistrement d'index de partition pour une table existante.
+ `Partitions` : un tableau d’objets [PartitionValueList](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionValueList).

  Liste d'un nombre limité de partitions dans la réponse.

## IcebergInput structure
<a name="aws-glue-api-catalog-tables-IcebergInput"></a>

Une structure qui définit une table de métadonnées Apache Iceberg à créer dans le catalogue.

**Champs**
+ `MetadataOperation` – *Obligatoire* : Chaîne UTF-8 (valeurs valides : `CREATE`).

  Une opération de métadonnées obligatoire. Ne peut être défini que sur `CREATE`.
+ `Version` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  La version de table pour la table Iceberg. La valeur par défaut est 2.
+ `CreateIcebergTableInput` – Un objet [CreateIcebergTableInput](#aws-glue-api-catalog-tables-CreateIcebergTableInput).

  Les paramètres de configuration requis pour créer une nouvelle table Iceberg dans le catalogue de AWS Glue données, y compris les propriétés de la table et les spécifications des métadonnées.

## OpenTableFormatInput structure
<a name="aws-glue-api-catalog-tables-OpenTableFormatInput"></a>

Une structure représentant un tableau au format ouvert.

**Champs**
+ `IcebergInput` : un objet [IcebergInput](#aws-glue-api-catalog-tables-IcebergInput).

  Spécifie une structure `IcebergInput` qui définit une table de métadonnées Apache Iceberg.

## ViewDefinition structure
<a name="aws-glue-api-catalog-tables-ViewDefinition"></a>

Structure contenant les détails des représentations.

**Champs**
+ `IsProtected` : booléen.

  Vous pouvez définir cet indicateur sur true pour indiquer au moteur de ne pas transférer les opérations fournies par l’utilisateur dans le plan logique de la vue lors de la planification des requêtes. Cependant, le réglage de cet indicateur ne garantit pas que le moteur sera conforme. Reportez-vous à la documentation du moteur pour comprendre les garanties fournies, le cas échéant.
+ `Definer` – chaîne UTF-8, d’une longueur comprise entre 20 et 2048 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Définisseur d’une vue dans SQL.
+ `SubObjects` : tableau de chaînes UTF-8, avec 10 chaînes maximum.

  Liste des tables Amazon Resource Names (ARNs).
+ `Representations` – tableau d’objets [ViewRepresentation](#aws-glue-api-catalog-tables-ViewRepresentation), avec 1 structure minimum et 1 000 structures maximum.

  Liste de représentations.

## ViewDefinitionInput structure
<a name="aws-glue-api-catalog-tables-ViewDefinitionInput"></a>

Structure contenant les détails relatifs à la création ou à la mise à jour d'une AWS Glue vue.

**Champs**
+ `IsProtected` : booléen.

  Vous pouvez définir cet indicateur sur true pour indiquer au moteur de ne pas transférer les opérations fournies par l’utilisateur dans le plan logique de la vue lors de la planification des requêtes. Cependant, le réglage de cet indicateur ne garantit pas que le moteur sera conforme. Reportez-vous à la documentation du moteur pour comprendre les garanties fournies, le cas échéant.
+ `Definer` – chaîne UTF-8, d’une longueur comprise entre 20 et 2048 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Définisseur d’une vue dans SQL.
+ `Representations` – Tableau d’objets [ViewRepresentationInput](#aws-glue-api-catalog-tables-ViewRepresentationInput), avec 1 structure minimum et 10 structures maximum.

  Liste de structures contenant le dialecte de la vue et la requête qui définit la vue.
+ `SubObjects` : tableau de chaînes UTF-8, avec 10 chaînes maximum.

  Liste des tables de base ARNs qui constituent la vue.

## ViewRepresentation structure
<a name="aws-glue-api-catalog-tables-ViewRepresentation"></a>

Structure contenant le dialecte de la vue et la requête qui définit la vue.

**Champs**
+ `Dialect` – Chaîne UTF-8 (valeurs valides : `REDSHIFT` \$1 `ATHENA` \$1 `SPARK`).

  Dialecte du moteur de requête.
+ `DialectVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets.

  Version du dialecte du moteur de requête. Par exemple, 3.0.0.
+ `ViewOriginalText` – Chaîne UTF-8, d’une longueur maximale de 409 600 octets.

  Requête `SELECT` fournie par le client pendant `CREATE VIEW DDL`. Ce code SQL n’est pas utilisé lors d’une requête sur une vue (`ViewExpandedText` est utilisé à la place). `ViewOriginalText` est utilisé dans les cas comme `SHOW CREATE VIEW` où les utilisateurs souhaitent voir la commande DDL d’origine qui a créé la vue.
+ `ViewExpandedText` – Chaîne UTF-8, d’une longueur maximale de 409 600 octets.

  Code SQL étendu pour la vue. Ce code SQL est utilisé par les moteurs lors du traitement d’une requête sur une vue. Les moteurs peuvent effectuer des opérations lors de la création de la vue pour transformer `ViewOriginalText` en `ViewExpandedText`. Par exemple :
  + Identifiants entièrement qualifiés : `SELECT * from table1 -> SELECT * from db1.table1`
+ `ValidationConnection` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la connexion à utiliser pour valider la représentation spécifique de la vue.
+ `IsStale` : booléen.

  Les dialectes marqués comme périmés ne sont plus valides et doivent être mis à jour avant de pouvoir être interrogés dans leurs moteurs de requêtes respectifs.

## ViewRepresentationInput structure
<a name="aws-glue-api-catalog-tables-ViewRepresentationInput"></a>

Structure contenant les détails d’une représentation pour mettre à jour ou créer une vue Lake Formation.

**Champs**
+ `Dialect` – Chaîne UTF-8 (valeurs valides : `REDSHIFT` \$1 `ATHENA` \$1 `SPARK`).

  Paramètre qui indique le type de moteur d’une représentation spécifique.
+ `DialectVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets.

  Paramètre qui indique la version du moteur d’une représentation spécifique.
+ `ViewOriginalText` – Chaîne UTF-8, d’une longueur maximale de 409 600 octets.

  Chaîne qui représente la requête SQL d’origine qui décrit la vue.
+ `ValidationConnection` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la connexion à utiliser pour valider la représentation spécifique de la vue.
+ `ViewExpandedText` – Chaîne UTF-8, d’une longueur maximale de 409 600 octets.

  Chaîne qui représente la requête SQL qui décrit la vue avec une ressource étendue ARNs

## UpdateOpenTableFormatInput structure
<a name="aws-glue-api-catalog-tables-UpdateOpenTableFormatInput"></a>

Paramètres d'entrée pour la mise à jour des tables au format de table ouvertes dans AWS Glue Data Catalog, servant de wrapper pour les opérations de mise à jour spécifiques au format, telles qu'Apache Iceberg.

**Champs**
+ `UpdateIcebergInput` : un objet [UpdateIcebergInput](#aws-glue-api-catalog-tables-UpdateIcebergInput).

  Paramètres de mise à jour propres à Apache Iceberg qui définissent les modifications de table à appliquer, notamment les modifications de schéma, les spécifications de partition et les propriétés de table.

## UpdateIcebergInput structure
<a name="aws-glue-api-catalog-tables-UpdateIcebergInput"></a>

Paramètres d'entrée spécifiques à la mise à jour des tables Apache Iceberg dans le catalogue de AWS Glue données, contenant les opérations de mise à jour à appliquer à une table Iceberg existante.

**Champs**
+ `UpdateIcebergTableInput` – *Obligatoire :* un objet [UpdateIcebergTableInput](#aws-glue-api-catalog-tables-UpdateIcebergTableInput).

  Opérations de mise à jour spécifiques à appliquer à la table Iceberg, contenant une liste de mises à jour qui définissent le nouvel état de la table, y compris le schéma, les partitions et les propriétés.

## CreateIcebergTableInput structure
<a name="aws-glue-api-catalog-tables-CreateIcebergTableInput"></a>

Les paramètres de configuration requis pour créer une nouvelle table Iceberg dans le catalogue de AWS Glue données, y compris les propriétés de la table et les spécifications des métadonnées.

**Champs**
+ `Location` – *Obligatoire :* chaîne de localisation, d’une longueur maximale de 2 056 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  L’emplacement S3 dans lequel les données de la table Iceberg seront stockées.
+ `Schema` – *Obligatoire :* un objet [IcebergSchema](#aws-glue-api-catalog-tables-IcebergSchema).

  Définition du schéma qui spécifie la structure, les types de champs et les métadonnées de la table Iceberg.
+ `PartitionSpec` : un objet [IcebergPartitionSpec](#aws-glue-api-catalog-tables-IcebergPartitionSpec).

  Spécification de partitionnement qui définit la manière dont les données de la table Iceberg seront organisées et partitionnées pour des performances de requête optimales.
+ `WriteOrder` : un objet [IcebergSortOrder](#aws-glue-api-catalog-tables-IcebergSortOrder).

  Spécification de l’ordre de tri qui définit la manière dont les données doivent être ordonnées au sein de chaque partition afin d’optimiser les performances des requêtes.
+ `Properties` – 

  Paires clé-valeur contenant des propriétés de table supplémentaires et des paramètres de configuration pour la table Iceberg.

## UpdateIcebergTableInput structure
<a name="aws-glue-api-catalog-tables-UpdateIcebergTableInput"></a>

Contient les opérations de mise à jour à appliquer à une table Iceberg existante dans le catalogue de AWS Glue données, définissant le nouvel état des métadonnées de la table. 

**Champs**
+ `Updates` – *Obligatoire :* un tableau d’objets [IcebergTableUpdate](#aws-glue-api-catalog-tables-IcebergTableUpdate).

  Liste des opérations de mise à jour de la table qui spécifient les modifications à apporter à la table Iceberg, notamment les modifications du schéma, les spécifications de partition et les propriétés de la table.

## IcebergSortOrder structure
<a name="aws-glue-api-catalog-tables-IcebergSortOrder"></a>

Définit la spécification de l’ordre de tri pour une table Iceberg, déterminant comment les données doivent être classées dans les partitions afin d’optimiser les performances des requêtes.

**Champs**
+ `OrderId` – *Obligatoire :* nombre (entier).

  Identifiant unique pour cette spécification d’ordre de tri dans les métadonnées de la table Iceberg.
+ `Fields` – *Obligatoire :* un tableau d’objets [IcebergSortField](#aws-glue-api-catalog-tables-IcebergSortField).

  La liste des champs et leurs directions de tri qui définissent les critères d’ordre des données de la table Iceberg.

## IcebergSortField structure
<a name="aws-glue-api-catalog-tables-IcebergSortField"></a>

Définit un champ unique dans une spécification d’ordre de tri Iceberg, y compris le champ source, la transformation, la direction du tri et l’ordre des valeurs nulles.

**Champs**
+ `SourceId` – *Obligatoire :* nombre (entier).

  Identifiant du champ source issu du schéma de table sur lequel ce champ de tri est basé.
+ `Transform` – *Obligatoire :* chaîne UTF-8.

  Fonction de transformation appliquée au champ source avant le tri, telle que identity, bucket ou truncate.
+ `Direction` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `asc="ASC"` \$1 `desc="DESC"`).

  La direction du tri pour ce champ, soit croissant, soit décroissant.
+ `NullOrder` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `nulls-first="NULLS_FIRST"` \$1 `nulls-last="NULLS_LAST"`).

  Comportement d’ordre des valeurs nulles dans ce champ, spécifiant si les valeurs nulles doivent apparaître en premier ou en dernier dans l’ordre de tri.

## IcebergPartitionSpec structure
<a name="aws-glue-api-catalog-tables-IcebergPartitionSpec"></a>

Définit les spécifications de partitionnement d’une table Iceberg, déterminant comment les données de la table seront organisées et partitionnées pour des performances de requête optimales.

**Champs**
+ `Fields` – *Obligatoire :* un tableau d’objets [IcebergPartitionField](#aws-glue-api-catalog-tables-IcebergPartitionField).

  Liste des champs de partition qui définissent la manière dont les données de la table doivent être partitionnées, y compris les champs source et leurs transformations.
+ `SpecId` : nombre (entier).

  Identifiant unique de cette spécification de partition dans l’historique des métadonnées de la table Iceberg.

## IcebergPartitionField structure
<a name="aws-glue-api-catalog-tables-IcebergPartitionField"></a>

Définit un champ de partition unique dans une spécification de partition Iceberg, y compris le champ source, la fonction de transformation, le nom de la partition et l’identifiant unique.

**Champs**
+ `SourceId` – *Obligatoire :* nombre (entier).

  Identifiant du champ source issu du schéma de table sur lequel ce champ de partition est basé.
+ `Transform` – *Obligatoire :* chaîne UTF-8.

  Fonction de transformation appliquée au champ source pour créer la partition, telle que identity, bucket, truncate, year, month, day ou hour.
+ `Name` – *Obligatoire :* chaîne UTF-8, d’une longueur comprise entre 1 et 1024 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du champ de partition tel qu’il apparaîtra dans la structure de la table partitionnée.
+ `FieldId` : nombre (entier).

  Identifiant unique attribué à ce champ de partition dans la spécification de partition de la table Iceberg.

## IcebergSchema structure
<a name="aws-glue-api-catalog-tables-IcebergSchema"></a>

Définit la structure du schéma d’une table Iceberg, y compris les définitions de champs, les types de données et les métadonnées du schéma.

**Champs**
+ `SchemaId` : nombre (entier).

  Identifiant unique de cette version de schéma dans l’historique d’évolution du schéma de la table Iceberg.
+ `IdentifierFieldIds` : un tableau d’entiers 32 bits signés.

  Liste des identifiants de champs qui identifient de manière unique les enregistrements de la table, utilisés pour les opérations au niveau des lignes et la déduplication.
+ `Type` – Chaîne UTF-8 (valeurs valides : `struct="STRUCT"`).

  Type de racine de la structure du schéma, généralement « struct » pour les schémas de table Iceberg.
+ `Fields` – *Obligatoire :* un tableau d’objets [IcebergStructField](#aws-glue-api-catalog-tables-IcebergStructField).

  Liste des définitions de champs qui constituent le schéma de table, y compris les noms, les types et les métadonnées des champs.

## IcebergStructField structure
<a name="aws-glue-api-catalog-tables-IcebergStructField"></a>

Définit un champ unique dans un schéma de table Iceberg, y compris son identifiant, son nom, son type de données, son caractère nul et sa documentation.

**Champs**
+ `Id` – *Obligatoire :* nombre (entier).

  Identifiant unique attribué à ce champ dans le schéma de table Iceberg, utilisé pour l’évolution du schéma et le suivi des champs.
+ `Name` – *Obligatoire :* chaîne UTF-8, d’une longueur comprise entre 1 et 1024 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du champ tel qu’il apparaît dans le schéma de table et dans les opérations de requête.
+ `Type`— *Obligatoire :* une structure vide nommée `IcebergDocument`.

  Définition du type de données pour ce champ, spécifiant la structure et le format des données qu’il contient.
+ `Required` – *obligatoire :* booléen.

  Indique si ce champ est obligatoire (n’autorisant pas les valeurs nulles) ou facultatif (autorisant les valeurs nulles) dans le schéma de table.
+ `Doc` – Chaîne de commentaire, d’une longueur maximale de 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Documentation facultative ou texte de description fournissant un contexte supplémentaire sur l’objectif et l’utilisation de ce champ.

## IcebergTableUpdate structure
<a name="aws-glue-api-catalog-tables-IcebergTableUpdate"></a>

Définit un ensemble complet de mises à jour à appliquer à une table Iceberg, y compris les modifications de schéma, les modifications de partitionnement, les ajustements d’ordre de tri, les mises à jour de localisation et les modifications de propriétés.

**Champs**
+ `Schema` – *Obligatoire :* un objet [IcebergSchema](#aws-glue-api-catalog-tables-IcebergSchema).

  Définition de schéma mise à jour pour la table Iceberg, spécifiant les modifications apportées à la structure des champs, aux types de données ou aux métadonnées du schéma.
+ `PartitionSpec` : un objet [IcebergPartitionSpec](#aws-glue-api-catalog-tables-IcebergPartitionSpec).

  Spécification de partitionnement mise à jour qui définit la manière dont les données de la table doivent être réorganisées et partitionnées.
+ `SortOrder` : un objet [IcebergSortOrder](#aws-glue-api-catalog-tables-IcebergSortOrder).

  Spécification de l’ordre de tri mise à jour qui définit la manière dont les données doivent être ordonnées au sein des partitions afin d’optimiser les performances des requêtes.
+ `Location` – *Obligatoire :* chaîne de localisation, d’une longueur maximale de 2 056 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  L’emplacement S3 mis à jour dans lequel les données de la table Iceberg seront stockées.
+ `Properties` – 

  Paires clé-valeur mises à jour des propriétés de table et des paramètres de configuration pour la table Iceberg.

## AuditContext structure
<a name="aws-glue-api-catalog-tables-AuditContext"></a>

Structure contenant le contexte de l' Lake Formation audit.

**Champs**
+ `AdditionalAuditContext`— Chaîne UTF-8 d'une longueur maximale de 2 048 octets.

  Chaîne contenant les informations contextuelles d'audit supplémentaires.
+ `RequestedColumns` – Tableau de chaînes UTF-8.

  Les colonnes demandées pour l'audit.
+ `AllColumnsRequested` : booléen.

  Toutes les colonnes font l'objet d'une demande d'audit.

## Opérations
<a name="aws-glue-api-catalog-tables-actions"></a>
+ [CreateTable action (Python : créer\$1table)](#aws-glue-api-catalog-tables-CreateTable)
+ [UpdateTable action (Python : update\$1table)](#aws-glue-api-catalog-tables-UpdateTable)
+ [DeleteTable action (Python : supprimer\$1table)](#aws-glue-api-catalog-tables-DeleteTable)
+ [BatchDeleteTable action (Python : batch\$1delete\$1table)](#aws-glue-api-catalog-tables-BatchDeleteTable)
+ [GetTable action (Python : get\$1table)](#aws-glue-api-catalog-tables-GetTable)
+ [GetTables action (Python : get\$1tables)](#aws-glue-api-catalog-tables-GetTables)
+ [GetTableVersion action (Python : get\$1table\$1version)](#aws-glue-api-catalog-tables-GetTableVersion)
+ [GetTableVersions action (Python : get\$1table\$1versions)](#aws-glue-api-catalog-tables-GetTableVersions)
+ [DeleteTableVersion action (Python : supprimer\$1table\$1version)](#aws-glue-api-catalog-tables-DeleteTableVersion)
+ [BatchDeleteTableVersion action (Python : batch\$1delete\$1table\$1version)](#aws-glue-api-catalog-tables-BatchDeleteTableVersion)
+ [SearchTables action (Python : tables de recherche)](#aws-glue-api-catalog-tables-SearchTables)
+ [GetPartitionIndexes action (Python : get\$1partition\$1indexes)](#aws-glue-api-catalog-tables-GetPartitionIndexes)
+ [CreatePartitionIndex action (Python : create\$1partition\$1index)](#aws-glue-api-catalog-tables-CreatePartitionIndex)
+ [DeletePartitionIndex action (Python : delete\$1partition\$1index)](#aws-glue-api-catalog-tables-DeletePartitionIndex)
+ [GetColumnStatisticsForTable action (Python : get\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-GetColumnStatisticsForTable)
+ [UpdateColumnStatisticsForTable action (Python : update\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-UpdateColumnStatisticsForTable)
+ [DeleteColumnStatisticsForTable action (Python : delete\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-DeleteColumnStatisticsForTable)

## CreateTable action (Python : créer\$1table)
<a name="aws-glue-api-catalog-tables-CreateTable"></a>

Crée une nouvelle définition de table dans le catalogue de données.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel créer la `Table`. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Base de données du catalogue dans laquelle créer la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la table de la base de données spécifiée qui sera créée dans le catalogue de AWS Glue données.
+ `TableInput` – Un objet [TableInput](#aws-glue-api-catalog-tables-TableInput).

  Objet `TableInput` qui définit la table de métadonnées à créer dans le catalogue.
+ `PartitionIndexes` – Un tableau d'objets [PartitionIndex](#aws-glue-api-catalog-tables-PartitionIndex), 3 structures au maximum.

  Liste d'index de partition, structures de type `PartitionIndex`, à créer dans la table.
+ `TransactionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #44](aws-glue-api-common.md#regex_44).

  ID de la transaction.
+ `OpenTableFormatInput` : un objet [OpenTableFormatInput](#aws-glue-api-catalog-tables-OpenTableFormatInput).

  Spécifie une structure `OpenTableFormatInput` lors de la création d'un tableau au format ouvert.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `ResourceNotReadyException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## UpdateTable action (Python : update\$1table)
<a name="aws-glue-api-catalog-tables-UpdateTable"></a>

Met à jour une table de métadonnées dans le catalogue de données.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données où réside la table. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue où se trouve la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la table de la base de données spécifiée qui sera créée dans le catalogue de AWS Glue données.
+ `TableInput` – Un objet [TableInput](#aws-glue-api-catalog-tables-TableInput).

  Objet `TableInput` mis à jour qui définit la table de métadonnées du catalogue.
+ `SkipArchive` : booléen.

  Par défaut, `UpdateTable` crée toujours une version archivée de la table avant de la mettre à jour. Toutefois, si `skipArchive` a la valeur true, `UpdateTable` ne crée pas la version archivée.
+ `TransactionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #44](aws-glue-api-common.md#regex_44).

  L'ID de transaction auquel le contenu de la table doit être mis à jour. 
+ `VersionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID de la version selon laquelle le contenu du tableau doit être mis à jour. 
+ `ViewUpdateAction` – Chaîne UTF-8 (valeurs valides : `ADD` \$1 `REPLACE` \$1 `ADD_OR_REPLACE` \$1 `DROP`).

  Opération à effectuer lors de la mise à jour de la vue.
+ `Force` : booléen.

  Indicateur qui peut être défini sur true pour ignorer les exigences de correspondance entre le descripteur de stockage et le sous-objet.
+ `UpdateOpenTableFormatInput` : un objet [UpdateOpenTableFormatInput](#aws-glue-api-catalog-tables-UpdateOpenTableFormatInput).

  Paramètres d'entrée pour la mise à jour des tables au format de table ouvertes dans AWS Glue Data Catalog, servant de wrapper pour les opérations de mise à jour spécifiques au format, telles qu'Apache Iceberg.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`
+ `ResourceNotReadyException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
+ `AlreadyExistsException`

## DeleteTable action (Python : supprimer\$1table)
<a name="aws-glue-api-catalog-tables-DeleteTable"></a>

Supprime une définition de table du catalogue de données.

**Note**  
Après avoir effectué cette opération, vous n'avez plus accès aux versions et partitions de table appartenant à la table supprimée. AWS Glue supprime ces ressources « orphelines » de manière asynchrone en temps opportun, à la discrétion du service.  
Pour garantir la suppression immédiate de toutes les ressources connexes, avant d'appeler `DeleteTable`, utilisez `DeleteTableVersion` ou `BatchDeleteTableVersion`, et `DeletePartition` ou `BatchDeletePartition`, pour supprimer les ressources appartenant à la table.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données où réside la table. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue où se trouve la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table à supprimer. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `TransactionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #44](aws-glue-api-common.md#regex_44).

  L'ID de transaction pour laquelle supprimer le contenu de la table.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`
+ `ResourceNotReadyException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## BatchDeleteTable action (Python : batch\$1delete\$1table)
<a name="aws-glue-api-catalog-tables-BatchDeleteTable"></a>

Supprime plusieurs tables à la fois.

**Note**  
Après avoir effectué cette opération, vous n'avez plus accès aux versions et partitions de table appartenant à la table supprimée. AWS Glue supprime ces ressources « orphelines » de manière asynchrone en temps opportun, à la discrétion du service.  
Pour garantir la suppression immédiate de toutes les ressources connexes, avant d'appeler `BatchDeleteTable`, utilisez `DeleteTableVersion` ou `BatchDeleteTableVersion`, et `DeletePartition` ou `BatchDeletePartition`, pour supprimer les ressources appartenant à la table.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données où réside la table. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données de catalogue où résident les tables à supprimer. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `TablesToDelete` – *Obligatoire :* Tableau de chaînes UTF-8, avec 100 chaînes maximum.

  Liste des tables à supprimer.
+ `TransactionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #44](aws-glue-api-common.md#regex_44).

  L'ID de transaction pour laquelle supprimer le contenu de la table.

**Réponse**
+ `Errors` : un tableau d’objets [TableError](#aws-glue-api-catalog-tables-TableError).

  Liste des erreurs survenues dans la tentative de supprimer les tables spécifiées.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ResourceNotReadyException`

## GetTable action (Python : get\$1table)
<a name="aws-glue-api-catalog-tables-GetTable"></a>

Extrait la définition de `Table` d'un catalogue de données pour une table spécifiée.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données où réside la table. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue où se trouve la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table pour laquelle récupérer la définition. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `TransactionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #44](aws-glue-api-common.md#regex_44).

  L'ID de transaction pour laquelle lire le contenu de la table. 
+ `QueryAsOfTime` – Horodatage.

  L'Heure à laquelle lire le contenu de la table. S'il n'est pas défini, l'heure de validation de transaction la plus récente sera utilisée. Ne peut pas être spécifié avec `TransactionId`.
+ `AuditContext` : un objet [AuditContext](#aws-glue-api-catalog-tables-AuditContext).

  Structure contenant le [contexte de l' Lake Formation audit](https://docs.aws.amazon.com/glue/latest/webapi/API_AuditContext.html).
+ `IncludeStatusDetails` : booléen.

  Spécifie s'il faut inclure les détails du statut relatifs à une demande de création ou de mise à jour d'une vue du catalogue de AWS Glue données.

**Réponse**
+ `Table` – Un Objet [Table](#aws-glue-api-catalog-tables-Table).

  Objet `Table` qui définit la table spécifiée.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ResourceNotReadyException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## GetTables action (Python : get\$1tables)
<a name="aws-glue-api-catalog-tables-GetTables"></a>

Récupère les définitions de tout ou partie des tables dans une `Database` donnée.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID du catalogue de données où résident les tables. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Base de données du catalogue dont les tables doivent être affichées. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `Expression` – Chaîne UTF-8, d'une longueur maximale de 2 048 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Modèle d'expression régulière. S'il est présent, seules les tables dont les noms correspondent au modèle sont renvoyées.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, inclus s’il s’agit d’un appel de continuation.
+ `MaxResults` – Nombre (entier), compris entre 1 et 100.

  Nombre maximal de tables à renvoyer dans une seule réponse.
+ `TransactionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #44](aws-glue-api-common.md#regex_44).

  L'ID de transaction pour laquelle lire le contenu de la table.
+ `QueryAsOfTime` – Horodatage.

  L'Heure à laquelle lire le contenu de la table. S'il n'est pas défini, l'heure de validation de transaction la plus récente sera utilisée. Ne peut pas être spécifié avec `TransactionId`.
+ `AuditContext` : un objet [AuditContext](#aws-glue-api-catalog-tables-AuditContext).

  Structure contenant le [contexte de l' Lake Formation audit](https://docs.aws.amazon.com/glue/latest/webapi/API_AuditContext.html).
+ `IncludeStatusDetails` : booléen.

  Spécifie s'il faut inclure les détails du statut relatifs à une demande de création ou de mise à jour d'une vue du catalogue de AWS Glue données.
+ `AttributesToGet` – Tableau de chaînes UTF-8.

   Indique les champs de table renvoyés par l’appel `GetTables`. Ce paramètre n’accepte pas une liste vide. La demande doit inclure `NAME`.

  Les combinaisons de valeurs valides sont les suivantes :
  + `NAME` : nom de toutes les tables de la base de données.
  + `NAME`, `TABLE_TYPE` : noms de toutes les tables et des types de table.

**Réponse**
+ `TableList` : un tableau d’objets [Table](#aws-glue-api-catalog-tables-Table).

  Liste des objets `Table` demandés.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, présent si le segment de liste actuel n'est pas le dernier.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## GetTableVersion action (Python : get\$1table\$1version)
<a name="aws-glue-api-catalog-tables-GetTableVersion"></a>

Extrait une version spécifiée d'une table.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID du catalogue de données où résident les tables. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Base de données du catalogue où se trouve la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `VersionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Valeur d'ID de la version de table à récupérer. Un `VersionID` est une représentation de chaîne d'un nombre entier. Chaque version est incrémentée par 1. 

**Réponse**
+ `TableVersion` – Un objet [TableVersion](#aws-glue-api-catalog-tables-TableVersion).

  Version de table demandée.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## GetTableVersions action (Python : get\$1table\$1versions)
<a name="aws-glue-api-catalog-tables-GetTableVersions"></a>

Extrait une liste de chaînes qui identifient les versions disponibles d'une table spécifiée.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID du catalogue de données où résident les tables. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Base de données du catalogue où se trouve la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s'il ne s'agit pas du premier appel.
+ `MaxResults` – Nombre (entier), compris entre 1 et 100.

  Nombre maximal de versions de table à renvoyer dans une réponse.

**Réponse**
+ `TableVersions` : un tableau d’objets [TableVersion](#aws-glue-api-catalog-tables-TableVersion).

  Liste de chaînes qui identifient les versions disponibles de la table spécifiée.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, si la liste des version disponibles n'inclut pas la dernière version.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## DeleteTableVersion action (Python : supprimer\$1table\$1version)
<a name="aws-glue-api-catalog-tables-DeleteTableVersion"></a>

Supprime une version spécifiée d'une table.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID du catalogue de données où résident les tables. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Base de données du catalogue où se trouve la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `VersionId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de la version de table à supprimer. Un `VersionID` est une représentation de chaîne d'un nombre entier. Chaque version est incrémentée par 1.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## BatchDeleteTableVersion action (Python : batch\$1delete\$1table\$1version)
<a name="aws-glue-api-catalog-tables-BatchDeleteTableVersion"></a>

Supprime un lot spécifié de versions d'une table.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID du catalogue de données où résident les tables. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Base de données du catalogue où se trouve la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table. Pour la compatibilité Hive, ce nom doit être entièrement en minuscules.
+ `VersionIds` – *Obligatoire :* Tableau de chaînes UTF-8, avec 100 chaînes maximum.

  Liste IDs des versions à supprimer. Un `VersionId` est une représentation de chaîne d'un nombre entier. Chaque version est incrémentée par 1.

**Réponse**
+ `Errors` : un tableau d’objets [TableVersionError](#aws-glue-api-catalog-tables-TableVersionError).

  Liste des erreurs survenues lors de la tentative de suppression des versions de table spécifiées.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## SearchTables action (Python : tables de recherche)
<a name="aws-glue-api-catalog-tables-SearchTables"></a>

Recherche un ensemble de tables en fonction des propriétés figurant dans les métadonnées de table, ainsi que dans la base de données parent. Vous pouvez effectuer une recherche sur des conditions de texte ou de filtre. 

Vous pouvez uniquement obtenir les tables auxquelles vous avez accès en fonction des stratégies de sécurité définies dans Lake Formation. Vous avez besoin d'au moins un accès en lecture seule à la table pour qu'elle soit renvoyée. Si vous n'avez pas accès à toutes les colonnes de la table, ces colonnes ne feront pas l'objet d'une recherche lorsque la liste des tables vous sera renvoyée. Si vous avez accès aux colonnes, mais pas aux données des colonnes, ces colonnes et les métadonnées associées pour ces colonnes seront incluses dans la recherche. 

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique, composé de `account_id`.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, inclus s’il s’agit d’un appel de continuation.
+ `Filters` : un tableau d’objets [PropertyPredicate](aws-glue-api-common.md#aws-glue-api-common-PropertyPredicate).

  Liste de paires clé-valeur et comparateur utilisé pour filtrer les résultats de recherche. Renvoie toutes les entités correspondant au prédicat.

  Le membre `Comparator` du struct `PropertyPredicate` est utilisé uniquement pour les champs temporels et peut être omis pour d'autres types de champs. En outre, lors de la comparaison de valeurs de chaîne, par exemple lorsque `Key=Name`, un algorithme de correspondance floue (fuzzy match) est utilisé. Le champ `Key` (par exemple, la valeur du champ `Name`) est divisé en jetons sur certains caractères de ponctuation, par exemple -, :, \$1, etc.. Ensuite, chaque jeton est comparé de manière exacte à un membre `Value` de `PropertyPredicate`. Par exemple, si `Key=Name` et `Value=link`, les tables nommées `customer-link` et `xx-link-yy` sont retournés, mais `xxlinkyy` ne l'est pas.
+ `SearchText` : chaîne de valeurs, d’une longueur comprise entre 1 et 1 024 octets.

  Chaîne utilisée pour une recherche de texte.

  La spécification d'une valeur entre guillemets filtre en fonction d'une correspondance exacte avec cette valeur.
+ `SortCriteria` – Un tableau d'objets [SortCriterion](#aws-glue-api-catalog-tables-SortCriterion), pas plus d'une structure.

  Liste de critères de tri des résultats par un nom de champ, dans un ordre croissant ou décroissant.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximal de tables à renvoyer dans une seule réponse.
+ `ResourceShareType` – Chaîne UTF-8 (valeurs valides : `FOREIGN` \$1 `ALL` \$1 `FEDERATED`).

  Permet de spécifier que vous souhaitez rechercher les tables partagées avec votre compte. Les valeurs autorisées sont `FOREIGN` ou `ALL`. 
  + Si défini sur `FOREIGN`, effectuera une recherche dans les tables partagées avec votre compte. 
  + Si défini sur `ALL`, effectuera une recherche dans les tables partagées avec votre compte, ainsi que les tables dans votre compte local. 
+ `IncludeStatusDetails` : booléen.

  Spécifie s'il faut inclure les détails du statut relatifs à une demande de création ou de mise à jour d'une vue du catalogue de AWS Glue données.

**Réponse**
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, présent si le segment de liste actuel n'est pas le dernier.
+ `TableList` : un tableau d’objets [Table](#aws-glue-api-catalog-tables-Table).

  Liste des objets `Table` demandés. La réponse `SearchTables` renvoie uniquement les tables auxquelles vous avez accès.

**Erreurs**
+ `InternalServiceException`
+ `InvalidInputException`
+ `OperationTimeoutException`

## GetPartitionIndexes action (Python : get\$1partition\$1indexes)
<a name="aws-glue-api-catalog-tables-GetPartitionIndexes"></a>

Récupère les index de partition associés à une table.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue où réside la table.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Spécifie le nom d'une base de données à partir de laquelle vous souhaitez extraire des index de partition.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Spécifie le nom d'une table à partir de laquelle vous souhaitez extraire les index de partition.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, inclus s’il s’agit d’un appel de continuation.

**Réponse**
+ `PartitionIndexDescriptorList` : un tableau d’objets [PartitionIndexDescriptor](#aws-glue-api-catalog-tables-PartitionIndexDescriptor).

  Liste des descripteurs d'index.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, présent si le segment de liste actuel n'est pas le dernier.

**Erreurs**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `ConflictException`

## CreatePartitionIndex action (Python : create\$1partition\$1index)
<a name="aws-glue-api-catalog-tables-CreatePartitionIndex"></a>

Crée un index de partition spécifié dans une table existante.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue où réside la table.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Spécifie le nom d'une base de données dans laquelle vous souhaitez créer un index de partition.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Spécifie le nom d'une table dans laquelle vous souhaitez créer un index de partition.
+ `PartitionIndex` – *Obligatoire :* un objet [PartitionIndex](#aws-glue-api-catalog-tables-PartitionIndex).

  Spécifie une structure `PartitionIndex` pour créer un index de partition dans une table existante.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## DeletePartitionIndex action (Python : delete\$1partition\$1index)
<a name="aws-glue-api-catalog-tables-DeletePartitionIndex"></a>

Supprime un index de partition spécifié d'une table existante.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue où réside la table.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Spécifie le nom d'une base de données dont vous souhaitez supprimer un index de partition.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Spécifie le nom d'une table dont vous souhaitez supprimer un index de partition.
+ `IndexName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'index de partition à supprimer.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `ConflictException`
+ `GlueEncryptionException`

## GetColumnStatisticsForTable action (Python : get\$1column\$1statistics\$1for\$1table)
<a name="aws-glue-api-catalog-tables-GetColumnStatisticsForTable"></a>

Récupère les statistiques de table des colonnes.

L'autorisation Identity and Access Management (IAM) requise pour cette opération est `GetTable`.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données où résident les partitions en question. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données de catalogue où résident les partitions.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table des partitions.
+ `ColumnNames` – *Obligatoire :* Tableau de chaînes UTF-8, avec 100 chaînes maximum.

  Une liste des noms de colonnes.

**Réponse**
+ `ColumnStatisticsList` : un tableau d’objets [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics).

  Liste des ColumnStatistics.
+ `Errors` : un tableau d’objets [ColumnError](aws-glue-api-common.md#aws-glue-api-common-ColumnError).

  La liste de ces ColumnStatistics informations n'a pas pu être récupérée.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## UpdateColumnStatisticsForTable action (Python : update\$1column\$1statistics\$1for\$1table)
<a name="aws-glue-api-catalog-tables-UpdateColumnStatisticsForTable"></a>

Crée ou met à jour les statistiques de table des colonnes.

L'autorisation Identity and Access Management (IAM) requise pour cette opération est `UpdateTable`.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données où résident les partitions en question. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données de catalogue où résident les partitions.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table des partitions.
+ `ColumnStatisticsList` – *Obligatoire :* Un tableau d'objets [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics), 25 structures maximum.

  Liste des statistiques de la colonne.

**Réponse**
+ `Errors` : un tableau d’objets [ColumnStatisticsError](aws-glue-api-common.md#aws-glue-api-common-ColumnStatisticsError).

  Liste des ColumnStatisticsErrors.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## DeleteColumnStatisticsForTable action (Python : delete\$1column\$1statistics\$1for\$1table)
<a name="aws-glue-api-catalog-tables-DeleteColumnStatisticsForTable"></a>

Récupère les statistiques de table des colonnes.

L'autorisation Identity and Access Management (IAM) requise pour cette opération est `DeleteTable`.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données où résident les partitions en question. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données de catalogue où résident les partitions.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table des partitions.
+ `ColumnName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de la colonne.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

# API de partition
<a name="aws-glue-api-catalog-partitions"></a>

L'API de partition décrit les types de données et les opérations qui permettent de travailler avec les partitions.

## Types de données
<a name="aws-glue-api-catalog-partitions-objects"></a>
+ [Structure de partition](#aws-glue-api-catalog-partitions-Partition)
+ [PartitionInput structure](#aws-glue-api-catalog-partitions-PartitionInput)
+ [PartitionSpecWithSharedStorageDescriptor structure](#aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor)
+ [PartitionListComposingSpec structure](#aws-glue-api-catalog-partitions-PartitionListComposingSpec)
+ [PartitionSpecProxy structure](#aws-glue-api-catalog-partitions-PartitionSpecProxy)
+ [PartitionValueList structure](#aws-glue-api-catalog-partitions-PartitionValueList)
+ [Structure d'un segment](#aws-glue-api-catalog-partitions-Segment)
+ [PartitionError structure](#aws-glue-api-catalog-partitions-PartitionError)
+ [BatchUpdatePartitionFailureEntry structure](#aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry)
+ [BatchUpdatePartitionRequestEntry structure](#aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry)
+ [StorageDescriptor structure](#aws-glue-api-catalog-partitions-StorageDescriptor)
+ [SchemaReference structure](#aws-glue-api-catalog-partitions-SchemaReference)
+ [SerDeInfo structure](#aws-glue-api-catalog-partitions-SerDeInfo)
+ [SkewedInfo structure](#aws-glue-api-catalog-partitions-SkewedInfo)

## Structure de partition
<a name="aws-glue-api-catalog-partitions-Partition"></a>

Représente une tranche de données d'une table.

**Champs**
+ `Values` – Tableau de chaînes UTF-8.

  Valeurs de la partition.
+ `DatabaseName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue dans laquelle créer la partition.
+ `TableName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table de base de données dans laquelle créer la partition.
+ `CreationTime` – Horodatage.

  Heure à laquelle la partition a été créée.
+ `LastAccessTime` – Horodatage.

  Dernière date d'accès à la partition.
+ `StorageDescriptor` – Un objet [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor).

  Fournit des informations sur l'emplacement physique où la partition est stockée.
+ `Parameters` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Ces paires clé-valeur définissent les paramètre de partition.
+ `LastAnalyzedTime` – Horodatage.

  Dernière heure à laquelle les statistiques de colonne ont été calculées pour cette partition.
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel réside la partition.

## PartitionInput structure
<a name="aws-glue-api-catalog-partitions-PartitionInput"></a>

Structure utilisée pour créer et mettre à jour une partition.

**Champs**
+ `Values` – Tableau de chaînes UTF-8.

  Valeurs de la partition. Bien que ce paramètre ne soit pas requis par le SDK, vous devez spécifier ce paramètre pour une entrée valide.

  Les valeurs des clés de la nouvelle partition doivent être transmises sous la forme d'un tableau d'objets String qui doivent être classés dans le même ordre que les clés de partition qui apparaissent dans le préfixe Amazon S3. Sinon, les valeurs AWS Glue seront ajoutées aux mauvaises clés.
+ `LastAccessTime` – Horodatage.

  Dernière date d'accès à la partition.
+ `StorageDescriptor` – Un objet [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor).

  Fournit des informations sur l'emplacement physique où la partition est stockée.
+ `Parameters` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Ces paires clé-valeur définissent les paramètre de partition.
+ `LastAnalyzedTime` – Horodatage.

  Dernière heure à laquelle les statistiques de colonne ont été calculées pour cette partition.

## PartitionSpecWithSharedStorageDescriptor structure
<a name="aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor"></a>

Spécification de partition pour les partitions qui partagent un emplacement physique.

**Champs**
+ `StorageDescriptor` – Un objet [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor).

  Informations sur le partage du stockage physique.
+ `Partitions` : un tableau d’objets [Partition](#aws-glue-api-catalog-partitions-Partition).

  Liste des partitions qui partagent cet emplacement physique.

## PartitionListComposingSpec structure
<a name="aws-glue-api-catalog-partitions-PartitionListComposingSpec"></a>

Répertorie les partitions connexes.

**Champs**
+ `Partitions` : un tableau d’objets [Partition](#aws-glue-api-catalog-partitions-Partition).

  Liste des partitions dans la spécification de composition.

## PartitionSpecProxy structure
<a name="aws-glue-api-catalog-partitions-PartitionSpecProxy"></a>

Fournit un chemin d'accès racine aux partitions spécifiées.

**Champs**
+ `DatabaseName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Base de données du catalogue dans laquelle résident les partitions.
+ `TableName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table contenant les partitions.
+ `RootPath` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chemin d'accès racine du proxy pour l'adressage des partitions.
+ `PartitionSpecWithSharedSD` – Un objet [PartitionSpecWithSharedStorageDescriptor](#aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor).

  Spécification des partitions qui partagent le même emplacement de stockage physique.
+ `PartitionListComposingSpec` – Un objet [PartitionListComposingSpec](#aws-glue-api-catalog-partitions-PartitionListComposingSpec).

  Spécifie une liste de partitions.

## PartitionValueList structure
<a name="aws-glue-api-catalog-partitions-PartitionValueList"></a>

Contient une liste de valeurs définissant les partitions.

**Champs**
+ `Values` – *Obligatoire :* Tableau de chaînes UTF-8.

  Liste de valeurs.

## Structure d'un segment
<a name="aws-glue-api-catalog-partitions-Segment"></a>

Définit une région sans chevauchement des partitions d'une table, ce qui permet l'exécution en parallèle de plusieurs requêtes.

**Champs**
+ `SegmentNumber` – *Obligatoire :* Nombre (entier), pas plus qu'Aucun.

  Numéro d'index de base zéro du segment. Par exemple, si le nombre total de segments est 4, les valeurs `SegmentNumber` vont de 0 à 3.
+ `TotalSegments` – *Obligatoire :* Nombre (entier), compris entre 1 et 10.

  Nombre total de segments.

## PartitionError structure
<a name="aws-glue-api-catalog-partitions-PartitionError"></a>

Contient les informations sur une erreur de partition.

**Champs**
+ `PartitionValues` – Tableau de chaînes UTF-8.

  Valeurs qui définissent la partition.
+ `ErrorDetail` – Un objet [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail).

  Détails sur l'erreur de partition.

## BatchUpdatePartitionFailureEntry structure
<a name="aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry"></a>

Contient des informations sur une erreur de partition de mise à jour par lots.

**Champs**
+ `PartitionValueList` – Tableau de chaînes UTF-8, avec 100 chaînes maximum.

  Liste des valeurs définissant la partition.
+ `ErrorDetail` – Un objet [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail).

  Détails sur l'erreur de partition de mise à jour par lots.

## BatchUpdatePartitionRequestEntry structure
<a name="aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry"></a>

Structure contenant les valeurs et la structure utilisées pour mettre à jour une partition.

**Champs**
+ `PartitionValueList` – *Obligatoire :* Tableau de chaînes UTF-8, avec 100 chaînes maximum.

  Liste des valeurs définissant la partition.
+ `PartitionInput` – *Obligatoire :* un objet [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput).

  Structure utilisée pour mettre à jour une partition.

## StorageDescriptor structure
<a name="aws-glue-api-catalog-partitions-StorageDescriptor"></a>

Décrit le stockage physique des données de table.

**Champs**
+ `Columns` : un tableau d’objets [Colonne](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-Column).

  Liste des `Columns` de la table.
+ `Location` – Chaîne de localisation, d'une longueur maximale de 2 056 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Emplacement physique de la table. Par défaut, il prend la forme de l'emplacement de entrepôt, suivie de l'emplacement de la base de données dans l'entrepôt, suivi du nom de la table.
+ `AdditionalLocations` – Tableau de chaînes UTF-8.

  Liste des emplacements pointant vers le chemin d'accès où se trouve une table Delta.
+ `InputFormat` – Chaîne de format, d'une longueur maximale de 128 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Format d'entrée : `SequenceFileInputFormat` (binaire) ou `TextInputFormat` ou format personnalisé.
+ `OutputFormat` – Chaîne de format, d'une longueur maximale de 128 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Format de sortie : `SequenceFileOutputFormat` (binaire) ou `IgnoreKeyTextOutputFormat` ou format personnalisé.
+ `Compressed` : booléen.

  `True` si les données de la table sont compressées ou `False` si elles ne le sont pas.
+ `NumberOfBuckets` : nombre (entier).

  Doit être spécifié si la table contient des colonnes de dimension.
+ `SerdeInfo` – Un objet [SerDeInfo](#aws-glue-api-catalog-partitions-SerDeInfo).

  Les serialization/deserialization (SerDe) informations.
+ `BucketColumns` – Tableau de chaînes UTF-8.

  Liste de colonnes de regroupement de réducteur, de colonnes de clustérisation et de colonnes de mise en compartiment de la table.
+ `SortColumns` : un tableau d’objets [Ordre](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-Order).

  Liste spécifiant l'ordre de tri de chaque compartiment de la table.
+ `Parameters` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Propriétés fournies par l'utilisateur sous la forme clé-valeur.
+ `SkewedInfo` – Un objet [SkewedInfo](#aws-glue-api-catalog-partitions-SkewedInfo).

  Informations concernant les valeurs qui apparaissent fréquemment dans une colonne (valeurs asymétriques).
+ `StoredAsSubDirectories` : booléen.

  `True` si les données de la table sont stockées dans les sous-répertoires ou `False` dans le cas contraire.
+ `SchemaReference` – Un objet [SchemaReference](#aws-glue-api-catalog-partitions-SchemaReference).

  Objet qui fait référence à un schéma stocké dans le registre des AWS Glue schémas.

  Lors de la création d'une table, vous pouvez transmettre une liste vide de colonnes pour le schéma et plutôt utiliser une référence de schéma.

## SchemaReference structure
<a name="aws-glue-api-catalog-partitions-SchemaReference"></a>

Objet qui fait référence à un schéma stocké dans le registre des AWS Glue schémas.

**Champs**
+ `SchemaId` – Un objet [SchemaId](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-SchemaId).

  Structure qui contient des champs d'identité de schéma. Ceci ou `SchemaVersionId` doit être fourni.
+ `SchemaVersionId` – Obligatoire : chaîne UTF-8, d'une longueur exacte de 36 octets, correspondant au [Custom string pattern #45](aws-glue-api-common.md#regex_45).

  ID unique affecté à une version du schéma. Ceci ou `SchemaId` doit être fourni.
+ `SchemaVersionNumber` – Nombre (long), compris entre 1 et 100 000.

  Numéro de version du schéma.

## SerDeInfo structure
<a name="aws-glue-api-catalog-partitions-SerDeInfo"></a>

Informations sur un serialization/deserialization programme (SerDe) qui sert d'extracteur et de chargeur.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du SerDe.
+ `SerializationLibrary` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Généralement, la classe qui implémente le SerDe. Par exemple : `org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe`.
+ `Parameters` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne de clé, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 512 000 octets.

  Ces paires clé-valeur définissent les paramètres d'initialisation pour. SerDe

## SkewedInfo structure
<a name="aws-glue-api-catalog-partitions-SkewedInfo"></a>

Spécifie les valeurs biaisées d'une table. Les valeurs biaisées sont celles qui se produisent à très haute fréquence.

**Champs**
+ `SkewedColumnNames` – Tableau de chaînes UTF-8.

  Liste des noms de colonnes qui contiennent des valeurs biaisées.
+ `SkewedColumnValues` – Tableau de chaînes UTF-8.

  Liste des valeurs qui apparaissent si fréquemment qu'elles sont considérées comme biaisées.
+ `SkewedColumnValueLocationMaps` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Mappage de valeurs biaisées avec les colonnes qui les contiennent.

## Opérations
<a name="aws-glue-api-catalog-partitions-actions"></a>
+ [CreatePartition action (Python : créer\$1partition)](#aws-glue-api-catalog-partitions-CreatePartition)
+ [BatchCreatePartition action (Python : batch\$1create\$1partition)](#aws-glue-api-catalog-partitions-BatchCreatePartition)
+ [UpdatePartition action (Python : update\$1partition)](#aws-glue-api-catalog-partitions-UpdatePartition)
+ [DeletePartition action (Python : supprimer\$1partition)](#aws-glue-api-catalog-partitions-DeletePartition)
+ [BatchDeletePartition action (Python : batch\$1supprimer\$1partition)](#aws-glue-api-catalog-partitions-BatchDeletePartition)
+ [GetPartition action (Python : get\$1partition)](#aws-glue-api-catalog-partitions-GetPartition)
+ [GetPartitions action (Python : get\$1partitions)](#aws-glue-api-catalog-partitions-GetPartitions)
+ [BatchGetPartition action (Python : batch\$1get\$1partition)](#aws-glue-api-catalog-partitions-BatchGetPartition)
+ [BatchUpdatePartition action (Python : batch\$1update\$1partition)](#aws-glue-api-catalog-partitions-BatchUpdatePartition)
+ [GetColumnStatisticsForPartition action (Python : get\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-GetColumnStatisticsForPartition)
+ [UpdateColumnStatisticsForPartition action (Python : update\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-UpdateColumnStatisticsForPartition)
+ [DeleteColumnStatisticsForPartition action (Python : supprimer\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-DeleteColumnStatisticsForPartition)

## CreatePartition action (Python : créer\$1partition)
<a name="aws-glue-api-catalog-partitions-CreatePartition"></a>

Crée une partition.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de AWS compte du catalogue dans lequel la partition doit être créée.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données de métadonnées dans laquelle la partition doit être créée.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table de métadonnées dans laquelle la partition doit être créée.
+ `PartitionInput` – *Obligatoire :* un objet [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput).

  Structure `PartitionInput`définissant la partition à créer.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## BatchCreatePartition action (Python : batch\$1create\$1partition)
<a name="aws-glue-api-catalog-partitions-BatchCreatePartition"></a>

Crée une ou plusieurs partitions dans une opération par lot.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue dans lequel la partition doit être créée. Actuellement, il devrait s'agir de l'identifiant du AWS compte.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données de métadonnées dans laquelle la partition doit être créée.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table de métadonnées dans laquelle la partition doit être créée.
+ `PartitionInputList` – *Obligatoire :* Un tableau d'objets [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput), 100 structures maximum.

  Liste de structures `PartitionInput` qui définissent les partitions à créer.

**Réponse**
+ `Errors` : un tableau d’objets [PartitionError](#aws-glue-api-catalog-partitions-PartitionError).

  Erreurs survenues pendant la tentative de création des partitions demandées.

**Erreurs**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## UpdatePartition action (Python : update\$1partition)
<a name="aws-glue-api-catalog-partitions-UpdatePartition"></a>

Met à jour une partition.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données où réside la partition à mettre à jour. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue où se trouve la table en question.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table où se trouve la partition à mettre à jour.
+ `PartitionValueList` – *Obligatoire :* Tableau de chaînes UTF-8, avec 100 chaînes maximum.

  Liste des valeurs de clé de partition qui définissent la partition à mettre à jour.
+ `PartitionInput` – *Obligatoire :* un objet [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput).

  Nouvel objet de partition où mettre à jour la partition.

  Cette propriété `Values` ne peut pas être modifiée. Si vous souhaitez modifier les valeurs de clé de partition d'une partition, supprimez et recréez la partition.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## DeletePartition action (Python : supprimer\$1partition)
<a name="aws-glue-api-catalog-partitions-DeletePartition"></a>

Supprime une partition spécifiée.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données où réside la partition à supprimer. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue où se trouve la table en question.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table qui contient la partition à supprimer.
+ `PartitionValues` – *Obligatoire :* Tableau de chaînes UTF-8.

  Valeurs qui définissent la partition.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## BatchDeletePartition action (Python : batch\$1supprimer\$1partition)
<a name="aws-glue-api-catalog-partitions-BatchDeletePartition"></a>

Supprime une ou plusieurs partitions dans une opération par lot.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données où réside la partition à supprimer. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue où se trouve la table en question.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table contenant les partitions à supprimer.
+ `PartitionsToDelete` – *Obligatoire :* Un tableau d'objets [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList), 25 structures maximum.

  Liste de structures `PartitionInput` qui définissent les partitions à supprimer.

**Réponse**
+ `Errors` : un tableau d’objets [PartitionError](#aws-glue-api-catalog-partitions-PartitionError).

  Erreurs survenues pendant la tentative de suppression des partitions demandées.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetPartition action (Python : get\$1partition)
<a name="aws-glue-api-catalog-partitions-GetPartition"></a>

Extrait les informations sur une partition spécifiée.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données où réside la partition en question. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données de catalogue où réside la partition.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table des partitions.
+ `PartitionValues` – *Obligatoire :* Tableau de chaînes UTF-8.

  Valeurs qui définissent la partition.

**Réponse**
+ `Partition` – Un objet [Partition](#aws-glue-api-catalog-partitions-Partition).

  Informations demandées, sous la forme d'un objet `Partition`.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## GetPartitions action (Python : get\$1partitions)
<a name="aws-glue-api-catalog-partitions-GetPartitions"></a>

Extrait les informations sur les partitions d'une table.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données où résident les partitions en question. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données de catalogue où résident les partitions.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table des partitions.
+ `Expression` – Chaîne de prédicat, d'une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Expression qui filtre les partitions à renvoyer.

  L'expression utilise une syntaxe SQL similaire à la clause de filtre `WHERE` SQL. L'analyseur d'instructions SQL [JSQLParser](http://jsqlparser.sourceforge.net/home.php)analyse l'expression. 

  *Opérateurs* : voici les opérateurs que vous pouvez utiliser dans l'appel d'API `Expression` :  
=  
Vérifie si les valeurs des deux opérandes sont égales ; si c'est le cas, la condition est vraie.  
Exemple : supposons que la « variable a » et la « variable b » sont de 20.   
(a = b) n'est pas vrai.  
< >  
Vérifie si les valeurs des deux opérandes sont égales ; si ce n'est pas le cas, la condition est vraie.  
Exemple : (a < > b) est vrai.  
>  
Vérifie si la valeur de l'opérande gauche est supérieure à la valeur de l'opérande droite ; si c'est le cas, la condition est vraie.  
Exemple : (a > b) n'est pas vrai.  
<  
Vérifie si la valeur de l'opérande gauche est inférieure à la valeur de l'opérande droite ; si c'est le cas, la condition est vraie.  
Exemple : (a < b) est vrai.  
>=  
Vérifie si la valeur de l'opérande gauche est supérieure ou égale à la valeur de l'opérande droite ; si c'est le cas, la condition est vraie.  
Exemple : (a >= b) n'est pas vrai.  
<=  
Vérifie si la valeur de l'opérande gauche est inférieure ou égale à la valeur de l'opérande droite ; si c'est le cas, la condition est vraie.  
Exemple : (a <= b) est vrai.  
AND, OR, IN, BETWEEN, LIKE, NOT, IS NULL  
Opérateurs logiques.

  *Types de clés de partition prises en charge* : les clés de partition prises en charge sont énoncées ci-dessous.
  + `string`
  + `date`
  + `timestamp`
  + `int`
  + `bigint`
  + `long`
  + `tinyint`
  + `smallint`
  + `decimal`

  Si un type non valide est rencontré, une exception est levée. 

  La liste suivante présente les opérateurs valides sur chaque type. Lorsque vous définissez un crawler, le type `partitionKey` est créé en tant que `STRING`, pour être compatible avec le catalogue de partitions. 

  *Exemple d'appel d'API* :   
**Example**  

  La table `twitter_partition` comprend trois partitions :

  ```
  year = 2015
          year = 2016
          year = 2017
  ```  
**Example**  

  Obtenir la partition `year` équivalant à 2015

  ```
  aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year*=*'2015'"
  ```  
**Example**  

  Obtenir la partition `year` entre 2016 et 2018 (exclusif)

  ```
  aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year>'2016' AND year<'2018'"
  ```  
**Example**  

  Obtenir la partition `year` entre 2015 et 2018 (inclusif). Les appels d'API suivants sont équivalents :

  ```
  aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year>='2015' AND year<='2018'"
          
          aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year BETWEEN 2015 AND 2018"
          
          aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year IN (2015,2016,2017,2018)"
  ```  
**Example**  

  Une partition à caractère générique où la sortie d'appel suivante est la partition année = 2017. Une expression régulière n'est pas prise en charge dans `LIKE`.

  ```
  aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year LIKE '%7'"
  ```
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, si ce n'est pas le premier appel pour récupérer ces partitions.
+ `Segment` – Un objet [Segment](#aws-glue-api-catalog-partitions-Segment).

  Segment des partitions de la table à analyser dans cette demande.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximal de partitions à renvoyer dans une seule réponse.
+ `ExcludeColumnSchema` : booléen.

  Lorsque la valeur est « true (VRAI) », indique de ne pas renvoyer le schéma de la colonne de partition. Utile lorsque vous êtes intéressé uniquement par d'autres attributs de partition tels que les valeurs de partition ou l'emplacement. En ne renvoyant pas de données en double, cette approche évite le problème d'une grande réponse.
+ `TransactionId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #44](aws-glue-api-common.md#regex_44).

  L'ID de transaction auquel lire le contenu de la partition.
+ `QueryAsOfTime` – Horodatage.

  L'Heure à laquelle lire le contenu de la partition. S'il n'est pas défini, l'heure de validation de transaction la plus récente sera utilisée. Ne peut pas être spécifié avec `TransactionId`.

**Réponse**
+ `Partitions` : un tableau d’objets [Partition](#aws-glue-api-catalog-partitions-Partition).

  Liste des partitions demandées.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, si la liste de partitions renvoyée n'inclut pas la dernière partition.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`
+ `InvalidStateException`
+ `ResourceNotReadyException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## BatchGetPartition action (Python : batch\$1get\$1partition)
<a name="aws-glue-api-catalog-partitions-BatchGetPartition"></a>

Extrait les partitions d'une demande par lot.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données où résident les partitions en question. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données de catalogue où résident les partitions.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table des partitions.
+ `PartitionsToGet` – *Obligatoire :* Un tableau d'objets [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList), 1000 structures maximum.

  Liste des valeurs de partition qui identifie les partitions à récupérer.

**Réponse**
+ `Partitions` : un tableau d’objets [Partition](#aws-glue-api-catalog-partitions-Partition).

  Liste des partitions demandées.
+ `UnprocessedKeys` – Un tableau d'objets [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList), 1000 structures maximum.

  Liste des valeurs de partition de la demande pour laquelle les partitions n'ont pas été retournées.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`
+ `InvalidStateException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## BatchUpdatePartition action (Python : batch\$1update\$1partition)
<a name="aws-glue-api-catalog-partitions-BatchUpdatePartition"></a>

Met à jour une ou plusieurs partitions dans une opération par lot.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue dans lequel la partition doit être mise à jour. Actuellement, il devrait s'agir de l'identifiant du AWS compte.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données de métadonnées dans laquelle la partition doit être mise à jour.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table de métadonnées dans laquelle la partition doit être mise à jour.
+ `Entries` – *Obligatoire :* Tableau d'objets [BatchUpdatePartitionRequestEntry](#aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry), 1 structure minimum et 100 structures maximum.

  Une liste de jusqu'à 100 objets `BatchUpdatePartitionRequestEntry` à mettre à jour.

**Réponse**
+ `Errors` : un tableau d’objets [BatchUpdatePartitionFailureEntry](#aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry).

  Erreurs survenues pendant la tentative de mise à jour des partitions demandées. Liste d’objets `BatchUpdatePartitionFailureEntry`.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`

## GetColumnStatisticsForPartition action (Python : get\$1column\$1statistics\$1for\$1partition)
<a name="aws-glue-api-catalog-partitions-GetColumnStatisticsForPartition"></a>

Récupère les statistiques de partition des colonnes.

L'autorisation Identity and Access Management (IAM) requise pour cette opération est `GetPartition`.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données où résident les partitions en question. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données de catalogue où résident les partitions.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table des partitions.
+ `PartitionValues` – *Obligatoire :* Tableau de chaînes UTF-8.

  Liste des valeurs de partition qui identifie la partition.
+ `ColumnNames` – *Obligatoire :* Tableau de chaînes UTF-8, avec 100 chaînes maximum.

  Une liste des noms de colonnes.

**Réponse**
+ `ColumnStatisticsList` : un tableau d’objets [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics).

  La liste n' ColumnStatistics a pas pu être récupérée.
+ `Errors` : un tableau d’objets [ColumnError](aws-glue-api-common.md#aws-glue-api-common-ColumnError).

  Une erreur s'est produite lors de la récupération des données statistiques de colonne.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## UpdateColumnStatisticsForPartition action (Python : update\$1column\$1statistics\$1for\$1partition)
<a name="aws-glue-api-catalog-partitions-UpdateColumnStatisticsForPartition"></a>

Crée ou met à jour les statistiques de partition des colonnes.

L'autorisation Identity and Access Management (IAM) requise pour cette opération est `UpdatePartition`.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données où résident les partitions en question. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données de catalogue où résident les partitions.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table des partitions.
+ `PartitionValues` – *Obligatoire :* Tableau de chaînes UTF-8.

  Liste des valeurs de partition qui identifie la partition.
+ `ColumnStatisticsList` – *Obligatoire :* Un tableau d'objets [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics), 25 structures maximum.

  Liste des statistiques de la colonne.

**Réponse**
+ `Errors` : un tableau d’objets [ColumnStatisticsError](aws-glue-api-common.md#aws-glue-api-common-ColumnStatisticsError).

  Une erreur s'est produite lors de la mise à jour des données statistiques.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## DeleteColumnStatisticsForPartition action (Python : supprimer\$1column\$1statistics\$1for\$1partition)
<a name="aws-glue-api-catalog-partitions-DeleteColumnStatisticsForPartition"></a>

Supprime les statistiques de colonne de partition d'une colonne.

L'autorisation Identity and Access Management (IAM) requise pour cette opération est `DeletePartition`.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données où résident les partitions en question. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données de catalogue où résident les partitions.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table des partitions.
+ `PartitionValues` – *Obligatoire :* Tableau de chaînes UTF-8.

  Liste des valeurs de partition qui identifie la partition.
+ `ColumnName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la colonne.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

# API de connexions
<a name="aws-glue-api-catalog-connections"></a>

L'API Connections décrit les types de données et l'API liés à l'utilisation des connexions dans AWS Glue.

**Topics**
+ [API de connexion](aws-glue-api-catalog-connections-connections.md)
+ [API de types de connexion](aws-glue-api-catalog-connections-connections-type.md)
+ [Métadonnées de connexion et API de prévisualisation](aws-glue-api-catalog-connections-connections-metadata.md)

# API de connexion
<a name="aws-glue-api-catalog-connections-connections"></a>

L'API de connexion décrit les types de données de AWS Glue connexion, ainsi que l'API permettant de créer, de supprimer, de mettre à jour et de répertorier les connexions.

## Types de données
<a name="aws-glue-api-catalog-connections-connections-objects"></a>
+ [Structure de connexion](#aws-glue-api-catalog-connections-connections-Connection)
+ [ConnectionInput structure](#aws-glue-api-catalog-connections-connections-ConnectionInput)
+ [TestConnectionInput structure](#aws-glue-api-catalog-connections-connections-TestConnectionInput)
+ [PhysicalConnectionRequirements structure](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements)
+ [GetConnectionsFilter structure](#aws-glue-api-catalog-connections-connections-GetConnectionsFilter)
+ [AuthenticationConfiguration structure](#aws-glue-api-catalog-connections-connections-AuthenticationConfiguration)
+ [AuthenticationConfigurationInput structure](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput)
+ [OAuth2Structure des propriétés](#aws-glue-api-catalog-connections-connections-OAuth2Properties)
+ [OAuth2PropertiesInput structure](#aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput)
+ [OAuth2ClientApplication structure](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication)
+ [AuthorizationCodeProperties structure](#aws-glue-api-catalog-connections-connections-AuthorizationCodeProperties)
+ [BasicAuthenticationCredentials structure](#aws-glue-api-catalog-connections-connections-BasicAuthenticationCredentials)
+ [OAuth2Structure des informations d'identification](#aws-glue-api-catalog-connections-connections-OAuth2Credentials)

## Structure de connexion
<a name="aws-glue-api-catalog-connections-connections-Connection"></a>

Définit une connexion à une source de données.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la définition de connexion.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de la connexion.
+ `ConnectionType`— Chaîne UTF-8 (valeurs valides : `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` `INTERCOM` `SNAPCHATADS`\$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` \$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE`\$1 `HBASE` `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` `TPCDS` \$1`VERTICA`).

  Type de connexion. Actuellement, SFTP n'est pas pris en charge.
+ `MatchCriteria` : tableau de chaînes UTF-8, avec 10 chaînes maximum.

  Liste des critères qui peuvent être utilisés dans la sélection de cette connexion.
+ `ConnectionProperties` – Tableau de mappage de paires clé-valeur, 100 paires au maximum.

  Chaque clé est une chaîne UTF-8 (valeurs valides : `HOST` \$1 `PORT` \$1 `USERNAME="USER_NAME"` \$1 `PASSWORD` \$1 `ENCRYPTED_PASSWORD` \$1 `JDBC_DRIVER_JAR_URI` \$1 `JDBC_DRIVER_CLASS_NAME` \$1 `JDBC_ENGINE` \$1 `JDBC_ENGINE_VERSION` \$1 `CONFIG_FILES` \$1 `INSTANCE_ID` \$1 `JDBC_CONNECTION_URL` \$1 `JDBC_ENFORCE_SSL` \$1 `CUSTOM_JDBC_CERT` \$1 `SKIP_CUSTOM_JDBC_CERT_VALIDATION` \$1 `CUSTOM_JDBC_CERT_STRING` \$1 `CONNECTION_URL` \$1 `KAFKA_BOOTSTRAP_SERVERS` \$1 `KAFKA_SSL_ENABLED` \$1 `KAFKA_CUSTOM_CERT` \$1 `KAFKA_SKIP_CUSTOM_CERT_VALIDATION` \$1 `KAFKA_CLIENT_KEYSTORE` \$1 `KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `KAFKA_CLIENT_KEY_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD` \$1 `KAFKA_SASL_MECHANISM` \$1 `KAFKA_SASL_PLAIN_USERNAME` \$1 `KAFKA_SASL_PLAIN_PASSWORD` \$1 `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD` \$1 `KAFKA_SASL_SCRAM_USERNAME` \$1 `KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_SCRAM_SECRETS_ARN` \$1 `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_GSSAPI_KEYTAB` \$1 `KAFKA_SASL_GSSAPI_KRB5_CONF` \$1 `KAFKA_SASL_GSSAPI_SERVICE` \$1 `KAFKA_SASL_GSSAPI_PRINCIPAL` \$1 `SECRET_ID` \$1 `CONNECTOR_URL` \$1 `CONNECTOR_TYPE` \$1 `CONNECTOR_CLASS_NAME` \$1 `ENDPOINT` \$1 `ENDPOINT_TYPE` \$1 `ROLE_ARN` \$1 `REGION` \$1 `WORKGROUP_NAME` \$1 `CLUSTER_IDENTIFIER` \$1 `DATABASE`).

  Chaque valeur est une chaîne Valeur, d’une longueur comprise entre 1 et 1 024 octets.

  Ces paires clé-valeur définissent les paramètres pour la connexion lors de l’utilisation du schéma de connexion de la version 1 :
  + `HOST`- L'URI de l'hôte : soit le nom de domaine complet (FQDN), soit l' IPv4 adresse de l'hôte de la base de données.
  + `PORT` - Numéro du port, compris entre 1 024 et 65 535, sur lequel l'hôte de base de données écoute les connexions de la base de données.
  + `USER_NAME` - Nom sous lequel vous vous connectez à la base de données. La valeur de chaîne pour `USER_NAME` est « `USERNAME` ».
  + `PASSWORD` - Mot de passe, le cas échéant, pour le nom d'utilisateur.
  + `ENCRYPTED_PASSWORD` - Lorsque vous activez la protection de mot de passe en réglant `ConnectionPasswordEncryption` dans les paramètres de chiffrage de Catalogue de données, ce champ stocke le mot de passe chiffré.
  + `JDBC_DRIVER_JAR_URI` - Chemin d’accès Amazon Simple Storage Service (Amazon S3) du fichier JAR qui contient le pilote JDBC à utiliser.
  + `JDBC_DRIVER_CLASS_NAME` - Nom de classe du pilote JDBC à utiliser.
  + `JDBC_ENGINE` – Nom du moteur JDBC à utiliser.
  + `JDBC_ENGINE_VERSION` - Version du moteur JDBC à utiliser.
  + `CONFIG_FILES` - (Réservé pour une utilisation ultérieure.)
  + `INSTANCE_ID` - ID d'instance à utiliser.
  + `JDBC_CONNECTION_URL` - URL de connexion à une source de données JDBC.
  + `JDBC_ENFORCE_SSL` : chaîne booléenne insensible à la casse (true, false) spécifiant si Secure Sockets Layer (SSL) avec le nom d’hôte correspondant est appliqué pour la connexion JDBC sur le client. La valeur par défaut est false.
  + `CUSTOM_JDBC_CERT`- Un emplacement Amazon S3 spécifiant le certificat racine du client. AWS Glue utilise ce certificat racine pour valider le certificat du client lors de la connexion à la base de données clients. AWS Glue gère uniquement les certificats X.509. Le certificat fourni doit être codé DER et fourni au format PEM d'encodage Base64.
  + `SKIP_CUSTOM_JDBC_CERT_VALIDATION`- Par défaut, c'est le cas`false`. AWS Glue valide l'algorithme de signature et l'algorithme de clé publique du sujet pour le certificat client. Les seuls algorithmes autorisés pour l'algorithme de signature sont SHA256with RSA, RSA ou SHA384with SHA512with RSA. Pour l'algorithme de clé publique d'objet, la longueur de clé doit être d'au moins 2048. Vous pouvez mettre la valeur de cette propriété à `true` pour ignorer la validation par AWS Glue du certificat du client.
  + `CUSTOM_JDBC_CERT_STRING`- Une chaîne de certificat JDBC personnalisée qui est utilisée pour la correspondance de domaine ou de nom distinctif afin de prévenir une man-in-the-middle attaque. Dans Oracle Database, elle est utilisée comme `SSL_SERVER_CERT_DN`. Dans Microsoft SQL Server, elle est utilisée comme `hostNameInCertificate`.
  + `CONNECTION_URL` - URL de connexion à une source de données générale (non JDBC).
  + `SECRET_ID` - L'ID secret utilisé pour le gestionnaire secret des informations d'identification.
  + `CONNECTOR_URL` - L'URL du connecteur pour une connexion MARKETPLACE ou CUSTOM.
  + `CONNECTOR_TYPE` - Le type du connecteur pour une connexion MARKETPLACE ou CUSTOM.
  + `CONNECTOR_CLASS_NAME` - Le nom de la classe de connecteur pour une connexion MARKETPLACE ou CUSTOM.
  + `KAFKA_BOOTSTRAP_SERVERS` - Liste séparée par des virgules composée de paires hôte et port qui sont les adresses des courtiers Apache Kafka dans un cluster Kafka auquel un client Kafka se connecte pour démarrer lui-même.
  + `KAFKA_SSL_ENABLED` - Indique s'il convient d'activer ou de désactiver SSL sur une connexion Apache Kafka. La valeur par défaut est « true » (vrai).
  + `KAFKA_CUSTOM_CERT` - L'URL d'Amazon S3 pour le fichier de certificat de l'autorité de certification privée (format .pem). La valeur par défaut est une chaîne vide.
  + `KAFKA_SKIP_CUSTOM_CERT_VALIDATION`- S'il faut ou non ignorer la validation du fichier de certification CA. AWS Glue valide pour trois algorithmes : SHA256with RSA, RSA et SHA384with RSA. SHA512with La valeur par défaut est « false » (faux).
  + `KAFKA_CLIENT_KEYSTORE` - Emplacement Amazon S3 du fichier de magasin de clés client pour l'authentification côté client Kafka (facultatif).
  + `KAFKA_CLIENT_KEYSTORE_PASSWORD` - Le mot de passe pour accéder au magasin de clés fourni (facultatif).
  + `KAFKA_CLIENT_KEY_PASSWORD` - Un magasin de clés peut être composé de plusieurs clés, il s'agit donc du mot de passe pour accéder à la clé client à utiliser avec la clé côté serveur Kafka (facultatif).
  + `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD`- La version cryptée du mot de passe du keystore du client Kafka (si l'utilisateur a sélectionné le paramètre de AWS Glue chiffrement des mots de passe).
  + `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD`- La version cryptée du mot de passe clé du client Kafka (si l'utilisateur a sélectionné le paramètre de AWS Glue cryptage des mots de passe).
  + `KAFKA_SASL_MECHANISM`- `"SCRAM-SHA-512"``"GSSAPI"`,`"AWS_MSK_IAM"`, ou`"PLAIN"`. Ce sont les [mécanismes SASL](https://www.iana.org/assignments/sasl-mechanisms/sasl-mechanisms.xhtml) pris en charge.
  + `KAFKA_SASL_PLAIN_USERNAME` : nom d’utilisateur en texte clair utilisé pour s’authentifier avec le mécanisme « PLAIN ».
  + `KAFKA_SASL_PLAIN_PASSWORD` : mot de passe en texte clair utilisé pour s’authentifier avec le mécanisme « PLAIN ».
  + `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD`- La version cryptée du mot de passe Kafka SASL PLAIN (si l'utilisateur a sélectionné le paramètre de AWS Glue cryptage des mots de passe).
  + `KAFKA_SASL_SCRAM_USERNAME` - Un nom d'utilisateur en texte clair utilisé pour s'authentifier avec le mécanisme « SCRAM-SHA-512 ».
  + `KAFKA_SASL_SCRAM_PASSWORD` - Un mot de passe en texte clair utilisé pour s'authentifier avec le mécanisme « SCRAM-SHA-512 ».
  + `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD`- La version cryptée du mot de passe Kafka SASL SCRAM (si l'utilisateur a sélectionné le paramètre de AWS Glue cryptage des mots de passe).
  + `KAFKA_SASL_SCRAM_SECRETS_ARN`- Le nom de ressource Amazon d'un secret dans AWS Secrets Manager.
  + `KAFKA_SASL_GSSAPI_KEYTAB` - Emplacement S3 d'un fichier Kerberos `keytab`. Un keytab stocke les clés à long terme pour un ou plusieurs principaux. Pour en savoir plus, consultez [Documentation du MIT Kerberos : Keytab](https://web.mit.edu/kerberos/krb5-latest/doc/basic/keytab_def.html).
  + `KAFKA_SASL_GSSAPI_KRB5_CONF` - Emplacement S3 d'un fichier Kerberos `krb5.conf`. Un fichier krb5.conf stocke les informations de configuration Kerberos, telles que l'emplacement du serveur KDC. Pour en savoir plus, consultez [Documentation MIT Kerberos : krb5.conf](https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html).
  + `KAFKA_SASL_GSSAPI_SERVICE` - Le nom du service Kerberos, tel que défini avec `sasl.kerberos.service.name` dans votre [Configuration Kafka](https://kafka.apache.org/documentation/#brokerconfigs_sasl.kerberos.service.name).
  + `KAFKA_SASL_GSSAPI_PRINCIPAL`- Le nom du principal Kerberos utilisé par. AWS Glue Pour plus d’informations, consultez [Documentation Kafka : configuration des courtiers Kafka](https://kafka.apache.org/documentation/#security_sasl_kerberos_clientconfig).
  + `ROLE_ARN` : rôle à utiliser pour exécuter des requêtes.
  + `REGION`- La AWS région dans laquelle les requêtes seront exécutées.
  + `WORKGROUP_NAME` : nom d’un groupe de travail Amazon Redshift sans serveur ou d’un groupe de travail Amazon Athena dans lequel les requêtes seront exécutées.
  + `CLUSTER_IDENTIFIER` : identifiant de cluster d’un cluster Amazon Redshift dans lequel les requêtes seront exécutées.
  + `DATABASE` : base de données Amazon Redshift à laquelle vous vous connectez.
+ `SparkProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Propriétés de connexion propres à l’environnement de calcul Spark.
+ `AthenaProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Propriétés de connexion propres à l’environnement de calcul Athena.
+ `PythonProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Propriétés de connexion propres à l’environnement de calcul Python.
+ `PhysicalConnectionRequirements` – Un objet [PhysicalConnectionRequirements](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements).

  Les exigences de connexion physique, comme un cloud privé virtuel (VPC) et `SecurityGroup`, qui sont nécessaires pour établir la connexion.
+ `CreationTime` – Horodatage.

  Horodatage de l’heure à laquelle la définition de connexion a été créée.
+ `LastUpdatedTime` – Horodatage.

  Horodatage de la dernière date à laquelle la définition de connexion a été mise à jour.
+ `LastUpdatedBy` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'utilisateur, groupe ou rôle qui a mis à jour la définition de connexion pour la dernière fois.
+ `Status` – Chaîne UTF-8 (valeurs valides : `READY` \$1 `IN_PROGRESS` \$1 `FAILED`).

  État de la connexion. Peut avoir l'une des valeurs suivantes : `READY`, `IN_PROGRESS` ou `FAILED`.
+ `StatusReason` – Chaîne UTF-8, d’une longueur comprise entre 1 et 16 384 octets.

  Motif de l’état de la connexion.
+ `LastConnectionValidationTime` – Horodatage.

  Horodatage de la dernière date de validation de cette connexion.
+ `AuthenticationConfiguration` : un objet [AuthenticationConfiguration](#aws-glue-api-catalog-connections-connections-AuthenticationConfiguration).

  Les propriétés d’authentification de la connexion.
+ `ConnectionSchemaVersion`— Nombre (entier), pas moins de 1 ou plus de 2.

  Version du schéma de connexion pour cette connexion. La version 2 prend en charge les propriétés pour des environnements de calcul spécifiques.
+ `CompatibleComputeEnvironments` – Tableau de chaînes UTF-8.

  Liste des environnements de calcul compatibles avec la connexion.

## ConnectionInput structure
<a name="aws-glue-api-catalog-connections-connections-ConnectionInput"></a>

Une structure utilisée pour spécifier la connexion à créer ou à mettre à jour.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la connexion.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de la connexion.
+ `ConnectionType`— *Obligatoire :* chaîne UTF-8 (valeurs valides : `JDBC` `SFTP` `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` `DATADOG` `WOOCOMMERCE`\$1 `INTERCOM` \$1 `SNAPCHATADS` \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO`\$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` `TIMESTREAM` \$1 `TPCDS` \$1`VERTICA`).

  Type de connexion. Actuellement, ces types sont pris en charge :
  + `JDBC` - Désigne une connexion à une base de données via Java Database Connectivity (JDBC).

    `JDBC`Les connexions utilisent les méthodes suivantes ConnectionParameters.
    + Obligatoire : toutes les valeurs (`HOST`, `PORT`, `JDBC_ENGINE`) ou `JDBC_CONNECTION_URL`.
    + Obligatoire : toutes les valeurs (`USERNAME`, `PASSWORD`) ou `SECRET_ID`.
    + Facultatif : `JDBC_ENFORCE_SSL`, `CUSTOM_JDBC_CERT`, `CUSTOM_JDBC_CERT_STRING`, `SKIP_CUSTOM_JDBC_CERT_VALIDATION`. Ces paramètres sont utilisés pour configurer le SSL avec JDBC.
  + `KAFKA` - Désigne une connexion à une plateforme de streaming Apache Kafka.

    `KAFKA`Les connexions utilisent les méthodes suivantes ConnectionParameters.
    + Obligatoire : `KAFKA_BOOTSTRAP_SERVERS`.
    + Facultatif : `KAFKA_SSL_ENABLED`, `KAFKA_CUSTOM_CERT`, `KAFKA_SKIP_CUSTOM_CERT_VALIDATION`. Ces paramètres sont utilisés pour configurer le SSL avec `KAFKA`.
    + Facultatif : `KAFKA_CLIENT_KEYSTORE`, `KAFKA_CLIENT_KEYSTORE_PASSWORD`, `KAFKA_CLIENT_KEY_PASSWORD`, `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD`, `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD`. Ces paramètres sont utilisés pour configurer la configuration client TLS avec SSL dans `KAFKA`.
    + Facultatif : `KAFKA_SASL_MECHANISM`. Peut être spécifié comme suit : `SCRAM-SHA-512`, `GSSAPI` ou `AWS_MSK_IAM`.
    + Facultatif : `KAFKA_SASL_SCRAM_USERNAME`, `KAFKA_SASL_SCRAM_PASSWORD`, `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD`. Ces paramètres sont utilisés pour configurer l'authentification SASL/SCRAMSHA-512 avec `KAFKA`.
    + Facultatif : `KAFKA_SASL_GSSAPI_KEYTAB`, `KAFKA_SASL_GSSAPI_KRB5_CONF`, `KAFKA_SASL_GSSAPI_SERVICE`, `KAFKA_SASL_GSSAPI_PRINCIPAL`. Ces paramètres sont utilisés pour configurer SASL/GSSAPI l'authentification avec`KAFKA`.
  + `MONGODB` - Désigne une connexion à une base de données de documents MongoDB.

    `MONGODB`Les connexions utilisent les méthodes suivantes ConnectionParameters.
    + Obligatoire : `CONNECTION_URL`.
    + Obligatoire : toutes les valeurs (`USERNAME`, `PASSWORD`) ou `SECRET_ID`.
  + `VIEW_VALIDATION_REDSHIFT` : désigne une connexion utilisée pour la validation des vues par Amazon Redshift.
  + `VIEW_VALIDATION_ATHENA` : désigne une connexion utilisée pour la validation des vues par Amazon Athena.
  + `NETWORK` - Désigne une connexion réseau à une source de données dans un environnement Amazon Virtual Private Cloud (Amazon VPC).

    `NETWORK`Les connexions ne sont pas nécessaires ConnectionParameters. Fournissez plutôt un PhysicalConnectionRequirements.
  + `MARKETPLACE`- Utilise les paramètres de configuration contenus dans un connecteur acheté AWS Marketplace pour lire et écrire dans des magasins de données qui ne sont pas pris en charge de manière native par AWS Glue.

    `MARKETPLACE`Les connexions utilisent les méthodes suivantes ConnectionParameters.
    + Obligatoire : `CONNECTOR_TYPE`, `CONNECTOR_URL`, `CONNECTOR_CLASS_NAME`, `CONNECTION_URL`.
    + Obligatoire pour les connexions `JDBC` `CONNECTOR_TYPE` : toutes les valeurs (`USERNAME`, `PASSWORD`) ou `SECRET_ID`.
  + `CUSTOM` - Utilise les paramètres de configuration contenus dans un connecteur personnalisé pour lire et écrire dans des magasins de données qui ne sont pas pris en charge en mode natif par AWS Glue.

  Pour plus d'informations sur les paramètres de connexion nécessaires pour un connecteur particulier, consultez la documentation du connecteur dans la section [Ajout d'une AWS Glue connexion](https://docs.aws.amazon.com/glue/latest/dg/console-connections.html) dans le guide de AWS Glue l'utilisateur.

  `SFTP` n’est pas pris en charge.

  Pour plus d'informations sur la manière dont les fonctionnalités facultatives ConnectionProperties sont utilisées pour configurer les fonctionnalités dans AWS Glue, consultez les [propriétés de AWS Glue connexion](https://docs.aws.amazon.com/glue/latest/dg/connection-defining.html).

  Pour plus d'informations sur la manière dont ConnectionProperties les options sont utilisées pour configurer les fonctionnalités dans AWS Glue Studio, consultez [Utilisation de connecteurs et de connexions](https://docs.aws.amazon.com/glue/latest/ug/connectors-chapter.html).
+ `MatchCriteria` : tableau de chaînes UTF-8, avec 10 chaînes maximum.

  Liste des critères qui peuvent être utilisés dans la sélection de cette connexion.
+ `ConnectionProperties` – *Obligatoire :* Tableau de mappage de paires clé-valeur, avec 100 paires au maximum.

  Chaque clé est une chaîne UTF-8 (valeurs valides : `HOST` \$1 `PORT` \$1 `USERNAME="USER_NAME"` \$1 `PASSWORD` \$1 `ENCRYPTED_PASSWORD` \$1 `JDBC_DRIVER_JAR_URI` \$1 `JDBC_DRIVER_CLASS_NAME` \$1 `JDBC_ENGINE` \$1 `JDBC_ENGINE_VERSION` \$1 `CONFIG_FILES` \$1 `INSTANCE_ID` \$1 `JDBC_CONNECTION_URL` \$1 `JDBC_ENFORCE_SSL` \$1 `CUSTOM_JDBC_CERT` \$1 `SKIP_CUSTOM_JDBC_CERT_VALIDATION` \$1 `CUSTOM_JDBC_CERT_STRING` \$1 `CONNECTION_URL` \$1 `KAFKA_BOOTSTRAP_SERVERS` \$1 `KAFKA_SSL_ENABLED` \$1 `KAFKA_CUSTOM_CERT` \$1 `KAFKA_SKIP_CUSTOM_CERT_VALIDATION` \$1 `KAFKA_CLIENT_KEYSTORE` \$1 `KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `KAFKA_CLIENT_KEY_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD` \$1 `KAFKA_SASL_MECHANISM` \$1 `KAFKA_SASL_PLAIN_USERNAME` \$1 `KAFKA_SASL_PLAIN_PASSWORD` \$1 `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD` \$1 `KAFKA_SASL_SCRAM_USERNAME` \$1 `KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_SCRAM_SECRETS_ARN` \$1 `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_GSSAPI_KEYTAB` \$1 `KAFKA_SASL_GSSAPI_KRB5_CONF` \$1 `KAFKA_SASL_GSSAPI_SERVICE` \$1 `KAFKA_SASL_GSSAPI_PRINCIPAL` \$1 `SECRET_ID` \$1 `CONNECTOR_URL` \$1 `CONNECTOR_TYPE` \$1 `CONNECTOR_CLASS_NAME` \$1 `ENDPOINT` \$1 `ENDPOINT_TYPE` \$1 `ROLE_ARN` \$1 `REGION` \$1 `WORKGROUP_NAME` \$1 `CLUSTER_IDENTIFIER` \$1 `DATABASE`).

  Chaque valeur est une chaîne Valeur, d’une longueur comprise entre 1 et 1 024 octets.

  Ces paires clé-valeur définissent les paramètres pour la connexion.
+ `SparkProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Propriétés de connexion propres à l’environnement de calcul Spark.
+ `AthenaProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Propriétés de connexion propres à l’environnement de calcul Athena.
+ `PythonProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Propriétés de connexion propres à l’environnement de calcul Python.
+ `PhysicalConnectionRequirements` – Un objet [PhysicalConnectionRequirements](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements).

  Les exigences de connexion physique, comme un cloud privé virtuel (VPC) et `SecurityGroup`, qui sont nécessaires pour bien établir cette connexion.
+ `AuthenticationConfiguration` : un objet [AuthenticationConfigurationInput](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput).

  Les propriétés d’authentification de la connexion.
+ `ValidateCredentials` : booléen.

  Un indicateur pour valider les informations d’identification lors de la création de la connexion. La valeur par défaut est true. 
+ `ValidateForComputeEnvironments` – Tableau de chaînes UTF-8.

  Environnements de calcul par rapport auxquels les propriétés de connexion spécifiées sont validées.

## TestConnectionInput structure
<a name="aws-glue-api-catalog-connections-connections-TestConnectionInput"></a>

Structure utilisée pour spécifier le test d’une connexion à un service.

**Champs**
+ `ConnectionType`— *Obligatoire :* chaîne UTF-8 (valeurs valides : `JDBC` `SFTP` `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` `DATADOG` `WOOCOMMERCE`\$1 `INTERCOM` \$1 `SNAPCHATADS` \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO`\$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` `TIMESTREAM` \$1 `TPCDS` \$1`VERTICA`).

  Le type de connexion à tester. Cette opération n’est disponible que pour les types de connexion `JDBC` ou `SALESFORCE`.
+ `ConnectionProperties` – *Obligatoire :* Tableau de mappage de paires clé-valeur, avec 100 paires au maximum.

  Chaque clé est une chaîne UTF-8 (valeurs valides : `HOST` \$1 `PORT` \$1 `USERNAME="USER_NAME"` \$1 `PASSWORD` \$1 `ENCRYPTED_PASSWORD` \$1 `JDBC_DRIVER_JAR_URI` \$1 `JDBC_DRIVER_CLASS_NAME` \$1 `JDBC_ENGINE` \$1 `JDBC_ENGINE_VERSION` \$1 `CONFIG_FILES` \$1 `INSTANCE_ID` \$1 `JDBC_CONNECTION_URL` \$1 `JDBC_ENFORCE_SSL` \$1 `CUSTOM_JDBC_CERT` \$1 `SKIP_CUSTOM_JDBC_CERT_VALIDATION` \$1 `CUSTOM_JDBC_CERT_STRING` \$1 `CONNECTION_URL` \$1 `KAFKA_BOOTSTRAP_SERVERS` \$1 `KAFKA_SSL_ENABLED` \$1 `KAFKA_CUSTOM_CERT` \$1 `KAFKA_SKIP_CUSTOM_CERT_VALIDATION` \$1 `KAFKA_CLIENT_KEYSTORE` \$1 `KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `KAFKA_CLIENT_KEY_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD` \$1 `KAFKA_SASL_MECHANISM` \$1 `KAFKA_SASL_PLAIN_USERNAME` \$1 `KAFKA_SASL_PLAIN_PASSWORD` \$1 `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD` \$1 `KAFKA_SASL_SCRAM_USERNAME` \$1 `KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_SCRAM_SECRETS_ARN` \$1 `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_GSSAPI_KEYTAB` \$1 `KAFKA_SASL_GSSAPI_KRB5_CONF` \$1 `KAFKA_SASL_GSSAPI_SERVICE` \$1 `KAFKA_SASL_GSSAPI_PRINCIPAL` \$1 `SECRET_ID` \$1 `CONNECTOR_URL` \$1 `CONNECTOR_TYPE` \$1 `CONNECTOR_CLASS_NAME` \$1 `ENDPOINT` \$1 `ENDPOINT_TYPE` \$1 `ROLE_ARN` \$1 `REGION` \$1 `WORKGROUP_NAME` \$1 `CLUSTER_IDENTIFIER` \$1 `DATABASE`).

  Chaque valeur est une chaîne Valeur, d’une longueur comprise entre 1 et 1 024 octets.

  Les paires clé-valeur qui définissent les paramètres pour la connexion.

  Les connexions JDBC utilisent les propriétés de connexion suivantes :
  + Obligatoire : toutes les valeurs (`HOST`, `PORT`, `JDBC_ENGINE`) ou `JDBC_CONNECTION_URL`.
  + Obligatoire : toutes les valeurs (`USERNAME`, `PASSWORD`) ou `SECRET_ID`.
  + Facultatif : `JDBC_ENFORCE_SSL`, `CUSTOM_JDBC_CERT`, `CUSTOM_JDBC_CERT_STRING`, `SKIP_CUSTOM_JDBC_CERT_VALIDATION`. Ces paramètres sont utilisés pour configurer le SSL avec JDBC.

  Les connexions SALESFORCE nécessitent que le membre `AuthenticationConfiguration` soit configuré.
+ `AuthenticationConfiguration` : un objet [AuthenticationConfigurationInput](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput).

  Structure contenant la configuration d'authentification dans la TestConnection demande. Nécessaire pour une connexion à Salesforce à l'aide de OAuth l'authentification.

## PhysicalConnectionRequirements structure
<a name="aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements"></a>

L'application OAuth cliente en GetConnection réponse.

**Champs**
+ `SubnetId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de sous-réseau utilisé par la connexion.
+ `SecurityGroupIdList` – Tableau de chaînes UTF-8, avec 50 chaînes maximum.

  Liste des ID de groupe de sécurité utilisée par la connexion.
+ `AvailabilityZone` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Connexion de la zone de disponibilité.

## GetConnectionsFilter structure
<a name="aws-glue-api-catalog-connections-connections-GetConnectionsFilter"></a>

Filtre les définitions de connexion retournées par l'opération d'API `GetConnections`.

**Champs**
+ `MatchCriteria` : tableau de chaînes UTF-8, avec 10 chaînes maximum.

  Chaîne des critères qui doivent répondre aux critères enregistrés dans la définition de connexion pour que cette définition soit renvoyée.
+ `ConnectionType`— Chaîne UTF-8 (valeurs valides : `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` `INTERCOM` `SNAPCHATADS`\$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` \$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE`\$1 `HBASE` `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` `TPCDS` \$1`VERTICA`).

  Type de connexions à renvoyer. Actuellement, SFTP n'est pas pris en charge.
+ `ConnectionSchemaVersion`— Nombre (entier), pas moins de 1 ou plus de 2.

  Indique si la connexion a été créée avec la version 1 ou 2 du schéma.

## AuthenticationConfiguration structure
<a name="aws-glue-api-catalog-connections-connections-AuthenticationConfiguration"></a>

Une structure contenant la configuration d’authentification.

**Champs**
+ `AuthenticationType` – Chaîne UTF-8 (valeurs valides : `BASIC` \$1 `OAUTH2` \$1 `CUSTOM` \$1 `IAM`).

  Une structure contenant la configuration d’authentification.
+ `SecretArn` – Chaîne UTF-8, correspondant au [Custom string pattern #36](aws-glue-api-common.md#regex_36).

  ARN de Secrets Manager pour stocker les informations d’identification.
+ `KmsKeyArn` – Chaîne UTF-8, correspondant au [Custom string pattern #42](aws-glue-api-common.md#regex_42).

  Amazon Resource Name (ARN) de la clé KMS à utiliser pour chiffrer les informations d’authentification sensibles. Cette clé est utilisée pour protéger les informations d’identification et autres données sensibles stockées dans la configuration d’authentification.
+ `OAuth2Properties` : un objet [OAuth2Propriétés](#aws-glue-api-catalog-connections-connections-OAuth2Properties).

  Les propriétés de l' OAuth2 authentification.

## AuthenticationConfigurationInput structure
<a name="aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput"></a>

Structure contenant la configuration d'authentification dans la CreateConnection demande.

**Champs**
+ `AuthenticationType` – Chaîne UTF-8 (valeurs valides : `BASIC` \$1 `OAUTH2` \$1 `CUSTOM` \$1 `IAM`).

  Structure contenant la configuration d'authentification dans la CreateConnection demande.
+ `OAuth2Properties` : un objet [OAuth2PropertiesInput](#aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput).

  Les propriétés d' OAuth2 authentification dans la CreateConnection demande.
+ `SecretArn` – Chaîne UTF-8, correspondant au [Custom string pattern #36](aws-glue-api-common.md#regex_36).

  L'ARN du gestionnaire secret pour stocker les informations d'identification dans la CreateConnection demande.
+ `KmsKeyArn` – Chaîne UTF-8, correspondant au [Custom string pattern #42](aws-glue-api-common.md#regex_42).

  ARN de la clé KMS utilisée pour chiffrer la connexion. Utilisé uniquement comme entrée dans la demande et stocké dans Secrets Manager.
+ `BasicAuthenticationCredentials` – Un objet [BasicAuthenticationCredentials](#aws-glue-api-catalog-connections-connections-BasicAuthenticationCredentials).

  Informations d’identification utilisées lorsque le type d’authentification est une authentification de base.
+ `CustomAuthenticationCredentials` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Informations d’identification utilisées lorsque le type d’authentification est une authentification personnalisée.

## OAuth2Structure des propriétés
<a name="aws-glue-api-catalog-connections-connections-OAuth2Properties"></a>

Structure contenant les propriétés d' OAuth2 authentification.

**Champs**
+ `OAuth2GrantType` – Chaîne UTF-8 (valeurs valides : `AUTHORIZATION_CODE` \$1 `CLIENT_CREDENTIALS` \$1 `JWT_BEARER`).

  Le type de OAuth2 subvention. Par exemple, `AUTHORIZATION_CODE`, `JWT_BEARER` ou `CLIENT_CREDENTIALS`.
+ `OAuth2ClientApplication` : un objet [OAuth2ClientApplication](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication).

  Type d’application client. Par exemple, AWS\$1MANAGED ou USER\$1MANAGED.
+ `TokenUrl` – chaîne UTF-8, d'une longueur ne dépassant pas 256 octets, correspondant au [Custom string pattern #40](aws-glue-api-common.md#regex_40).

  URL du serveur d’authentification du fournisseur, pour échanger un code d’autorisation en vue d’obtenir un jeton d’accès.
+ `TokenUrlParametersMap` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets.

  Carte des paramètres ajoutés à la demande de jeton `GET`.

## OAuth2PropertiesInput structure
<a name="aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput"></a>

Structure contenant les propriétés OAuth2 de la CreateConnection demande.

**Champs**
+ `OAuth2GrantType` – Chaîne UTF-8 (valeurs valides : `AUTHORIZATION_CODE` \$1 `CLIENT_CREDENTIALS` \$1 `JWT_BEARER`).

  Type de OAuth2 subvention indiqué dans la CreateConnection demande. Par exemple, `AUTHORIZATION_CODE`, `JWT_BEARER` ou `CLIENT_CREDENTIALS`.
+ `OAuth2ClientApplication` : un objet [OAuth2ClientApplication](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication).

  Type d'application client dans la CreateConnection demande. Par exemple, `AWS_MANAGED` ou `USER_MANAGED`.
+ `TokenUrl` – chaîne UTF-8, d'une longueur ne dépassant pas 256 octets, correspondant au [Custom string pattern #40](aws-glue-api-common.md#regex_40).

  URL du serveur d’authentification du fournisseur, pour échanger un code d’autorisation en vue d’obtenir un jeton d’accès.
+ `TokenUrlParametersMap` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets.

  Carte des paramètres ajoutés à la demande de jeton `GET`.
+ `AuthorizationCodeProperties` : un objet [AuthorizationCodeProperties](#aws-glue-api-catalog-connections-connections-AuthorizationCodeProperties).

  Ensemble de propriétés requis pour le type de OAuth2 `AUTHORIZATION_CODE` subvention.
+ `OAuth2Credentials` : un objet [OAuth2Informations d'identification](#aws-glue-api-catalog-connections-connections-OAuth2Credentials).

  Les informations d'identification utilisées lorsque le type d'authentification est OAuth2 l'authentification.

## OAuth2ClientApplication structure
<a name="aws-glue-api-catalog-connections-connections-OAuth2ClientApplication"></a>

L'application OAuth2 cliente utilisée pour la connexion.

**Champs**
+ `UserManagedClientApplicationClientId` – Chaîne UTF-8, d'une longueur maximale de 2 048 octets, correspondant au [Custom string pattern #37](aws-glue-api-common.md#regex_37).

  ClientiD de l'application clientId si c'est le cas. ClientAppType `USER_MANAGED`
+ `AWSManagedClientApplicationReference` – Chaîne UTF-8, d'une longueur maximale de 2 048 octets, correspondant au [Custom string pattern #37](aws-glue-api-common.md#regex_37).

  La référence à l'application cliente côté SaaS qui est AWS gérée.

## AuthorizationCodeProperties structure
<a name="aws-glue-api-catalog-connections-connections-AuthorizationCodeProperties"></a>

Ensemble de propriétés requis pour le flux de travail du type de OAuth2 `AUTHORIZATION_CODE` subvention.

**Champs**
+ `AuthorizationCode`— Chaîne UTF-8, d'une longueur d'au moins 1 ou supérieure à 4 096 octets, correspondant au. [Custom string pattern #37](aws-glue-api-common.md#regex_37)

  Code d’autorisation à utiliser dans la troisième étape du flux de travail d’autorisation `AUTHORIZATION_CODE`. Il s’agit d’un code à usage unique qui devient invalide une fois échangé contre un jeton d’accès. Il est donc acceptable d’avoir cette valeur comme paramètre de demande.
+ `RedirectUri`— Chaîne UTF-8, d'une longueur maximale de 512 octets, correspondant au. [Custom string pattern #41](aws-glue-api-common.md#regex_41)

  URI de redirection vers lequel l’utilisateur est redirigé par le serveur d’autorisation lors de l’émission d’un code d’autorisation. L’URI est ensuite utilisé lorsque le code d’autorisation est échangé pour obtenir un jeton d’accès.

## BasicAuthenticationCredentials structure
<a name="aws-glue-api-catalog-connections-connections-BasicAuthenticationCredentials"></a>

Pour fournir des informations d’authentification de base lorsque vous ne fournissez pas de valeur `SecretArn`.

**Champs**
+ `Username`— Chaîne UTF-8, d'une longueur maximale de 512 octets, correspondant au. [Custom string pattern #37](aws-glue-api-common.md#regex_37)

  Nom d’utilisateur pour se connecter à la source de données.
+ `Password`— Chaîne UTF-8, d'une longueur maximale de 512 octets, correspondant au. [Custom string pattern #33](aws-glue-api-common.md#regex_33)

  Mot de passe pour se connecter à la source de données.

## OAuth2Structure des informations d'identification
<a name="aws-glue-api-catalog-connections-connections-OAuth2Credentials"></a>

Les informations d'identification utilisées lorsque le type d'authentification est OAuth2 l'authentification.

**Champs**
+ `UserManagedClientApplicationClientSecret`— Chaîne UTF-8, d'une longueur maximale de 512 octets, correspondant au. [Custom string pattern #38](aws-glue-api-common.md#regex_38)

  Secret client de l’application client si l’application client est gérée par l’utilisateur.
+ `AccessToken`— Chaîne UTF-8, d'une longueur maximale de 4096 octets, correspondant au. [Custom string pattern #38](aws-glue-api-common.md#regex_38)

  Le jeton d'accès utilisé lorsque le type d'authentification est OAuth2.
+ `RefreshToken`— Chaîne UTF-8, d'une longueur maximale de 4096 octets, correspondant au. [Custom string pattern #38](aws-glue-api-common.md#regex_38)

  Le jeton d'actualisation utilisé lorsque le type d'authentification est OAuth2.
+ `JwtToken`— Chaîne UTF-8, d'une longueur maximale de 8 000 octets, correspondant au. [Custom string pattern #39](aws-glue-api-common.md#regex_39)

  Le jeton Web JSON (JWT) utilisé lorsque le type d'authentification est OAuth2.

## Opérations
<a name="aws-glue-api-catalog-connections-connections-actions"></a>
+ [CreateConnection action (Python : créer\$1connexion)](#aws-glue-api-catalog-connections-connections-CreateConnection)
+ [DeleteConnection action (Python : supprimer\$1connexion)](#aws-glue-api-catalog-connections-connections-DeleteConnection)
+ [GetConnection action (Python : get\$1connection)](#aws-glue-api-catalog-connections-connections-GetConnection)
+ [GetConnections action (Python : get\$1connections)](#aws-glue-api-catalog-connections-connections-GetConnections)
+ [UpdateConnection action (Python : update\$1connection)](#aws-glue-api-catalog-connections-connections-UpdateConnection)
+ [TestConnection action (Python : test\$1connection)](#aws-glue-api-catalog-connections-connections-TestConnection)
+ [BatchDeleteConnection action (Python : batch\$1delete\$1connection)](#aws-glue-api-catalog-connections-connections-BatchDeleteConnection)

## CreateConnection action (Python : créer\$1connexion)
<a name="aws-glue-api-catalog-connections-connections-CreateConnection"></a>

Crée une définition de connexion dans le catalogue de données.

Les connexions utilisées pour créer des ressources fédérées nécessitent l’autorisation IAM `glue:PassConnection`.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel créer la connexion. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `ConnectionInput` – *Obligatoire :* un objet [ConnectionInput](#aws-glue-api-catalog-connections-connections-ConnectionInput).

  Objet `ConnectionInput` définissant la connexion à créer.
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Les identifications que vous attribuez à la connexion.

**Réponse**
+ `CreateConnectionStatus` – Chaîne UTF-8 (valeurs valides : `READY` \$1 `IN_PROGRESS` \$1 `FAILED`).

  Statut de la demande de création de connexion. La demande peut prendre un certain temps pour certains types d'authentification, par exemple lors de la création d'une OAuth connexion avec échange de jetons via VPC.

**Erreurs**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`

## DeleteConnection action (Python : supprimer\$1connexion)
<a name="aws-glue-api-catalog-connections-connections-DeleteConnection"></a>

Supprime une connexion du catalogue de données.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel réside la connexion. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `ConnectionName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la connexion à supprimer.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `OperationTimeoutException`

## GetConnection action (Python : get\$1connection)
<a name="aws-glue-api-catalog-connections-connections-GetConnection"></a>

Extrait une définition de connexion du catalogue de données.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel réside la connexion. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la définition de connexion à extraire.
+ `HidePassword` : booléen.

  Vous permet de récupérer les métadonnées de connexion sans renvoyer le mot de passe. Par exemple, la AWS Glue console utilise cet indicateur pour récupérer la connexion et n'affiche pas le mot de passe. Définissez ce paramètre lorsque l'appelant n'est peut-être pas autorisé à utiliser la AWS KMS clé pour déchiffrer le mot de passe, mais qu'il est autorisé à accéder au reste des propriétés de connexion.
+ `ApplyOverrideForComputeEnvironment` – Chaîne UTF-8 (valeurs valides : `SPARK` \$1 `ATHENA` \$1 `PYTHON`).

  Pour les connexions qui peuvent être utilisées dans plusieurs services, spécifie les propriétés de renvoi pour l’environnement de calcul spécifié.

**Réponse**
+ `Connection` – Un objet [Connexion](#aws-glue-api-catalog-connections-connections-Connection).

  Définition de connexion demandée.

**Erreurs**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`

## GetConnections action (Python : get\$1connections)
<a name="aws-glue-api-catalog-connections-connections-GetConnections"></a>

Extrait une liste de définitions de connexion du catalogue de données.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel résident les connexions. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `Filter` – Un objet [GetConnectionsFilter](#aws-glue-api-catalog-connections-connections-GetConnectionsFilter).

  Filtre qui contrôle les connexions à renvoyer.
+ `HidePassword` : booléen.

  Vous permet de récupérer les métadonnées de connexion sans renvoyer le mot de passe. Par exemple, la AWS Glue console utilise cet indicateur pour récupérer la connexion et n'affiche pas le mot de passe. Définissez ce paramètre lorsque l'appelant n'est peut-être pas autorisé à utiliser la AWS KMS clé pour déchiffrer le mot de passe, mais qu'il est autorisé à accéder au reste des propriétés de connexion.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximal de connexions à renvoyer dans une réponse.

**Réponse**
+ `ConnectionList` : un tableau d’objets [Connexion](#aws-glue-api-catalog-connections-connections-Connection).

  Liste des définitions de connexion demandées.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, si la liste des connexions renvoyées n'inclut pas la dernière connexion filtrée.

**Erreurs**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`

## UpdateConnection action (Python : update\$1connection)
<a name="aws-glue-api-catalog-connections-connections-UpdateConnection"></a>

Met à jour une définition de connexion dans le catalogue de données.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel réside la connexion. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la définition de connexion à mettre à jour.
+ `ConnectionInput` – *Obligatoire :* un objet [ConnectionInput](#aws-glue-api-catalog-connections-connections-ConnectionInput).

  Objet `ConnectionInput` qui redéfinit la connexion en question.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`

## TestConnection action (Python : test\$1connection)
<a name="aws-glue-api-catalog-connections-connections-TestConnection"></a>

Teste une connexion à un service pour valider les informations d’identification du service que vous indiquez.

Vous pouvez indiquer un nom de connexion existant ou une `TestConnectionInput` pour tester une entrée de connexion inexistante. Fournir les deux en même temps entraînera une erreur.

Si l’action aboutit, le service renvoie une réponse HTTP 200.

**Demande**
+ `ConnectionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Facultatif. Nom de la connexion à tester. Si seul le nom est fourni, l’opération obtiendra la connexion et l’utilisera pour les tests.
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue où réside la connexion.
+ `TestConnectionInput` – Un objet [TestConnectionInput](#aws-glue-api-catalog-connections-connections-TestConnectionInput).

  Structure utilisée pour spécifier le test d’une connexion à un service.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`
+ `FederationSourceException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ConflictException`
+ `InternalServiceException`

## BatchDeleteConnection action (Python : batch\$1delete\$1connection)
<a name="aws-glue-api-catalog-connections-connections-BatchDeleteConnection"></a>

Supprime une liste de définitions de connexion du catalogue de données.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel résident les connexions. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `ConnectionNameList` – *Obligatoire :* Tableau de chaînes UTF-8, avec 25 chaînes maximum.

  Liste des noms des connexions à supprimer.

**Réponse**
+ `Succeeded` – Tableau de chaînes UTF-8.

  Liste des noms des définitions de connexion qui ont été supprimées avec succès.
+ `Errors` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est un objet [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail).

  Carte des noms des connexions qui n'ont pas été supprimées avec succès pour les détails d'erreur.

**Erreurs**
+ `InternalServiceException`
+ `OperationTimeoutException`

# API de types de connexion
<a name="aws-glue-api-catalog-connections-connections-type"></a>

L'API Connection Type décrit AWS Glue APIs les types de connexion.

## Gestion des connexions APIs
<a name="aws-glue-api-catalog-connections-connections-type-connection-management"></a>
+ [DescribeConnectionType action (Python : describe\$1connection\$1type)](#aws-glue-api-catalog-connections-connections-type-DescribeConnectionType)
+ [ListConnectionTypes action (Python : list\$1connection\$1types)](#aws-glue-api-catalog-connections-connections-type-ListConnectionTypes)
+ [ConnectionTypeBrief structure](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief)
+ [ConnectionTypeVariant structure](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant)

## DescribeConnectionType action (Python : describe\$1connection\$1type)
<a name="aws-glue-api-catalog-connections-connections-type-DescribeConnectionType"></a>

L’API `DescribeConnectionType` fournit des informations complètes sur les options prises en charge pour un type de connexion donné dans AWS Glue.

**Demande**
+ `ConnectionType` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du type de connexion à décrire.

**Réponse**
+ `ConnectionType` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du type de connexion.
+ `Description` – Chaîne UTF-8, d’une longueur maximale de 1 024 octets.

  Description du type de connexion.
+ `Capabilities` – Un objet [Fonctionnalités](#aws-glue-api-catalog-connections-connections-type-Capabilities).

  Les types d’authentification, les types d’interface de données (environnements de calcul) et les opérations de données pris en charge par le connecteur.
+ `ConnectionProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est un objet [Propriété](#aws-glue-api-catalog-connections-connections-type-Property).

  Propriétés de connexion communes à tous les environnements de calcul.
+ `ConnectionOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est un objet [Propriété](#aws-glue-api-catalog-connections-connections-type-Property).

  Renvoie les propriétés qui peuvent être définies lors de la création d’une connexion dans les `ConnectionInput.ConnectionProperties`. `ConnectionOptions` définit les paramètres qui peuvent être définis dans un script Spark ETL dans la carte des options de connexion transmise à un DataFrame.
+ `AuthenticationConfiguration` : un objet [AuthConfiguration](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration).

  Le type d’autorisation utilisé pour la connexion.
+ `ComputeEnvironmentConfigurations` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est un objet [ComputeEnvironmentConfiguration](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration).

  Les environnements de calcul pris en charge par la connexion.
+ `PhysicalConnectionRequirements` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est un objet [Propriété](#aws-glue-api-catalog-connections-connections-type-Property).

  Exigences physiques pour une connexion, telles que les spécifications VPC, Sous-réseau et Groupe de sécurité.
+ `AthenaConnectionProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est un objet [Propriété](#aws-glue-api-catalog-connections-connections-type-Property).

  Propriétés de connexion propres à l’environnement de calcul Athena.
+ `PythonConnectionProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est un objet [Propriété](#aws-glue-api-catalog-connections-connections-type-Property).

  Propriétés de connexion propres à l’environnement de calcul Python.
+ `SparkConnectionProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est un objet [Propriété](#aws-glue-api-catalog-connections-connections-type-Property).

  Propriétés de connexion propres à l’environnement de calcul Spark.

**Erreurs**
+ `ValidationException`
+ `InvalidInputException`
+ `InternalServiceException`

## ListConnectionTypes action (Python : list\$1connection\$1types)
<a name="aws-glue-api-catalog-connections-connections-type-ListConnectionTypes"></a>

L’API `ListConnectionTypes` fournit un mécanisme de découverte permettant de connaître les types de connexion disponibles dans AWS Glue. La réponse contient une liste de types de connexion avec des informations détaillées sur ce qui est pris en charge pour chaque type de connexion. Les types de connexion répertoriés sont l’ensemble des options prises en charge pour la valeur `ConnectionType` dans l’API `CreateConnection`.

**Demande**
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximal de résultats à renvoyer.
+ `NextToken` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2048 octets, correspondant au [Custom string pattern #11](aws-glue-api-common.md#regex_11).

  Jeton de continuation, s’il s’agit d’un appel de continuation.

**Réponse**
+ `ConnectionTypes` : un tableau d’objets [ConnectionTypeBrief](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief).

  Une liste d’objets `ConnectionTypeBrief` contenant de brèves informations sur les types de connexion pris en charge.
+ `NextToken` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2048 octets, correspondant au [Custom string pattern #11](aws-glue-api-common.md#regex_11).

  Jeton de continuation, si le segment de liste actuel n’est pas le dernier.

**Erreurs**
+ `InternalServiceException`

## ConnectionTypeBrief structure
<a name="aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief"></a>

Brèves informations sur un type de connexion pris en charge renvoyées par l’API `ListConnectionTypes`.

**Champs**
+ `ConnectionType`— Chaîne UTF-8 (valeurs valides : `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` `INTERCOM` `SNAPCHATADS`\$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` \$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE`\$1 `HBASE` \$1 `KUSTOMER` `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` `TIMESTREAM` \$1 `TPCDS` \$1`VERTICA`).

  Nom du type de connexion.
+ `DisplayName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Nom lisible par l’utilisateur du type de connexion affiché dans la console AWS Glue .
+ `Vendor` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Nom du fournisseur qui a créé ou qui gère ce type de connexion.
+ `Description` – Chaîne UTF-8, d’une longueur maximale de 1 024 octets.

  Description du type de connexion.
+ `Categories` – .

  Liste des catégories auxquelles appartient ce type de connexion. Les catégories aident les utilisateurs à filtrer et à trouver les types de connexion appropriés en fonction de leurs cas d’utilisation.
+ `Capabilities` – Un objet [Fonctionnalités](#aws-glue-api-catalog-connections-connections-type-Capabilities).

  Les types d’authentification, les types d’interface de données (environnements de calcul) et les opérations de données pris en charge par le connecteur.
+ `LogoUrl` – Chaîne UTF-8.

  URL du logo associé à un type de connexion.
+ `ConnectionTypeVariants` : un tableau d’objets [ConnectionTypeVariant](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant).

  Liste des variantes disponibles pour ce type de connexion. Différentes variantes peuvent fournir des configurations spécialisées pour des cas d’utilisation ou des mises en œuvre spécifiques du même type de connexion général.

## ConnectionTypeVariant structure
<a name="aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant"></a>

Représente une variante d'un type de connexion dans le catalogue de AWS Glue données. Les variantes de type de connexion fournissent des configurations et des comportements spécifiques pour différentes implémentations du même type de connexion général.

**Champs**
+ `ConnectionTypeVariantName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Identifiant unique pour la variante du type de connexion. Ce nom est utilisé en interne pour identifier la variante spécifique d’un type de connexion. 
+ `DisplayName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Nom lisible par l'homme de la variante de type de connexion affichée dans la AWS Glue console.
+ `Description` – Chaîne UTF-8, d’une longueur maximale de 1 024 octets.

  Description détaillée de la variante du type de connexion, y compris son objectif, ses cas d’utilisation et les exigences de configuration spécifiques.
+ `LogoUrl` – Chaîne UTF-8.

  URL du logo associé à une variante du type de connexion.

## types de données
<a name="aws-glue-api-catalog-connections-connections-type-connection-types"></a>
+ [Structure de validation](#aws-glue-api-catalog-connections-connections-type-Validation)
+ [AuthConfiguration structure](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration)
+ [Structure des fonctionnalités](#aws-glue-api-catalog-connections-connections-type-Capabilities)
+ [Structure de la propriété](#aws-glue-api-catalog-connections-connections-type-Property)
+ [AllowedValue structure](#aws-glue-api-catalog-connections-connections-type-AllowedValue)
+ [ComputeEnvironmentConfiguration structure](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration)

## Structure de validation
<a name="aws-glue-api-catalog-connections-connections-type-Validation"></a>

Définit la manière dont une validation est effectuée sur une propriété de connexion.

**Champs**
+ `ValidationType` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `REGEX` \$1 `RANGE`).

  Type de validation à effectuer, tel que `REGEX`.
+ `Patterns` – .

  Liste des modèles qui s’appliquent à la validation.
+ `Description` – *Obligatoire :* chaîne UTF-8, d’une longueur comprise entre 1 et 1 024 octets.

  Description de la validation.
+ `MaxLength` : nombre (entier).

  Longueur maximale d’une propriété de connexion de chaîne.
+ `Maximum` : nombre (entier).

  Valeur maximale lors de la spécification d’un type `RANGE` de validation.
+ `Minimum` : nombre (entier).

  Valeur minimale lors de la spécification d’un type `RANGE` de validation.

## AuthConfiguration structure
<a name="aws-glue-api-catalog-connections-connections-type-AuthConfiguration"></a>

Configuration d’authentification pour une connexion renvoyée par l’API `DescribeConnectionType`.

**Champs**
+ `AuthenticationType` – *Obligatoire :* un objet [Propriété](#aws-glue-api-catalog-connections-connections-type-Property).

  Type d’autorisation pour une connexion.
+ `SecretArn` – Un objet [Propriété](#aws-glue-api-catalog-connections-connections-type-Property).

  Amazon Resource Name (ARN) pour Secrets Manager.
+ `OAuth2Properties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est un objet [Propriété](#aws-glue-api-catalog-connections-connections-type-Property).

  Carte des paires clé-valeur pour les OAuth2 propriétés. Chaque valeur est un objet `Property`.
+ `BasicAuthenticationProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est un objet [Propriété](#aws-glue-api-catalog-connections-connections-type-Property).

  Carte des paires clé-valeur pour les OAuth2 propriétés. Chaque valeur est un objet `Property`.
+ `CustomAuthenticationProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est un objet [Propriété](#aws-glue-api-catalog-connections-connections-type-Property).

  Mappage de paires clé-valeur pour les propriétés d’authentification personnalisées. Chaque valeur est un objet `Property`.

## Structure des fonctionnalités
<a name="aws-glue-api-catalog-connections-connections-type-Capabilities"></a>

Spécifie les types d’authentification pris en charge renvoyés par l’API `DescribeConnectionType`.

**Champs**
+ `SupportedAuthenticationTypes` – *Obligatoire :* Tableau de chaînes UTF-8.

  Liste des types d’authentification pris en charge.
+ `SupportedDataOperations` – *Obligatoire :* Tableau de chaînes UTF-8.

  Liste des opérations de données prises en charge.
+ `SupportedComputeEnvironments` – *Obligatoire :* Tableau de chaînes UTF-8.

  Liste des environnements de calcul pris en charge.

## Structure de la propriété
<a name="aws-glue-api-catalog-connections-connections-type-Property"></a>

Objet qui définit un type de connexion pour un environnement de calcul.

**Champs**
+ `Name`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Le nom de la propriété.
+ `Description` – *Obligatoire :* Chaîne UTF-8, d’une longueur ne dépassant pas 1 024 octets.

  Description de la propriété.
+ `Required` – *obligatoire :* booléen.

  Indique si la propriété est obligatoire.
+ `PropertyTypes` – *Obligatoire :* Tableau de chaînes UTF-8.

  Décrit le type de propriété.
+ `AllowedValues` : un tableau d’objets [AllowedValue](#aws-glue-api-catalog-connections-connections-type-AllowedValue).

  Liste d’objets `AllowedValue` représentant les valeurs autorisées pour la propriété.
+ `DataOperationScopes` – Tableau de chaînes UTF-8.

  Indique les opérations de données applicables à la propriété.

## AllowedValue structure
<a name="aws-glue-api-catalog-connections-connections-type-AllowedValue"></a>

Objet représentant une valeur autorisée pour une propriété.

**Champs**
+ `Description` – Chaîne UTF-8, d’une longueur maximale de 1 024 octets.

  Description de la valeur autorisée.
+ `Value`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Valeur autorisée pour la propriété.

## ComputeEnvironmentConfiguration structure
<a name="aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration"></a>

Objet contenant la configuration d’un environnement de calcul (tel que Spark, Python ou Athena) renvoyé par l’API `DescribeConnectionType`.

**Champs**
+ `Name`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Nom de la configuration de l’environnement de calcul.
+ `Description` – *Obligatoire :* Chaîne UTF-8, d’une longueur ne dépassant pas 1 024 octets.

  Description de l’environnement de calcul.
+ `ComputeEnvironment` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `SPARK` \$1 `ATHENA` \$1 `PYTHON`).

  Type d'environnement de calcul.
+ `SupportedAuthenticationTypes` – *Obligatoire :* Tableau de chaînes UTF-8.

  Types d’authentification pris en charge pour l’environnement de calcul.
+ `ConnectionOptions` – *obligatoire :* tableau de mappage de paires clé-valeur.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est un objet [Propriété](#aws-glue-api-catalog-connections-connections-type-Property).

  Paramètres utilisés comme options de connexion pour l’environnement de calcul.
+ `ConnectionPropertyNameOverrides` – *obligatoire :* tableau de mappage de paires clé-valeur.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Le nom de propriété de connexion est remplacé pour l’environnement de calcul.
+ `ConnectionOptionNameOverrides` – *obligatoire :* tableau de mappage de paires clé-valeur.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Le nom d’option de connexion est remplacé pour l’environnement de calcul.
+ `ConnectionPropertiesRequiredOverrides`— *Obligatoire :*.

  Les propriétés de connexion requises en tant que remplacements pour l’environnement de calcul.
+ `PhysicalConnectionPropertiesRequired` : booléen.

  Indique si les `PhysicalConnectionProperties` sont requises pour l’environnement de calcul.

# Métadonnées de connexion et API de prévisualisation
<a name="aws-glue-api-catalog-connections-connections-metadata"></a>

La connexion suivante APIs décrit les opérations permettant de décrire les métadonnées de connexion.

## Types de données
<a name="aws-glue-api-catalog-connections-connections-metadata-objects"></a>
+ [Structure de l’entité](#aws-glue-api-catalog-connections-connections-metadata-Entity)
+ [Structure de champ](#aws-glue-api-catalog-connections-connections-metadata-Field)

## Structure de l’entité
<a name="aws-glue-api-catalog-connections-connections-metadata-Entity"></a>

Entité prise en charge par un `ConnectionType` donné.

**Champs**
+ `EntityName` – Chaîne UTF-8.

  Le nom de l’entité.
+ `Label` – Chaîne UTF-8.

  Étiquette utilisée pour l’entité.
+ `IsParentEntity` : booléen.

  Valeur booléenne qui permet de déterminer si des sous-objets peuvent être répertoriés.
+ `Description` – Chaîne UTF-8.

  Une description de l’entité.
+ `Category` – Chaîne UTF-8.

  Type d’entités présentes dans la réponse. Cette valeur dépend de la connexion source. Par exemple, il s’agit de `SObjects` pour Salesforce et de `databases`, `schemas` ou `tables` pour des sources telles qu’Amazon Redshift.
+ `CustomProperties` – 

  Carte facultative de clés qui peuvent être renvoyées pour une entité par un connecteur.

## Structure de champ
<a name="aws-glue-api-catalog-connections-connections-metadata-Field"></a>

L’objet `Field` contient des informations sur les différentes propriétés associées à un champ dans le connecteur.

**Champs**
+ `FieldName` – Chaîne UTF-8.

  Un identifiant unique du champ.
+ `Label` – Chaîne UTF-8.

  Une étiquette lisible pour le champ.
+ `Description` – Chaîne UTF-8.

  Une description du champ.
+ `FieldType`— Chaîne UTF-8 (valeurs valides : `INT` \$1 \$1 `SMALLINT` \$1 `BIGINT` \$1 \$1 `FLOAT` \$1 `LONG` \$1 `DATE` \$1 `BOOLEAN` \$1 `MAP` \$1 `ARRAY` \$1 `STRING` \$1 `TIMESTAMP` \$1 \$1 `DECIMAL` \$1 `BYTE` `SHORT` `DOUBLE` \$1`STRUCT`).

  Type de données dans le champ.
+ `IsPrimaryKey` : booléen.

  Indique si ce champ peut être utilisé comme clé primaire pour l’entité donnée.
+ `IsNullable` : booléen.

  Indique si ce champ peut autoriser les valeurs nulles ou non.
+ `IsRetrievable` : booléen.

  Indique si ce champ peut être ajouté dans la clause Select de la requête SQL ou s’il peut être extrait ou non.
+ `IsFilterable` : booléen.

   Indique si ce champ peut être utilisé dans une clause de filtre (clause `WHERE`) d’une instruction SQL lors de l’interrogation de données. 
+ `IsPartitionable` : booléen.

  Indique si un champ donné peut être utilisé pour partitionner la requête envoyée à SaaS.
+ `IsCreateable` : booléen.

  Indique si ce champ peut être créé dans le cadre d’une écriture de destination.
+ `IsUpdateable` : booléen.

  Indique si ce champ peut être mis à jour dans le cadre d’une écriture de destination.
+ `IsUpsertable` : booléen.

  Indique si ce champ peut faire l’objet d’un upsert dans le cadre d’une écriture de destination.
+ `IsDefaultOnCreate` : booléen.

  Indique si ce champ est automatiquement renseigné lors de la création de l’objet, par exemple s’il est créé au niveau de l’horodatage.
+ `SupportedValues` – .

  Liste des valeurs prises en charge pour le champ.
+ `SupportedFilterOperators` – Tableau de chaînes UTF-8.

  Indique les opérateurs de filtre de prise en charge pour ce champ.
+ `CustomProperties` – 

  Carte facultative des clés qui peuvent être renvoyées.

## Opérations
<a name="aws-glue-api-catalog-connections-connections-metadata-actions"></a>
+ [ListEntities action (Python : list\$1entities)](#aws-glue-api-catalog-connections-connections-metadata-ListEntities)
+ [DescribeEntity action (Python : describe\$1entity)](#aws-glue-api-catalog-connections-connections-metadata-DescribeEntity)
+ [GetEntityRecords action (Python : get\$1entity\$1records)](#aws-glue-api-catalog-connections-connections-metadata-GetEntityRecords)

## ListEntities action (Python : list\$1entities)
<a name="aws-glue-api-catalog-connections-connections-metadata-ListEntities"></a>

Renvoie les entités disponibles prises en charge par le type de connexion. 

**Demande**
+ `ConnectionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la connexion dont les informations d’identification sont requises pour interroger n’importe quel type de connexion.
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue contenant la connexion. Cela peut être nul. Par défaut, l'ID de AWS compte est l'ID du catalogue.
+ `ParentEntityName` – Chaîne UTF-8.

  Nom de l’entité parent pour laquelle vous souhaitez répertorier les enfants. Ce paramètre utilise un chemin entièrement qualifié de l’entité afin de répertorier les entités enfant.
+ `NextToken` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2048 octets, correspondant au [Custom string pattern #11](aws-glue-api-common.md#regex_11).

  Jeton de continuation, inclus s’il s’agit d’un appel de continuation.
+ `DataStoreApiVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 256 octets, correspondant au [Custom string pattern #23](aws-glue-api-common.md#regex_23).

  Version d’API du connecteur SaaS.

**Réponse**
+ `Entities` : un tableau d’objets [Entité](#aws-glue-api-catalog-connections-connections-metadata-Entity).

  Liste d’objets `Entity`.
+ `NextToken` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2048 octets, correspondant au [Custom string pattern #11](aws-glue-api-common.md#regex_11).

  Un jeton de continuation, présent si le segment actuel n’est pas le dernier.

**Erreurs**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`

## DescribeEntity action (Python : describe\$1entity)
<a name="aws-glue-api-catalog-connections-connections-metadata-DescribeEntity"></a>

Fournit des détails concernant l’entité utilisée avec le type de connexion, avec une description du modèle de données pour chaque champ de l’entité sélectionnée.

 La réponse inclut tous les champs qui constituent l’entité.

**Demande**
+ `ConnectionName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la connexion qui contient les informations d’identification du type de connexion.
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue contenant la connexion. Cela peut être nul. Par défaut, l'ID de AWS compte est l'ID du catalogue.
+ `EntityName` – *Obligatoire :* chaîne UTF-8.

  Nom de l’entité que vous souhaitez décrire à partir du type de connexion.
+ `NextToken` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2048 octets, correspondant au [Custom string pattern #11](aws-glue-api-common.md#regex_11).

  Jeton de continuation, inclus s’il s’agit d’un appel de continuation.
+ `DataStoreApiVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 256 octets, correspondant au [Custom string pattern #23](aws-glue-api-common.md#regex_23).

  Version de l’API utilisée pour l’entrepôt de données.

**Réponse**
+ `Fields` : un tableau d’objets [Champ](#aws-glue-api-catalog-connections-connections-metadata-Field).

  Décrit les champs de cette entité de connecteur. Il s’agit de la liste des objets `Field`. `Field` est très similaire à une colonne dans une base de données. L’objet `Field` contient des informations sur les différentes propriétés associées aux champs dans le connecteur.
+ `NextToken` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2048 octets, correspondant au [Custom string pattern #11](aws-glue-api-common.md#regex_11).

  Un jeton de continuation, présent si le segment actuel n’est pas le dernier.

**Erreurs**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`

## GetEntityRecords action (Python : get\$1entity\$1records)
<a name="aws-glue-api-catalog-connections-connections-metadata-GetEntityRecords"></a>

Cette API est utilisée pour interroger les données d'aperçu à partir d'un type de connexion donné ou d'un catalogue de AWS Glue données natif basé sur Amazon S3.

Renvoie les enregistrements sous forme de tableau de blobs JSON. Chaque enregistrement est formaté à l'aide de Jackson en JsonNode fonction du type de champ défini par l'`DescribeEntity`API.

Les connecteurs Spark génèrent des schémas selon le même mappage de type de données que dans l’API `DescribeEntity`. Les connecteurs Spark convertissent les données en types de données appropriés correspondant au schéma lors du renvoi de lignes.

**Demande**
+ `ConnectionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la connexion qui contient les informations d’identification du type de connexion.
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue contenant la connexion. Cela peut être nul. Par défaut, l'ID de AWS compte est l'ID du catalogue.
+ `EntityName` – *Obligatoire :* chaîne UTF-8.

  Nom de l’entité pour laquelle nous souhaitons interroger les données de prévisualisation à partir du type de connexion donné.
+ `NextToken` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2048 octets, correspondant au [Custom string pattern #11](aws-glue-api-common.md#regex_11).

  Jeton de continuation, inclus s’il s’agit d’un appel de continuation.
+ `DataStoreApiVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 256 octets, correspondant au [Custom string pattern #23](aws-glue-api-common.md#regex_23).

  Version d’API du connecteur SaaS.
+ `ConnectionOptions` – Tableau de mappage de paires clé-valeur, 100 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 256 octets, correspondant au [Custom string pattern #18](aws-glue-api-common.md#regex_18).

  Chaque valeur est une chaîne UTF-8, d’une longueur comprise entre 1 et 256 octets, correspondant au [Custom string pattern #17](aws-glue-api-common.md#regex_17).

  Options de connecteur requises pour interroger les données.
+ `FilterPredicate` – Chaîne UTF-8, d’une longueur comprise entre 1 et 100000 octets.

  Un prédicat de filtre que vous pouvez appliquer dans la demande de requête.
+ `Limit` – *Obligatoire :* nombre (long), compris entre 1 et 1 000.

  Limite le nombre d’enregistrements récupérés avec la demande.
+ `SelectedFields` – Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 000 chaînes maximum.

   Liste des champs que nous souhaitons récupérer dans le cadre des données de prévisualisation.

**Réponse**
+ `Records` : tableau d’une structure.

  Liste des objets demandés.
+ `NextToken` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2048 octets, correspondant au [Custom string pattern #11](aws-glue-api-common.md#regex_11).

  Un jeton de continuation, présent si le segment actuel n’est pas le dernier.

**Erreurs**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`

# API de fonction définie par l'utilisateur
<a name="aws-glue-api-catalog-functions"></a>

L'API des fonctions définies par l'utilisateur décrit les types de AWS Glue données et les opérations utilisés lors de l'utilisation des fonctions.

## Types de données
<a name="aws-glue-api-catalog-functions-objects"></a>
+ [UserDefinedFunction structure](#aws-glue-api-catalog-functions-UserDefinedFunction)
+ [UserDefinedFunctionInput structure](#aws-glue-api-catalog-functions-UserDefinedFunctionInput)

## UserDefinedFunction structure
<a name="aws-glue-api-catalog-functions-UserDefinedFunction"></a>

Représente l'équivalent d'une définition de fonction Hive définie par l'utilisateur (`UDF`).

**Champs**
+ `FunctionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la fonction.
+ `DatabaseName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue qui contient la fonction.
+ `ClassName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Classe Java qui contient le code de fonction.
+ `OwnerName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Propriétaire de la fonction.
+ `OwnerType` – Chaîne UTF-8 (valeurs valides : `USER` \$1 `ROLE` \$1 `GROUP`).

  Type de propriétaire.
+ `CreateTime` – Horodatage.

  Heure à laquelle la fonction a été créée.
+ `ResourceUris` – Un tableau d'objets [ResourceUri](aws-glue-api-common.md#aws-glue-api-common-ResourceUri), 1000 structures maximum.

  La ressource URIs associée à la fonction.
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel réside la fonction.

## UserDefinedFunctionInput structure
<a name="aws-glue-api-catalog-functions-UserDefinedFunctionInput"></a>

Structure utilisée pour créer ou mettre à jour une fonction définie par l'utilisateur.

**Champs**
+ `FunctionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la fonction.
+ `ClassName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Classe Java qui contient le code de fonction.
+ `OwnerName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Propriétaire de la fonction.
+ `OwnerType` – Chaîne UTF-8 (valeurs valides : `USER` \$1 `ROLE` \$1 `GROUP`).

  Type de propriétaire.
+ `ResourceUris` – Un tableau d'objets [ResourceUri](aws-glue-api-common.md#aws-glue-api-common-ResourceUri), 1000 structures maximum.

  La ressource URIs associée à la fonction.

## Opérations
<a name="aws-glue-api-catalog-functions-actions"></a>
+ [CreateUserDefinedFunction action (Python : create\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-CreateUserDefinedFunction)
+ [UpdateUserDefinedFunction action (Python : update\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-UpdateUserDefinedFunction)
+ [DeleteUserDefinedFunction action (Python : delete\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-DeleteUserDefinedFunction)
+ [GetUserDefinedFunction action (Python : get\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-GetUserDefinedFunction)
+ [GetUserDefinedFunctions action (Python : get\$1user\$1defined\$1functions)](#aws-glue-api-catalog-functions-GetUserDefinedFunctions)

## CreateUserDefinedFunction action (Python : create\$1user\$1defined\$1function)
<a name="aws-glue-api-catalog-functions-CreateUserDefinedFunction"></a>

Crée une nouvelle définition de fonction dans le catalogue de données.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel créer la fonction. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue dans laquelle créer la fonction.
+ `FunctionInput` – *Obligatoire :* un objet [UserDefinedFunctionInput](#aws-glue-api-catalog-functions-UserDefinedFunctionInput).

  Objet `FunctionInput` qui définit la fonction à créer dans le catalogue de données.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`

## UpdateUserDefinedFunction action (Python : update\$1user\$1defined\$1function)
<a name="aws-glue-api-catalog-functions-UpdateUserDefinedFunction"></a>

Met à jour une définition de fonction existante dans le catalogue de données.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données contenant la fonction à mettre à jour. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue contenant la fonction à mettre à jour.
+ `FunctionName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la fonction.
+ `FunctionInput` – *Obligatoire :* un objet [UserDefinedFunctionInput](#aws-glue-api-catalog-functions-UserDefinedFunctionInput).

  Objet `FunctionInput` qui redéfinit la fonction à créer dans le catalogue de données.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## DeleteUserDefinedFunction action (Python : delete\$1user\$1defined\$1function)
<a name="aws-glue-api-catalog-functions-DeleteUserDefinedFunction"></a>

Supprime une définition de fonction existante du catalogue de données.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données contenant la fonction à supprimer. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue contenant la fonction.
+ `FunctionName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la définition de fonction à supprimer.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetUserDefinedFunction action (Python : get\$1user\$1defined\$1function)
<a name="aws-glue-api-catalog-functions-GetUserDefinedFunction"></a>

Extrait une définition de fonction spécifiée du catalogue de données.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données contenant la fonction à extraire. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue contenant la fonction.
+ `FunctionName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la fonction.

**Réponse**
+ `UserDefinedFunction` – Un objet [UserDefinedFunction](#aws-glue-api-catalog-functions-UserDefinedFunction).

  Définition de la fonction demandée.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## GetUserDefinedFunctions action (Python : get\$1user\$1defined\$1functions)
<a name="aws-glue-api-catalog-functions-GetUserDefinedFunctions"></a>

Extrait plusieurs définitions de fonction du catalogue de données.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données contenant les fonction à extraire. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `DatabaseName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue contenant les fonctions. Si aucune n'est fournie, des fonctions de toutes les bases de données du catalogue seront renvoyées.
+ `Pattern` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaîne de modèle nom-fonction facultative qui filtre les définitions de fonction renvoyées.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.
+ `MaxResults` – Nombre (entier), compris entre 1 et 100.

  Nombre maximum de fonctions renvoyées par réponse.

**Réponse**
+ `UserDefinedFunctions` : un tableau d’objets [UserDefinedFunction](#aws-glue-api-catalog-functions-UserDefinedFunction).

  Liste des définitions de fonction demandées.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, si la liste de fonctions renvoyée n'inclut pas la dernière fonction demandée.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`

# Importation d'un Athena catalogue dans AWS Glue
<a name="aws-glue-api-catalog-migration"></a>

L'API de migration décrit AWS Glue les types de données et les opérations liées à la migration d'un catalogue de Athena données vers AWS Glue.

## Types de données
<a name="aws-glue-api-catalog-migration-objects"></a>
+ [CatalogImportStatus structure](#aws-glue-api-catalog-migration-CatalogImportStatus)

## CatalogImportStatus structure
<a name="aws-glue-api-catalog-migration-CatalogImportStatus"></a>

Structure contenant les informations sur le statut de la migration.

**Champs**
+ `ImportCompleted` : booléen.

  `True` si la migration est terminée ou `False` dans le cas contraire.
+ `ImportTime` – Horodatage.

  Heure à laquelle la migration a été démarrée.
+ `ImportedBy` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la personne ayant lancé la migration.

## Opérations
<a name="aws-glue-api-catalog-migration-actions"></a>
+ [ImportCatalogToGlue action (Python : import\$1catalog\$1to\$1glue)](#aws-glue-api-catalog-migration-ImportCatalogToGlue)
+ [GetCatalogImportStatus action (Python : get\$1catalog\$1import\$1status)](#aws-glue-api-catalog-migration-GetCatalogImportStatus)

## ImportCatalogToGlue action (Python : import\$1catalog\$1to\$1glue)
<a name="aws-glue-api-catalog-migration-ImportCatalogToGlue"></a>

Importe un catalogue de données Amazon Athena existant dans. AWS Glue

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue à importer. Actuellement, il devrait s'agir de l'identifiant du AWS compte.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetCatalogImportStatus action (Python : get\$1catalog\$1import\$1status)
<a name="aws-glue-api-catalog-migration-GetCatalogImportStatus"></a>

Extrait le statut d'une opération de migration.

**Demande**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue à migrer. Actuellement, il devrait s'agir de l'identifiant du AWS compte.

**Réponse**
+ `ImportStatus` – Un objet [CatalogImportStatus](#aws-glue-api-catalog-migration-CatalogImportStatus).

  Statut de la migration du catalogue spécifié.

**Erreurs**
+ `InternalServiceException`
+ `OperationTimeoutException`

# API d'optimiseur de table
<a name="aws-glue-api-table-optimizers"></a>

L'API d'optimisation de table décrit l' AWS Glue API permettant d'activer le compactage afin d'améliorer les performances de lecture.

## Types de données
<a name="aws-glue-api-table-optimizers-objects"></a>
+ [TableOptimizer structure](#aws-glue-api-table-optimizers-TableOptimizer)
+ [TableOptimizerConfiguration structure](#aws-glue-api-table-optimizers-TableOptimizerConfiguration)
+ [TableOptimizerVpcConfiguration structure](#aws-glue-api-table-optimizers-TableOptimizerVpcConfiguration)
+ [CompactionConfiguration structure](#aws-glue-api-table-optimizers-CompactionConfiguration)
+ [IcebergCompactionConfiguration structure](#aws-glue-api-table-optimizers-IcebergCompactionConfiguration)
+ [TableOptimizerRun structure](#aws-glue-api-table-optimizers-TableOptimizerRun)
+ [BatchGetTableOptimizerEntry structure](#aws-glue-api-table-optimizers-BatchGetTableOptimizerEntry)
+ [BatchTableOptimizer structure](#aws-glue-api-table-optimizers-BatchTableOptimizer)
+ [BatchGetTableOptimizerError structure](#aws-glue-api-table-optimizers-BatchGetTableOptimizerError)
+ [RetentionConfiguration structure](#aws-glue-api-table-optimizers-RetentionConfiguration)
+ [IcebergRetentionConfiguration structure](#aws-glue-api-table-optimizers-IcebergRetentionConfiguration)
+ [OrphanFileDeletionConfiguration structure](#aws-glue-api-table-optimizers-OrphanFileDeletionConfiguration)
+ [IcebergOrphanFileDeletionConfiguration structure](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionConfiguration)
+ [CompactionMetrics structure](#aws-glue-api-table-optimizers-CompactionMetrics)
+ [RetentionMetrics structure](#aws-glue-api-table-optimizers-RetentionMetrics)
+ [OrphanFileDeletionMetrics structure](#aws-glue-api-table-optimizers-OrphanFileDeletionMetrics)
+ [IcebergCompactionMetrics structure](#aws-glue-api-table-optimizers-IcebergCompactionMetrics)
+ [IcebergRetentionMetrics structure](#aws-glue-api-table-optimizers-IcebergRetentionMetrics)
+ [IcebergOrphanFileDeletionMetrics structure](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionMetrics)
+ [RunMetrics structure](#aws-glue-api-table-optimizers-RunMetrics)

## TableOptimizer structure
<a name="aws-glue-api-table-optimizers-TableOptimizer"></a>

Contient des détails sur un optimiseur associé à une table.

**Champs**
+ `type` – Chaîne UTF-8 (valeurs valides : `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  Le type d'optimiseur de table. Les valeurs valides sont :
  + `compaction` : pour gérer le compactage à l’aide d’un optimiseur de table.
  + `retention` : pour gérer la conservation des instantanés à l’aide d’un optimiseur de table.
  + `orphan_file_deletion` : pour gérer la suppression de fichiers orphelins à l’aide d’un optimiseur de table.
+ `configuration` – Un objet [TableOptimizerConfiguration](#aws-glue-api-table-optimizers-TableOptimizerConfiguration).

  Un objet `TableOptimizerConfiguration` spécifié lors de la création ou de la mise à jour d'un optimiseur de table.
+ `lastRun` – Un objet [TableOptimizerRun](#aws-glue-api-table-optimizers-TableOptimizerRun).

  Un objet `TableOptimizerRun` représentant la dernière exécution de l'optimiseur de table.
+ `configurationSource` – Chaîne UTF-8 (valeurs valides : `catalog="CATALOG"` \$1 `table="TABLE"`).

   Spécifie la source de la configuration de l’optimiseur. Cela indique comment l’optimiseur de table a été configuré et quelle entité ou quel service a initié la configuration. 

## TableOptimizerConfiguration structure
<a name="aws-glue-api-table-optimizers-TableOptimizerConfiguration"></a>

Contient des détails sur la configuration d'un optimiseur de table. Vous transmettez cette configuration lors de la création ou de la mise à jour d'un optimiseur de table.

**Champs**
+ `roleArn` – chaîne UTF-8, d’une longueur comprise entre 20 et 2048 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Un rôle transmis par l'appelant qui autorise le service à mettre à jour les ressources associées à l'optimiseur au nom de l'appelant.
+ `enabled` : booléen.

  Si l'optimisation des tables est activée.
+ `vpcConfiguration` – Un objet [TableOptimizerVpcConfiguration](#aws-glue-api-table-optimizers-TableOptimizerVpcConfiguration).

  Un objet `TableOptimizerVpcConfiguration` représentant la configuration VPC pour un optimiseur de table.

  Cette configuration est nécessaire pour optimiser les tables qui se trouvent dans un VPC client.
+ `compactionConfiguration` – Un objet [CompactionConfiguration](#aws-glue-api-table-optimizers-CompactionConfiguration).

  Configuration d’un optimiseur de compactage. Cette configuration définit la manière dont les fichiers de données de votre table seront compactés afin d’améliorer les performances des requêtes et de réduire les coûts de stockage.
+ `retentionConfiguration` – Un objet [RetentionConfiguration](#aws-glue-api-table-optimizers-RetentionConfiguration).

  Configuration d’un optimiseur de conservation d’instantanés.
+ `orphanFileDeletionConfiguration` : un objet [OrphanFileDeletionConfiguration](#aws-glue-api-table-optimizers-OrphanFileDeletionConfiguration).

  Configuration d’un optimiseur de suppression de fichiers orphelins.

## TableOptimizerVpcConfiguration structure
<a name="aws-glue-api-table-optimizers-TableOptimizerVpcConfiguration"></a>

Un objet décrivant la configuration VPC pour un optimiseur de table.

Cette configuration est nécessaire pour optimiser les tables qui se trouvent dans un VPC client.

**Champs**
+ `glueConnectionName` — Chaîne UTF-8, d'une longueur minimale de 1 octet.

  Nom de la AWS Glue connexion utilisée pour le VPC pour l'optimiseur de table.

## CompactionConfiguration structure
<a name="aws-glue-api-table-optimizers-CompactionConfiguration"></a>

Configuration d’un optimiseur de compactage. Cette configuration définit la manière dont les fichiers de données de votre table seront compactés afin d’améliorer les performances des requêtes et de réduire les coûts de stockage.

**Champs**
+ `icebergConfiguration` : un objet [IcebergCompactionConfiguration](#aws-glue-api-table-optimizers-IcebergCompactionConfiguration).

  Configuration d’un optimiseur de compactage Iceberg.

## IcebergCompactionConfiguration structure
<a name="aws-glue-api-table-optimizers-IcebergCompactionConfiguration"></a>

Configuration d’un optimiseur de compactage Iceberg. Cette configuration définit les paramètres permettant d’optimiser la disposition des fichiers de données dans les tables Iceberg.

**Champs**
+ `strategy` – Chaîne UTF-8 (valeurs valides : `binpack="BINPACK"` \$1 `sort="SORT"` \$1 `z-order="ZORDER"`).

  Stratégie à utiliser pour le compactage. Les valeurs valides sont :
  +  `binpack` : combine de petits fichiers en fichiers plus volumineux, en ciblant généralement des tailles supérieures à 100 Mo, tout en appliquant les suppressions en attente. Il s’agit de la stratégie de compactage recommandée dans la plupart des cas d’utilisation. 
  +  `sort` : organise les données en fonction de colonnes spécifiées qui sont triées hiérarchiquement lors du compactage, améliorant ainsi les performances des requêtes pour les opérations filtrées. Cette stratégie est recommandée lorsque vos requêtes filtrent fréquemment sur des colonnes spécifiques. Pour utiliser cette stratégie, vous devez d’abord définir un ordre de tri dans les propriétés de votre table Iceberg à l’aide de la propriété de table `sort_order`.
  +  `z-order` : optimise l’organisation des données en fusionnant plusieurs attributs en une seule valeur scalaire qui peut être utilisée pour le tri, ce qui permet d’effectuer des requêtes efficaces sur plusieurs dimensions. Cette stratégie est recommandée lorsque vous devez interroger des données simultanément sur plusieurs dimensions. Pour utiliser cette stratégie, vous devez d’abord définir un ordre de tri dans les propriétés de votre table Iceberg à l’aide de la propriété de table `sort_order`. 

  Si aucune entrée n’est fournie, la valeur par défaut « binpack » sera utilisée.
+ `minInputFiles` : nombre (entier).

  Le nombre minimum de fichiers de données qui doivent être présents dans une partition avant le compactage permet en réalité de compacter les fichiers. Ce paramètre permet de contrôler le moment où le compactage est déclenché, empêchant ainsi les opérations de compactage inutiles sur les partitions contenant peu de fichiers. Si aucune entrée n’est fournie, la valeur par défaut 100 sera utilisée.
+ `deleteFileThreshold` : nombre (entier).

  Nombre minimal de suppressions qui doivent être présentes dans un fichier de données pour qu’il puisse être compacté. Ce paramètre permet d’optimiser le compactage en se concentrant sur les fichiers contenant un nombre important d’opérations de suppression, ce qui peut améliorer les performances des requêtes en supprimant les enregistrements supprimés. Si aucune entrée n’est fournie, la valeur par défaut 1 sera utilisée.

## TableOptimizerRun structure
<a name="aws-glue-api-table-optimizers-TableOptimizerRun"></a>

Contient les détails relatifs à l'exécution d'un optimiseur de table.

**Champs**
+ `eventType` – Chaîne UTF-8 (valeurs valides : `starting="STARTING"` \$1 `completed="COMPLETED"` \$1 `failed="FAILED"` \$1 `in_progress="IN_PROGRESS"`).

  Un type d'événement représentant l'état de l'exécution de l'optimiseur de table.
+ `startTimestamp` – Horodatage.

  Représente l'horodatage de l'époque à laquelle la tâche de compactage a commencé dans Lake Formation.
+ `endTimestamp` – Horodatage.

  Représente l'horodatage de l'époque à laquelle la tâche de compactage s'est terminée.
+ `metrics` – Un objet [RunMetrics](#aws-glue-api-table-optimizers-RunMetrics).

  Un objet `RunMetrics` contenant des métriques pour l'exécution de l'optimiseur.

  Ce membre est obsolète. Consultez les membres individuels de la métrique pour le compactage, la conservation et la suppression des fichiers orphelins.
+ `error` – Chaîne UTF-8.

  Une erreur survenue lors de l'exécution de l'optimiseur.
+ `compactionMetrics` – Un objet [CompactionMetrics](#aws-glue-api-table-optimizers-CompactionMetrics).

  Un objet `CompactionMetrics` contenant des métriques pour l'exécution de l'optimiseur.
+ `compactionStrategy` – Chaîne UTF-8 (valeurs valides : `binpack="BINPACK"` \$1 `sort="SORT"` \$1 `z-order="ZORDER"`).

  Stratégie utilisée pour l’exécution du compactage. Indique quel algorithme a été appliqué pour déterminer comment les fichiers ont été sélectionnés et combinés pendant le processus de compactage. Les valeurs valides sont :
  +  `binpack` : combine de petits fichiers en fichiers plus volumineux, en ciblant généralement des tailles supérieures à 100 Mo, tout en appliquant les suppressions en attente. Il s’agit de la stratégie de compactage recommandée dans la plupart des cas d’utilisation. 
  +  `sort` : organise les données en fonction de colonnes spécifiées qui sont triées hiérarchiquement lors du compactage, améliorant ainsi les performances des requêtes pour les opérations filtrées. Cette stratégie est recommandée lorsque vos requêtes filtrent fréquemment sur des colonnes spécifiques. Pour utiliser cette stratégie, vous devez d’abord définir un ordre de tri dans les propriétés de votre table Iceberg à l’aide de la propriété de table `sort_order`.
  +  `z-order` : optimise l’organisation des données en fusionnant plusieurs attributs en une seule valeur scalaire qui peut être utilisée pour le tri, ce qui permet d’effectuer des requêtes efficaces sur plusieurs dimensions. Cette stratégie est recommandée lorsque vous devez interroger des données simultanément sur plusieurs dimensions. Pour utiliser cette stratégie, vous devez d’abord définir un ordre de tri dans les propriétés de votre table Iceberg à l’aide de la propriété de table `sort_order`. 
+ `retentionMetrics` – Un objet [RetentionMetrics](#aws-glue-api-table-optimizers-RetentionMetrics).

  Un objet `RetentionMetrics` contenant des métriques pour l'exécution de l'optimiseur.
+ `orphanFileDeletionMetrics` : un objet [OrphanFileDeletionMetrics](#aws-glue-api-table-optimizers-OrphanFileDeletionMetrics).

  Objet `OrphanFileDeletionMetrics` contenant des métriques pour l’exécution de l’optimiseur.

## BatchGetTableOptimizerEntry structure
<a name="aws-glue-api-table-optimizers-BatchGetTableOptimizerEntry"></a>

Représente un optimiseur de table à récupérer lors de l'opération `BatchGetTableOptimizer`.

**Champs**
+ `catalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID de catalogue de la table.
+ `databaseName` — Chaîne UTF-8, d'une longueur minimale de 1 octet.

  Nom de la base de données du catalogue où se trouve la table.
+ `tableName` — Chaîne UTF-8, d'une longueur minimale de 1 octet.

  Nom de la table.
+ `type` – Chaîne UTF-8 (valeurs valides : `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  Le type d'optimiseur de table.

## BatchTableOptimizer structure
<a name="aws-glue-api-table-optimizers-BatchTableOptimizer"></a>

Contient les détails de l'un des optimiseurs de table renvoyés par l'opération `BatchGetTableOptimizer`.

**Champs**
+ `catalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID de catalogue de la table.
+ `databaseName` — Chaîne UTF-8, d'une longueur minimale de 1 octet.

  Nom de la base de données du catalogue où se trouve la table.
+ `tableName` — Chaîne UTF-8, d'une longueur minimale de 1 octet.

  Nom de la table.
+ `tableOptimizer` – Un objet [TableOptimizer](#aws-glue-api-table-optimizers-TableOptimizer).

  Un objet `TableOptimizer` qui contient des détails sur la configuration et la dernière exécution d’un optimiseur de table.

## BatchGetTableOptimizerError structure
<a name="aws-glue-api-table-optimizers-BatchGetTableOptimizerError"></a>

Contient des détails sur l'une des erreurs de la liste d'erreurs renvoyée par l'opération `BatchGetTableOptimizer`.

**Champs**
+ `error` : un objet [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail).

  Un objet `ErrorDetail` contenant le code et les détails du message sur l'erreur.
+ `catalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID de catalogue de la table.
+ `databaseName` — Chaîne UTF-8, d'une longueur minimale de 1 octet.

  Nom de la base de données du catalogue où se trouve la table.
+ `tableName` — Chaîne UTF-8, d'une longueur minimale de 1 octet.

  Nom de la table.
+ `type` – Chaîne UTF-8 (valeurs valides : `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  Le type d'optimiseur de table.

## RetentionConfiguration structure
<a name="aws-glue-api-table-optimizers-RetentionConfiguration"></a>

Configuration d’un optimiseur de conservation d’instantanés.

**Champs**
+ `icebergConfiguration` : un objet [IcebergRetentionConfiguration](#aws-glue-api-table-optimizers-IcebergRetentionConfiguration).

  Configuration d’un optimiseur de conservation des instantanés Iceberg.

## IcebergRetentionConfiguration structure
<a name="aws-glue-api-table-optimizers-IcebergRetentionConfiguration"></a>

Configuration d’un optimiseur de conservation des instantanés Iceberg.

**Champs**
+ `snapshotRetentionPeriodInDays` : nombre (entier).

  Nombre de jours pendant lesquels les instantanés Iceberg doivent être conservés. Si aucune entrée n’est fournie, le champ de configuration de table Iceberg correspondant sera utilisé ou, s’il n’est pas présent, la valeur par défaut 5 sera utilisée.
+ `numberOfSnapshotsToRetain` : nombre (entier).

  Nombre d’instantanés Iceberg à conserver pendant la période de conservation. Si aucune entrée n’est fournie, le champ de configuration de table Iceberg correspondant sera utilisé ou, s’il n’est pas présent, la valeur par défaut 1 sera utilisée.
+ `cleanExpiredFiles` : booléen.

  Si cette valeur est définie sur false, les instantanés sont uniquement supprimés des métadonnées de la table, et les fichiers de données et de métadonnées sous-jacents ne sont pas supprimés.
+ `runRateInHours` : nombre (entier).

  Intervalle en heures entre les exécutions des tâches de conservation. Ce paramètre contrôle la fréquence d’exécution de l’optimiseur de conservation pour nettoyer les instantanés expirés. La valeur doit être comprise entre 3 et 168 heures (7 jours). Si aucune entrée n’est fournie, la valeur par défaut 24 sera utilisée.

## OrphanFileDeletionConfiguration structure
<a name="aws-glue-api-table-optimizers-OrphanFileDeletionConfiguration"></a>

Configuration d’un optimiseur de suppression de fichiers orphelins.

**Champs**
+ `icebergConfiguration` : un objet [IcebergOrphanFileDeletionConfiguration](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionConfiguration).

  Configuration d’un optimiseur de suppression de fichiers orphelins Iceberg.

## IcebergOrphanFileDeletionConfiguration structure
<a name="aws-glue-api-table-optimizers-IcebergOrphanFileDeletionConfiguration"></a>

Configuration d’un optimiseur de suppression de fichiers orphelins Iceberg.

**Champs**
+ `orphanFileRetentionPeriodInDays` : nombre (entier).

  Nombre de jours pendant lesquels les fichiers orphelins doivent être conservés avant leur suppression. Si aucune entrée n’est fournie, la valeur par défaut 3 sera utilisée.
+ `location` – Chaîne UTF-8.

  Spécifie un répertoire dans lequel les fichiers seront recherchés (par défaut, l’emplacement de la table). Vous pouvez choisir un sous-répertoire plutôt que l’emplacement de la table de niveau supérieur.
+ `runRateInHours` : nombre (entier).

  L’intervalle en heures entre les exécutions des tâches de suppression de fichiers orphelins. Ce paramètre contrôle la fréquence à laquelle l’optimiseur de suppression des fichiers orphelins sera exécuté pour nettoyer les fichiers orphelins. La valeur doit être comprise entre 3 et 168 heures (7 jours). Si aucune entrée n’est fournie, la valeur par défaut 24 sera utilisée.

## CompactionMetrics structure
<a name="aws-glue-api-table-optimizers-CompactionMetrics"></a>

Structure contenant les métriques de compactage pour l’exécution de l’optimiseur.

**Champs**
+ `IcebergMetrics` : un objet [IcebergCompactionMetrics](#aws-glue-api-table-optimizers-IcebergCompactionMetrics).

  Structure contenant les métriques de compactage Iceberg pour l’exécution de l’optimiseur.

## RetentionMetrics structure
<a name="aws-glue-api-table-optimizers-RetentionMetrics"></a>

Structure contenant les métriques de conservation pour l’exécution de l’optimiseur.

**Champs**
+ `IcebergMetrics` : un objet [IcebergRetentionMetrics](#aws-glue-api-table-optimizers-IcebergRetentionMetrics).

  Structure contenant les métriques de conservation Iceberg pour l’exécution de l’optimiseur.

## OrphanFileDeletionMetrics structure
<a name="aws-glue-api-table-optimizers-OrphanFileDeletionMetrics"></a>

Structure contenant les métriques de suppression de fichiers orphelins pour l’exécution de l’optimiseur.

**Champs**
+ `IcebergMetrics` : un objet [IcebergOrphanFileDeletionMetrics](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionMetrics).

  Structure contenant les métriques de suppression des fichiers orphelins Iceberg pour l’exécution de l’optimiseur.

## IcebergCompactionMetrics structure
<a name="aws-glue-api-table-optimizers-IcebergCompactionMetrics"></a>

Métriques de compactage d’Iceberg pour l’exécution de l’optimiseur.

**Champs**
+ `DpuHours` – Nombre (double).

  Nombre d'heures DPU consommées par la tâche.
+ `NumberOfDpus` : nombre (entier).

  Le nombre de personnes DPUs consommées par la tâche, arrondi au nombre entier le plus proche.
+ `JobDurationInHour` – Nombre (double).

  Durée de la tâche en heures.

## IcebergRetentionMetrics structure
<a name="aws-glue-api-table-optimizers-IcebergRetentionMetrics"></a>

Métriques de conservation des instantanés d’Iceberg pour l’exécution de l’optimiseur.

**Champs**
+ `DpuHours` – Nombre (double).

  Nombre d'heures DPU consommées par la tâche.
+ `NumberOfDpus` : nombre (entier).

  Le nombre de personnes DPUs consommées par la tâche, arrondi au nombre entier le plus proche.
+ `JobDurationInHour` – Nombre (double).

  Durée de la tâche en heures.

## IcebergOrphanFileDeletionMetrics structure
<a name="aws-glue-api-table-optimizers-IcebergOrphanFileDeletionMetrics"></a>

Métriques de suppression de fichiers orphelins d’Iceberg pour l’exécution de l’optimiseur.

**Champs**
+ `DpuHours` – Nombre (double).

  Nombre d'heures DPU consommées par la tâche.
+ `NumberOfDpus` : nombre (entier).

  Le nombre de personnes DPUs consommées par la tâche, arrondi au nombre entier le plus proche.
+ `JobDurationInHour` – Nombre (double).

  Durée de la tâche en heures.

## RunMetrics structure
<a name="aws-glue-api-table-optimizers-RunMetrics"></a>

Métriques relatives à l'exécution de l'optimiseur.

Cette structure est obsolète. Consultez les membres individuels de la métrique pour le compactage, la conservation et la suppression des fichiers orphelins.

**Champs**
+ `NumberOfBytesCompacted` – Chaîne UTF-8.

  Nombre d'octets supprimés lors de l'exécution de la tâche de compactage.
+ `NumberOfFilesCompacted` – Chaîne UTF-8.

  Nombre de fichiers supprimés lors de l'exécution de la tâche de compactage.
+ `NumberOfDpus` – Chaîne UTF-8.

  Le nombre de personnes DPUs consommées par la tâche, arrondi au nombre entier le plus proche.
+ `JobDurationInHour` – Chaîne UTF-8.

  Durée de la tâche en heures.

## Opérations
<a name="aws-glue-api-table-optimizers-actions"></a>
+ [GetTableOptimizer action (Python : get\$1table\$1optimizer)](#aws-glue-api-table-optimizers-GetTableOptimizer)
+ [BatchGetTableOptimizer action (Python : batch\$1get\$1table\$1optimizer)](#aws-glue-api-table-optimizers-BatchGetTableOptimizer)
+ [ListTableOptimizerRuns action (Python : list\$1table\$1optimizer\$1runs)](#aws-glue-api-table-optimizers-ListTableOptimizerRuns)
+ [CreateTableOptimizer action (Python : create\$1table\$1optimizer)](#aws-glue-api-table-optimizers-CreateTableOptimizer)
+ [DeleteTableOptimizer action (Python : delete\$1table\$1optimizer)](#aws-glue-api-table-optimizers-DeleteTableOptimizer)
+ [UpdateTableOptimizer action (Python : update\$1table\$1optimizer)](#aws-glue-api-table-optimizers-UpdateTableOptimizer)

## GetTableOptimizer action (Python : get\$1table\$1optimizer)
<a name="aws-glue-api-table-optimizers-GetTableOptimizer"></a>

Renvoie la configuration de tous les optimiseurs associés à une table spécifiée.

**Demande**
+ `CatalogId` – *Obligatoire :* Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID de catalogue de la table.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue où se trouve la table.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table.
+ `Type` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  Le type d'optimiseur de table.

**Réponse**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID de catalogue de la table.
+ `DatabaseName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue où se trouve la table.
+ `TableName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table.
+ `TableOptimizer` – Un objet [TableOptimizer](#aws-glue-api-table-optimizers-TableOptimizer).

  L'optimiseur associé à la table spécifiée.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `AccessDeniedException`
+ `InternalServiceException`
+ `ThrottlingException`

## BatchGetTableOptimizer action (Python : batch\$1get\$1table\$1optimizer)
<a name="aws-glue-api-table-optimizers-BatchGetTableOptimizer"></a>

Renvoie la configuration des optimiseurs de table spécifiés.

**Demande**
+ `Entries` – *Obligatoire :* un tableau d’objets [BatchGetTableOptimizerEntry](#aws-glue-api-table-optimizers-BatchGetTableOptimizerEntry).

  Liste d'objets `BatchGetTableOptimizerEntry` spécifiant les optimiseurs de table à récupérer.

**Réponse**
+ `TableOptimizers` : un tableau d’objets [BatchTableOptimizer](#aws-glue-api-table-optimizers-BatchTableOptimizer).

  Liste d’objets `BatchTableOptimizer`.
+ `Failures` : un tableau d’objets [BatchGetTableOptimizerError](#aws-glue-api-table-optimizers-BatchGetTableOptimizerError).

  Liste des erreurs liées à l'opération.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `AccessDeniedException`
+ `InternalServiceException`
+ `ThrottlingException`

## ListTableOptimizerRuns action (Python : list\$1table\$1optimizer\$1runs)
<a name="aws-glue-api-table-optimizers-ListTableOptimizerRuns"></a>

Répertorie l'historique des exécutions précédentes de l'optimiseur pour une table spécifique.

**Demande**
+ `CatalogId` – *Obligatoire :* Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID de catalogue de la table.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue où se trouve la table.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table.
+ `Type` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  Le type d'optimiseur de table.
+ `MaxResults` : nombre (entier).

  Nombre maximal d'exécutions d'optimisation à renvoyer à chaque appel.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.

**Réponse**
+ `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID de catalogue de la table.
+ `DatabaseName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue où se trouve la table.
+ `TableName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation pour la pagination de la liste renvoyée des exécutions de l'optimiseur, renvoyé si le segment actuel de la liste n'est pas le dernier.
+ `TableOptimizerRuns` : un tableau d’objets [TableOptimizerRun](#aws-glue-api-table-optimizers-TableOptimizerRun).

  Une liste des exécutions d'optimiseur associées à une table.

**Erreurs**
+ `EntityNotFoundException`
+ `AccessDeniedException`
+ `InvalidInputException`
+ `ValidationException`
+ `InternalServiceException`
+ `ThrottlingException`

## CreateTableOptimizer action (Python : create\$1table\$1optimizer)
<a name="aws-glue-api-table-optimizers-CreateTableOptimizer"></a>

Créer un optimiseur de table pour une fonction spécifique. 

**Demande**
+ `CatalogId` – *Obligatoire :* Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID de catalogue de la table.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue où se trouve la table.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table.
+ `Type` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  Le type d'optimiseur de table.
+ `TableOptimizerConfiguration` – *Obligatoire :* un objet [TableOptimizerConfiguration](#aws-glue-api-table-optimizers-TableOptimizerConfiguration).

  Un objet `TableOptimizerConfiguration` représentant la configuration d'un optimiseur de table.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `ValidationException`
+ `InvalidInputException`
+ `AccessDeniedException`
+ `AlreadyExistsException`
+ `InternalServiceException`
+ `ThrottlingException`

## DeleteTableOptimizer action (Python : delete\$1table\$1optimizer)
<a name="aws-glue-api-table-optimizers-DeleteTableOptimizer"></a>

Supprime un optimiseur et toutes les métadonnées associées à une table. L'optimisation ne sera plus effectuée sur la table.

**Demande**
+ `CatalogId` – *Obligatoire :* Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID de catalogue de la table.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue où se trouve la table.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table.
+ `Type` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  Le type d'optimiseur de table.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `AccessDeniedException`
+ `InternalServiceException`
+ `ThrottlingException`

## UpdateTableOptimizer action (Python : update\$1table\$1optimizer)
<a name="aws-glue-api-table-optimizers-UpdateTableOptimizer"></a>

Met à jour la configuration d'un optimiseur de table existant.

**Demande**
+ `CatalogId` – *Obligatoire :* Chaîne d'ID de catalogue, d'une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID de catalogue de la table.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données du catalogue où se trouve la table.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table.
+ `Type` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  Le type d'optimiseur de table.
+ `TableOptimizerConfiguration` – *Obligatoire :* un objet [TableOptimizerConfiguration](#aws-glue-api-table-optimizers-TableOptimizerConfiguration).

  Un objet `TableOptimizerConfiguration` représentant la configuration d'un optimiseur de table.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `AccessDeniedException`
+ `ValidationException`
+ `InternalServiceException`
+ `ThrottlingException`
+ `ConcurrentModificationException`

# API de classifieurs et d'crawlers
<a name="aws-glue-api-crawler"></a>

L'API Crawler and classifiers décrit les types de données du AWS Glue crawler et du classificateur, et inclut l'API permettant de créer, supprimer, mettre à jour et répertorier les crawlers ou les classificateurs.

**Topics**
+ [API du classifieur](aws-glue-api-crawler-classifiers.md)
+ [API du crawler](aws-glue-api-crawler-crawling.md)
+ [API de statistiques de colonne](aws-glue-api-crawler-column-statistics.md)
+ [API du planificateur du crawler](aws-glue-api-crawler-scheduler.md)

# API du classifieur
<a name="aws-glue-api-crawler-classifiers"></a>

L'API Classifier décrit les types de données du AWS Glue classificateur et inclut l'API permettant de créer, de supprimer, de mettre à jour et de répertorier les classificateurs.

## Types de données
<a name="aws-glue-api-crawler-classifiers-objects"></a>
+ [Structure du classifieur](#aws-glue-api-crawler-classifiers-Classifier)
+ [GrokClassifier structure](#aws-glue-api-crawler-classifiers-GrokClassifier)
+ [XMLClassifier structure](#aws-glue-api-crawler-classifiers-XMLClassifier)
+ [JsonClassifier structure](#aws-glue-api-crawler-classifiers-JsonClassifier)
+ [CsvClassifier structure](#aws-glue-api-crawler-classifiers-CsvClassifier)
+ [CreateGrokClassifierRequest structure](#aws-glue-api-crawler-classifiers-CreateGrokClassifierRequest)
+ [UpdateGrokClassifierRequest structure](#aws-glue-api-crawler-classifiers-UpdateGrokClassifierRequest)
+ [Créer une structure XMLClassifier de demande](#aws-glue-api-crawler-classifiers-CreateXMLClassifierRequest)
+ [Structure de XMLClassifier demande de mise à jour](#aws-glue-api-crawler-classifiers-UpdateXMLClassifierRequest)
+ [CreateJsonClassifierRequest structure](#aws-glue-api-crawler-classifiers-CreateJsonClassifierRequest)
+ [UpdateJsonClassifierRequest structure](#aws-glue-api-crawler-classifiers-UpdateJsonClassifierRequest)
+ [CreateCsvClassifierRequest structure](#aws-glue-api-crawler-classifiers-CreateCsvClassifierRequest)
+ [UpdateCsvClassifierRequest structure](#aws-glue-api-crawler-classifiers-UpdateCsvClassifierRequest)

## Structure du classifieur
<a name="aws-glue-api-crawler-classifiers-Classifier"></a>

Les classifieurs sont déclenchés durant une tâche d'analyse. Un classifieur vérifie si un fichier donné est dans un format qu'il peut gérer. Si c'est le cas, le classifieur crée un schéma sous la forme d'un objet `StructType` correspondant à ce format de données.

Vous pouvez utiliser les classificateurs standard AWS Glue fournis, ou vous pouvez écrire vos propres classificateurs pour classer au mieux vos sources de données et spécifier les schémas appropriés à utiliser pour celles-ci. Un classifieur peut être un classifieur `grok`, un classifieur `XML`, un classifieur `JSON` ou un classifieur `CSV` personnalisé, selon ce qui est spécifié dans l'un des champs de l'objet `Classifier`.

**Champs**
+ `GrokClassifier` – Un objet [GrokClassifier](#aws-glue-api-crawler-classifiers-GrokClassifier).

  Classificateur qui utilise `grok`.
+ `XMLClassifier` – Un objet [XMLClassifier](#aws-glue-api-crawler-classifiers-XMLClassifier).

  Classificateur de contenu XML.
+ `JsonClassifier` – Un objet [JsonClassifier](#aws-glue-api-crawler-classifiers-JsonClassifier).

  Classificateur de contenu JSON.
+ `CsvClassifier` – Un objet [CsvClassifier](#aws-glue-api-crawler-classifiers-CsvClassifier).

  Classificateur pour les valeurs séparées par des virgules (CSV).

## GrokClassifier structure
<a name="aws-glue-api-crawler-classifiers-GrokClassifier"></a>

Classifieur qui utilise des modèles `grok`.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du classifieur.
+ `Classification` – *Obligatoire :* chaîne UTF-8.

  Identifiant du format des données auquel le classifieur correspond, comme les journaux Twitter, JSON, Omniture, etc.
+ `CreationTime` – Horodatage.

  Heure à laquelle ce classificateur a été enregistré.
+ `LastUpdated` – Horodatage.

  Heure de la dernière mise à jour de ce classifieur.
+ `Version` – Nombre (long).

  Version de ce classifieur.
+ `GrokPattern` – *Obligatoire :* chaîne UTF-8, d'une longueur comprise entre 1 et 2048 octets, correspondant au [A Logstash Grok string pattern](aws-glue-api-common.md#aws-glue-api-grok-pattern).

  Modèle grok appliqué à un magasin de données par ce classifieur. Pour plus d'informations, consultez les modèles intégrés dans [Writing Custom Classifiers](https://docs.aws.amazon.com/glue/latest/dg/custom-classifier.html) (Écriture de classifieurs personnalisés).
+ `CustomPatterns` – Chaîne UTF-8, d'une longueur maximale de 16 000 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Modèles grok personnalisés facultatifs définis par ce classifieur. Pour plus d'informations, consultez les modèles personnalisés dans [Writing Custom Classifiers](https://docs.aws.amazon.com/glue/latest/dg/custom-classifier.html) (Écriture de classifieurs personnalisés).

## XMLClassifier structure
<a name="aws-glue-api-crawler-classifiers-XMLClassifier"></a>

Classifieur de contenu `XML`.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du classifieur.
+ `Classification` – *Obligatoire :* chaîne UTF-8.

  Identifiant du format des données que le classifieur fait correspondre.
+ `CreationTime` – Horodatage.

  Heure à laquelle ce classificateur a été enregistré.
+ `LastUpdated` – Horodatage.

  Heure de la dernière mise à jour de ce classifieur.
+ `Version` – Nombre (long).

  Version de ce classifieur.
+ `RowTag` – Chaîne UTF-8.

  Balise XML désignant l'élément contenant chaque enregistrement d'un document XML en cours d'analyse. Cela ne permet pas d'identifier un élément à fermeture automatique (fermé par `/>`). Un élément de ligne vide contenant uniquement des attributs peut être analysé tant qu'il se termine par une balise de fermeture (par exemple, `<row item_a="A" item_b="B"></row>` est correct, mais `<row item_a="A" item_b="B" />` ne l'est pas).

## JsonClassifier structure
<a name="aws-glue-api-crawler-classifiers-JsonClassifier"></a>

Classifieur de contenu `JSON`.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du classifieur.
+ `CreationTime` – Horodatage.

  Heure à laquelle ce classificateur a été enregistré.
+ `LastUpdated` – Horodatage.

  Heure de la dernière mise à jour de ce classifieur.
+ `Version` – Nombre (long).

  Version de ce classifieur.
+ `JsonPath` – *Obligatoire :* chaîne UTF-8.

  `JsonPath`Chaîne définissant les données JSON à classer par le classificateur. AWS Glue prend en charge un sous-ensemble de JsonPath, comme décrit dans la section [Écrire des JsonPath classificateurs personnalisés](https://docs.aws.amazon.com/glue/latest/dg/custom-classifier.html#custom-classifier-json).

## CsvClassifier structure
<a name="aws-glue-api-crawler-classifiers-CsvClassifier"></a>

Classifieur de contenu `CSV` personnalisé.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du classifieur.
+ `CreationTime` – Horodatage.

  Heure à laquelle ce classificateur a été enregistré.
+ `LastUpdated` – Horodatage.

  Heure de la dernière mise à jour de ce classifieur.
+ `Version` – Nombre (long).

  Version de ce classifieur.
+ `Delimiter` – Chaîne UTF-8, d'une longueur d'au moins 1 ou de plus de 1 octet, correspondant au [Custom string pattern #26](aws-glue-api-common.md#regex_26).

  Symbole personnalisé pour indiquer ce qui sépare chaque entrée de colonne dans la ligne.
+ `QuoteSymbol` – Chaîne UTF-8, d'une longueur d'au moins 1 ou de plus de 1 octet, correspondant au [Custom string pattern #26](aws-glue-api-common.md#regex_26).

  Symbole personnalisé pour indiquer ce qui combine le contenu en une seule valeur de colonne. Doit être différent du délimiteur de colonne.
+ `ContainsHeader` – Chaîne UTF-8 (valeurs valides : `UNKNOWN` \$1 `PRESENT` \$1 `ABSENT`).

  Indique si le fichier CSV contient un en-tête.
+ `Header` – Tableau de chaînes UTF-8.

  Liste des chaînes représentant les noms des colonnes.
+ `DisableValueTrimming` : booléen.

  Spécifie de ne pas couper les valeurs avant d'identifier le type des valeurs de colonne. La valeur par défaut est `true`.
+ `AllowSingleColumn` : booléen.

  Active le traitement des fichiers qui ne contiennent qu'une seule colonne.
+ `CustomDatatypeConfigured` : booléen.

  Permet de configurer le type de données personnalisé.
+ `CustomDatatypes` – Tableau de chaînes UTF-8.

  Liste de types de données personnalisés, notamment « BINARY », « BOOLEAN », « DATE », « DECIMAL », « DOUBLE », « FLOAT », « INT », « LONG », « SHORT », « STRING », « TIMESTAMP ».
+ `Serde` – Chaîne UTF-8 (valeurs valides : `OpenCSVSerDe` \$1 `LazySimpleSerDe` \$1 `None`).

  Définit le CSV SerDe pour le traitement dans le classificateur, qui sera appliqué dans le catalogue de données. Les valeurs valides sont `OpenCSVSerDe`, `LazySimpleSerDe` et `None`. Vous pouvez spécifier la valeur `None` lorsque vous souhaitez que le Crawler effectue la détection.

## CreateGrokClassifierRequest structure
<a name="aws-glue-api-crawler-classifiers-CreateGrokClassifierRequest"></a>

Spécifie un classifieur `grok` que `CreateClassifier` doit créer.

**Champs**
+ `Classification` – *Obligatoire :* chaîne UTF-8.

  Identifiant du format de données auquel le classificateur correspond, tel que Twitter, JSON, Omniture CloudWatch logs, Amazon Logs, etc.
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du nouveau classifieur.
+ `GrokPattern` – *Obligatoire :* chaîne UTF-8, d'une longueur comprise entre 1 et 2048 octets, correspondant au [A Logstash Grok string pattern](aws-glue-api-common.md#aws-glue-api-grok-pattern).

  Modèle grok utilisé par ce classifieur.
+ `CustomPatterns` – Chaîne UTF-8, d'une longueur maximale de 16 000 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Modèles grok personnalisés facultatifs utilisés par ce classifieur.

## UpdateGrokClassifierRequest structure
<a name="aws-glue-api-crawler-classifiers-UpdateGrokClassifierRequest"></a>

Spécifie un classifieur grok à mettre à jour lorsqu'il est transmis à `UpdateClassifier`.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de l'`GrokClassifier`.
+ `Classification` – Chaîne UTF-8.

  Identifiant du format de données auquel le classificateur correspond, tel que Twitter, JSON, Omniture CloudWatch logs, Amazon Logs, etc.
+ `GrokPattern` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2048 octets, correspondant au [A Logstash Grok string pattern](aws-glue-api-common.md#aws-glue-api-grok-pattern).

  Modèle grok utilisé par ce classifieur.
+ `CustomPatterns` – Chaîne UTF-8, d'une longueur maximale de 16 000 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Modèles grok personnalisés facultatifs utilisés par ce classifieur.

## Créer une structure XMLClassifier de demande
<a name="aws-glue-api-crawler-classifiers-CreateXMLClassifierRequest"></a>

Spécifie un classifieur XML que `CreateClassifier` doit créer.

**Champs**
+ `Classification` – *Obligatoire :* chaîne UTF-8.

  Identifiant du format des données que le classifieur fait correspondre.
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du classifieur.
+ `RowTag` – Chaîne UTF-8.

  Balise XML désignant l'élément contenant chaque enregistrement d'un document XML en cours d'analyse. Cela ne permet pas d'identifier un élément à fermeture automatique (fermé par `/>`). Un élément de ligne vide contenant uniquement des attributs peut être analysé tant qu'il se termine par une balise de fermeture (par exemple, `<row item_a="A" item_b="B"></row>` est correct, mais `<row item_a="A" item_b="B" />` ne l'est pas).

## Structure de XMLClassifier demande de mise à jour
<a name="aws-glue-api-crawler-classifiers-UpdateXMLClassifierRequest"></a>

Spécifie un classifieur XML à mettre à jour.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du classifieur.
+ `Classification` – Chaîne UTF-8.

  Identifiant du format des données que le classifieur fait correspondre.
+ `RowTag` – Chaîne UTF-8.

  Balise XML désignant l'élément contenant chaque enregistrement d'un document XML en cours d'analyse. Cela ne permet pas d’identifier un élément à fermeture automatique (fermé par `/>`). Un élément de ligne vide contenant uniquement des attributs peut être analysé tant qu'il se termine par une balise de fermeture (par exemple, `<row item_a="A" item_b="B"></row>` est correct, mais `<row item_a="A" item_b="B" />` ne l'est pas).

## CreateJsonClassifierRequest structure
<a name="aws-glue-api-crawler-classifiers-CreateJsonClassifierRequest"></a>

Spécifie un classifieur JSON que `CreateClassifier` doit créer.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du classifieur.
+ `JsonPath` – *Obligatoire :* chaîne UTF-8.

  `JsonPath`Chaîne définissant les données JSON à classer par le classificateur. AWS Glue prend en charge un sous-ensemble de JsonPath, comme décrit dans la section [Écrire des JsonPath classificateurs personnalisés](https://docs.aws.amazon.com/glue/latest/dg/custom-classifier.html#custom-classifier-json).

## UpdateJsonClassifierRequest structure
<a name="aws-glue-api-crawler-classifiers-UpdateJsonClassifierRequest"></a>

Spécifie un classifieur JSON à mettre à jour.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du classifieur.
+ `JsonPath` – Chaîne UTF-8.

  `JsonPath`Chaîne définissant les données JSON à classer par le classificateur. AWS Glue prend en charge un sous-ensemble de JsonPath, comme décrit dans la section [Écrire des JsonPath classificateurs personnalisés](https://docs.aws.amazon.com/glue/latest/dg/custom-classifier.html#custom-classifier-json).

## CreateCsvClassifierRequest structure
<a name="aws-glue-api-crawler-classifiers-CreateCsvClassifierRequest"></a>

Spécifie un classifieur CSV personnalisé que `CreateClassifier` doit créer.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du classifieur.
+ `Delimiter` – Chaîne UTF-8, d'une longueur d'au moins 1 ou de plus de 1 octet, correspondant au [Custom string pattern #26](aws-glue-api-common.md#regex_26).

  Symbole personnalisé pour indiquer ce qui sépare chaque entrée de colonne dans la ligne.
+ `QuoteSymbol` – Chaîne UTF-8, d'une longueur d'au moins 1 ou de plus de 1 octet, correspondant au [Custom string pattern #26](aws-glue-api-common.md#regex_26).

  Symbole personnalisé pour indiquer ce qui combine le contenu en une seule valeur de colonne. Doit être différent du délimiteur de colonne.
+ `ContainsHeader` – Chaîne UTF-8 (valeurs valides : `UNKNOWN` \$1 `PRESENT` \$1 `ABSENT`).

  Indique si le fichier CSV contient un en-tête.
+ `Header` – Tableau de chaînes UTF-8.

  Liste des chaînes représentant les noms des colonnes.
+ `DisableValueTrimming` : booléen.

  Spécifie de ne pas couper les valeurs avant d'identifier le type des valeurs de colonne. La valeur par défaut est True.
+ `AllowSingleColumn` : booléen.

  Active le traitement des fichiers qui ne contiennent qu'une seule colonne.
+ `CustomDatatypeConfigured` : booléen.

  Permet la configuration du type de données personnalisé.
+ `CustomDatatypes` – Tableau de chaînes UTF-8.

  Crée une liste des types de données personnalisés pris en charge.
+ `Serde` – Chaîne UTF-8 (valeurs valides : `OpenCSVSerDe` \$1 `LazySimpleSerDe` \$1 `None`).

  Définit le CSV SerDe pour le traitement dans le classificateur, qui sera appliqué dans le catalogue de données. Les valeurs valides sont `OpenCSVSerDe`, `LazySimpleSerDe` et `None`. Vous pouvez spécifier la valeur `None` lorsque vous souhaitez que le Crawler effectue la détection.

## UpdateCsvClassifierRequest structure
<a name="aws-glue-api-crawler-classifiers-UpdateCsvClassifierRequest"></a>

Spécifie un classifieur CSV personnalisé à mettre à jour.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du classifieur.
+ `Delimiter` – Chaîne UTF-8, d'une longueur d'au moins 1 ou de plus de 1 octet, correspondant au [Custom string pattern #26](aws-glue-api-common.md#regex_26).

  Symbole personnalisé pour indiquer ce qui sépare chaque entrée de colonne dans la ligne.
+ `QuoteSymbol` – Chaîne UTF-8, d'une longueur d'au moins 1 ou de plus de 1 octet, correspondant au [Custom string pattern #26](aws-glue-api-common.md#regex_26).

  Symbole personnalisé pour indiquer ce qui combine le contenu en une seule valeur de colonne. Doit être différent du délimiteur de colonne.
+ `ContainsHeader` – Chaîne UTF-8 (valeurs valides : `UNKNOWN` \$1 `PRESENT` \$1 `ABSENT`).

  Indique si le fichier CSV contient un en-tête.
+ `Header` – Tableau de chaînes UTF-8.

  Liste des chaînes représentant les noms des colonnes.
+ `DisableValueTrimming` : booléen.

  Spécifie de ne pas couper les valeurs avant d'identifier le type des valeurs de colonne. La valeur par défaut est True.
+ `AllowSingleColumn` : booléen.

  Active le traitement des fichiers qui ne contiennent qu'une seule colonne.
+ `CustomDatatypeConfigured` : booléen.

  Spécifie la configuration du type de données personnalisé.
+ `CustomDatatypes` – Tableau de chaînes UTF-8.

  Spécifie une liste des types de données personnalisés pris en charge.
+ `Serde` – Chaîne UTF-8 (valeurs valides : `OpenCSVSerDe` \$1 `LazySimpleSerDe` \$1 `None`).

  Définit le CSV SerDe pour le traitement dans le classificateur, qui sera appliqué dans le catalogue de données. Les valeurs valides sont `OpenCSVSerDe`, `LazySimpleSerDe` et `None`. Vous pouvez spécifier la valeur `None` lorsque vous souhaitez que le Crawler effectue la détection.

## Opérations
<a name="aws-glue-api-crawler-classifiers-actions"></a>
+ [CreateClassifier action (Python : create\$1classifier)](#aws-glue-api-crawler-classifiers-CreateClassifier)
+ [DeleteClassifier action (Python : delete\$1classifier)](#aws-glue-api-crawler-classifiers-DeleteClassifier)
+ [GetClassifier action (Python : get\$1classifier)](#aws-glue-api-crawler-classifiers-GetClassifier)
+ [GetClassifiers action (Python : get\$1classifiers)](#aws-glue-api-crawler-classifiers-GetClassifiers)
+ [UpdateClassifier action (Python : update\$1classifier)](#aws-glue-api-crawler-classifiers-UpdateClassifier)

## CreateClassifier action (Python : create\$1classifier)
<a name="aws-glue-api-crawler-classifiers-CreateClassifier"></a>

Crée un classifieur dans le compte de l'utilisateur. Cela peut être un `GrokClassifier`, un `XMLClassifier`, un `JsonClassifier` ou un `CsvClassifier`, selon le champ de la demande qui est présent.

**Demande**
+ `GrokClassifier` – Un objet [CreateGrokClassifierRequest](#aws-glue-api-crawler-classifiers-CreateGrokClassifierRequest).

  Un `GrokClassifier` objet spécifiant le classifieur à créer.
+ `XMLClassifier` – Un objet [Créer une XMLClassifier demande](#aws-glue-api-crawler-classifiers-CreateXMLClassifierRequest).

  Un `XMLClassifier` objet spécifiant le classifieur à créer.
+ `JsonClassifier` – Un objet [CreateJsonClassifierRequest](#aws-glue-api-crawler-classifiers-CreateJsonClassifierRequest).

  Un `JsonClassifier` objet spécifiant le classifieur à créer.
+ `CsvClassifier` – Un objet [CreateCsvClassifierRequest](#aws-glue-api-crawler-classifiers-CreateCsvClassifierRequest).

  Un `CsvClassifier` objet spécifiant le classifieur à créer.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `OperationTimeoutException`

## DeleteClassifier action (Python : delete\$1classifier)
<a name="aws-glue-api-crawler-classifiers-DeleteClassifier"></a>

Supprime un classifieur du catalogue de données.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du classifieur à supprimer.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `OperationTimeoutException`

## GetClassifier action (Python : get\$1classifier)
<a name="aws-glue-api-crawler-classifiers-GetClassifier"></a>

Récupérer un classifieur par son nom.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du classifieur à récupérer.

**Réponse**
+ `Classifier` – Un objet [Classifieur](#aws-glue-api-crawler-classifiers-Classifier).

  Classifieur demandé.

**Erreurs**
+ `EntityNotFoundException`
+ `OperationTimeoutException`

## GetClassifiers action (Python : get\$1classifiers)
<a name="aws-glue-api-crawler-classifiers-GetClassifiers"></a>

Répertorie toutes les objets Classifieur du catalogue de données.

**Demande**
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Taille de la liste à renvoyer (facultatif).
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation facultatif.

**Réponse**
+ `Classifiers` : un tableau d’objets [Classifieur](#aws-glue-api-crawler-classifiers-Classifier).

  Liste des objets Classifier demandée.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation.

**Erreurs**
+ `OperationTimeoutException`

## UpdateClassifier action (Python : update\$1classifier)
<a name="aws-glue-api-crawler-classifiers-UpdateClassifier"></a>

Modifie un classifieur existant (`GrokClassifier`, `XMLClassifier`, `JsonClassifier` ou `CsvClassifier`, selon le champ qui est présent).

**Demande**
+ `GrokClassifier` – Un objet [UpdateGrokClassifierRequest](#aws-glue-api-crawler-classifiers-UpdateGrokClassifierRequest).

  Un objet `GrokClassifier` avec des champs mis à jour.
+ `XMLClassifier` – Un objet [XMLClassifierDemande de mise à jour](#aws-glue-api-crawler-classifiers-UpdateXMLClassifierRequest).

  Un objet `XMLClassifier` avec des champs mis à jour.
+ `JsonClassifier` – Un objet [UpdateJsonClassifierRequest](#aws-glue-api-crawler-classifiers-UpdateJsonClassifierRequest).

  Un objet `JsonClassifier` avec des champs mis à jour.
+ `CsvClassifier` – Un objet [UpdateCsvClassifierRequest](#aws-glue-api-crawler-classifiers-UpdateCsvClassifierRequest).

  Un objet `CsvClassifier` avec des champs mis à jour.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `InvalidInputException`
+ `VersionMismatchException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`

# API du crawler
<a name="aws-glue-api-crawler-crawling"></a>

L'API Crawler décrit les types de données des AWS Glue robots d'exploration, ainsi que l'API permettant de créer, de supprimer, de mettre à jour et de répertorier les robots d'exploration.

## Types de données
<a name="aws-glue-api-crawler-crawling-objects"></a>
+ [Structure du crawler](#aws-glue-api-crawler-crawling-Crawler)
+ [Structure du planificateur](#aws-glue-api-crawler-crawling-Schedule)
+ [CrawlerTargets structure](#aws-glue-api-crawler-crawling-CrawlerTargets)
+ [Structure de la S3Target](#aws-glue-api-crawler-crawling-S3Target)
+ [DeltaCatalogTarget Structure S3](#aws-glue-api-crawler-crawling-S3DeltaCatalogTarget)
+ [DeltaDirectTarget Structure S3](#aws-glue-api-crawler-crawling-S3DeltaDirectTarget)
+ [JdbcTarget structure](#aws-glue-api-crawler-crawling-JdbcTarget)
+ [Structure Mongo DBTarget](#aws-glue-api-crawler-crawling-MongoDBTarget)
+ [Structure de la dynamo DBTarget](#aws-glue-api-crawler-crawling-DynamoDBTarget)
+ [DeltaTarget structure](#aws-glue-api-crawler-crawling-DeltaTarget)
+ [IcebergTarget structure](#aws-glue-api-crawler-crawling-IcebergTarget)
+ [HudiTarget structure](#aws-glue-api-crawler-crawling-HudiTarget)
+ [CatalogTarget structure](#aws-glue-api-crawler-crawling-CatalogTarget)
+ [CrawlerMetrics structure](#aws-glue-api-crawler-crawling-CrawlerMetrics)
+ [CrawlerHistory structure](#aws-glue-api-crawler-crawling-CrawlerHistory)
+ [CrawlsFilter structure](#aws-glue-api-crawler-crawling-CrawlsFilter)
+ [SchemaChangePolicy structure](#aws-glue-api-crawler-crawling-SchemaChangePolicy)
+ [LastCrawlInfo structure](#aws-glue-api-crawler-crawling-LastCrawlInfo)
+ [RecrawlPolicy structure](#aws-glue-api-crawler-crawling-RecrawlPolicy)
+ [LineageConfiguration structure](#aws-glue-api-crawler-crawling-LineageConfiguration)
+ [LakeFormationConfiguration structure](#aws-glue-api-crawler-crawling-LakeFormationConfiguration)

## Structure du crawler
<a name="aws-glue-api-crawler-crawling-Crawler"></a>

Spécifie un crawler qui examine une source de données et utilise des classifieurs pour tenter de déterminer son schéma. Si l'action aboutit, l'crawler enregistre les métadonnées relatives à la source de données dans le AWS Glue Data Catalog.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'crawler.
+ `Role` – Chaîne UTF-8.

  L'Amazon Resource Name (ARN) d'un rôle IAM utilisé pour accéder aux ressources client, par exemple des données Amazon Simple Storage Service (Amazon S3).
+ `Targets` – Un objet [CrawlerTargets](#aws-glue-api-crawler-crawling-CrawlerTargets).

  Ensemble de cibles à analyser.
+ `DatabaseName` – Chaîne UTF-8.

  Nom de la base de données dans laquelle le résultat de l'crawler est stockée.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description du crawler.
+ `Classifiers` – Tableau de chaînes UTF-8.

  Liste de chaînes UTF-8 qui spécifient les classificateurs personnalisés et associés à l'crawler.
+ `RecrawlPolicy` – Un objet [RecrawlPolicy](#aws-glue-api-crawler-crawling-RecrawlPolicy).

  Stratégie qui spécifie s'il faut analyser à nouveau le jeu de données entier ou analyser uniquement les dossiers ajoutés depuis la dernière exécution du crawler.
+ `SchemaChangePolicy` – Un objet [SchemaChangePolicy](#aws-glue-api-crawler-crawling-SchemaChangePolicy).

  Stratégie qui spécifie la mise à jour et la suppression des comportements pour l'crawler.
+ `LineageConfiguration` – Un objet [LineageConfiguration](#aws-glue-api-crawler-crawling-LineageConfiguration).

  Configuration qui spécifie si la lignée de données est activée pour le crawler.
+ `State` – Chaîne UTF-8 (valeurs valides : `READY` \$1 `RUNNING` \$1 `STOPPING`).

  Indique si le crawler est en cours d'exécution, ou si une exécution est en attente.
+ `TablePrefix` – Chaîne UTF-8, d'une longueur maximale de 128 octets.

  Préfixe ajouté aux noms des tables créées.
+ `Schedule` – Un objet [Planificateur](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-Schedule).

  Pour les crawlers planifiés, planification de l'exécution du crawler.
+ `CrawlElapsedTime` – Nombre (long).

  Si le crawler est en cours d'exécution, contient le temps écoulé total depuis le début de la dernière analyse.
+ `CreationTime` – Horodatage.

  Heure de création du crawler.
+ `LastUpdated` – Horodatage.

  Heure de la dernière mise à jour du crawler.
+ `LastCrawl` – Un objet [LastCrawlInfo](#aws-glue-api-crawler-crawling-LastCrawlInfo).

  État de la dernière analyse, et éventuellement informations d'erreur si une erreur s'est produite.
+ `Version` – Nombre (long).

  Version de l'crawler.
+ `Configuration` – Chaîne UTF-8.

  Informations sur la configuration du crawler. Cette chaîne JSON avec gestion des versions permet aux utilisateurs de spécifier des aspects du comportement d'un crawler. Pour plus d'informations, consultez [Setting Crawler configuration options](https://docs.aws.amazon.com/glue/latest/dg/crawler-configuration.html) (Définition d'options de configuration du crawler).
+ `CrawlerSecurityConfiguration` – Chaîne UTF-8, d'une longueur maximale de 128 octets.

  Nom de la structure `SecurityConfiguration` qui sera utilisée par ce crawler.
+ `LakeFormationConfiguration` – Un objet [LakeFormationConfiguration](#aws-glue-api-crawler-crawling-LakeFormationConfiguration).

  Spécifie si le robot d'exploration doit utiliser les AWS Lake Formation informations d'identification du robot au lieu des informations d'identification du rôle IAM.

## Structure du planificateur
<a name="aws-glue-api-crawler-crawling-Schedule"></a>

Objet de planification utilisant une instruction `cron` pour planifier un événement.

**Champs**
+ `ScheduleExpression` – Chaîne UTF-8.

  Une expression `cron` utilisée pour spécifier la planification (consultez [Time-Based Schedules for Jobs and Crawlers](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) (Planifications temporelles pour les tâches et les crawlers)). Par exemple, pour exécuter un élément tous les jours à 12h15 UTC, vous devez spécifier : `cron(15 12 * * ? *)`.
+ `State` – Chaîne UTF-8 (valeurs valides : `SCHEDULED` \$1 `NOT_SCHEDULED` \$1 `TRANSITIONING`).

  État de la planification.

## CrawlerTargets structure
<a name="aws-glue-api-crawler-crawling-CrawlerTargets"></a>

Indique les magasins de données à analyser.

**Champs**
+ `S3Targets` : un tableau d’objets [S3Target](#aws-glue-api-crawler-crawling-S3Target).

  Spécifie des cibles Amazon Simple Storage Service (Amazon S3).
+ `JdbcTargets` : un tableau d’objets [JdbcTarget](#aws-glue-api-crawler-crawling-JdbcTarget).

  Spécifie les cibles JDBC.
+ `MongoDBTargets` – Un tableau d'objets [Mongo DBTarget](#aws-glue-api-crawler-crawling-MongoDBTarget).

  Spécifie les cibles Amazon DocumentDB ou MongoDB.
+ `DynamoDBTargets` – Un tableau d'objets [Dynamo DBTarget](#aws-glue-api-crawler-crawling-DynamoDBTarget).

  Spécifie des cibles Amazon DynamoDB.
+ `CatalogTargets` – Un tableau d'objets [CatalogTarget](#aws-glue-api-crawler-crawling-CatalogTarget).

  Spécifie AWS Glue Data Catalog les cibles.
+ `DeltaTargets` – Un tableau d'objets [DeltaTarget](#aws-glue-api-crawler-crawling-DeltaTarget).

  Spécifie les cibles du stockage de données Delta.
+ `IcebergTargets` : un tableau d’objets [IcebergTarget](#aws-glue-api-crawler-crawling-IcebergTarget).

  Spécifie les cibles du magasin de données Apache Iceberg.
+ `HudiTargets` : un tableau d’objets [HudiTarget](#aws-glue-api-crawler-crawling-HudiTarget).

  Spécifie les cibles du magasin de données Hudi Iceberg.

## Structure de la S3Target
<a name="aws-glue-api-crawler-crawling-S3Target"></a>

Spécifie un magasin de données dans Amazon Simple Storage Service (Amazon S3).

**Champs**
+ `Path` – Chaîne UTF-8.

  Chemin vers la cible Amazon S3.
+ `Exclusions` – Tableau de chaînes UTF-8.

  Liste de modèles glob utilisés à exclure de l'analyse. Pour en savoir plus, consultez [Catalog Tables with a Crawler](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html) (Tables de catalogues avec un crawler).
+ `ConnectionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Nom d'une connexion qui permet à une tâche ou à un crawler d'accéder aux données dans Amazon S3 au sein d'un environnement Amazon Virtual Private Cloud (Amazon VPC).
+ `SampleSize` : nombre (entier).

  Définit le nombre de fichiers dans chaque dossier feuille à analyser lors de l'analyse d'échantillons de fichiers dans un jeu de données. Si ce paramètre n'est pas défini, tous les fichiers sont analysés. Une valeur valide est un entier compris entre 1 et 249.
+ `EventQueueArn` – Chaîne UTF-8.

  Un ARN Amazon SQS valide. Par exemple, `arn:aws:sqs:region:account:sqs`.
+ `DlqEventQueueArn` – Chaîne UTF-8.

  Un ARN SQS de lettres mortes Amazon valide. Par exemple, `arn:aws:sqs:region:account:deadLetterQueue`.

## DeltaCatalogTarget Structure S3
<a name="aws-glue-api-crawler-crawling-S3DeltaCatalogTarget"></a>

Spécifie une cible qui écrit dans une source de données Delta Lake dans le catalogue de AWS Glue données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `PartitionKeys` – Tableau de chaînes UTF-8.

  Indique le partitionnement natif à l'aide d'une séquence de clés.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table de la base de données dans laquelle écrire les données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données dans laquelle écrire les données.
+ `AdditionalOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique des options de connexion supplémentaires pour le connecteur.
+ `SchemaChangePolicy` – Un objet [CatalogSchemaChangePolicy](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy).

  Une politique qui indique les évolutions de mise à jour pour le crawler.
+ `AutoDataQuality` : un objet [AutoDataQuality](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AutoDataQuality).

  Indique s’il faut activer automatiquement l’évaluation de la qualité des données pour la cible du catalogue S3 Delta. Lorsque ce paramètre est défini sur `true`, les contrôles de qualité des données sont effectués automatiquement pendant l’opération d’écriture.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la cible du catalogue S3 Delta.

## DeltaDirectTarget Structure S3
<a name="aws-glue-api-crawler-crawling-S3DeltaDirectTarget"></a>

Spécifie une cible qui écrit dans une source de données de Delta Lake dans Amazon S3.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `PartitionKeys` – Tableau de chaînes UTF-8.

  Indique le partitionnement natif à l'aide d'une séquence de clés.
+ `Path` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le chemin d'accès Amazon S3 de votre source de données Delta Lake sur laquelle écrire.
+ `Compression` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `uncompressed="UNCOMPRESSED"` \$1 `snappy="SNAPPY"`).

  Indique la manière dont les données sont comprimées. Ce n'est généralement pas nécessaire si le fichier de données a une extension standard. Les valeurs possibles sont `"gzip"` et `"bzip"`).
+ `NumberTargetPartitions` – Chaîne UTF-8.

  Indique le nombre de partitions cible pour distribuer les fichiers de jeux de données Delta Lake sur Amazon S3.
+ `Format` – *Obligatoire :* chaîne UTF-8 (valeurs valides : `json="JSON"` \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` \$1 `iceberg="ICEBERG"` \$1 `hyper="HYPER"` \$1 `xml="XML"`).

  Définit le format de sortie des données pour la cible.
+ `AdditionalOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique des options de connexion supplémentaires pour le connecteur.
+ `SchemaChangePolicy` – Un objet [DirectSchemaChangePolicy](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DirectSchemaChangePolicy).

  Une politique qui indique les évolutions de mise à jour pour le crawler.
+ `AutoDataQuality` : un objet [AutoDataQuality](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AutoDataQuality).

  Indique s’il faut activer automatiquement l’évaluation de la qualité des données pour la cible directe S3 Delta. Lorsque ce paramètre est défini sur `true`, les contrôles de qualité des données sont effectués automatiquement pendant l’opération d’écriture.

## JdbcTarget structure
<a name="aws-glue-api-crawler-crawling-JdbcTarget"></a>

Indique les magasins de données JDBC à analyser.

**Champs**
+ `ConnectionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Nom de la connexion à utiliser pour se connecter à la cible JDBC.
+ `Path` – Chaîne UTF-8.

  Le chemin de la cible JDBC.
+ `Exclusions` – Tableau de chaînes UTF-8.

  Liste de modèles glob utilisés à exclure de l'analyse. Pour en savoir plus, consultez [Catalog Tables with a Crawler](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html) (Tables de catalogues avec un crawler).
+ `EnableAdditionalMetadata` – Tableau de chaînes UTF-8.

  Spécifiez une valeur de `RAWTYPES` ou `COMMENTS` pour activer des métadonnées supplémentaires dans les réponses des tables. `RAWTYPES` fournit le type de données de niveau natif. `COMMENTS` fournit des commentaires associés à une colonne ou à une table de la base de données.

  Si vous n'avez pas besoin d'autres métadonnées, laissez le champ vide.

## Structure Mongo DBTarget
<a name="aws-glue-api-crawler-crawling-MongoDBTarget"></a>

Indique les magasins de données Amazon DocumentDB ou MongoDB à analyser.

**Champs**
+ `ConnectionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Nom de la connexion à utiliser pour se connecter à la cible Amazon DocumentDB ou MongoDB.
+ `Path` – Chaîne UTF-8.

  Chemin d'accès de la cible Amazon DocumentDB ou MongoDB (base de données/collection).
+ `ScanAll` : booléen.

  Indique s'il faut analyser tous les enregistrements ou échantillonner les lignes de la table. L'analyse de tous les enregistrements peut prendre beaucoup de temps lorsque la table n'est pas à haut débit.

  La valeur `true` implique l'analyse de tous les enregistrements, tandis que la valeur `false` implique l'échantillonnage des enregistrements. Si aucune valeur n'est spécifiée, la valeur par défaut est `true`.

## Structure de la dynamo DBTarget
<a name="aws-glue-api-crawler-crawling-DynamoDBTarget"></a>

Spécifie une table Amazon DynamoDB à analyser.

**Champs**
+ `Path` – Chaîne UTF-8.

  Nom de la table DynamoDB à analyser.
+ `scanAll` : booléen.

  Indique s'il faut analyser tous les enregistrements ou échantillonner les lignes de la table. L'analyse de tous les enregistrements peut prendre beaucoup de temps lorsque la table n'est pas à haut débit.

  La valeur `true` implique l'analyse de tous les enregistrements, tandis que la valeur `false` implique l'échantillonnage des enregistrements. Si aucune valeur n'est spécifiée, la valeur par défaut est `true`.
+ `scanRate` – Nombre (double).

  Pourcentage d'unités de capacité de lecture configurées à utiliser par le AWS Glue robot d'exploration. Unités de capacité de lecture est un terme défini par DynamoDB et est une valeur numérique qui sert de limiteur de vitesse pour le nombre de lectures pouvant être effectuées sur cette table par seconde.

  Les valeurs valides sont nulles ou une valeur comprise entre 0,1 et 1,5. Une valeur NULL est utilisée lorsque l'utilisateur ne fournit pas de valeur et que la valeur par défaut est 0,5 de l'unité de capacité de lecture configurée (pour les tables provisionnées) ou 0,25 de l'unité de capacité de lecture maximale configurée (pour les tables utilisant le mode à la demande).

## DeltaTarget structure
<a name="aws-glue-api-crawler-crawling-DeltaTarget"></a>

Spécifie un stockage de données Delta pour analyser un ou plusieurs tableaux Delta.

**Champs**
+ `DeltaTables` – Tableau de chaînes UTF-8.

  Une liste de chemins Amazon S3 vers les tableaux Delta.
+ `ConnectionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Nom de la connexion à utiliser pour se connecter à la cible Delta.
+ `WriteManifest` : booléen.

  Spécifie s'il faut écrire les fichiers manifestes dans le chemin d'accès au tableau Delta.
+ `CreateNativeDeltaTable` : booléen.

  Spécifie si le crawler va créer des tables natives pour permettre l'intégration avec les moteurs de requêtes qui prennent directement en charge l'interrogation du journal de transactions Delta.

## IcebergTarget structure
<a name="aws-glue-api-crawler-crawling-IcebergTarget"></a>

Spécifie une source de données Apache Iceberg où les tables Iceberg sont stockées dans Amazon S3.

**Champs**
+ `Paths` – Tableau de chaînes UTF-8.

  Un ou plusieurs Amazon S3 chemins contenant les dossiers de métadonnées Iceberg en tant que`s3://bucket/prefix`.
+ `ConnectionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Nom de la connexion à utiliser pour se connecter à la cible Iceberg.
+ `Exclusions` – Tableau de chaînes UTF-8.

  Liste de modèles glob utilisés à exclure de l'analyse. Pour en savoir plus, consultez [Catalog Tables with a Crawler](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html) (Tables de catalogues avec un crawler).
+ `MaximumTraversalDepth` : nombre (entier).

  Profondeur maximale des Amazon S3 chemins que le robot d'exploration peut parcourir pour découvrir le dossier de métadonnées Iceberg dans votre Amazon S3 chemin. Utilisé pour limiter le temps d'exécution du Crawler.

## HudiTarget structure
<a name="aws-glue-api-crawler-crawling-HudiTarget"></a>

Spécifie une source de données Apache Hudi.

**Champs**
+ `Paths` – Tableau de chaînes UTF-8.

  Tableau de chaînes de Amazon S3 localisation pour Hudi, chacune indiquant le dossier racine dans lequel se trouvent les fichiers de métadonnées d'une table Hudi. Le dossier Hudi peut se trouver dans un dossier enfant du dossier racine.

  Le Crawler examine tous les dossiers situés sous un chemin à la recherche d'un dossier Hudi.
+ `ConnectionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Nom de la connexion à utiliser pour se connecter à la cible Hudi. Si vos fichiers Hudi sont stockés dans des compartiments nécessitant une autorisation VPC, vous pouvez définir leurs propriétés de connexion ici.
+ `Exclusions` – Tableau de chaînes UTF-8.

  Liste de modèles glob utilisés à exclure de l'analyse. Pour en savoir plus, consultez [Catalog Tables with a Crawler](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html) (Tables de catalogues avec un crawler).
+ `MaximumTraversalDepth` : nombre (entier).

  Profondeur maximale des Amazon S3 chemins que le robot d'exploration peut parcourir pour découvrir le dossier de métadonnées Hudi dans votre Amazon S3 chemin. Utilisé pour limiter le temps d'exécution du Crawler.

## CatalogTarget structure
<a name="aws-glue-api-crawler-crawling-CatalogTarget"></a>

Spécifie une AWS Glue Data Catalog cible.

**Champs**
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de la base de données à synchroniser.
+ `Tables` – *Obligatoire :* Tableau de chaînes UTF-8, au moins 1 chaîne.

  Une liste des tables à synchroniser.
+ `ConnectionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Le nom de la connexion d'une table de catalogue de données basées sur Amazon S3 qui doit être la cible de l'analyse lors de l'utilisation d'un type de connexion `Catalog` associé à un type de connexion `NETWORK`.
+ `EventQueueArn` – Chaîne UTF-8.

  Un ARN Amazon SQS valide. Par exemple, `arn:aws:sqs:region:account:sqs`.
+ `DlqEventQueueArn` – Chaîne UTF-8.

  Un ARN SQS de lettres mortes Amazon valide. Par exemple, `arn:aws:sqs:region:account:deadLetterQueue`.

## CrawlerMetrics structure
<a name="aws-glue-api-crawler-crawling-CrawlerMetrics"></a>

Métriques d'un crawler spécifié.

**Champs**
+ `CrawlerName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'crawler.
+ `TimeLeftSeconds` – Nombre (double), pas plus qu'Aucun.

  Estimation du temps restant pour terminer une analyse en cours d'exécution.
+ `StillEstimating` : booléen.

  True si le crawler est toujours en cours d'estimation du temps nécessaire pour terminer cette exécution.
+ `LastRuntimeSeconds` – Nombre (double), pas plus qu'Aucun.

  Durée de l'exécution la plus récente de l'crawler, en secondes.
+ `MedianRuntimeSeconds` – Nombre (double), pas plus qu'Aucun.

  Durée médiane des exécutions de cet crawler, en secondes.
+ `TablesCreated` – Nombre (entier), pas plus qu'Aucun.

  Nombre de tables créées par cet crawler.
+ `TablesUpdated` – Nombre (entier), pas plus qu'Aucun.

  Nombre de tables mises à jour par cet crawler.
+ `TablesDeleted` – Nombre (entier), pas plus qu'Aucun.

  Nombre de tables supprimées par cet crawler.

## CrawlerHistory structure
<a name="aws-glue-api-crawler-crawling-CrawlerHistory"></a>

Contient les informations pour une exécution d'un crawler.

**Champs**
+ `CrawlId` – Chaîne UTF-8.

  Un identifiant UUID pour chaque analyse.
+ `State` – Chaîne UTF-8 (valeurs valides : `RUNNING` \$1 `COMPLETED` \$1 `FAILED` \$1 `STOPPED`).

  État de l'analyse.
+ `StartTime` – Horodatage.

  Date et heure auxquelles le crawler a démarré.
+ `EndTime` – Horodatage.

  Date et heure auxquelles l'analyse s'est achevée.
+ `Summary` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Un résumé d'exécution pour l'analyse spécifique dans JSON. Contient les tables de catalogue et les partitions qui ont été ajoutées, mises à jour ou supprimées.
+ `ErrorMessage` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Si une erreur s'est produite, le message d'erreur associé à l'analyse.
+ `LogGroup` – Chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets, correspondant au [Log group string pattern](aws-glue-api-common.md#aws-glue-api-regex-logGroup-id).

  Groupe de journaux associés au crawler.
+ `LogStream` – Chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets, correspondant au [Log-stream string pattern](aws-glue-api-common.md#aws-glue-api-regex-logStream-id).

  Flux de journaux associé au crawler.
+ `MessagePrefix` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le préfixe d'un CloudWatch message concernant ce crawl.
+ `DPUHour` – Nombre (double), pas plus qu'Aucun.

  Nombre d'unités de traitement de données (DPU) utilisées en heures pour l'analyse.

## CrawlsFilter structure
<a name="aws-glue-api-crawler-crawling-CrawlsFilter"></a>

Une liste de champs, de comparateurs et de valeurs que vous pouvez utiliser pour filtrer les exécutions de crawler pour un crawler spécifié.

**Champs**
+ `FieldName` – Chaîne UTF-8 (valeurs valides : `CRAWL_ID` \$1 `STATE` \$1 `START_TIME` \$1 `END_TIME` \$1 `DPU_HOUR`).

  Une clé utilisée pour filtrer les exécutions de Crawler pour un Crawler spécifié. Les valeurs valides pour chacun des noms de champs sont les suivantes :
  + `CRAWL_ID` : une chaîne représentant l'identifiant UUID d'une analyse.
  + `STATE` : une chaîne représentant l'état de l'analyse.
  + `START_TIME` et `END_TIME` : l'horodatage de l'époque en millisecondes.
  + `DPU_HOUR` : le nombre d'heures d'unité de traitement de données (DPU) utilisées pour l'analyse.
+ `FilterOperator` – Chaîne UTF-8 (valeurs valides : `GT` \$1 `GE` \$1 `LT` \$1 `LE` \$1 `EQ` \$1 `NE`).

  Un comparateur défini qui agit sur la valeur. Les opérateurs disponibles sont les suivants :
  + `GT` : Supérieur à.
  + `GE` : Supérieur ou égal à.
  + `LT` : Inférieur à.
  + `LE` : Inférieur ou égal à.
  + `EQ` : Égal à.
  + `NE` : Pas égal à.
+ `FieldValue` – Chaîne UTF-8.

  La valeur fournie pour la comparaison dans le champ d'analyse. 

## SchemaChangePolicy structure
<a name="aws-glue-api-crawler-crawling-SchemaChangePolicy"></a>

Stratégie qui spécifie des comportements de mise à jour et de suppression pour l'crawler.

**Champs**
+ `UpdateBehavior` – Chaîne UTF-8 (valeurs valides : `LOG` \$1 `UPDATE_IN_DATABASE`).

  Comportement de mise à jour lorsque le crawler détecte un schéma modifié.
+ `DeleteBehavior` – Chaîne UTF-8 (valeurs valides : `LOG` \$1 `DELETE_FROM_DATABASE` \$1 `DEPRECATE_IN_DATABASE`).

  Comportement de suppression lorsque le crawler détecte un objet supprimé.

## LastCrawlInfo structure
<a name="aws-glue-api-crawler-crawling-LastCrawlInfo"></a>

Informations d'état et d'erreur sur l'analyse la plus récente.

**Champs**
+ `Status` – Chaîne UTF-8 (valeurs valides : `SUCCEEDED` \$1 `CANCELLED` \$1 `FAILED`).

  État de la dernière analyse.
+ `ErrorMessage` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Si une erreur s'est produite, informations d'erreur sur la dernière analyse.
+ `LogGroup` – Chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets, correspondant au [Log group string pattern](aws-glue-api-common.md#aws-glue-api-regex-logGroup-id).

  Groupe de journaux de la dernière analyse.
+ `LogStream` – Chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets, correspondant au [Log-stream string pattern](aws-glue-api-common.md#aws-glue-api-regex-logStream-id).

  Flux de journal de la dernière analyse.
+ `MessagePrefix` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Préfixe d'un message sur cette analyse.
+ `StartTime` – Horodatage.

  Heure à laquelle l'analyse a commencé.

## RecrawlPolicy structure
<a name="aws-glue-api-crawler-crawling-RecrawlPolicy"></a>

Lorsque vous indexez une source de données Amazon S3 après la première indexation, spécifie s'il faut indexer à nouveau l'ensemble du jeu de données ou uniquement les dossiers ajoutés depuis la dernière exécution du crawler. Pour de plus amples informations, veuillez consulter la rubrique [Analyses incrémentielles dans AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/incremental-crawls.html) dans le guide du développeur.

**Champs**
+ `RecrawlBehavior` – Chaîne UTF-8 (valeurs valides : `CRAWL_EVERYTHING` \$1 `CRAWL_NEW_FOLDERS_ONLY` \$1 `CRAWL_EVENT_MODE`).

  Spécifie s'il faut analyser à nouveau le jeu de données ou uniquement les dossiers ajoutés depuis la dernière exécution de l'crawler.

  Une valeur de `CRAWL_EVERYTHING` indique que l'ensemble du jeu de données doit être analysé à nouveau.

  Une valeur de `CRAWL_NEW_FOLDERS_ONLY` indique que seuls les dossiers ajoutés depuis la dernière exécution du crawler doivent être indexés.

  Une valeur de `CRAWL_EVENT_MODE` spécifie uniquement l'analyse des modifications identifiées par les événements Amazon S3.

## LineageConfiguration structure
<a name="aws-glue-api-crawler-crawling-LineageConfiguration"></a>

Spécifie les paramètres de configuration de la lignée de données pour l'crawler.

**Champs**
+ `CrawlerLineageSettings` – Chaîne UTF-8 (valeurs valides : `ENABLE` \$1 `DISABLE`).

  Indique si la lignée de données est activée pour le crawler. Les valeurs valides sont :
  + ENABLE : active la lignée des données pour le crawler
  + DISABLE : désactive la lignée de données pour le crawler

## LakeFormationConfiguration structure
<a name="aws-glue-api-crawler-crawling-LakeFormationConfiguration"></a>

Spécifie les paramètres de AWS Lake Formation configuration du robot d'exploration.

**Champs**
+ `UseLakeFormationCredentials` : booléen.

  Spécifie s'il faut utiliser les AWS Lake Formation informations d'identification du robot d'exploration au lieu des informations d'identification du rôle IAM.
+ `AccountId` – Chaîne UTF-8, d'une longueur maximale de 12 octets.

  Obligatoire pour les analyses de compte croisées. Pour les mêmes analyses de compte que les données cibles, cela peut être laissé nul.

## Opérations
<a name="aws-glue-api-crawler-crawling-actions"></a>
+ [CreateCrawler action (Python : create\$1crawler)](#aws-glue-api-crawler-crawling-CreateCrawler)
+ [DeleteCrawler action (Python : delete\$1crawler)](#aws-glue-api-crawler-crawling-DeleteCrawler)
+ [GetCrawler action (Python : get\$1crawler)](#aws-glue-api-crawler-crawling-GetCrawler)
+ [GetCrawlers action (Python : get\$1crawlers)](#aws-glue-api-crawler-crawling-GetCrawlers)
+ [GetCrawlerMetrics action (Python : get\$1crawler\$1metrics)](#aws-glue-api-crawler-crawling-GetCrawlerMetrics)
+ [UpdateCrawler action (Python : update\$1crawler)](#aws-glue-api-crawler-crawling-UpdateCrawler)
+ [StartCrawler action (Python : start\$1crawler)](#aws-glue-api-crawler-crawling-StartCrawler)
+ [StopCrawler action (Python : stop\$1crawler)](#aws-glue-api-crawler-crawling-StopCrawler)
+ [BatchGetCrawlers action (Python : batch\$1get\$1crawlers)](#aws-glue-api-crawler-crawling-BatchGetCrawlers)
+ [ListCrawlers action (Python : list\$1crawlers)](#aws-glue-api-crawler-crawling-ListCrawlers)
+ [ListCrawls action (Python : list\$1crawls)](#aws-glue-api-crawler-crawling-ListCrawls)

## CreateCrawler action (Python : create\$1crawler)
<a name="aws-glue-api-crawler-crawling-CreateCrawler"></a>

Crée un crawler avec des cibles, un rôle, une configuration, et une éventuelle planification spécifiés. Au moins une cible d'analyse doit être spécifiée dans le champ `s3Targets`, le champ `jdbcTargets` ou le champ `DynamoDBTargets`.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du nouveau crawler.
+ `Role` – *Obligatoire :* chaîne UTF-8.

  Rôle IAM ou Amazon Resource Name (ARN) d'un rôle IAM utilisé par le nouveau crawler pour accéder aux ressources client.
+ `DatabaseName` – Chaîne UTF-8.

  La AWS Glue base de données dans laquelle les résultats sont écrits, par exemple :`arn:aws:daylight:us-east-1::database/sometable/*`.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description du nouvel crawler.
+ `Targets` – *Obligatoire :* un objet [CrawlerTargets](#aws-glue-api-crawler-crawling-CrawlerTargets).

  Liste de l'ensemble de cibles à analyser.
+ `Schedule` – Chaîne UTF-8.

  Une expression `cron` utilisée pour spécifier la planification (consultez [Time-Based Schedules for Jobs and Crawlers](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) (Planifications temporelles pour les tâches et les crawlers)). Par exemple, pour exécuter un élément tous les jours à 12h15 UTC, vous devez spécifier : `cron(15 12 * * ? *)`.
+ `Classifiers` – Tableau de chaînes UTF-8.

  Liste des classifieurs personnalisés que l'utilisateur a enregistrés. Par défaut, tous les classificateurs intégrés sont inclus dans une analyse, mais ces classificateurs personnalisés se substituent toujours aux classificateurs par défaut pour une classification donnée.
+ `TablePrefix` – Chaîne UTF-8, d'une longueur maximale de 128 octets.

  Préfixe de table utilisé pour les tables catalogue créées.
+ `SchemaChangePolicy` – Un objet [SchemaChangePolicy](#aws-glue-api-crawler-crawling-SchemaChangePolicy).

  Stratégie du comportement de mise à jour et de suppression de l'crawler.
+ `RecrawlPolicy` – Un objet [RecrawlPolicy](#aws-glue-api-crawler-crawling-RecrawlPolicy).

  Stratégie qui spécifie s'il faut analyser à nouveau le jeu de données entier ou analyser uniquement les dossiers ajoutés depuis la dernière exécution du crawler.
+ `LineageConfiguration` – Un objet [LineageConfiguration](#aws-glue-api-crawler-crawling-LineageConfiguration).

  Spécifie les paramètres de configuration de la lignée de données pour le crawler.
+ `LakeFormationConfiguration` – Un objet [LakeFormationConfiguration](#aws-glue-api-crawler-crawling-LakeFormationConfiguration).

  Spécifie les paramètres de AWS Lake Formation configuration du robot d'exploration.
+ `Configuration` – Chaîne UTF-8.

  Informations sur la configuration du crawler. Cette chaîne JSON avec gestion des versions permet aux utilisateurs de spécifier des aspects du comportement d'un crawler. Pour plus d'informations, consultez [Setting Crawler configuration options](https://docs.aws.amazon.com/glue/latest/dg/crawler-configuration.html) (Définition d'options de configuration du crawler).
+ `CrawlerSecurityConfiguration` – Chaîne UTF-8, d'une longueur maximale de 128 octets.

  Nom de la structure `SecurityConfiguration` qui sera utilisée par ce crawler.
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Balises à utiliser avec cette demande d'crawler. Vous pouvez utiliser des balises pour limiter l'accès à l'crawler. Pour plus d'informations sur les tags in AWS Glue, voir [AWS Tags in AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html) dans le guide du développeur.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`

## DeleteCrawler action (Python : delete\$1crawler)
<a name="aws-glue-api-crawler-crawling-DeleteCrawler"></a>

Supprime un robot d'exploration spécifié du AWS Glue Data Catalog, sauf si l'état du robot est. `RUNNING`

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'crawler à supprimer.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `CrawlerRunningException`
+ `SchedulerTransitioningException`
+ `OperationTimeoutException`

## GetCrawler action (Python : get\$1crawler)
<a name="aws-glue-api-crawler-crawling-GetCrawler"></a>

Récupère des métadonnées pour un crawler spécifié.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'crawler pour lequel récupérer les métadonnées.

**Réponse**
+ `Crawler` – Un objet [crawler](#aws-glue-api-crawler-crawling-Crawler).

  Métadonnées pour l'crawler spécifié.

**Erreurs**
+ `EntityNotFoundException`
+ `OperationTimeoutException`

## GetCrawlers action (Python : get\$1crawlers)
<a name="aws-glue-api-crawler-crawling-GetCrawlers"></a>

Récupère les métadonnées pour tous les crawlers définis dans le compte client.

**Demande**
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre d'crawlers à renvoyer à chaque appel.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’une requête de continuation.

**Réponse**
+ `Crawlers` : un tableau d’objets [crawler](#aws-glue-api-crawler-crawling-Crawler).

  Liste des métadonnées de l'crawler.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, si la liste renvoyée n'a pas atteint la fin de ceux définis dans ce compte client.

**Erreurs**
+ `OperationTimeoutException`

## GetCrawlerMetrics action (Python : get\$1crawler\$1metrics)
<a name="aws-glue-api-crawler-crawling-GetCrawlerMetrics"></a>

Récupère les métriques sur les crawlers spécifiés.

**Demande**
+ `CrawlerNameList` – Tableau de chaînes UTF-8, avec 100 chaînes maximum.

  Liste des noms des crawlers sur lesquels récupérer les métriques.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  La taille maximale d’une liste à renvoyer.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.

**Réponse**
+ `CrawlerMetricsList` : un tableau d’objets [CrawlerMetrics](#aws-glue-api-crawler-crawling-CrawlerMetrics).

  Liste des métriques pour l'crawler spécifié.
+ `NextToken` – Chaîne UTF-8.

  Jeton continuation, si la liste renvoyée ne contient pas la dernière métrique disponible.

**Erreurs**
+ `OperationTimeoutException`

## UpdateCrawler action (Python : update\$1crawler)
<a name="aws-glue-api-crawler-crawling-UpdateCrawler"></a>

Met à jour un crawler. Si un crawler est en cours d'exécution, vous devez l'arrêter à l'aide de `StopCrawler` avant de le mettre à jour.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du nouvel crawler.
+ `Role` – Chaîne UTF-8.

  Rôle IAM ou Amazon Resource Name (ARN) d'un rôle IAM qui est utilisé par le nouvel crawler pour accéder aux ressources client.
+ `DatabaseName` – Chaîne UTF-8.

  La AWS Glue base de données dans laquelle les résultats sont stockés, par exemple :`arn:aws:daylight:us-east-1::database/sometable/*`.
+ `Description` – Chaîne UTF-8, d'une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description du nouvel crawler.
+ `Targets` – Un objet [CrawlerTargets](#aws-glue-api-crawler-crawling-CrawlerTargets).

  Liste des cibles à analyser.
+ `Schedule` – Chaîne UTF-8.

  Une expression `cron` utilisée pour spécifier la planification (consultez [Time-Based Schedules for Jobs and Crawlers](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) (Planifications temporelles pour les tâches et les crawlers)). Par exemple, pour exécuter un élément tous les jours à 12h15 UTC, vous devez spécifier : `cron(15 12 * * ? *)`.
+ `Classifiers` – Tableau de chaînes UTF-8.

  Liste des classifieurs personnalisés que l'utilisateur a enregistrés. Par défaut, tous les classificateurs intégrés sont inclus dans une analyse, mais ces classificateurs personnalisés se substituent toujours aux classificateurs par défaut pour une classification donnée.
+ `TablePrefix` – Chaîne UTF-8, d'une longueur maximale de 128 octets.

  Préfixe de table utilisé pour les tables catalogue créées.
+ `SchemaChangePolicy` – Un objet [SchemaChangePolicy](#aws-glue-api-crawler-crawling-SchemaChangePolicy).

  Stratégie du comportement de mise à jour et de suppression de l'crawler.
+ `RecrawlPolicy` – Un objet [RecrawlPolicy](#aws-glue-api-crawler-crawling-RecrawlPolicy).

  Stratégie qui spécifie s'il faut analyser à nouveau le jeu de données entier ou analyser uniquement les dossiers ajoutés depuis la dernière exécution du crawler.
+ `LineageConfiguration` – Un objet [LineageConfiguration](#aws-glue-api-crawler-crawling-LineageConfiguration).

  Spécifie les paramètres de configuration de la lignée de données pour le crawler.
+ `LakeFormationConfiguration` – Un objet [LakeFormationConfiguration](#aws-glue-api-crawler-crawling-LakeFormationConfiguration).

  Spécifie les paramètres de AWS Lake Formation configuration du robot d'exploration.
+ `Configuration` – Chaîne UTF-8.

  Informations sur la configuration du crawler. Cette chaîne JSON avec gestion des versions permet aux utilisateurs de spécifier des aspects du comportement d'un crawler. Pour plus d'informations, consultez [Setting Crawler configuration options](https://docs.aws.amazon.com/glue/latest/dg/crawler-configuration.html) (Définition d'options de configuration du crawler).
+ `CrawlerSecurityConfiguration` – Chaîne UTF-8, d'une longueur maximale de 128 octets.

  Nom de la structure `SecurityConfiguration` qui sera utilisée par cet crawler.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `InvalidInputException`
+ `VersionMismatchException`
+ `EntityNotFoundException`
+ `CrawlerRunningException`
+ `OperationTimeoutException`

## StartCrawler action (Python : start\$1crawler)
<a name="aws-glue-api-crawler-crawling-StartCrawler"></a>

Démarre une analyse à l'aide de l'crawler, indépendamment de ce qui est prévu. Si le robot d'exploration est déjà en cours d'exécution, renvoie un [CrawlerRunningException](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-exceptions.html#aws-glue-api-exceptions-CrawlerRunningException).

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'crawler à démarrer.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `CrawlerRunningException`
+ `OperationTimeoutException`

## StopCrawler action (Python : stop\$1crawler)
<a name="aws-glue-api-crawler-crawling-StopCrawler"></a>

Si l'crawler spécifié est en cours d'exécution, arrête l'analyse.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'crawler à arrêter.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `CrawlerNotRunningException`
+ `CrawlerStoppingException`
+ `OperationTimeoutException`

## BatchGetCrawlers action (Python : batch\$1get\$1crawlers)
<a name="aws-glue-api-crawler-crawling-BatchGetCrawlers"></a>

Renvoie la liste des métadonnées de ressource pour une liste donnée de noms d'crawler. Après avoir appelé l’opération `ListCrawlers`, vous pouvez appeler cette opération pour accéder aux données sur lesquelles des autorisations vous ont été octroyées. Cette opération prend en charge toutes les autorisations IAM, y compris les conditions d’autorisation qui utilisent des balises.

**Demande**
+ `CrawlerNames` – *Obligatoire :* Tableau de chaînes UTF-8, avec 100 chaînes maximum.

  Liste des noms d'crawler, qui peuvent être les noms renvoyés à partir de l'opération `ListCrawlers`.

**Réponse**
+ `Crawlers` : un tableau d’objets [crawler](#aws-glue-api-crawler-crawling-Crawler).

  Liste des définitions d'crawler.
+ `CrawlersNotFound` – Tableau de chaînes UTF-8, avec 100 chaînes maximum.

  Liste de noms d'crawler qui n'ont pas été trouvés.

**Erreurs**
+ `InvalidInputException`
+ `OperationTimeoutException`

## ListCrawlers action (Python : list\$1crawlers)
<a name="aws-glue-api-crawler-crawling-ListCrawlers"></a>

Récupère les noms de toutes les ressources du robot d'exploration de ce AWS compte, ou des ressources portant le tag spécifié. Cette opération vous permet de voir quelles ressources sont disponibles dans votre compte, et leurs noms.

Cette opération accepte le champ `Tags` facultatif que vous pouvez utiliser comme filtre sur la réponse, afin que les ressources balisées puissent être récupérées en tant que groupe. Si vous choisissez d'utiliser le filtrage des balises, seules les ressources avec la balise sont récupérées.

**Demande**
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  La taille maximale d’une liste à renvoyer.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’une requête de continuation.
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Spécifie de renvoyer uniquement les ressources balisées.

**Réponse**
+ `CrawlerNames` – Tableau de chaînes UTF-8, avec 100 chaînes maximum.

  Noms de tous les crawlers dans le compte ou des crawlers avec les balises spécifiées.
+ `NextToken` – Chaîne UTF-8.

  Jeton continuation, si la liste renvoyée ne contient pas la dernière métrique disponible.

**Erreurs**
+ `OperationTimeoutException`

## ListCrawls action (Python : list\$1crawls)
<a name="aws-glue-api-crawler-crawling-ListCrawls"></a>

Renvoie toutes les analyse d'un Crawler spécifié. Renvoie uniquement les analyses qui ont eu lieu depuis la date de lancement de la fonction d'historique du Crawler, et ne retient que jusqu'à 12 mois d'analyse. Les anciennes analyses ne seront pas renvoyées.

Vous pouvez utiliser cette API pour :
+ Récupère toutes les analyse d'un Crawler spécifié.
+ Récupère toutes les analyse d'un Crawler spécifié dans un nombre limité.
+ Récupère toutes les analyse d'un Crawler spécifié dans une plage de temps spécifique.
+ Récupère toutes les analyse d'un Crawler spécifié avec un état, un ID d'analyse ou une valeur d'heure DPU particuliers.

**Demande**
+ `CrawlerName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du Crawler dont vous voulez récupérer les exécutions.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximal de résultats à renvoyer. La valeur par défaut est 20 et la valeur maximale est 100.
+ `Filters` : un tableau d’objets [CrawlsFilter](#aws-glue-api-crawler-crawling-CrawlsFilter).

  Filtre les analyse en fonction de critères que vous spécifiez dans une liste objets `CrawlsFilter`.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.

**Réponse**
+ `Crawls` : un tableau d’objets [CrawlerHistory](#aws-glue-api-crawler-crawling-CrawlerHistory).

  Une liste d'objets `CrawlerHistory` représentant les cycles d'analyse qui répondent à vos critères.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation pour la pagination de la liste des jetons renvoyés, renvoyé si le segment actuel de la liste n’est pas le dernier.

**Erreurs**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`

# API de statistiques de colonne
<a name="aws-glue-api-crawler-column-statistics"></a>

L'API de statistiques de colonnes décrit comment renvoyer AWS Glue APIs des statistiques sur les colonnes d'une table.

## Types de données
<a name="aws-glue-api-crawler-column-statistics-objects"></a>
+ [ColumnStatisticsTaskRun structure](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRun)
+ [ColumnStatisticsTaskSettings structure](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskSettings)
+ [ExecutionAttempt structure](#aws-glue-api-crawler-column-statistics-ExecutionAttempt)

## ColumnStatisticsTaskRun structure
<a name="aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRun"></a>

L'objet qui affiche les détails de l'exécution des statistiques de colonne.

**Champs**
+ `CustomerId` – Chaîne UTF-8, d'une longueur maximale de 12 octets.

  L'identifiant AWS du compte.
+ `ColumnStatisticsTaskRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'identifiant d'exécution de la tâche de statistiques de colonne particulière.
+ `DatabaseName` – Chaîne UTF-8.

  La base de données où réside la table.
+ `TableName` – Chaîne UTF-8.

  Le nom de la table pour laquelle les statistiques de colonne sont générées.
+ `ColumnNameList` – Tableau de chaînes UTF-8.

  Une liste des noms de colonnes. Si aucun nom n'est fourni, tous les noms de colonnes de la table seront utilisés par défaut.
+ `CatalogID` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données où réside la table. Si aucun identifiant n'est fourni, l'identifiant du AWS compte est utilisé par défaut.
+ `Role` – Chaîne UTF-8.

  Le rôle IAM que le service assume pour générer des statistiques.
+ `SampleSize` – Nombre (double), 100 au maximum.

  Pourcentage de lignes utilisées pour générer des statistiques. Si aucun nom n'est fourni, la table entière sera utilisée pour générer des statistiques.
+ `SecurityConfiguration` – Chaîne UTF-8, d'une longueur maximale de 128 octets.

  Nom de la configuration de sécurité utilisée pour chiffrer les CloudWatch journaux pour la tâche de statistiques de colonne exécutée.
+ `NumberOfWorkers` – Nombre (entier), au moins égal à 1.

  Le nombre d'employés utilisés pour générer les statistiques de colonne. La tâche est préconfigurée pour effectuer une mise à l'échelle automatique jusqu'à 25 instances.
+ `WorkerType` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Type de travailleurs utilisés pour générer des statistiques. La valeur par défaut est `g.1x`.
+ `ComputationType` – Chaîne UTF-8 (valeurs valides : `FULL` \$1 `INCREMENTAL`).

  Type de calcul de statistiques de colonne.
+ `Status` – Chaîne UTF-8 (valeurs valides : `STARTING` \$1 `RUNNING` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `STOPPED`).

  L'état d'exécution de la tâche.
+ `CreationTime` – Horodatage.

  Heure à laquelle cette tâche a été créée.
+ `LastUpdated` – Horodatage.

  Dernier moment où cette tâche a été modifiée.
+ `StartTime` – Horodatage.

  L'heure de début de la tâche.
+ `EndTime` – Horodatage.

  L'heure de fin de la tâche.
+ `ErrorMessage` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Le message d'erreur pour la tâche.
+ `DPUSeconds` – Nombre (double), pas plus qu'Aucun.

  L'utilisation de la DPU calculée en secondes pour tous les travailleurs mis à l'échelle automatique.

## ColumnStatisticsTaskSettings structure
<a name="aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskSettings"></a>

Paramètres d’une tâche de statistiques de colonne.

**Champs**
+ `DatabaseName` – Chaîne UTF-8.

  Le nom de la base de données où réside la table.
+ `TableName` – Chaîne UTF-8.

  Nom de la table pour laquelle les statistiques de colonne sont générées.
+ `Schedule` – Un objet [Planificateur](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-Schedule).

  Calendrier d’exécution des statistiques de colonne, spécifié dans la syntaxe CRON.
+ `ColumnNameList` – Tableau de chaînes UTF-8.

  Liste des noms de colonnes pour lesquelles les statistiques doivent être exécutées.
+ `CatalogID` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel réside la base de données.
+ `Role` – Chaîne UTF-8.

  Rôle utilisé pour l’exécution des statistiques de colonne.
+ `SampleSize` – Nombre (double), 100 au maximum.

  Pourcentage de données à échantillonner.
+ `SecurityConfiguration` – Chaîne UTF-8, d'une longueur maximale de 128 octets.

  Nom de la configuration de sécurité utilisée pour chiffrer les CloudWatch journaux.
+ `ScheduleType` – Chaîne UTF-8 (valeurs valides : `CRON` \$1 `AUTO`).

  Type de planification pour une tâche de statistiques de colonne. Les valeurs possibles peuvent être `CRON` ou `AUTO`.
+ `SettingSource` – Chaîne UTF-8 (valeurs valides : `CATALOG` \$1 `TABLE`).

  Source de définition de la tâche de statistiques de colonne. Les valeurs possibles peuvent être `CATALOG` ou `TABLE`.
+ `LastExecutionAttempt` : un objet [ExecutionAttempt](#aws-glue-api-crawler-column-statistics-ExecutionAttempt).

  Dernière `ExecutionAttempt` pour l’exécution de la tâche de statistiques de colonne.

## ExecutionAttempt structure
<a name="aws-glue-api-crawler-column-statistics-ExecutionAttempt"></a>

Tentative d’exécution d’une tâche de statistiques de colonne.

**Champs**
+ `Status` – Chaîne UTF-8 (valeurs valides : `FAILED` \$1 `STARTED`).

  Statut d’exécution de la dernière tâche de statistiques de colonne.
+ `ColumnStatisticsTaskRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant d’exécution de tâche de la dernière exécution de tâche de statistiques de colonne.
+ `ExecutionTimestamp` – Horodatage.

  Horodatage de la dernière exécution de tâche de statistiques de colonne.
+ `ErrorMessage` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Message d’erreur associé à la dernière exécution de tâche de statistiques de colonne.

## Opérations
<a name="aws-glue-api-crawler-column-statistics-actions"></a>
+ [StartColumnStatisticsTaskRun action (Python : start\$1column\$1statistics\$1task\$1run)](#aws-glue-api-crawler-column-statistics-StartColumnStatisticsTaskRun)
+ [GetColumnStatisticsTaskRun action (Python : get\$1column\$1statistics\$1task\$1run)](#aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskRun)
+ [GetColumnStatisticsTaskRuns action (Python : get\$1column\$1statistics\$1task\$1runs)](#aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskRuns)
+ [ListColumnStatisticsTaskRuns action (Python : list\$1column\$1statistics\$1task\$1runs)](#aws-glue-api-crawler-column-statistics-ListColumnStatisticsTaskRuns)
+ [StopColumnStatisticsTaskRun action (Python : stop\$1column\$1statistics\$1task\$1run)](#aws-glue-api-crawler-column-statistics-StopColumnStatisticsTaskRun)
+ [CreateColumnStatisticsTaskSettings action (Python : create\$1column\$1statistics\$1task\$1settings)](#aws-glue-api-crawler-column-statistics-CreateColumnStatisticsTaskSettings)
+ [UpdateColumnStatisticsTaskSettings action (Python : update\$1column\$1statistics\$1task\$1settings)](#aws-glue-api-crawler-column-statistics-UpdateColumnStatisticsTaskSettings)
+ [GetColumnStatisticsTaskSettings action (Python : get\$1column\$1statistics\$1task\$1settings)](#aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskSettings)
+ [DeleteColumnStatisticsTaskSettings action (Python : delete\$1column\$1statistics\$1task\$1settings)](#aws-glue-api-crawler-column-statistics-DeleteColumnStatisticsTaskSettings)
+ [StartColumnStatisticsTaskRunSchedule action (Python : start\$1column\$1statistics\$1task\$1run\$1schedule)](#aws-glue-api-crawler-column-statistics-StartColumnStatisticsTaskRunSchedule)
+ [StopColumnStatisticsTaskRunSchedule action (Python : stop\$1column\$1statistics\$1task\$1run\$1schedule)](#aws-glue-api-crawler-column-statistics-StopColumnStatisticsTaskRunSchedule)

## StartColumnStatisticsTaskRun action (Python : start\$1column\$1statistics\$1task\$1run)
<a name="aws-glue-api-crawler-column-statistics-StartColumnStatisticsTaskRun"></a>

Démarre une exécution de tâche de statistiques de colonne pour une table et des colonnes spécifiées.

**Demande**
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de la base de données où réside la table.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de la table pour générer des statistiques.
+ `ColumnNameList` – Tableau de chaînes UTF-8.

  Une liste des noms de colonnes pour générer des statistiques. Si aucun nom n'est fourni, tous les noms de colonnes de la table seront utilisés par défaut.
+ `Role` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le rôle IAM que le service assume pour générer des statistiques.
+ `SampleSize` – Nombre (double), 100 au maximum.

  Pourcentage de lignes utilisées pour générer des statistiques. Si aucun nom n'est fourni, la table entière sera utilisée pour générer des statistiques.
+ `CatalogID` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID du catalogue de données où réside la table. Si aucun nom n'est fourni, l'ID de compte AWS est utilisé par défaut.
+ `SecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la configuration de sécurité utilisée pour chiffrer les CloudWatch journaux pour la tâche de statistiques de colonne exécutée.

**Réponse**
+ `ColumnStatisticsTaskRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'identifiant d'exécution de la tâche de statistiques de colonne.

**Erreurs**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ColumnStatisticsTaskRunningException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `InvalidInputException`

## GetColumnStatisticsTaskRun action (Python : get\$1column\$1statistics\$1task\$1run)
<a name="aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskRun"></a>

Obtenez le code associé metadata/information à une exécution de tâche, en fonction d'un ID d'exécution de tâche.

**Demande**
+ `ColumnStatisticsTaskRunId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'identifiant d'exécution de la tâche de statistiques de colonne particulière.

**Réponse**
+ `ColumnStatisticsTaskRun` – Un objet [ColumnStatisticsTaskRun](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRun).

  Un objet `ColumnStatisticsTaskRun` représentant les détails de l'exécution des statistiques de colonne.

**Erreurs**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`

## GetColumnStatisticsTaskRuns action (Python : get\$1column\$1statistics\$1task\$1runs)
<a name="aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskRuns"></a>

Récupère des informations sur toutes les exécutions associées à la table spécifiée.

**Demande**
+ `DatabaseName` – *Obligatoire :* chaîne UTF-8.

  Le nom de la base de données où réside la table.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Taille maximale de la réponse.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.

**Réponse**
+ `ColumnStatisticsTaskRuns` : un tableau d’objets [ColumnStatisticsTaskRun](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRun).

  Une liste des exécutions de tâches de statistiques de colonne.
+ `NextToken` – Chaîne UTF-8.

  Un jeton de continuation, si toutes les exécutions de tâches n'ont pas encore été renvoyées.

**Erreurs**
+ `OperationTimeoutException`

## ListColumnStatisticsTaskRuns action (Python : list\$1column\$1statistics\$1task\$1runs)
<a name="aws-glue-api-crawler-column-statistics-ListColumnStatisticsTaskRuns"></a>

Répertoriez toutes les exécutions de tâches pour un compte spécifique.

**Demande**
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Taille maximale de la réponse.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.

**Réponse**
+ `ColumnStatisticsTaskRunIds` – Tableau de chaînes UTF-8, avec 100 chaînes maximum.

  Liste des tâches de statistiques de colonnes exécutées IDs.
+ `NextToken` – Chaîne UTF-8.

  Un jeton de continuation, si toutes les tâches exécutées n' IDs ont pas encore été renvoyées.

**Erreurs**
+ `OperationTimeoutException`

## StopColumnStatisticsTaskRun action (Python : stop\$1column\$1statistics\$1task\$1run)
<a name="aws-glue-api-crawler-column-statistics-StopColumnStatisticsTaskRun"></a>

Arrête l'exécution d'une tâche pour la table spécifiée.

**Demande**
+ `DatabaseName` – *Obligatoire :* chaîne UTF-8.

  Le nom de la base de données où réside la table.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `ColumnStatisticsTaskNotRunningException`
+ `ColumnStatisticsTaskStoppingException`
+ `OperationTimeoutException`

## CreateColumnStatisticsTaskSettings action (Python : create\$1column\$1statistics\$1task\$1settings)
<a name="aws-glue-api-crawler-column-statistics-CreateColumnStatisticsTaskSettings"></a>

Crée les paramètres d’une tâche de statistiques de colonne.

**Demande**
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de la base de données où réside la table.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table pour laquelle les statistiques de colonne sont générées.
+ `Role` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Rôle utilisé pour l’exécution des statistiques de colonne.
+ `Schedule` – Chaîne UTF-8.

  Calendrier d’exécution des statistiques de colonne, spécifié dans la syntaxe CRON.
+ `ColumnNameList` – Tableau de chaînes UTF-8.

  Liste des noms de colonnes pour lesquelles les statistiques doivent être exécutées.
+ `SampleSize` – Nombre (double), 100 au maximum.

  Pourcentage de données à échantillonner.
+ `CatalogID` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel réside la base de données.
+ `SecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la configuration de sécurité utilisée pour chiffrer les CloudWatch journaux.
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Carte de balises.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `AlreadyExistsException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ColumnStatisticsTaskRunningException`

## UpdateColumnStatisticsTaskSettings action (Python : update\$1column\$1statistics\$1task\$1settings)
<a name="aws-glue-api-crawler-column-statistics-UpdateColumnStatisticsTaskSettings"></a>

Met à jour les paramètres d’une tâche de statistiques de colonne.

**Demande**
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de la base de données où réside la table.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table pour laquelle les statistiques de colonne sont générées.
+ `Role` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Rôle utilisé pour l’exécution des statistiques de colonne.
+ `Schedule` – Chaîne UTF-8.

  Calendrier d’exécution des statistiques de colonne, spécifié dans la syntaxe CRON.
+ `ColumnNameList` – Tableau de chaînes UTF-8.

  Liste des noms de colonnes pour lesquelles les statistiques doivent être exécutées.
+ `SampleSize` – Nombre (double), 100 au maximum.

  Pourcentage de données à échantillonner.
+ `CatalogID` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du catalogue de données dans lequel réside la base de données.
+ `SecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la configuration de sécurité utilisée pour chiffrer les CloudWatch journaux.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `VersionMismatchException`
+ `OperationTimeoutException`

## GetColumnStatisticsTaskSettings action (Python : get\$1column\$1statistics\$1task\$1settings)
<a name="aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskSettings"></a>

Obtient les paramètres d’une tâche de statistiques de colonne.

**Demande**
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de la base de données où réside la table.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table pour laquelle les statistiques de colonne sont extraites.

**Réponse**
+ `ColumnStatisticsTaskSettings` – Un objet [ColumnStatisticsTaskSettings](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskSettings).

  Objet `ColumnStatisticsTaskSettings` représentant les paramètres de la tâche de statistiques de colonne.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`

## DeleteColumnStatisticsTaskSettings action (Python : delete\$1column\$1statistics\$1task\$1settings)
<a name="aws-glue-api-crawler-column-statistics-DeleteColumnStatisticsTaskSettings"></a>

Supprime les paramètres d’une tâche de statistiques de colonne.

**Demande**
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de la base de données où réside la table.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table pour laquelle les statistiques de colonne sont supprimées.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`

## StartColumnStatisticsTaskRunSchedule action (Python : start\$1column\$1statistics\$1task\$1run\$1schedule)
<a name="aws-glue-api-crawler-column-statistics-StartColumnStatisticsTaskRunSchedule"></a>

Démarre la planification d’exécution d’une tâche de statistiques de colonne.

**Demande**
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de la base de données où réside la table.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table pour laquelle un calendrier d’exécution des tâches de statistiques de colonne doit être lancé.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`

## StopColumnStatisticsTaskRunSchedule action (Python : stop\$1column\$1statistics\$1task\$1run\$1schedule)
<a name="aws-glue-api-crawler-column-statistics-StopColumnStatisticsTaskRunSchedule"></a>

Arrête un calendrier d’exécution d’une tâche de statistiques de colonne.

**Demande**
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de la base de données où réside la table.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table pour laquelle un calendrier d’exécution des tâches de statistiques de colonne doit être arrêté.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`

## Exceptions
<a name="aws-glue-api-crawler-column-statistics-exceptions"></a>
+ [ColumnStatisticsTaskRunningException structure](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRunningException)
+ [ColumnStatisticsTaskNotRunningException structure](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskNotRunningException)
+ [ColumnStatisticsTaskStoppingException structure](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskStoppingException)
+ [ColumnStatisticsTaskAutoConcurrencyLimitException structure](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskAutoConcurrencyLimitException)
+ [InvalidCatalogSettingException structure](#aws-glue-api-crawler-column-statistics-InvalidCatalogSettingException)

## ColumnStatisticsTaskRunningException structure
<a name="aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRunningException"></a>

Exception renvoyée lorsque vous essayez de démarrer une autre tâche lors de l'exécution d'une tâche de génération de statistiques de colonne.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## ColumnStatisticsTaskNotRunningException structure
<a name="aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskNotRunningException"></a>

Exception renvoyée lorsque vous essayez d'arrêter l'exécution d'une tâche alors qu'aucune tâche n'est en cours d'exécution.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## ColumnStatisticsTaskStoppingException structure
<a name="aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskStoppingException"></a>

Exception renvoyée lorsque vous essayez d'arrêter l'exécution d'une tâche.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## ColumnStatisticsTaskAutoConcurrencyLimitException structure
<a name="aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskAutoConcurrencyLimitException"></a>

Une exception est déclenchée lorsque vous avez déjà atteint la limite des tâches de statistiques automatiques simultanées.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## InvalidCatalogSettingException structure
<a name="aws-glue-api-crawler-column-statistics-InvalidCatalogSettingException"></a>

Une exception déclenchée en cas de problème avec les paramètres du catalogue.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

# API du planificateur du crawler
<a name="aws-glue-api-crawler-scheduler"></a>

L'API du planificateur de robots décrit les types de données des robots d' AWS Glue exploration, ainsi que l'API permettant de créer, de supprimer, de mettre à jour et de répertorier les robots d'exploration.

## Types de données
<a name="aws-glue-api-crawler-scheduler-objects"></a>
+ [Structure du planificateur](#aws-glue-api-crawler-scheduler-Schedule)

## Structure du planificateur
<a name="aws-glue-api-crawler-scheduler-Schedule"></a>

Objet de planification utilisant une instruction `cron` pour planifier un événement.

**Champs**
+ `ScheduleExpression` – Chaîne UTF-8.

  Une expression `cron` utilisée pour spécifier la planification (consultez [Time-Based Schedules for Jobs and Crawlers](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) (Planifications temporelles pour les tâches et les crawlers)). Par exemple, pour exécuter un élément tous les jours à 12h15 UTC, vous devez spécifier : `cron(15 12 * * ? *)`.
+ `State` – Chaîne UTF-8 (valeurs valides : `SCHEDULED` \$1 `NOT_SCHEDULED` \$1 `TRANSITIONING`).

  État de la planification.

## Opérations
<a name="aws-glue-api-crawler-scheduler-actions"></a>
+ [UpdateCrawlerSchedule action (Python : update\$1crawler\$1schedule)](#aws-glue-api-crawler-scheduler-UpdateCrawlerSchedule)
+ [StartCrawlerSchedule action (Python : start\$1crawler\$1schedule)](#aws-glue-api-crawler-scheduler-StartCrawlerSchedule)
+ [StopCrawlerSchedule action (Python : stop\$1crawler\$1schedule)](#aws-glue-api-crawler-scheduler-StopCrawlerSchedule)

## UpdateCrawlerSchedule action (Python : update\$1crawler\$1schedule)
<a name="aws-glue-api-crawler-scheduler-UpdateCrawlerSchedule"></a>

Met à jour la planification d'un crawler à l'aide d'une expression `cron`. 

**Demande**
+ `CrawlerName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'crawler dont la planification doit être mise à jour.
+ `Schedule` – Chaîne UTF-8.

  L'expression `cron` mise à jour utilisée pour spécifier la planification (voir [Planifications temporelles pour les tâches et les crawlers](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html)). Par exemple, pour exécuter un élément tous les jours à 12h15 UTC, vous devez spécifier : `cron(15 12 * * ? *)`.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `VersionMismatchException`
+ `SchedulerTransitioningException`
+ `OperationTimeoutException`

## StartCrawlerSchedule action (Python : start\$1crawler\$1schedule)
<a name="aws-glue-api-crawler-scheduler-StartCrawlerSchedule"></a>

Modifie l'état de la planification pour l'crawler spécifié par `SCHEDULED`, sauf si l'crawler est déjà en cours d'exécution ou si l'état de la planification est déjà `SCHEDULED`.

**Demande**
+ `CrawlerName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'crawler à planifier.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `SchedulerRunningException`
+ `SchedulerTransitioningException`
+ `NoScheduleException`
+ `OperationTimeoutException`

## StopCrawlerSchedule action (Python : stop\$1crawler\$1schedule)
<a name="aws-glue-api-crawler-scheduler-StopCrawlerSchedule"></a>

Définit l'état de la planification de l'crawler spécifié sur `NOT_SCHEDULED`, mais n'arrête pas l'crawler s'il est déjà en cours d'exécution.

**Demande**
+ `CrawlerName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'crawler dont l'état de la planification doit être défini.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `SchedulerNotRunningException`
+ `SchedulerTransitioningException`
+ `OperationTimeoutException`

# Génération automatique d'API de scripts ETL
<a name="aws-glue-api-etl-script-generation"></a>

L'API de génération de script ETL décrit les types de données et l'API pour générer les scripts ETL dans AWS Glue.

## Types de données
<a name="aws-glue-api-etl-script-generation-objects"></a>
+ [CodeGenNode structure](#aws-glue-api-etl-script-generation-CodeGenNode)
+ [CodeGenNodeArg structure](#aws-glue-api-etl-script-generation-CodeGenNodeArg)
+ [CodeGenEdge structure](#aws-glue-api-etl-script-generation-CodeGenEdge)
+ [Structure de l'emplacement](#aws-glue-api-etl-script-generation-Location)
+ [CatalogEntry structure](#aws-glue-api-etl-script-generation-CatalogEntry)
+ [MappingEntry structure](#aws-glue-api-etl-script-generation-MappingEntry)

## CodeGenNode structure
<a name="aws-glue-api-etl-script-generation-CodeGenNode"></a>

Représente un nœud dans un graphe orienté acyclique (DAG)

**Champs**
+ `Id` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Identifier string pattern](aws-glue-api-common.md#aws-glue-api-regex-id).

  Identifiant de nœud qui est unique dans le graphe du nœud.
+ `NodeType` – *Obligatoire :* chaîne UTF-8.

  Type de nœud.
+ `Args` – *Obligatoire :* Un tableau d'objets [CodeGenNodeArg](#aws-glue-api-etl-script-generation-CodeGenNodeArg), 50 structures maximum.

  Propriétés du nœud, sous forme de paires nom-valeur.
+ `LineNumber` : nombre (entier).

  Numéro de ligne du nœud.

## CodeGenNodeArg structure
<a name="aws-glue-api-etl-script-generation-CodeGenNodeArg"></a>

Argument ou propriété d'un nœud.

**Champs**
+ `Name` – *Obligatoire :* chaîne UTF-8.

  Nom de l'argument ou de la propriété.
+ `Value` – *Obligatoire :* chaîne UTF-8.

  Valeur de l'argument ou de la propriété.
+ `Param` : booléen.

  True si la valeur est utilisée en tant que paramètre.

## CodeGenEdge structure
<a name="aws-glue-api-etl-script-generation-CodeGenEdge"></a>

Représente un bord directionnel dans un graphe orienté acyclique (DAG).

**Champs**
+ `Source` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Identifier string pattern](aws-glue-api-common.md#aws-glue-api-regex-id).

  ID du nœud où commence le bord.
+ `Target` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Identifier string pattern](aws-glue-api-common.md#aws-glue-api-regex-id).

  ID du nœud où finit le bord.
+ `TargetParameter` – Chaîne UTF-8.

  Cible du bord.

## Structure de l'emplacement
<a name="aws-glue-api-etl-script-generation-Location"></a>

Emplacement des ressources.

**Champs**
+ `Jdbc` – Un tableau d'objets [CodeGenNodeArg](#aws-glue-api-etl-script-generation-CodeGenNodeArg), 50 structures maximum.

  Emplacement JDBC.
+ `S3` – Un tableau d'objets [CodeGenNodeArg](#aws-glue-api-etl-script-generation-CodeGenNodeArg), 50 structures maximum.

  Emplacement Amazon Simple Storage Service (Amazon S3).
+ `DynamoDB` – Un tableau d'objets [CodeGenNodeArg](#aws-glue-api-etl-script-generation-CodeGenNodeArg), 50 structures maximum.

  Emplacement de table Amazon DynamoDB.

## CatalogEntry structure
<a name="aws-glue-api-etl-script-generation-CatalogEntry"></a>

Spécifie une définition de table dans AWS Glue Data Catalog.

**Champs**
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Base de données dans laquelle réside les métadonnées de la table.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table en question.

## MappingEntry structure
<a name="aws-glue-api-etl-script-generation-MappingEntry"></a>

Définit un mappage.

**Champs**
+ `SourceTable` – Chaîne UTF-8.

  Nom de la table source.
+ `SourcePath` – Chaîne UTF-8.

  Le chemin d'accès source .
+ `SourceType` – Chaîne UTF-8.

  Type source.
+ `TargetTable` – Chaîne UTF-8.

  Table cible.
+ `TargetPath` – Chaîne UTF-8.

  Chemin cible.
+ `TargetType` – Chaîne UTF-8.

  Type de cible.

## Opérations
<a name="aws-glue-api-etl-script-generation-actions"></a>
+ [CreateScript action (Python : créer\$1script)](#aws-glue-api-etl-script-generation-CreateScript)
+ [GetDataflowGraph action (Python : get\$1dataflow\$1graph)](#aws-glue-api-etl-script-generation-GetDataflowGraph)
+ [GetMapping action (Python : get\$1mapping)](#aws-glue-api-etl-script-generation-GetMapping)
+ [GetPlan action (Python : get\$1plan)](#aws-glue-api-etl-script-generation-GetPlan)

## CreateScript action (Python : créer\$1script)
<a name="aws-glue-api-etl-script-generation-CreateScript"></a>

Transforme un graphe orienté acyclique (DAG) en code.

**Demande**
+ `DagNodes` : un tableau d’objets [CodeGenNode](#aws-glue-api-etl-script-generation-CodeGenNode).

  Liste de nœuds dans le DAG.
+ `DagEdges` : un tableau d’objets [CodeGenEdge](#aws-glue-api-etl-script-generation-CodeGenEdge).

  Liste de bords dans le DAG.
+ `Language` – Chaîne UTF-8 (valeurs valides : `PYTHON` \$1 `SCALA`).

  Langage de programmation du code obtenu à partir du DAG.

**Réponse**
+ `PythonScript` – Chaîne UTF-8.

  Script Python généré à partir du DAG.
+ `ScalaCode` – Chaîne UTF-8.

  Code Scala généré à partir du DAG.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetDataflowGraph action (Python : get\$1dataflow\$1graph)
<a name="aws-glue-api-etl-script-generation-GetDataflowGraph"></a>

Transforme un script Python en graphe orienté acyclique (DAG). 

**Demande**
+ `PythonScript` – Chaîne UTF-8.

  Script Python à transformer.

**Réponse**
+ `DagNodes` : un tableau d’objets [CodeGenNode](#aws-glue-api-etl-script-generation-CodeGenNode).

  Liste de nœuds dans le DAG obtenu.
+ `DagEdges` : un tableau d’objets [CodeGenEdge](#aws-glue-api-etl-script-generation-CodeGenEdge).

  Liste de bords dans le DAG obtenu.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetMapping action (Python : get\$1mapping)
<a name="aws-glue-api-etl-script-generation-GetMapping"></a>

Crée des mappages.

**Demande**
+ `Source` – *Obligatoire :* un objet [CatalogEntry](#aws-glue-api-etl-script-generation-CatalogEntry).

  Spécifie la table source.
+ `Sinks` : un tableau d’objets [CatalogEntry](#aws-glue-api-etl-script-generation-CatalogEntry).

  Liste des tables cible.
+ `Location` – Un objet [Location](#aws-glue-api-etl-script-generation-Location).

  Paramètres pour le mappage.

**Réponse**
+ `Mapping` – *Obligatoire :* un tableau d’objets [MappingEntry](#aws-glue-api-etl-script-generation-MappingEntry).

  Liste des mappages pour les cibles spécifiées.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `EntityNotFoundException`

## GetPlan action (Python : get\$1plan)
<a name="aws-glue-api-etl-script-generation-GetPlan"></a>

Obtient le code pour effectuer un mappage spécifié.

**Demande**
+ `Mapping` – *Obligatoire :* un tableau d’objets [MappingEntry](#aws-glue-api-etl-script-generation-MappingEntry).

  Liste des mappages d'une table source vers des tables cibles.
+ `Source` – *Obligatoire :* un objet [CatalogEntry](#aws-glue-api-etl-script-generation-CatalogEntry).

  Table source.
+ `Sinks` – Un tableau [CatalogEntry](#aws-glue-api-etl-script-generation-CatalogEntry) d'objets.

  Tables cibles.
+ `Location` – Un objet [Location](#aws-glue-api-etl-script-generation-Location).

  Paramètres pour le mappage.
+ `Language` – Chaîne UTF-8 (valeurs valides : `PYTHON` \$1 `SCALA`).

  Langage de programmation du code pour effectuer le mappage.
+ `AdditionalPlanOptionsMap` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Carte pour contenir les paramètres clé-valeur facultatifs supplémentaires.

  Actuellement, ces paires clé-valeur sont prises en charge :
  + `inferSchema`— Spécifie si le script par défaut généré par une AWS Glue tâche doit `inferSchema` être défini sur true ou false. Par exemple, pour définir `inferSchema` sur true, transmettez la paire de clé-valeur suivante :

    `--additional-plan-options-map '{"inferSchema":"true"}'`

**Réponse**
+ `PythonScript` – Chaîne UTF-8.

  Script Python pour effectuer le mappage.
+ `ScalaCode` – Chaîne UTF-8.

  Code Scala pour effectuer le mappage.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

# API Visual Job
<a name="aws-glue-api-visual-job-api"></a>

L'API Visual job vous permet de créer des jobs d'intégration de données en utilisant l' AWS Glue API d'un objet JSON qui représente la configuration visuelle d'un AWS Glue job. 

Une liste est fournie à une API de `CodeGenConfigurationNodes` création ou de mise à jour de tâche afin d'enregistrer un DAG dans AWS Glue Studio pour la tâche créée et de générer le code associé.

## Types de données
<a name="aws-glue-api-visual-job-api-objects"></a>
+ [CodeGenConfigurationNode structure](#aws-glue-api-visual-job-api-CodeGenConfigurationNode)
+ [JDBCConnectorStructure des options](#aws-glue-api-visual-job-api-JDBCConnectorOptions)
+ [StreamingDataPreviewOptions structure](#aws-glue-api-visual-job-api-StreamingDataPreviewOptions)
+ [AthenaConnectorSource structure](#aws-glue-api-visual-job-api-AthenaConnectorSource)
+ [JDBCConnectorStructure de la source](#aws-glue-api-visual-job-api-JDBCConnectorSource)
+ [SparkConnectorSource structure](#aws-glue-api-visual-job-api-SparkConnectorSource)
+ [CatalogSource structure](#aws-glue-api-visual-job-api-CatalogSource)
+ [Structure SQLCatalog de ma source](#aws-glue-api-visual-job-api-MySQLCatalogSource)
+ [Structure de la SQLCatalog source Postgre](#aws-glue-api-visual-job-api-PostgreSQLCatalogSource)
+ [Structure d'Oracle SQLCatalog Source](#aws-glue-api-visual-job-api-OracleSQLCatalogSource)
+ [SQLServerCatalogSource Structure de Microsoft](#aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogSource)
+ [CatalogKinesisSource structure](#aws-glue-api-visual-job-api-CatalogKinesisSource)
+ [DirectKinesisSource structure](#aws-glue-api-visual-job-api-DirectKinesisSource)
+ [KinesisStreamingSourceOptions structure](#aws-glue-api-visual-job-api-KinesisStreamingSourceOptions)
+ [CatalogKafkaSource structure](#aws-glue-api-visual-job-api-CatalogKafkaSource)
+ [DirectKafkaSource structure](#aws-glue-api-visual-job-api-DirectKafkaSource)
+ [KafkaStreamingSourceOptions structure](#aws-glue-api-visual-job-api-KafkaStreamingSourceOptions)
+ [RedshiftSource structure](#aws-glue-api-visual-job-api-RedshiftSource)
+ [AmazonRedshiftSource structure](#aws-glue-api-visual-job-api-AmazonRedshiftSource)
+ [AmazonRedshiftNodeData structure](#aws-glue-api-visual-job-api-AmazonRedshiftNodeData)
+ [AmazonRedshiftAdvancedOption structure](#aws-glue-api-visual-job-api-AmazonRedshiftAdvancedOption)
+ [Structure de l'option](#aws-glue-api-visual-job-api-Option)
+ [CatalogSource Structure S3](#aws-glue-api-visual-job-api-S3CatalogSource)
+ [SourceAdditionalOptions Structure S3](#aws-glue-api-visual-job-api-S3SourceAdditionalOptions)
+ [CsvSource Structure S3](#aws-glue-api-visual-job-api-S3CsvSource)
+ [JDBCSource Structure directe](#aws-glue-api-visual-job-api-DirectJDBCSource)
+ [DirectSourceAdditionalOptions Structure S3](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions)
+ [JsonSource Structure S3](#aws-glue-api-visual-job-api-S3JsonSource)
+ [ParquetSource Structure S3](#aws-glue-api-visual-job-api-S3ParquetSource)
+ [DeltaSource Structure S3](#aws-glue-api-visual-job-api-S3DeltaSource)
+ [CatalogDeltaSource Structure S3](#aws-glue-api-visual-job-api-S3CatalogDeltaSource)
+ [CatalogDeltaSource structure](#aws-glue-api-visual-job-api-CatalogDeltaSource)
+ [HudiSource Structure S3](#aws-glue-api-visual-job-api-S3HudiSource)
+ [CatalogHudiSource Structure S3](#aws-glue-api-visual-job-api-S3CatalogHudiSource)
+ [ExcelSource Structure S3](#aws-glue-api-visual-job-api-S3ExcelSource)
+ [CatalogHudiSource structure](#aws-glue-api-visual-job-api-CatalogHudiSource)
+ [Structure de Dynamo DBCatalog Source](#aws-glue-api-visual-job-api-DynamoDBCatalogSource)
+ [RelationalCatalogSource structure](#aws-glue-api-visual-job-api-RelationalCatalogSource)
+ [JDBCConnectorStructure de la cible](#aws-glue-api-visual-job-api-JDBCConnectorTarget)
+ [SparkConnectorTarget structure](#aws-glue-api-visual-job-api-SparkConnectorTarget)
+ [BasicCatalogTarget structure](#aws-glue-api-visual-job-api-BasicCatalogTarget)
+ [Structure de My SQLCatalog Target](#aws-glue-api-visual-job-api-MySQLCatalogTarget)
+ [Structure de SQLCatalog PostgreTarget](#aws-glue-api-visual-job-api-PostgreSQLCatalogTarget)
+ [Structure d'Oracle SQLCatalog Target](#aws-glue-api-visual-job-api-OracleSQLCatalogTarget)
+ [SQLServerCatalogTarget Structure de Microsoft](#aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogTarget)
+ [RedshiftTarget structure](#aws-glue-api-visual-job-api-RedshiftTarget)
+ [AmazonRedshiftTarget structure](#aws-glue-api-visual-job-api-AmazonRedshiftTarget)
+ [UpsertRedshiftTargetOptions structure](#aws-glue-api-visual-job-api-UpsertRedshiftTargetOptions)
+ [CatalogTarget Structure S3](#aws-glue-api-visual-job-api-S3CatalogTarget)
+ [GlueParquetTarget Structure S3](#aws-glue-api-visual-job-api-S3GlueParquetTarget)
+ [CatalogSchemaChangePolicy structure](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy)
+ [DirectTarget Structure S3](#aws-glue-api-visual-job-api-S3DirectTarget)
+ [HudiCatalogTarget Structure S3](#aws-glue-api-visual-job-api-S3HudiCatalogTarget)
+ [HudiDirectTarget Structure S3](#aws-glue-api-visual-job-api-S3HudiDirectTarget)
+ [DeltaCatalogTarget Structure S3](#aws-glue-api-visual-job-api-S3DeltaCatalogTarget)
+ [DeltaDirectTarget Structure S3](#aws-glue-api-visual-job-api-S3DeltaDirectTarget)
+ [HyperDirectTarget Structure S3](#aws-glue-api-visual-job-api-S3HyperDirectTarget)
+ [IcebergDirectTarget Structure S3](#aws-glue-api-visual-job-api-S3IcebergDirectTarget)
+ [DirectSchemaChangePolicy structure](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy)
+ [ApplyMapping structure](#aws-glue-api-visual-job-api-ApplyMapping)
+ [Structure de mappage](#aws-glue-api-visual-job-api-Mapping)
+ [SelectFields structure](#aws-glue-api-visual-job-api-SelectFields)
+ [DropFields structure](#aws-glue-api-visual-job-api-DropFields)
+ [RenameField structure](#aws-glue-api-visual-job-api-RenameField)
+ [Structure Spigot](#aws-glue-api-visual-job-api-Spigot)
+ [Structure Join](#aws-glue-api-visual-job-api-Join)
+ [JoinColumn structure](#aws-glue-api-visual-job-api-JoinColumn)
+ [SplitFields structure](#aws-glue-api-visual-job-api-SplitFields)
+ [SelectFromCollection structure](#aws-glue-api-visual-job-api-SelectFromCollection)
+ [FillMissingValues structure](#aws-glue-api-visual-job-api-FillMissingValues)
+ [Structure Filtre](#aws-glue-api-visual-job-api-Filter)
+ [FilterExpression structure](#aws-glue-api-visual-job-api-FilterExpression)
+ [FilterValue structure](#aws-glue-api-visual-job-api-FilterValue)
+ [CustomCode structure](#aws-glue-api-visual-job-api-CustomCode)
+ [Structure SparkSQL](#aws-glue-api-visual-job-api-SparkSQL)
+ [SqlAlias structure](#aws-glue-api-visual-job-api-SqlAlias)
+ [DropNullFields structure](#aws-glue-api-visual-job-api-DropNullFields)
+ [NullCheckBoxList structure](#aws-glue-api-visual-job-api-NullCheckBoxList)
+ [NullValueField structure](#aws-glue-api-visual-job-api-NullValueField)
+ [Structure Datatype](#aws-glue-api-visual-job-api-Datatype)
+ [Structure Fusion](#aws-glue-api-visual-job-api-Merge)
+ [Structure Union](#aws-glue-api-visual-job-api-Union)
+ [PIIDetection structure](#aws-glue-api-visual-job-api-PIIDetection)
+ [Structure Aggregate](#aws-glue-api-visual-job-api-Aggregate)
+ [DropDuplicates structure](#aws-glue-api-visual-job-api-DropDuplicates)
+ [GovernedCatalogTarget structure](#aws-glue-api-visual-job-api-GovernedCatalogTarget)
+ [GovernedCatalogSource structure](#aws-glue-api-visual-job-api-GovernedCatalogSource)
+ [AggregateOperation structure](#aws-glue-api-visual-job-api-AggregateOperation)
+ [GlueSchema structure](#aws-glue-api-visual-job-api-GlueSchema)
+ [GlueStudioSchemaColumn structure](#aws-glue-api-visual-job-api-GlueStudioSchemaColumn)
+ [GlueStudioColumn structure](#aws-glue-api-visual-job-api-GlueStudioColumn)
+ [DynamicTransform structure](#aws-glue-api-visual-job-api-DynamicTransform)
+ [TransformConfigParameter structure](#aws-glue-api-visual-job-api-TransformConfigParameter)
+ [EvaluateDataQuality structure](#aws-glue-api-visual-job-api-EvaluateDataQuality)
+ [DQResultsPublishingOptions structure](#aws-glue-api-visual-job-api-DQResultsPublishingOptions)
+ [DQStopJobOnFailureOptions structure](#aws-glue-api-visual-job-api-DQStopJobOnFailureOptions)
+ [EvaluateDataQualityMultiFrame structure](#aws-glue-api-visual-job-api-EvaluateDataQualityMultiFrame)
+ [Structure de la recette](#aws-glue-api-visual-job-api-Recipe)
+ [RecipeReference structure](#aws-glue-api-visual-job-api-RecipeReference)
+ [SnowflakeNodeData structure](#aws-glue-api-visual-job-api-SnowflakeNodeData)
+ [SnowflakeSource structure](#aws-glue-api-visual-job-api-SnowflakeSource)
+ [SnowflakeTarget structure](#aws-glue-api-visual-job-api-SnowflakeTarget)
+ [ConnectorDataSource structure](#aws-glue-api-visual-job-api-ConnectorDataSource)
+ [ConnectorDataTarget structure](#aws-glue-api-visual-job-api-ConnectorDataTarget)
+ [RecipeStep structure](#aws-glue-api-visual-job-api-RecipeStep)
+ [RecipeAction structure](#aws-glue-api-visual-job-api-RecipeAction)
+ [ConditionExpression structure](#aws-glue-api-visual-job-api-ConditionExpression)
+ [CatalogIcebergSource Structure S3](#aws-glue-api-visual-job-api-S3CatalogIcebergSource)
+ [CatalogIcebergSource structure](#aws-glue-api-visual-job-api-CatalogIcebergSource)
+ [IcebergCatalogTarget Structure S3](#aws-glue-api-visual-job-api-S3IcebergCatalogTarget)
+ [Structure de Dynamo DBELTConnector Source](#aws-glue-api-visual-job-api-DynamoDBELTConnectorSource)
+ [DDBELTConnectionStructure des options](#aws-glue-api-visual-job-api-DDBELTConnectionOptions)
+ [DDBELTCatalogAdditionalOptions structure](#aws-glue-api-visual-job-api-DDBELTCatalogAdditionalOptions)
+ [Structure de route](#aws-glue-api-visual-job-api-Route)
+ [GroupFilters structure](#aws-glue-api-visual-job-api-GroupFilters)
+ [AutoDataQuality structure](#aws-glue-api-visual-job-api-AutoDataQuality)

## CodeGenConfigurationNode structure
<a name="aws-glue-api-visual-job-api-CodeGenConfigurationNode"></a>

`CodeGenConfigurationNode` Il énumère les différents types de nœuds valides. Une seule et unique de ses variables membres peut être renseignée.

**Champs**
+ `AthenaConnectorSource` : un objet [AthenaConnectorSource](#aws-glue-api-visual-job-api-AthenaConnectorSource).

  Indique un connecteur à une source de données Amazon Athena.
+ `JDBCConnectorSource` – Un objet [JDBCConnectorLa source](#aws-glue-api-visual-job-api-JDBCConnectorSource).

  Indique un connecteur à une source de données JDBC.
+ `SparkConnectorSource` – Un objet [SparkConnectorSource](#aws-glue-api-visual-job-api-SparkConnectorSource).

  Indique un connecteur à une source de données Apache Spark.
+ `CatalogSource` – Un objet [CatalogSource](#aws-glue-api-visual-job-api-CatalogSource).

  Spécifie un magasin de données dans le catalogue de AWS Glue données.
+ `RedshiftSource` – Un objet [RedshiftSource](#aws-glue-api-visual-job-api-RedshiftSource).

  Indique un stocker de données Amazon Redshift.
+ `S3CatalogSource` – Un objet [S3 CatalogSource](#aws-glue-api-visual-job-api-S3CatalogSource).

  Spécifie un magasin de données Amazon S3 dans le catalogue de AWS Glue données.
+ `S3CsvSource` – Objet [S3 CsvSource](#aws-glue-api-visual-job-api-S3CsvSource).

  Indique un stocker de données CSV (valeurs séparées par commande) stocké dans Amazon S3.
+ `S3JsonSource` – Un objet [S3 JsonSource](#aws-glue-api-visual-job-api-S3JsonSource).

  Indique un stocker de données JSON stocké dans Amazon S3.
+ `S3ParquetSource` – Un objet [S3 ParquetSource](#aws-glue-api-visual-job-api-S3ParquetSource).

  Indique un stocker de données Apache Parquet stocké dans Amazon S3.
+ `RelationalCatalogSource` – Un objet [RelationalCatalogSource](#aws-glue-api-visual-job-api-RelationalCatalogSource).

  Spécifie un magasin de données de catalogue relationnel dans le catalogue de AWS Glue données.
+ `DynamoDBCatalogSource` – Un objet [Source de dynamo DBCatalog](#aws-glue-api-visual-job-api-DynamoDBCatalogSource).

  Spécifie un magasin de données du catalogue DynamoDBC dans le catalogue de AWS Glue données.
+ `JDBCConnectorTarget` – Un objet [JDBCConnectorCible](#aws-glue-api-visual-job-api-JDBCConnectorTarget).

  Indique une cible de données qui écrit sur Amazon S3 dans un stockage en colonnes Apache Parquet.
+ `SparkConnectorTarget` – Un objet [SparkConnectorTarget](#aws-glue-api-visual-job-api-SparkConnectorTarget).

  Indique une cible qui utilise un connecteur Apache Spark.
+ `CatalogTarget` – Un objet [BasicCatalogTarget](#aws-glue-api-visual-job-api-BasicCatalogTarget).

  Spécifie une cible qui utilise une table AWS Glue de catalogue de données.
+ `RedshiftTarget` – Un objet [RedshiftTarget](#aws-glue-api-visual-job-api-RedshiftTarget).

  Indique une cible qui utilise Amazon Redshift.
+ `S3CatalogTarget` – Un objet [S3 CatalogTarget](#aws-glue-api-visual-job-api-S3CatalogTarget).

  Spécifie une cible de données qui écrit sur Amazon S3 à l'aide du catalogue de AWS Glue données.
+ `S3GlueParquetTarget` – Un objet [S3 GlueParquetTarget](#aws-glue-api-visual-job-api-S3GlueParquetTarget).

  Indique une cible de données qui écrit sur Amazon S3 dans un stockage en colonnes Apache Parquet.
+ `S3DirectTarget` – Un objet [S3 DirectTarget](#aws-glue-api-visual-job-api-S3DirectTarget).

  Indique une cible de données qui écrit dans Amazon S3.
+ `ApplyMapping` : un objet [ApplyMapping](#aws-glue-api-visual-job-api-ApplyMapping).

  Indique une transformation qui mappe les clés de propriétés de données de la source de données aux clés de propriété de données de la cible de données. Vous pouvez renommer les clés, modifier leur type de données et choisir les clés à supprimer du jeu de données.
+ `SelectFields` – Un objet [SelectFields](#aws-glue-api-visual-job-api-SelectFields).

  Indique une transformation qui choisit les clés de propriété de données que vous souhaitez conserver.
+ `DropFields` – Un objet [DropFields](#aws-glue-api-visual-job-api-DropFields).

  Indique une transformation qui choisit les clés de propriété de données que vous souhaitez supprimer.
+ `RenameField` – Un objet [RenameField](#aws-glue-api-visual-job-api-RenameField).

  Indique une transformation qui renomme une clé de propriété de données unique.
+ `Spigot` – Un objet [Spigot](#aws-glue-api-visual-job-api-Spigot).

  Indique une transformation qui écrit des échantillons de données dans un compartiment Amazon S3.
+ `Join` – Un objet [Join](#aws-glue-api-visual-job-api-Join).

  Indique une transformation qui joint deux jeux de données en un jeu de données à l'aide d'une phrase de comparaison sur les clés de propriété de données spécifiées. Vous pouvez utiliser des jointures internes (ou intérieures), externes (ou extérieures), gauche, droite, semi gauche et anti gauche.
+ `SplitFields` – Un objet [SplitFields](#aws-glue-api-visual-job-api-SplitFields).

  Indique une transformation qui divise les clés de propriété de données en deux `DynamicFrames`. Le résultat est une collection de `DynamicFrames` : une avec les clés de propriété de données sélectionnées, et une autre avec les clés de propriété de données restantes.
+ `SelectFromCollection` – Un objet [SelectFromCollection](#aws-glue-api-visual-job-api-SelectFromCollection).

  Indique une transformation qui en choisit une `DynamicFrame` provenant d'une collection de `DynamicFrames`. Le résultat est le `DynamicFrame` sélectionné
+ `FillMissingValues` – Un objet [FillMissingValues](#aws-glue-api-visual-job-api-FillMissingValues).

  Indique une transformation qui localise les registres dans le jeu de données dont les valeurs sont manquantes et ajoute un nouveau champ avec une valeur déterminée par imputation. Le jeu de données source est utilisé pour entraîner le modèle de machine learning (ML) qui détermine la valeur manquante.
+ `Filter` – Un objet [Filtre](#aws-glue-api-visual-job-api-Filter).

  Indique une transformation qui divise un jeu de données en deux, en fonction d'une condition de filtre.
+ `CustomCode` – Un objet [CustomCode](#aws-glue-api-visual-job-api-CustomCode).

  Indique une transformation qui utilise le code personnalisé que vous fournissez pour effectuer la transformation des données. La sortie est une collection de DynamicFrames.
+ `SparkSQL` – Un objet [SparkSQL](#aws-glue-api-visual-job-api-SparkSQL).

  Indique une transformation dans laquelle vous entrez une requête SQL à l'aide de la syntaxe Spark SQL pour transformer les données. Le résultat est un `DynamicFrame` unique.
+ `DirectKinesisSource` – Un objet [DirectKinesisSource](#aws-glue-api-visual-job-api-DirectKinesisSource).

  Indique une source de données Amazon Kinesis directe.
+ `DirectKafkaSource` – Un objet [DirectKafkaSource](#aws-glue-api-visual-job-api-DirectKafkaSource).

  Indique un stocker de données Apache Kafka.
+ `CatalogKinesisSource` – Un objet [CatalogKinesisSource](#aws-glue-api-visual-job-api-CatalogKinesisSource).

  Spécifie une source de données Kinesis dans le catalogue de AWS Glue données.
+ `CatalogKafkaSource` – Un objet [CatalogKafkaSource](#aws-glue-api-visual-job-api-CatalogKafkaSource).

  Indique un stocker de données Apache Kafka dans le catalogue de données.
+ `DropNullFields` – Un objet [DropNullFields](#aws-glue-api-visual-job-api-DropNullFields).

  Indique une transformation qui supprime les colonnes du jeu de données si toutes les valeurs de la colonne sont « nulles ». Par défaut, AWS Glue Studio reconnaît les objets nuls, mais certaines valeurs telles que les chaînes vides, les chaînes « nulles », les entiers -1 ou d'autres espaces réservés tels que les zéros ne sont pas automatiquement reconnues comme nulles.
+ `Merge` – Un objet [Fusionner](#aws-glue-api-visual-job-api-Merge).

  Indique une transformation qui fusionne une `DynamicFrame` avec une `DynamicFrame` intermédiaire basée sur les clés primaires spécifiées pour identifier les registres. Les registres en double (registres avec les mêmes clés primaires) ne sont pas dédupliqués. 
+ `Union` : un objet [Union](#aws-glue-api-visual-job-api-Union).

  Indique une transformation qui combine les lignes de deux jeux de données ou plus en un seul résultat.
+ `PIIDetection` – Un objet [PIIDetection](#aws-glue-api-visual-job-api-PIIDetection).

  Indique une transformation qui identifie, supprime ou masque les données d'informations personnelles identifiables (PII).
+ `Aggregate` : un objet [Regrouper](#aws-glue-api-visual-job-api-Aggregate).

  Indique une transformation qui regroupe les lignes par champs choisis et calcule la valeur agrégée par fonction spécifiée.
+ `DropDuplicates` – Un objet [DropDuplicates](#aws-glue-api-visual-job-api-DropDuplicates).

  Indique une transformation qui supprime des lignes de données répétitives d'un jeu de données.
+ `GovernedCatalogTarget` – Un objet [GovernedCatalogTarget](#aws-glue-api-visual-job-api-GovernedCatalogTarget).

  Indique une cible de données qui écrit dans un catalogue gouverné.
+ `GovernedCatalogSource` – Un objet [GovernedCatalogSource](#aws-glue-api-visual-job-api-GovernedCatalogSource).

  Indique une source de données dans un catalogue de données gouverné.
+ `MicrosoftSQLServerCatalogSource` – Un objet [Microsoft SQLServer CatalogSource](#aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogSource).

  Indique une source de données Microsoft SQL Server dans le catalogue de données AWS Glue .
+ `MySQLCatalogSource` – Un objet [Ma SQLCatalog source](#aws-glue-api-visual-job-api-MySQLCatalogSource).

  Spécifie une source de données MySQL dans le catalogue de AWS Glue données.
+ `OracleSQLCatalogSource` : un objet [SQLCatalogSource d'Oracle](#aws-glue-api-visual-job-api-OracleSQLCatalogSource).

  Spécifie une source de données Oracle dans le catalogue de AWS Glue données.
+ `PostgreSQLCatalogSource` – Un objet [Source de Postgrer SQLCatalog](#aws-glue-api-visual-job-api-PostgreSQLCatalogSource).

  Spécifie une source de données PostgressQL dans le catalogue de données. AWS Glue 
+ `MicrosoftSQLServerCatalogTarget` – Un objet [Microsoft SQLServer CatalogTarget](#aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogTarget).

  Indique une cible qui utilise Microsoft SQL.
+ `MySQLCatalogTarget` – Un objet [Ma SQLCatalog cible](#aws-glue-api-visual-job-api-MySQLCatalogTarget).

  Indique une cible qui utilise MySQL.
+ `OracleSQLCatalogTarget` : un objet [SQLCatalogCible Oracle](#aws-glue-api-visual-job-api-OracleSQLCatalogTarget).

  Indique une cible qui utilise Oracle SQL.
+ `PostgreSQLCatalogTarget` – Un objet [Cible Postgrer SQLCatalog](#aws-glue-api-visual-job-api-PostgreSQLCatalogTarget).

  Indique une cible qui utilise Postgre SQL.
+ `Route` – Un objet [Acheminement](#aws-glue-api-visual-job-api-Route).

  Spécifie un nœud de route qui dirige les données vers différents chemins de sortie en fonction de conditions de filtrage définies.
+ `DynamicTransform` – Un objet [DynamicTransform](#aws-glue-api-visual-job-api-DynamicTransform).

  Spécifie une transformation visuelle personnalisée créée par un utilisateur.
+ `EvaluateDataQuality` : un objet [EvaluateDataQuality](#aws-glue-api-visual-job-api-EvaluateDataQuality).

  Spécifie vos critères d'évaluation de la qualité des données.
+ `S3CatalogHudiSource` – Un objet [S3 CatalogHudiSource](#aws-glue-api-visual-job-api-S3CatalogHudiSource).

  Spécifie une source de données Hudi enregistrée dans le catalogue de AWS Glue données. La source de données doit être stockée dans Amazon S3.
+ `CatalogHudiSource` – Un objet [CatalogHudiSource](#aws-glue-api-visual-job-api-CatalogHudiSource).

  Spécifie une source de données Hudi enregistrée dans le catalogue de AWS Glue données.
+ `S3HudiSource` – Un objet [S3 HudiSource](#aws-glue-api-visual-job-api-S3HudiSource).

  Spécifie une source de données Hudi stockée dans. Amazon S3
+ `S3HudiCatalogTarget` – Un objet [S3 HudiCatalogTarget](#aws-glue-api-visual-job-api-S3HudiCatalogTarget).

  Spécifie une cible qui écrit dans une source de données Hudi du catalogue de AWS Glue données.
+ `S3HudiDirectTarget` – Un objet [S3 HudiDirectTarget](#aws-glue-api-visual-job-api-S3HudiDirectTarget).

  Spécifie une cible qui écrit dans une source de données Hudi en Amazon S3.
+ `S3CatalogDeltaSource` – Un objet [S3 CatalogDeltaSource](#aws-glue-api-visual-job-api-S3CatalogDeltaSource).

  Spécifie une source de données Delta Lake enregistrée dans le catalogue de AWS Glue données. La source de données doit être stockée dans Amazon S3.
+ `CatalogDeltaSource` – Un objet [CatalogDeltaSource](#aws-glue-api-visual-job-api-CatalogDeltaSource).

  Spécifie une source de données Delta Lake enregistrée dans le catalogue de AWS Glue données.
+ `S3DeltaSource` – Un objet [S3 DeltaSource](#aws-glue-api-visual-job-api-S3DeltaSource).

  Spécifie une source de données Delta Lake stockée dans Amazon S3.
+ `S3DeltaCatalogTarget` – Un objet [S3 DeltaCatalogTarget](#aws-glue-api-visual-job-api-S3DeltaCatalogTarget).

  Spécifie une cible qui écrit dans une source de données Delta Lake dans le catalogue de AWS Glue données.
+ `S3DeltaDirectTarget` – Un objet [S3 DeltaDirectTarget](#aws-glue-api-visual-job-api-S3DeltaDirectTarget).

  Spécifie une cible qui écrit dans une source de données de Delta Lake en Amazon S3.
+ `AmazonRedshiftSource` : un objet [AmazonRedshiftSource](#aws-glue-api-visual-job-api-AmazonRedshiftSource).

  Indique une cible qui écrit dans une source de données dans Amazon Redshift.
+ `AmazonRedshiftTarget` : un objet [AmazonRedshiftTarget](#aws-glue-api-visual-job-api-AmazonRedshiftTarget).

  Indique une cible qui écrit dans une cible de données dans Amazon Redshift.
+ `EvaluateDataQualityMultiFrame` : un objet [EvaluateDataQualityMultiFrame](#aws-glue-api-visual-job-api-EvaluateDataQualityMultiFrame).

  Spécifie vos critères d'évaluation de la qualité des données. Autorise plusieurs données d'entrée et renvoie une collection de cadres dynamiques.
+ `Recipe` – Un objet [Formule](#aws-glue-api-visual-job-api-Recipe).

  Spécifie un nœud de AWS Glue DataBrew recette.
+ `SnowflakeSource` – Un objet [SnowflakeSource](#aws-glue-api-visual-job-api-SnowflakeSource).

  Indique une source de données Snowflake.
+ `SnowflakeTarget` – Un objet [SnowflakeTarget](#aws-glue-api-visual-job-api-SnowflakeTarget).

  Indique une cible qui écrit dans une source de données Snowflake.
+ `ConnectorDataSource` – Un objet [ConnectorDataSource](#aws-glue-api-visual-job-api-ConnectorDataSource).

  Spécifie une source générée avec des options de connexion standard.
+ `ConnectorDataTarget` – Un objet [ConnectorDataTarget](#aws-glue-api-visual-job-api-ConnectorDataTarget).

  Spécifie une cible générée avec des options de connexion standard.
+ `S3CatalogIcebergSource` – Un objet [S3 CatalogIcebergSource](#aws-glue-api-visual-job-api-S3CatalogIcebergSource).

  Spécifie une source de données Apache Iceberg enregistrée dans le catalogue de AWS Glue données. La source de données Iceberg doit être stockée dans Amazon S3.
+ `CatalogIcebergSource` – Un objet [CatalogIcebergSource](#aws-glue-api-visual-job-api-CatalogIcebergSource).

  Spécifie une source de données Apache Iceberg enregistrée dans le catalogue de AWS Glue données.
+ `S3IcebergCatalogTarget` – Un objet [S3 IcebergCatalogTarget](#aws-glue-api-visual-job-api-S3IcebergCatalogTarget).

  Spécifie une cible de catalogue Apache Iceberg qui écrit des données Amazon S3 et enregistre la table dans le catalogue de AWS Glue données.
+ `S3IcebergDirectTarget` – Un objet [S3 IcebergDirectTarget](#aws-glue-api-visual-job-api-S3IcebergDirectTarget).

  Définit les paramètres de configuration pour écrire des données dans Amazon S3 sous forme de table Apache Iceberg.
+ `S3ExcelSource` – Un objet [S3 ExcelSource](#aws-glue-api-visual-job-api-S3ExcelSource).

  Définit les paramètres de configuration pour lire des fichiers Excel depuis Amazon S3.
+ `S3HyperDirectTarget` – Un objet [S3 HyperDirectTarget](#aws-glue-api-visual-job-api-S3HyperDirectTarget).

  Définit les paramètres de configuration pour écrire des données sur Amazon S3 à l'aide de l' HyperDirect optimisation.
+ `DynamoDBELTConnectorSource` – Un objet [Source de dynamo DBELTConnector](#aws-glue-api-visual-job-api-DynamoDBELTConnectorSource).

  Spécifie une source de connecteur DynamoDB ELT pour extraire les données des tables DynamoDB.

## JDBCConnectorStructure des options
<a name="aws-glue-api-visual-job-api-JDBCConnectorOptions"></a>

Options de connexion supplémentaires pour le connecteur.

**Champs**
+ `FilterPredicate` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Clause de condition supplémentaire pour filtrer les données à partir de la source. Par exemple : 

  `BillingCity='Mountain View'`

  Lorsque vous utilisez une requête au lieu d'un nom de tableau, vous devez vérifier que la requête fonctionne avec le `filterPredicate` spécifié.
+ `PartitionColumn` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom d'une colonne entière utilisée pour le partitionnement. Cette option fonctionne uniquement lorsqu'elle est incluse dans `lowerBound`, `upperBound` et `numPartitions`. Cette option fonctionne de la même manière que dans le lecteur JDBC SQL Spark.
+ `LowerBound` – Nombre (long), pas plus qu'Aucun.

  La valeur minimale de `partitionColumn` qui est utilisée pour décider de la progression de la partition.
+ `UpperBound` – Nombre (long), pas plus qu'Aucun.

  La valeur maximale de `partitionColumn` qui est utilisée pour décider de la progression de la partition.
+ `NumPartitions` – Nombre (long), pas plus qu'Aucun.

  Nombre de partitions. Cette valeur, ainsi que `lowerBound` (inclusive) et `upperBound` (exclusive) forment les progressions de partition pour les expressions de clause `WHERE` générées qui sont utilisées pour diviser le fichier `partitionColumn`.
+ `JobBookmarkKeys` – Tableau de chaînes UTF-8.

  Le nom des clés de marque-page de tâches sur lesquelles effectuer le tri.
+ `JobBookmarkKeysSortOrder` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique un ordre de tri croissant ou décroissant.
+ `DataTypeMapping` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8 (valeurs valides :`ARRAY` \$1 `BIGINT` \$1 `BINARY` \$1 `BIT` \$1 `BLOB` \$1 `BOOLEAN` \$1 `CHAR` \$1 `CLOB` \$1 `DATALINK` \$1 `DATE` \$1 `DECIMAL` \$1 `DISTINCT` \$1 `DOUBLE` \$1 `FLOAT` \$1 `INTEGER` \$1 `JAVA_OBJECT` \$1 `LONGNVARCHAR` \$1 `LONGVARBINARY` \$1 `LONGVARCHAR` \$1 `NCHAR` \$1 `NCLOB` \$1 `NULL` \$1 `NUMERIC` \$1 `NVARCHAR` \$1 `OTHER` \$1 `REAL` \$1 `REF` \$1 `REF_CURSOR` \$1 `ROWID` \$1 `SMALLINT` \$1 `SQLXML` \$1 `STRUCT` \$1 `TIME` \$1 `TIME_WITH_TIMEZONE` \$1 `TIMESTAMP` \$1 `TIMESTAMP_WITH_TIMEZONE` \$1 `TINYINT` \$1 `VARBINARY` \$1 `VARCHAR`).

  Chaque valeur est une chaîne UTF-8 (valeurs valides : `DATE` \$1 `STRING` \$1 `TIMESTAMP` \$1 `INT` \$1 `FLOAT` \$1 `LONG` \$1 `BIGDECIMAL` \$1 `BYTE` \$1 `SHORT` \$1 `DOUBLE`).

  Mappage de type de données personnalisé qui crée un mappage d'un type de données JDBC à un type de données AWS Glue . Par exemple, l'option `"dataTypeMapping":{"FLOAT":"STRING"}` mappe les champs de données de type JDBC `FLOAT` dans le `String` type Java en appelant la `ResultSet.getString()` méthode du pilote et l'utilise pour créer l' AWS Glue enregistrement. L'objet est `ResultSet` implémenté par chaque pilote, donc le comportement est spécifique au pilote que vous utilisez. Reportez-vous à la documentation de votre pilote JDBC pour comprendre comment le pilote effectue les conversions.

## StreamingDataPreviewOptions structure
<a name="aws-glue-api-visual-job-api-StreamingDataPreviewOptions"></a>

Indique les options liées à la prévisualisation des données pour visualiser un échantillon de vos données.

**Champs**
+ `PollingTime` : nombre (long), au moins égal à 10.

  Temps d'interrogation en millisecondes.
+ `RecordPollingLimit` : nombre (long), au moins égal à 1.

  Limite du nombre de registres interrogés.

## AthenaConnectorSource structure
<a name="aws-glue-api-visual-job-api-AthenaConnectorSource"></a>

Indique un connecteur à une source de données Amazon Athena.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source de données.
+ `ConnectionName` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la connexion associée au connecteur.
+ `ConnectorName` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom d'un connecteur qui facilite l'accès au magasin de données dans AWS Glue Studio.
+ `ConnectionType` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Type de connexion, tel que marketplace.athena ou custom.athena, désignant une connexion à un stocker de données Amazon Athena.
+ `ConnectionTable` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la source de données.
+ `SchemaName` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom du groupe de journaux CloudWatch à partir duquel lire les données. Par exemple, `/aws-glue/jobs/output`.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la source Athena personnalisée.

## JDBCConnectorStructure de la source
<a name="aws-glue-api-visual-job-api-JDBCConnectorSource"></a>

Indique un connecteur à une source de données JDBC.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source de données.
+ `ConnectionName` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la connexion associée au connecteur.
+ `ConnectorName` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom d'un connecteur qui facilite l'accès au magasin de données dans AWS Glue Studio.
+ `ConnectionType` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Type de connexion, tel que marketplace.jdbc ou custom.jdbc, désignant une connexion à un stocker de données JDBC.
+ `AdditionalOptions` – Un objet [JDBCConnectorOptions](#aws-glue-api-visual-job-api-JDBCConnectorOptions).

  Options de connexion supplémentaires pour le connecteur.
+ `ConnectionTable` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la source de données.
+ `Query` – Chaîne UTF-8, correspondant au [Custom string pattern #62](aws-glue-api-common.md#regex_62).

  La table ou la requête SQL à partir de laquelle obtenir les données. Vous pouvez préciser `ConnectionTable` ou `query`, mais pas les deux.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la source JDBC personnalisée.

## SparkConnectorSource structure
<a name="aws-glue-api-visual-job-api-SparkConnectorSource"></a>

Indique un connecteur à une source de données Apache Spark.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source de données.
+ `ConnectionName` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la connexion associée au connecteur.
+ `ConnectorName` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom d'un connecteur qui facilite l'accès au magasin de données dans AWS Glue Studio.
+ `ConnectionType` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Type de connexion, tel que marketplace.spark ou custom.spark, désignant une connexion à un stocker de données Apache Spark.
+ `AdditionalOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Options de connexion supplémentaires pour le connecteur.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la source Spark personnalisée.

## CatalogSource structure
<a name="aws-glue-api-visual-job-api-CatalogSource"></a>

Spécifie un magasin de données dans le catalogue de AWS Glue données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du stocker de données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données à partir de laquelle lire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la base de données à partir de laquelle lire les données.
+ `PartitionPredicate` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

   Les partitions satisfaisant à ce prédicat sont supprimées. Les fichiers qui se situent dans la période de conservation pour ces partitions ne sont pas supprimés. 
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la source de catalogue.

## Structure SQLCatalog de ma source
<a name="aws-glue-api-visual-job-api-MySQLCatalogSource"></a>

Spécifie une source de données MySQL dans le catalogue de AWS Glue données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source de données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données à partir de laquelle lire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la base de données à partir de laquelle lire les données.

## Structure de la SQLCatalog source Postgre
<a name="aws-glue-api-visual-job-api-PostgreSQLCatalogSource"></a>

Spécifie une source de données PostgressQL dans le catalogue de données. AWS Glue 

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source de données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données à partir de laquelle lire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la base de données à partir de laquelle lire les données.

## Structure d'Oracle SQLCatalog Source
<a name="aws-glue-api-visual-job-api-OracleSQLCatalogSource"></a>

Spécifie une source de données Oracle dans le catalogue de AWS Glue données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source de données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données à partir de laquelle lire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la base de données à partir de laquelle lire les données.

## SQLServerCatalogSource Structure de Microsoft
<a name="aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogSource"></a>

Indique une source de données Microsoft SQL Server dans le catalogue de données AWS Glue .

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source de données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données à partir de laquelle lire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la base de données à partir de laquelle lire les données.

## CatalogKinesisSource structure
<a name="aws-glue-api-visual-job-api-CatalogKinesisSource"></a>

Spécifie une source de données Kinesis dans le catalogue de AWS Glue données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source de données.
+ `WindowSize` – Nombre (entier), pas plus qu'Aucun.

  Durée de traitement de chaque micro lot.
+ `DetectSchema` : booléen.

  Indique s'il faut déterminer automatiquement le schéma à partir des données entrantes.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la base de données à partir de laquelle lire les données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données à partir de laquelle lire les données.
+ `StreamingOptions` – Un objet [KinesisStreamingSourceOptions](#aws-glue-api-visual-job-api-KinesisStreamingSourceOptions).

  Options supplémentaires pour la source de données en streaming Kinesis.
+ `DataPreviewOptions` – Un objet [StreamingDataPreviewOptions](#aws-glue-api-visual-job-api-StreamingDataPreviewOptions).

  Options supplémentaires pour la prévisualisation des données.

## DirectKinesisSource structure
<a name="aws-glue-api-visual-job-api-DirectKinesisSource"></a>

Indique une source de données Amazon Kinesis directe.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source de données.
+ `WindowSize` – Nombre (entier), pas plus qu'Aucun.

  Durée de traitement de chaque micro lot.
+ `DetectSchema` : booléen.

  Indique s'il faut déterminer automatiquement le schéma à partir des données entrantes.
+ `StreamingOptions` – Un objet [KinesisStreamingSourceOptions](#aws-glue-api-visual-job-api-KinesisStreamingSourceOptions).

  Options supplémentaires pour la source de données en streaming Kinesis.
+ `DataPreviewOptions` – Un objet [StreamingDataPreviewOptions](#aws-glue-api-visual-job-api-StreamingDataPreviewOptions).

  Options supplémentaires pour la prévisualisation des données.

## KinesisStreamingSourceOptions structure
<a name="aws-glue-api-visual-job-api-KinesisStreamingSourceOptions"></a>

Options supplémentaires pour la source de données Amazon Kinesis streaming.

**Champs**
+ `EndpointUrl` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  L'URL du point de terminaison de Kinesis.
+ `StreamName` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom du flux de données Kinesis.
+ `Classification` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Une classification facultative.
+ `Delimiter` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique le caractère délimiteur.
+ `StartingPosition` – Chaîne UTF-8 (valeurs valides : `latest="LATEST"` \$1 `trim_horizon="TRIM_HORIZON"` \$1 `earliest="EARLIEST"` \$1 `timestamp="TIMESTAMP"`).

  La position de départ dans le flux de données Kinesis à partir duquel lire les données. Les valeurs possibles sont `"latest"`, `"trim_horizon"`, `"earliest"`, ou une chaîne d'horodatage au format UTC dans le modèle `yyyy-mm-ddTHH:MM:SSZ` (où `Z` représente un décalage de fuseau horaire UTC avec un \$1/-. Par exemple : « 2023-04-04T08:00:00-04:00 »). La valeur par défaut est `"latest"`.

  Remarque : L'utilisation d'une valeur qui est une chaîne d'horodatage au format UTC pour « StartingPosition » n'est prise en charge que pour la AWS Glue version 4.0 ou ultérieure.
+ `MaxFetchTimeInMs` – Nombre (long), pas plus qu'Aucun.

  Le temps maximal passé dans l’exécuteur de tâches pour lire des enregistrements du lot actuel à partir du flux de données Kinesis, exprimé en millisecondes (ms). Plusieurs appels d’API `GetRecords` peuvent être effectués pendant cette période. La valeur par défaut est `1000`.
+ `MaxFetchRecordsPerShard` – Nombre (long), pas plus qu'Aucun.

  Nombre maximal d’enregistrements à récupérer par partition dans le flux de données Kinesis par microlot. Remarque : Le client peut dépasser cette limite si la tâche de streaming a déjà lu des enregistrements supplémentaires provenant de Kinesis (dans le même appel get-records). Si `MaxFetchRecordsPerShard` doit être strict, il doit être un multiple de `MaxRecordPerRead`. La valeur par défaut est `100000`.
+ `MaxRecordPerRead` – Nombre (long), pas plus qu'Aucun.

  Nombre maximal de registres à extraire du flux de données Kinesis dans chaque opération . La valeur par défaut est `10000`.
+ `AddIdleTimeBetweenReads` : booléen.

  Ajoute un délai entre deux opérations getRecords consécutives. La valeur par défaut est `"False"`. Cette option n’est configurable que pour AWS Glue versions 2.0 et ultérieures.
+ `IdleTimeBetweenReadsInMs` – Nombre (long), pas plus qu'Aucun.

  Le délai minimum entre deux opérations getRecords consécutives, spécifié en ms. La valeur par défaut est `1000`. Cette option n'est configurable que pour les AWS Glue versions 2.0 et supérieures.
+ `DescribeShardInterval` – Nombre (long), pas plus qu'Aucun.

  Intervalle de temps minimum entre deux appels ListShards d'API avant que votre script envisage le repartage. La valeur par défaut est `1s`.
+ `NumRetries` – Nombre (entier), pas plus qu'Aucun.

  Le nombre maximal de nouvelles tentatives pour les demandes d'API Kinesis Data Streams. La valeur par défaut est `3`.
+ `RetryIntervalMs` – Nombre (long), pas plus qu'Aucun.

  Le délai de réflexion (spécifié en ms) avant de réessayer l'appel d'API Kinesis Data Streams. La valeur par défaut est `1000`.
+ `MaxRetryIntervalMs` – Nombre (long), pas plus qu'Aucun.

  Le délai d'attente maximal (spécifié en ms) entre deux tentatives d'appel d'API Kinesis Data Streams. La valeur par défaut est `10000`.
+ `AvoidEmptyBatches` : booléen.

  Évite de créer une tâche de micro-lot vide en vérifiant les données non lues dans le flux de données Kinesis avant le démarrage du lot. La valeur par défaut est `"False"`.
+ `StreamArn` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom Amazon Resource Name (ARN) du flux de données Kinesis.
+ `RoleArn` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom Amazon Resource Name (ARN) du rôle à endosser à l'aide d'AWS Security Token Service (AWS STS). Ce rôle doit disposer des autorisations nécessaires pour décrire ou lire des registres pour le flux de données Kinesis. Vous devez utiliser ce paramètre lorsque vous accédez à un flux de données dans un autre compte. Utilisez conjointement avec `"awsSTSSessionName"`.
+ `RoleSessionName` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Un identifiant de la session endossant le rôle à l'aide d'AWS STS. Vous devez utiliser ce paramètre lorsque vous accédez à un flux de données dans un autre compte. Utilisez conjointement avec `"awsSTSRoleARN"`.
+ `AddRecordTimestamp` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Lorsque cette option est définie sur « true », la sortie de données contient une colonne supplémentaire nommée « \$1\$1src\$1timestamp » qui indique l'heure à laquelle l'enregistrement correspondant est reçu par le flux. La valeur par défaut est « false ». Cette option est prise en charge dans AWS Glue la version 4.0 ou ultérieure.
+ `EmitConsumerLagMetrics` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Lorsque cette option est définie sur « true », pour chaque lot, elle émet les métriques correspondant à la durée comprise entre le plus ancien enregistrement reçu par le flux et l'heure AWS Glue à laquelle il arrive CloudWatch. Le nom de la métrique est « glue.driver.streaming ». maxConsumerLagInMs». La valeur par défaut est « false ». Cette option est prise en charge dans AWS Glue version 4.0 ou ultérieure.
+ `StartingTimestamp` – Chaîne UTF-8.

  L'horodatage de l'enregistrement dans le flux de données Kinesis à partir duquel les données doivent être lues. Les valeurs possibles sont une chaîne d'horodatage au format UTC du modèle `yyyy-mm-ddTHH:MM:SSZ` (où Z représente un décalage de fuseau horaire UTC avec un \$1/-. Par exemple : « 2023-04-04T08:00:00\$108:00 »). 
+ `FanoutConsumerARN` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Amazon Resource Name (ARN) du consommateur à ventilation améliorée Kinesis Data Streams. Lorsqu’il est spécifié, il permet une ventilation améliorée pour un débit dédié et une consommation de données à latence réduite.

## CatalogKafkaSource structure
<a name="aws-glue-api-visual-job-api-CatalogKafkaSource"></a>

Indique un stocker de données Apache Kafka dans le catalogue de données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du stocker de données.
+ `WindowSize` – Nombre (entier), pas plus qu'Aucun.

  Durée de traitement de chaque micro lot.
+ `DetectSchema` : booléen.

  Indique s'il faut déterminer automatiquement le schéma à partir des données entrantes.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la base de données à partir de laquelle lire les données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données à partir de laquelle lire les données.
+ `StreamingOptions` – Un objet [KafkaStreamingSourceOptions](#aws-glue-api-visual-job-api-KafkaStreamingSourceOptions).

  Indique les options de streaming.
+ `DataPreviewOptions` – Un objet [StreamingDataPreviewOptions](#aws-glue-api-visual-job-api-StreamingDataPreviewOptions).

  Indique les options liées à la prévisualisation des données pour visualiser un échantillon de vos données.

## DirectKafkaSource structure
<a name="aws-glue-api-visual-job-api-DirectKafkaSource"></a>

Indique un stocker de données Apache Kafka.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du stocker de données.
+ `StreamingOptions` – Un objet [KafkaStreamingSourceOptions](#aws-glue-api-visual-job-api-KafkaStreamingSourceOptions).

  Indique les options de streaming.
+ `WindowSize` – Nombre (entier), pas plus qu'Aucun.

  Durée de traitement de chaque micro lot.
+ `DetectSchema` : booléen.

  Indique s'il faut déterminer automatiquement le schéma à partir des données entrantes.
+ `DataPreviewOptions` – Un objet [StreamingDataPreviewOptions](#aws-glue-api-visual-job-api-StreamingDataPreviewOptions).

  Indique les options liées à la prévisualisation des données pour visualiser un échantillon de vos données.

## KafkaStreamingSourceOptions structure
<a name="aws-glue-api-visual-job-api-KafkaStreamingSourceOptions"></a>

Options supplémentaires pour streaming.

**Champs**
+ `BootstrapServers` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Une liste de serveurs bootstrap URLs, par exemple, comme`b-1.vpc-test-2.o4q88o.c6.kafka.us-east-1.amazonaws.com:9094`. Cette option doit être spécifiée dans l'appel d'API ou définie dans les métadonnées de la table dans le catalogue de données.
+ `SecurityProtocol` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le protocole utilisé pour communiquer avec les agents. Les valeurs possibles sont `"SSL"` ou `"PLAINTEXT"`.
+ `ConnectionName` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Nom de la connexion.
+ `TopicName` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de rubrique tel que spécifié dans Apache Kafka. Vous devez Indiquer au moins un des éléments suivants : `"topicName"`, `"assign"` ou `"subscribePattern"`.
+ `Assign` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Les `TopicPartitions` spécifiques à consommer. Vous devez Indiquer au moins un des éléments suivants : `"topicName"`, `"assign"` ou `"subscribePattern"`.
+ `SubscribePattern` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Une chaîne d'expression rationnelle Java qui identifie la liste de rubriques à laquelle vous souhaitez vous abonner. Vous devez Indiquer au moins un des éléments suivants : `"topicName"`, `"assign"` ou `"subscribePattern"`.
+ `Classification` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Une classification facultative.
+ `Delimiter` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique le caractère délimiteur.
+ `StartingOffsets` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  La position de départ dans la rubrique Kafka à partir de laquelle lire les données. Les valeurs possibles sont `"earliest"` ou `"latest"`. La valeur par défaut est `"latest"`.
+ `EndingOffsets` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le point de fin lorsqu'une requête par lots est terminée. Les valeurs possibles sont `"latest"` ou une chaîne JSON qui Indique un décalage de fin pour chaque `TopicPartition`.
+ `PollTimeoutMs` – Nombre (long), pas plus qu'Aucun.

  Le délai d'attente en millisecondes pour interroger les données de Kafka dans les exécuteurs de tâches Spark. La valeur par défaut est `512`.
+ `NumRetries` – Nombre (entier), pas plus qu'Aucun.

  Le nombre de nouvelles tentatives avant de ne pas récupérer les décalages Kafka. La valeur par défaut est `3`.
+ `RetryIntervalMs` – Nombre (long), pas plus qu'Aucun.

  Temps d'attente en millisecondes avant d'essayer de récupérer les décalages Kafka. La valeur par défaut est `10`.
+ `MaxOffsetsPerTrigger` – Nombre (long), pas plus qu'Aucun.

  La limite de taux sur le nombre maximal de décalages qui sont traités par intervalle de déclenchement. Le nombre total spécifié de décalages est réparti proportionnellement entre les `topicPartitions` des différents volumes. La valeur par défaut est null, ce qui signifie que le consommateur lit tous les décalages jusqu'au dernier décalage connu.
+ `MinPartitions` – Nombre (entier), pas plus qu'Aucun.

  Le nombre minimum de partitions à lire à partir de Kafka. La valeur par défaut est nulle, ce qui signifie que le nombre de partitions Spark est égal au nombre de partitions Kafka.
+ `IncludeHeaders` : booléen.

  Indique s'il faut inclure les en-têtes Kafka. Lorsque l'option est définie sur « true » (vrai), la sortie de données contiendra une colonne supplémentaire nommée « glue\$1streaming\$1kafka\$1headers » avec le type `Array[Struct(key: String, value: String)]`. La valeur définie par défaut est « false ». Cette option n'est disponible que dans AWS Glue la version 3.0 ou ultérieure.
+ `AddRecordTimestamp` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Lorsque cette option est définie sur « true », la sortie de données contient une colonne supplémentaire nommée « \$1\$1src\$1timestamp » qui indique l'heure à laquelle l'enregistrement correspondant est reçu par la rubrique. La valeur par défaut est « false ». Cette option est prise en charge dans AWS Glue la version 4.0 ou ultérieure.
+ `EmitConsumerLagMetrics` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Lorsque cette option est définie sur « vrai », pour chaque lot, elle émet les métriques correspondant à la durée comprise entre le plus ancien enregistrement reçu par le sujet et le moment où il arrive CloudWatch. AWS Glue Le nom de la métrique est « glue.driver.streaming ». maxConsumerLagInMs». La valeur par défaut est « false ». Cette option est prise en charge dans AWS Glue version 4.0 ou ultérieure.
+ `StartingTimestamp` – Chaîne UTF-8.

  L'horodatage de l'enregistrement dans la rubrique Kafka à partir duquel les données doivent être lues. Les valeurs possibles sont une chaîne d'horodatage au format UTC du modèle `yyyy-mm-ddTHH:MM:SSZ` (où Z représente un décalage de fuseau horaire UTC avec un \$1/-. Par exemple : « 2023-04-04T08:00:00\$108:00 »). 

  Seul `StartingTimestamp` ou `StartingOffsets` doit être défini.

## RedshiftSource structure
<a name="aws-glue-api-visual-job-api-RedshiftSource"></a>

Indique un stocker de données Amazon Redshift.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom du stocker de données Amazon Redshift.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  La base de données à partir de laquelle lire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Table de base de données à lire.
+ `RedshiftTmpDir` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chemin Amazon S3 où les données temporaires peuvent être stockées lors de la copie à partir de la base de données.
+ `TmpDirIAMRole` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le rôle IAM avec les autorisations.

## AmazonRedshiftSource structure
<a name="aws-glue-api-visual-job-api-AmazonRedshiftSource"></a>

Indique une source Amazon Redshift.

**Champs**
+ `Name` – Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la source Amazon Redshift.
+ `Data` : un objet [AmazonRedshiftNodeData](#aws-glue-api-visual-job-api-AmazonRedshiftNodeData).

  Indique les données du nœud source Amazon Reshift.

## AmazonRedshiftNodeData structure
<a name="aws-glue-api-visual-job-api-AmazonRedshiftNodeData"></a>

Indique un nœud Amazon Redshift.

**Champs**
+ `AccessType` – Chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Le type d'accès pour la connexion Redshift. Il peut s'agir d'une connexion directe ou de connexions au catalogue.
+ `SourceType` – Chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Le type de source pour spécifier si une table spécifique est la source ou une requête personnalisée.
+ `Connection` : un objet [Option](#aws-glue-api-visual-job-api-Option).

  La AWS Glue connexion au cluster Redshift.
+ `Schema` : un objet [Option](#aws-glue-api-visual-job-api-Option).

  Le nom du schéma Redshift lorsque vous travaillez avec une connexion directe.
+ `Table` : un objet [Option](#aws-glue-api-visual-job-api-Option).

  Le nom de la table Redshift lorsque vous travaillez avec une connexion directe.
+ `CatalogDatabase` : un objet [Option](#aws-glue-api-visual-job-api-Option).

  Nom de la base de AWS Glue données du catalogue de données lorsque vous travaillez avec un catalogue de données.
+ `CatalogTable` : un objet [Option](#aws-glue-api-visual-job-api-Option).

  Le nom de la table du catalogue de AWS Glue données lorsque vous travaillez avec un catalogue de données.
+ `CatalogRedshiftSchema` – Chaîne UTF-8.

  Le nom du schéma Redshift lorsque vous travaillez avec un catalogue de données.
+ `CatalogRedshiftTable` – Chaîne UTF-8.

  Table de base de données à lire.
+ `TempDir` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chemin Amazon S3 où les données temporaires peuvent être stockées lors de la copie à partir de la base de données.
+ `IamRole` : un objet [Option](#aws-glue-api-visual-job-api-Option).

  Facultatif. Le nom de rôle utilisé lors de la connexion à S3. Le rôle IAM sera remplacé par défaut par le rôle sur la tâche lorsque ce champ est laissé vide.
+ `AdvancedOptions` : un tableau d’objets [AmazonRedshiftAdvancedOption](#aws-glue-api-visual-job-api-AmazonRedshiftAdvancedOption).

  Les valeurs facultatives lors de la connexion au cluster Redshift.
+ `SampleQuery` – Chaîne UTF-8.

  Le code SQL utilisé pour récupérer les données d'une source Redshift lorsqu'il SourceType s'agit d'une « requête ».
+ `PreAction` – Chaîne UTF-8.

  Le code SQL utilisé avant l'exécution d'une opération MERGE ou APPEND avec insertion.
+ `PostAction` – Chaîne UTF-8.

  Le code SQL utilisé avant l'exécution d'une opération MERGE ou APPEND avec insertion.
+ `Action` – Chaîne UTF-8.

  Indique comment l'écriture dans un cluster Redshift se fera.
+ `TablePrefix` – Chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Indique le préfixe d'une table.
+ `Upsert` : booléen.

  L'action utilisée sur les récepteurs Redshift lorsque vous effectuez une opération APPEND.
+ `MergeAction` – Chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  L'action utilisée pour déterminer comment une opération MERGE dans un récepteur Redshift sera traitée.
+ `MergeWhenMatched` – Chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  L'action utilisée pour déterminer comment une opération MERGE dans un récepteur Redshift sera traitée lorsqu'un enregistrement existant correspond à un nouvel enregistrement.
+ `MergeWhenNotMatched` – Chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  L'action utilisée pour déterminer comment une opération MERGE dans un récepteur Redshift sera traitée lorsqu'un enregistrement existant ne correspond pas à un nouvel enregistrement.
+ `MergeClause` – Chaîne UTF-8.

  Le code SQL utilisé dans une fusion personnalisée pour traiter les enregistrements correspondants.
+ `CrawlerConnection` – Chaîne UTF-8.

  Indique le nom de la connexion associée à la table de catalogue utilisée.
+ `TableSchema` : un tableau d’objets [Option](#aws-glue-api-visual-job-api-Option).

  Le tableau de sortie du schéma pour un nœud donné.
+ `StagingTable` – Chaîne UTF-8.

  Le nom de la table intermédiaire temporaire utilisée lors d'une opération MERGE ou APPEND avec insertion.
+ `SelectedColumns` : un tableau d’objets [Option](#aws-glue-api-visual-job-api-Option).

  La liste des noms de colonnes utilisée pour déterminer un enregistrement correspondant lors d'une opération MERGE ou APPEND avec insertion.

## AmazonRedshiftAdvancedOption structure
<a name="aws-glue-api-visual-job-api-AmazonRedshiftAdvancedOption"></a>

Indique une valeur facultative lors de la connexion au cluster Redshift.

**Champs**
+ `Key` – Chaîne UTF-8.

  La clé de l'option de connexion supplémentaire.
+ `Value` – Chaîne UTF-8.

  La valeur de l'option de connexion supplémentaire.

## Structure de l'option
<a name="aws-glue-api-visual-job-api-Option"></a>

Indique une valeur d'option.

**Champs**
+ `Value` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique la valeur de l'option.
+ `Label` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique l'étiquette de l'option.
+ `Description` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique la description de l'option.

## CatalogSource Structure S3
<a name="aws-glue-api-visual-job-api-S3CatalogSource"></a>

Spécifie un magasin de données Amazon S3 dans le catalogue de AWS Glue données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du stocker de données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  La base de données à partir de laquelle lire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Table de base de données à lire.
+ `PartitionPredicate` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Les partitions satisfaisant à ce prédicat sont supprimées. Les fichiers qui se situent dans la période de conservation pour ces partitions ne sont pas supprimés. Valeur définie sur `""` – vide par défaut.
+ `AdditionalOptions` – Un objet [S3 SourceAdditionalOptions](#aws-glue-api-visual-job-api-S3SourceAdditionalOptions).

  Indique des options de connexion supplémentaires.

## SourceAdditionalOptions Structure S3
<a name="aws-glue-api-visual-job-api-S3SourceAdditionalOptions"></a>

Indique des options de connexion supplémentaires pour le stocker de données Amazon S3.

**Champs**
+ `BoundedSize` – Nombre (long).

  Définit la limite supérieure de la dimension cible du jeu de données en octets à traiter.
+ `BoundedFiles` – Nombre (long).

  Définit la limite supérieure du nombre cible de fichiers à traiter.

## CsvSource Structure S3
<a name="aws-glue-api-visual-job-api-S3CsvSource"></a>

Indique un stocker de données CSV (valeurs séparées par commande) stocké dans Amazon S3.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du stocker de données.
+ `Paths` – *Obligatoire :* Tableau de chaînes UTF-8.

  Une liste de chemins Amazon S3 à lire.
+ `CompressionType` – Chaîne UTF-8 (valeurs valides : `gzip="GZIP"` \$1 `bzip2="BZIP2"`).

  Indique la manière dont les données sont comprimées. Ce n'est généralement pas nécessaire si le fichier de données a une extension standard. Les valeurs possibles sont `"gzip"` et `"bzip"`).
+ `Exclusions` – Tableau de chaînes UTF-8.

  Une chaîne contenant une liste JSON des modèles glob de style Unix à exclure. Par exemple, [\$1"\$1\$1.pdf\$1"] permet d'exclure tous les fichiers PDF. 
+ `GroupSize` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  La dimension du groupe cible, en octets. La valeur par défaut est calculée en fonction de la dimension des données en entrée et de la dimension de votre cluster. Lorsqu'il y a moins de 50 000 fichiers en entrée, `"groupFiles"` doit être défini sur `"inPartition"` pour que cela prenne effet.
+ `GroupFiles` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le groupement de fichiers est activé par défaut lorsque l'entrée contient plus de 50 000 fichiers. Pour activer le groupement lorsqu'il y a moins de 50 000 fichiers, définissez ce paramètre sur « inPartition ». Pour désactiver le groupement lorsqu'il y a plus de 50 000 fichiers, définissez ce paramètre sur `"none"`.
+ `Recurse` : booléen.

  Si ce paramètre est défini sur « VRAI », les fichiers sont lus de manière récursive dans tous les sous-répertoires des chemins spécifiés.
+ `MaxBand` – Nombre (entier), pas plus qu'Aucun.

  Cette option permet de contrôler la durée, en millisecondes, au delà de laquelle la liste S3 est susceptible d'être cohérente. Les fichiers dont l'horodatage des modifications se situe dans les dernières millisecondes de MaxBand sont suivis, en particulier lors de leur utilisation, afin de tenir compte de la cohérence éventuelle JobBookmarks d'Amazon S3. La plupart des utilisateurs n'ont pas besoin de définir cette option. La valeur par défaut est 900 000 millisecondes, soit 15 minutes.
+ `MaxFilesInBand` – Nombre (entier), pas plus qu'Aucun.

  Cette option Indique le nombre maximal de fichiers à enregistrer à partir des dernières secondes maxBand. Si ce nombre est dépassé, les fichiers supplémentaires sont ignorés et traités dans l'exécution de tâche suivante.
+ `AdditionalOptions` – Un objet [S3 DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions).

  Indique des options de connexion supplémentaires.
+ `Separator` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `comma="COMMA"` \$1 `ctrla="CTRLA"` \$1 `pipe="PIPE"` \$1 `semicolon="SEMICOLON"` \$1 `tab="TAB"`).

  Indique le caractère délimiteur. La valeur par défaut est une virgule : « , », mais tout autre caractère peut être spécifié.
+ `Escaper` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique le caractère à utiliser pour l'échappement. Cette option est utilisée uniquement lors de la lecture de fichiers CSV. La valeur par défaut est `none`. Si cette option est activée, le caractère suivant est immédiatement utilisé tel quel, sauf pour un petit ensemble d'échappements connus (`\n`, `\r`, `\t` et `\0`).
+ `QuoteChar` – *Obligatoire* :Chaîne UTF-8 (valeurs valides : `quote="QUOTE"` \$1 `quillemet="QUILLEMET"` \$1 `single_quote="SINGLE_QUOTE"` \$1 `disabled="DISABLED"`).

  Indique le caractère à utiliser pour les guillemets. La valeur par défaut est les guillemets doubles : `'"'`. Définissez ce champ sur `-1` pour désactiver entièrement les guillemets.
+ `Multiline` : booléen.

  Une valeur booléenne qui indique si un même registre peut couvrir plusieurs lignes. Cela peut se produire lorsqu’un champ contient un caractère de nouvelle ligne. Vous devez définir cette option sur « VRAI » si aucun registre ne s'étend sur plusieurs lignes. La valeur par défaut est `False`, qui permet un fractionnement en fichiers plus intense pendant l'analyse.
+ `WithHeader` : booléen.

  Une valeur booléenne qui indique s'il convient de traiter la première ligne comme un en-tête. La valeur par défaut est `False`.
+ `WriteHeader` : booléen.

  Une valeur booléenne qui indique s'il faut écrire l'en-tête dans la sortie. La valeur par défaut est `True`. 
+ `SkipFirst` : booléen.

  Une valeur booléenne qui indique s'il faut ignorer la première ligne de données. La valeur par défaut est `False`.
+ `OptimizePerformance` : booléen.

  Une valeur booléenne qui indique s'il faut utiliser le lecteur CSV SIMD avancé avec les formats de mémoire en colonnes basés sur Apache Arrow. Disponible uniquement dans AWS Glue la version 3.0.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la source S3 CSV.

## JDBCSource Structure directe
<a name="aws-glue-api-visual-job-api-DirectJDBCSource"></a>

Indique la connexion directe à la source JDBC.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la connexion à la source JDBC.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Base de données de la connexion à la source JDBC.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Table de la connexion à la source JDBC.
+ `ConnectionName` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Nom de connexion de la source JDBC.
+ `ConnectionType` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `sqlserver` \$1 `mysql` \$1 `oracle` \$1 `postgresql` \$1 `redshift`).

  Type de connexion de la source JDBC.
+ `RedshiftTmpDir` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Répertoire temporaire de la source JDBC Redshift.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la source JDBC directe.

## DirectSourceAdditionalOptions Structure S3
<a name="aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions"></a>

Indique des options de connexion supplémentaires pour le stocker de données Amazon S3.

**Champs**
+ `BoundedSize` – Nombre (long).

  Définit la limite supérieure de la dimension cible du jeu de données en octets à traiter.
+ `BoundedFiles` – Nombre (long).

  Définit la limite supérieure du nombre cible de fichiers à traiter.
+ `EnableSamplePath` : booléen.

  Définit l'option d'activation d'un exemple de chemin.
+ `SamplePath` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Si cette option est activée, elle indique l'exemple de chemin.

## JsonSource Structure S3
<a name="aws-glue-api-visual-job-api-S3JsonSource"></a>

Indique un stocker de données JSON stocké dans Amazon S3.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du stocker de données.
+ `Paths` – *Obligatoire :* Tableau de chaînes UTF-8.

  Une liste de chemins Amazon S3 à lire.
+ `CompressionType` – Chaîne UTF-8 (valeurs valides : `gzip="GZIP"` \$1 `bzip2="BZIP2"`).

  Indique la manière dont les données sont comprimées. Ce n'est généralement pas nécessaire si le fichier de données a une extension standard. Les valeurs possibles sont `"gzip"` et `"bzip"`).
+ `Exclusions` – Tableau de chaînes UTF-8.

  Une chaîne contenant une liste JSON des modèles glob de style Unix à exclure. Par exemple, [\$1"\$1\$1.pdf\$1"] permet d'exclure tous les fichiers PDF. 
+ `GroupSize` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  La dimension du groupe cible, en octets. La valeur par défaut est calculée en fonction de la dimension des données en entrée et de la dimension de votre cluster. Lorsqu'il y a moins de 50 000 fichiers en entrée, `"groupFiles"` doit être défini sur `"inPartition"` pour que cela prenne effet.
+ `GroupFiles` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le groupement de fichiers est activé par défaut lorsque l'entrée contient plus de 50 000 fichiers. Pour activer le groupement lorsqu'il y a moins de 50 000 fichiers, définissez ce paramètre sur « inPartition ». Pour désactiver le groupement lorsqu'il y a plus de 50 000 fichiers, définissez ce paramètre sur `"none"`.
+ `Recurse` : booléen.

  Si ce paramètre est défini sur « VRAI », les fichiers sont lus de manière récursive dans tous les sous-répertoires des chemins spécifiés.
+ `MaxBand` – Nombre (entier), pas plus qu'Aucun.

  Cette option permet de contrôler la durée, en millisecondes, au delà de laquelle la liste S3 est susceptible d'être cohérente. Les fichiers dont l'horodatage des modifications se situe dans les dernières millisecondes de MaxBand sont suivis, en particulier lors de leur utilisation, afin de tenir compte de la cohérence éventuelle JobBookmarks d'Amazon S3. La plupart des utilisateurs n'ont pas besoin de définir cette option. La valeur par défaut est 900 000 millisecondes, soit 15 minutes.
+ `MaxFilesInBand` – Nombre (entier), pas plus qu'Aucun.

  Cette option Indique le nombre maximal de fichiers à enregistrer à partir des dernières secondes maxBand. Si ce nombre est dépassé, les fichiers supplémentaires sont ignorés et traités dans l'exécution de tâche suivante.
+ `AdditionalOptions` – Un objet [S3 DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions).

  Indique des options de connexion supplémentaires.
+ `JsonPath` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

   JsonPath Chaîne définissant les données JSON.
+ `Multiline` : booléen.

  Une valeur booléenne qui indique si un même registre peut couvrir plusieurs lignes. Cela peut se produire lorsqu’un champ contient un caractère de nouvelle ligne. Vous devez définir cette option sur « VRAI » si aucun registre ne s'étend sur plusieurs lignes. La valeur par défaut est `False`, qui permet un fractionnement en fichiers plus intense pendant l'analyse.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la source S3 JSON.

## ParquetSource Structure S3
<a name="aws-glue-api-visual-job-api-S3ParquetSource"></a>

Indique un stocker de données Apache Parquet stocké dans Amazon S3.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du stocker de données.
+ `Paths` – *Obligatoire :* Tableau de chaînes UTF-8.

  Une liste de chemins Amazon S3 à lire.
+ `CompressionType` – Chaîne UTF-8 (valeurs valides: `snappy="SNAPPY"` \$1 `lzo="LZO"` \$1 `gzip="GZIP"` \$1 `brotli="BROTLI"` \$1 `lz4="LZ4"` \$1 `uncompressed="UNCOMPRESSED"` \$1 `none="NONE"`).

  Indique la manière dont les données sont comprimées. Ce n'est généralement pas nécessaire si le fichier de données a une extension standard. Les valeurs possibles sont `"gzip"` et `"bzip"`).
+ `Exclusions` – Tableau de chaînes UTF-8.

  Une chaîne contenant une liste JSON des modèles glob de style Unix à exclure. Par exemple, [\$1"\$1\$1.pdf\$1"] permet d'exclure tous les fichiers PDF. 
+ `GroupSize` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  La dimension du groupe cible, en octets. La valeur par défaut est calculée en fonction de la dimension des données en entrée et de la dimension de votre cluster. Lorsqu'il y a moins de 50 000 fichiers en entrée, `"groupFiles"` doit être défini sur `"inPartition"` pour que cela prenne effet.
+ `GroupFiles` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le groupement de fichiers est activé par défaut lorsque l'entrée contient plus de 50 000 fichiers. Pour activer le groupement lorsqu'il y a moins de 50 000 fichiers, définissez ce paramètre sur « inPartition ». Pour désactiver le groupement lorsqu'il y a plus de 50 000 fichiers, définissez ce paramètre sur `"none"`.
+ `Recurse` : booléen.

  Si ce paramètre est défini sur « VRAI », les fichiers sont lus de manière récursive dans tous les sous-répertoires des chemins spécifiés.
+ `MaxBand` – Nombre (entier), pas plus qu'Aucun.

  Cette option permet de contrôler la durée, en millisecondes, au delà de laquelle la liste S3 est susceptible d'être cohérente. Les fichiers dont l'horodatage des modifications se situe dans les dernières millisecondes de MaxBand sont suivis, en particulier lors de leur utilisation, afin de tenir compte de la cohérence éventuelle JobBookmarks d'Amazon S3. La plupart des utilisateurs n'ont pas besoin de définir cette option. La valeur par défaut est 900 000 millisecondes, soit 15 minutes.
+ `MaxFilesInBand` – Nombre (entier), pas plus qu'Aucun.

  Cette option Indique le nombre maximal de fichiers à enregistrer à partir des dernières secondes maxBand. Si ce nombre est dépassé, les fichiers supplémentaires sont ignorés et traités dans l'exécution de tâche suivante.
+ `AdditionalOptions` – Un objet [S3 DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions).

  Indique des options de connexion supplémentaires.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la source S3 Parquet.

## DeltaSource Structure S3
<a name="aws-glue-api-visual-job-api-S3DeltaSource"></a>

Spécifie une source de données Delta Lake stockée dans Amazon S3.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la source de Delta Lake.
+ `Paths` – *Obligatoire :* Tableau de chaînes UTF-8.

  Une liste de chemins Amazon S3 à lire.
+ `AdditionalDeltaOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique des options de connexion supplémentaires.
+ `AdditionalOptions` – Un objet [S3 DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions).

  Indique les options supplémentaires du connecteur.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la source Delta Lake.

## CatalogDeltaSource Structure S3
<a name="aws-glue-api-visual-job-api-S3CatalogDeltaSource"></a>

Spécifie une source de données Delta Lake enregistrée dans le catalogue de AWS Glue données. La source de données doit être stockée dans Amazon S3.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la source de données Delta Lake.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données à partir de laquelle lire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la base de données à partir de laquelle lire les données.
+ `AdditionalDeltaOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique des options de connexion supplémentaires.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la source Delta Lake.

## CatalogDeltaSource structure
<a name="aws-glue-api-visual-job-api-CatalogDeltaSource"></a>

Spécifie une source de données Delta Lake enregistrée dans le catalogue de AWS Glue données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la source de données Delta Lake.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données à partir de laquelle lire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la base de données à partir de laquelle lire les données.
+ `AdditionalDeltaOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique des options de connexion supplémentaires.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la source Delta Lake.

## HudiSource Structure S3
<a name="aws-glue-api-visual-job-api-S3HudiSource"></a>

Spécifie une source de données Hudi stockée dans. Amazon S3

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source Hudi.
+ `Paths` – *Obligatoire :* Tableau de chaînes UTF-8.

  Une liste de chemins Amazon S3 à lire.
+ `AdditionalHudiOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique des options de connexion supplémentaires.
+ `AdditionalOptions` – Un objet [S3 DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions).

  Indique les options supplémentaires du connecteur.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la source Hudi.

## CatalogHudiSource Structure S3
<a name="aws-glue-api-visual-job-api-S3CatalogHudiSource"></a>

Spécifie une source de données Hudi enregistrée dans le catalogue de AWS Glue données. La source de données Hudi doit être stockée dans Amazon S3.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source de données Hudi.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données à partir de laquelle lire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la base de données à partir de laquelle lire les données.
+ `AdditionalHudiOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique des options de connexion supplémentaires.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la source Hudi.

## ExcelSource Structure S3
<a name="aws-glue-api-visual-job-api-S3ExcelSource"></a>

Spécifie une source de données S3 Excel.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source de données S3 Excel.
+ `Paths` – *Obligatoire :* Tableau de chaînes UTF-8.

  Chemins S3 où se trouvent les fichiers Excel.
+ `CompressionType` – Chaîne UTF-8 (valeurs valides: `snappy="SNAPPY"` \$1 `lzo="LZO"` \$1 `gzip="GZIP"` \$1 `brotli="BROTLI"` \$1 `lz4="LZ4"` \$1 `uncompressed="UNCOMPRESSED"` \$1 `none="NONE"`).

  Format de compression utilisé pour les fichiers Excel.
+ `Exclusions` – Tableau de chaînes UTF-8.

  Modèles permettant d’exclure des fichiers ou des chemins spécifiques du traitement.
+ `GroupSize` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Définit la taille des groupes de fichiers pour le traitement par lots.
+ `GroupFiles` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Spécifie la manière dont les fichiers doivent être regroupés pour être traités.
+ `Recurse` : booléen.

  Indique s’il faut traiter les sous-répertoires de manière récursive.
+ `MaxBand` – Nombre (entier), pas plus qu'Aucun.

  Nombre maximal de bandes de traitement à utiliser.
+ `MaxFilesInBand` – Nombre (entier), pas plus qu'Aucun.

  Nombre maximal de fichiers à traiter dans chaque bande.
+ `AdditionalOptions` – Un objet [S3 DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions).

  Options de configuration supplémentaires pour le traitement direct des sources dans S3.
+ `NumberRows` – Nombre (long).

  Nombre de lignes à traiter dans chaque fichier Excel.
+ `SkipFooter` – Nombre (entier), pas plus qu'Aucun.

  Nombre de lignes à ignorer à la fin de chaque fichier Excel.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Les AWS Glue schémas à appliquer aux données traitées.

## CatalogHudiSource structure
<a name="aws-glue-api-visual-job-api-CatalogHudiSource"></a>

Spécifie une source de données Hudi enregistrée dans le catalogue de AWS Glue données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source de données Hudi.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données à partir de laquelle lire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la base de données à partir de laquelle lire les données.
+ `AdditionalHudiOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique des options de connexion supplémentaires.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la source Hudi.

## Structure de Dynamo DBCatalog Source
<a name="aws-glue-api-visual-job-api-DynamoDBCatalogSource"></a>

Spécifie une source de données DynamoDB dans AWS Glue le catalogue de données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source de données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données à partir de laquelle lire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la base de données à partir de laquelle lire les données.
+ `PitrEnabled` : booléen.

  Spécifie si Point-in-Time la restauration (PITR) est activée pour la table DynamoDB. Lorsque ce paramètre est défini sur `true`, cela permet la lecture à un moment précis dans le temps. La valeur par défaut est `false`.
+ `AdditionalOptions` – Un objet [DDBELTCatalogAdditionalOptions](#aws-glue-api-visual-job-api-DDBELTCatalogAdditionalOptions).

  Indique des options de connexion supplémentaires pour la source de données DynamoDB.

## RelationalCatalogSource structure
<a name="aws-glue-api-visual-job-api-RelationalCatalogSource"></a>

Indique une source de données de base de données relationnelle dans le catalogue de données AWS Glue .

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source de données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données à partir de laquelle lire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la base de données à partir de laquelle lire les données.

## JDBCConnectorStructure de la cible
<a name="aws-glue-api-visual-job-api-JDBCConnectorTarget"></a>

Indique une cible de données qui écrit sur Amazon S3 dans un stockage en colonnes Apache Parquet.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `ConnectionName` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la connexion associée au connecteur.
+ `ConnectionTable` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la cible de données.
+ `ConnectorName` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom d'un connecteur qui sera utilisé.
+ `ConnectionType` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Type de connexion, tel que marketplace.jdbc ou custom.jdbc, désignant une connexion à une cible de données JDBC.
+ `AdditionalOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Options de connexion supplémentaires pour le connecteur.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la cible JDBC.

## SparkConnectorTarget structure
<a name="aws-glue-api-visual-job-api-SparkConnectorTarget"></a>

Indique une cible qui utilise un connecteur Apache Spark.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `ConnectionName` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom d'une connexion pour un connecteur Apache Spark.
+ `ConnectorName` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom d'un connecteur Apache Spark.
+ `ConnectionType` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Type de connexion, tel que marketplace.spark ou custom.spark, désignant une connexion à un stocker de données Apache Spark.
+ `AdditionalOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Options de connexion supplémentaires pour le connecteur.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la cible Spark personnalisée.

## BasicCatalogTarget structure
<a name="aws-glue-api-visual-job-api-BasicCatalogTarget"></a>

Spécifie une cible qui utilise une table AWS Glue de catalogue de données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de votre cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `PartitionKeys` – Tableau de chaînes UTF-8.

  Les clés de partition utilisées pour distribuer les données sur plusieurs partitions en fonction d’une clé ou d’un ensemble de clés spécifique.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  La base de données où se trouve la table que vous souhaitez utiliser comme cible. Cette base de données doit déjà exister dans le catalogue de données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  La table qui définit le schéma de vos données de sortie. Cette table doit déjà exister dans le catalogue de données..

## Structure de My SQLCatalog Target
<a name="aws-glue-api-visual-job-api-MySQLCatalogTarget"></a>

Indique une cible qui utilise MySQL.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données dans laquelle écrire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table de la base de données dans laquelle écrire les données.

## Structure de SQLCatalog PostgreTarget
<a name="aws-glue-api-visual-job-api-PostgreSQLCatalogTarget"></a>

Indique une cible qui utilise Postgre SQL.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données dans laquelle écrire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table de la base de données dans laquelle écrire les données.

## Structure d'Oracle SQLCatalog Target
<a name="aws-glue-api-visual-job-api-OracleSQLCatalogTarget"></a>

Indique une cible qui utilise Oracle SQL.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données dans laquelle écrire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table de la base de données dans laquelle écrire les données.

## SQLServerCatalogTarget Structure de Microsoft
<a name="aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogTarget"></a>

Indique une cible qui utilise Microsoft SQL.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données dans laquelle écrire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table de la base de données dans laquelle écrire les données.

## RedshiftTarget structure
<a name="aws-glue-api-visual-job-api-RedshiftTarget"></a>

Indique une cible qui utilise Amazon Redshift.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données dans laquelle écrire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table de la base de données dans laquelle écrire les données.
+ `RedshiftTmpDir` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chemin Amazon S3 où les données temporaires peuvent être stockées lors de la copie à partir de la base de données.
+ `TmpDirIAMRole` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le rôle IAM avec les autorisations.
+ `UpsertRedshiftOptions` : un objet [UpsertRedshiftTargetOptions](#aws-glue-api-visual-job-api-UpsertRedshiftTargetOptions).

  Jeu d'options permettant de configurer une opération de mise à jour/insertion lors de l'écriture vers une cible Redshift.

## AmazonRedshiftTarget structure
<a name="aws-glue-api-visual-job-api-AmazonRedshiftTarget"></a>

Indique une cible Amazon Redshift.

**Champs**
+ `Name` – Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible Amazon Redshift.
+ `Data` : un objet [AmazonRedshiftNodeData](#aws-glue-api-visual-job-api-AmazonRedshiftNodeData).

  Indique les données du nœud cible Amazon Redshift.
+ `Inputs` : tableau de chaînes UTF-8, avec une chaîne minimum et une chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.

## UpsertRedshiftTargetOptions structure
<a name="aws-glue-api-visual-job-api-UpsertRedshiftTargetOptions"></a>

Options permettant de configurer une opération de mise à jour/insertion lors de l'écriture vers une cible Redshift.

**Champs**
+ `TableLocation` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Emplacement physique de la table Redshift.
+ `ConnectionName` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Nom de la connexion à utiliser pour écrire dans Redshift.
+ `UpsertKeys` – Tableau de chaînes UTF-8.

  Clés utilisées pour déterminer si une opération de mise à jour ou d'insertion est nécessaire.

## CatalogTarget Structure S3
<a name="aws-glue-api-visual-job-api-S3CatalogTarget"></a>

Spécifie une cible de données qui écrit sur Amazon S3 à l'aide du catalogue de AWS Glue données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `PartitionKeys` – Tableau de chaînes UTF-8.

  Indique le partitionnement natif à l'aide d'une séquence de clés.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table de la base de données dans laquelle écrire les données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données dans laquelle écrire les données.
+ `SchemaChangePolicy` – Un objet [CatalogSchemaChangePolicy](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy).

  Une politique qui indique les évolutions de mise à jour pour le crawler.
+ `AutoDataQuality` : un objet [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality).

  Indique s’il faut activer automatiquement l’évaluation de la qualité des données pour la cible du catalogue S3. Lorsque ce paramètre est défini sur `true`, les contrôles de qualité des données sont effectués automatiquement pendant l’opération d’écriture.

## GlueParquetTarget Structure S3
<a name="aws-glue-api-visual-job-api-S3GlueParquetTarget"></a>

Indique une cible de données qui écrit sur Amazon S3 dans un stockage en colonnes Apache Parquet.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `PartitionKeys` – Tableau de chaînes UTF-8.

  Indique le partitionnement natif à l'aide d'une séquence de clés.
+ `Path` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Un seul chemin Amazon S3 sur lequel écrire.
+ `Compression` – Chaîne UTF-8 (valeurs valides: `snappy="SNAPPY"` \$1 `lzo="LZO"` \$1 `gzip="GZIP"` \$1 `brotli="BROTLI"` \$1 `lz4="LZ4"` \$1 `uncompressed="UNCOMPRESSED"` \$1 `none="NONE"`).

  Indique la manière dont les données sont comprimées. Ce n'est généralement pas nécessaire si le fichier de données a une extension standard. Les valeurs possibles sont `"gzip"` et `"bzip"`).
+ `NumberTargetPartitions` – Chaîne UTF-8.

  Indique le nombre de partitions cible pour les fichiers Parquet lorsque vous écrivez vers Amazon S3 à l’aide d’ AWS Glue.
+ `SchemaChangePolicy` – Un objet [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy).

  Une politique qui indique les évolutions de mise à jour pour le crawler.
+ `AutoDataQuality` : un objet [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality).

  Spécifie s'il faut activer automatiquement l'évaluation de la qualité des données pour la cible S3 AWS Glue Parquet. Lorsque ce paramètre est défini sur `true`, les contrôles de qualité des données sont effectués automatiquement pendant l’opération d’écriture.

## CatalogSchemaChangePolicy structure
<a name="aws-glue-api-visual-job-api-CatalogSchemaChangePolicy"></a>

Une politique qui indique des comportements de mise à jour pour l'crawler.

**Champs**
+ `EnableUpdateCatalog` : booléen.

  S'il faut utiliser ou non le comportement de mise à jour spécifié lorsque l'crawler détecte un schéma modifié.
+ `UpdateBehavior` – Chaîne UTF-8 (valeurs valides : `UPDATE_IN_DATABASE` \$1 `LOG`).

  Comportement de mise à jour lorsque le crawler détecte un schéma modifié.

## DirectTarget Structure S3
<a name="aws-glue-api-visual-job-api-S3DirectTarget"></a>

Indique une cible de données qui écrit dans Amazon S3.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `PartitionKeys` – Tableau de chaînes UTF-8.

  Indique le partitionnement natif à l'aide d'une séquence de clés.
+ `Path` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Un seul chemin Amazon S3 sur lequel écrire.
+ `Compression` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique la manière dont les données sont comprimées. Ce n'est généralement pas nécessaire si le fichier de données a une extension standard. Les valeurs possibles sont `"gzip"` et `"bzip"`).
+ `NumberTargetPartitions` – Chaîne UTF-8.

  Indique le nombre de partitions cible lorsque vous écrivez directement vers Amazon S3.
+ `Format` – *Obligatoire :* chaîne UTF-8 (valeurs valides : `json="JSON"` \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` \$1 `iceberg="ICEBERG"` \$1 `hyper="HYPER"` \$1 `xml="XML"`).

  Définit le format de sortie des données pour la cible.
+ `SchemaChangePolicy` – Un objet [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy).

  Une politique qui indique les évolutions de mise à jour pour le crawler.
+ `AutoDataQuality` : un objet [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality).

  Indique s’il faut activer automatiquement l’évaluation de la qualité des données pour la cible directe S3. Lorsque ce paramètre est défini sur `true`, les contrôles de qualité des données sont effectués automatiquement pendant l’opération d’écriture.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la cible directe S3.

## HudiCatalogTarget Structure S3
<a name="aws-glue-api-visual-job-api-S3HudiCatalogTarget"></a>

Spécifie une cible qui écrit dans une source de données Hudi du catalogue de AWS Glue données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `PartitionKeys` – Tableau de chaînes UTF-8.

  Indique le partitionnement natif à l'aide d'une séquence de clés.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table de la base de données dans laquelle écrire les données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données dans laquelle écrire les données.
+ `AdditionalOptions` – *obligatoire :* tableau de mappage de paires clé-valeur.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique des options de connexion supplémentaires pour le connecteur.
+ `SchemaChangePolicy` – Un objet [CatalogSchemaChangePolicy](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy).

  Une politique qui indique les évolutions de mise à jour pour le crawler.
+ `AutoDataQuality` : un objet [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality).

  Indique s’il faut activer automatiquement l’évaluation de la qualité des données pour la cible du catalogue S3 Hudi. Lorsque ce paramètre est défini sur `true`, les contrôles de qualité des données sont effectués automatiquement pendant l’opération d’écriture.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la cible du catalogue S3 Hudi.

## HudiDirectTarget Structure S3
<a name="aws-glue-api-visual-job-api-S3HudiDirectTarget"></a>

Spécifie une cible qui écrit dans une source de données Hudi en Amazon S3.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `Path` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le chemin d'accès Amazon S3 de votre source de données Hudi sur laquelle écrire.
+ `Compression` – *Obligatoire* :Chaîne UTF-8 (valeurs valides : `gzip="GZIP"` \$1 `lzo="LZO"` \$1 `uncompressed="UNCOMPRESSED"` \$1 `snappy="SNAPPY"`).

  Indique la manière dont les données sont comprimées. Ce n'est généralement pas nécessaire si le fichier de données a une extension standard. Les valeurs possibles sont `"gzip"` et `"bzip"`).
+ `NumberTargetPartitions` – Chaîne UTF-8.

  Indique le nombre de partitions cible pour distribuer les fichiers de jeux de données Hudi sur Amazon S3.
+ `PartitionKeys` – Tableau de chaînes UTF-8.

  Indique le partitionnement natif à l'aide d'une séquence de clés.
+ `Format` – *Obligatoire :* chaîne UTF-8 (valeurs valides : `json="JSON"` \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` \$1 `iceberg="ICEBERG"` \$1 `hyper="HYPER"` \$1 `xml="XML"`).

  Définit le format de sortie des données pour la cible.
+ `AdditionalOptions` – *obligatoire :* tableau de mappage de paires clé-valeur.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique des options de connexion supplémentaires pour le connecteur.
+ `SchemaChangePolicy` – Un objet [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy).

  Une politique qui indique les évolutions de mise à jour pour le crawler.
+ `AutoDataQuality` : un objet [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality).

  Indique s’il faut activer automatiquement l’évaluation de la qualité des données pour la cible directe S3 Hudi. Lorsque ce paramètre est défini sur `true`, les contrôles de qualité des données sont effectués automatiquement pendant l’opération d’écriture.

## DeltaCatalogTarget Structure S3
<a name="aws-glue-api-visual-job-api-S3DeltaCatalogTarget"></a>

Spécifie une cible qui écrit dans une source de données Delta Lake dans le catalogue de AWS Glue données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `PartitionKeys` – Tableau de chaînes UTF-8.

  Indique le partitionnement natif à l'aide d'une séquence de clés.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table de la base de données dans laquelle écrire les données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données dans laquelle écrire les données.
+ `AdditionalOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique des options de connexion supplémentaires pour le connecteur.
+ `SchemaChangePolicy` – Un objet [CatalogSchemaChangePolicy](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy).

  Une politique qui indique les évolutions de mise à jour pour le crawler.
+ `AutoDataQuality` : un objet [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality).

  Indique s’il faut activer automatiquement l’évaluation de la qualité des données pour la cible du catalogue S3 Delta. Lorsque ce paramètre est défini sur `true`, les contrôles de qualité des données sont effectués automatiquement pendant l’opération d’écriture.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la cible du catalogue S3 Delta.

## DeltaDirectTarget Structure S3
<a name="aws-glue-api-visual-job-api-S3DeltaDirectTarget"></a>

Spécifie une cible qui écrit dans une source de données de Delta Lake en Amazon S3.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `PartitionKeys` – Tableau de chaînes UTF-8.

  Indique le partitionnement natif à l'aide d'une séquence de clés.
+ `Path` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le chemin d'accès Amazon S3 de votre source de données Delta Lake sur laquelle écrire.
+ `Compression` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `uncompressed="UNCOMPRESSED"` \$1 `snappy="SNAPPY"`).

  Indique la manière dont les données sont comprimées. Ce n'est généralement pas nécessaire si le fichier de données a une extension standard. Les valeurs possibles sont `"gzip"` et `"bzip"`).
+ `NumberTargetPartitions` – Chaîne UTF-8.

  Indique le nombre de partitions cible pour distribuer les fichiers de jeux de données Delta Lake sur Amazon S3.
+ `Format` – *Obligatoire :* chaîne UTF-8 (valeurs valides : `json="JSON"` \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` \$1 `iceberg="ICEBERG"` \$1 `hyper="HYPER"` \$1 `xml="XML"`).

  Définit le format de sortie des données pour la cible.
+ `AdditionalOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique des options de connexion supplémentaires pour le connecteur.
+ `SchemaChangePolicy` – Un objet [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy).

  Une politique qui indique les évolutions de mise à jour pour le crawler.
+ `AutoDataQuality` : un objet [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality).

  Indique s’il faut activer automatiquement l’évaluation de la qualité des données pour la cible directe S3 Delta. Lorsque ce paramètre est défini sur `true`, les contrôles de qualité des données sont effectués automatiquement pendant l’opération d’écriture.

## HyperDirectTarget Structure S3
<a name="aws-glue-api-visual-job-api-S3HyperDirectTarget"></a>

Spécifie une cible de HyperDirect données qui écrit sur Amazon S3.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Identifiant unique du nœud HyperDirect cible.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Spécifie la source d'entrée pour la HyperDirect cible.
+ `Format`— Chaîne UTF-8 (valeurs valides : `json="JSON"` \$1 \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` `iceberg="ICEBERG"` `hyper="HYPER"` \$1`xml="XML"`).

  Spécifie le format de sortie des données pour la HyperDirect cible.
+ `PartitionKeys` – Tableau de chaînes UTF-8.

  Définit la stratégie de partitionnement des données de sortie.
+ `Path` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Emplacement S3 dans lequel les données de sortie seront écrites.
+ `Compression` – Chaîne UTF-8 (valeurs valides : `uncompressed="UNCOMPRESSED"`).

  Type de compression à appliquer aux données de sortie.
+ `SchemaChangePolicy` – Un objet [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy).

  Définit la manière dont les modifications de schéma sont gérées lors des opérations d’écriture.
+ `AutoDataQuality` : un objet [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality).

  Indique s’il faut activer automatiquement l’évaluation de la qualité des données pour la cible directe S3 Hyper. Lorsque ce paramètre est défini sur `true`, les contrôles de qualité des données sont effectués automatiquement pendant l’opération d’écriture.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la cible directe S3 Hyper.

## IcebergDirectTarget Structure S3
<a name="aws-glue-api-visual-job-api-S3IcebergDirectTarget"></a>

Indique une cible qui écrit dans une source de données Iceberg de Amazon S3.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Indique l’identifiant unique du nœud cible Iceberg dans votre pipeline de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Définit la source d’entrée unique qui fournit des données à cette cible Iceberg.
+ `PartitionKeys` – Tableau de chaînes UTF-8.

  Indique les colonnes utilisées pour partitionner les données de la table Iceberg dans S3.
+ `Path` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique l’emplacement S3 dans lequel les données de la table Iceberg seront stockées.
+ `Format` – *Obligatoire :* chaîne UTF-8 (valeurs valides : `json="JSON"` \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` \$1 `iceberg="ICEBERG"` \$1 `hyper="HYPER"` \$1 `xml="XML"`).

  Indique le format de fichier utilisé pour stocker les données des tables Iceberg (par exemple, Parquet, ORC).
+ `AdditionalOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Fournit des options de configuration supplémentaires pour personnaliser le comportement de la table Iceberg.
+ `SchemaChangePolicy` – Un objet [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy).

  Définit la manière dont les modifications de schéma sont gérées lors de l’écriture de données dans la table Iceberg.
+ `Compression` – *Obligatoire* :Chaîne UTF-8 (valeurs valides : `gzip="GZIP"` \$1 `lzo="LZO"` \$1 `uncompressed="UNCOMPRESSED"` \$1 `snappy="SNAPPY"`).

  Indique le codec de compression utilisé pour les fichiers de table Iceberg dans S3.
+ `NumberTargetPartitions` – Chaîne UTF-8.

  Définit le nombre de partitions cible pour la distribution des fichiers de table Iceberg dans S3.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la cible directe S3 Iceberg.

## DirectSchemaChangePolicy structure
<a name="aws-glue-api-visual-job-api-DirectSchemaChangePolicy"></a>

Une politique qui indique des comportements de mise à jour pour l'crawler.

**Champs**
+ `EnableUpdateCatalog` : booléen.

  S'il faut utiliser ou non le comportement de mise à jour spécifié lorsque l'crawler détecte un schéma modifié.
+ `UpdateBehavior` – Chaîne UTF-8 (valeurs valides : `UPDATE_IN_DATABASE` \$1 `LOG`).

  Comportement de mise à jour lorsque l'crawler détecte un schéma modifié.
+ `Table` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique la table de la base de données à laquelle s'applique la politique de modification du schéma.
+ `Database` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique la base de données à laquelle s'applique la politique de modification du schéma.

## ApplyMapping structure
<a name="aws-glue-api-visual-job-api-ApplyMapping"></a>

Indique une transformation qui mappe les clés de propriétés de données de la source de données aux clés de propriété de données de la cible de données. Vous pouvez renommer les clés, modifier leur type de données et choisir les clés à supprimer du jeu de données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les entrées de données identifiées par leurs noms de nœuds.
+ `Mapping` – *Obligatoire :* un tableau d’objets [Mappage](#aws-glue-api-visual-job-api-Mapping).

  Indique le mappage des clés de propriétés de données de la source de données avec les clés de propriétés de données de la cible de données.

## Structure de mappage
<a name="aws-glue-api-visual-job-api-Mapping"></a>

Indique le mappage des clés de propriété de données.

**Champs**
+ `ToKey` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Après le mappage d'application, quel nom donner à la colonne. Peut être similaire à `FromPath`.
+ `FromPath` – Tableau de chaînes UTF-8.

  La table ou la colonne à modifier.
+ `FromType` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le type des données à modifier.
+ `ToType` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le type de données sous lequel les données doivent être modifiées.
+ `Dropped` : booléen.

  Si ce paramètre est défini sur « VRAI », la colonne est supprimée.
+ `Children` : un tableau d’objets [Mappage](#aws-glue-api-visual-job-api-Mapping).

  S'applique uniquement aux structures de données imbriquées. Si vous souhaitez modifier la structure parente, mais également l'un de ses enfants, vous pouvez remplir cette structure de données. C'est aussi `Mapping`, mais son `FromPath` sera le `FromPath` du parent plus le `FromPath` provenant de cette structure.

  Pour la partie enfants, supposons que vous ayez la structure suivante :

  `{ "FromPath": "OuterStructure", "ToKey": "OuterStructure", "ToType": "Struct", "Dropped": false, "Chidlren": [{ "FromPath": "inner", "ToKey": "inner", "ToType": "Double", "Dropped": false, }] }`

  Vous pouvez Indiquer un `Mapping` qui se présente sous la forme suivante :

  `{ "FromPath": "OuterStructure", "ToKey": "OuterStructure", "ToType": "Struct", "Dropped": false, "Chidlren": [{ "FromPath": "inner", "ToKey": "inner", "ToType": "Double", "Dropped": false, }] }`

## SelectFields structure
<a name="aws-glue-api-visual-job-api-SelectFields"></a>

Indique une transformation qui choisit les clés de propriété de données que vous souhaitez conserver.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les entrées de données identifiées par leurs noms de nœuds.
+ `Paths` – *Obligatoire :* Tableau de chaînes UTF-8.

  Un chemin JSON vers une variable de la structure de données.

## DropFields structure
<a name="aws-glue-api-visual-job-api-DropFields"></a>

Indique une transformation qui choisit les clés de propriété de données que vous souhaitez supprimer.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les entrées de données identifiées par leurs noms de nœuds.
+ `Paths` – *Obligatoire :* Tableau de chaînes UTF-8.

  Un chemin JSON vers une variable de la structure de données.

## RenameField structure
<a name="aws-glue-api-visual-job-api-RenameField"></a>

Indique une transformation qui renomme une clé de propriété de données unique.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les entrées de données identifiées par leurs noms de nœuds.
+ `SourcePath` – *Obligatoire :* Tableau de chaînes UTF-8.

  Un chemin JSON vers une variable de la structure de données pour les données source.
+ `TargetPath` – *Obligatoire :* Tableau de chaînes UTF-8.

  Un chemin JSON vers une variable de la structure de données pour les données cibles.

## Structure Spigot
<a name="aws-glue-api-visual-job-api-Spigot"></a>

Indique une transformation qui écrit des échantillons de données dans un compartiment Amazon S3.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les entrées de données identifiées par leurs noms de nœuds.
+ `Path` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Un chemin dans Amazon S3 où la transformation écrira un sous-ensemble de registres à partir du jeu de données dans un fichier JSON situé dans un compartiment Amazon S3.
+ `Topk` – Nombre (entier), 100 au maximum.

  Indique un certain nombre de registres à écrire à partir du début du jeu de données.
+ `Prob` – Nombre (double), 1 au maximum.

  La probabilité (valeur décimale ayant une valeur maximale de 1) de prélèvement d'un registre donné. La valeur 1 indique que chaque ligne lue à partir du jeu de données doit être incluse dans l'exemple de sortie.

## Structure Join
<a name="aws-glue-api-visual-job-api-Join"></a>

Indique une transformation qui joint deux jeux de données en un jeu de données à l'aide d'une phrase de comparaison sur les clés de propriété de données spécifiées. Vous pouvez utiliser des jointures internes (ou intérieures), externes (ou extérieures), gauche, droite, semi gauche et anti gauche.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 2 chaînes minimum et 2 chaînes maximum.

  Les entrées de données identifiées par leurs noms de nœuds.
+ `JoinType` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `equijoin="EQUIJOIN"` \$1 `left="LEFT"` \$1 `right="RIGHT"` \$1 `outer="OUTER"` \$1 `leftsemi="LEFT_SEMI"` \$1 `leftanti="LEFT_ANTI"`).

  Indique le type de jointure à effectuer sur les jeux de données.
+ `Columns` – *Obligatoire :* Tableau d'objets [JoinColumn](#aws-glue-api-visual-job-api-JoinColumn), 2 structures minimum et 2 structures maximum.

  Liste des deux colonnes à joindre.

## JoinColumn structure
<a name="aws-glue-api-visual-job-api-JoinColumn"></a>

Indique une colonne à joindre.

**Champs**
+ `From` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  La colonne à joindre.
+ `Keys` – *Obligatoire :* Tableau de chaînes UTF-8.

  La clé de la colonne à joindre.

## SplitFields structure
<a name="aws-glue-api-visual-job-api-SplitFields"></a>

Indique une transformation qui divise les clés de propriété de données en deux `DynamicFrames`. Le résultat est une collection de `DynamicFrames` : une avec les clés de propriété de données sélectionnées, et une autre avec les clés de propriété de données restantes.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les entrées de données identifiées par leurs noms de nœuds.
+ `Paths` – *Obligatoire :* Tableau de chaînes UTF-8.

  Un chemin JSON vers une variable de la structure de données.

## SelectFromCollection structure
<a name="aws-glue-api-visual-job-api-SelectFromCollection"></a>

Indique une transformation qui en choisit une `DynamicFrame` provenant d'une collection de `DynamicFrames`. Le résultat est le `DynamicFrame` sélectionné

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les entrées de données identifiées par leurs noms de nœuds.
+ `Index` – *Obligatoire :* Nombre (entier), pas plus qu'Aucun.

  L'index du DynamicFrame à sélectionner.

## FillMissingValues structure
<a name="aws-glue-api-visual-job-api-FillMissingValues"></a>

Précise une transformation qui localise les registres dans le jeu de données dont les valeurs sont manquantes et ajoute un nouveau champ avec une valeur déterminée par imputation. Le jeu de données source est utilisé pour entraîner le modèle de machine learning (ML) qui détermine la valeur manquante.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les entrées de données identifiées par leurs noms de nœuds.
+ `ImputedPath` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Un chemin JSON vers une variable de la structure de données pour le jeu de données attribué.
+ `FilledPath` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Un chemin JSON vers une variable de la structure de données pour le jeu de données rempli.

## Structure Filtre
<a name="aws-glue-api-visual-job-api-Filter"></a>

Indique une transformation qui divise un jeu de données en deux, en fonction d'une condition de filtre.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les entrées de données identifiées par leurs noms de nœuds.
+ `LogicalOperator` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `AND` \$1 `OR`).

  L'opérateur utilisé pour filtrer les lignes en comparant la valeur clé à une valeur spécifiée.
+ `Filters` – *Obligatoire :* un tableau d’objets [FilterExpression](#aws-glue-api-visual-job-api-FilterExpression).

  Indique une expression de filtre.

## FilterExpression structure
<a name="aws-glue-api-visual-job-api-FilterExpression"></a>

Indique une expression de filtre.

**Champs**
+ `Operation` –* Obligatoire :* Chaîne UTF-8 (valeurs valides : `EQ` \$1 `LT` \$1 `GT` \$1 `LTE` \$1 `GTE` \$1 `REGEX` \$1 `ISNULL`).

  Le type d'opération à effectuer dans l'expression.
+ `Negated` : booléen.

  Indique si l'expression doit être annulée.
+ `Values` – *Obligatoire :* un tableau d’objets [FilterValue](#aws-glue-api-visual-job-api-FilterValue).

  Une liste de valeurs de filtre.

## FilterValue structure
<a name="aws-glue-api-visual-job-api-FilterValue"></a>

Représente une entrée unique dans la liste de valeurs de `FilterExpression`. 

**Champs**
+ `Type` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `COLUMNEXTRACTED` \$1 `CONSTANT`).

  Le type de valeur de filtre.
+ `Value` – *Obligatoire :* Tableau de chaînes UTF-8.

  La valeur à associer.

## CustomCode structure
<a name="aws-glue-api-visual-job-api-CustomCode"></a>

Indique une transformation qui utilise le code personnalisé que vous fournissez pour effectuer la transformation des données. La sortie est une collection de DynamicFrames.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, au moins 1 chaîne.

  Les entrées de données identifiées par leurs noms de nœuds.
+ `Code` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #54](aws-glue-api-common.md#regex_54).

  Le code personnalisé utilisé pour effectuer la transformation des données.
+ `ClassName` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom défini pour la classe de nœuds de code personnalisée.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la transformation du code personnalisé.

## Structure SparkSQL
<a name="aws-glue-api-visual-job-api-SparkSQL"></a>

Indique une transformation dans laquelle vous saisissez une requête SQL à l'aide de la syntaxe Spark SQL pour transformer les données. Le résultat est un `DynamicFrame` unique.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, au moins 1 chaîne.

  Les entrées de données identifiées par leurs noms de nœuds. Vous pouvez associer un nom de table à chaque nœud d'entrée à utiliser dans la requête SQL. Le nom que vous choisissez doit respecter les restrictions de dénomination de Spark SQL.
+ `SqlQuery` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #62](aws-glue-api-common.md#regex_62).

  Une requête SQL qui doit utiliser la syntaxe Spark SQL et renvoyer un jeu de données unique.
+ `SqlAliases` – *Obligatoire :* un tableau d’objets [SqlAlias](#aws-glue-api-visual-job-api-SqlAlias).

  Liste d’alias Un alias vous autorise de spécifier le nom à utiliser dans SQL pour une entrée donnée. Par exemple, vous avez une source de données nommée « MyDataSource ». Si vous spécifiez `From` as MyDataSource et `Alias` as SqlName, alors dans votre code SQL, vous pouvez faire :

  `select * from SqlName`

  et qui obtient des données de MyDataSource.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la transformation SparkSQL.

## SqlAlias structure
<a name="aws-glue-api-visual-job-api-SqlAlias"></a>

Représente une entrée unique dans la liste de valeurs de `SqlAliases`. 

**Champs**
+ `From` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Une table ou une colonne d'une table.
+ `Alias` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Un nom temporaire donné à une table ou à une colonne d'une table.

## DropNullFields structure
<a name="aws-glue-api-visual-job-api-DropNullFields"></a>

Indique une transformation qui supprime les colonnes du jeu de données si toutes les valeurs de la colonne sont « nulles ». Par défaut, AWS Glue Studio reconnaît les objets nuls, mais certaines valeurs telles que les chaînes vides, les chaînes « nulles », les entiers -1 ou d'autres espaces réservés tels que les zéros ne sont pas automatiquement reconnues comme nulles.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les entrées de données identifiées par leurs noms de nœuds.
+ `NullCheckBoxList` – Un objet [NullCheckBoxList](#aws-glue-api-visual-job-api-NullCheckBoxList).

  Une structure qui indique si certaines valeurs sont reconnues comme des valeurs null en vue de la suppression.
+ `NullTextList` – Un tableau d'objets [NullValueField](#aws-glue-api-visual-job-api-NullValueField), 50 structures maximum.

  Structure qui spécifie une liste de NullValueField structures représentant une valeur nulle personnalisée telle que zéro ou une autre valeur utilisée comme espace réservé nul propre à l'ensemble de données.

  La transformation `DropNullFields` supprime les valeurs nulles personnalisées uniquement, si la valeur de l'espace réservé nul et du type de données correspondent aux données.

## NullCheckBoxList structure
<a name="aws-glue-api-visual-job-api-NullCheckBoxList"></a>

Indique si certaines valeurs sont reconnues comme des valeurs null en vue de la suppression.

**Champs**
+ `IsEmpty` : booléen.

  Indique qu'une chaîne vide est considérée comme une valeur null.
+ `IsNullString` : booléen.

  Indique qu'une valeur révélant le mot « null » est considérée comme une valeur null.
+ `IsNegOne` : booléen.

  Indique qu'une valeur entière de -1 est considérée comme une valeur null.

## NullValueField structure
<a name="aws-glue-api-visual-job-api-NullValueField"></a>

Représente une valeur null personnalisée telle qu'un zéro ou une autre valeur utilisée comme espace réservé null unique pour le jeu de données.

**Champs**
+ `Value` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  La valeur de l'espace réservé null.
+ `Datatype` – *Obligatoire :* un objet [Datatype](#aws-glue-api-visual-job-api-Datatype).

  Le type de données de la valeur.

## Structure Datatype
<a name="aws-glue-api-visual-job-api-Datatype"></a>

Une structure représentant le type de données de la valeur.

**Champs**
+ `Id` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Le type de données de la valeur.
+ `Label` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Une étiquette affectée au type de données.

## Structure Fusion
<a name="aws-glue-api-visual-job-api-Merge"></a>

Indique une transformation qui fusionne une `DynamicFrame` avec une `DynamicFrame` intermédiaire basée sur les clés primaires spécifiées pour identifier les registres. Les registres en double (registres avec les mêmes clés primaires) ne sont pas dédupliqués. 

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 2 chaînes minimum et 2 chaînes maximum.

  Les entrées de données identifiées par leurs noms de nœuds.
+ `Source` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  La source `DynamicFrame` qui sera fusionnée avec une `DynamicFrame` intermédiaire.
+ `PrimaryKeys` – *Obligatoire :* Tableau de chaînes UTF-8.

  La liste des champs de clé primaire permettant de faire correspondre les registres des trames dynamiques source et intermédiaire.

## Structure Union
<a name="aws-glue-api-visual-job-api-Union"></a>

Indique une transformation qui combine les lignes de deux jeux de données ou plus en un seul résultat.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 2 chaîne minimum et 2 chaîne maximum.

  Les entrées de l'ID du nœud dans la transformation.
+ `UnionType` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `ALL` \$1 `DISTINCT`).

  Indique le type de transformation Union. 

  Spécifiez `ALL` de joindre toutes les lignes des sources de données au résultat DynamicFrame. L'union qui en résulte ne supprime pas les lignes en double.

  Spécifiez `DISTINCT` de supprimer les lignes dupliquées dans le résultat DynamicFrame.

## PIIDetection structure
<a name="aws-glue-api-visual-job-api-PIIDetection"></a>

Indique une transformation qui identifie, supprime ou masque les données d'informations personnelles identifiables (PII).

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les entrées de l'ID du nœud dans la transformation.
+ `PiiType` –* Obligatoire :* Chaîne UTF-8 (valeurs valides : `RowAudit` \$1 `RowHashing` \$1 `RowMasking` \$1 `RowPartialMasking` \$1 `ColumnAudit` \$1 `ColumnHashing` \$1 `ColumnMasking`).

  Indique le type de PIIDetection transformation. 
+ `EntityTypesToDetect` – *Obligatoire :* Tableau de chaînes UTF-8.

  Indique les types d'entités que la PIIDetection transformation identifiera en tant que données PII. 

   Les entités de type PII comprennent : PERSON\$1NAME, DATE, USA\$1SNN, EMAIL, USA\$1ITIN, USA\$1PASSPORT\$1NUMBER, PHONE\$1NUMBER, BANK\$1ACCOUNT, IP\$1ADDRESS, MAC\$1ADDRESS, USA\$1CPT\$1CODE, USA\$1HCPCS\$1CODE, USA\$1NATIONAL\$1DRUG\$1CODE, USA\$1MEDICARE\$1BENEFICIARY\$1IDENTIFIER, USA\$1HEALTH\$1INSURANCE\$1CLAIM\$1NUMBER, CREDIT\$1CARD, USA\$1NATIONAL\$1PROVIDER\$1IDENTIFIER, USA\$1DEA\$1NUMBER, USA\$1DRIVING\$1LICENSE 
+ `OutputColumnName` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique le nom de la colonne de sortie qui contiendra tout type d'entité détecté dans cette ligne. 
+ `SampleFraction` – Nombre (double), 1 au maximum.

  Indique la fraction des données à échantillonner lors de la recherche d'entités PII. 
+ `ThresholdFraction` – Nombre (double), 1 au maximum.

  Indique la fraction des données qui doit être satisfaite pour qu'une colonne soit identifiée comme données PII. 
+ `MaskValue` – chaîne UTF-8, d'une longueur ne dépassant pas 256 octets, correspondant au [Custom string pattern #58](aws-glue-api-common.md#regex_58).

  Indique la valeur qui remplacera l'entité détectée. 
+ `RedactText` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique s’il faut expurger le texte des données d’identification personnelle (PII) détecté. Lorsqu’il est défini sur `true`, le contenu des PII est remplacé par des caractères de rédaction.
+ `RedactChar` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le caractère utilisé pour remplacer le contenu des PII détecté lorsque la rédaction est activée. Le caractère de rédaction par défaut est `*`.
+ `MatchPattern` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Modèle d’expression régulière utilisé pour identifier un contenu des PII supplémentaire au-delà des algorithmes de détection standard.
+ `NumLeftCharsToExclude` – Nombre (entier), pas plus qu'Aucun.

  Le nombre de caractères à exclure de la rédaction sur le côté gauche du contenu des PII détecté. Cela permet de préserver le contexte des données sensibles.
+ `NumRightCharsToExclude` – Nombre (entier), pas plus qu'Aucun.

  Le nombre de caractères à exclure de la rédaction sur le côté droit du contenu des PII détecté. Cela permet de préserver le contexte des données sensibles.
+ `DetectionParameters` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Paramètres supplémentaires pour configurer le comportement de détection des PII et les paramètres de sensibilité.
+ `DetectionSensitivity` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Niveau de sensibilité pour la détection des PII. Des niveaux de sensibilité plus élevés détectent un plus grand nombre de PII potentielles, mais peuvent entraîner un plus grand nombre de faux positifs.

## Structure Aggregate
<a name="aws-glue-api-visual-job-api-Aggregate"></a>

Indique une transformation qui regroupe les lignes par champs choisis et calcule la valeur agrégée par fonction spécifiée.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Indique les champs et les lignes à utiliser comme entrées pour la transformation agrégée.
+ `Groups` – *Obligatoire :* Tableau de chaînes UTF-8.

  Indique les champs à regrouper.
+ `Aggs` – *Obligatoire :* tableau d'objets [AggregateOperation](#aws-glue-api-visual-job-api-AggregateOperation), 1 structure minimum et 30 structures maximum.

  Indique les fonctions d'agrégation à exécuter sur des champs spécifiés. 

## DropDuplicates structure
<a name="aws-glue-api-visual-job-api-DropDuplicates"></a>

Indique une transformation qui supprime des lignes de données répétitives d'un jeu de données. 

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du nœud de transformation.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les entrées de données identifiées par leurs noms de nœuds.
+ `Columns` – Tableau de chaînes UTF-8.

  Nom des colonnes à fusionner ou à supprimer en cas de répétition.

## GovernedCatalogTarget structure
<a name="aws-glue-api-visual-job-api-GovernedCatalogTarget"></a>

Spécifie une cible de données qui écrit sur Amazon S3 à l'aide du catalogue de AWS Glue données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible de données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.
+ `PartitionKeys` – Tableau de chaînes UTF-8.

  Indique le partitionnement natif à l'aide d'une séquence de clés.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table de la base de données dans laquelle écrire les données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données dans laquelle écrire les données.
+ `SchemaChangePolicy` – Un objet [CatalogSchemaChangePolicy](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy).

  Politique qui indique des comportements de mise à jour pour le catalogue gouverné.

## GovernedCatalogSource structure
<a name="aws-glue-api-visual-job-api-GovernedCatalogSource"></a>

Spécifie le magasin de données dans le catalogue de AWS Glue données régi.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du stocker de données.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  La base de données à partir de laquelle lire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Table de base de données à lire.
+ `PartitionPredicate` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Les partitions satisfaisant à ce prédicat sont supprimées. Les fichiers qui se situent dans la période de conservation pour ces partitions ne sont pas supprimés. Valeur définie sur `""` – vide par défaut.
+ `AdditionalOptions` – Un objet [S3 SourceAdditionalOptions](#aws-glue-api-visual-job-api-S3SourceAdditionalOptions).

  Indique des options de connexion supplémentaires.

## AggregateOperation structure
<a name="aws-glue-api-visual-job-api-AggregateOperation"></a>

Indique l'ensemble de paramètres permettant d'effectuer l'agrégation de la transformation agrégée.

**Champs**
+ `Column` – *Obligatoire :* Tableau de chaînes UTF-8.

  Indique la colonne du jeu de données sur lequel la fonction d'agrégation sera appliquée.
+ `AggFunc` – *Obligatoire :*chaîne UTF-8 (valeurs valides : `avg` \$1 `countDistinct` \$1 `count` \$1 `first` \$1 `last` \$1 `kurtosis` \$1 `max` \$1 `min` \$1 `skewness` \$1 `stddev_samp` \$1 `stddev_pop` \$1 `sum` \$1 `sumDistinct` \$1 `var_samp` \$1 `var_pop`).

  Indique la fonction d'agrégation à appliquer.

  Les fonctions d'agrégation possibles incluent : avg countDistinct, count, first, last, kurtosis, max, min, skewness, stddev\$1samp, stddev\$1pop, sum, sumDistinct, var\$1samp, var\$1pop

## GlueSchema structure
<a name="aws-glue-api-visual-job-api-GlueSchema"></a>

Indique un schéma défini par l'utilisateur lorsqu'un schéma ne peut pas être déterminé par AWS Glue.

**Champs**
+ `Columns` : un tableau d’objets [GlueStudioSchemaColumn](#aws-glue-api-visual-job-api-GlueStudioSchemaColumn).

  Spécifie les définitions de colonnes qui constituent un AWS Glue schéma.

## GlueStudioSchemaColumn structure
<a name="aws-glue-api-visual-job-api-GlueStudioSchemaColumn"></a>

Spécifie une seule colonne dans une définition de AWS Glue schéma.

**Champs**
+ `Name` : *Requis :* chaîne UTF-8, d'une longueur maximale de 1 024 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la colonne dans le schéma AWS Glue Studio.
+ `Type` – Chaîne UTF-8, d’une longueur maximale de 131 072 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Type de ruche pour cette colonne dans le schéma AWS Glue Studio.
+ `GlueStudioType` – Chaîne UTF-8, d’une longueur maximale de 131 072 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Type de données de la colonne tel que défini dans AWS Glue Studio.

## GlueStudioColumn structure
<a name="aws-glue-api-visual-job-api-GlueStudioColumn"></a>

Spécifie une seule colonne dans AWS Glue Studio.

**Champs**
+ `Key` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  La clé de la colonne dans AWS Glue Studio.
+ `FullPath` – *Obligatoire :* Tableau de chaînes UTF-8.

  TThe URL complète de la colonne dans AWS Glue Studio.
+ `Type` : *requis :* chaîne UTF-8 (valeurs valides : `array="ARRAY"` \$1 `bigint="BIGINT"` \$1 `bigint array="BIGINT_ARRAY"` \$1 `binary="BINARY"` \$1 `binary array="BINARY_ARRAY"` \$1 `boolean="BOOLEAN"` \$1 `boolean array="BOOLEAN_ARRAY"` \$1 `byte="BYTE"` \$1 `byte array="BYTE_ARRAY"` \$1 `char="CHAR"` \$1 `char array="CHAR_ARRAY"` \$1 `choice="CHOICE"` \$1 `choice array="CHOICE_ARRAY"` \$1 `date="DATE"` \$1 `date array="DATE_ARRAY"` \$1 `decimal="DECIMAL"` \$1 `decimal array="DECIMAL_ARRAY"` \$1 `double="DOUBLE"` \$1 `double array="DOUBLE_ARRAY"` \$1 `enum="ENUM"` \$1 `enum array="ENUM_ARRAY"` \$1 `float="FLOAT"` \$1 `float array="FLOAT_ARRAY"` \$1 `int="INT"` \$1 `int array="INT_ARRAY"` \$1 `interval="INTERVAL"` \$1 `interval array="INTERVAL_ARRAY"` \$1 `long="LONG"` \$1 `long array="LONG_ARRAY"` \$1 `object="OBJECT"` \$1 `short="SHORT"` \$1 `short array="SHORT_ARRAY"` \$1 `smallint="SMALLINT"` \$1 `smallint array="SMALLINT_ARRAY"` \$1 `string="STRING"` \$1 `string array="STRING_ARRAY"` \$1 `timestamp="TIMESTAMP"` \$1 `timestamp array="TIMESTAMP_ARRAY"` \$1 `tinyint="TINYINT"` \$1 `tinyint array="TINYINT_ARRAY"` \$1 `varchar="VARCHAR"` \$1 `varchar array="VARCHAR_ARRAY"` \$1 `null="NULL"` \$1 `unknown="UNKNOWN"` \$1 `unknown array="UNKNOWN_ARRAY"`).

  TThe type de colonne dans AWS Glue Studio.
+ `Children` : tableau d’une structure.

  TThe enfants de la colonne parent dans AWS Glue Studio.
+ `GlueStudioType` : chaîne UTF-8 (valeurs valides : `array="ARRAY"` \$1 `bigint="BIGINT"` \$1 `bigint array="BIGINT_ARRAY"` \$1 `binary="BINARY"` \$1 `binary array="BINARY_ARRAY"` \$1 `boolean="BOOLEAN"` \$1 `boolean array="BOOLEAN_ARRAY"` \$1 `byte="BYTE"` \$1 `byte array="BYTE_ARRAY"` \$1 `char="CHAR"` \$1 `char array="CHAR_ARRAY"` \$1 `choice="CHOICE"` \$1 `choice array="CHOICE_ARRAY"` \$1 `date="DATE"` \$1 `date array="DATE_ARRAY"` \$1 `decimal="DECIMAL"` \$1 `decimal array="DECIMAL_ARRAY"` \$1 `double="DOUBLE"` \$1 `double array="DOUBLE_ARRAY"` \$1 `enum="ENUM"` \$1 `enum array="ENUM_ARRAY"` \$1 `float="FLOAT"` \$1 `float array="FLOAT_ARRAY"` \$1 `int="INT"` \$1 `int array="INT_ARRAY"` \$1 `interval="INTERVAL"` \$1 `interval array="INTERVAL_ARRAY"` \$1 `long="LONG"` \$1 `long array="LONG_ARRAY"` \$1 `object="OBJECT"` \$1 `short="SHORT"` \$1 `short array="SHORT_ARRAY"` \$1 `smallint="SMALLINT"` \$1 `smallint array="SMALLINT_ARRAY"` \$1 `string="STRING"` \$1 `string array="STRING_ARRAY"` \$1 `timestamp="TIMESTAMP"` \$1 `timestamp array="TIMESTAMP_ARRAY"` \$1 `tinyint="TINYINT"` \$1 `tinyint array="TINYINT_ARRAY"` \$1 `varchar="VARCHAR"` \$1 `varchar array="VARCHAR_ARRAY"` \$1 `null="NULL"` \$1 `unknown="UNKNOWN"` \$1 `unknown array="UNKNOWN_ARRAY"`).

  Type de données de la colonne tel que défini dans AWS Glue Studio.

## DynamicTransform structure
<a name="aws-glue-api-visual-job-api-DynamicTransform"></a>

Spécifie l'ensemble de paramètres permettant d'effectuer la transformation dynamique.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Spécifie le nom de la transformation dynamique.
+ `TransformName` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Spécifie le nom de la transformation dynamique tel qu'il apparaît dans l'éditeur visuel de AWS Glue Studio.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Spécifie les entrées requises pour la transformation dynamique.
+ `Parameters` : un tableau d’objets [TransformConfigParameter](#aws-glue-api-visual-job-api-TransformConfigParameter).

  Spécifie les paramètres de la transformation dynamique.
+ `FunctionName` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Spécifie le nom de la fonction de la transformation dynamique.
+ `Path` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Spécifie le chemin de la source de transformation dynamique et des fichiers de configuration.
+ `Version` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Ce champ n'est pas utilisé et sera obsolète dans une version ultérieure.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la transformation dynamique.

## TransformConfigParameter structure
<a name="aws-glue-api-visual-job-api-TransformConfigParameter"></a>

Spécifie les paramètres du fichier de configuration de la transformation dynamique.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Spécifie le nom du paramètre dans le fichier de configuration de la transformation dynamique.
+ `Type` –* Obligatoire :* Chaîne UTF-8 (valeurs valides : `str="STR"` \$1 `int="INT"` \$1 `float="FLOAT"` \$1 `complex="COMPLEX"` \$1 `bool="BOOL"` \$1 `list="LIST"` \$1 `null="NULL"`).

  Spécifie le type de paramètre dans le fichier de configuration de la transformation dynamique.
+ `ValidationRule` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Spécifie la règle de validation dans le fichier de configuration de la transformation dynamique.
+ `ValidationMessage` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Spécifie le message de validation dans le fichier de configuration de la transformation dynamique.
+ `Value` – Tableau de chaînes UTF-8.

  Spécifie la valeur du paramètre dans le fichier de configuration de la transformation dynamique.
+ `ListType` – Chaîne UTF-8 (valeurs valides: `str="STR"` \$1 `int="INT"` \$1 `float="FLOAT"` \$1 `complex="COMPLEX"` \$1 `bool="BOOL"` \$1 `list="LIST"` \$1 `null="NULL"`).

  Spécifie le type de liste du paramètre dans le fichier de configuration de la transformation dynamique.
+ `IsOptional` : booléen.

  Spécifie si le paramètre est facultatif ou non dans le fichier de configuration de la transformation dynamique.

## EvaluateDataQuality structure
<a name="aws-glue-api-visual-job-api-EvaluateDataQuality"></a>

Spécifie vos critères d'évaluation de la qualité des données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de l'évaluation de la qualité des données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Entrées de votre évaluation de la qualité des données.
+ `Ruleset` – *Obligatoire :* Chaîne UTF-8, d'une longueur comprise entre 1 et 65536 octets, correspondant au [Custom string pattern #59](aws-glue-api-common.md#regex_59).

  Ensemble de règles pour l'évaluation de la qualité de vos données.
+ `Output` – Chaîne UTF-8 (valeurs valides : `PrimaryInput` \$1 `EvaluationResults`).

  Résultat de votre évaluation de la qualité des données.
+ `PublishingOptions` – Un objet [DQResultsPublishingOptions](#aws-glue-api-visual-job-api-DQResultsPublishingOptions).

  Options permettant de configurer le mode de publication de vos résultats.
+ `StopJobOnFailureOptions` – Un objet [DQStopJobOnFailureOptions](#aws-glue-api-visual-job-api-DQStopJobOnFailureOptions).

  Options permettant de configurer le mode d'interruption de votre tâche en cas d'échec de l'évaluation de la qualité des données.

## DQResultsPublishingOptions structure
<a name="aws-glue-api-visual-job-api-DQResultsPublishingOptions"></a>

Options permettant de configurer le mode de publication des résultats de votre évaluation de la qualité des données.

**Champs**
+ `EvaluationContext` – Chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Contexte de l'évaluation.
+ `ResultsS3Prefix` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Préfixe Amazon S3 ajouté aux résultats.
+ `CloudWatchMetricsEnabled` : booléen.

  Activez les métriques pour vos résultats de qualité des données.
+ `ResultsPublishingEnabled` : booléen.

  Activez la publication pour vos résultats de qualité des données.

## DQStopJobOnFailureOptions structure
<a name="aws-glue-api-visual-job-api-DQStopJobOnFailureOptions"></a>

Options permettant de configurer le mode d'interruption de votre tâche en cas d'échec de l'évaluation de la qualité des données.

**Champs**
+ `StopJobOnFailureTiming` – Chaîne UTF-8 (valeurs valides : `Immediate` \$1 `AfterDataLoad`).

  Quand arrêter la tâche en cas d'échec de votre évaluation de la qualité des données. Les options sont immédiates ou AfterDataLoad.

## EvaluateDataQualityMultiFrame structure
<a name="aws-glue-api-visual-job-api-EvaluateDataQualityMultiFrame"></a>

Spécifie vos critères d'évaluation de la qualité des données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de l'évaluation de la qualité des données.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, au moins 1 chaîne.

  Entrées de votre évaluation de la qualité des données. La première entrée de cette liste est la source de données principale.
+ `AdditionalDataSources` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Les alias de toutes les sources de données, à l'exception de la source principale.
+ `Ruleset` – *Obligatoire :* Chaîne UTF-8, d'une longueur comprise entre 1 et 65536 octets, correspondant au [Custom string pattern #59](aws-glue-api-common.md#regex_59).

  Ensemble de règles pour l'évaluation de la qualité de vos données.
+ `PublishingOptions` – Un objet [DQResultsPublishingOptions](#aws-glue-api-visual-job-api-DQResultsPublishingOptions).

  Options permettant de configurer le mode de publication de vos résultats.
+ `AdditionalOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8 (valeurs valides : `performanceTuning.caching="CacheOption"` \$1 `observations.scope="ObservationsOption"` \$1`compositeRuleEvaluation.method="CompositeOption"`).

  Chaque valeur est une chaîne UTF-8.

  Options permettant de configurer le comportement d'exécution de la transformation.
+ `StopJobOnFailureOptions` – Un objet [DQStopJobOnFailureOptions](#aws-glue-api-visual-job-api-DQStopJobOnFailureOptions).

  Options permettant de configurer le mode d'interruption de votre tâche en cas d'échec de l'évaluation de la qualité des données.

## Structure de la recette
<a name="aws-glue-api-visual-job-api-Recipe"></a>

Un nœud AWS Glue Studio qui utilise une AWS Glue DataBrew recette dans les AWS Glue tâches.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du nœud AWS Glue Studio.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Les nœuds qui sont des entrées du nœud de recette, identifiés par un identifiant.
+ `RecipeReference` – Un objet [RecipeReference](#aws-glue-api-visual-job-api-RecipeReference).

  Référence à la DataBrew recette utilisée par le nœud.
+ `RecipeSteps` : un tableau d’objets [RecipeStep](#aws-glue-api-visual-job-api-RecipeStep).

  Étapes de transformation utilisées dans le nœud de recette.

## RecipeReference structure
<a name="aws-glue-api-visual-job-api-RecipeReference"></a>

Référence à une AWS Glue DataBrew recette.

**Champs**
+ `RecipeArn` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  L'ARN de la DataBrew recette.
+ `RecipeVersion` – *obligatoire* : chaîne UTF-8, d'une longueur comprise entre 1 et 16 octets.

  Celui RecipeVersion de la DataBrew recette.

## SnowflakeNodeData structure
<a name="aws-glue-api-visual-job-api-SnowflakeNodeData"></a>

Spécifie la configuration des nœuds Snowflake dans Studio. AWS Glue 

**Champs**
+ `SourceType` – Chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Indique la manière dont les données extraites sont spécifiées. Valeurs valides : `"table"`, ` "query"`.
+ `Connection` : un objet [Option](#aws-glue-api-visual-job-api-Option).

  Spécifie une connexion au catalogue de AWS Glue données à un point de terminaison Snowflake.
+ `Schema` – Chaîne UTF-8.

  Indique un schéma de base de données Snowflake que votre nœud doit utiliser.
+ `Table` – Chaîne UTF-8.

  Indique une table Snowflake que votre nœud doit utiliser.
+ `Database` – Chaîne UTF-8.

  Indique une base de données Snowflake que votre nœud doit utiliser.
+ `TempDir` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Non utilisé actuellement.
+ `IamRole` : un objet [Option](#aws-glue-api-visual-job-api-Option).

  Non utilisé actuellement.
+ `AdditionalOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique les options supplémentaires transmises au connecteur Snowflake. Si des options sont spécifiées ailleurs dans ce nœud, elles seront prioritaires.
+ `SampleQuery` – Chaîne UTF-8.

  Une chaîne SQL utilisée pour récupérer des données avec le type source `query`.
+ `PreAction` – Chaîne UTF-8.

  Une chaîne SQL exécutée avant que le connecteur Snowflake n'exécute ses actions standard.
+ `PostAction` – Chaîne UTF-8.

  Une chaîne SQL exécutée après que le connecteur Snowflake a exécuté ses actions standard.
+ `Action` – Chaîne UTF-8.

  Indique l'action à effectuer lors de l'écriture dans une table contenant des données préexistantes. Valeurs valides: ` append`, `merge`, `truncate`, `drop`.
+ `Upsert` : booléen.

  Utilisé lorsque action est `append`. Indique le comportement de résolution lorsqu'une ligne existe déjà. Si la valeur est vraie, les lignes préexistantes seront mises à jour. Si la valeur est fausse, ces lignes seront insérées.
+ `MergeAction` – Chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Indique une action de fusion. Valeurs valides : `simple`, `custom`. S'il la valeur est simple, le comportement de fusion est défini par `MergeWhenMatched` et ` MergeWhenNotMatched`. Si la valeur est personnalisée, il est défini par `MergeClause`.
+ `MergeWhenMatched` – Chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Indique comment résoudre les enregistrements qui correspondent à des données préexistantes lors de la fusion. Valeurs valides : ` update`, `delete`.
+ `MergeWhenNotMatched` – Chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Indique comment traiter les enregistrements qui ne correspondent pas aux données préexistantes lors de la fusion. Valeurs valides : `insert`, `none`.
+ `MergeClause` – Chaîne UTF-8.

  Une instruction SQL qui spécifie un comportement de fusion personnalisé.
+ `StagingTable` – Chaîne UTF-8.

  Le nom d'une table intermédiaire utilisée lors de l'exécution de l'action `merge` ou d'actions d'insertion `append`. Les données sont écrites dans cette table, puis déplacées vers `table` par une postaction générée.
+ `SelectedColumns` : un tableau d’objets [Option](#aws-glue-api-visual-job-api-Option).

  Indique les colonnes combinées pour identifier un enregistrement lors de la détection des correspondances pour les fusions et les insertions. Une liste de structures avec des clés `value`, `label` et ` description`. Chaque structure décrit une colonne.
+ `AutoPushdown` : booléen.

  Indique si le pushdown automatique des requêtes est activée. Lorsque l'option pushdown est activée, si une partie de la requête peut être « poussée vers le bas » sur le serveur Snowflake, elle est poussée vers le bas au moment de l'exécution de la requête sur Spark. Cela améliore les performances de certaines requêtes.
+ `TableSchema` : un tableau d’objets [Option](#aws-glue-api-visual-job-api-Option).

  Définit manuellement le schéma cible du nœud. Une liste de structures avec des clés `value`, `label` et `description`. Chaque structure définit une colonne.

## SnowflakeSource structure
<a name="aws-glue-api-visual-job-api-SnowflakeSource"></a>

Indique une source de données Snowflake.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la source de données Snowflake.
+ `Data` – *Obligatoire :* un objet [SnowflakeNodeData](#aws-glue-api-visual-job-api-SnowflakeNodeData).

  Configuration de la source de données Snowflake.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique les schémas définis par l'utilisateur pour vos données de sortie.

## SnowflakeTarget structure
<a name="aws-glue-api-visual-job-api-SnowflakeTarget"></a>

Indique une cible Snowflake.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Le nom de la cible Snowflake.
+ `Data` – *Obligatoire :* un objet [SnowflakeNodeData](#aws-glue-api-visual-job-api-SnowflakeNodeData).

  Indique les données du nœud cible Snowflake.
+ `Inputs` : tableau de chaînes UTF-8, avec une chaîne minimum et une chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.

## ConnectorDataSource structure
<a name="aws-glue-api-visual-job-api-ConnectorDataSource"></a>

Spécifie une source générée avec des options de connexion standard.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de ce nœud source.
+ `ConnectionType` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le`connectionType`, tel que fourni à la AWS Glue bibliothèque sous-jacente. Ce type de nœud prend en charge les types de connexion suivants : 
  + `opensearch`
  + `azuresql`
  + `azurecosmos`
  + `bigquery`
  + `saphana`
  + `teradata`
  + `vertica`
+ `Data` – *obligatoire :* tableau de mappage de paires clé-valeur.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Carte indiquant des options de connexion pour le nœud. Vous trouverez les options de connexion standard pour le type de connexion correspondant dans la section [Paramètres de connexion](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-connect.html) de la AWS Glue documentation.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Spécifie le schéma de données pour cette source.

## ConnectorDataTarget structure
<a name="aws-glue-api-visual-job-api-ConnectorDataTarget"></a>

Spécifie une cible générée avec des options de connexion standard.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de ce nœud cible.
+ `ConnectionType` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le`connectionType`, tel que fourni à la AWS Glue bibliothèque sous-jacente. Ce type de nœud prend en charge les types de connexion suivants : 
  + `opensearch`
  + `azuresql`
  + `azurecosmos`
  + `bigquery`
  + `saphana`
  + `teradata`
  + `vertica`
+ `Data` – *obligatoire :* tableau de mappage de paires clé-valeur.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Carte indiquant des options de connexion pour le nœud. Vous trouverez les options de connexion standard pour le type de connexion correspondant dans la section [Paramètres de connexion](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-connect.html) de la AWS Glue documentation.
+ `Inputs` : tableau de chaînes UTF-8, avec une chaîne minimum et une chaîne maximum.

  Les nœuds qui constituent des entrées pour la cible de données.

## RecipeStep structure
<a name="aws-glue-api-visual-job-api-RecipeStep"></a>

Étape de recette utilisée dans un nœud de recette de préparation de données AWS Glue Studio.

**Champs**
+ `Action` – *Obligatoire :* un objet [RecipeAction](#aws-glue-api-visual-job-api-RecipeAction).

  Action de transformation de l’étape de recette.
+ `ConditionExpressions` : un tableau d’objets [ConditionExpression](#aws-glue-api-visual-job-api-ConditionExpression).

  Expressions de condition pour l’étape de recette.

## RecipeAction structure
<a name="aws-glue-api-visual-job-api-RecipeAction"></a>

Actions définies dans le nœud de recette de préparation des données de AWS Glue Studio.

**Champs**
+ `Operation` – *obligatoire :* chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #56](aws-glue-api-common.md#regex_56).

  Fonctionnement de l’action de recette.
+ `Parameters` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d'une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #57](aws-glue-api-common.md#regex_57).

  Chaque valeur est une chaîne UTF-8, d’une longueur comprise entre 1 et 32 768 octets.

  Paramètres de l’action de recette.

## ConditionExpression structure
<a name="aws-glue-api-visual-job-api-ConditionExpression"></a>

Expression de condition définie dans le nœud de recette de préparation des données de AWS Glue Studio.

**Champs**
+ `Condition` – *obligatoire :* chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #56](aws-glue-api-common.md#regex_56).

  Condition de l’expression de condition.
+ `Value` – Chaîne UTF-8, d’une longueur maximale de 1 024 octets.

  Valeur de l’expression de condition.
+ `TargetColumn` – *Obligatoire :* chaîne UTF-8, d’une longueur comprise entre 1 et 1 024 octets.

  Colonne cible des expressions de condition.

## CatalogIcebergSource Structure S3
<a name="aws-glue-api-visual-job-api-S3CatalogIcebergSource"></a>

Spécifie une source de données Apache Iceberg enregistrée dans le catalogue de AWS Glue données. La source de données Iceberg doit être stockée dans Amazon S3.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source de données Iceberg.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données à partir de laquelle lire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la base de données à partir de laquelle lire les données.
+ `AdditionalIcebergOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique des options de connexion supplémentaires pour la source de données Iceberg.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la source Iceberg.

## CatalogIcebergSource structure
<a name="aws-glue-api-visual-job-api-CatalogIcebergSource"></a>

Spécifie une source de données Apache Iceberg enregistrée dans le catalogue de AWS Glue données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source de données Iceberg.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données à partir de laquelle lire les données.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la table dans la base de données à partir de laquelle lire les données.
+ `AdditionalIcebergOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique des options de connexion supplémentaires pour la source de données Iceberg.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la source Iceberg.

## IcebergCatalogTarget Structure S3
<a name="aws-glue-api-visual-job-api-S3IcebergCatalogTarget"></a>

Spécifie une cible de catalogue Apache Iceberg qui écrit des données Amazon S3 et enregistre la table dans le catalogue de AWS Glue données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la cible du catalogue Iceberg.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Connexion d’entrée pour la cible du catalogue Iceberg.
+ `PartitionKeys` – Tableau de chaînes UTF-8.

  Liste de clés de partition pour la table Iceberg.
+ `Table` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Nom de la table dans laquelle écrire dans le catalogue.
+ `Database` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le nom de la base de données dans laquelle écrire les données.
+ `AdditionalOptions` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Chaque valeur est une chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique des options de connexion supplémentaires pour la cible du catalogue Iceberg.
+ `SchemaChangePolicy` – Un objet [CatalogSchemaChangePolicy](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy).

  Politique de gestion des modifications de schéma dans la cible du catalogue.
+ `AutoDataQuality` : un objet [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality).

  Indique s’il faut activer automatiquement l’évaluation de la qualité des données pour la cible du catalogue S3 Iceberg. Lorsque ce paramètre est défini sur `true`, les contrôles de qualité des données sont effectués automatiquement pendant l’opération d’écriture.

## Structure de Dynamo DBELTConnector Source
<a name="aws-glue-api-visual-job-api-DynamoDBELTConnectorSource"></a>

Spécifie une source de connecteur DynamoDB ELT pour extraire les données des tables DynamoDB.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom de la source du connecteur DynamoDB ELT.
+ `ConnectionOptions` – Un objet [DDBELTConnectionOptions](#aws-glue-api-visual-job-api-DDBELTConnectionOptions).

  Options de connexion pour la source du connecteur DynamoDB ELT.
+ `OutputSchemas` : un tableau d’objets [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema).

  Indique le schéma de données de la source du connecteur DynamoDB ELT.

## DDBELTConnectionStructure des options
<a name="aws-glue-api-visual-job-api-DDBELTConnectionOptions"></a>

Indique les options de connexion pour les opérations DynamoDB ELT (extraction, chargement, transformation). Cette structure contient les paramètres de configuration permettant de se connecter aux tables DynamoDB et d’en extraire les données à l’aide du connecteur ELT.

**Champs**
+ `DynamodbExport` – Chaîne UTF-8 (valeurs valides : `ddb` \$1 `s3`).

  Indique le type d’exportation pour l’extraction de données DynamoDB. Ce paramètre détermine la manière dont les données sont exportées depuis la table DynamoDB pendant le processus ELT.
+ `DynamodbUnnestDDBJson` : booléen.

  Valeur booléenne qui indique s’il faut désimbriquer le format DynamoDB JSON lors de l’extraction des données. Lorsque cette valeur est définie sur `true`, le connecteur aplatit les structures JSON imbriquées à partir d’éléments DynamoDB. Lorsque cette valeur est définie sur `false`, la structure JSON DynamoDB d’origine est préservée.
+ `DynamodbTableArn` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Amazon Resource Name (ARN) de la table DynamoDB à partir de laquelle extraire les données. Ce paramètre spécifie la table source pour l’opération ELT. 
+ `DynamodbS3Bucket` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Nom du compartiment Amazon S3 utilisé pour le stockage intermédiaire pendant le processus DynamoDB ELT. Ce compartiment est utilisé pour stocker temporairement les données DynamoDB exportées avant qu’elles ne soient traitées par la tâche ELT.
+ `DynamodbS3Prefix` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Préfixe de clé d’objet S3 pour les fichiers stockés dans le compartiment S3 intermédiaire pendant le processus DynamoDB ELT. Ce préfixe permet d’organiser et d’identifier les fichiers temporaires créés lors de l’extraction des données.
+ `DynamodbS3BucketOwner` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  L'ID de AWS compte du propriétaire du compartiment S3 spécifié dans`DynamodbS3Bucket`. Ce paramètre est obligatoire lorsque le compartiment S3 appartient à un AWS compte différent de celui qui exécute la tâche ELT, ce qui permet un accès entre comptes au compartiment de stockage intermédiaire.
+ `DynamodbStsRoleArn` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Nom de ressource Amazon (ARN) du rôle de AWS Security Token Service (STS) à assumer pour accéder aux ressources DynamoDB et S3 pendant l'opération ELT. Ce rôle doit disposer des autorisations nécessaires pour lire dans la table DynamoDB et écrire dans le compartiment S3 intermédiaire. 

## DDBELTCatalogAdditionalOptions structure
<a name="aws-glue-api-visual-job-api-DDBELTCatalogAdditionalOptions"></a>

Indique des options supplémentaires pour les opérations de catalogue DynamoDB ELT.

**Champs**
+ `DynamodbExport` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Indique la configuration d’exportation DynamoDB pour l’opération ELT.
+ `DynamodbUnnestDDBJson` : booléen.

  Indique s’il faut annuler l’imbrication du format JSON DynamoDB. Lorsque cette valeur est définie sur `true`, les structures JSON imbriquées dans les éléments DynamoDB sont aplaties.

## Structure de route
<a name="aws-glue-api-visual-job-api-Route"></a>

Spécifie un nœud de route qui dirige les données vers différents chemins de sortie en fonction de conditions de filtrage définies.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #63](aws-glue-api-common.md#regex_63).

  Nom du nœud de route.
+ `Inputs` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 1 chaîne maximum.

  Connexion d’entrée pour le nœud de route.
+ `GroupFiltersList` – *Obligatoire :* un tableau d’objets [GroupFilters](#aws-glue-api-visual-job-api-GroupFilters).

  Liste de filtres de groupe qui définissent les conditions de routage et les critères permettant de diriger les données vers différents chemins de sortie.

## GroupFilters structure
<a name="aws-glue-api-visual-job-api-GroupFilters"></a>

Spécifie un groupe de filtres avec un opérateur logique qui détermine la manière dont les filtres sont combinés pour évaluer les conditions de routage.

**Champs**
+ `GroupName` – *Obligatoire :* Chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Nom du groupe de filtres.
+ `Filters` – *Obligatoire :* un tableau d’objets [FilterExpression](#aws-glue-api-visual-job-api-FilterExpression).

  Liste d’expressions de filtre qui définissent les conditions pour ce groupe.
+ `LogicalOperator` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `AND` \$1 `OR`).

  Opérateur logique utilisé pour combiner les filtres de ce groupe. Détermine si tous les filtres doivent correspondre (AND) ou si n’importe quel filtre peut correspondre (OR).

## AutoDataQuality structure
<a name="aws-glue-api-visual-job-api-AutoDataQuality"></a>

Spécifie les options de configuration pour l'évaluation automatique de la qualité des données dans les AWS Glue tâches. Cette structure permet des contrôles et une surveillance automatisés de la qualité des données pendant les opérations ETL, ce qui contribue à garantir l’intégrité et la fiabilité des données sans intervention manuelle.

**Champs**
+ `IsEnabled` : booléen.

  Indique si l’évaluation automatique de la qualité des données est activée. Lorsque ce paramètre est défini sur `true`, les contrôles de qualité des données sont effectués automatiquement.
+ `EvaluationContext` – Chaîne UTF-8, correspondant au [Custom string pattern #61](aws-glue-api-common.md#regex_61).

  Le contexte d’évaluation pour les contrôles automatiques de qualité des données. Cela définit la portée et les paramètres de l’évaluation de la qualité des données.

# API de tâches
<a name="aws-glue-api-jobs"></a>

L'API Jobs décrit les types de données des tâches et contient des informations APIs permettant d'utiliser les tâches, les exécutions de tâches et les déclencheurs AWS Glue.

**Topics**
+ [Tâches](aws-glue-api-jobs-job.md)
+ [Exécutions de tâches](aws-glue-api-jobs-runs.md)
+ [Triggers](aws-glue-api-jobs-trigger.md)

# Tâches
<a name="aws-glue-api-jobs-job"></a>

L'API Jobs décrit les types de données et l'API liés à la création, à la mise à jour, à la suppression ou à l'affichage des jobs dans AWS Glue.

## Types de données
<a name="aws-glue-api-jobs-job-objects"></a>
+ [Structure Job](#aws-glue-api-jobs-job-Job)
+ [ExecutionProperty structure](#aws-glue-api-jobs-job-ExecutionProperty)
+ [NotificationProperty structure](#aws-glue-api-jobs-job-NotificationProperty)
+ [JobCommand structure](#aws-glue-api-jobs-job-JobCommand)
+ [ConnectionsList structure](#aws-glue-api-jobs-job-ConnectionsList)
+ [JobUpdate structure](#aws-glue-api-jobs-job-JobUpdate)
+ [SourceControlDetails structure](#aws-glue-api-jobs-job-SourceControlDetails)

## Structure Job
<a name="aws-glue-api-jobs-job-Job"></a>

Spécifie une définition de la tâche.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom que vous affectez à la définition de la tâche.
+ `JobMode` – Chaîne UTF-8 (valeurs valides : `SCRIPT=""` \$1 `VISUAL=""` \$1 `NOTEBOOK=""`).

  Mode qui décrit la façon dont une tâche a été créée. Les valeurs valides sont :
  + `SCRIPT`- La tâche a été créée à l'aide de l'éditeur de script AWS Glue Studio.
  + `VISUAL`- La tâche a été créée à l'aide de l'éditeur visuel AWS Glue Studio.
  + `NOTEBOOK` : la tâche a été créée à l’aide d’un bloc-notes de sessions interactives.

  Lorsque le champ `JobMode` est manquant ou a la valeur null, `SCRIPT` est attribué comme valeur par défaut.
+ `JobRunQueuingEnabled` : booléen.

  Indique si la mise en file d’attente des exécutions de tâches est activée pour les exécutions de cette tâche.

  La valeur true signifie que la mise en file d’attente des tâches est activée pour les exécutions de tâches. Si la valeur est false ou si elle n’est pas renseignée, les exécutions de tâches ne seront pas prises en compte pour la mise en file d’attente.

  Si ce champ ne correspond pas à la valeur définie dans l’exécution de la tâche, la valeur du champ d’exécution de la tâche sera utilisée.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de la tâche.
+ `LogUri` – Chaîne UTF-8.

  Ce champ est réservé pour un usage futur.
+ `Role` – Chaîne UTF-8.

  Nom ou Amazon Resource Name (ARN) du rôle IAM associé à cette tâche.
+ `CreatedOn` – Horodatage.

  Date et heure de création de la définition de tâche.
+ `LastModifiedOn` – Horodatage.

  Dernier moment où la définition de tâche a été modifiée.
+ `ExecutionProperty` – Un objet [ExecutionProperty](#aws-glue-api-jobs-job-ExecutionProperty).

  Objet `ExecutionProperty` spécifiant le nombre maximal d'exécutions simultanées autorisées pour cette tâche.
+ `Command` – Un objet [JobCommand](#aws-glue-api-jobs-job-JobCommand).

  La commande `JobCommand` qui exécute cette tâche.
+ `DefaultArguments` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Les arguments par défaut pour chaque exécution de cette tâche, spécifiés en tant que paires nom-valeur.

  Vous pouvez spécifier ici les arguments que votre propre script d'exécution de tâches consomme, ainsi que les arguments qu'il consomme AWS Glue lui-même.

  Les arguments de la tâche peuvent être consignés. Ne transmettez pas de secrets en texte clair comme arguments. Récupérez les secrets d'une AWS Glue connexion AWS Secrets Manager ou d'un autre mécanisme de gestion des secrets si vous avez l'intention de les conserver dans le cadre du Job. 

  Pour plus d'informations sur la façon de spécifier et d'utiliser vos propres arguments Job, consultez la rubrique [Calling AWS Glue APIs in Python](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) du guide du développeur.

  Pour plus d'informations sur les arguments que vous pouvez fournir dans ce champ lors de la configuration des tâches Spark, consultez la rubrique [Special Parameters Used by AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) dans le guide du développeur.

  Pour plus d'informations sur les arguments que vous pouvez fournir dans ce champ lors de la configuration des tâches Ray, consultez [Utilisation des paramètres de tâches dans les tâches Ray](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html) dans le guide du développeur.
+ `NonOverridableArguments` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Les arguments de cette tâche qui ne sont pas remplacés lorsque vous fournissez des arguments de tâche dans le cadre d'une exécution de tâche, spécifiés sous forme de paires nom-valeur.
+ `Connections` – Un objet [ConnectionsList](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ConnectionsList).

  Connexions utilisées pour la tâche.
+ `MaxRetries` : nombre (entier).

  Nombre maximal de fois que vous pouvez réessayer cette tâche après un JobRun échec.
+ `AllocatedCapacity` : nombre (entier).

  Ce champ est obsolète. Utilisez `MaxCapacity` à la place.

  Nombre d'unités de traitement de AWS Glue données (DPUs) allouées aux exécutions de cette tâche. Vous pouvez en allouer au moins 2 DPUs ; la valeur par défaut est 10. Un DPU est une mesure relative de la puissance de traitement composée de 4 V de capacité CPUs de calcul et de 16 Go de mémoire. Pour plus d'informations, consultez la page de tarification [AWS Glue](https://aws.amazon.com/glue/pricing/).

  
+ `Timeout` – Nombre (entier), au moins égal à 1.

  Délai d'expiration de la tâche en minutes. Durée maximale durant laquelle une tâche exécutée peut consommer des ressources avant qu'elle ne se termine et n'entre dans l'état `TIMEOUT`.

  Les tâches doivent avoir des valeurs de délai d’expiration inférieures à 7 jours ou 10 080 minutes. Dans le cas contraire, les tâches déclencheront une exception.

  Si aucune valeur n’est indiquée, le délai d’expiration est défini par défaut sur 2 880 minutes.

  Toutes les AWS Glue tâches existantes dont le délai d'expiration est supérieur à 7 jours seront définies par défaut sur 7 jours. Par exemple, si vous avez spécifié un délai d’expiration de 20 jours pour un traitement par lots, celui-ci sera arrêté le 7e jour.

  Pour les tâches de streaming, si vous avez défini une fenêtre de maintenance, elles seront redémarrées au cours de celle-ci au bout de sept jours.
+ `MaxCapacity` – Nombre (double).

  Pour les tâches Glue version 1.0 ou antérieures, en utilisant le type de travailleur standard, le nombre d'unités de traitement des AWS Glue données (DPUs) qui peuvent être allouées lors de l'exécution de cette tâche. Un DPU est une mesure relative de la puissance de traitement composée de 4 V de capacité CPUs de calcul et de 16 Go de mémoire. Pour plus d'informations, consultez la page de tarification [AWS Glue](https://aws.amazon.com/glue/pricing/).

  Pour les tâches des versions 2.0 ou ultérieures de Glue, vous ne pouvez pas spécifier de `Maximum capacity`. Au lieu de cela, vous devez spécifier `Worker type` et `Number of workers`.

  Ne définissez pas `MaxCapacity` si vous utilisez `WorkerType` et `NumberOfWorkers`.

  La valeur pouvant être attribuée à `MaxCapacity` varie selon que vous exécutez une tâche shell Python, une tâche ETL Apache Spark ou une tâche ETL Apache Spark Streaming :
  + Lorsque vous spécifiez une tâche shell Python (`JobCommand.Name`="pythonshell"), vous pouvez allouer 0,0625 ou 1 DPU. La valeur par défaut correspond à 0,0625 DPU.
  + Lorsque vous spécifiez une tâche ETL Apache Spark (`JobCommand.Name`="glueetl ») ou une tâche ETL de streaming Apache Spark (`JobCommand.Name`="gluestreaming »), vous pouvez en allouer de 2 à 100. DPUs La valeur par défaut est 10 DPUs. Ce type de tâche ne peut pas avoir une allocation DPU fractionnée.
+ `WorkerType`— Chaîne UTF-8 (valeurs valides : `Standard=""` \$1 \$1 `G.025X=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `G.12X=""` \$1 `G.16X=""` \$1 `R.1X=""` \$1 `R.2X=""` `R.4X=""` `R.8X=""` \$1`Z.2X=""`).

  Type de travail prédéfini qui est alloué lorsqu'une tâche est exécutée.

  AWS Glue propose plusieurs types de travailleurs pour répondre aux différentes exigences de charge de travail :

  Types de travailleurs G (travailleurs de calcul à usage général) :
  + G.025X : 0,25 DPU (2 VCPUs, 4 Go de mémoire, 84 Go de disque)
  + G.1 X : 1 processeur (4 VCPUs, 16 Go de mémoire, 94 Go de disque)
  + G.2X : 2 processeurs (8 VCPUs, 32 Go de mémoire, 138 Go de disque)
  + G.4X : 4 processeurs (16 VCPUs, 64 Go de mémoire, 256 Go de disque)
  + G.8X : 8 DPU (32 VCPUs, 128 Go de mémoire, 512 Go de disque)
  + G.12X : 12 DPU (48 VCPUs, 192 Go de mémoire, 768 Go de disque)
  + G.16X : 16 DPU (64 VCPUs, 256 Go de mémoire, 1024 Go de disque)

  Types de travailleurs R (travailleurs optimisés pour la mémoire) :
  + R.1X : 1 processeur (4 VCPUs, 32 Go de mémoire, 94 Go de disque)
  + R.2X : 2 processeurs (8 VCPUs, 64 Go de mémoire, 128 Go de disque)
  + R.4X : 4 processeurs (16 VCPUs, 128 Go de mémoire, 256 Go de disque)
  + R.8X : 8 DPU (32 VCPUs, 256 Go de mémoire, 512 Go de disque)
+ `NumberOfWorkers` : nombre (entier).

  Nombre de travaux d'un `workerType` défini qui sont attribués lorsqu'une tâche est exécutée.
+ `SecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la structure `SecurityConfiguration` à utiliser avec cette tâche.
+ `NotificationProperty` – Un objet [NotificationProperty](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-NotificationProperty).

  Spécifie les propriétés de configuration d'une notification de tâche.
+ `Running` : booléen.

  Ce champ est réservé pour un usage futur.
+ `GlueVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Dans les tâches Spark, `GlueVersion` détermine les versions d'Apache Spark et de Python AWS Glue disponibles dans une tâche. La version de Python indique la version prise en charge pour les tâches de type Spark. 

  Les tâches Ray doivent définir `GlueVersion` sur `4.0` ou supérieur. Toutefois, les versions de Ray, de Python et des bibliothèques supplémentaires disponibles dans votre tâche Ray sont déterminées par le paramètre `Runtime` de la commande de tâche.

  Pour plus d'informations sur les AWS Glue versions disponibles et les versions correspondantes de Spark et Python, consultez [la version de Glue](https://docs.aws.amazon.com/glue/latest/dg/add-job.html) dans le guide du développeur.

  Les tâches créées sans que la version de Glue soit spécifiée sont des tâches Glue 0.9 par défaut.
+ `CodeGenConfigurationNodes` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Chaque valeur est un objet [CodeGenConfigurationNode](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CodeGenConfigurationNode).

  Représentation d'un graphe orienté acyclique sur lequel le composant visuel Glue Studio et la génération de code Glue Studio sont basés.
+ `ExecutionClass` – Chaîne UTF-8, d'une longueur maximale de 16 octets (valeurs valides : `FLEX=""` \$1 `STANDARD=""`).

  Indique si la tâche est exécutée avec une classe d'exécution standard ou flexible. La classe d'exécution standard est idéale pour les charges de travail sensibles au temps qui nécessitent un démarrage rapide des tâches et des ressources dédiées.

  La classe d'exécution flexible, adaptée aux tâches non urgentes dont les heures de début et de fin peuvent varier. 

  Seules les tâches dotées de AWS Glue la version 3.0 ou supérieure et du type de commande `glueetl` seront autorisées à être définies `ExecutionClass` sur`FLEX`. La classe d'exécution flexible est disponible pour les tâches Spark.
+ `SourceControlDetails` – Un objet [SourceControlDetails](#aws-glue-api-jobs-job-SourceControlDetails).

  Les détails d'une configuration de contrôle source pour une tâche, permettant la synchronisation des artefacts de la tâche vers ou depuis un référentiel distant.
+ `MaintenanceWindow` – Chaîne UTF-8, correspondant au [Custom string pattern #34](aws-glue-api-common.md#regex_34).

  Ce champ indique un jour de la semaine et une heure pour une fenêtre de maintenance pour les tâches de streaming. AWS Glue effectue périodiquement des activités de maintenance. Au cours de ces fenêtres de maintenance, vous AWS Glue devrez redémarrer vos tâches de streaming.

  AWS Glue redémarrera le travail dans les 3 heures suivant la période de maintenance spécifiée. Par exemple, si vous configurez la fenêtre de maintenance pour le lundi à 10h00 GMT, vos tâches seront redémarrées entre 10h00 GMT et 13h00 GMT.
+ `ProfileName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom d'un profil AWS Glue d'utilisation associé à la tâche.

## ExecutionProperty structure
<a name="aws-glue-api-jobs-job-ExecutionProperty"></a>

Propriété d'exécution d'une tâche.

**Champs**
+ `MaxConcurrentRuns` : nombre (entier).

  Nombre maximal d'exécutions simultanées autorisées pour la tâche. La valeur par défaut est 1. Une erreur est renvoyée lorsque ce seuil est atteint. La valeur maximale que vous pouvez spécifier est contrôlée par une limite de service.

## NotificationProperty structure
<a name="aws-glue-api-jobs-job-NotificationProperty"></a>

Spécifie les propriétés de configuration d'une notification.

**Champs**
+ `NotifyDelayAfter` – Nombre (entier), au moins égal à 1.

  Après le démarrage d'une exécution de tâche, nombre de minutes d'attente avant l'envoi d'une notification de délai d'exécution de tâche.

## JobCommand structure
<a name="aws-glue-api-jobs-job-JobCommand"></a>

Spécifie le code exécuté lorsqu'une tâche est exécutée.

**Champs**
+ `Name` – Chaîne UTF-8.

  Nom de la commande de tâche. Pour une tâche ETL Apache Spark, cette valeur doit être `glueetl`. Pour un shell Python, elle doit être `pythonshell`. Pour une tâche ETL Apache Spark Streaming, elle doit correspondre à `gluestreaming`. Pour une tâche Ray, cela doit être `glueray`.
+ `ScriptLocation` – Chaîne UTF-8, d'une longueur maximale de 400 000 octets.

  Spécifie le chemin d'accès Amazon Simple Storage Service (Amazon S3) à un script qui exécute une tâche.
+ `PythonVersion` – Chaîne UTF-8, correspondant au [Custom string pattern #49](aws-glue-api-common.md#regex_49).

  Version Python utilisée pour exécuter une tâche shell Python. Les valeurs autorisées sont 2 ou 3.
+ `Runtime` : chaîne UTF-8, d'une longueur ne dépassant pas 64 octets, correspondant au [Custom string pattern #33](aws-glue-api-common.md#regex_33).

  Dans les tâches Ray, l'exécution est utilisée pour spécifier les versions de Ray, de Python et des bibliothèques supplémentaires disponibles dans votre environnement. Ce champ n'est pas utilisé dans les autres types de tâches. Pour connaître les valeurs d'environnement d'exécution prises [en charge, consultez la section Environnements d'exécution Ray pris](https://docs.aws.amazon.com/glue/latest/dg/ray-jobs-section.html) en charge dans le manuel du AWS Glue développeur.

## ConnectionsList structure
<a name="aws-glue-api-jobs-job-ConnectionsList"></a>

Spécifie les connexions utilisées par une tâche.

**Champs**
+ `Connections` – Tableau de chaînes UTF-8, avec 1 000 chaînes maximum.

  Liste de connexions utilisées par la tâche.

## JobUpdate structure
<a name="aws-glue-api-jobs-job-JobUpdate"></a>

Spécifie les informations utilisées pour mettre à jour une définition de tâche. La définition de tâche précédente est entièrement remplacée par ces informations.

**Champs**
+ `JobMode` – Chaîne UTF-8 (valeurs valides : `SCRIPT=""` \$1 `VISUAL=""` \$1 `NOTEBOOK=""`).

  Mode qui décrit la façon dont une tâche a été créée. Les valeurs valides sont :
  + `SCRIPT`- La tâche a été créée à l'aide de l'éditeur de script AWS Glue Studio.
  + `VISUAL`- La tâche a été créée à l'aide de l'éditeur visuel AWS Glue Studio.
  + `NOTEBOOK` : la tâche a été créée à l’aide d’un bloc-notes de sessions interactives.

  Lorsque le champ `JobMode` est manquant ou a la valeur null, `SCRIPT` est attribué comme valeur par défaut.
+ `JobRunQueuingEnabled` : booléen.

  Indique si la mise en file d’attente des exécutions de tâches est activée pour les exécutions de cette tâche.

  La valeur true signifie que la mise en file d’attente des tâches est activée pour les exécutions de tâches. Si la valeur est false ou si elle n’est pas renseignée, les exécutions de tâches ne seront pas prises en compte pour la mise en file d’attente.

  Si ce champ ne correspond pas à la valeur définie dans l’exécution de la tâche, la valeur du champ d’exécution de la tâche sera utilisée.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de la tâche définie.
+ `LogUri` – Chaîne UTF-8.

  Ce champ est réservé pour un usage futur.
+ `Role` – Chaîne UTF-8.

  Nom ou Amazon Resource Name (ARN) du rôle IAM associé à cette tâche (obligatoire).
+ `ExecutionProperty` – Un objet [ExecutionProperty](#aws-glue-api-jobs-job-ExecutionProperty).

  Objet `ExecutionProperty` spécifiant le nombre maximal d'exécutions simultanées autorisées pour cette tâche.
+ `Command` – Un objet [JobCommand](#aws-glue-api-jobs-job-JobCommand).

  Objet `JobCommand` qui exécute cette tâche (obligatoire).
+ `DefaultArguments` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Les arguments par défaut pour chaque exécution de cette tâche, spécifiés en tant que paires nom-valeur.

  Vous pouvez spécifier ici les arguments que votre propre script d'exécution de tâches consomme, ainsi que les arguments qu'il consomme AWS Glue lui-même.

  Les arguments de la tâche peuvent être consignés. Ne transmettez pas de secrets en texte clair comme arguments. Récupérez les secrets d'une AWS Glue connexion AWS Secrets Manager ou d'un autre mécanisme de gestion des secrets si vous avez l'intention de les conserver dans le cadre du Job. 

  Pour plus d'informations sur la façon de spécifier et d'utiliser vos propres arguments Job, consultez la rubrique [Calling AWS Glue APIs in Python](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) du guide du développeur.

  Pour plus d'informations sur les arguments que vous pouvez fournir dans ce champ lors de la configuration des tâches Spark, consultez la rubrique [Special Parameters Used by AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) dans le guide du développeur.

  Pour plus d'informations sur les arguments que vous pouvez fournir dans ce champ lors de la configuration des tâches Ray, consultez [Utilisation des paramètres de tâches dans les tâches Ray](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html) dans le guide du développeur.
+ `NonOverridableArguments` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Les arguments de cette tâche qui ne sont pas remplacés lorsque vous fournissez des arguments de tâche dans le cadre d'une exécution de tâche, spécifiés sous forme de paires nom-valeur.
+ `Connections` – Un objet [ConnectionsList](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ConnectionsList).

  Connexions utilisées pour la tâche.
+ `MaxRetries` : nombre (entier).

  Nombre maximum de tentatives de cette tâche en cas d'échec.
+ `AllocatedCapacity` : nombre (entier).

  Ce champ est obsolète. Utilisez `MaxCapacity` à la place.

  Nombre d'unités de traitement de AWS Glue données (DPUs) à allouer à cette tâche. Vous pouvez en allouer au moins 2 DPUs ; la valeur par défaut est 10. Un DPU est une mesure relative de la puissance de traitement composée de 4 V de capacité CPUs de calcul et de 16 Go de mémoire. Pour plus d'informations, consultez la page de tarification [AWS Glue](https://aws.amazon.com/glue/pricing/).
+ `Timeout` – Nombre (entier), au moins égal à 1.

  Délai d'expiration de la tâche en minutes. Durée maximale durant laquelle une tâche exécutée peut consommer des ressources avant qu'elle ne se termine et n'entre dans l'état `TIMEOUT`.

  Les tâches doivent avoir des valeurs de délai d’expiration inférieures à 7 jours ou 10 080 minutes. Dans le cas contraire, les tâches déclencheront une exception.

  Si aucune valeur n’est indiquée, le délai d’expiration est défini par défaut sur 2 880 minutes.

  Toutes les AWS Glue tâches existantes dont le délai d'expiration est supérieur à 7 jours seront définies par défaut sur 7 jours. Par exemple, si vous avez spécifié un délai d’expiration de 20 jours pour un traitement par lots, celui-ci sera arrêté le 7e jour.

  Pour les tâches de streaming, si vous avez défini une fenêtre de maintenance, elles seront redémarrées au cours de celle-ci au bout de sept jours.
+ `MaxCapacity` – Nombre (double).

  Pour les tâches Glue version 1.0 ou antérieures, en utilisant le type de travailleur standard, le nombre d'unités de traitement des AWS Glue données (DPUs) qui peuvent être allouées lors de l'exécution de cette tâche. Un DPU est une mesure relative de la puissance de traitement composée de 4 V de capacité CPUs de calcul et de 16 Go de mémoire. Pour plus d'informations, consultez la page de tarification [AWS Glue](https://aws.amazon.com/glue/pricing/).

  Pour les tâches des versions 2.0 et ultérieures de Glue, vous ne pouvez pas spécifier un `Maximum capacity`. Au lieu de cela, vous devez spécifier `Worker type` et `Number of workers`.

  Ne définissez pas `MaxCapacity` si vous utilisez `WorkerType` et `NumberOfWorkers`.

  La valeur pouvant être attribuée à `MaxCapacity` varie selon que vous exécutez une tâche shell Python, une tâche ETL Apache Spark ou une tâche ETL Apache Spark Streaming :
  + Lorsque vous spécifiez une tâche shell Python (`JobCommand.Name`="pythonshell"), vous pouvez allouer 0,0625 ou 1 DPU. La valeur par défaut correspond à 0,0625 DPU.
  + Lorsque vous spécifiez une tâche ETL Apache Spark (`JobCommand.Name`="glueetl ») ou une tâche ETL de streaming Apache Spark (`JobCommand.Name`="gluestreaming »), vous pouvez en allouer de 2 à 100. DPUs La valeur par défaut est 10 DPUs. Ce type de tâche ne peut pas avoir une allocation DPU fractionnée.
+ `WorkerType`— Chaîne UTF-8 (valeurs valides : `Standard=""` \$1 \$1 `G.025X=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `G.12X=""` \$1 `G.16X=""` \$1 `R.1X=""` \$1 `R.2X=""` `R.4X=""` `R.8X=""` \$1`Z.2X=""`).

  Type de travail prédéfini qui est alloué lorsqu'une tâche est exécutée. Accepte une valeur de G.025X, G-1X, G.2X, G.4X, G.8X, G.12X, G.16X, R.1X, R.2X, R.4X ou R.8X pour les tâches Spark. Accepte la valeur Z.2X pour les tâches Ray. Pour plus d’informations, consultez [Defining job properties for Spark jobs](https://docs.aws.amazon.com/glue/latest/dg/add-job.html#create-job).
+ `NumberOfWorkers` : nombre (entier).

  Nombre de travaux d'un `workerType` défini qui sont attribués lorsqu'une tâche est exécutée.
+ `SecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la structure `SecurityConfiguration` à utiliser avec cette tâche.
+ `NotificationProperty` – Un objet [NotificationProperty](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-NotificationProperty).

  Spécifie les propriétés de configuration d'une notification de tâche.
+ `GlueVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Dans les tâches Spark, `GlueVersion` détermine les versions d'Apache Spark et de Python AWS Glue disponibles dans une tâche. La version de Python indique la version prise en charge pour les tâches de type Spark. 

  Les tâches Ray doivent définir `GlueVersion` sur `4.0` ou supérieur. Toutefois, les versions de Ray, de Python et des bibliothèques supplémentaires disponibles dans votre tâche Ray sont déterminées par le paramètre `Runtime` de la commande de tâche.

  Pour plus d'informations sur les AWS Glue versions disponibles et les versions correspondantes de Spark et Python, consultez [la version de Glue](https://docs.aws.amazon.com/glue/latest/dg/add-job.html) dans le guide du développeur.

  Les tâches créées sans que la version de Glue soit spécifiée sont des tâches Glue 0.9 par défaut.
+ `CodeGenConfigurationNodes` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Chaque valeur est un objet [CodeGenConfigurationNode](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CodeGenConfigurationNode).

  Représentation d'un graphe orienté acyclique sur lequel le composant visuel Glue Studio et la génération de code Glue Studio sont basés.
+ `ExecutionClass` – Chaîne UTF-8, d'une longueur maximale de 16 octets (valeurs valides : `FLEX=""` \$1 `STANDARD=""`).

  Indique si la tâche est exécutée avec une classe d'exécution standard ou flexible. La classe d'exécution standard est idéale pour les charges de travail urgentes qui nécessitent un démarrage rapide des tâches et des ressources dédiées.

  La classe d'exécution flexible, adaptée aux tâches non urgentes dont les heures de début et de fin peuvent varier. 

  Seules les tâches dotées de AWS Glue la version 3.0 ou supérieure et du type de commande `glueetl` seront autorisées à être définies `ExecutionClass` sur`FLEX`. La classe d'exécution flexible est disponible pour les tâches Spark.
+ `SourceControlDetails` – Un objet [SourceControlDetails](#aws-glue-api-jobs-job-SourceControlDetails).

  Les détails d'une configuration de contrôle source pour une tâche, permettant la synchronisation des artefacts de la tâche vers ou depuis un référentiel distant.
+ `MaintenanceWindow` – Chaîne UTF-8, correspondant au [Custom string pattern #34](aws-glue-api-common.md#regex_34).

  Ce champ indique un jour de la semaine et une heure pour une fenêtre de maintenance pour les tâches de streaming. AWS Glue effectue périodiquement des activités de maintenance. Au cours de ces fenêtres de maintenance, vous AWS Glue devrez redémarrer vos tâches de streaming.

  AWS Glue redémarrera le travail dans les 3 heures suivant la période de maintenance spécifiée. Par exemple, si vous configurez la fenêtre de maintenance pour le lundi à 10h00 GMT, vos tâches seront redémarrées entre 10h00 GMT et 13h00 GMT.
+ `ProfileName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom d'un profil AWS Glue d'utilisation associé à la tâche.

## SourceControlDetails structure
<a name="aws-glue-api-jobs-job-SourceControlDetails"></a>

Les détails d'une configuration de contrôle source pour une tâche, permettant la synchronisation des artefacts de la tâche vers ou depuis un référentiel distant.

**Champs**
+ `Provider` – Chaîne UTF-8 (valeurs valides : `GITHUB` \$1 `AWS_CODE_COMMIT`).

  Le fournisseur du référentiel distant.
+ `Repository` – chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets.

  Le nom du référentiel distant qui contient les artefacts de la tâche.
+ `Owner` – chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets.

  Le propriétaire du référentiel distant qui contient les artefacts de la tâche.
+ `Branch` – chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets.

  Une branche facultative dans le référentiel distant.
+ `Folder` – chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets.

  Un dossier facultatif dans le référentiel distant.
+ `LastCommitId` – chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets.

  Le dernier identifiant de validation pour une validation dans le référentiel distant.
+ `LastSyncTimestamp` – chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets.

  La date et l'heure auxquelles la dernière synchronisation de la tâche a été effectuée.
+ `AuthStrategy` – Chaîne UTF-8 (valeurs valides : `PERSONAL_ACCESS_TOKEN` \$1 `AWS_SECRETS_MANAGER`).

  Le type d'authentification, qui peut être un jeton d'authentification stocké dans AWS Secrets Manager ou un jeton d'accès personnel.
+ `AuthToken` – chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets.

  La valeur d'un jeton d'autorisation.

## Opérations
<a name="aws-glue-api-jobs-job-actions"></a>
+ [CreateJob action (Python : create\$1job)](#aws-glue-api-jobs-job-CreateJob)
+ [UpdateJob action (Python : update\$1job)](#aws-glue-api-jobs-job-UpdateJob)
+ [GetJob action (Python : get\$1job)](#aws-glue-api-jobs-job-GetJob)
+ [GetJobs action (Python : get\$1jobs)](#aws-glue-api-jobs-job-GetJobs)
+ [DeleteJob action (Python : supprimer\$1tâche)](#aws-glue-api-jobs-job-DeleteJob)
+ [ListJobs action (Python : list\$1jobs)](#aws-glue-api-jobs-job-ListJobs)
+ [BatchGetJobs action (Python : batch\$1get\$1jobs)](#aws-glue-api-jobs-job-BatchGetJobs)

## CreateJob action (Python : create\$1job)
<a name="aws-glue-api-jobs-job-CreateJob"></a>

Crée une nouvelle définition de tâche.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom que vous affectez à la définition de la tâche. Doit être unique au sein de votre compte .
+ `JobMode` – Chaîne UTF-8 (valeurs valides : `SCRIPT=""` \$1 `VISUAL=""` \$1 `NOTEBOOK=""`).

  Mode qui décrit la façon dont une tâche a été créée. Les valeurs valides sont :
  + `SCRIPT`- La tâche a été créée à l'aide de l'éditeur de script AWS Glue Studio.
  + `VISUAL`- La tâche a été créée à l'aide de l'éditeur visuel AWS Glue Studio.
  + `NOTEBOOK` : la tâche a été créée à l’aide d’un bloc-notes de sessions interactives.

  Lorsque le champ `JobMode` est manquant ou a la valeur null, `SCRIPT` est attribué comme valeur par défaut.
+ `JobRunQueuingEnabled` : booléen.

  Indique si la mise en file d’attente des exécutions de tâches est activée pour les exécutions de cette tâche.

  La valeur true signifie que la mise en file d’attente des tâches est activée pour les exécutions de tâches. Si la valeur est false ou si elle n’est pas renseignée, les exécutions de tâches ne seront pas prises en compte pour la mise en file d’attente.

  Si ce champ ne correspond pas à la valeur définie dans l’exécution de la tâche, la valeur du champ d’exécution de la tâche sera utilisée.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de la tâche définie.
+ `LogUri` – Chaîne UTF-8.

  Ce champ est réservé pour un usage futur.
+ `Role` – *Obligatoire :* chaîne UTF-8.

  Nom ou Amazon Resource Name (ARN) du rôle IAM associé à cette tâche.
+ `ExecutionProperty` – Un objet [ExecutionProperty](#aws-glue-api-jobs-job-ExecutionProperty).

  Objet `ExecutionProperty` spécifiant le nombre maximal d'exécutions simultanées autorisées pour cette tâche.
+ `Command` – *Obligatoire :* un objet [JobCommand](#aws-glue-api-jobs-job-JobCommand).

  La commande `JobCommand` qui exécute cette tâche.
+ `DefaultArguments` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Les arguments par défaut pour chaque exécution de cette tâche, spécifiés en tant que paires nom-valeur.

  Vous pouvez spécifier ici les arguments que votre propre script d'exécution de tâches consomme, ainsi que les arguments qu'il consomme AWS Glue lui-même.

  Les arguments de la tâche peuvent être consignés. Ne transmettez pas de secrets en texte clair comme arguments. Récupérez les secrets d'une AWS Glue connexion AWS Secrets Manager ou d'un autre mécanisme de gestion des secrets si vous avez l'intention de les conserver dans le cadre du Job. 

  Pour plus d'informations sur la façon de spécifier et d'utiliser vos propres arguments Job, consultez la rubrique [Calling AWS Glue APIs in Python](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) du guide du développeur.

  Pour plus d'informations sur les arguments que vous pouvez fournir dans ce champ lors de la configuration des tâches Spark, consultez la rubrique [Special Parameters Used by AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) dans le guide du développeur.

  Pour plus d'informations sur les arguments que vous pouvez fournir dans ce champ lors de la configuration des tâches Ray, consultez [Utilisation des paramètres de tâches dans les tâches Ray](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html) dans le guide du développeur.
+ `NonOverridableArguments` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Les arguments de cette tâche qui ne sont pas remplacés lorsque vous fournissez des arguments de tâche dans le cadre d'une exécution de tâche, spécifiés sous forme de paires nom-valeur.
+ `Connections` – Un objet [ConnectionsList](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ConnectionsList).

  Connexions utilisées pour la tâche.
+ `MaxRetries` : nombre (entier).

  Nombre maximum de tentatives de cette tâche en cas d'échec.
+ `AllocatedCapacity` : nombre (entier).

  Ce paramètre est obsolète. Utilisez `MaxCapacity` à la place.

  Le nombre d'unités de traitement de AWS Glue données (DPUs) à allouer à ce Job. Vous pouvez en allouer au moins 2 DPUs ; la valeur par défaut est 10. Un DPU est une mesure relative de la puissance de traitement composée de 4 V de capacité CPUs de calcul et de 16 Go de mémoire. Pour plus d'informations, consultez la page de tarification [AWS Glue](https://aws.amazon.com/glue/pricing/).
+ `Timeout` – Nombre (entier), au moins égal à 1.

  Délai d'expiration de la tâche en minutes. Durée maximale durant laquelle une tâche exécutée peut consommer des ressources avant qu'elle ne se termine et n'entre dans l'état `TIMEOUT`.

  Les tâches doivent avoir des valeurs de délai d’expiration inférieures à 7 jours ou 10 080 minutes. Dans le cas contraire, les tâches déclencheront une exception.

  Si aucune valeur n’est indiquée, le délai d’expiration est défini par défaut sur 2 880 minutes.

  Toutes les AWS Glue tâches existantes dont le délai d'expiration est supérieur à 7 jours seront définies par défaut sur 7 jours. Par exemple, si vous avez spécifié un délai d’expiration de 20 jours pour un traitement par lots, celui-ci sera arrêté le 7e jour.

  Pour les tâches de streaming, si vous avez défini une fenêtre de maintenance, elles seront redémarrées au cours de celle-ci au bout de sept jours.
+ `MaxCapacity` – Nombre (double).

  Pour les tâches Glue version 1.0 ou antérieures, en utilisant le type de travailleur standard, le nombre d'unités de traitement des AWS Glue données (DPUs) qui peuvent être allouées lors de l'exécution de cette tâche. Un DPU est une mesure relative de la puissance de traitement composée de 4 V de capacité CPUs de calcul et de 16 Go de mémoire. Pour plus d'informations, consultez la page de tarification [AWS Glue](https://aws.amazon.com/glue/pricing/).

  Pour les tâches des versions 2.0 et ultérieures de Glue, vous ne pouvez pas spécifier un `Maximum capacity`. Au lieu de cela, vous devez spécifier `Worker type` et `Number of workers`.

  Ne définissez pas `MaxCapacity` si vous utilisez `WorkerType` et `NumberOfWorkers`.

  La valeur pouvant être attribuée à `MaxCapacity` varie selon que vous exécutez une tâche shell Python, une tâche ETL Apache Spark ou une tâche ETL Apache Spark Streaming :
  + Lorsque vous spécifiez une tâche shell Python (`JobCommand.Name`="pythonshell"), vous pouvez allouer 0,0625 ou 1 DPU. La valeur par défaut correspond à 0,0625 DPU.
  + Lorsque vous spécifiez une tâche ETL Apache Spark (`JobCommand.Name`="glueetl ») ou une tâche ETL de streaming Apache Spark (`JobCommand.Name`="gluestreaming »), vous pouvez en allouer de 2 à 100. DPUs La valeur par défaut est 10 DPUs. Ce type de tâche ne peut pas avoir une allocation DPU fractionnée.
+ `SecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la structure `SecurityConfiguration` à utiliser avec cette tâche.
+ `Tags` – tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Balises à utiliser avec cette tâche. Vous pouvez utiliser des balises pour limiter l'accès à la tâche. Pour plus d'informations sur les tags in AWS Glue, voir [AWS Tags in AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html) dans le guide du développeur.
+ `NotificationProperty` – Un objet [NotificationProperty](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-NotificationProperty).

  Spécifie les propriétés de configuration d'une notification de tâche.
+ `GlueVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Dans les tâches Spark, `GlueVersion` détermine les versions d'Apache Spark et de Python AWS Glue disponibles dans une tâche. La version de Python indique la version prise en charge pour les tâches de type Spark. 

  Les tâches Ray doivent définir `GlueVersion` sur `4.0` ou supérieur. Toutefois, les versions de Ray, de Python et des bibliothèques supplémentaires disponibles dans votre tâche Ray sont déterminées par le paramètre `Runtime` de la commande de tâche.

  Pour plus d'informations sur les AWS Glue versions disponibles et les versions correspondantes de Spark et Python, consultez [la version de Glue](https://docs.aws.amazon.com/glue/latest/dg/add-job.html) dans le guide du développeur.

  Les tâches créées sans que la version de Glue soit spécifiée sont des tâches Glue 0.9 par défaut.
+ `NumberOfWorkers` : nombre (entier).

  Nombre de travaux d'un `workerType` défini qui sont attribués lorsqu'une tâche est exécutée.
+ `WorkerType`— Chaîne UTF-8 (valeurs valides : `Standard=""` \$1 \$1 `G.025X=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `G.12X=""` \$1 `G.16X=""` \$1 `R.1X=""` \$1 `R.2X=""` `R.4X=""` `R.8X=""` \$1`Z.2X=""`).

  Type de travail prédéfini qui est alloué lorsqu'une tâche est exécutée. Accepte une valeur de G.025X, G-1X, G.2X, G.4X, G.8X, G.12X, G.16X, R.1X, R.2X, R.4X ou R.8X pour les tâches Spark. Accepte la valeur Z.2X pour les tâches Ray.
  + Pour le type de `G.025X` worker, chaque worker est mappé sur 0,25 DPU (2 vCPUs, 4 Go de mémoire) avec un disque de 84 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type d’employé pour les travaux de streaming à faible volume. Ce type de travailleur n'est disponible que pour les tâches de streaming en AWS Glue version 3.0 ou ultérieure.
  + Pour le type de `G.1X` worker, chaque worker est mappé à 1 DPU (4 vCPUs, 16 Go de mémoire) avec un disque de 94 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type de travailleur pour les charges de travail telles que les transformations de données, les jointures et les requêtes, afin de proposer un moyen évolutif et rentable d'exécuter la plupart des tâches.
  + Pour le type de `G.2X` travailleur, chaque utilisateur est mappé sur 2 DPU (8 VCPUs, 32 Go de mémoire) avec un disque de 138 Go et fournit un exécuteur par travailleur. Nous recommandons ce type de travailleur pour les charges de travail telles que les transformations de données, les jointures et les requêtes, afin de proposer un moyen évolutif et rentable d'exécuter la plupart des tâches.
  + Pour le type de `G.4X` worker, chaque worker est mappé sur 4 DPU (16 vCPUs, 64 Go de mémoire) avec un disque de 256 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type de travailleur pour les tâches dont les charges de travail contiennent les transformations, les agrégations, les jointures et les requêtes les plus exigeantes. Ce type de travailleur est disponible uniquement pour les tâches Spark ETL AWS Glue version 3.0 ou ultérieure dans les AWS régions suivantes : USA Est (Ohio), USA Est (Virginie du Nord), USA Ouest (Californie du Nord), USA Ouest (Oregon), Asie-Pacifique (Mumbai), Asie-Pacifique (Séoul), Asie-Pacifique (Sydney), Asie-Pacifique (Tokyo), Canada (Centre), Europe (Francfort), Europe (Irlande), Europe (Londres), Europe (Espagne), Europe (Stockholm), et 
  + Pour le type de `G.8X` travailleur, chaque travailleur est mappé sur 8 DPU (32 vCPUs, 128 Go de mémoire) avec un disque de 512 Go et fournit un exécuteur par travailleur. Nous recommandons ce type de travailleur pour les tâches dont les charges de travail contiennent les transformations, les agrégations, les jointures et les requêtes les plus exigeantes. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 3.0 ou ultérieure, dans les mêmes AWS régions que celles prises en charge pour le type de `G.4X` travailleur.
  + Pour le type de `G.12X` travailleur, chaque travailleur est mappé sur 12 DPU (48 vCPUs, 192 Go de mémoire) avec 768 Go de disque, et fournit un exécuteur par travailleur. Nous recommandons ce type de travailleur pour les tâches comportant de très lourdes charges de travail. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `G.16X` worker, chaque worker est mappé sur 16 DPU (64 vCPUs, 256 Go de mémoire) avec un disque de 1024 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type de travailleur pour les tâches comportant de très lourdes charges de travail. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `R.1X` worker, chaque worker est mappé à 1 DPU (4 vCPUs, 32 Go de mémoire) avec un disque de 94 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type de travailleur pour les charges de travail gourmandes en mémoire. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `R.2X` worker, chaque worker est mappé sur 2 DPU (8 vCPUs, 64 Go de mémoire) avec un disque de 128 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type de travailleur pour les charges de travail gourmandes en mémoire. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `R.4X` travailleur, chaque travailleur est mappé sur 4 DPU (16 vCPUs, 128 Go de mémoire) avec un disque de 256 Go et fournit un exécuteur par travailleur. Nous recommandons ce type de travailleur pour les charges de travail gourmandes en mémoire. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `R.8X` travailleur, chaque utilisateur est mappé sur 8 DPU (32 VCPUs, 256 Go de mémoire) avec un disque de 512 Go et fournit un exécuteur par travailleur. Nous recommandons ce type de travailleur pour les charges de travail gourmandes en mémoire. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `Z.2X` travailleur, chaque utilisateur est mappé sur 2 M-DPU (8 VCPUs, 64 Go de mémoire) avec un disque de 128 Go, et fournit jusqu'à 8 processeurs Ray sur la base de l'autoscaler.
+ `CodeGenConfigurationNodes` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, correspondant au [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Chaque valeur est un objet [CodeGenConfigurationNode](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CodeGenConfigurationNode).

  Représentation d'un graphe orienté acyclique sur lequel le composant visuel Glue Studio et la génération de code Glue Studio sont basés.
+ `ExecutionClass` – Chaîne UTF-8, d'une longueur maximale de 16 octets (valeurs valides : `FLEX=""` \$1 `STANDARD=""`).

  Indique si la tâche est exécutée avec une classe d'exécution standard ou flexible. La classe d'exécution standard est idéale pour les charges de travail urgentes qui nécessitent un démarrage rapide des tâches et des ressources dédiées.

  La classe d'exécution flexible, adaptée aux tâches non urgentes dont les heures de début et de fin peuvent varier. 

  Seules les tâches dotées de AWS Glue la version 3.0 ou supérieure et du type de commande `glueetl` seront autorisées à être définies `ExecutionClass` sur`FLEX`. La classe d'exécution flexible est disponible pour les tâches Spark.
+ `SourceControlDetails` – Un objet [SourceControlDetails](#aws-glue-api-jobs-job-SourceControlDetails).

  Les détails d'une configuration de contrôle source pour une tâche, permettant la synchronisation des artefacts de la tâche vers ou depuis un référentiel distant.
+ `MaintenanceWindow` – Chaîne UTF-8, correspondant au [Custom string pattern #34](aws-glue-api-common.md#regex_34).

  Ce champ indique un jour de la semaine et une heure pour une fenêtre de maintenance pour les tâches de streaming. AWS Glue effectue périodiquement des activités de maintenance. Au cours de ces fenêtres de maintenance, vous AWS Glue devrez redémarrer vos tâches de streaming.

  AWS Glue redémarrera le travail dans les 3 heures suivant la période de maintenance spécifiée. Par exemple, si vous configurez la fenêtre de maintenance pour le lundi à 10h00 GMT, vos tâches seront redémarrées entre 10h00 GMT et 13h00 GMT.
+ `ProfileName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom d'un profil AWS Glue d'utilisation associé à la tâche.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom unique qui a été fourni pour cette définition de tâche.

**Erreurs**
+ `InvalidInputException`
+ `IdempotentParameterMismatchException`
+ `AlreadyExistsException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentModificationException`

## UpdateJob action (Python : update\$1job)
<a name="aws-glue-api-jobs-job-UpdateJob"></a>

Met à jour une définition de tâche. La définition de tâche précédente est entièrement remplacée par ces informations.

**Demande**
+ `JobName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la définition de tâche à mettre à jour.
+ `JobUpdate` – *Obligatoire :* un objet [JobUpdate](#aws-glue-api-jobs-job-JobUpdate).

  Spécifie les valeurs avec lesquelles mettre à jour la définition de la tâche. Toute configuration non spécifiée est supprimée ou réinitialisée aux valeurs par défaut.
+ `ProfileName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom d'un profil AWS Glue d'utilisation associé à la tâche.

**Réponse**
+ `JobName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Retourne le nom de la définition de tâche mise à jour.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`

## GetJob action (Python : get\$1job)
<a name="aws-glue-api-jobs-job-GetJob"></a>

Extrait une définition de tâche.

**Demande**
+ `JobName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la définition de tâche à extraire.

**Réponse**
+ `Job` – Un objet [Tâche](#aws-glue-api-jobs-job-Job).

  Définition de tâche requise.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetJobs action (Python : get\$1jobs)
<a name="aws-glue-api-jobs-job-GetJobs"></a>

Récupère toutes les définitions de tâche actuelles.

**Demande**
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Taille maximale de la réponse.

**Réponse**
+ `Jobs` : un tableau d’objets [Tâche](#aws-glue-api-jobs-job-Job).

  Liste des définitions de tâche.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, si toutes les définitions de tâche n'ont pas encore été renvoyées.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## DeleteJob action (Python : supprimer\$1tâche)
<a name="aws-glue-api-jobs-job-DeleteJob"></a>

Supprime une définition de tâche spécifiée. Si la définition de tâche est introuvable, aucune exception n'est levée.

**Demande**
+ `JobName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la définition de tâche à supprimer.

**Réponse**
+ `JobName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la définition de tâche qui a été supprimée.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## ListJobs action (Python : list\$1jobs)
<a name="aws-glue-api-jobs-job-ListJobs"></a>

Récupère les noms de toutes les ressources de travail de ce AWS compte ou des ressources portant le tag spécifié. Cette opération vous permet de voir quelles ressources sont disponibles dans votre compte, et leurs noms.

Cette opération accepte le champ `Tags` facultatif que vous pouvez utiliser comme filtre sur la réponse, afin que les ressources balisées puissent être récupérées en tant que groupe. Si vous choisissez d'utiliser le filtrage des balises, seules les ressources avec la balise sont récupérées.

**Demande**
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’une requête de continuation.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  La taille maximale d’une liste à renvoyer.
+ `Tags` – tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Spécifie de renvoyer uniquement les ressources balisées.

**Réponse**
+ `JobNames` – Tableau de chaînes UTF-8.

  Noms de toutes les tâches dans le compte ou des tâches avec les balises spécifiées.
+ `NextToken` – Chaîne UTF-8.

  Jeton continuation, si la liste renvoyée ne contient pas la dernière métrique disponible.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## BatchGetJobs action (Python : batch\$1get\$1jobs)
<a name="aws-glue-api-jobs-job-BatchGetJobs"></a>

Renvoie la liste des métadonnées de ressource pour une liste donnée de noms de tâche. Après avoir appelé l’opération `ListJobs`, vous pouvez appeler cette opération pour accéder aux données sur lesquelles des autorisations vous ont été octroyées. Cette opération prend en charge toutes les autorisations IAM, y compris les conditions d’autorisation qui utilisent des balises. 

**Demande**
+ `JobNames` – *obligatoire :* tableau de chaînes UTF-8.

  Liste des noms de tâche, qui peuvent être les noms renvoyés à partir de l'opération `ListJobs`.

**Réponse**
+ `Jobs` : un tableau d’objets [Tâche](#aws-glue-api-jobs-job-Job).

  Liste des définitions de tâche.
+ `JobsNotFound` – Tableau de chaînes UTF-8.

  Liste de noms de tâches introuvables.

**Erreurs**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`

# Exécutions de tâches
<a name="aws-glue-api-jobs-runs"></a>

 L'API Jobs Runs décrit les types de données et l'API liés au démarrage, à l'arrêt ou à la visualisation des exécutions de tâches, ainsi qu'à la réinitialisation des signets de tâches, dans. AWS Glue L’historique d’exécution des tâches est accessible pendant 90 jours pour votre flux de travail et l’exécution des tâches. 

## Types de données
<a name="aws-glue-api-jobs-runs-objects"></a>
+ [JobRun structure](#aws-glue-api-jobs-runs-JobRun)
+ [Structure de Predecessor](#aws-glue-api-jobs-runs-Predecessor)
+ [JobBookmarkEntry structure](#aws-glue-api-jobs-runs-JobBookmarkEntry)
+ [BatchStopJobRunSuccessfulSubmission structure](#aws-glue-api-jobs-runs-BatchStopJobRunSuccessfulSubmission)
+ [BatchStopJobRunError structure](#aws-glue-api-jobs-runs-BatchStopJobRunError)
+ [NotificationProperty structure](#aws-glue-api-jobs-runs-NotificationProperty)

## JobRun structure
<a name="aws-glue-api-jobs-runs-JobRun"></a>

Contient des informations à propos d'une exécution de tâche.

**Champs**
+ `Id` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de cette exécution de tâche.
+ `Attempt` : nombre (entier).

  Nombre de tentatives d'exécution de cette tâche.
+ `PreviousRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de l'exécution précédente de cette tâche. Par exemple, `JobRunId` spécifié dans l'action `StartJobRun`.
+ `TriggerName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du déclencheur ayant démarré cette exécution de tâche.
+ `JobName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la définition de tâche utilisée dans cette exécution.
+ `JobMode` – Chaîne UTF-8 (valeurs valides : `SCRIPT=""` \$1 `VISUAL=""` \$1 `NOTEBOOK=""`).

  Mode qui décrit la façon dont une tâche a été créée. Les valeurs valides sont :
  + `SCRIPT`- La tâche a été créée à l'aide de l'éditeur de script AWS Glue Studio.
  + `VISUAL`- La tâche a été créée à l'aide de l'éditeur visuel AWS Glue Studio.
  + `NOTEBOOK` : la tâche a été créée à l’aide d’un bloc-notes de sessions interactives.

  Lorsque le champ `JobMode` est manquant ou a la valeur null, `SCRIPT` est attribué comme valeur par défaut.
+ `JobRunQueuingEnabled` : booléen.

  Indique si la mise en file d’attente des tâches est activée pour l’exécution de la tâche.

  La valeur true signifie que la mise en file d’attente des tâches est activée pour l’exécution de la tâche. Si la valeur est false ou si elle n’est pas renseignée, l’exécution de la tâche ne sera pas prise en compte pour la mise en file d’attente.
+ `StartedOn` – Horodatage.

  Date et heure auxquelles cette exécution de tâche a démarré.
+ `LastModifiedOn` – Horodatage.

  Heure de la dernière modification de cette exécution de tâche.
+ `CompletedOn` – Horodatage.

  Date et heure auxquelles cette exécution de tâche s'est terminée.
+ `JobRunState`— Chaîne UTF-8 (valeurs valides : `STARTING` \$1 \$1 `RUNNING` \$1 `STOPPING` \$1 `STOPPED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `TIMEOUT` `ERROR` `WAITING` \$1`EXPIRED`).

  État actuel de l'exécution de tâche. Pour plus d'informations sur les statuts des tâches qui se sont terminées anormalement, consultez [AWS Glue Job Run Statuses](https://docs.aws.amazon.com/glue/latest/dg/job-run-statuses.html).
+ `Arguments` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Arguments de la tâche associés à cette exécution. Pour cette exécution de tâche, ils remplacent les arguments par défaut définis pour la tâche elle-même.

  Vous pouvez spécifier ici les arguments que votre propre script d'exécution de tâches consomme, ainsi que les arguments qu'il consomme AWS Glue lui-même.

  Les arguments de la tâche peuvent être consignés. Ne transmettez pas de secrets en texte clair comme arguments. Récupérez les secrets d'une AWS Glue connexion AWS Secrets Manager ou d'un autre mécanisme de gestion des secrets si vous avez l'intention de les conserver dans le cadre du Job. 

  Pour plus d'informations sur la façon de spécifier et d'utiliser vos propres arguments Job, consultez la rubrique [Calling AWS Glue APIs in Python](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) du guide du développeur.

  Pour plus d'informations sur les arguments que vous pouvez fournir dans ce champ lors de la configuration des tâches Spark, consultez la rubrique [Special Parameters Used by AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) dans le guide du développeur.

  Pour plus d'informations sur les arguments que vous pouvez fournir dans ce champ lors de la configuration des tâches Ray, consultez [Utilisation des paramètres de tâches dans les tâches Ray](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html) dans le guide du développeur.
+ `ErrorMessage` – Chaîne UTF-8.

  Message d'erreur associé à cette exécution de tâche.
+ `PredecessorRuns` : un tableau d’objets [Predecessor](#aws-glue-api-jobs-runs-Predecessor).

  Liste des prédécesseurs de cette exécution de tâche.
+ `AllocatedCapacity` : nombre (entier).

  Ce champ est obsolète. Utilisez `MaxCapacity` à la place.

  Le nombre d'unités de traitement de AWS Glue données (DPUs) qui y sont allouées JobRun. De 2 à 100 DPUs peuvent être alloués ; la valeur par défaut est 10. Un DPU est une mesure relative de la puissance de traitement composée de 4 V de capacité CPUs de calcul et de 16 Go de mémoire. Pour plus d'informations, consultez la page de tarification [AWS Glue](https://aws.amazon.com/glue/pricing/).
+ `ExecutionTime` : nombre (entier).

  Durée (en secondes) pendant laquelle la tâche exécutée a consommé des ressources.
+ `Timeout` – Nombre (entier), au moins égal à 1.

  Délai d'expiration de `JobRun` en minutes. Durée maximale durant laquelle une tâche exécutée peut consommer des ressources avant qu'elle ne se termine et n'entre dans l'état `TIMEOUT`. Cette valeur remplace la valeur définie dans la tâche parent.

  Les tâches doivent avoir des valeurs de délai d’expiration inférieures à 7 jours ou 10 080 minutes. Dans le cas contraire, les tâches déclencheront une exception.

  Si aucune valeur n’est indiquée, le délai d’expiration est défini par défaut sur 2 880 minutes.

  Toutes les AWS Glue tâches existantes dont le délai d'expiration est supérieur à 7 jours seront définies par défaut sur 7 jours. Par exemple, si vous avez spécifié un délai d’expiration de 20 jours pour un traitement par lots, celui-ci sera arrêté le 7e jour.

  Pour les tâches de streaming, si vous avez défini une fenêtre de maintenance, elles seront redémarrées au cours de celle-ci au bout de sept jours.
+ `MaxCapacity` – Nombre (double).

  Pour les tâches Glue version 1.0 ou antérieures, en utilisant le type de travailleur standard, le nombre d'unités de traitement des AWS Glue données (DPUs) pouvant être allouées lors de l'exécution de cette tâche. Un DPU est une mesure relative de la puissance de traitement composée de 4 V de capacité CPUs de calcul et de 16 Go de mémoire. Pour plus d'informations, consultez la page de tarification [AWS Glue](https://aws.amazon.com/glue/pricing/).

  Pour les tâches des versions 2.0 et ultérieures de Glue, vous ne pouvez pas spécifier un `Maximum capacity`. Au lieu de cela, vous devez spécifier `Worker type` et `Number of workers`.

  Ne définissez pas `MaxCapacity` si vous utilisez `WorkerType` et `NumberOfWorkers`.

  La valeur pouvant être attribuée à `MaxCapacity` varie selon que vous exécutez une tâche shell Python, une tâche ETL Apache Spark ou une tâche ETL Apache Spark Streaming :
  + Lorsque vous spécifiez une tâche shell Python (`JobCommand.Name`="pythonshell"), vous pouvez allouer 0,0625 ou 1 DPU. La valeur par défaut correspond à 0,0625 DPU.
  + Lorsque vous spécifiez une tâche ETL Apache Spark (`JobCommand.Name`="glueetl ») ou une tâche ETL de streaming Apache Spark (`JobCommand.Name`="gluestreaming »), vous pouvez en allouer de 2 à 100. DPUs La valeur par défaut est 10 DPUs. Ce type de tâche ne peut pas avoir une allocation DPU fractionnée.
+ `WorkerType`— Chaîne UTF-8 (valeurs valides : `Standard=""` \$1 \$1 `G.025X=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `G.12X=""` \$1 `G.16X=""` \$1 `R.1X=""` \$1 `R.2X=""` `R.4X=""` `R.8X=""` \$1`Z.2X=""`).

  Type de travail prédéfini qui est alloué lorsqu'une tâche est exécutée. Accepte une valeur de G.025X, G-1X, G.2X, G.4X, G.8X, G.12X, G.16X, R.1X, R.2X, R.4X ou R.8X pour les tâches Spark. Accepte la valeur Z.2X pour les tâches Ray.
  + Pour le type de `G.1X` worker, chaque worker est mappé à 1 DPU (4 vCPUs, 16 Go de mémoire) avec un disque de 94 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type de travailleur pour les charges de travail telles que les transformations de données, les jointures et les requêtes, afin de proposer un moyen évolutif et rentable d'exécuter la plupart des tâches.
  + Pour le type de `G.2X` travailleur, chaque utilisateur est mappé sur 2 DPU (8 VCPUs, 32 Go de mémoire) avec un disque de 138 Go et fournit un exécuteur par travailleur. Nous recommandons ce type de travailleur pour les charges de travail telles que les transformations de données, les jointures et les requêtes, afin de proposer un moyen évolutif et rentable d'exécuter la plupart des tâches.
  + Pour le type de `G.4X` worker, chaque worker est mappé sur 4 DPU (16 vCPUs, 64 Go de mémoire) avec un disque de 256 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type de travailleur pour les tâches dont les charges de travail contiennent les transformations, les agrégations, les jointures et les requêtes les plus exigeantes. Ce type de travailleur n'est disponible que pour les tâches Spark ETL AWS Glue version 3.0 ou ultérieure dans les AWS régions suivantes : USA Est (Ohio), USA Est (Virginie du Nord), USA Ouest (Oregon), Asie-Pacifique (Singapour), Asie-Pacifique (Sydney), Asie-Pacifique (Tokyo), Canada (Centre), Europe (Francfort), Europe (Irlande) et Europe (Stockholm).
  + Pour le type de `G.8X` travailleur, chaque travailleur est mappé sur 8 DPU (32 vCPUs, 128 Go de mémoire) avec un disque de 512 Go et fournit un exécuteur par travailleur. Nous recommandons ce type de travailleur pour les tâches dont les charges de travail contiennent les transformations, les agrégations, les jointures et les requêtes les plus exigeantes. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 3.0 ou ultérieure, dans les mêmes AWS régions que celles prises en charge pour le type de `G.4X` travailleur.
  + Pour le type de `G.12X` travailleur, chaque travailleur est mappé sur 12 DPU (48 vCPUs, 192 Go de mémoire) avec 768 Go de disque, et fournit un exécuteur par travailleur. Nous recommandons ce type de travailleur pour les tâches comportant de très lourdes charges de travail. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `G.16X` worker, chaque worker est mappé sur 16 DPU (64 vCPUs, 256 Go de mémoire) avec un disque de 1024 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type de travailleur pour les tâches comportant de très lourdes charges de travail. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `G.025X` worker, chaque worker est mappé sur 0,25 DPU (2 vCPUs, 4 Go de mémoire) avec un disque de 84 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type d’employé pour les travaux de streaming à faible volume. Ce type de travailleur n'est disponible que pour les tâches de streaming en AWS Glue version 3.0 ou ultérieure.
  + Pour le type de `R.1X` worker, chaque worker est mappé à 1 DPU (4 vCPUs, 32 Go de mémoire) avec un disque de 94 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type de travailleur pour les charges de travail gourmandes en mémoire. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `R.2X` worker, chaque worker est mappé sur 2 DPU (8 vCPUs, 64 Go de mémoire) avec un disque de 128 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type de travailleur pour les charges de travail gourmandes en mémoire. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `R.4X` travailleur, chaque travailleur est mappé sur 4 DPU (16 vCPUs, 128 Go de mémoire) avec un disque de 256 Go et fournit un exécuteur par travailleur. Nous recommandons ce type de travailleur pour les charges de travail gourmandes en mémoire. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `R.8X` travailleur, chaque utilisateur est mappé sur 8 DPU (32 VCPUs, 256 Go de mémoire) avec un disque de 512 Go et fournit un exécuteur par travailleur. Nous recommandons ce type de travailleur pour les charges de travail gourmandes en mémoire. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `Z.2X` travailleur, chaque utilisateur est mappé sur 2 M-DPU (8 VCPUs, 64 Go de mémoire) avec un disque de 128 Go, et fournit jusqu'à 8 processeurs Ray sur la base de l'autoscaler.
+ `NumberOfWorkers` : nombre (entier).

  Nombre de travaux d'un `workerType` défini qui sont attribués lorsqu'une tâche est exécutée.
+ `SecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la structure `SecurityConfiguration` à utiliser avec cette exécution de tâche.
+ `LogGroupName` – Chaîne UTF-8.

  Le nom du groupe de journaux pour la journalisation sécurisée qui peut être chiffré côté serveur sur Amazon CloudWatch à l'aide de. AWS KMS Ce nom peut avoir pour valeur `/aws-glue/jobs/`, auquel cas le chiffrement par défaut est `NONE`. Si vous ajoutez un nom de rôle et un nom `SecurityConfiguration` (en d'autres termes, `/aws-glue/jobs-yourRoleName-yourSecurityConfigurationName/`), cette configuration de sécurité est utilisée pour chiffrer le groupe de journaux.
+ `NotificationProperty` – Un objet [NotificationProperty](#aws-glue-api-jobs-runs-NotificationProperty).

  Spécifie les propriétés de configuration d'une notification d'exécution de tâche.
+ `GlueVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Dans les tâches Spark, `GlueVersion` détermine les versions d'Apache Spark et de Python AWS Glue disponibles dans une tâche. La version de Python indique la version prise en charge pour les tâches de type Spark. 

  Les tâches Ray doivent définir `GlueVersion` sur `4.0` ou supérieur. Toutefois, les versions de Ray, de Python et des bibliothèques supplémentaires disponibles dans votre tâche Ray sont déterminées par le paramètre `Runtime` de la commande de tâche.

  Pour plus d'informations sur les AWS Glue versions disponibles et les versions correspondantes de Spark et Python, consultez [la version de Glue](https://docs.aws.amazon.com/glue/latest/dg/add-job.html) dans le guide du développeur.

  Les tâches créées sans que la version de Glue soit spécifiée sont des tâches Glue 0.9 par défaut.
+ `DPUSeconds` – Nombre (double).

  Ce champ peut être défini pour les exécutions de tâche avec la classe d’exécution `FLEX` ou lorsque autoscaling est activé, et représente la durée totale d’exécution de chaque exécuteur pendant le cycle de vie d’une tâche exécutée en secondes, multipliée par un facteur DPU (1 pour `G.1X`, 2 pour `G.2X` ou 0,25 pour `G.025X` travailleurs). Cette valeur peut être différente de la valeur `executionEngineRuntime` \$1 `MaxCapacity` comme dans le cas des tâches Auto Scaling, car le nombre d'exécuteurs exécutés à un moment donné peut être inférieur à la `MaxCapacity`. Par conséquent, il est possible que la valeur de `DPUSeconds` soit inférieure à `executionEngineRuntime` \$1 `MaxCapacity`.
+ `ExecutionClass` – Chaîne UTF-8, d'une longueur maximale de 16 octets (valeurs valides : `FLEX=""` \$1 `STANDARD=""`).

  Indique si la tâche est exécutée avec une classe d'exécution standard ou flexible. La classe d'exécution standard est idéale pour les charges de travail urgentes qui nécessitent un démarrage rapide des tâches et des ressources dédiées.

  La classe d'exécution flexible, adaptée aux tâches non urgentes dont les heures de début et de fin peuvent varier. 

  Seules les tâches dotées de AWS Glue la version 3.0 ou supérieure et du type de commande `glueetl` seront autorisées à être définies `ExecutionClass` sur`FLEX`. La classe d'exécution flexible est disponible pour les tâches Spark.
+ `MaintenanceWindow` – Chaîne UTF-8, correspondant au [Custom string pattern #34](aws-glue-api-common.md#regex_34).

  Ce champ indique un jour de la semaine et une heure pour une fenêtre de maintenance pour les tâches de streaming. AWS Glue effectue périodiquement des activités de maintenance. Au cours de ces fenêtres de maintenance, vous AWS Glue devrez redémarrer vos tâches de streaming.

  AWS Glue redémarrera le travail dans les 3 heures suivant la période de maintenance spécifiée. Par exemple, si vous configurez la fenêtre de maintenance pour le lundi à 10h00 GMT, vos tâches seront redémarrées entre 10h00 GMT et 13h00 GMT.
+ `ProfileName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom d'un profil AWS Glue d'utilisation associé à la tâche exécutée.
+ `StateDetail` – Chaîne UTF-8, d'une longueur maximale de 400 000 octets.

  Ce champ contient des informations relatives à l’état d’une exécution de tâche. Le champ autorise les valeurs Null.

  Par exemple, lorsqu’une tâche est exécutée dans un état WAITING à la suite d’une mise en file d’attente, le champ indique la raison pour laquelle la tâche exécutée est dans cet état.
+ `ExecutionRoleSessionPolicy` : chaîne UTF-8, d’une longueur comprise entre 2 et 2 048 octets.

  Cette politique de session intégrée à l' StartJobRun API vous permet de restreindre de manière dynamique les autorisations du rôle d'exécution spécifié pour l'étendue de la tâche, sans avoir à créer de rôles IAM supplémentaires.

## Structure de Predecessor
<a name="aws-glue-api-jobs-runs-Predecessor"></a>

Exécution de tâche utilisée dans le prédicat d'un déclencheur conditionnel ayant déclenché cette exécution de tâche.

**Champs**
+ `JobName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la définition de tâche utilisée par la tâche exécutée précédente.
+ `RunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID d'exécution de tâche de l'exécution de tâche précédente.

## JobBookmarkEntry structure
<a name="aws-glue-api-jobs-runs-JobBookmarkEntry"></a>

Définit un point à partir duquel une tâche peut reprendre le traitement.

**Champs**
+ `JobName` – Chaîne UTF-8.

  Nom de la tâche en question.
+ `Version` : nombre (entier).

  Version de la tâche.
+ `Run` : nombre (entier).

  Numéro d'identification de l'exécution.
+ `Attempt` : nombre (entier).

  Numéro d'identification de la tentative.
+ `PreviousRunId` – Chaîne UTF-8.

  Identifiant d'exécution unique associé à l'exécution de tâche précédente.
+ `RunId` – Chaîne UTF-8.

  Numéro d'identification de l'exécution.
+ `JobBookmark` – Chaîne UTF-8.

  Le marque-page lui-même.

## BatchStopJobRunSuccessfulSubmission structure
<a name="aws-glue-api-jobs-runs-BatchStopJobRunSuccessfulSubmission"></a>

Enregistre une requête réussie visant à arrêter une `JobRun` spécifiée.

**Champs**
+ `JobName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la définition de tâche utilisée par la tâche exécutée qui a été arrêtée.
+ `JobRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  `JobRunId` de la tâche qui a été arrêtée.

## BatchStopJobRunError structure
<a name="aws-glue-api-jobs-runs-BatchStopJobRunError"></a>

Enregistre une erreur qui s'est produite lors de la tentative d'arrêt d'une tâche exécutée spécifiée.

**Champs**
+ `JobName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la définition de tâche utilisée par la tâche exécutée en question.
+ `JobRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  `JobRunId` de l'exécution de tâche en question.
+ `ErrorDetail` – Un objet [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail).

  Spécifie les détails de l'erreur qui s'est produite.

## NotificationProperty structure
<a name="aws-glue-api-jobs-runs-NotificationProperty"></a>

Spécifie les propriétés de configuration d'une notification.

**Champs**
+ `NotifyDelayAfter` – Nombre (entier), au moins égal à 1.

  Après le démarrage d'une exécution de tâche, nombre de minutes d'attente avant l'envoi d'une notification de délai d'exécution de tâche.

## Opérations
<a name="aws-glue-api-jobs-runs-actions"></a>
+ [StartJobRun action (Python : start\$1job\$1run)](#aws-glue-api-jobs-runs-StartJobRun)
+ [BatchStopJobRun action (Python : batch\$1stop\$1job\$1run)](#aws-glue-api-jobs-runs-BatchStopJobRun)
+ [GetJobRun action (Python : get\$1job\$1run)](#aws-glue-api-jobs-runs-GetJobRun)
+ [GetJobRuns action (Python : get\$1job\$1runs)](#aws-glue-api-jobs-runs-GetJobRuns)
+ [GetJobBookmark action (Python : get\$1job\$1bookmark)](#aws-glue-api-jobs-runs-GetJobBookmark)
+ [GetJobBookmarks action (Python : get\$1job\$1bookmarks)](#aws-glue-api-jobs-runs-GetJobBookmarks)
+ [ResetJobBookmark action (Python : reset\$1job\$1bookmark)](#aws-glue-api-jobs-runs-ResetJobBookmark)

## StartJobRun action (Python : start\$1job\$1run)
<a name="aws-glue-api-jobs-runs-StartJobRun"></a>

Démarre une exécution de tâche à l'aide d'une définition de tâche.

**Demande**
+ `JobName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la définition de tâche à utiliser.
+ `JobRunQueuingEnabled` : booléen.

  Indique si la mise en file d’attente des tâches est activée pour l’exécution de la tâche.

  La valeur true signifie que la mise en file d’attente des tâches est activée pour l’exécution de la tâche. Si la valeur est false ou si elle n’est pas renseignée, l’exécution de la tâche ne sera pas prise en compte pour la mise en file d’attente.
+ `JobRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID d'une précédente `JobRun` pour une nouvelle tentative.
+ `Arguments` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Arguments de la tâche associés à cette exécution. Pour cette exécution de tâche, ils remplacent les arguments par défaut définis pour la tâche elle-même.

  Vous pouvez spécifier ici les arguments que votre propre script d'exécution de tâches consomme, ainsi que les arguments qu'il consomme AWS Glue lui-même.

  Les arguments de la tâche peuvent être consignés. Ne transmettez pas de secrets en texte clair comme arguments. Récupérez les secrets d'une AWS Glue connexion AWS Secrets Manager ou d'un autre mécanisme de gestion des secrets si vous avez l'intention de les conserver dans le cadre du Job. 

  Pour plus d'informations sur la façon de spécifier et d'utiliser vos propres arguments Job, consultez la rubrique [Calling AWS Glue APIs in Python](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) du guide du développeur.

  Pour plus d'informations sur les arguments que vous pouvez fournir dans ce champ lors de la configuration des tâches Spark, consultez la rubrique [Special Parameters Used by AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) dans le guide du développeur.

  Pour plus d'informations sur les arguments que vous pouvez fournir dans ce champ lors de la configuration des tâches Ray, consultez [Utilisation des paramètres de tâches dans les tâches Ray](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html) dans le guide du développeur.
+ `AllocatedCapacity` : nombre (entier).

  Ce champ est obsolète. Utilisez `MaxCapacity` à la place.

  Le nombre d'unités de traitement de AWS Glue données (DPUs) à y affecter JobRun. Vous pouvez en allouer au moins 2 DPUs ; la valeur par défaut est 10. Un DPU est une mesure relative de la puissance de traitement composée de 4 V de capacité CPUs de calcul et de 16 Go de mémoire. Pour plus d'informations, consultez la page de tarification [AWS Glue](https://aws.amazon.com/glue/pricing/).
+ `Timeout` – Nombre (entier), au moins égal à 1.

  Délai d'expiration de `JobRun` en minutes. Durée maximale durant laquelle une tâche exécutée peut consommer des ressources avant qu'elle ne se termine et n'entre dans l'état `TIMEOUT`. Cette valeur remplace la valeur définie dans la tâche parent. 

  Les tâches doivent avoir des valeurs de délai d’expiration inférieures à 7 jours ou 10 080 minutes. Dans le cas contraire, les tâches déclencheront une exception.

  Si aucune valeur n’est indiquée, le délai d’expiration est défini par défaut sur 2 880 minutes.

  Toutes les AWS Glue tâches existantes dont le délai d'expiration est supérieur à 7 jours seront définies par défaut sur 7 jours. Par exemple, si vous avez spécifié un délai d’expiration de 20 jours pour un traitement par lots, celui-ci sera arrêté le 7e jour.

  Pour les tâches de streaming, si vous avez défini une fenêtre de maintenance, elles seront redémarrées au cours de celle-ci au bout de sept jours.
+ `MaxCapacity` – Nombre (double).

  Pour les tâches Glue version 1.0 ou antérieures, en utilisant le type de travailleur standard, le nombre d'unités de traitement des AWS Glue données (DPUs) pouvant être allouées lors de l'exécution de cette tâche. Un DPU est une mesure relative de la puissance de traitement composée de 4 V de capacité CPUs de calcul et de 16 Go de mémoire. Pour plus d'informations, consultez la page de tarification [AWS Glue](https://aws.amazon.com/glue/pricing/).

  Pour les tâches des versions 2.0 et ultérieures de Glue, vous ne pouvez pas spécifier un `Maximum capacity`. Au lieu de cela, vous devez spécifier `Worker type` et `Number of workers`.

  Ne définissez pas `MaxCapacity` si vous utilisez `WorkerType` et `NumberOfWorkers`.

  La valeur pouvant être attribuée à `MaxCapacity` varie selon que vous exécutez une tâche shell Python, une tâche ETL Apache Spark ou une tâche ETL Apache Spark Streaming :
  + Lorsque vous spécifiez une tâche shell Python (`JobCommand.Name`="pythonshell"), vous pouvez allouer 0,0625 ou 1 DPU. La valeur par défaut correspond à 0,0625 DPU.
  + Lorsque vous spécifiez une tâche ETL Apache Spark (`JobCommand.Name`="glueetl ») ou une tâche ETL de streaming Apache Spark (`JobCommand.Name`="gluestreaming »), vous pouvez en allouer de 2 à 100. DPUs La valeur par défaut est 10 DPUs. Ce type de tâche ne peut pas avoir une allocation DPU fractionnée.
+ `SecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la structure `SecurityConfiguration` à utiliser avec cette exécution de tâche.
+ `NotificationProperty` – Un objet [NotificationProperty](#aws-glue-api-jobs-runs-NotificationProperty).

  Spécifie les propriétés de configuration d'une notification d'exécution de tâche.
+ `WorkerType` – Chaîne UTF-8 (valeurs valides: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  Type de travail prédéfini qui est alloué lorsqu'une tâche est exécutée. Accepte une valeur de G.1X, G.2X, G.4X, G.8X ou G.025X pour les tâches Spark. Accepte la valeur Z.2X pour les tâches Ray.
  + Pour le type de `G.1X` worker, chaque worker est mappé à 1 DPU (4 vCPUs, 16 Go de mémoire) avec un disque de 94 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type de travailleur pour les charges de travail telles que les transformations de données, les jointures et les requêtes, afin de proposer un moyen évolutif et rentable d'exécuter la plupart des tâches.
  + Pour le type de `G.2X` travailleur, chaque utilisateur est mappé sur 2 DPU (8 VCPUs, 32 Go de mémoire) avec un disque de 138 Go et fournit un exécuteur par travailleur. Nous recommandons ce type de travailleur pour les charges de travail telles que les transformations de données, les jointures et les requêtes, afin de proposer un moyen évolutif et rentable d'exécuter la plupart des tâches.
  + Pour le type de `G.4X` worker, chaque worker est mappé sur 4 DPU (16 vCPUs, 64 Go de mémoire) avec un disque de 256 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type de travailleur pour les tâches dont les charges de travail contiennent les transformations, les agrégations, les jointures et les requêtes les plus exigeantes. Ce type de travailleur n'est disponible que pour les tâches Spark ETL AWS Glue version 3.0 ou ultérieure dans les AWS régions suivantes : USA Est (Ohio), USA Est (Virginie du Nord), USA Ouest (Oregon), Asie-Pacifique (Singapour), Asie-Pacifique (Sydney), Asie-Pacifique (Tokyo), Canada (Centre), Europe (Francfort), Europe (Irlande) et Europe (Stockholm).
  + Pour le type de `G.8X` travailleur, chaque travailleur est mappé sur 8 DPU (32 vCPUs, 128 Go de mémoire) avec un disque de 512 Go et fournit un exécuteur par travailleur. Nous recommandons ce type de travailleur pour les tâches dont les charges de travail contiennent les transformations, les agrégations, les jointures et les requêtes les plus exigeantes. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 3.0 ou ultérieure, dans les mêmes AWS régions que celles prises en charge pour le type de `G.4X` travailleur.
  + Pour le type de `G.12X` travailleur, chaque travailleur est mappé sur 12 DPU (48 vCPUs, 192 Go de mémoire) avec 768 Go de disque, et fournit un exécuteur par travailleur. Nous recommandons ce type de travailleur pour les tâches comportant de très lourdes charges de travail. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `G.16X` worker, chaque worker est mappé sur 16 DPU (64 vCPUs, 256 Go de mémoire) avec un disque de 1024 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type de travailleur pour les tâches comportant de très lourdes charges de travail. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `G.025X` worker, chaque worker est mappé sur 0,25 DPU (2 vCPUs, 4 Go de mémoire) avec un disque de 84 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type d’employé pour les travaux de streaming à faible volume. Ce type de travailleur n'est disponible que pour les tâches de streaming en AWS Glue version 3.0 ou ultérieure.
  + Pour le type de `R.1X` worker, chaque worker est mappé à 1 DPU (4 vCPUs, 32 Go de mémoire) avec un disque de 94 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type de travailleur pour les charges de travail gourmandes en mémoire. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `R.2X` worker, chaque worker est mappé sur 2 DPU (8 vCPUs, 64 Go de mémoire) avec un disque de 128 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type de travailleur pour les charges de travail gourmandes en mémoire. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `R.4X` travailleur, chaque travailleur est mappé sur 4 DPU (16 vCPUs, 128 Go de mémoire) avec un disque de 256 Go et fournit un exécuteur par travailleur. Nous recommandons ce type de travailleur pour les charges de travail gourmandes en mémoire. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `R.8X` travailleur, chaque utilisateur est mappé sur 8 DPU (32 VCPUs, 256 Go de mémoire) avec un disque de 512 Go et fournit un exécuteur par travailleur. Nous recommandons ce type de travailleur pour les charges de travail gourmandes en mémoire. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 4.0 ou ultérieure.
  + Pour le type de `Z.2X` travailleur, chaque utilisateur est mappé sur 2 M-DPU (8 VCPUs, 64 Go de mémoire) avec un disque de 128 Go, et fournit jusqu'à 8 processeurs Ray sur la base de l'autoscaler.
+ `NumberOfWorkers` : nombre (entier).

  Nombre de travaux d'un `workerType` défini qui sont attribués lorsqu'une tâche est exécutée.
+ `ExecutionClass` – Chaîne UTF-8, d'une longueur maximale de 16 octets (valeurs valides : `FLEX=""` \$1 `STANDARD=""`).

  Indique si la tâche est exécutée avec une classe d'exécution standard ou flexible. La classe d'exécution standard est idéale pour les charges de travail urgentes qui nécessitent un démarrage rapide des tâches et des ressources dédiées.

  La classe d'exécution flexible, adaptée aux tâches non urgentes dont les heures de début et de fin peuvent varier. 

  Seules les tâches dotées de AWS Glue la version 3.0 ou supérieure et du type de commande `glueetl` seront autorisées à être définies `ExecutionClass` sur`FLEX`. La classe d'exécution flexible est disponible pour les tâches Spark.
+ `ProfileName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom d'un profil AWS Glue d'utilisation associé à la tâche exécutée.
+ `ExecutionRoleSessionPolicy` : chaîne UTF-8, d’une longueur comprise entre 2 et 2 048 octets.

  Cette politique de session intégrée à l' StartJobRun API vous permet de restreindre de manière dynamique les autorisations du rôle d'exécution spécifié pour l'étendue de la tâche, sans avoir à créer de rôles IAM supplémentaires.

**Réponse**
+ `JobRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID attribuée à cette exécution de tâche.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentRunsExceededException`

## BatchStopJobRun action (Python : batch\$1stop\$1job\$1run)
<a name="aws-glue-api-jobs-runs-BatchStopJobRun"></a>

Arrête une ou plusieurs exécutions de tâche pour une définition de tâche spécifiée.

**Demande**
+ `JobName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la définition de tâche pour laquelle arrêter les exécutions de tâche.
+ `JobRunIds` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 25 chaînes maximum.

  Liste des `JobRunIds` qui doivent être arrêtés pour cette définition de tâche.

**Réponse**
+ `SuccessfulSubmissions` : un tableau d’objets [BatchStopJobRunSuccessfulSubmission](#aws-glue-api-jobs-runs-BatchStopJobRunSuccessfulSubmission).

  Une liste de ceux JobRuns qui ont été soumis avec succès pour arrêt.
+ `Errors` – Un tableau [BatchStopJobRunError](#aws-glue-api-jobs-runs-BatchStopJobRunError) d'objets.

  Liste des erreurs qui se sont produites lors de la tentative d'arrêt de `JobRuns`, incluant la `JobRunId` pour laquelle chaque erreur s'est produite et les détails de l'erreur.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetJobRun action (Python : get\$1job\$1run)
<a name="aws-glue-api-jobs-runs-GetJobRun"></a>

Récupère les métadonnées d'une exécution de tâche donnée. L’historique d’exécution des tâches est accessible pendant 365 jours pour votre flux de travail et l’exécution des tâches.

**Demande**
+ `JobName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la définition de tâche en cours d'exécution.
+ `RunId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de l'exécution de tâche.
+ `PredecessorsIncluded` : booléen.

  True si une liste d'exécutions précédentes doit être renvoyée.

**Réponse**
+ `JobRun` – Un objet [JobRun](#aws-glue-api-jobs-runs-JobRun).

  Métadonnées de l'exécution de tâche demandée.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetJobRuns action (Python : get\$1job\$1runs)
<a name="aws-glue-api-jobs-runs-GetJobRuns"></a>

Récupère les métadonnées de toutes les exécutions d'une définition de tâche donnée.

`GetJobRuns` renvoie les tâches exécutées par ordre chronologique, les tâches les plus récentes étant renvoyées en premier.

**Demande**
+ `JobName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la définition de tâche pour laquelle récupérer toutes les exécutions de tâche.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.
+ `MaxResults`— Nombre (entier), pas moins de 1 ou plus de 200.

  Taille maximale de la réponse.

**Réponse**
+ `JobRuns` : un tableau d’objets [JobRun](#aws-glue-api-jobs-runs-JobRun).

  Liste des objets de métadonnées de l'exécution de tâche.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, si toutes les exécutions de tâche demandées ne sont pas renvoyées.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetJobBookmark action (Python : get\$1job\$1bookmark)
<a name="aws-glue-api-jobs-runs-GetJobBookmark"></a>

Renvoie des informations sur une entrée de marque-page de tâche.

Pour plus d'informations sur l'activation et l'utilisation des marque-pages de tâche, consultez :
+ [Suivi des données traitées à l'aide de signets de tâche](https://docs.aws.amazon.com/glue/latest/dg/monitor-continuations.html)
+ [Paramètres du job utilisés par AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html)
+ [Structure de tâche](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html#aws-glue-api-jobs-job-Job)

**Demande**
+ `JobName` – *Obligatoire :* chaîne UTF-8.

  Nom de la tâche en question.
+ `Version` : nombre (entier).

  Version de la tâche.
+ `RunId` – Chaîne UTF-8.

  Identifiant d'exécution unique associé à l'exécution de cette tâche.

**Réponse**
+ `JobBookmarkEntry` – Un objet [JobBookmarkEntry](#aws-glue-api-jobs-runs-JobBookmarkEntry).

  Structure qui définit un point à partir duquel une tâche peut reprendre le traitement.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ValidationException`

## GetJobBookmarks action (Python : get\$1job\$1bookmarks)
<a name="aws-glue-api-jobs-runs-GetJobBookmarks"></a>

Renvoie des informations sur les données de marque-page de tâche. La liste est classée par numéros de version décroissants.

Pour plus d'informations sur l'activation et l'utilisation des marque-pages de tâche, consultez :
+ [Suivi des données traitées à l'aide de signets de tâche](https://docs.aws.amazon.com/glue/latest/dg/monitor-continuations.html)
+ [Paramètres du job utilisés par AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html)
+ [Structure de tâche](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html#aws-glue-api-jobs-job-Job)

**Demande**
+ `JobName` – *Obligatoire :* chaîne UTF-8.

  Nom de la tâche en question.
+ `MaxResults` : nombre (entier).

  Taille maximale de la réponse.
+ `NextToken` : nombre (entier).

  Jeton de continuation, s’il s’agit d’un appel de continuation.

**Réponse**
+ `JobBookmarkEntries` : un tableau d’objets [JobBookmarkEntry](#aws-glue-api-jobs-runs-JobBookmarkEntry).

  Liste de données de marque-page de tâche qui définit un point à partir duquel une tâche peut reprendre son exécution.
+ `NextToken` : nombre (entier).

  Jeton de continuation, qui prend la valeur 1 si toutes les entrées sont renvoyées, ou > 1 si toutes les exécutions de tâches demandées n'ont pas été renvoyées.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## ResetJobBookmark action (Python : reset\$1job\$1bookmark)
<a name="aws-glue-api-jobs-runs-ResetJobBookmark"></a>

Réinitialise une donnée de marque-page.

Pour plus d'informations sur l'activation et l'utilisation des marque-pages de tâche, consultez :
+ [Suivi des données traitées à l'aide de signets de tâche](https://docs.aws.amazon.com/glue/latest/dg/monitor-continuations.html)
+ [Paramètres du job utilisés par AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html)
+ [Structure de tâche](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html#aws-glue-api-jobs-job-Job)

**Demande**
+ `JobName` – *Obligatoire :* chaîne UTF-8.

  Nom de la tâche en question.
+ `RunId` – Chaîne UTF-8.

  Identifiant d'exécution unique associé à l'exécution de cette tâche.

**Réponse**
+ `JobBookmarkEntry` – Un objet [JobBookmarkEntry](#aws-glue-api-jobs-runs-JobBookmarkEntry).

  Donnée de marque-page de réinitialisation.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

# Triggers
<a name="aws-glue-api-jobs-trigger"></a>

L'API Triggers décrit les types de données et l'API liés à la création, à la mise à jour ou à la suppression, ainsi qu'au démarrage et à l'arrêt des déclencheurs de tâches dans AWS Glue.

## Types de données
<a name="aws-glue-api-jobs-trigger-objects"></a>
+ [Structure Trigger](#aws-glue-api-jobs-trigger-Trigger)
+ [TriggerUpdate structure](#aws-glue-api-jobs-trigger-TriggerUpdate)
+ [Structure Predicate](#aws-glue-api-jobs-trigger-Predicate)
+ [Structure Condition](#aws-glue-api-jobs-trigger-Condition)
+ [Structure Action](#aws-glue-api-jobs-trigger-Action)
+ [EventBatchingCondition structure](#aws-glue-api-jobs-trigger-EventBatchingCondition)

## Structure Trigger
<a name="aws-glue-api-jobs-trigger-Trigger"></a>

Informations concernant un déclencheur spécifique.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom du déclencheur.
+ `WorkflowName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du flux de travail associé au déclencheur.
+ `Id` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Réservé pour un usage futur.
+ `Type` – Chaîne UTF-8 (valeurs valides : `SCHEDULED` \$1 `CONDITIONAL` \$1 `ON_DEMAND` \$1 `EVENT`).

  Type de déclencheur.
+ `State` – Chaîne UTF-8 (valeurs valides : `CREATING` \$1 `CREATED` \$1 `ACTIVATING` \$1 `ACTIVATED` \$1 `DEACTIVATING` \$1 `DEACTIVATED` \$1 `DELETING` \$1 `UPDATING`).

  État actuel du déclencheur.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de ce déclencheur.
+ `Schedule` – Chaîne UTF-8.

  Une expression `cron` utilisée pour spécifier la planification (consultez [Time-Based Schedules for Jobs and Crawlers](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) (Planifications temporelles pour les tâches et les crawlers)). Par exemple, pour exécuter un élément tous les jours à 12h15 UTC, vous devez spécifier : `cron(15 12 * * ? *)`.
+ `Actions` – Un tableau [Action](#aws-glue-api-jobs-trigger-Action) d'objets.

  Actions initiées par ce déclencheur.
+ `Predicate` – Un objet [Prédicat](#aws-glue-api-jobs-trigger-Predicate).

  Prédicat de ce déclencheur, qui définit le moment du déclenchement.
+ `EventBatchingCondition` – Un objet [EventBatchingCondition](#aws-glue-api-jobs-trigger-EventBatchingCondition).

  Condition de lot qui doit être remplie (nombre spécifié d'événements reçus ou délai de traitement du lot expiré) avant que EventBridge l'événement ne se déclenche.

## TriggerUpdate structure
<a name="aws-glue-api-jobs-trigger-TriggerUpdate"></a>

Structure utilisée pour fournir des informations utilisées pour mettre à jour un déclencheur. Cet objet met à jour la définition précédente du déclencheur en la remplaçant complètement.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Réservé pour un usage futur.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de ce déclencheur.
+ `Schedule` – Chaîne UTF-8.

  Une expression `cron` utilisée pour spécifier la planification (consultez [Time-Based Schedules for Jobs and Crawlers](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) (Planifications temporelles pour les tâches et les crawlers)). Par exemple, pour exécuter un élément tous les jours à 12h15 UTC, vous devez spécifier : `cron(15 12 * * ? *)`.
+ `Actions` – Un tableau [Action](#aws-glue-api-jobs-trigger-Action) d'objets.

  Actions initiées par ce déclencheur.
+ `Predicate` – Un objet [Prédicat](#aws-glue-api-jobs-trigger-Predicate).

  Prédicat de ce déclencheur, qui définit le moment du déclenchement.
+ `EventBatchingCondition` – Un objet [EventBatchingCondition](#aws-glue-api-jobs-trigger-EventBatchingCondition).

  Condition de lot qui doit être remplie (nombre spécifié d'événements reçus ou délai de traitement du lot expiré) avant que EventBridge l'événement ne se déclenche.

## Structure Predicate
<a name="aws-glue-api-jobs-trigger-Predicate"></a>

Définit le prédicat du déclencheur, qui détermine le moment du déclenchement.

**Champs**
+ `Logical` – Chaîne UTF-8 (valeurs valides : `AND` \$1 `ANY`).

  Champ facultatif si une seule condition est répertoriée. Si plusieurs conditions sont répertoriées, ce champ est obligatoire.
+ `Conditions`— Un ensemble d'[Condition](#aws-glue-api-jobs-trigger-Condition)objets, pas plus de 500 structures.

  Liste des conditions qui déterminent le moment du déclenchement.

## Structure Condition
<a name="aws-glue-api-jobs-trigger-Condition"></a>

Définit une condition selon laquelle un déclencheur s'exécute.

**Champs**
+ `LogicalOperator` – Chaîne UTF-8 (valeurs valides : `EQUALS`).

  Opérateur logique.
+ `JobName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la tâche pour laquelle cette condition s'applique à `JobRuns` et sur laquelle ce déclencheur attend.
+ `State`— Chaîne UTF-8 (valeurs valides : `STARTING` \$1 \$1 `RUNNING` \$1 `STOPPING` \$1 `STOPPED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `TIMEOUT` `ERROR` `WAITING` \$1`EXPIRED`).

  État de la condition. Actuellement, les seuls états de tâche qu'un déclencheur peut écouter sont `SUCCEEDED`, `STOPPED`, `FAILED` et `TIMEOUT`. Les seuls états d'crawler qu'un déclencheur peut écouter sont `SUCCEEDED`, `FAILED` et `CANCELLED`.
+ `CrawlerName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'crawler à laquelle cette condition s'applique.
+ `CrawlState` – Chaîne UTF-8 (valeurs valides : `RUNNING` \$1 `CANCELLING` \$1 `CANCELLED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `ERROR`).

  Nom de l'crawler à laquelle cette condition s'applique.

## Structure Action
<a name="aws-glue-api-jobs-trigger-Action"></a>

Définit une action qui doit être initiée par un déclencheur.

**Champs**
+ `JobName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la tâche à exécuter.
+ `Arguments` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Arguments de tâche utilisés lorsque ce déclencheur s'exécute. Pour cette exécution de tâche, ils remplacent les arguments par défaut définis pour la tâche elle-même.

  Vous pouvez spécifier ici les arguments que votre propre script d'exécution de tâches consomme, ainsi que les arguments qu'il consomme AWS Glue lui-même.

  Pour plus d'informations sur la façon de spécifier et d'utiliser vos propres arguments Job, consultez la rubrique [Calling AWS Glue APIs in Python](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) du guide du développeur.

  Pour plus d'informations sur les paires clé-valeur nécessaires AWS Glue à la configuration de votre tâche, consultez la AWS Glue rubrique [Paramètres spéciaux utilisés par](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) dans le guide du développeur.
+ `Timeout` – Nombre (entier), au moins égal à 1.

  Délai d'expiration de `JobRun` en minutes. Durée maximale durant laquelle une tâche exécutée peut consommer des ressources avant qu'elle ne se termine et n'entre dans l'état `TIMEOUT`. Cette valeur remplace la valeur définie dans la tâche parent.

  Les tâches doivent avoir des valeurs de délai d’expiration inférieures à 7 jours ou 10 080 minutes. Dans le cas contraire, les tâches déclencheront une exception.

  Si aucune valeur n’est indiquée, le délai d’expiration est défini par défaut sur 2 880 minutes.

  Toutes les AWS Glue tâches existantes dont le délai d'expiration est supérieur à 7 jours seront définies par défaut sur 7 jours. Par exemple, si vous avez spécifié un délai d’expiration de 20 jours pour un traitement par lots, celui-ci sera arrêté le 7e jour.

  Pour les tâches de streaming, si vous avez défini une fenêtre de maintenance, elles seront redémarrées au cours de celle-ci au bout de sept jours.
+ `SecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la structure `SecurityConfiguration` à utiliser avec cette action.
+ `NotificationProperty` – Un objet [NotificationProperty](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-NotificationProperty).

  Spécifie les propriétés de configuration d'une notification d'exécution de tâche.
+ `CrawlerName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'crawler à utiliser avec cette action.

## EventBatchingCondition structure
<a name="aws-glue-api-jobs-trigger-EventBatchingCondition"></a>

Condition de lot qui doit être remplie (nombre spécifié d'événements reçus ou délai de traitement du lot expiré) avant que EventBridge l'événement ne se déclenche.

**Champs**
+ `BatchSize` – *obligatoire :* nombre (entier), compris entre 1 et 100.

  Nombre d'événements qui doivent être reçus d'Amazon EventBridge avant que l' EventBridge événement ne déclenche un incendie.
+ `BatchWindow` – nombre (entier), compris entre 1 et 900.

  Fenêtre de temps en secondes après laquelle EventBridge l'événement déclenche des incendies. La fenêtre démarre dès la réception du premier événement.

## Opérations
<a name="aws-glue-api-jobs-trigger-actions"></a>
+ [CreateTrigger action (Python : create\$1trigger)](#aws-glue-api-jobs-trigger-CreateTrigger)
+ [StartTrigger action (Python : start\$1trigger)](#aws-glue-api-jobs-trigger-StartTrigger)
+ [GetTrigger action (Python : get\$1trigger)](#aws-glue-api-jobs-trigger-GetTrigger)
+ [GetTriggers action (Python : get\$1triggers)](#aws-glue-api-jobs-trigger-GetTriggers)
+ [UpdateTrigger action (Python : update\$1trigger)](#aws-glue-api-jobs-trigger-UpdateTrigger)
+ [StopTrigger action (Python : stop\$1trigger)](#aws-glue-api-jobs-trigger-StopTrigger)
+ [DeleteTrigger action (Python : delete\$1trigger)](#aws-glue-api-jobs-trigger-DeleteTrigger)
+ [ListTriggers action (Python : list\$1triggers)](#aws-glue-api-jobs-trigger-ListTriggers)
+ [BatchGetTriggers action (Python : batch\$1get\$1triggers)](#aws-glue-api-jobs-trigger-BatchGetTriggers)

## CreateTrigger action (Python : create\$1trigger)
<a name="aws-glue-api-jobs-trigger-CreateTrigger"></a>

Crée un nouveau déclencheur.

Les arguments de la tâche peuvent être consignés. Ne transmettez pas de secrets en texte clair comme arguments. Récupérez les secrets d'une AWS Glue connexion, d'un Gestionnaire de AWS Secrets ou d'un autre mécanisme de gestion des secrets si vous avez l'intention de les conserver dans le cadre du Job.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom du déclencheur.
+ `WorkflowName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du flux de travail associé au déclencheur.
+ `Type` – *obligatoire :* chaîne UTF-8 (valeurs valides : `SCHEDULED` \$1 `CONDITIONAL` \$1 `ON_DEMAND` \$1 `EVENT`).

  Type du nouveau déclencheur.
+ `Schedule` – Chaîne UTF-8.

  Une expression `cron` utilisée pour spécifier la planification (consultez [Time-Based Schedules for Jobs and Crawlers](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) (Planifications temporelles pour les tâches et les crawlers)). Par exemple, pour exécuter un élément tous les jours à 12h15 UTC, vous devez spécifier : `cron(15 12 * * ? *)`.

  Ce champ est obligatoire lorsque le type de déclencheur est SCHEDULED.
+ `Predicate` – Un objet [Prédicat](#aws-glue-api-jobs-trigger-Predicate).

  Prédicat pour spécifier le moment du déclenchement.

  Ce champ est obligatoire lorsque le type de déclencheur est `CONDITIONAL`.
+ `Actions` – *Obligatoire :* un tableau d’objets [Action](#aws-glue-api-jobs-trigger-Action).

  Actions initiées par ce déclencheur lorsqu'il s'exécute.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description du nouveau déclencheur.
+ `StartOnCreation` : booléen.

  Définissez ce paramètre sur `true` pour démarrer les déclencheurs `SCHEDULED` et `CONDITIONAL` lorsqu'ils sont créés. True n'est pas pris en charge pour les déclencheurs `ON_DEMAND`.
+ `Tags` – tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Balises à utiliser avec ce déclencheur. Vous pouvez utiliser des balises pour limiter l'accès au déclencheur. Pour plus d'informations sur les tags in AWS Glue, voir [AWS Tags in AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html) dans le guide du développeur. 
+ `EventBatchingCondition` : un objet [EventBatchingCondition](#aws-glue-api-jobs-trigger-EventBatchingCondition).

  Condition de lot qui doit être remplie (nombre spécifié d'événements reçus ou délai de traitement du lot expiré) avant que EventBridge l'événement ne se déclenche.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom du déclencheur.

**Erreurs**
+ `AlreadyExistsException`
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `IdempotentParameterMismatchException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentModificationException`

## StartTrigger action (Python : start\$1trigger)
<a name="aws-glue-api-jobs-trigger-StartTrigger"></a>

Lance un déclencheur existant. Consultez [Déclenchement de tâches](https://docs.aws.amazon.com/glue/latest/dg/trigger-job.html) pour obtenir des informations sur la manière dont différents types de déclencheurs sont lancés.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du déclencheur à lancer.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du déclencheur qui a été lancé.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentRunsExceededException`

## GetTrigger action (Python : get\$1trigger)
<a name="aws-glue-api-jobs-trigger-GetTrigger"></a>

Extrait la définition d'un déclencheur.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du déclencheur à extraire.

**Réponse**
+ `Trigger` – Un objet [Déclencheur](#aws-glue-api-jobs-trigger-Trigger).

  Définition du déclencheur demandé.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetTriggers action (Python : get\$1triggers)
<a name="aws-glue-api-jobs-trigger-GetTriggers"></a>

Permet d'obtenir tous les déclencheurs associés à une tâche.

**Demande**
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.
+ `DependentJobName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la tâche pour laquelle récupérer des déclencheurs. Le déclencheur qui peut lancer cette tâche est renvoyé. Si aucun déclencheur de ce type n'existe, tous les déclencheurs sont renvoyés.
+ `MaxResults`— Nombre (entier), pas moins de 1 ou plus de 200.

  Taille maximale de la réponse.

**Réponse**
+ `Triggers` : un tableau d’objets [Déclencheur](#aws-glue-api-jobs-trigger-Trigger).

  Liste des déclencheurs pour la tâche spécifiée.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, si tous les déclencheurs demandés ne sont pas encore renvoyés.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## UpdateTrigger action (Python : update\$1trigger)
<a name="aws-glue-api-jobs-trigger-UpdateTrigger"></a>

Met à jour la définition d'un déclencheur.

Les arguments de la tâche peuvent être consignés. Ne transmettez pas de secrets en texte clair comme arguments. Récupérez les secrets d'une AWS Glue connexion, d'un Gestionnaire de AWS Secrets ou d'un autre mécanisme de gestion des secrets si vous avez l'intention de les conserver dans le cadre du Job.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du déclencheur à mettre à jour.
+ `TriggerUpdate` – *Obligatoire :* un objet [TriggerUpdate](#aws-glue-api-jobs-trigger-TriggerUpdate).

  Nouvelles valeurs pour mettre à jour le déclencheur.

**Réponse**
+ `Trigger` – Un objet [Déclencheur](#aws-glue-api-jobs-trigger-Trigger).

  Définition du déclencheur obtenu.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`

## StopTrigger action (Python : stop\$1trigger)
<a name="aws-glue-api-jobs-trigger-StopTrigger"></a>

Arrête un déclencheur spécifié.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du déclencheur à arrêter.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du déclencheur qui a été arrêté.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`

## DeleteTrigger action (Python : delete\$1trigger)
<a name="aws-glue-api-jobs-trigger-DeleteTrigger"></a>

Supprime un déclencheur spécifié. Si le déclencheur est introuvable, aucune exception n'est levée.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du déclencheur à supprimer.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du déclencheur qui a été supprimé.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`

## ListTriggers action (Python : list\$1triggers)
<a name="aws-glue-api-jobs-trigger-ListTriggers"></a>

Récupère les noms de toutes les ressources de déclenchement de ce AWS compte ou des ressources portant le tag spécifié. Cette opération vous permet de voir quelles ressources sont disponibles dans votre compte, et leurs noms.

Cette opération accepte le champ `Tags` facultatif que vous pouvez utiliser comme filtre sur la réponse, afin que les ressources balisées puissent être récupérées en tant que groupe. Si vous choisissez d'utiliser le filtrage des balises, seules les ressources avec la balise sont récupérées.

**Demande**
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’une requête de continuation.
+ `DependentJobName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

   Nom de la tâche pour laquelle récupérer les déclencheurs. Le déclencheur qui peut lancer cette tâche est renvoyé. Si aucun déclencheur de ce type n'existe, tous les déclencheurs sont renvoyés.
+ `MaxResults`— Nombre (entier), pas moins de 1 ou plus de 200.

  La taille maximale d’une liste à renvoyer.
+ `Tags` – tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Spécifie de renvoyer uniquement les ressources balisées.

**Réponse**
+ `TriggerNames` – Tableau de chaînes UTF-8.

  Noms de tous les déclencheurs dans le compte ou des déclencheurs avec les balises spécifiées.
+ `NextToken` – Chaîne UTF-8.

  Jeton continuation, si la liste renvoyée ne contient pas la dernière métrique disponible.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## BatchGetTriggers action (Python : batch\$1get\$1triggers)
<a name="aws-glue-api-jobs-trigger-BatchGetTriggers"></a>

Renvoie la liste des métadonnées de ressource pour une liste donnée de noms de déclencheur. Après avoir appelé l’opération `ListTriggers`, vous pouvez appeler cette opération pour accéder aux données sur lesquelles des autorisations vous ont été octroyées. Cette opération prend en charge toutes les autorisations IAM, y compris les conditions d’autorisation qui utilisent des balises.

**Demande**
+ `TriggerNames` – *obligatoire :* tableau de chaînes UTF-8.

  Liste des noms de déclencheur, qui peuvent être les noms renvoyés à partir de l'opération `ListTriggers`.

**Réponse**
+ `Triggers` : un tableau d’objets [Déclencheur](#aws-glue-api-jobs-trigger-Trigger).

  Liste des définitions de déclencheur.
+ `TriggersNotFound` – Tableau de chaînes UTF-8.

  Liste des noms des déclencheurs introuvables.

**Erreurs**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`

# Intégration APIs dans AWS Glue
<a name="aws-glue-api-integrations"></a>

## Types de données
<a name="aws-glue-api-integrations-objects"></a>
+ [Structure d’intégration](#aws-glue-api-integrations-Integration)
+ [IntegrationConfig structure](#aws-glue-api-integrations-IntegrationConfig)
+ [IntegrationPartition structure](#aws-glue-api-integrations-IntegrationPartition)
+ [IntegrationError structure](#aws-glue-api-integrations-IntegrationError)
+ [IntegrationFilter structure](#aws-glue-api-integrations-IntegrationFilter)
+ [InboundIntegration structure](#aws-glue-api-integrations-InboundIntegration)
+ [SourceProcessingProperties structure](#aws-glue-api-integrations-SourceProcessingProperties)
+ [TargetProcessingProperties structure](#aws-glue-api-integrations-TargetProcessingProperties)
+ [SourceTableConfig structure](#aws-glue-api-integrations-SourceTableConfig)
+ [TargetTableConfig structure](#aws-glue-api-integrations-TargetTableConfig)

## Structure d’intégration
<a name="aws-glue-api-integrations-Integration"></a>

Décrit une intégration zéro ETL.

**Champs**
+ `SourceArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de la source pour l’intégration.
+ `TargetArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de la cible pour l’intégration.
+ `Description` – chaîne UTF-8, d’une longueur ne dépassant pas 1 000 octets, correspondant au [Custom string pattern #12](aws-glue-api-common.md#regex_12).

  Description de l’intégration.
+ `IntegrationName`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Nom unique de l’intégration.
+ `IntegrationArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Amazon Resource Name (ARN) de l’intégration.
+ `KmsKeyId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  ARN d’une clé KMS utilisée pour chiffrer le canal.
+ `AdditionalEncryptionContext` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Ensemble facultatif de paires clé-valeur non secrètes qui contiennent des informations contextuelles supplémentaires pour le chiffrement. Il ne peut être fourni que si `KMSKeyId` est indiqué.
+ `Tags` : un tableau d’objets [Balise](aws-glue-api-common.md#aws-glue-api-common-Tag).

  Métadonnée attribuée à la ressource composée d’une liste de paires clé-valeur.
+ `Status` –* Obligatoire :* Chaîne UTF-8 (valeurs valides : `CREATING` \$1 `ACTIVE` \$1 `MODIFYING` \$1 `FAILED` \$1 `DELETING` \$1 `SYNCING` \$1 `NEEDS_ATTENTION`).

  Les statuts possibles sont les suivants :
  + CREATING : l’intégration est en cours de création.
  + ACTIVE : la création de l’intégration a réussi..
  + MODIFYING : l’intégration est en cours de modification.
  + FAILED : la création de l’intégration a échoué. 
  + DELETING : l’intégration est supprimée.
  + SYNCING : l’intégration est en cours de synchronisation.
  + NEEDS\$1ATTENTION : l’intégration requiert votre attention, par exemple pour la synchronisation.
+ `CreateTime` – *obligatoire :* horodatage.

  Heure (UTC) de création de l’intégration.
+ `IntegrationConfig` : un objet [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig).

  Propriétés associées à l’intégration.
+ `Errors` : un tableau d’objets [IntegrationError](#aws-glue-api-integrations-IntegrationError).

  Liste des erreurs associées à l’intégration.
+ `DataFilter` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Sélectionne les tables source pour l’intégration à l’aide de la syntaxe du filtre Maxwell.

## IntegrationConfig structure
<a name="aws-glue-api-integrations-IntegrationConfig"></a>

Propriétés associées à l’intégration.

**Champs**
+ `RefreshInterval` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Spécifie la fréquence à laquelle CDC (Change Data Capture) doit effectuer des extractions ou des chargements incrémentiels. Ce paramètre offre la flexibilité nécessaire pour aligner le taux de rafraîchissement sur vos modèles de mise à jour des données spécifiques, vos considérations relatives à la charge du système et vos objectifs d’optimisation des performances. L’incrément de temps peut être réglé de 15 minutes à 8 640 minutes (six jours).
+ `SourceProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

   Une collection de paires clé-valeur qui spécifient des propriétés supplémentaires pour la source d’intégration. Ces propriétés fournissent des options de configuration qui peuvent être utilisées pour personnaliser le comportement de la source ODB lors des opérations d’intégration de données. 
+ `ContinuousSync` : booléen.

  Permet une synchronisation continue pour les extractions de données à la demande depuis : 1) des applications SaaS vers AWS des services de données tels qu'Amazon Redshift Amazon S3 et, et 2) DynamoDB vers. Amazon S3

## IntegrationPartition structure
<a name="aws-glue-api-integrations-IntegrationPartition"></a>

Structure qui décrit la manière dont les données sont partitionnées sur la cible.

**Champs**
+ `FieldName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Nom du champ utilisé pour partitionner les données sur la cible. Évitez d'utiliser des colonnes qui ont des valeurs uniques pour chaque ligne (par exemple, LastModifiedTimestamp « », SystemModTimeStamp « ») comme colonne de partition. Ces colonnes ne sont pas adaptées au partitionnement, car elles créent un grand nombre de petites partitions, ce qui peut entraîner des problèmes de performances.
+ `FunctionSpec` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Spécifie la fonction utilisée pour partitionner les données sur la cible. Les valeurs acceptées pour ce paramètre sont les suivantes :
  + `identity` : utilise les valeurs source directement sans transformation
  + `year` : extrait l’année à partir des valeurs d’horodatage (par exemple, 2023)
  + `month` : extrait le mois à partir des valeurs d’horodatage (par exemple, 2023-01)
  + `day` : extrait le jour à partir des valeurs d’horodatage (par exemple, 2023-01-15)
  + `hour` : extrait l’heure à partir des valeurs d’horodatage (par exemple, 2023-01-15-14)
+ `ConversionSpec` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Indique le format d’horodatage des données source. Les valeurs valides sont :
  + `epoch_sec` : horodatage d’époque Unix en secondes
  + `epoch_milli` : horodatage de l’époque Unix en millisecondes
  + `iso` : horodatage au format ISO 8601
**Note**  
 Spécifiez uniquement `ConversionSpec` lorsque vous utilisez des fonctions de partition basées sur l'horodatage (année, mois, jour ou heure). AWS Glue Zero-ETL utilise ce paramètre pour transformer correctement les données source au format d'horodatage avant le partitionnement.   
 N’utilisez pas de colonnes à cardinalité élevée avec la fonction de partition `identity`. Les colonnes à haute cardinalité comprennent :   
Clés primaires
Champs d’horodatage (tels que `LastModifiedTimestamp` et `CreatedDate`)
Horodatages générés par le système
 L’utilisation de colonnes à haute cardinalité avec partitionnement des identités crée de nombreuses petites partitions, ce qui peut considérablement dégrader les performances d’ingestion. 

## IntegrationError structure
<a name="aws-glue-api-integrations-IntegrationError"></a>

Erreur associée à une intégration zéro ETL.

**Champs**
+ `ErrorCode` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Code associé à cette erreur.
+ `ErrorMessage` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Message décrivant l'erreur.

## IntegrationFilter structure
<a name="aws-glue-api-integrations-IntegrationFilter"></a>

Filtre qui peut être utilisé lors de l’invocation d’une demande `DescribeIntegrations`.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Nom du filtre.
+ `Values` – Tableau de chaînes UTF-8.

  Une liste de valeurs de filtre.

## InboundIntegration structure
<a name="aws-glue-api-integrations-InboundIntegration"></a>

Structure pour une intégration qui écrit des données dans une ressource.

**Champs**
+ `SourceArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de la ressource source pour l’intégration.
+ `TargetArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de la ressource cible pour l’intégration..
+ `IntegrationArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de l’intégration zéro ETL.
+ `Status` –* Obligatoire :* Chaîne UTF-8 (valeurs valides : `CREATING` \$1 `ACTIVE` \$1 `MODIFYING` \$1 `FAILED` \$1 `DELETING` \$1 `SYNCING` \$1 `NEEDS_ATTENTION`).

  Les statuts possibles sont les suivants :
  + CREATING : l’intégration est en cours de création.
  + ACTIVE : la création de l’intégration a réussi..
  + MODIFYING : l’intégration est en cours de modification.
  + FAILED : la création de l’intégration a échoué. 
  + DELETING : l’intégration est supprimée.
  + SYNCING : l’intégration est en cours de synchronisation.
  + NEEDS\$1ATTENTION : l’intégration requiert votre attention, par exemple pour la synchronisation.
+ `CreateTime` – *obligatoire :* horodatage.

  Heure (UTC) de création de l’intégration.
+ `IntegrationConfig` : un objet [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig).

  Propriétés associées à l’intégration.
+ `Errors` : un tableau d’objets [IntegrationError](#aws-glue-api-integrations-IntegrationError).

  Liste des erreurs associées à l’intégration.

## SourceProcessingProperties structure
<a name="aws-glue-api-integrations-SourceProcessingProperties"></a>

Propriétés des ressources associées à la source d’intégration.

**Champs**
+ `RoleArn` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Rôle IAM permettant d'accéder à la AWS Glue connexion.

## TargetProcessingProperties structure
<a name="aws-glue-api-integrations-TargetProcessingProperties"></a>

Propriétés des ressources associées à la cible d’intégration.

**Champs**
+ `RoleArn` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Rôle IAM permettant d'accéder à la AWS Glue base de données.
+ `KmsArn` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  ARN de la clé KMS utilisée pour le chiffrement.
+ `ConnectionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Connexion AWS Glue réseau permettant de configurer la AWS Glue tâche exécutée dans le VPC du client.
+ `EventBusArn` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  ARN d’un bus d’événements Eventbridge pour recevoir la notification d’état de l’intégration.

## SourceTableConfig structure
<a name="aws-glue-api-integrations-SourceTableConfig"></a>

Propriétés utilisées par l’étape source pour traiter les données de la source.

**Champs**
+ `Fields` – Tableau de chaînes UTF-8.

  Liste des champs utilisés pour le filtrage au niveau des colonnes. Non prise en charge actuellement.
+ `FilterPredicate` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Clause de condition utilisée pour le filtrage au niveau des lignes. Non prise en charge actuellement.
+ `PrimaryKey` – Tableau de chaînes UTF-8.

  Fournissez le jeu de clés primaires pour cette table. Actuellement pris en charge spécifiquement pour les entités SAP `EntityOf` sur demande. Contactez AWS le Support pour rendre cette fonctionnalité disponible.
+ `RecordUpdateField` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Champ d’extraction incrémentielle basée sur l’horodatage. Non prise en charge actuellement.

## TargetTableConfig structure
<a name="aws-glue-api-integrations-TargetTableConfig"></a>

Propriétés utilisées par l’étape cible pour partitionner les données sur la cible.

**Champs**
+ `UnnestSpec` – Chaîne UTF-8 (valeurs valides : `TOPLEVEL` \$1 `FULL` \$1 `NOUNNEST`).

  Spécifie la manière dont les objets imbriqués sont aplatis par rapport aux éléments de niveau supérieur. Les valeurs valides sont : « TOPLEVEL », « FULL » ou « NOUNNEST ».
+ `PartitionSpec` : un tableau d’objets [IntegrationPartition](#aws-glue-api-integrations-IntegrationPartition).

  Détermine la disposition du fichier sur la cible.
+ `TargetTableName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Nom facultatif d’une table cible.

## Opérations
<a name="aws-glue-api-integrations-actions"></a>
+ [CreateIntegration action (Python : create\$1integration)](#aws-glue-api-integrations-CreateIntegration)
+ [ModifyIntegration action (Python : modifier\$1intégration)](#aws-glue-api-integrations-ModifyIntegration)
+ [DescribeIntegrations action (Python : describe\$1integrations)](#aws-glue-api-integrations-DescribeIntegrations)
+ [DeleteIntegration action (Python : delete\$1integration)](#aws-glue-api-integrations-DeleteIntegration)
+ [DescribeInboundIntegrations action (Python : describe\$1inbound\$1integrations)](#aws-glue-api-integrations-DescribeInboundIntegrations)
+ [CreateIntegrationTableProperties action (Python : create\$1integration\$1table\$1properties)](#aws-glue-api-integrations-CreateIntegrationTableProperties)
+ [UpdateIntegrationTableProperties action (Python : update\$1integration\$1table\$1properties)](#aws-glue-api-integrations-UpdateIntegrationTableProperties)
+ [GetIntegrationTableProperties action (Python : get\$1integration\$1table\$1properties)](#aws-glue-api-integrations-GetIntegrationTableProperties)
+ [DeleteIntegrationTableProperties action (Python : delete\$1integration\$1table\$1properties)](#aws-glue-api-integrations-DeleteIntegrationTableProperties)
+ [CreateIntegrationResourceProperty action (Python : create\$1integration\$1resource\$1property)](#aws-glue-api-integrations-CreateIntegrationResourceProperty)
+ [UpdateIntegrationResourceProperty action (Python : update\$1integration\$1resource\$1property)](#aws-glue-api-integrations-UpdateIntegrationResourceProperty)
+ [GetIntegrationResourceProperty action (Python : get\$1integration\$1resource\$1property)](#aws-glue-api-integrations-GetIntegrationResourceProperty)
+ [UntagResource action (Python : untag\$1resource)](#aws-glue-api-integrations-UntagResource)
+ [ListTagsForResource action (Python : list\$1tags\$1for\$1resource)](#aws-glue-api-integrations-ListTagsForResource)

## CreateIntegration action (Python : create\$1integration)
<a name="aws-glue-api-integrations-CreateIntegration"></a>

Crée une intégration zéro ETL dans le compte de l'appelant entre deux ressources portant Amazon Resource Names (ARNs) : le `SourceArn` et. `TargetArn`

**Demande**
+ `IntegrationName`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Nom unique pour une intégration dans AWS Glue.
+ `SourceArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de la ressource source pour l’intégration.
+ `TargetArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de la ressource cible pour l’intégration..
+ `Description` – chaîne UTF-8, d’une longueur ne dépassant pas 1 000 octets, correspondant au [Custom string pattern #12](aws-glue-api-common.md#regex_12).

  Description de l’intégration.
+ `DataFilter` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Sélectionne les tables source pour l’intégration à l’aide de la syntaxe du filtre Maxwell.
+ `KmsKeyId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  ARN d’une clé KMS utilisée pour chiffrer le canal.
+ `AdditionalEncryptionContext` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Ensemble facultatif de paires clé-valeur non secrètes qui contiennent des informations contextuelles supplémentaires pour le chiffrement. Il ne peut être fourni que si `KMSKeyId` est indiqué.
+ `Tags` : un tableau d’objets [Balise](aws-glue-api-common.md#aws-glue-api-common-Tag).

  Métadonnée attribuée à la ressource composée d’une liste de paires clé-valeur.
+ `IntegrationConfig` : un objet [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig).

  Paramètres de configuration.

**Réponse**
+ `SourceArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de la ressource source pour l’intégration.
+ `TargetArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de la ressource cible pour l’intégration..
+ `IntegrationName`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Nom unique pour une intégration dans AWS Glue.
+ `Description` – chaîne UTF-8, d’une longueur ne dépassant pas 1 000 octets, correspondant au [Custom string pattern #12](aws-glue-api-common.md#regex_12).

  Description de l’intégration.
+ `IntegrationArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Amazon Resource Name (ARN) de l’intégration créée.
+ `KmsKeyId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  ARN d’une clé KMS utilisée pour chiffrer le canal.
+ `AdditionalEncryptionContext` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Ensemble facultatif de paires clé-valeur non secrètes qui contiennent des informations contextuelles supplémentaires pour le chiffrement.
+ `Tags` : un tableau d’objets [Balise](aws-glue-api-common.md#aws-glue-api-common-Tag).

  Métadonnée attribuée à la ressource composée d’une liste de paires clé-valeur.
+ `Status` –* Obligatoire :* Chaîne UTF-8 (valeurs valides : `CREATING` \$1 `ACTIVE` \$1 `MODIFYING` \$1 `FAILED` \$1 `DELETING` \$1 `SYNCING` \$1 `NEEDS_ATTENTION`).

  État de l’intégration en cours de création.

  Les statuts possibles sont les suivants :
  + CREATING : l’intégration est en cours de création.
  + ACTIVE : la création de l’intégration a réussi..
  + MODIFYING : l’intégration est en cours de modification.
  + FAILED : la création de l’intégration a échoué. 
  + DELETING : l’intégration est supprimée.
  + SYNCING : l’intégration est en cours de synchronisation.
  + NEEDS\$1ATTENTION : l’intégration requiert votre attention, par exemple pour la synchronisation.
+ `CreateTime` – *obligatoire :* horodatage.

  Heure (UTC) de création de l’intégration.
+ `Errors` : un tableau d’objets [IntegrationError](#aws-glue-api-integrations-IntegrationError).

  Liste des erreurs associées à la création de l’intégration.
+ `DataFilter` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Sélectionne les tables source pour l’intégration à l’aide de la syntaxe du filtre Maxwell.
+ `IntegrationConfig` : un objet [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig).

  Paramètres de configuration.

**Erreurs**
+ `ValidationException`
+ `AccessDeniedException`
+ `ResourceNotFoundException`
+ `InternalServerException`
+ `IntegrationConflictOperationFault`
+ `IntegrationQuotaExceededFault`
+ `KMSKeyNotAccessibleFault`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `ConflictException`
+ `ResourceNumberLimitExceededException`
+ `InvalidInputException`

## ModifyIntegration action (Python : modifier\$1intégration)
<a name="aws-glue-api-integrations-ModifyIntegration"></a>

Modifie une intégration zéro ETL dans le compte de l’appelant.

**Demande**
+ `IntegrationIdentifier`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Amazon Resource Name (ARN) de l’intégration.
+ `Description` – chaîne UTF-8, d’une longueur ne dépassant pas 1 000 octets, correspondant au [Custom string pattern #12](aws-glue-api-common.md#regex_12).

  Description de l’intégration.
+ `DataFilter` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Sélectionne les tables source pour l’intégration à l’aide de la syntaxe du filtre Maxwell.
+ `IntegrationConfig` : un objet [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig).

  Paramètres de configuration pour l’intégration. Actuellement, seuls les RefreshInterval peuvent être modifiés. 
+ `IntegrationName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Nom unique pour une intégration dans AWS Glue.

**Réponse**
+ `SourceArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de la source pour l’intégration.
+ `TargetArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de la cible pour l’intégration.
+ `IntegrationName`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Nom unique pour une intégration dans AWS Glue.
+ `Description` – chaîne UTF-8, d’une longueur ne dépassant pas 1 000 octets, correspondant au [Custom string pattern #12](aws-glue-api-common.md#regex_12).

  Description de l’intégration.
+ `IntegrationArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Amazon Resource Name (ARN) de l’intégration.
+ `KmsKeyId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  ARN d’une clé KMS utilisée pour chiffrer le canal.
+ `AdditionalEncryptionContext` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Ensemble facultatif de paires clé-valeur non secrètes qui contiennent des informations contextuelles supplémentaires pour le chiffrement.
+ `Tags` : un tableau d’objets [Balise](aws-glue-api-common.md#aws-glue-api-common-Tag).

  Métadonnée attribuée à la ressource composée d’une liste de paires clé-valeur.
+ `Status` –* Obligatoire :* Chaîne UTF-8 (valeurs valides : `CREATING` \$1 `ACTIVE` \$1 `MODIFYING` \$1 `FAILED` \$1 `DELETING` \$1 `SYNCING` \$1 `NEEDS_ATTENTION`).

  État de l’intégration en cours de modification.

  Les statuts possibles sont les suivants :
  + CREATING : l’intégration est en cours de création.
  + ACTIVE : la création de l’intégration a réussi..
  + MODIFYING : l’intégration est en cours de modification.
  + FAILED : la création de l’intégration a échoué. 
  + DELETING : l’intégration est supprimée.
  + SYNCING : l’intégration est en cours de synchronisation.
  + NEEDS\$1ATTENTION : l’intégration requiert votre attention, par exemple pour la synchronisation.
+ `CreateTime` – *obligatoire :* horodatage.

  Heure (UTC) de création de l’intégration.
+ `Errors` : un tableau d’objets [IntegrationError](#aws-glue-api-integrations-IntegrationError).

  Liste des erreurs associées à la modification de l’intégration.
+ `DataFilter` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Sélectionne les tables source pour l’intégration à l’aide de la syntaxe du filtre Maxwell.
+ `IntegrationConfig` : un objet [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig).

  Paramètres de configuration mis à jour pour l’intégration.

**Erreurs**
+ `ValidationException`
+ `AccessDeniedException`
+ `InternalServerException`
+ `IntegrationNotFoundFault`
+ `IntegrationConflictOperationFault`
+ `InvalidIntegrationStateFault`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `ConflictException`
+ `InvalidStateException`
+ `InvalidInputException`

## DescribeIntegrations action (Python : describe\$1integrations)
<a name="aws-glue-api-integrations-DescribeIntegrations"></a>

L’API est utilisée pour récupérer une liste d’intégrations.

**Demande**
+ `IntegrationIdentifier` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Amazon Resource Name (ARN) de l’intégration.
+ `Marker` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Valeur qui indique le point de départ de la prochaine série d’enregistrements de réponses dans une demande ultérieure.
+ `MaxRecords` : nombre (entier).

  Nombre total d’éléments à renvoyer dans la sortie.
+ `Filters` : un tableau d’objets [IntegrationFilter](#aws-glue-api-integrations-IntegrationFilter).

  Liste de clés et de valeurs, pour filtrer les résultats. Les touches prises en charge sont « Status », IntegrationName « » et « SourceArn ». IntegrationName est limité à une seule valeur.

**Réponse**
+ `Integrations` : un tableau d’objets [Integration](#aws-glue-api-integrations-Integration).

  Liste des intégrations zéro ETL.
+ `Marker` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Valeur qui indique le point de départ de la prochaine série d’enregistrements de réponses dans une demande ultérieure.

**Erreurs**
+ `ValidationException`
+ `AccessDeniedException`
+ `InternalServerException`
+ `IntegrationNotFoundFault`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## DeleteIntegration action (Python : delete\$1integration)
<a name="aws-glue-api-integrations-DeleteIntegration"></a>

Supprime l’intégration zéro ETL spécifiée.

**Demande**
+ `IntegrationIdentifier`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Amazon Resource Name (ARN) de l’intégration.

**Réponse**
+ `SourceArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de la source pour l’intégration.
+ `TargetArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de la cible pour l’intégration.
+ `IntegrationName`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Nom unique pour une intégration dans AWS Glue.
+ `Description` – chaîne UTF-8, d’une longueur ne dépassant pas 1 000 octets, correspondant au [Custom string pattern #12](aws-glue-api-common.md#regex_12).

  Description de l’intégration.
+ `IntegrationArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Amazon Resource Name (ARN) de l’intégration.
+ `KmsKeyId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  ARN d’une clé KMS utilisée pour chiffrer le canal.
+ `AdditionalEncryptionContext` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Ensemble facultatif de paires clé-valeur non secrètes qui contiennent des informations contextuelles supplémentaires pour le chiffrement.
+ `Tags` : un tableau d’objets [Balise](aws-glue-api-common.md#aws-glue-api-common-Tag).

  Métadonnée attribuée à la ressource composée d’une liste de paires clé-valeur.
+ `Status` –* Obligatoire :* Chaîne UTF-8 (valeurs valides : `CREATING` \$1 `ACTIVE` \$1 `MODIFYING` \$1 `FAILED` \$1 `DELETING` \$1 `SYNCING` \$1 `NEEDS_ATTENTION`).

  État de l’intégration en cours de suppression.

  Les statuts possibles sont les suivants :
  + CREATING : l’intégration est en cours de création.
  + ACTIVE : la création de l’intégration a réussi..
  + MODIFYING : l’intégration est en cours de modification.
  + FAILED : la création de l’intégration a échoué. 
  + DELETING : l’intégration est supprimée.
  + SYNCING : l’intégration est en cours de synchronisation.
  + NEEDS\$1ATTENTION : l’intégration requiert votre attention, par exemple pour la synchronisation.
+ `CreateTime` – *obligatoire :* horodatage.

  Heure (UTC) de création de l’intégration.
+ `Errors` : un tableau d’objets [IntegrationError](#aws-glue-api-integrations-IntegrationError).

  Liste des erreurs associées à l’intégration.
+ `DataFilter` – Chaîne UTF-8, d’une longueur comprise entre 1 et 2 048 octets.

  Sélectionne les tables source pour l’intégration à l’aide de la syntaxe du filtre Maxwell.

**Erreurs**
+ `ValidationException`
+ `AccessDeniedException`
+ `InternalServerException`
+ `IntegrationNotFoundFault`
+ `IntegrationConflictOperationFault`
+ `InvalidIntegrationStateFault`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `ConflictException`
+ `InvalidStateException`
+ `InvalidInputException`

## DescribeInboundIntegrations action (Python : describe\$1inbound\$1integrations)
<a name="aws-glue-api-integrations-DescribeInboundIntegrations"></a>

Renvoie une liste des intégrations entrantes pour l’intégration spécifiée.

**Demande**
+ `IntegrationArn` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Amazon Resource Name (ARN) de l’intégration.
+ `Marker` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Jeton permettant de spécifier où commencer la pagination. Il s’agit du marqueur provenant d’une réponse tronquée précédemment.
+ `MaxRecords` : nombre (entier).

  Nombre total d’éléments à renvoyer dans la sortie.
+ `TargetArn` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Amazon Resource Name (ARN) de la ressource cible dans l’intégration.

**Réponse**
+ `InboundIntegrations` : un tableau d’objets [InboundIntegration](#aws-glue-api-integrations-InboundIntegration).

  Liste des intégrations entrantes.
+ `Marker` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Valeur qui indique le point de départ de la prochaine série d’enregistrements de réponses dans une demande ultérieure.

**Erreurs**
+ `ValidationException`
+ `AccessDeniedException`
+ `InternalServerException`
+ `IntegrationNotFoundFault`
+ `TargetResourceNotFound`
+ `OperationNotSupportedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## CreateIntegrationTableProperties action (Python : create\$1integration\$1table\$1properties)
<a name="aws-glue-api-integrations-CreateIntegrationTableProperties"></a>

Cette API est utilisée pour fournir des propriétés de remplacement facultatives pour les tables qui doivent être répliquées. Ces propriétés peuvent inclure des propriétés de filtrage et de partitionnement pour les tables source et cible. Pour définir à la fois les propriétés source et cible, la même API doit être invoquée avec l'ARN de AWS Glue connexion comme `ResourceArn` avec`SourceTableConfig`, et l'ARN AWS Glue de base de données comme `ResourceArn` avec `TargetTableConfig` respectivement.

**Demande**
+ `ResourceArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Amazon Resource Name (ARN) de la table cible pour laquelle vous souhaitez créer les propriétés de la table d’intégration. Actuellement, cette API prend uniquement en charge la création de propriétés de table d'intégration pour les tables cibles, et l'ARN fourni doit être l'ARN de la table cible dans le catalogue de AWS Glue données. La prise en charge de la création de propriétés de table d’intégration pour les connexions source (à l’aide de l’ARN de connexion) n’est pas encore mise en œuvre et sera ajoutée dans une future version. 
+ `TableName`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Nom de la table à répliquer.
+ `SourceTableConfig` – Un objet [SourceTableConfig](#aws-glue-api-integrations-SourceTableConfig).

  Structure pour la configuration de table source. Consultez la structure `SourceTableConfig` pour voir la liste des propriétés source prises en charge.
+ `TargetTableConfig` – Un objet [TargetTableConfig](#aws-glue-api-integrations-TargetTableConfig).

  Structure pour la configuration de table cible.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `ValidationException`
+ `AccessDeniedException`
+ `ResourceNotFoundException`
+ `InternalServerException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## UpdateIntegrationTableProperties action (Python : update\$1integration\$1table\$1properties)
<a name="aws-glue-api-integrations-UpdateIntegrationTableProperties"></a>

Cette API est utilisée pour fournir des propriétés de remplacement facultatives pour les tables qui doivent être répliquées. Ces propriétés peuvent inclure des propriétés de filtrage et de partitionnement pour les tables source et cible. Pour définir à la fois les propriétés source et cible, la même API doit être invoquée avec l'ARN de AWS Glue connexion comme `ResourceArn` avec`SourceTableConfig`, et l'ARN AWS Glue de base de données comme `ResourceArn` avec `TargetTableConfig` respectivement.

Le remplacement sera reflété dans toutes les intégrations utilisant le même `ResourceArn` et la même table source.

**Demande**
+ `ResourceArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de connexion de la source ou ARN de base de données de la cible.
+ `TableName`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Nom de la table à répliquer.
+ `SourceTableConfig` – Un objet [SourceTableConfig](#aws-glue-api-integrations-SourceTableConfig).

  Structure pour la configuration de table source.
+ `TargetTableConfig` – Un objet [TargetTableConfig](#aws-glue-api-integrations-TargetTableConfig).

  Structure pour la configuration de table cible.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `ValidationException`
+ `AccessDeniedException`
+ `ResourceNotFoundException`
+ `InternalServerException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## GetIntegrationTableProperties action (Python : get\$1integration\$1table\$1properties)
<a name="aws-glue-api-integrations-GetIntegrationTableProperties"></a>

Cette API est utilisée pour extraire des propriétés de remplacement facultatives pour les tables qui doivent être répliquées. Ces propriétés peuvent inclure des propriétés de filtrage et de partition pour les tables source et cible.

**Demande**
+ `ResourceArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Amazon Resource Name (ARN) de la table cible pour laquelle vous souhaitez récupérer les propriétés de la table d’intégration. Actuellement, cette API prend uniquement en charge la récupération des propriétés des tables cibles, et l'ARN fourni doit être l'ARN de la table cible dans le catalogue de AWS Glue données. La prise en charge de la récupération de propriétés de table d’intégration pour les connexions source (à l’aide de l’ARN de connexion) n’est pas encore mise en œuvre et sera ajoutée dans une future version. 
+ `TableName`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Nom de la table à répliquer.

**Réponse**
+ `ResourceArn` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Amazon Resource Name (ARN) de la table cible pour laquelle vous souhaitez récupérer les propriétés de la table d’intégration. Actuellement, cette API prend uniquement en charge la récupération des propriétés des tables cibles, et l'ARN fourni doit être l'ARN de la table cible dans le catalogue de AWS Glue données. La prise en charge de la récupération de propriétés de table d’intégration pour les connexions source (à l’aide de l’ARN de connexion) n’est pas encore mise en œuvre et sera ajoutée dans une future version. 
+ `TableName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Nom de la table à répliquer.
+ `SourceTableConfig` – Un objet [SourceTableConfig](#aws-glue-api-integrations-SourceTableConfig).

  Structure pour la configuration de table source.
+ `TargetTableConfig` – Un objet [TargetTableConfig](#aws-glue-api-integrations-TargetTableConfig).

  Structure pour la configuration de table cible.

**Erreurs**
+ `ValidationException`
+ `AccessDeniedException`
+ `ResourceNotFoundException`
+ `InternalServerException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## DeleteIntegrationTableProperties action (Python : delete\$1integration\$1table\$1properties)
<a name="aws-glue-api-integrations-DeleteIntegrationTableProperties"></a>

Supprime les propriétés de table créées pour les tables devant être répliquées.

**Demande**
+ `ResourceArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de connexion de la source ou ARN de base de données de la cible.
+ `TableName`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  Nom de la table à répliquer.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `ValidationException`
+ `AccessDeniedException`
+ `ResourceNotFoundException`
+ `InternalServerException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## CreateIntegrationResourceProperty action (Python : create\$1integration\$1resource\$1property)
<a name="aws-glue-api-integrations-CreateIntegrationResourceProperty"></a>

Cette API peut être utilisée pour configurer la AWS Glue connexion (pour `ResourceProperty` la source) ou l'ARN de la AWS Glue base de données (pour la cible). Ces propriétés peuvent inclure le rôle permettant d’accéder à la connexion ou à la base de données. Pour définir les propriétés source et cible, la même API doit être invoquée avec l'ARN de AWS Glue connexion comme `ResourceArn` avec `SourceProcessingProperties` et l'ARN AWS Glue de base de données comme `ResourceArn` avec `TargetProcessingProperties` respectivement.

**Demande**
+ `ResourceArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de connexion de la source ou ARN de base de données de la cible.
+ `SourceProcessingProperties` – Un objet [SourceProcessingProperties](#aws-glue-api-integrations-SourceProcessingProperties).

  Propriétés des ressources associées à la source d’intégration.
+ `TargetProcessingProperties` – Un objet [TargetProcessingProperties](#aws-glue-api-integrations-TargetProcessingProperties).

  Propriétés des ressources associées à la cible d’intégration.

**Réponse**
+ `ResourceArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de connexion de la source ou ARN de base de données de la cible.
+ `SourceProcessingProperties` – Un objet [SourceProcessingProperties](#aws-glue-api-integrations-SourceProcessingProperties).

  Propriétés des ressources associées à la source d’intégration.
+ `TargetProcessingProperties` – Un objet [TargetProcessingProperties](#aws-glue-api-integrations-TargetProcessingProperties).

  Propriétés des ressources associées à la cible d’intégration.

**Erreurs**
+ `ValidationException`
+ `AccessDeniedException`
+ `ConflictException`
+ `InternalServerException`
+ `ResourceNotFoundException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## UpdateIntegrationResourceProperty action (Python : update\$1integration\$1resource\$1property)
<a name="aws-glue-api-integrations-UpdateIntegrationResourceProperty"></a>

Cette API peut être utilisée pour mettre à jour `ResourceProperty` la AWS Glue connexion (pour la source) ou l'ARN de la AWS Glue base de données (pour la cible). Ces propriétés peuvent inclure le rôle permettant d’accéder à la connexion ou à la base de données. Comme la même ressource peut être utilisée dans plusieurs intégrations, la mise à jour des propriétés des ressources aura un impact sur toutes les intégrations qui l’utilisent.

**Demande**
+ `ResourceArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de connexion de la source ou ARN de base de données de la cible.
+ `SourceProcessingProperties` – Un objet [SourceProcessingProperties](#aws-glue-api-integrations-SourceProcessingProperties).

  Propriétés des ressources associées à la source d’intégration.
+ `TargetProcessingProperties` – Un objet [TargetProcessingProperties](#aws-glue-api-integrations-TargetProcessingProperties).

  Propriétés des ressources associées à la cible d’intégration.

**Réponse**
+ `ResourceArn` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  ARN de connexion de la source ou ARN de base de données de la cible.
+ `SourceProcessingProperties` – Un objet [SourceProcessingProperties](#aws-glue-api-integrations-SourceProcessingProperties).

  Propriétés des ressources associées à la source d’intégration.
+ `TargetProcessingProperties` – Un objet [TargetProcessingProperties](#aws-glue-api-integrations-TargetProcessingProperties).

  Propriétés des ressources associées à la cible d’intégration.

**Erreurs**
+ `ValidationException`
+ `AccessDeniedException`
+ `InternalServerException`
+ `ResourceNotFoundException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## GetIntegrationResourceProperty action (Python : get\$1integration\$1resource\$1property)
<a name="aws-glue-api-integrations-GetIntegrationResourceProperty"></a>

Cette API est utilisée pour récupérer la AWS Glue connexion (pour `ResourceProperty` la source) ou l'ARN de la AWS Glue base de données (pour la cible)

**Demande**
+ `ResourceArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 1 ou de plus de 128 octets.

  ARN de connexion de la source ou ARN de base de données de la cible.

**Réponse**
+ `ResourceArn` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  ARN de connexion de la source ou ARN de base de données de la cible.
+ `SourceProcessingProperties` – Un objet [SourceProcessingProperties](#aws-glue-api-integrations-SourceProcessingProperties).

  Propriétés des ressources associées à la source d’intégration.
+ `TargetProcessingProperties` – Un objet [TargetProcessingProperties](#aws-glue-api-integrations-TargetProcessingProperties).

  Propriétés des ressources associées à la cible d’intégration.

**Erreurs**
+ `ValidationException`
+ `AccessDeniedException`
+ `InternalServerException`
+ `ResourceNotFoundException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## UntagResource action (Python : untag\$1resource)
<a name="aws-glue-api-integrations-UntagResource"></a>

Supprime les balises spécifiées d’une ressource d’intégration.

**Demande**
+ `ResourceArn` – *Obligatoire :* chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  Amazon Resource Name (ARN) de la ressource d’intégration.
+ `TagsToRemove` – *Obligatoire :* Tableau de chaînes UTF-8, avec 50 chaînes maximum.

  Liste des balises de métadonnés à supprimer de la ressource.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `ResourceNotFoundException`

## ListTagsForResource action (Python : list\$1tags\$1for\$1resource)
<a name="aws-glue-api-integrations-ListTagsForResource"></a>

Répertorie les balises de métadonnées attribuées à la ressource spécifiée.

**Demande**
+ `ResourceARN` – *Obligatoire :* chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  ARN de ressource pour la ressource.

**Réponse**
+ `Tags` – Un tableau d'objets [Balise](aws-glue-api-common.md#aws-glue-api-common-Tag), 10 structures au maximum.

  Une liste de balises.

**Erreurs**
+ `ResourceNotFoundException`

## Exceptions
<a name="aws-glue-api-integrations-exceptions"></a>
+ [ResourceNotFoundException structure](#aws-glue-api-integrations-ResourceNotFoundException)
+ [InternalServerException structure](#aws-glue-api-integrations-InternalServerException)
+ [IntegrationAlreadyExistsFault structure](#aws-glue-api-integrations-IntegrationAlreadyExistsFault)
+ [IntegrationConflictOperationFault structure](#aws-glue-api-integrations-IntegrationConflictOperationFault)
+ [IntegrationQuotaExceededFault structure](#aws-glue-api-integrations-IntegrationQuotaExceededFault)
+ [KMSKeyNotAccessibleFault structure](#aws-glue-api-integrations-KMSKeyNotAccessibleFault)
+ [IntegrationNotFoundFault structure](#aws-glue-api-integrations-IntegrationNotFoundFault)
+ [TargetResourceNotFound structure](#aws-glue-api-integrations-TargetResourceNotFound)
+ [InvalidIntegrationStateFault structure](#aws-glue-api-integrations-InvalidIntegrationStateFault)

## ResourceNotFoundException structure
<a name="aws-glue-api-integrations-ResourceNotFoundException"></a>

La ressource est introuvable.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## InternalServerException structure
<a name="aws-glue-api-integrations-InternalServerException"></a>

Une erreur interne du serveur s’est produite.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## IntegrationAlreadyExistsFault structure
<a name="aws-glue-api-integrations-IntegrationAlreadyExistsFault"></a>

L’intégration spécifiée existe déjà.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## IntegrationConflictOperationFault structure
<a name="aws-glue-api-integrations-IntegrationConflictOperationFault"></a>

L’opération demandée est en conflit avec une autre opération.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## IntegrationQuotaExceededFault structure
<a name="aws-glue-api-integrations-IntegrationQuotaExceededFault"></a>

Les données traitées dans le cadre de votre intégration ont dépassé votre quota.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## KMSKeyNotAccessibleFault structure
<a name="aws-glue-api-integrations-KMSKeyNotAccessibleFault"></a>

La clé KMS spécifiée n’est pas accessible.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## IntegrationNotFoundFault structure
<a name="aws-glue-api-integrations-IntegrationNotFoundFault"></a>

L’intégration spécifiée est introuvable.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## TargetResourceNotFound structure
<a name="aws-glue-api-integrations-TargetResourceNotFound"></a>

La ressource cible est introuvable.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## InvalidIntegrationStateFault structure
<a name="aws-glue-api-integrations-InvalidIntegrationStateFault"></a>

L’intégration est dans un état non valide.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

# Séances interactives API
<a name="aws-glue-api-interactive-sessions"></a>

L'API des sessions interactives décrit l' AWS Glue API liée à l'utilisation de sessions AWS Glue interactives pour créer et tester des scripts d'extraction, de transformation et de chargement (ETL) pour l'intégration de données.

## Types de données
<a name="aws-glue-api-interactive-sessions-objects"></a>
+ [Structure de séance](#aws-glue-api-interactive-sessions-Session)
+ [SessionCommand structure](#aws-glue-api-interactive-sessions-SessionCommand)
+ [Structure de la déclaration](#aws-glue-api-interactive-sessions-Statement)
+ [StatementOutput structure](#aws-glue-api-interactive-sessions-StatementOutput)
+ [StatementOutputData structure](#aws-glue-api-interactive-sessions-StatementOutputData)
+ [ConnectionsList structure](#aws-glue-api-interactive-sessions-ConnectionsList)

## Structure de séance
<a name="aws-glue-api-interactive-sessions-Session"></a>

Période pendant laquelle un environnement d'exécution Spark distant est en cours d'exécution.

**Champs**
+ `Id` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID de la séance.
+ `CreatedOn` – Horodatage.

  Date et heure de création de la séance.
+ `Status` – Chaîne UTF-8 (valeurs valides : `PROVISIONING` \$1 `READY` \$1 `FAILED` \$1 `TIMEOUT` \$1 `STOPPING` \$1 `STOPPED`).

  Statut d'une séance. 
+ `ErrorMessage` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Le message d'erreur affiché pendant la séance.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de la séance.
+ `Role` – chaîne UTF-8, d'une longueur comprise entre 20 et 2048 octets, correspondant au [Custom string pattern #30](aws-glue-api-common.md#regex_30).

  Nom ou Amazon Resource Name (ARN) du rôle IAM associé à la séance.
+ `Command` – Un objet [SessionCommand](#aws-glue-api-interactive-sessions-SessionCommand).

  L'objet de commande. Voir. SessionCommand
+ `DefaultArguments` – Tableau de mappage de paires valeur-clé, avec 75 paires au maximum.

  Chaque clé est une chaîne UTF-8, d'une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Chaque valeur est une chaîne UTF-8, d'une longueur ne dépassant pas 4096 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Tableau de mappage de paires valeur-clé. Le maximum est de 75 paires. 
+ `Connections` – Un objet [ConnectionsList](#aws-glue-api-interactive-sessions-ConnectionsList).

  Nombre de connexions utilisées pour la séance.
+ `Progress` – Nombre (double).

  La progression de l'exécution du code de la séance.
+ `MaxCapacity` – Nombre (double).

  Le nombre d'unités de traitement de AWS Glue données (DPUs) qui peuvent être allouées lors de l'exécution de la tâche. Un DPU est une mesure relative de la puissance de traitement composée de 4 V de capacité CPUs de calcul et de 16 Go de mémoire. 
+ `SecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la SecurityConfiguration structure à utiliser avec la session.
+ `GlueVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  La AWS Glue version détermine les versions d'Apache Spark et de Python prises AWS Glue en charge. Le GlueVersion doit être supérieur à 2,0.
+ `DataAccessId` – Chaîne UTF-8, d'une longueur comprise entre 1 et 36 octets.

  ID d'accès aux données de la séance.
+ `PartitionId` – Chaîne UTF-8, d'une longueur comprise entre 1 et 36 octets.

  L'ID de partition de la séance.
+ `NumberOfWorkers` : nombre (entier).

  Nombre d'utilisateurs d'une `WorkerType` définie pour la séance.
+ `WorkerType` – Chaîne UTF-8 (valeurs valides: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  Type de travail prédéfini qui est alloué lorsqu'une session est exécutée. Accepte une valeur de `G.1X`, `G.2X`, `G.4X` ou `G.8X` pour les sessions Spark. Accepte la valeur `Z.2X` pour les sessions Ray.
+ `CompletedOn` – Horodatage.

  La date et heure à laquelle cette session s'est terminée.
+ `ExecutionTime` – Nombre (double).

  La durée totale de la session.
+ `DPUSeconds` – Nombre (double).

  La DPUs consommation par la séance (formule : ExecutionTime \$1 MaxCapacity).
+ `IdleTimeout` : nombre (entier).

  Le nombre de minutes d'inactivité avant l'expiration de la session.
+ `ProfileName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom d'un profil AWS Glue d'utilisation associé à la session.

## SessionCommand structure
<a name="aws-glue-api-interactive-sessions-SessionCommand"></a>

La commande `SessionCommand` qui exécute cette tâche.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Spécifie le nom du SessionCommand. Il peut s'agir de « gluetel » ou de « gluestreaming ».
+ `PythonVersion` – Chaîne UTF-8, correspondant au [Custom string pattern #49](aws-glue-api-common.md#regex_49).

  Spécifie la version de Python utilisée. La version de Python indique la version prise en charge pour les tâches de type Spark.

## Structure de la déclaration
<a name="aws-glue-api-interactive-sessions-Statement"></a>

La déclaration ou la demande pour qu'une action particulière se produise dans une séance.

**Champs**
+ `Id` : nombre (entier).

  ID de la déclaration.
+ `Code` – Chaîne UTF-8.

  Code d'exécution de la déclaration.
+ `State` – Chaîne UTF-8 (valeurs valides: `WAITING` \$1 `RUNNING` \$1 `AVAILABLE` \$1 `CANCELLING` \$1 `CANCELLED` \$1 \$1 ).

  État pendant que la demande est exécutée.
+ `Output` – Un objet [StatementOutput](#aws-glue-api-interactive-sessions-StatementOutput).

  Le résultat en JSON.
+ `Progress` – Nombre (double).

  La progression de l'exécution du code.
+ `StartedOn` – Nombre (long).

  Date et heure Unix de démarrage de la définition de tâche.
+ `CompletedOn` – Nombre (long).

  Date et heure Unix auxquelles la définition de tâche a été terminée.

## StatementOutput structure
<a name="aws-glue-api-interactive-sessions-StatementOutput"></a>

Résultat de l'exécution de code au format JSON.

**Champs**
+ `Data` – Un objet [StatementOutputData](#aws-glue-api-interactive-sessions-StatementOutputData).

  Résultat de l'exécution de code.
+ `ExecutionCount` : nombre (entier).

  Nombre d'exécution du résultat.
+ `Status` – Chaîne UTF-8 (valeurs valides : `WAITING` \$1 `RUNNING` \$1 `AVAILABLE` \$1 `CANCELLING` \$1 `CANCELLED` \$1 `ERROR`).

  Statut du résultat de l'exécution de code.
+ `ErrorName` – Chaîne UTF-8.

  Nom de l'erreur dans le résultat.
+ `ErrorValue` – Chaîne UTF-8.

  Valeur de l'erreur du résultat.
+ `Traceback` – Tableau de chaînes UTF-8.

  Le retraçage du résultat.

## StatementOutputData structure
<a name="aws-glue-api-interactive-sessions-StatementOutputData"></a>

Résultat de l'exécution de code au format JSON.

**Champs**
+ `TextPlain` – Chaîne UTF-8.

  Résultat de l'exécution de code au format texte.

## ConnectionsList structure
<a name="aws-glue-api-interactive-sessions-ConnectionsList"></a>

Spécifie les connexions utilisées par une tâche.

**Champs**
+ `Connections` – Tableau de chaînes UTF-8, avec 1 000 chaînes maximum.

  Liste de connexions utilisées par la tâche.

## Opérations
<a name="aws-glue-api-interactive-sessions-actions"></a>
+ [CreateSession action (Python : créer\$1session)](#aws-glue-api-interactive-sessions-CreateSession)
+ [StopSession action (Python : stop\$1session)](#aws-glue-api-interactive-sessions-StopSession)
+ [DeleteSession action (Python : supprimer\$1session)](#aws-glue-api-interactive-sessions-DeleteSession)
+ [GetSession action (Python : get\$1session)](#aws-glue-api-interactive-sessions-GetSession)
+ [ListSessions action (Python : list\$1sessions)](#aws-glue-api-interactive-sessions-ListSessions)
+ [RunStatement action (Python : run\$1statement)](#aws-glue-api-interactive-sessions-RunStatement)
+ [CancelStatement action (Python : annuler\$1statement)](#aws-glue-api-interactive-sessions-CancelStatement)
+ [GetStatement action (Python : get\$1statement)](#aws-glue-api-interactive-sessions-GetStatement)
+ [ListStatements action (Python : list\$1statements)](#aws-glue-api-interactive-sessions-ListStatements)
+ [GetGlueIdentityCenterConfiguration action (Python : get\$1glue\$1identity\$1center\$1configuration)](#aws-glue-api-interactive-sessions-GetGlueIdentityCenterConfiguration)
+ [UpdateGlueIdentityCenterConfiguration action (Python : update\$1glue\$1identity\$1center\$1configuration)](#aws-glue-api-interactive-sessions-UpdateGlueIdentityCenterConfiguration)
+ [CreateGlueIdentityCenterConfiguration action (Python : create\$1glue\$1identity\$1center\$1configuration)](#aws-glue-api-interactive-sessions-CreateGlueIdentityCenterConfiguration)
+ [DeleteGlueIdentityCenterConfiguration action (Python : delete\$1glue\$1identity\$1center\$1configuration)](#aws-glue-api-interactive-sessions-DeleteGlueIdentityCenterConfiguration)

## CreateSession action (Python : créer\$1session)
<a name="aws-glue-api-interactive-sessions-CreateSession"></a>

Crée une nouvelle séance.

**Demande**

Demande de création d'une nouvelle séance.
+ `Id` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID de la séance demandée 
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de la séance. 
+ `Role` – *Obligatoire :* chaîne UTF-8, d'une longueur comprise entre 20 et 2048 octets, correspondant au [Custom string pattern #30](aws-glue-api-common.md#regex_30).

  Un ARN de rôle IAM 
+ `Command` – *Obligatoire :* un objet [SessionCommand](#aws-glue-api-interactive-sessions-SessionCommand).

  La commande `SessionCommand` qui exécute cette tâche. 
+ `Timeout` – Nombre (entier), au moins égal à 1.

   Nombre de minutes avant l'expiration de la séance. La valeur par défaut pour les tâches ETL Spark est de 48 heures (2 880 minutes). Consultez la documentation pour les autres types de tâches. 
+ `IdleTimeout` – Nombre (entier), au moins égal à 1.

   Nombre de minutes d'inactivité avant l'expiration de la séance. La valeur par défaut pour les tâches ETL Spark est la valeur du délai d'expiration. Consultez la documentation pour les autres types de tâches. 
+ `DefaultArguments` – Tableau de mappage de paires valeur-clé, avec 75 paires au maximum.

  Chaque clé est une chaîne UTF-8, d'une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Chaque valeur est une chaîne UTF-8, d'une longueur ne dépassant pas 4096 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Tableau de mappage de paires valeur-clé. Le maximum est de 75 paires. 
+ `Connections` – Un objet [ConnectionsList](#aws-glue-api-interactive-sessions-ConnectionsList).

  Nombre de connexions à utiliser pour la séance. 
+ `MaxCapacity` – Nombre (double).

  Le nombre d'unités de traitement de AWS Glue données (DPUs) qui peuvent être allouées lors de l'exécution de la tâche. Un DPU est une mesure relative de la puissance de traitement composée de 4 V de capacité CPUs de calcul et de 16 Go de mémoire. 
+ `NumberOfWorkers` : nombre (entier).

  Nombre d'utilisateurs d'une `WorkerType` définie pour la séance. 
+ `WorkerType` – Chaîne UTF-8 (valeurs valides: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  Type de travail prédéfini qui est alloué lorsqu'une tâche est exécutée. Accepte une valeur de G.1X, G.2X, G.4X ou G.8X pour les tâches Spark. Accepte la valeur Z.2X pour les blocs-notes Ray.
  + Pour le type de `G.1X` worker, chaque worker est mappé à 1 DPU (4 vCPUs, 16 Go de mémoire) avec un disque de 94 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type de travailleur pour les charges de travail telles que les transformations de données, les jointures et les requêtes, afin de proposer un moyen évolutif et rentable d'exécuter la plupart des tâches.
  + Pour le type de `G.2X` travailleur, chaque utilisateur est mappé sur 2 DPU (8 VCPUs, 32 Go de mémoire) avec un disque de 138 Go et fournit un exécuteur par travailleur. Nous recommandons ce type de travailleur pour les charges de travail telles que les transformations de données, les jointures et les requêtes, afin de proposer un moyen évolutif et rentable d'exécuter la plupart des tâches.
  + Pour le type de `G.4X` worker, chaque worker est mappé sur 4 DPU (16 vCPUs, 64 Go de mémoire) avec un disque de 256 Go, et fournit 1 exécuteur par worker. Nous recommandons ce type de travailleur pour les tâches dont les charges de travail contiennent les transformations, les agrégations, les jointures et les requêtes les plus exigeantes. Ce type de travailleur n'est disponible que pour les tâches Spark ETL AWS Glue version 3.0 ou ultérieure dans les AWS régions suivantes : USA Est (Ohio), USA Est (Virginie du Nord), USA Ouest (Oregon), Asie-Pacifique (Singapour), Asie-Pacifique (Sydney), Asie-Pacifique (Tokyo), Canada (Centre), Europe (Francfort), Europe (Irlande) et Europe (Stockholm).
  + Pour le type de `G.8X` travailleur, chaque travailleur est mappé sur 8 DPU (32 vCPUs, 128 Go de mémoire) avec un disque de 512 Go et fournit un exécuteur par travailleur. Nous recommandons ce type de travailleur pour les tâches dont les charges de travail contiennent les transformations, les agrégations, les jointures et les requêtes les plus exigeantes. Ce type de travailleur n'est disponible que pour les tâches Spark ETL de AWS Glue version 3.0 ou ultérieure, dans les mêmes AWS régions que celles prises en charge pour le type de `G.4X` travailleur.
  + Pour le type de `Z.2X` travailleur, chaque utilisateur est mappé sur 2 M-DPU (8 VCPUs, 64 Go de mémoire) avec un disque de 128 Go et fournit jusqu'à 8 processeurs de rayons sur la base de l'autoscaler.
+ `SecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de la SecurityConfiguration structure à utiliser avec la session 
+ `GlueVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  La AWS Glue version détermine les versions d'Apache Spark et de Python prises AWS Glue en charge. Le GlueVersion doit être supérieur à 2,0. 
+ `DataAccessId` – Chaîne UTF-8, d'une longueur comprise entre 1 et 36 octets.

  ID d'accès aux données de la séance. 
+ `PartitionId` – Chaîne UTF-8, d'une longueur comprise entre 1 et 36 octets.

  ID de partition de la séance. 
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Carte des paires de valeurs clés (balises) appartenant à la séance.
+ `RequestOrigin` – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Origine de la demande. 
+ `ProfileName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom d'un profil AWS Glue d'utilisation associé à la session.

**Réponse**
+ `Session` – Un objet [Session](#aws-glue-api-interactive-sessions-Session).

  Retourne l'objet de séance dans la réponse.

**Erreurs**
+ `AccessDeniedException`
+ `IdempotentParameterMismatchException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `ValidationException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`

## StopSession action (Python : stop\$1session)
<a name="aws-glue-api-interactive-sessions-StopSession"></a>

Arrête la séance.

**Demande**
+ `Id` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de la séance à arrêter.
+ `RequestOrigin` – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Origine de la demande.

**Réponse**
+ `Id` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Retourne l'ID de la séance arrêtée.

**Erreurs**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`
+ `ConcurrentModificationException`

## DeleteSession action (Python : supprimer\$1session)
<a name="aws-glue-api-interactive-sessions-DeleteSession"></a>

Supprime la séance.

**Demande**
+ `Id` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de la séance à supprimer.
+ `RequestOrigin` – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Nom de l'origine de la demande de suppression de séance.

**Réponse**
+ `Id` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Renvoie l'ID de la séance supprimée.

**Erreurs**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`
+ `ConcurrentModificationException`

## GetSession action (Python : get\$1session)
<a name="aws-glue-api-interactive-sessions-GetSession"></a>

Récupère la séance.

**Demande**
+ `Id` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID de la séance. 
+ `RequestOrigin` – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Origine de la demande. 

**Réponse**
+ `Session` – Un objet [Session](#aws-glue-api-interactive-sessions-Session).

  L'objet récupéré est renvoyé dans la réponse.

**Erreurs**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`

## ListSessions action (Python : list\$1sessions)
<a name="aws-glue-api-interactive-sessions-ListSessions"></a>

Extrait une liste de séances.

**Demande**
+ `NextToken` – Chaîne UTF-8, d'une longueur maximale de 400 000 octets.

  Jeton pour l'ensemble de résultats suivant, ou null s'il n'y a pas de résultats supplémentaires. 
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximal de résultats. 
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Balises appartenant à la séance. 
+ `RequestOrigin` – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Origine de la demande. 

**Réponse**
+ `Ids` – Tableau de chaînes UTF-8.

  Retourne l'ID de la séance 
+ `Sessions` : un tableau d’objets [Session](#aws-glue-api-interactive-sessions-Session).

  Retourne l'objet de la séance. 
+ `NextToken` – Chaîne UTF-8, d'une longueur maximale de 400 000 octets.

  Jeton pour l'ensemble de résultats suivant, ou null s'il n'y a pas de résultats supplémentaires. 

**Erreurs**
+ `AccessDeniedException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## RunStatement action (Python : run\$1statement)
<a name="aws-glue-api-interactive-sessions-RunStatement"></a>

Exécute la déclaration.

**Demande**
+ `SessionId` – *Obligatoire :* Chaîne UTF-8, d'une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de séance de la déclaration à exécuter.
+ `Code` – *Obligatoire :* Chaîne UTF-8, d'une longueur ne dépassant pas 68000 octets.

  Code de la déclaration à exécuter.
+ `RequestOrigin` – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Origine de la demande.

**Réponse**
+ `Id` : nombre (entier).

  Renvoie l'ID de la déclaration exécutée.

**Erreurs**
+ `EntityNotFoundException`
+ `AccessDeniedException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `ValidationException`
+ `ResourceNumberLimitExceededException`
+ `IllegalSessionStateException`

## CancelStatement action (Python : annuler\$1statement)
<a name="aws-glue-api-interactive-sessions-CancelStatement"></a>

Annule la déclaration.

**Demande**
+ `SessionId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de séance de la déclaration à annuler.
+ `Id` – *Obligatoire :* nombre (entier).

  ID de la déclaration à annuler.
+ `RequestOrigin` – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Origine de la demande d'annuler la déclaration.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`

## GetStatement action (Python : get\$1statement)
<a name="aws-glue-api-interactive-sessions-GetStatement"></a>

Récupère la déclaration.

**Demande**
+ `SessionId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de séance de la déclaration.
+ `Id` – *Obligatoire :* nombre (entier).

  L'ID de la déclaration.
+ `RequestOrigin` – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Origine de la demande.

**Réponse**
+ `Statement` – Un objet [Instruction](#aws-glue-api-interactive-sessions-Statement).

  Renvoie la déclaration.

**Erreurs**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`

## ListStatements action (Python : list\$1statements)
<a name="aws-glue-api-interactive-sessions-ListStatements"></a>

Répertorie les déclarations de la séance.

**Demande**
+ `SessionId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de séance des déclarations.
+ `RequestOrigin` – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Origine de la demande de liste des déclarations.
+ `NextToken` – Chaîne UTF-8, d'une longueur maximale de 400 000 octets.

  Jeton de continuation, s’il s’agit d’un appel de continuation.

**Réponse**
+ `Statements` : un tableau d’objets [Instruction](#aws-glue-api-interactive-sessions-Statement).

  Renvoie la liste des déclarations.
+ `NextToken` – Chaîne UTF-8, d'une longueur maximale de 400 000 octets.

  Jeton de continuation, si toutes les déclarations n'ont pas encore été retournées.

**Erreurs**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`

## GetGlueIdentityCenterConfiguration action (Python : get\$1glue\$1identity\$1center\$1configuration)
<a name="aws-glue-api-interactive-sessions-GetGlueIdentityCenterConfiguration"></a>

Récupère les détails de configuration actuels AWS Glue d'Identity Center, y compris les informations relatives à l'instance et à l'application Identity Center associées.

**Demande**
+ *Aucun paramètre de demande.*

**Réponse**

Réponse contenant les détails de configuration AWS Glue d'Identity Center.
+ `ApplicationArn` – Chaîne UTF-8, d’une longueur comprise entre 10 et 1 224 octets.

  Le nom de ressource Amazon (ARN) de l'application Identity Center associée à la AWS Glue configuration.
+ `InstanceArn` – Chaîne UTF-8, d’une longueur comprise entre 10 et 1 224 octets.

  Le nom de ressource Amazon (ARN) de l'instance Identity Center associée à la AWS Glue configuration.
+ `Scopes` – Tableau de chaînes UTF-8.

  Liste des champs d'application d'Identity Center qui définissent les autorisations et les niveaux d'accès pour la AWS Glue configuration.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `AccessDeniedException`
+ `ConcurrentModificationException`

## UpdateGlueIdentityCenterConfiguration action (Python : update\$1glue\$1identity\$1center\$1configuration)
<a name="aws-glue-api-interactive-sessions-UpdateGlueIdentityCenterConfiguration"></a>

Met à jour la configuration existante de AWS Glue l'Identity Center, permettant de modifier les étendues et les autorisations de l'intégration.

**Demande**

Demande de mise à jour d'une configuration AWS Glue Identity Center existante.
+ `Scopes` – Tableau de chaînes UTF-8, entre 1 et 50 chaînes.

  Liste des étendues d'Identity Center qui définissent les autorisations et les niveaux d'accès mis à jour pour la AWS Glue configuration.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `AccessDeniedException`
+ `ConcurrentModificationException`

## CreateGlueIdentityCenterConfiguration action (Python : create\$1glue\$1identity\$1center\$1configuration)
<a name="aws-glue-api-interactive-sessions-CreateGlueIdentityCenterConfiguration"></a>

Crée une nouvelle configuration AWS Glue Identity Center pour permettre l'intégration entre AWS Glue AWS IAM Identity Center à des fins d'authentification et d'autorisation.

**Demande**

Demande de création d'une nouvelle configuration AWS Glue d'Identity Center.
+ `InstanceArn`— *Obligatoire :* chaîne UTF-8 d'une longueur d'au moins 10 octets ou supérieure à 1224 octets.

  Le nom de ressource Amazon (ARN) de l'instance Identity Center à associer à la AWS Glue configuration.
+ `Scopes` – Tableau de chaînes UTF-8, entre 1 et 50 chaînes.

  Liste des champs d'application d'Identity Center qui définissent les autorisations et les niveaux d'accès pour la AWS Glue configuration.

**Réponse**

Réponse à la création d'une nouvelle configuration AWS Glue d'Identity Center.
+ `ApplicationArn` – Chaîne UTF-8, d’une longueur comprise entre 10 et 1 224 octets.

  Le nom de ressource Amazon (ARN) de l'application Identity Center créée pour la AWS Glue configuration.

**Erreurs**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `AccessDeniedException`
+ `ConcurrentModificationException`

## DeleteGlueIdentityCenterConfiguration action (Python : delete\$1glue\$1identity\$1center\$1configuration)
<a name="aws-glue-api-interactive-sessions-DeleteGlueIdentityCenterConfiguration"></a>

Supprime la configuration existante de l' AWS Glue Identity Center, supprimant ainsi l'intégration entre IAM Identity Center AWS Glue et AWS IAM Identity Center.

**Demande**
+ *Aucun paramètre de demande.*

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `AccessDeniedException`
+ `ConcurrentModificationException`

# API de points de terminaison de développement
<a name="aws-glue-api-dev-endpoint"></a>

L'API Development endpoints décrit l' AWS Glue API liée aux tests à l'aide d'une personnalisation DevEndpoint.

## Types de données
<a name="aws-glue-api-dev-endpoint-objects"></a>
+ [DevEndpoint structure](#aws-glue-api-dev-endpoint-DevEndpoint)
+ [DevEndpointCustomLibraries structure](#aws-glue-api-dev-endpoint-DevEndpointCustomLibraries)

## DevEndpoint structure
<a name="aws-glue-api-dev-endpoint-DevEndpoint"></a>

Point de terminaison de développement où un développeur peut déboguer à distance des scripts ETL (extraction, transformation et chargement).

**Champs**
+ `EndpointName` – Chaîne UTF-8.

  Le nom de l'`DevEndpoint`.
+ `RoleArn` – Chaîne UTF-8, correspondant au [AWS IAM ARN string pattern](aws-glue-api-common.md#aws-glue-api-regex-aws-iam-arn-id).

  Amazon Resource Name (ARN) du rôle IAM utilisé dans ce `DevEndpoint`.
+ `SecurityGroupIds` – Tableau de chaînes UTF-8.

  Liste d'identifiants de groupe de sécurité utilisés dans ce `DevEndpoint`.
+ `SubnetId` – Chaîne UTF-8.

  ID de sous-réseau pour ce `DevEndpoint`.
+ `YarnEndpointAddress` – Chaîne UTF-8.

  Adresse du point de terminaison YARN utilisée par ce `DevEndpoint`.
+ `PrivateAddress` – Chaîne UTF-8.

  Adresse IP privée pour accéder au `DevEndpoint` au sein d'un VPC si le `DevEndpoint` est créé dans celui-ci. Le champ `PrivateAddress` est présent uniquement lorsque vous créez le `DevEndpoint` au sein de votre VPC.
+ `ZeppelinRemoteSparkInterpreterPort` : nombre (entier).

  Port Apache Zeppelin pour l'interpréteur Apache Spark à distance.
+ `PublicAddress` – Chaîne UTF-8.

  Adresse IP publique utilisée par ce `DevEndpoint`. Le champ `PublicAddress` est présent uniquement lorsque vous créez un `DevEndpoint` de cloud privé non virtuel.
+ `Status` – Chaîne UTF-8.

  Statut actuel de ce `DevEndpoint`.
+ `WorkerType` – Chaîne UTF-8 (valeurs valides: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  Type de travail prédéfini qui est alloué au point de terminaison de développement. Accepte la valeur Standard, G.1X ou G.2X.
  + Pour le type de travail `Standard`, chaque travail fournit 4 vCPU, 16 Go de mémoire et 50 Go de disque, ainsi que 2 exécuteurs par travail.
  + Pour le type de travail `G.1X`, chaque travail mappe vers 1 DPU (4 vCPU, 16 Go de mémoire et 64 Go de disque), et fournit 1 exécuteur par travail. Nous vous recommandons ce type d'employé pour les tâches utilisant beaucoup de mémoire.
  + Pour le type de travail `G.2X`, chaque travail mappe vers 2 DPU (8 vCPU, 32 Go de mémoire et 128 Go de disque), et fournit 1 exécuteur par travail. Nous vous recommandons ce type d'employé pour les tâches utilisant beaucoup de mémoire.

  Problème connu : lorsqu'un point de terminaison de développement est créé avec la configuration `G.2X` `WorkerType`, les pilotes Spark pour le point de terminaison de développement s'exécutent sur 4 vCPU, 16 Go de mémoire et un disque de 64 Go. 
+ `GlueVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  La version de Glue détermine les versions d'Apache Spark et Python prises AWS Glue en charge. La version Python indique la version prise en charge pour l'exécution de vos scripts ETL sur les points de terminaison de développement. 

  Pour plus d'informations sur les AWS Glue versions disponibles et les versions correspondantes de Spark et Python, consultez [la version de Glue](https://docs.aws.amazon.com/glue/latest/dg/add-job.html) dans le guide du développeur.

  Les points de terminaison de développement créés sans spécifier de version de Glue sont par défaut Glue 0.9.

  Vous pouvez spécifier une version du support Python pour les points de terminaison de développement en utilisant le `Arguments` paramètre dans le `CreateDevEndpoint` ou `UpdateDevEndpoint` APIs. Si aucun argument n'est fourni, la version utilisée par défaut est Python 2.
+ `NumberOfWorkers` : nombre (entier).

  Nombre de travaux d'un `workerType` défini qui sont alloués au point de terminaison de développement.

  Le nombre maximal de travaux que vous pouvez définir est de 299 pour `G.1X` et de 149 pour `G.2X`. 
+ `NumberOfNodes` : nombre (entier).

  Le nombre d'unités de traitement des AWS Glue données (DPUs) allouées à cela`DevEndpoint`.
+ `AvailabilityZone` – Chaîne UTF-8.

  La zone de AWS disponibilité dans laquelle `DevEndpoint` il se trouve.
+ `VpcId` – Chaîne UTF-8.

  ID du cloud privé virtuel (VPC) utilisé par ce `DevEndpoint`.
+ `ExtraPythonLibsS3Path` – Chaîne UTF-8.

  Chemin(s) d'accès à une ou plusieurs bibliothèques Python dans un compartiment Amazon S3 qui doit être chargé dans votre `DevEndpoint`. Plusieurs valeurs doivent être des chemins entiers séparés par une virgule.
**Note**  
Vous pouvez uniquement utiliser des bibliothèques Python pur avec un `DevEndpoint`. Les bibliothèques reposant sur des extensions C, par exemple la bibliothèque d'analyse des données Python [pandas](http://pandas.pydata.org/), ne sont actuellement pas prises en charge.
+ `ExtraJarsS3Path` – Chaîne UTF-8.

  Chemin d'accès à un ou plusieurs fichiers Java `.jar` dans un compartiment S3 qui doit être chargé dans votre `DevEndpoint`.
**Note**  
Vous ne pouvez utiliser que des Java/Scala bibliothèques pures avec un`DevEndpoint`.
+ `FailureReason` – Chaîne UTF-8.

  Raison d'un échec actuel dans ce `DevEndpoint`.
+ `LastUpdateStatus` – Chaîne UTF-8.

  Statut de la dernière mise à jour.
+ `CreatedTimestamp` – Horodatage.

  Le moment où cela DevEndpoint a été créé.
+ `LastModifiedTimestamp` – Horodatage.

  Moment auquel ce `DevEndpoint` a été modifié pour la dernière fois.
+ `PublicKey` – Chaîne UTF-8.

  Clé publique à utiliser par ce `DevEndpoint` pour l'authentification. Cet attribut est fourni à des fins de rétrocompatibilité, car l'attribut dont l'utilisation est recommandée sont les clés publiques.
+ `PublicKeys` – Tableau de chaînes UTF-8, avec 5 chaînes maximum.

  Liste de clés publiques à utiliser par le `DevEndpoints` pour authentification. L'utilisation de cet attribut est plus recommandé qu'une simple clé publique, car les clés publiques vous permettent d'avoir une clé privée différente pour chaque client.
**Note**  
Si vous avez déjà créé un point de terminaison avec une clé publique, vous devez supprimer cette clé pour être en mesure de définir une liste de clés publiques. Appelez l'opération d'API `UpdateDevEndpoint` avec le contenu de la clé publique dans l'attribut `deletePublicKeys` et la liste des nouvelles clés dans l'attribut `addPublicKeys`.
+ `SecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la structure `SecurityConfiguration` à utiliser avec ce `DevEndpoint`.
+ `Arguments` – tableau de mappage de paires clé-valeur, avec 100 paires au maximum.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Mappage des arguments utilisés pour configurer le `DevEndpoint`.

  Les arguments valides sont les suivants :
  + `"--enable-glue-datacatalog": ""`

  Vous pouvez spécifier une version du support Python pour les points de terminaison de développement en utilisant le `Arguments` paramètre dans le `CreateDevEndpoint` ou `UpdateDevEndpoint` APIs. Si aucun argument n'est fourni, la version utilisée par défaut est Python 2.

## DevEndpointCustomLibraries structure
<a name="aws-glue-api-dev-endpoint-DevEndpointCustomLibraries"></a>

Bibliothèques personnalisées à charger dans un point de terminaison de développement.

**Champs**
+ `ExtraPythonLibsS3Path` – Chaîne UTF-8.

  Chemins d'accès à une ou plusieurs bibliothèques Python dans un compartiment Amazon Simple Storage Service (Amazon S3) qui doivent être chargées dans votre `DevEndpoint`. Plusieurs valeurs doivent être des chemins entiers séparés par une virgule.
**Note**  
Vous pouvez uniquement utiliser des bibliothèques Python pur avec un `DevEndpoint`. Les bibliothèques reposant sur des extensions C, par exemple la bibliothèque d'analyse des données Python [pandas](http://pandas.pydata.org/), ne sont actuellement pas prises en charge.
+ `ExtraJarsS3Path` – Chaîne UTF-8.

  Chemin d'accès à un ou plusieurs fichiers Java `.jar` dans un compartiment S3 qui doit être chargé dans votre `DevEndpoint`.
**Note**  
Vous ne pouvez utiliser que des Java/Scala bibliothèques pures avec un`DevEndpoint`.

## Opérations
<a name="aws-glue-api-dev-endpoint-actions"></a>
+ [CreateDevEndpoint action (Python : create\$1dev\$1endpoint)](#aws-glue-api-dev-endpoint-CreateDevEndpoint)
+ [UpdateDevEndpoint action (Python : update\$1dev\$1endpoint)](#aws-glue-api-dev-endpoint-UpdateDevEndpoint)
+ [DeleteDevEndpoint action (Python : delete\$1dev\$1endpoint)](#aws-glue-api-dev-endpoint-DeleteDevEndpoint)
+ [GetDevEndpoint action (Python : get\$1dev\$1endpoint)](#aws-glue-api-dev-endpoint-GetDevEndpoint)
+ [GetDevEndpoints action (Python : get\$1dev\$1endpoints)](#aws-glue-api-dev-endpoint-GetDevEndpoints)
+ [BatchGetDevEndpoints action (Python : batch\$1get\$1dev\$1endpoints)](#aws-glue-api-dev-endpoint-BatchGetDevEndpoints)
+ [ListDevEndpoints action (Python : list\$1dev\$1endpoints)](#aws-glue-api-dev-endpoint-ListDevEndpoints)

## CreateDevEndpoint action (Python : create\$1dev\$1endpoint)
<a name="aws-glue-api-dev-endpoint-CreateDevEndpoint"></a>

Crée un nouveau point de terminaison de développement.

**Demande**
+ `EndpointName` – *Obligatoire :* chaîne UTF-8.

  Nom à affecter au nouveau `DevEndpoint`.
+ `RoleArn` – *Obligatoire :* Chaîne UTF-8, correspondant au [AWS IAM ARN string pattern](aws-glue-api-common.md#aws-glue-api-regex-aws-iam-arn-id).

  Rôle IAM pour le `DevEndpoint`.
+ `SecurityGroupIds` – Tableau de chaînes UTF-8.

  Groupe de sécurité IDs pour les groupes de sécurité à utiliser par le nouveau`DevEndpoint`.
+ `SubnetId` – Chaîne UTF-8.

  ID de sous-réseau pour le nouveau `DevEndpoint` à utiliser.
+ `PublicKey` – Chaîne UTF-8.

  Clé publique à utiliser par ce `DevEndpoint` pour l'authentification. Cet attribut est fourni à des fins de rétrocompatibilité, car l'attribut dont l'utilisation est recommandée sont les clés publiques.
+ `PublicKeys` – Tableau de chaînes UTF-8, avec 5 chaînes maximum.

  Liste de clés publiques à utiliser par les points de terminaison de développement pour authentification. L'utilisation de cet attribut est plus recommandé qu'une simple clé publique, car les clés publiques vous permettent d'avoir une clé privée différente pour chaque client.
**Note**  
Si vous avez déjà créé un point de terminaison avec une clé publique, vous devez supprimer cette clé pour être en mesure de définir une liste de clés publiques. Appelez l'API `UpdateDevEndpoint` avec le contenu de la clé publique dans l'attribut `deletePublicKeys` et la liste des nouvelles clés dans l'attribut `addPublicKeys`.
+ `NumberOfNodes` : nombre (entier).

  Le nombre d'unités de traitement des AWS Glue données (DPUs) à y affecter`DevEndpoint`.
+ `WorkerType` – Chaîne UTF-8 (valeurs valides: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  Type de travail prédéfini qui est alloué au point de terminaison de développement. Accepte la valeur Standard, G.1X ou G.2X.
  + Pour le type de travail `Standard`, chaque travail fournit 4 vCPU, 16 Go de mémoire et 50 Go de disque, ainsi que 2 exécuteurs par travail.
  + Pour le type de travail `G.1X`, chaque travail mappe vers 1 DPU (4 vCPU, 16 Go de mémoire et 64 Go de disque), et fournit 1 exécuteur par travail. Nous vous recommandons ce type d'employé pour les tâches utilisant beaucoup de mémoire.
  + Pour le type de travail `G.2X`, chaque travail mappe vers 2 DPU (8 vCPU, 32 Go de mémoire et 128 Go de disque), et fournit 1 exécuteur par travail. Nous vous recommandons ce type d'employé pour les tâches utilisant beaucoup de mémoire.

  Problème connu : lorsqu'un point de terminaison de développement est créé avec la configuration `G.2X` `WorkerType`, les pilotes Spark pour le point de terminaison de développement s'exécutent sur 4 vCPU, 16 Go de mémoire et un disque de 64 Go. 
+ `GlueVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  La version de Glue détermine les versions d'Apache Spark et Python prises AWS Glue en charge. La version Python indique la version prise en charge pour l'exécution de vos scripts ETL sur les points de terminaison de développement. 

  Pour plus d'informations sur les AWS Glue versions disponibles et les versions correspondantes de Spark et Python, consultez [la version de Glue](https://docs.aws.amazon.com/glue/latest/dg/add-job.html) dans le guide du développeur.

  Les points de terminaison de développement créés sans spécifier de version de Glue sont par défaut Glue 0.9.

  Vous pouvez spécifier une version du support Python pour les points de terminaison de développement en utilisant le `Arguments` paramètre dans le `CreateDevEndpoint` ou `UpdateDevEndpoint` APIs. Si aucun argument n'est fourni, la version utilisée par défaut est Python 2.
+ `NumberOfWorkers` : nombre (entier).

  Nombre de travaux d'un `workerType` défini qui sont alloués au point de terminaison de développement.

  Le nombre maximal de travaux que vous pouvez définir est de 299 pour `G.1X` et de 149 pour `G.2X`. 
+ `ExtraPythonLibsS3Path` – Chaîne UTF-8.

  Chemin(s) d'accès à une ou plusieurs bibliothèques Python dans un compartiment Amazon S3 qui doit être chargé dans votre `DevEndpoint`. Plusieurs valeurs doivent être des chemins entiers séparés par une virgule.
**Note**  
Vous pouvez uniquement utiliser des bibliothèques Python pur avec un `DevEndpoint`. Les bibliothèques reposant sur des extensions C, par exemple la bibliothèque d'analyse des données Python [pandas](http://pandas.pydata.org/), ne sont pas encore prises en charge.
+ `ExtraJarsS3Path` – Chaîne UTF-8.

  Chemin d'accès à un ou plusieurs fichiers Java `.jar` dans un compartiment S3 qui doit être chargé dans votre `DevEndpoint`.
+ `SecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la structure `SecurityConfiguration` à utiliser avec ce `DevEndpoint`.
+ `Tags` – tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Balises à utiliser avec ce DevEndpoint. Vous pouvez utiliser des balises pour limiter l'accès au DevEndpoint. Pour plus d'informations sur les tags in AWS Glue, voir [AWS Tags in AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html) dans le guide du développeur.
+ `Arguments` – tableau de mappage de paires clé-valeur, avec 100 paires au maximum.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Mappage des arguments utilisés pour configurer le `DevEndpoint`.

**Réponse**
+ `EndpointName` – Chaîne UTF-8.

  Nom attribué au nouveau `DevEndpoint`.
+ `Status` – Chaîne UTF-8.

  Statut actuel du nouveau `DevEndpoint`.
+ `SecurityGroupIds` – Tableau de chaînes UTF-8.

  Groupes de sécurité affectés au nouveau `DevEndpoint`.
+ `SubnetId` – Chaîne UTF-8.

  ID de sous-réseau affecté au nouveau `DevEndpoint`.
+ `RoleArn` – Chaîne UTF-8, correspondant au [AWS IAM ARN string pattern](aws-glue-api-common.md#aws-glue-api-regex-aws-iam-arn-id).

  Amazon Resource Name (ARN) du rôle affecté au nouveau `DevEndpoint`.
+ `YarnEndpointAddress` – Chaîne UTF-8.

  Adresse du point de terminaison YARN utilisé par ce `DevEndpoint`.
+ `ZeppelinRemoteSparkInterpreterPort` : nombre (entier).

  Port Apache Zeppelin pour l'interpréteur Apache Spark à distance.
+ `NumberOfNodes` : nombre (entier).

  Le nombre d'unités de traitement des AWS Glue données (DPUs) allouées à cela DevEndpoint.
+ `WorkerType` – Chaîne UTF-8 (valeurs valides: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  Type de travail prédéfini qui est alloué au point de terminaison de développement. La valeur peut être Standard, G.1X ou G.2X.
+ `GlueVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  La version de Glue détermine les versions d'Apache Spark et Python prises AWS Glue en charge. La version Python indique la version prise en charge pour l'exécution de vos scripts ETL sur les points de terminaison de développement. 

  Pour plus d'informations sur les AWS Glue versions disponibles et les versions correspondantes de Spark et Python, consultez [la version de Glue](https://docs.aws.amazon.com/glue/latest/dg/add-job.html) dans le guide du développeur.
+ `NumberOfWorkers` : nombre (entier).

  Nombre de travaux d'un `workerType` défini qui sont alloués au point de terminaison de développement.
+ `AvailabilityZone` – Chaîne UTF-8.

  La zone de AWS disponibilité dans laquelle `DevEndpoint` il se trouve.
+ `VpcId` – Chaîne UTF-8.

  ID du cloud privé virtuel (VPC) utilisé par ce `DevEndpoint`.
+ `ExtraPythonLibsS3Path` – Chaîne UTF-8.

  Chemin(s) d'accès à une ou plusieurs bibliothèques Python dans un compartiment S3 qui sera chargé dans votre `DevEndpoint`.
+ `ExtraJarsS3Path` – Chaîne UTF-8.

  Chemi(s)n d'accès à un ou plusieurs fichiers Java `.jar` dans un compartiment S3 qui sera chargé dans votre `DevEndpoint`.
+ `FailureReason` – Chaîne UTF-8.

  Raison d'un échec actuel dans ce `DevEndpoint`.
+ `SecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la structure `SecurityConfiguration` utilisée avec ce `DevEndpoint`.
+ `CreatedTimestamp` – Horodatage.

  Moment où ce `DevEndpoint` a été créé.
+ `Arguments` – tableau de mappage de paires clé-valeur, avec 100 paires au maximum.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Mappage des arguments utilisés pour configurer ce `DevEndpoint`.

  Les arguments valides sont les suivants :
  + `"--enable-glue-datacatalog": ""`

  Vous pouvez spécifier une version du support Python pour les points de terminaison de développement en utilisant le `Arguments` paramètre dans le `CreateDevEndpoint` ou `UpdateDevEndpoint` APIs. Si aucun argument n'est fourni, la version utilisée par défaut est Python 2.

**Erreurs**
+ `AccessDeniedException`
+ `AlreadyExistsException`
+ `IdempotentParameterMismatchException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `ValidationException`
+ `ResourceNumberLimitExceededException`

## UpdateDevEndpoint action (Python : update\$1dev\$1endpoint)
<a name="aws-glue-api-dev-endpoint-UpdateDevEndpoint"></a>

Met à jour un point de terminaison de développement spécifié.

**Demande**
+ `EndpointName` – *Obligatoire :* chaîne UTF-8.

  Nom du `DevEndpoint` à mettre à jour.
+ `PublicKey` – Chaîne UTF-8.

  Clé publique pour le `DevEndpoint` à utiliser.
+ `AddPublicKeys` – Tableau de chaînes UTF-8, avec 5 chaînes maximum.

  Liste des clés publiques pour le `DevEndpoint` à utiliser.
+ `DeletePublicKeys` – Tableau de chaînes UTF-8, avec 5 chaînes maximum.

  Liste de clés publiques à supprimer du `DevEndpoint`.
+ `CustomLibraries` – Un objet [DevEndpointCustomLibraries](#aws-glue-api-dev-endpoint-DevEndpointCustomLibraries).

  Bibliothèques Python ou Java personnalisées à charger dans le `DevEndpoint`.
+ `UpdateEtlLibraries` : booléen.

  `True` si la liste des bibliothèques personnalisées à charger dans le point de terminaison de développement doit être mise à jour, sinon `False`.
+ `DeleteArguments` – Tableau de chaînes UTF-8.

  Liste des clés d'argument à supprimer du mappage d'arguments utilisé pour configurer le `DevEndpoint`.
+ `AddArguments` – tableau de mappage de paires clé-valeur, avec 100 paires au maximum.

  Chaque clé est une chaîne UTF-8.

  Chaque valeur est une chaîne UTF-8.

  Mappage d'arguments à ajouter au mappage d'arguments utilisé pour configurer le `DevEndpoint`.

  Les arguments valides sont les suivants :
  + `"--enable-glue-datacatalog": ""`

  Vous pouvez spécifier une version du support Python pour les points de terminaison de développement en utilisant le `Arguments` paramètre dans le `CreateDevEndpoint` ou `UpdateDevEndpoint` APIs. Si aucun argument n'est fourni, la version utilisée par défaut est Python 2.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `ValidationException`

## DeleteDevEndpoint action (Python : delete\$1dev\$1endpoint)
<a name="aws-glue-api-dev-endpoint-DeleteDevEndpoint"></a>

Supprime un point de terminaison de développement spécifié.

**Demande**
+ `EndpointName` – *Obligatoire :* chaîne UTF-8.

  Le nom de l'`DevEndpoint`.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`

## GetDevEndpoint action (Python : get\$1dev\$1endpoint)
<a name="aws-glue-api-dev-endpoint-GetDevEndpoint"></a>

Récupère des informations sur un point de terminaison de développement spécifié.

**Note**  
Lorsque vous créez un point de terminaison de développement dans un cloud privé virtuel (VPC), AWS Glue renvoie uniquement une adresse IP privée et le champ de l'adresse IP publique n'est pas renseigné. Lorsque vous créez un point de terminaison de développement non VPC, il AWS Glue renvoie uniquement une adresse IP publique.

**Demande**
+ `EndpointName` – *Obligatoire :* chaîne UTF-8.

  Nom du `DevEndpoint` pour lequel des informations seront récupérées.

**Réponse**
+ `DevEndpoint` – Un objet [DevEndpoint](#aws-glue-api-dev-endpoint-DevEndpoint).

  Définition d'un `DevEndpoint`.

**Erreurs**
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`

## GetDevEndpoints action (Python : get\$1dev\$1endpoints)
<a name="aws-glue-api-dev-endpoint-GetDevEndpoints"></a>

Récupère tous les points de terminaison de développement de ce AWS compte.

**Note**  
Lorsque vous créez un point de terminaison de développement dans un Virtual Private Cloud (VPC), AWS Glue renvoie uniquement une adresse IP privée et le champ de l'adresse IP publique n'est pas renseigné. Lorsque vous créez un point de terminaison de développement non VPC, il AWS Glue renvoie uniquement une adresse IP publique.

**Demande**
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Taille maximale des informations à renvoyer.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.

**Réponse**
+ `DevEndpoints` : un tableau d’objets [DevEndpoint](#aws-glue-api-dev-endpoint-DevEndpoint).

  Liste des définitions de `DevEndpoint`.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, si toutes les définitions de `DevEndpoint` n'ont pas encore été renvoyées.

**Erreurs**
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`

## BatchGetDevEndpoints action (Python : batch\$1get\$1dev\$1endpoints)
<a name="aws-glue-api-dev-endpoint-BatchGetDevEndpoints"></a>

Renvoie une liste des métadonnées de ressource pour une liste donnée de noms de point de terminaison de développement. Après avoir appelé l’opération `ListDevEndpoints`, vous pouvez appeler cette opération pour accéder aux données sur lesquelles des autorisations vous ont été octroyées. Cette opération prend en charge toutes les autorisations IAM, y compris les conditions d’autorisation qui utilisent des balises.

**Demande**
+ `customerAccountId` – Chaîne UTF-8.

  L'identifiant AWS du compte.
+ `DevEndpointNames` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 25 chaînes maximum.

  Liste de noms de `DevEndpoint`, qui peuvent être les noms renvoyés à partir de l'opération `ListDevEndpoint`.

**Réponse**
+ `DevEndpoints` : un tableau d’objets [DevEndpoint](#aws-glue-api-dev-endpoint-DevEndpoint).

  Liste des définitions de `DevEndpoint`.
+ `DevEndpointsNotFound` – tableau de chaînes UTF-8, avec 1 chaîne minimum et 25 chaînes maximum.

  Liste des `DevEndpoints` introuvables.

**Erreurs**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`

## ListDevEndpoints action (Python : list\$1dev\$1endpoints)
<a name="aws-glue-api-dev-endpoint-ListDevEndpoints"></a>

Récupère les noms de toutes les ressources `DevEndpoint` dans ce compte AWS , ou les ressources avec la balise spécifiée. Cette opération vous permet de voir quelles ressources sont disponibles dans votre compte, et leurs noms.

Cette opération accepte le champ `Tags` facultatif que vous pouvez utiliser comme filtre sur la réponse, afin que les ressources balisées puissent être récupérées en tant que groupe. Si vous choisissez d'utiliser le filtrage des balises, seules les ressources avec la balise sont récupérées.

**Demande**
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’une requête de continuation.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  La taille maximale d’une liste à renvoyer.
+ `Tags` – tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Spécifie de renvoyer uniquement les ressources balisées.

**Réponse**
+ `DevEndpointNames` – Tableau de chaînes UTF-8.

  Noms de tous les `DevEndpoint` dans le compte ou les `DevEndpoint` avec les balises spécifiées.
+ `NextToken` – Chaîne UTF-8.

  Jeton continuation, si la liste renvoyée ne contient pas la dernière métrique disponible.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

# Registre de schémas
<a name="aws-glue-api-schema-registry-api"></a>

L'API de registre des schémas décrit les types de données et l'API liés à l'utilisation des schémas dans AWS Glue.

## Types de données
<a name="aws-glue-api-schema-registry-api-objects"></a>
+ [RegistryId structure](#aws-glue-api-schema-registry-api-RegistryId)
+ [RegistryListItem structure](#aws-glue-api-schema-registry-api-RegistryListItem)
+ [MetadataInfo structure](#aws-glue-api-schema-registry-api-MetadataInfo)
+ [OtherMetadataValueListItem structure](#aws-glue-api-schema-registry-api-OtherMetadataValueListItem)
+ [SchemaListItem structure](#aws-glue-api-schema-registry-api-SchemaListItem)
+ [SchemaVersionListItem structure](#aws-glue-api-schema-registry-api-SchemaVersionListItem)
+ [MetadataKeyValuePair structure](#aws-glue-api-schema-registry-api-MetadataKeyValuePair)
+ [SchemaVersionErrorItem structure](#aws-glue-api-schema-registry-api-SchemaVersionErrorItem)
+ [ErrorDetails structure](#aws-glue-api-schema-registry-api-ErrorDetails)
+ [SchemaVersionNumber structure](#aws-glue-api-schema-registry-api-SchemaVersionNumber)
+ [SchemaId structure](#aws-glue-api-schema-registry-api-SchemaId)

## RegistryId structure
<a name="aws-glue-api-schema-registry-api-RegistryId"></a>

Structure d'encapsulation qui peut contenir le nom et l'Amazon Resource Name (ARN) du registre.

**Champs**
+ `RegistryName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du registre. Utilisé uniquement pour la recherche. `RegistryArn` ou `RegistryName` doit être fourni. 
+ `RegistryArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  ARN du registre à mettre à jour. `RegistryArn` ou `RegistryName` doit être fourni.

## RegistryListItem structure
<a name="aws-glue-api-schema-registry-api-RegistryListItem"></a>

Une structure contenant les détails d'un registre.

**Champs**
+ `RegistryName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du registre.
+ `RegistryArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  L'Amazon Resource Name (ARN) du registre.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description du registre.
+ `Status` – Chaîne UTF-8 (valeurs valides : `AVAILABLE` \$1 `DELETING`).

  Statut du registre.
+ `CreatedTime` – Chaîne UTF-8.

  Données que le registre a été créé.
+ `UpdatedTime` – Chaîne UTF-8.

  Date à laquelle le registre a été mis à jour.

## MetadataInfo structure
<a name="aws-glue-api-schema-registry-api-MetadataInfo"></a>

Structure contenant des informations de métadonnées pour une version de schéma.

**Champs**
+ `MetadataValue` – Chaîne UTF-8, d'une longueur comprise entre 1 et 256 octets, correspondant au [Custom string pattern #14](aws-glue-api-common.md#regex_14).

  Valeur correspondant à une clé de métadonnées.
+ `CreatedTime` – Chaîne UTF-8.

  Heure à laquelle l'entrée a été créée.
+ `OtherMetadataValueList` : un tableau d’objets [OtherMetadataValueListItem](#aws-glue-api-schema-registry-api-OtherMetadataValueListItem).

  Autres métadonnées appartenant à la même clé de métadonnées.

## OtherMetadataValueListItem structure
<a name="aws-glue-api-schema-registry-api-OtherMetadataValueListItem"></a>

Structure contenant d'autres métadonnées pour une version de schéma appartenant à la même clé de métadonnées.

**Champs**
+ `MetadataValue` – Chaîne UTF-8, d'une longueur comprise entre 1 et 256 octets, correspondant au [Custom string pattern #14](aws-glue-api-common.md#regex_14).

  Valeur correspondante de la clé de métadonnées pour les autres métadonnées appartenant à la même clé de métadonnées.
+ `CreatedTime` – Chaîne UTF-8.

  Heure à laquelle l'entrée a été créée.

## SchemaListItem structure
<a name="aws-glue-api-schema-registry-api-SchemaListItem"></a>

Objet qui contient des détails minimaux pour un schéma.

**Champs**
+ `RegistryName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du registre dans lequel se trouve le schéma.
+ `SchemaName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du schéma.
+ `SchemaArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  Amazon Resource Name (ARN) du schéma.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description du schéma.
+ `SchemaStatus` – Chaîne UTF-8 (valeurs valides : `AVAILABLE` \$1 `PENDING` \$1 `DELETING`).

  Statut du schéma.
+ `CreatedTime` – Chaîne UTF-8.

  Date et heure de création d'un schéma.
+ `UpdatedTime` – Chaîne UTF-8.

  Date et heure de mise à jour d'un schéma.

## SchemaVersionListItem structure
<a name="aws-glue-api-schema-registry-api-SchemaVersionListItem"></a>

Objet contenant les détails d'une version de schéma.

**Champs**
+ `SchemaArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  L'Amazon Resource Name (ARN) du filtre.
+ `SchemaVersionId` – Chaîne UTF-8, d'une longueur exacte de 36 octets, correspondant au [Custom string pattern #45](aws-glue-api-common.md#regex_45).

  Identifiant unique de la version du schéma.
+ `VersionNumber` – Nombre (long), compris entre 1 et 100 000.

  Numéro de version du schéma.
+ `Status` – Chaîne UTF-8 (valeurs valides : `AVAILABLE` \$1 `PENDING` \$1 `FAILURE` \$1 `DELETING`).

  Statut de la version du schéma.
+ `CreatedTime` – Chaîne UTF-8.

  Date et heure de création à laquelle la version de schéma a été créée.

## MetadataKeyValuePair structure
<a name="aws-glue-api-schema-registry-api-MetadataKeyValuePair"></a>

Structure contenant une paire de valeurs clé pour les métadonnées.

**Champs**
+ `MetadataKey` – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #14](aws-glue-api-common.md#regex_14).

  Clé de métadonnées.
+ `MetadataValue` – Chaîne UTF-8, d'une longueur comprise entre 1 et 256 octets, correspondant au [Custom string pattern #14](aws-glue-api-common.md#regex_14).

  Valeur correspondant à une clé de métadonnées.

## SchemaVersionErrorItem structure
<a name="aws-glue-api-schema-registry-api-SchemaVersionErrorItem"></a>

Objet contenant les détails d'erreur d'une opération sur une version de schéma.

**Champs**
+ `VersionNumber` – Nombre (long), compris entre 1 et 100 000.

  Numéro de version du schéma.
+ `ErrorDetails` – Un objet [ErrorDetails](#aws-glue-api-schema-registry-api-ErrorDetails).

  Détails de l'erreur pour la version du schéma.

## ErrorDetails structure
<a name="aws-glue-api-schema-registry-api-ErrorDetails"></a>

Objet contenant des détails d'erreur.

**Champs**
+ `ErrorCode` – Chaîne UTF-8.

  Code d'erreur correspondant à une erreur.
+ `ErrorMessage` – Chaîne UTF-8.

  Message d'erreur pour une erreur.

## SchemaVersionNumber structure
<a name="aws-glue-api-schema-registry-api-SchemaVersionNumber"></a>

Structure contenant les informations de version du schéma.

**Champs**
+ `LatestVersion` : booléen.

  Dernière version disponible pour le schéma.
+ `VersionNumber` – Nombre (long), compris entre 1 et 100 000.

  Numéro de version du schéma.

## SchemaId structure
<a name="aws-glue-api-schema-registry-api-SchemaId"></a>

ID unique du schéma dans le registre des AWS Glue schémas.

**Champs**
+ `SchemaArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  L'Amazon Resource Name (ARN) du filtre. `SchemaArn` ou `SchemaName` doit être fourni.
+ `SchemaName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du schéma. `SchemaArn` ou `SchemaName` doit être fourni.
+ `RegistryName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du registre de schémas contenant le schéma.

## Opérations
<a name="aws-glue-api-schema-registry-api-actions"></a>
+ [CreateRegistry action (Python : create\$1registry)](#aws-glue-api-schema-registry-api-CreateRegistry)
+ [CreateSchema action (Python : créer\$1schéma)](#aws-glue-api-schema-registry-api-CreateSchema)
+ [GetSchema action (Python : get\$1schema)](#aws-glue-api-schema-registry-api-GetSchema)
+ [ListSchemaVersions action (Python : list\$1schema\$1versions)](#aws-glue-api-schema-registry-api-ListSchemaVersions)
+ [GetSchemaVersion action (Python : get\$1schema\$1version)](#aws-glue-api-schema-registry-api-GetSchemaVersion)
+ [GetSchemaVersionsDiff action (Python : get\$1schema\$1versions\$1diff)](#aws-glue-api-schema-registry-api-GetSchemaVersionsDiff)
+ [ListRegistries action (Python : list\$1registries)](#aws-glue-api-schema-registry-api-ListRegistries)
+ [ListSchemas action (Python : list\$1schemas)](#aws-glue-api-schema-registry-api-ListSchemas)
+ [RegisterSchemaVersion action (Python : register\$1schema\$1version)](#aws-glue-api-schema-registry-api-RegisterSchemaVersion)
+ [UpdateSchema action (Python : update\$1schema)](#aws-glue-api-schema-registry-api-UpdateSchema)
+ [CheckSchemaVersionValidity action (Python : check\$1schema\$1version\$1validity)](#aws-glue-api-schema-registry-api-CheckSchemaVersionValidity)
+ [UpdateRegistry action (Python : update\$1registry)](#aws-glue-api-schema-registry-api-UpdateRegistry)
+ [GetSchemaByDefinition action (Python : get\$1schema\$1by\$1definition)](#aws-glue-api-schema-registry-api-GetSchemaByDefinition)
+ [GetRegistry action (Python : get\$1registry)](#aws-glue-api-schema-registry-api-GetRegistry)
+ [PutSchemaVersionMetadata action (Python : put\$1schema\$1version\$1metadata)](#aws-glue-api-schema-registry-api-PutSchemaVersionMetadata)
+ [QuerySchemaVersionMetadata action (Python : query\$1schema\$1version\$1metadata)](#aws-glue-api-schema-registry-api-QuerySchemaVersionMetadata)
+ [RemoveSchemaVersionMetadata action (Python : remove\$1schema\$1version\$1metadata)](#aws-glue-api-schema-registry-api-RemoveSchemaVersionMetadata)
+ [DeleteRegistry action (Python : supprimer\$1registre)](#aws-glue-api-schema-registry-api-DeleteRegistry)
+ [DeleteSchema action (Python : supprimer\$1schéma)](#aws-glue-api-schema-registry-api-DeleteSchema)
+ [DeleteSchemaVersions action (Python : delete\$1schema\$1versions)](#aws-glue-api-schema-registry-api-DeleteSchemaVersions)

## CreateRegistry action (Python : create\$1registry)
<a name="aws-glue-api-schema-registry-api-CreateRegistry"></a>

Crée un registre qui peut être utilisé pour contenir une collection de schémas.

**Demande**
+ `RegistryName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du registre à créer, d'une longueur maximale de 255, et ne pouvant contenir que des lettres, des chiffres, trait d'union, trait de soulignement, symbole dollar ou dièse. Pas d'espace.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description du registre. Si la description n'est pas fournie, aucune valeur par défaut ne sera attribuée.
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  AWS balises contenant une paire clé-valeur et pouvant être recherchées par console, ligne de commande ou API.

**Réponse**
+ `RegistryArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  Amazon Resource Name (ARN) du registre nouvellement créé.
+ `RegistryName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du registre.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description du registre.
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Balises pour le registre.

**Erreurs**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
+ `InternalServiceException`

## CreateSchema action (Python : créer\$1schéma)
<a name="aws-glue-api-schema-registry-api-CreateSchema"></a>

Crée un jeu de schémas et enregistre la définition de schéma. Renvoie une erreur si le jeu de schémas existe déjà sans pour autant enregistrer la version.

Lorsque le jeu de schémas est créé, un point de contrôle de version est défini sur la première version. Le mode de compatibilité « DISABLED » empêche toute version de schéma supplémentaire d'être ajoutée après la première version de schéma. Pour tous les autres modes de compatibilité, la validation des paramètres de compatibilité ne sera appliquée qu'à partir de la deuxième version lorsque l'API `RegisterSchemaVersion` est utilisée.

Lorsque cette API est appelée sans `RegistryId`, cela créera une entrée pour un « registre par défaut » dans les tables de base de données du registre, si elle n'est pas déjà présente.

**Demande**
+ `RegistryId` – Un objet [RegistryId](#aws-glue-api-schema-registry-api-RegistryId).

   Il s'agit d'une forme d'encapsulation qui contient les champs d'identité du registre. S'il n'est pas fourni, le registre par défaut sera utilisé. Le format ARN pour celui-ci sera : `arn:aws:glue:us-east-2:<customer id>:registry/default-registry:random-5-letter-id`.
+ `SchemaName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du schéma à créer d'une longueur maximale de 255. Il ne peut contenir que des lettres, chiffres, tirets, traits de soulignement, signes dollar ou signes de hachage. Pas d'espace.
+ `DataFormat` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `AVRO` \$1 `JSON` \$1 `PROTOBUF`).

  Format de données de la définition de schéma. À l'heure actuelle, `AVRO`, `JSON` et `PROTOBUF` sont pris en charge.
+ `Compatibility` – Chaîne UTF-8 (valeurs valides : `NONE` \$1 `DISABLED` \$1 `BACKWARD` \$1 `BACKWARD_ALL` \$1 `FORWARD` \$1 `FORWARD_ALL` \$1 `FULL` \$1 `FULL_ALL`).

  Mode de compatibilité du schéma. Les valeurs possibles sont :
  +  *NONE (AUCUN)* : aucun mode de compatibilité ne s'applique. Vous pouvez utiliser ce choix dans les scénarios de développement ou si vous ne connaissez pas le mode de compatibilité que vous souhaitez appliquer aux schémas. Toute nouvelle version ajoutée sera acceptée sans faire l'objet d'un contrôle de compatibilité.
  +  *DISABLED (DÉSACTIVÉ)* : ce choix de compatibilité empêche la gestion des versions pour un schéma particulier. Vous pouvez utiliser ce choix pour empêcher la gestion des versions futures d'un schéma.
  +  *BACKWARD (DESCENDANT)* : ce choix de compatibilité est recommandé, car il permet aux récepteurs de données de lire à la fois la version actuelle et une version antérieure du schéma. Cela signifie, par exemple, qu'une nouvelle version de schéma ne peut pas supprimer des champs de données ou modifier le type de ces champs, de sorte qu'ils ne peuvent pas être lus par les lecteurs utilisant la version précédente.
  +  *BACKWARD\$1ALL (DESCENDANT\$1TOUT)* : ce choix de compatibilité permet aux récepteurs de données de lire à la fois la version actuelle et toutes les versions antérieures du schéma. Vous pouvez utiliser ce choix lorsque vous devez supprimer des champs ou ajouter des champs facultatifs, et vérifier la compatibilité avec toutes les versions de schéma précédentes. 
  +  *ASCENDANT* : ce choix de compatibilité permet aux récepteurs de données de lire à la fois la version actuelle et la version suivante du schéma, mais pas nécessairement les versions ultérieures. Vous pouvez utiliser ce choix lorsque vous devez ajouter des champs ou supprimer des champs facultatifs, mais uniquement vérifier la compatibilité avec la dernière version du schéma.
  +  *ASCENDANT\$1TOUT* : ce choix de compatibilité permet aux récepteurs de données de lire les données écrites par les producteurs de tout nouveau schéma enregistré. Vous pouvez utiliser ce choix lorsque vous devez ajouter des champs ou supprimer des champs facultatifs, et vérifier la compatibilité avec toutes les versions de schéma précédentes.
  +  *COMPLET* : ce choix de compatibilité permet aux récepteurs de données de lire les données écrites par les producteurs à l'aide de la version précédente ou suivante du schéma, mais pas nécessairement des versions antérieures ou ultérieures. Vous pouvez utiliser ce choix lorsque vous devez ajouter ou supprimer des champs facultatifs, mais uniquement vérifier la compatibilité par rapport à la dernière version du schéma.
  +  *COMPLET\$1TOUT* : ce choix de compatibilité permet aux récepteurs de données de lire les données écrites par les producteurs utilisant toutes les versions de schéma précédentes. Vous pouvez utiliser ce choix lorsque vous devez ajouter ou supprimer des champs facultatifs et vérifier la compatibilité avec toutes les versions de schéma précédentes.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description facultative du schéma. Si la description n'est pas fournie, aucune valeur par défaut ne sera attribuée automatiquement.
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  AWS balises contenant une paire clé-valeur et pouvant être recherchées par console, ligne de commande ou API. Si spécifié, suit le AWS tags-on-create modèle.
+ `SchemaDefinition` – Chaîne UTF-8, d'une longueur comprise entre 1 et 170 000 octets, correspondant au [Custom string pattern #13](aws-glue-api-common.md#regex_13).

  Définition de schéma à l'aide du paramètre `DataFormat` pour `SchemaName`.

**Réponse**
+ `RegistryName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du registre.
+ `RegistryArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  L'Amazon Resource Name (ARN) du registre.
+ `SchemaName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du schéma.
+ `SchemaArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  L'Amazon Resource Name (ARN) du filtre.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description du schéma si spécifié lors de sa création.
+ `DataFormat` – Chaîne UTF-8 (valeurs valides : `AVRO` \$1 `JSON` \$1 `PROTOBUF`).

  Format de données de la définition de schéma. À l'heure actuelle, `AVRO`, `JSON` et `PROTOBUF` sont pris en charge.
+ `Compatibility` – Chaîne UTF-8 (valeurs valides : `NONE` \$1 `DISABLED` \$1 `BACKWARD` \$1 `BACKWARD_ALL` \$1 `FORWARD` \$1 `FORWARD_ALL` \$1 `FULL` \$1 `FULL_ALL`).

  Mode de compatibilité du schéma.
+ `SchemaCheckpoint` – Nombre (long), compris entre 1 et 100 000.

  Numéro de version du point de contrôle (la dernière fois que le mode de compatibilité a été modifié).
+ `LatestSchemaVersion` – Nombre (long), compris entre 1 et 100 000.

  Version la plus récente du schéma associé à la définition de schéma renvoyée.
+ `NextSchemaVersion` – Nombre (long), compris entre 1 et 100 000.

  Version suivante du schéma associé à la définition de schéma renvoyée.
+ `SchemaStatus` – Chaîne UTF-8 (valeurs valides : `AVAILABLE` \$1 `PENDING` \$1 `DELETING`).

  Statut du schéma. 
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Balises pour le schéma.
+ `SchemaVersionId` – Chaîne UTF-8, d'une longueur exacte de 36 octets, correspondant au [Custom string pattern #45](aws-glue-api-common.md#regex_45).

  Identifiant unique de la première version du schéma.
+ `SchemaVersionStatus` – Chaîne UTF-8 (valeurs valides : `AVAILABLE` \$1 `PENDING` \$1 `FAILURE` \$1 `DELETING`).

  Statut de la première version du schéma créée.

**Erreurs**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
+ `InternalServiceException`

## GetSchema action (Python : get\$1schema)
<a name="aws-glue-api-schema-registry-api-GetSchema"></a>

Décrit en détail le schéma spécifié.

**Demande**
+ `SchemaId` – *Obligatoire :* un objet [SchemaId](#aws-glue-api-schema-registry-api-SchemaId).

  Structure d'encapsulation contenant les champs d'identité de schéma. La structure contient :
  + SchemaId\$1 SchemaArn : Le nom de ressource Amazon (ARN) du schéma. Il faut fournir soit `SchemaArn`, soit `SchemaName` et `RegistryName`.
  + SchemaId\$1 SchemaName : nom du schéma. Il faut fournir soit `SchemaArn`, soit `SchemaName` et `RegistryName`.

**Réponse**
+ `RegistryName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du registre.
+ `RegistryArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  L'Amazon Resource Name (ARN) du registre.
+ `SchemaName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du schéma.
+ `SchemaArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  L'Amazon Resource Name (ARN) du filtre.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description du schéma si spécifié lors de sa création
+ `DataFormat` – Chaîne UTF-8 (valeurs valides : `AVRO` \$1 `JSON` \$1 `PROTOBUF`).

  Format de données de la définition de schéma. À l'heure actuelle, `AVRO`, `JSON` et `PROTOBUF` sont pris en charge.
+ `Compatibility` – Chaîne UTF-8 (valeurs valides : `NONE` \$1 `DISABLED` \$1 `BACKWARD` \$1 `BACKWARD_ALL` \$1 `FORWARD` \$1 `FORWARD_ALL` \$1 `FULL` \$1 `FULL_ALL`).

  Mode de compatibilité du schéma.
+ `SchemaCheckpoint` – Nombre (long), compris entre 1 et 100 000.

  Numéro de version du point de contrôle (la dernière fois que le mode de compatibilité a été modifié).
+ `LatestSchemaVersion` – Nombre (long), compris entre 1 et 100 000.

  Version la plus récente du schéma associé à la définition de schéma renvoyée.
+ `NextSchemaVersion` – Nombre (long), compris entre 1 et 100 000.

  Version suivante du schéma associé à la définition de schéma renvoyée.
+ `SchemaStatus` – Chaîne UTF-8 (valeurs valides : `AVAILABLE` \$1 `PENDING` \$1 `DELETING`).

  Statut du schéma.
+ `CreatedTime` – Chaîne UTF-8.

  Date et heure de création du schéma.
+ `UpdatedTime` – Chaîne UTF-8.

  Date et heure de mise à jour du schéma.

**Erreurs**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ThrottlingException`
+ `InternalServiceException`

## ListSchemaVersions action (Python : list\$1schema\$1versions)
<a name="aws-glue-api-schema-registry-api-ListSchemaVersions"></a>

Renvoie une liste des versions de schéma que vous avez créées, avec un minimum d'informations. Les versions de schémas dont le statut est Deleted ne seront pas incluses dans les résultats. Des résultats vides seront retournés s'il n'y a pas de version de schéma disponible.

**Demande**
+ `SchemaId` – *Obligatoire :* un objet [SchemaId](#aws-glue-api-schema-registry-api-SchemaId).

  Structure d'encapsulation contenant les champs d'identité de schéma. La structure contient :
  + SchemaId\$1 SchemaArn : Le nom de ressource Amazon (ARN) du schéma. Il faut fournir soit `SchemaArn`, soit `SchemaName` et `RegistryName`.
  + SchemaId\$1 SchemaName : nom du schéma. Il faut fournir soit `SchemaArn`, soit `SchemaName` et `RegistryName`.
+ `MaxResults` – Nombre (entier), compris entre 1 et 100.

  Nombre maximum de résultats requis par page. Si la valeur n'est pas fournie, elle par défaut sera de 25 par page.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.

**Réponse**
+ `Schemas` : un tableau d’objets [SchemaVersionListItem](#aws-glue-api-schema-registry-api-SchemaVersionListItem).

  Tableau d'objets `SchemaVersionList` contenant les détails de chaque version de schéma.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation pour la pagination de la liste des jetons renvoyés, renvoyé si le segment actuel de la liste n’est pas le dernier.

**Erreurs**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ThrottlingException`
+ `InternalServiceException`

## GetSchemaVersion action (Python : get\$1schema\$1version)
<a name="aws-glue-api-schema-registry-api-GetSchemaVersion"></a>

Récupère le schéma spécifié par son ID unique attribué lors de la création ou de l'enregistrement d'une version du schéma. Les versions de schémas dont le statut est Deleted ne seront pas incluses dans les résultats.

**Demande**
+ `SchemaId` – Un objet [SchemaId](#aws-glue-api-schema-registry-api-SchemaId).

  Structure d'encapsulation contenant les champs d'identité de schéma. La structure contient :
  + SchemaId\$1 SchemaArn : Le nom de ressource Amazon (ARN) du schéma. Il faut fournir soit `SchemaArn`, soit `SchemaName` et `RegistryName`.
  + SchemaId\$1 SchemaName : nom du schéma. Il faut fournir soit `SchemaArn`, soit `SchemaName` et `RegistryName`.
+ `SchemaVersionId` – Chaîne UTF-8, d'une longueur exacte de 36 octets, correspondant au [Custom string pattern #45](aws-glue-api-common.md#regex_45).

  Le `SchemaVersionId` de la version du schéma. Ce champ est requis pour l'extraction par ID de schéma. Il faut fournir soit cet élément, soit l'encapsulateur `SchemaId`.
+ `SchemaVersionNumber` – Un objet [SchemaVersionNumber](#aws-glue-api-schema-registry-api-SchemaVersionNumber).

  Numéro de version du schéma.

**Réponse**
+ `SchemaVersionId` – Chaîne UTF-8, d'une longueur exacte de 36 octets, correspondant au [Custom string pattern #45](aws-glue-api-common.md#regex_45).

  Le `SchemaVersionId` de la version du schéma.
+ `SchemaDefinition` – Chaîne UTF-8, d'une longueur comprise entre 1 et 170 000 octets, correspondant au [Custom string pattern #13](aws-glue-api-common.md#regex_13).

  La définition du schéma pour l'ID du schéma.
+ `DataFormat` – Chaîne UTF-8 (valeurs valides : `AVRO` \$1 `JSON` \$1 `PROTOBUF`).

  Format de données de la définition de schéma. À l'heure actuelle, `AVRO`, `JSON` et `PROTOBUF` sont pris en charge.
+ `SchemaArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  L'Amazon Resource Name (ARN) du filtre.
+ `VersionNumber` – Nombre (long), compris entre 1 et 100 000.

  Numéro de version du schéma.
+ `Status` – Chaîne UTF-8 (valeurs valides : `AVAILABLE` \$1 `PENDING` \$1 `FAILURE` \$1 `DELETING`).

  Statut de la version du schéma. 
+ `CreatedTime` – Chaîne UTF-8.

  Date et heure de création à laquelle la version de schéma a été créée.

**Erreurs**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ThrottlingException`
+ `InternalServiceException`

## GetSchemaVersionsDiff action (Python : get\$1schema\$1versions\$1diff)
<a name="aws-glue-api-schema-registry-api-GetSchemaVersionsDiff"></a>

Récupère la différence de version de schéma dans le type de différence spécifié entre deux versions de schéma stockées dans le registre des schémas.

Cette API vous permet de comparer deux versions de schéma entre deux définitions de schéma sous le même schéma.

**Demande**
+ `SchemaId` – *Obligatoire :* un objet [SchemaId](#aws-glue-api-schema-registry-api-SchemaId).

  Structure d'encapsulation contenant les champs d'identité de schéma. La structure contient :
  + SchemaId\$1 SchemaArn : Le nom de ressource Amazon (ARN) du schéma. `SchemaArn` ou `SchemaName` doit être fourni.
  + SchemaId\$1 SchemaName : nom du schéma. `SchemaArn` ou `SchemaName` doit être fourni.
+ `FirstSchemaVersionNumber` – *Obligatoire :* un objet [SchemaVersionNumber](#aws-glue-api-schema-registry-api-SchemaVersionNumber).

  La première des deux versions de schéma à comparer.
+ `SecondSchemaVersionNumber` – *Obligatoire :* un objet [SchemaVersionNumber](#aws-glue-api-schema-registry-api-SchemaVersionNumber).

  La seconde des deux versions de schéma à comparer.
+ `SchemaDiffType` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `SYNTAX_DIFF`).

  Fait référence à `SYNTAX_DIFF`, qui est le type diff actuellement pris en charge.

**Réponse**
+ `Diff` – Chaîne UTF-8, d'une longueur comprise entre 1 et 340 000 octets, correspondant au [Custom string pattern #13](aws-glue-api-common.md#regex_13).

  La différence entre les schémas sous forme de chaîne de JsonPatch caractères.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `AccessDeniedException`
+ `ThrottlingException`
+ `InternalServiceException`

## ListRegistries action (Python : list\$1registries)
<a name="aws-glue-api-schema-registry-api-ListRegistries"></a>

Renvoie une liste des registres que vous avez créés, avec des informations de registre minimales. Les registres dont le statut est `Deleting` ne seront pas inclus dans les résultats. Des résultats vides seront retournés s'il n'y a pas de registres disponibles.

**Demande**
+ `MaxResults` – Nombre (entier), compris entre 1 et 100.

  Nombre maximum de résultats requis par page. Si la valeur n'est pas fournie, elle par défaut sera de 25 par page.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.

**Réponse**
+ `Registries` : un tableau d’objets [RegistryListItem](#aws-glue-api-schema-registry-api-RegistryListItem).

  Tableau d'objets `RegistryDetailedListItem` contenant des détails minimaux de chaque registre.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation pour la pagination de la liste des jetons renvoyés, renvoyé si le segment actuel de la liste n’est pas le dernier.

**Erreurs**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `ThrottlingException`
+ `InternalServiceException`

## ListSchemas action (Python : list\$1schemas)
<a name="aws-glue-api-schema-registry-api-ListSchemas"></a>

Renvoie une liste de schémas avec des détails minimaux. Les schémas dont le statut est Deleted ne seront pas inclus dans les résultats. Des résultats vides seront retournés s'il n'y a pas de schéma disponible.

Lorsque `RegistryId` n'est pas fourni, tous les schémas entre les registres feront partie de la réponse de l'API.

**Demande**
+ `RegistryId` – Un objet [RegistryId](#aws-glue-api-schema-registry-api-RegistryId).

  Structure d'encapsulation qui peut contenir le nom et l'Amazon Resource Name (ARN) du registre.
+ `MaxResults` – Nombre (entier), compris entre 1 et 100.

  Nombre maximum de résultats requis par page. Si la valeur n'est pas fournie, elle par défaut sera de 25 par page.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.

**Réponse**
+ `Schemas` : un tableau d’objets [SchemaListItem](#aws-glue-api-schema-registry-api-SchemaListItem).

  Tableau d'objets `SchemaListItem` contenant les détails de chaque schéma.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation pour la pagination de la liste des jetons renvoyés, renvoyé si le segment actuel de la liste n’est pas le dernier.

**Erreurs**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ThrottlingException`
+ `InternalServiceException`

## RegisterSchemaVersion action (Python : register\$1schema\$1version)
<a name="aws-glue-api-schema-registry-api-RegisterSchemaVersion"></a>

Ajoute une nouvelle version au schéma existant. Renvoie une erreur si la nouvelle version du schéma ne répond pas aux exigences de compatibilité du jeu de schémas. Cette API ne crée pas de nouveau jeu de schémas et renvoie une erreur 404 si le jeu de schémas n'est pas déjà présent dans le registre de schémas.

S'il s'agit de la première définition de schéma enregistrée dans le registre de schéma, cette API stockera la version du schéma et retournera immédiatement à l'appelant. Sinon, cet appel peut s'exécuter plus longtemps que d'autres opérations en raison des modes de compatibilité. Vous pouvez appeler l'API `GetSchemaVersion` avec le `SchemaVersionId` pour vérifier les modes de compatibilité.

Si la même définition de schéma est déjà stockée dans le registre de schéma en tant que version, l'ID de schéma du schéma existant est renvoyé à l'appelant.

**Demande**
+ `SchemaId` – *Obligatoire :* un objet [SchemaId](#aws-glue-api-schema-registry-api-SchemaId).

  Structure d'encapsulation contenant les champs d'identité de schéma. La structure contient :
  + SchemaId\$1 SchemaArn : Le nom de ressource Amazon (ARN) du schéma. Il faut fournir soit `SchemaArn`, soit `SchemaName` et `RegistryName`.
  + SchemaId\$1 SchemaName : nom du schéma. Il faut fournir soit `SchemaArn`, soit `SchemaName` et `RegistryName`.
+ `SchemaDefinition` – *Obligatoire :* chaîne UTF-8, d'une longueur comprise entre 1 et 170 000 octets, correspondant au [Custom string pattern #13](aws-glue-api-common.md#regex_13).

  Définition de schéma à l'aide du paramètre `DataFormat` pour `SchemaName`.

**Réponse**
+ `SchemaVersionId` – Chaîne UTF-8, d'une longueur exacte de 36 octets, correspondant au [Custom string pattern #45](aws-glue-api-common.md#regex_45).

  ID unique qui représente la version de ce schéma.
+ `VersionNumber` – Nombre (long), compris entre 1 et 100 000.

  Version de ce schéma (pour le flux de synchronisation uniquement, dans le cas où il s'agit de la première version).
+ `Status` – Chaîne UTF-8 (valeurs valides : `AVAILABLE` \$1 `PENDING` \$1 `FAILURE` \$1 `DELETING`).

  Statut de la version du schéma.

**Erreurs**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ResourceNumberLimitExceededException`
+ `ThrottlingException`
+ `ConcurrentModificationException`
+ `InternalServiceException`

## UpdateSchema action (Python : update\$1schema)
<a name="aws-glue-api-schema-registry-api-UpdateSchema"></a>

Met à jour la description, le paramètre de compatibilité ou le point de contrôle de version d'un jeu de schéma.

Pour mettre à jour le paramètre de compatibilité, l'appel ne valide pas la compatibilité pour l'ensemble des versions de schéma avec le nouveau paramètre de compatibilité. Si la valeur pour `Compatibility` est fournie, le `VersionNumber` (un point de contrôle) est également requis. L'API valide le numéro de version du point de contrôle à des fins de cohérence.

Si la valeur du `VersionNumber` (point de contrôle) est fournie, elle `Compatibility` est facultative et peut être utilisée comme point set/reset de contrôle pour le schéma.

Cette mise à jour se produira uniquement si le schéma est dans l'état AVAILABLE (DISPONIBLE).

**Demande**
+ `SchemaId` – *Obligatoire :* un objet [SchemaId](#aws-glue-api-schema-registry-api-SchemaId).

  Structure d'encapsulation contenant les champs d'identité de schéma. La structure contient :
  + SchemaId\$1 SchemaArn : Le nom de ressource Amazon (ARN) du schéma. `SchemaArn` ou `SchemaName` doit être fourni.
  + SchemaId\$1 SchemaName : nom du schéma. `SchemaArn` ou `SchemaName` doit être fourni.
+ `SchemaVersionNumber` – Un objet [SchemaVersionNumber](#aws-glue-api-schema-registry-api-SchemaVersionNumber).

  Numéro de version requis pour le pointage de contrôle. `VersionNumber` ou `Compatibility` doit être fourni.
+ `Compatibility` – Chaîne UTF-8 (valeurs valides : `NONE` \$1 `DISABLED` \$1 `BACKWARD` \$1 `BACKWARD_ALL` \$1 `FORWARD` \$1 `FORWARD_ALL` \$1 `FULL` \$1 `FULL_ALL`).

  Nouveau paramètre de compatibilité pour le schéma.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Nouvelle description du schéma.

**Réponse**
+ `SchemaArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  L'Amazon Resource Name (ARN) du filtre.
+ `SchemaName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du schéma.
+ `RegistryName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du registre contenant le schéma.

**Erreurs**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
+ `InternalServiceException`

## CheckSchemaVersionValidity action (Python : check\$1schema\$1version\$1validity)
<a name="aws-glue-api-schema-registry-api-CheckSchemaVersionValidity"></a>

Valide le schéma fourni. Cet appel n'a pas d'effets secondaires, il effectue simplement une validation en utilisant le schéma fourni à l'aide de `DataFormat`. Comme il ne prend pas de nom de jeu de schéma, aucune vérification de compatibilité n'est effectuée.

**Demande**
+ `DataFormat` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `AVRO` \$1 `JSON` \$1 `PROTOBUF`).

  Format de données de la définition de schéma. À l'heure actuelle, `AVRO`, `JSON` et `PROTOBUF` sont pris en charge.
+ `SchemaDefinition` – *Obligatoire :* chaîne UTF-8, d'une longueur comprise entre 1 et 170 000 octets, correspondant au [Custom string pattern #13](aws-glue-api-common.md#regex_13).

  Définition du schéma qui doit être validé.

**Réponse**
+ `Valid` : booléen.

  Renvoie true, si le schéma est valide et false sinon.
+ `Error` – Chaîne UTF-8, d'une longueur comprise entre 1 et 5 000 octets.

  Message d'erreur d'échec de validation.

**Erreurs**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `ThrottlingException`
+ `InternalServiceException`

## UpdateRegistry action (Python : update\$1registry)
<a name="aws-glue-api-schema-registry-api-UpdateRegistry"></a>

Met à jour un registre existant qui est utilisé pour contenir une collection de schémas. Les propriétés mises à jour se rapportent au registre et ne modifient aucun des schémas de celui-ci. 

**Demande**
+ `RegistryId` – *Obligatoire :* un objet [RegistryId](#aws-glue-api-schema-registry-api-RegistryId).

  Structure d'encapsulation qui peut contenir le nom et l'Amazon Resource Name (ARN) du registre.
+ `Description` – *Obligatoire :* Chaîne de description, d'une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description du registre. Si la description n'est pas fournie, ce champ ne sera pas mis à jour.

**Réponse**
+ `RegistryName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du registre mis à jour.
+ `RegistryArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  Amazon Resource Name (ARN) du registre mis à jour.

**Erreurs**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
+ `InternalServiceException`

## GetSchemaByDefinition action (Python : get\$1schema\$1by\$1definition)
<a name="aws-glue-api-schema-registry-api-GetSchemaByDefinition"></a>

Récupère un schéma à l'aide de sa `SchemaDefinition`. La définition du schéma est envoyée au registre de schéma, rendue canonique et hachée. Si le hachage correspond à la portée du `SchemaName` ou de l'ARN (ou du registre par défaut, si aucun n'est fourni), les métadonnées de ce schéma sont retournées. Dans le cas contraire, un 404 ou une NotFound erreur est renvoyée. Les versions de schémas dont le statut est `Deleted` ne seront pas incluses dans les résultats.

**Demande**
+ `SchemaId` – *Obligatoire :* un objet [SchemaId](#aws-glue-api-schema-registry-api-SchemaId).

  Structure d'encapsulation contenant les champs d'identité de schéma. La structure contient :
  + SchemaId\$1 SchemaArn : Le nom de ressource Amazon (ARN) du schéma. `SchemaArn` ou `SchemaName` doit être fourni.
  + SchemaId\$1 SchemaName : nom du schéma. `SchemaArn` ou `SchemaName` doit être fourni.
+ `SchemaDefinition` – *Obligatoire :* chaîne UTF-8, d'une longueur comprise entre 1 et 170 000 octets, correspondant au [Custom string pattern #13](aws-glue-api-common.md#regex_13).

  Définition du schéma pour lequel les détails du schéma sont requis.

**Réponse**
+ `SchemaVersionId` – Chaîne UTF-8, d'une longueur exacte de 36 octets, correspondant au [Custom string pattern #45](aws-glue-api-common.md#regex_45).

  ID de schéma de la version du schéma.
+ `SchemaArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  L'Amazon Resource Name (ARN) du filtre.
+ `DataFormat` – Chaîne UTF-8 (valeurs valides : `AVRO` \$1 `JSON` \$1 `PROTOBUF`).

  Format de données de la définition de schéma. À l'heure actuelle, `AVRO`, `JSON` et `PROTOBUF` sont pris en charge.
+ `Status` – Chaîne UTF-8 (valeurs valides : `AVAILABLE` \$1 `PENDING` \$1 `FAILURE` \$1 `DELETING`).

  Statut de la version du schéma.
+ `CreatedTime` – Chaîne UTF-8.

  Date et heure de création du schéma.

**Erreurs**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ThrottlingException`
+ `InternalServiceException`

## GetRegistry action (Python : get\$1registry)
<a name="aws-glue-api-schema-registry-api-GetRegistry"></a>

Décrit en détail le registre spécifié.

**Demande**
+ `RegistryId` – *Obligatoire :* un objet [RegistryId](#aws-glue-api-schema-registry-api-RegistryId).

  Structure d'encapsulation qui peut contenir le nom et l'Amazon Resource Name (ARN) du registre.

**Réponse**
+ `RegistryName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du registre.
+ `RegistryArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  L'Amazon Resource Name (ARN) du registre.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description du registre.
+ `Status` – Chaîne UTF-8 (valeurs valides : `AVAILABLE` \$1 `DELETING`).

  Statut du registre.
+ `CreatedTime` – Chaîne UTF-8.

  Date et heure de création du registre.
+ `UpdatedTime` – Chaîne UTF-8.

  Date et heure de mise à jour du registre.

**Erreurs**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ThrottlingException`
+ `InternalServiceException`

## PutSchemaVersionMetadata action (Python : put\$1schema\$1version\$1metadata)
<a name="aws-glue-api-schema-registry-api-PutSchemaVersionMetadata"></a>

Place la paire de valeurs clé de métadonnées pour un ID de version de schéma spécifié. Un maximum de 10 paires de valeurs clé sera autorisé par version de schéma. Ils peuvent être ajoutés au moyen d'un ou de plusieurs appels.

**Demande**
+ `SchemaId` – Un objet [SchemaId](#aws-glue-api-schema-registry-api-SchemaId).

  ID unique du schéma.
+ `SchemaVersionNumber` – Un objet [SchemaVersionNumber](#aws-glue-api-schema-registry-api-SchemaVersionNumber).

  Numéro de version du schéma.
+ `SchemaVersionId` – Chaîne UTF-8, d'une longueur exacte de 36 octets, correspondant au [Custom string pattern #45](aws-glue-api-common.md#regex_45).

  ID de version unique de la version du schéma.
+ `MetadataKeyValue` – *Obligatoire :* un objet [MetadataKeyValuePair](#aws-glue-api-schema-registry-api-MetadataKeyValuePair).

  Valeur correspondant à une clé de métadonnées.

**Réponse**
+ `SchemaArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  Amazon Resource Name (ARN) du schéma.
+ `SchemaName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du schéma.
+ `RegistryName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du registre.
+ `LatestVersion` : booléen.

  Dernière version du schéma.
+ `VersionNumber` – Nombre (long), compris entre 1 et 100 000.

  Numéro de version du schéma.
+ `SchemaVersionId` – Chaîne UTF-8, d'une longueur exacte de 36 octets, correspondant au [Custom string pattern #45](aws-glue-api-common.md#regex_45).

  ID de version unique de la version du schéma.
+ `MetadataKey` – Chaîne UTF-8, d'une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #14](aws-glue-api-common.md#regex_14).

  Clé de métadonnées.
+ `MetadataValue` – Chaîne UTF-8, d'une longueur comprise entre 1 et 256 octets, correspondant au [Custom string pattern #14](aws-glue-api-common.md#regex_14).

  Valeur de la clé de métadonnées.

**Erreurs**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `AlreadyExistsException`
+ `EntityNotFoundException`
+ `ThrottlingException`
+ `ResourceNumberLimitExceededException`

## QuerySchemaVersionMetadata action (Python : query\$1schema\$1version\$1metadata)
<a name="aws-glue-api-schema-registry-api-QuerySchemaVersionMetadata"></a>

Requêtes pour les informations de métadonnées de version du schéma. 

**Demande**
+ `SchemaId` – Un objet [SchemaId](#aws-glue-api-schema-registry-api-SchemaId).

  Structure d'encapsulation qui peut contenir le nom et l'Amazon Resource Name (ARN) du schéma.
+ `SchemaVersionNumber` – Un objet [SchemaVersionNumber](#aws-glue-api-schema-registry-api-SchemaVersionNumber).

  Numéro de version du schéma.
+ `SchemaVersionId` – Chaîne UTF-8, d'une longueur exacte de 36 octets, correspondant au [Custom string pattern #45](aws-glue-api-common.md#regex_45).

  ID de version unique de la version du schéma.
+ `MetadataList` : un tableau d’objets [MetadataKeyValuePair](#aws-glue-api-schema-registry-api-MetadataKeyValuePair).

  Rechercher des paires clé-valeur pour les métadonnées, si elles ne sont pas fournies, toutes les informations de métadonnées seront récupérées.
+ `MaxResults` – Nombre (entier), compris entre 1 et 50.

  Nombre maximum de résultats requis par page. Si la valeur n'est pas fournie, elle par défaut sera de 25 par page.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’un appel de continuation.

**Réponse**
+ `MetadataInfoMap` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d'une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #14](aws-glue-api-common.md#regex_14).

  Chaque valeur est un objet [MetadataInfo](#aws-glue-api-schema-registry-api-MetadataInfo).

  Carte d'une clé de métadonnées et des valeurs associées.
+ `SchemaVersionId` – Chaîne UTF-8, d'une longueur exacte de 36 octets, correspondant au [Custom string pattern #45](aws-glue-api-common.md#regex_45).

  ID de version unique de la version du schéma.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation pour la pagination de la liste des jetons renvoyés, renvoyé si le segment actuel de la liste n’est pas le dernier.

**Erreurs**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `ThrottlingException`
+ `EntityNotFoundException`

## RemoveSchemaVersionMetadata action (Python : remove\$1schema\$1version\$1metadata)
<a name="aws-glue-api-schema-registry-api-RemoveSchemaVersionMetadata"></a>

Supprime une paire de valeurs clé des métadonnées de version de schéma pour l'ID de version de schéma spécifié.

**Demande**
+ `SchemaId` – Un objet [SchemaId](#aws-glue-api-schema-registry-api-SchemaId).

  Structure d'encapsulation qui peut contenir le nom et l'Amazon Resource Name (ARN) du schéma.
+ `SchemaVersionNumber` – Un objet [SchemaVersionNumber](#aws-glue-api-schema-registry-api-SchemaVersionNumber).

  Numéro de version du schéma.
+ `SchemaVersionId` – Chaîne UTF-8, d'une longueur exacte de 36 octets, correspondant au [Custom string pattern #45](aws-glue-api-common.md#regex_45).

  ID de version unique de la version du schéma.
+ `MetadataKeyValue` – *Obligatoire :* un objet [MetadataKeyValuePair](#aws-glue-api-schema-registry-api-MetadataKeyValuePair).

  Valeur de la clé de métadonnées.

**Réponse**
+ `SchemaArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  L'Amazon Resource Name (ARN) du filtre.
+ `SchemaName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du schéma.
+ `RegistryName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du registre.
+ `LatestVersion` : booléen.

  Dernière version du schéma.
+ `VersionNumber` – Nombre (long), compris entre 1 et 100 000.

  Numéro de version du schéma.
+ `SchemaVersionId` – Chaîne UTF-8, d'une longueur exacte de 36 octets, correspondant au [Custom string pattern #45](aws-glue-api-common.md#regex_45).

  ID de version pour la version du schéma.
+ `MetadataKey` – Chaîne UTF-8, d'une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #14](aws-glue-api-common.md#regex_14).

  Clé de métadonnées.
+ `MetadataValue` – Chaîne UTF-8, d'une longueur comprise entre 1 et 256 octets, correspondant au [Custom string pattern #14](aws-glue-api-common.md#regex_14).

  Valeur de la clé de métadonnées.

**Erreurs**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `ThrottlingException`
+ `EntityNotFoundException`

## DeleteRegistry action (Python : supprimer\$1registre)
<a name="aws-glue-api-schema-registry-api-DeleteRegistry"></a>

Supprimer l'intégralité du registre, y compris le schéma et toutes ses versions. Pour obtenir le statut de l'opération de suppression, vous pouvez appeler l'API `GetRegistry` après l'appel asynchrone. La suppression d'un registre désactivera toutes les opérations en ligne du registre, telles que le`UpdateRegistry`, `CreateSchema``UpdateSchema`, et `RegisterSchemaVersion` APIs. 

**Demande**
+ `RegistryId` – *Obligatoire :* un objet [RegistryId](#aws-glue-api-schema-registry-api-RegistryId).

  Structure d'encapsulation qui peut contenir le nom et l'Amazon Resource Name (ARN) du registre.

**Réponse**
+ `RegistryName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du registre en cours de suppression.
+ `RegistryArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  Amazon Resource Name (ARN) du registre en cours de suppression.
+ `Status` – Chaîne UTF-8 (valeurs valides : `AVAILABLE` \$1 `DELETING`).

  Statut du registre. La réussite de l'opération retournera le statut `Deleting`.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `AccessDeniedException`
+ `ThrottlingException`
+ `ConcurrentModificationException`

## DeleteSchema action (Python : supprimer\$1schéma)
<a name="aws-glue-api-schema-registry-api-DeleteSchema"></a>

Supprime l'ensemble de schémas, y compris le jeu de schémas et toutes ses versions. Pour obtenir le statut de l'opération de suppression, vous pouvez appeler l'API `GetSchema` après l'appel asynchrone. La suppression d'un registre désactivera toutes les opérations en ligne pour le schéma, telles que le`GetSchemaByDefinition`, et `RegisterSchemaVersion` APIs.

**Demande**
+ `SchemaId` – *Obligatoire :* un objet [SchemaId](#aws-glue-api-schema-registry-api-SchemaId).

  Structure d'encapsulation qui peut contenir le nom et l'Amazon Resource Name (ARN) du schéma.

**Réponse**
+ `SchemaArn` – Chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  Amazon Resource Name (ARN) du schéma en cours de suppression.
+ `SchemaName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #46](aws-glue-api-common.md#regex_46).

  Nom du schéma en cours de suppression.
+ `Status` – Chaîne UTF-8 (valeurs valides : `AVAILABLE` \$1 `PENDING` \$1 `DELETING`).

  Statut du schéma.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `AccessDeniedException`
+ `ThrottlingException`
+ `ConcurrentModificationException`

## DeleteSchemaVersions action (Python : delete\$1schema\$1versions)
<a name="aws-glue-api-schema-registry-api-DeleteSchemaVersions"></a>

Supprimez des versions du schéma spécifié. Un numéro ou une plage de versions peut être fourni. Si le mode de compatibilité interdit la suppression d'une version nécessaire, telle que BACKWARDS\$1FULL (DESCENDANT\$1TOUT), une erreur est renvoyée. En appelant l'API `GetSchemaVersions` après cet appel, vous obtiendrez la liste de l'état des versions supprimées.

Lorsque la plage de numéros de version contient une version comportant un point de contrôle, l'API renvoie un conflit 409 et ne procède pas à la suppression. Vous devez d'abord supprimer le point de contrôle à l'aide de l'API `DeleteSchemaCheckpoint` avant d'utiliser cette API.

Vous ne pouvez pas utiliser l'API `DeleteSchemaVersions` pour supprimer la première version de schéma dans le jeu de schémas. La première version de schéma ne peut être supprimée que par l'appel à l'API `DeleteSchema`. Cette opération supprimera également les `SchemaVersionMetadata` attachées aux versions du schéma. Les suppressions définitives seront appliquées sur la base de données.

Si le mode de compatibilité interdit la suppression d'une version nécessaire, telle que BACKWARDS\$1FULL (DESCENDANT\$1TOUT), une erreur est renvoyée.

**Demande**
+ `SchemaId` – *Obligatoire :* un objet [SchemaId](#aws-glue-api-schema-registry-api-SchemaId).

  Structure d'encapsulation qui peut contenir le nom et l'Amazon Resource Name (ARN) du schéma.
+ `Versions` – *Obligatoire :* chaîne UTF-8, d'une longueur comprise entre 1 et 100 000 octets, correspondant au [Custom string pattern #15](aws-glue-api-common.md#regex_15).

  Une plage de versions peut être fournie au format suivant :
  + un numéro de version unique, 5
  + une plage, 5-8 : supprime les versions 5, 6, 7, 8

**Réponse**
+ `SchemaVersionErrors` : un tableau d’objets [SchemaVersionErrorItem](#aws-glue-api-schema-registry-api-SchemaVersionErrorItem).

  Une liste d'objets `SchemaVersionErrorItem`, chacun contenant une version d'erreur et de schéma.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `AccessDeniedException`
+ `ThrottlingException`
+ `ConcurrentModificationException`

# Flux de travail
<a name="aws-glue-api-workflow"></a>

 L'API Workflows décrit les types de données et l'API liés à la création, à la mise à jour ou à l'affichage des flux de travail dans AWS Glue. L’historique d’exécution des tâches est accessible pendant 90 jours pour votre flux de travail et l’exécution des tâches. 

## Types de données
<a name="aws-glue-api-workflow-objects"></a>
+ [JobNodeDetails structure](#aws-glue-api-workflow-JobNodeDetails)
+ [CrawlerNodeDetails structure](#aws-glue-api-workflow-CrawlerNodeDetails)
+ [TriggerNodeDetails structure](#aws-glue-api-workflow-TriggerNodeDetails)
+ [Structure Crawl](#aws-glue-api-workflow-Crawl)
+ [Structure de nœud](#aws-glue-api-workflow-Node)
+ [Structure Edge](#aws-glue-api-workflow-Edge)
+ [Structure de flux de travail](#aws-glue-api-workflow-Workflow)
+ [WorkflowGraph structure](#aws-glue-api-workflow-WorkflowGraph)
+ [WorkflowRun structure](#aws-glue-api-workflow-WorkflowRun)
+ [WorkflowRunStatistics structure](#aws-glue-api-workflow-WorkflowRunStatistics)
+ [StartingEventBatchCondition structure](#aws-glue-api-workflow-StartingEventBatchCondition)
+ [Structure du plan](#aws-glue-api-workflow-Blueprint)
+ [BlueprintDetails structure](#aws-glue-api-workflow-BlueprintDetails)
+ [LastActiveDefinition structure](#aws-glue-api-workflow-LastActiveDefinition)
+ [BlueprintRun structure](#aws-glue-api-workflow-BlueprintRun)

## JobNodeDetails structure
<a name="aws-glue-api-workflow-JobNodeDetails"></a>

Détails d'un nœud de tâches présent dans le flux de travail.

**Champs**
+ `JobRuns` : un tableau d’objets [JobRun](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-JobRun).

  Informations relatives aux exécutions de tâches représentées par le nœud de tâches.

## CrawlerNodeDetails structure
<a name="aws-glue-api-workflow-CrawlerNodeDetails"></a>

Détails d'un nœud d'crawler présent dans le flux de travail.

**Champs**
+ `Crawls` : un tableau d’objets [Crawl](#aws-glue-api-workflow-Crawl).

  Liste de crawlers représentés par le nœud de crawler.

## TriggerNodeDetails structure
<a name="aws-glue-api-workflow-TriggerNodeDetails"></a>

Détails d'un nœud Trigger présent dans le flux de travail.

**Champs**
+ `Trigger` – Un objet [Déclencheur](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-Trigger).

  Informations relatives au déclencheur représenté par le nœud de déclencheur.

## Structure Crawl
<a name="aws-glue-api-workflow-Crawl"></a>

Détails d'un crawler dans le flux de travail.

**Champs**
+ `State` – Chaîne UTF-8 (valeurs valides : `RUNNING` \$1 `CANCELLING` \$1 `CANCELLED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `ERROR`).

  État de l'crawler.
+ `StartedOn` – Horodatage.

  Date et heure auxquelles le crawler a démarré.
+ `CompletedOn` – Horodatage.

  Date et heure auxquelles l’analyse a terminé.
+ `ErrorMessage` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Message d'erreur associé au crawler
+ `LogGroup` – Chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets, correspondant au [Log group string pattern](aws-glue-api-common.md#aws-glue-api-regex-logGroup-id).

  Groupe de journaux associés au crawler.
+ `LogStream` – Chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets, correspondant au [Log-stream string pattern](aws-glue-api-common.md#aws-glue-api-regex-logStream-id).

  Flux de journaux associé au crawler.

## Structure de nœud
<a name="aws-glue-api-workflow-Node"></a>

Un nœud représente un AWS Glue composant (déclencheur, robot ou tâche) sur un graphe de flux de travail.

**Champs**
+ `Type` – Chaîne UTF-8 (valeurs valides : `CRAWLER` \$1 `JOB` \$1 `TRIGGER`).

  Type de AWS Glue composant représenté par le nœud.
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du AWS Glue composant représenté par le nœud.
+ `UniqueId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID unique affecté au nœud au sein du flux de travail.
+ `TriggerDetails` – Un objet [TriggerNodeDetails](#aws-glue-api-workflow-TriggerNodeDetails).

  Détails du déclencheur lorsque le nœud représente un déclencheur.
+ `JobDetails` – Un objet [JobNodeDetails](#aws-glue-api-workflow-JobNodeDetails).

  Détails de la tâche lorsque le nœud représente une tâche.
+ `CrawlerDetails` – Un objet [CrawlerNodeDetails](#aws-glue-api-workflow-CrawlerNodeDetails).

  Détails de l'crawler lorsque le nœud représente un crawler.

## Structure Edge
<a name="aws-glue-api-workflow-Edge"></a>

Un arête représente une connexion dirigée entre deux AWS Glue composants qui font partie du flux de travail auquel appartient l'arête.

**Champs**
+ `SourceId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaîne unique du nœud au sein du flux de travail où démarre la périphérie.
+ `DestinationId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaîne unique du nœud au sein du flux de travail où la périphérie se termine.

## Structure de flux de travail
<a name="aws-glue-api-workflow-Workflow"></a>

Un flux de travail est un ensemble de plusieurs AWS Glue tâches dépendantes et de robots d'exploration exécutés pour effectuer une tâche ETL complexe. Un flux de travail gère l'exécution et le suivi de tous ses jobs et crawlers.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du flux de travail.
+ `Description` – Chaîne UTF-8.

  Description du flux de travail.
+ `DefaultRunProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8.

  Collection de propriétés à utiliser dans le cadre de chaque exécution du flux de travail. Les propriétés d’exécution sont mises à la disposition de chaque tâche du flux de travail. Une tâche peut modifier les propriétés des tâches suivants dans le flux de travail.
+ `CreatedOn` – Horodatage.

  Date et heure auxquelles le flux de travail a été créé.
+ `LastModifiedOn` – Horodatage.

  Date et heure auxquelles le flux de travail a été modifié pour la dernière fois.
+ `LastRun` – Un objet [WorkflowRun](#aws-glue-api-workflow-WorkflowRun).

  Informations relatives à la dernière exécution du flux de travail.
+ `Graph` – Un objet [WorkflowGraph](#aws-glue-api-workflow-WorkflowGraph).

  Le graphique représente tous les AWS Glue composants appartenant au flux de travail sous forme de nœuds et les connexions dirigées entre eux sous forme d'arêtes.
+ `CreationStatus` – Chaîne UTF-8 (valeurs valides : `CREATING` \$1 `CREATED` \$1 `CREATION_FAILED`).

  État de création du flux de travail.
+ `MaxConcurrentRuns` : nombre (entier).

  Vous pouvez utiliser ce paramètre pour empêcher plusieurs mises à jour indésirables des données, pour contrôler les coûts ou, dans certains cas, pour empêcher le dépassement du nombre maximal d’exécutions simultanées de l’un des travaux de composant. Si vous laissez ce paramètre vide, le nombre d’exécutions de flux de travail simultanées est illimité.
+ `BlueprintDetails` – Un objet [BlueprintDetails](#aws-glue-api-workflow-BlueprintDetails).

  Cette structure indique les détails du plan à partir duquel ce flux de travail particulier est créé.

## WorkflowGraph structure
<a name="aws-glue-api-workflow-WorkflowGraph"></a>

Un graphique de flux de travail représente le flux de travail complet contenant tous les composants AWS Glue présents dans le flux de travail et toutes les connexions dirigées entre eux.

**Champs**
+ `Nodes` : un tableau d’objets [Nœud](#aws-glue-api-workflow-Node).

  Une liste des AWS Glue composants appartenant au flux de travail représentés sous forme de nœuds.
+ `Edges` : un tableau d’objets [Edge](#aws-glue-api-workflow-Edge).

  Liste de toutes les connexions dirigées entre les nœuds appartenant au flux de travail.

## WorkflowRun structure
<a name="aws-glue-api-workflow-WorkflowRun"></a>

Une exécution de flux de travail est une exécution de flux de travail qui fournit toutes les informations d’exécution.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du flux de travail qui a été exécuté.
+ `WorkflowRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de cette exécution de flux de travail.
+ `PreviousRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de la précédente exécution de flux de travail.
+ `WorkflowRunProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8.

  Propriétés d’exécution de flux de travail qui ont été définies au cours de l’exécution.
+ `StartedOn` – Horodatage.

  Date et heure auxquelles l’exécution de flux de travail a démarré.
+ `CompletedOn` – Horodatage.

  Date et heure auxquelles l’exécution de flux de travail a s’est terminée.
+ `Status` – Chaîne UTF-8 (valeurs valides : `RUNNING` \$1 `COMPLETED` \$1 `STOPPING` \$1 `STOPPED` \$1 `ERROR`).

  État de l’exécution de flux de travail.
+ `ErrorMessage` – Chaîne UTF-8.

  Ce message d’erreur décrit toute erreur qui peut s’être produite lors du démarrage de l’exécution du flux de travail. Actuellement, le seul message d’erreur est « Concurrent runs exceeded for workflow: `foo` » (Exécutions simultanées dépassées pour le flux de travail : foo).
+ `Statistics` – Un objet [WorkflowRunStatistics](#aws-glue-api-workflow-WorkflowRunStatistics).

  Statistiques de l’exécution.
+ `Graph` – Un objet [WorkflowGraph](#aws-glue-api-workflow-WorkflowGraph).

  Le graphique représente tous les AWS Glue composants appartenant au flux de travail sous forme de nœuds et les connexions dirigées entre eux sous forme d'arêtes.
+ `StartingEventBatchCondition` – Un objet [StartingEventBatchCondition](#aws-glue-api-workflow-StartingEventBatchCondition).

  Condition de lot qui a démarré l’exécution du flux de travail.

## WorkflowRunStatistics structure
<a name="aws-glue-api-workflow-WorkflowRunStatistics"></a>

Le flux de travail exécut des statistiques et fournit des statistiques sur l’exécution du flux de travail.

**Champs**
+ `TotalActions` : nombre (entier).

  Nombre total d’actions dans l’exécution du flux de travail.
+ `TimeoutActions` : nombre (entier).

  Nombre total d’actions qui ont expiré.
+ `FailedActions` : nombre (entier).

  Nombre total d’actions qui ont échoué.
+ `StoppedActions` : nombre (entier).

  Nombre total d’actions qui sont arrêtées.
+ `SucceededActions` : nombre (entier).

  Nombre total d’actions qui ont réussi.
+ `RunningActions` : nombre (entier).

  Nombre total d’actions en cours d’exécution.
+ `ErroredActions` : nombre (entier).

  Indique le nombre d’exécutions de tâches dans l’état ERROR dans l’exécution du flux de travail.
+ `WaitingActions` : nombre (entier).

  Indique le nombre d’exécutions de tâches en état WAITING dans l’exécution du flux de travail.

## StartingEventBatchCondition structure
<a name="aws-glue-api-workflow-StartingEventBatchCondition"></a>

Condition de lot qui a démarré l’exécution du flux de travail. Soit le nombre d'événements de la taille du lot est arrivé, auquel cas le BatchSize membre est différent de zéro, soit la fenêtre du lot a expiré, auquel cas le BatchWindow membre est différent de zéro.

**Champs**
+ `BatchSize` : nombre (entier).

  Nombre d’événements dans le lot.
+ `BatchWindow` : nombre (entier).

  Durée de la fenêtre de traitement par lots en secondes.

## Structure du plan
<a name="aws-glue-api-workflow-Blueprint"></a>

Détails d’un plan.

**Champs**
+ `Name` – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Nom du plan.
+ `Description` – chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets.

  Description du plan.
+ `CreatedOn` – Horodatage.

  Date et heure d’enregistrement du plan.
+ `LastModifiedOn` – Horodatage.

  Date et heure auxquelles le plan a été modifié pour la dernière fois.
+ `ParameterSpec` – chaîne UTF-8, d’une longueur comprise entre 1 et 131 072 octets.

  Chaîne JSON qui indique la liste des spécifications de paramètres pour le plan.
+ `BlueprintLocation` – Chaîne UTF-8.

  Spécifie le chemin dans Amazon S3 où le plan est publié.
+ `BlueprintServiceLocation` – Chaîne UTF-8.

  Spécifie un chemin dans Amazon S3 où le plan est copié lorsque vous appelez `CreateBlueprint/UpdateBlueprint` pour enregistrer le plan dans AWS Glue.
+ `Status` – Chaîne UTF-8 (valeurs valides : `CREATING` \$1 `ACTIVE` \$1 `UPDATING` \$1 `FAILED`).

  Statut de l’enregistrement du plan.
  + Création : l’enregistrement du plan est en cours.
  + Actif : le plan a été enregistré avec succès.
  + Mise à jour : une mise à jour de l’enregistrement du plan est en cours.
  + Échec : l’enregistrement du plan a échoué.
+ `ErrorMessage` – Chaîne UTF-8.

  Message d’erreur.
+ `LastActiveDefinition` – Un objet [LastActiveDefinition](#aws-glue-api-workflow-LastActiveDefinition).

  Lorsqu’il existe plusieurs versions d’un plan et que la dernière version contient des erreurs, cet attribut indique la dernière définition de plan réussie qui est disponible avec le service.

## BlueprintDetails structure
<a name="aws-glue-api-workflow-BlueprintDetails"></a>

Détails d’un plan.

**Champs**
+ `BlueprintName` – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Nom du plan.
+ `RunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID d’exécution de ce plan.

## LastActiveDefinition structure
<a name="aws-glue-api-workflow-LastActiveDefinition"></a>

Lorsqu’il existe plusieurs versions d’un plan et que la dernière version contient des erreurs, cet attribut indique la dernière définition de plan réussie qui est disponible avec le service.

**Champs**
+ `Description` – chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets.

  Description du plan.
+ `LastModifiedOn` – Horodatage.

  Date et heure auxquelles le plan a été modifié pour la dernière fois.
+ `ParameterSpec` – chaîne UTF-8, d'une longueur comprise entre 1 et 131 072 octets.

  Chaîne JSON spécifiant les paramètres du plan.
+ `BlueprintLocation` – Chaîne UTF-8.

  Spécifie un chemin dans Amazon S3 où le plan est publié par le AWS Glue développeur.
+ `BlueprintServiceLocation` – Chaîne UTF-8.

  Spécifie un chemin dans Amazon S3 où le plan est copié lorsque vous créez ou mettez à jour ce dernier.

## BlueprintRun structure
<a name="aws-glue-api-workflow-BlueprintRun"></a>

Détails d’une exécution de plan.

**Champs**
+ `BlueprintName` – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Nom du plan.
+ `RunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID d’exécution de cette exécution de plan.
+ `WorkflowName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom d’un flux de travail créé à la suite d’une exécution réussie du plan. Si une exécution de plan comporte une erreur, aucun flux de travail ne sera créé.
+ `State` – Chaîne UTF-8 (valeurs valides : `RUNNING` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `ROLLING_BACK`).

  État de l’exécution du plan. Les valeurs possibles sont :
  + En cours d’exécution : l’exécution du plan est en cours.
  + Réussi : l’exécution du plan s’est terminée.
  + Échec : l’exécution du plan a échoué et la restauration est terminée.
  + Annuler : l’exécution du plan a échoué et la restauration est en cours.
+ `StartedOn` – Horodatage.

  Date et heure auxquelles l’exécution du plan a démarré.
+ `CompletedOn` – Horodatage.

  Date et heure auxquelles le modèle a été exécuté.
+ `ErrorMessage` – Chaîne UTF-8.

  Indique les erreurs détectées lors de l’exécution du plan.
+ `RollbackErrorMessage` – Chaîne UTF-8.

  S’il y a des erreurs lors de la création des entités d’un flux de travail, nous essayons de restaurer les entités créées jusqu’à ce point et de les supprimer. Cet attribut indique les erreurs rencontrées lors de la tentative de suppression des entités créées.
+ `Parameters` – chaîne UTF-8, d'une longueur comprise entre 1 et 131 072 octets.

  Paramètres du plan sous la forme d’une chaîne. Vous devrez fournir une valeur pour chaque clé requise à partir de la spécification de paramètre définie dans `Blueprint$ParameterSpec`.
+ `RoleArn` – Chaîne UTF-8, d’une longueur comprise entre 1 et 1024 octets, correspondant au [Custom string pattern #30](aws-glue-api-common.md#regex_30).

  ARN du rôle. Ce rôle sera assumé par le AWS Glue service et sera utilisé pour créer le flux de travail et les autres entités d'un flux de travail.

## Opérations
<a name="aws-glue-api-workflow-actions"></a>
+ [CreateWorkflow action (Python : create\$1workflow)](#aws-glue-api-workflow-CreateWorkflow)
+ [UpdateWorkflow action (Python : update\$1workflow)](#aws-glue-api-workflow-UpdateWorkflow)
+ [DeleteWorkflow action (Python : delete\$1workflow)](#aws-glue-api-workflow-DeleteWorkflow)
+ [GetWorkflow action (Python : get\$1workflow)](#aws-glue-api-workflow-GetWorkflow)
+ [ListWorkflows action (Python : list\$1workflows)](#aws-glue-api-workflow-ListWorkflows)
+ [BatchGetWorkflows action (Python : batch\$1get\$1workflows)](#aws-glue-api-workflow-BatchGetWorkflows)
+ [GetWorkflowRun action (Python : get\$1workflow\$1run)](#aws-glue-api-workflow-GetWorkflowRun)
+ [GetWorkflowRuns action (Python : get\$1workflow\$1runs)](#aws-glue-api-workflow-GetWorkflowRuns)
+ [GetWorkflowRunProperties action (Python : get\$1workflow\$1run\$1properties)](#aws-glue-api-workflow-GetWorkflowRunProperties)
+ [PutWorkflowRunProperties action (Python : put\$1workflow\$1run\$1properties)](#aws-glue-api-workflow-PutWorkflowRunProperties)
+ [CreateBlueprint action (Python : créer\$1blueprint)](#aws-glue-api-workflow-CreateBlueprint)
+ [UpdateBlueprint action (Python : update\$1blueprint)](#aws-glue-api-workflow-UpdateBlueprint)
+ [DeleteBlueprint action (Python : delete\$1blueprint)](#aws-glue-api-workflow-DeleteBlueprint)
+ [ListBlueprints action (Python : list\$1blueprints)](#aws-glue-api-workflow-ListBlueprints)
+ [BatchGetBlueprints action (Python : batch\$1get\$1blueprints)](#aws-glue-api-workflow-BatchGetBlueprints)
+ [StartBlueprintRun action (Python : start\$1blueprint\$1run)](#aws-glue-api-workflow-StartBlueprintRun)
+ [GetBlueprintRun action (Python : get\$1blueprint\$1run)](#aws-glue-api-workflow-GetBlueprintRun)
+ [GetBlueprintRuns action (Python : get\$1blueprint\$1runs)](#aws-glue-api-workflow-GetBlueprintRuns)
+ [StartWorkflowRun action (Python : start\$1workflow\$1run)](#aws-glue-api-workflow-StartWorkflowRun)
+ [StopWorkflowRun action (Python : stop\$1workflow\$1run)](#aws-glue-api-workflow-StopWorkflowRun)
+ [ResumeWorkflowRun action (Python : resume\$1workflow\$1run)](#aws-glue-api-workflow-ResumeWorkflowRun)

## CreateWorkflow action (Python : create\$1workflow)
<a name="aws-glue-api-workflow-CreateWorkflow"></a>

Crée un nouveau flux de travail.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom à affecter ai flux de travail. Il doit être unique au sein de votre compte.
+ `Description` – Chaîne UTF-8, d’une longueur maximale de 120 000 octets.

  Description du flux de travail.
+ `DefaultRunProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8.

  Collection de propriétés à utiliser dans le cadre de chaque exécution du flux de travail.

  Les propriétés d’exécution peuvent être journalisées. Ne transmettez pas de secrets en texte clair comme propriétés. Récupérez les secrets d'une AWS Glue connexion, d'un Gestionnaire de AWS Secrets ou d'un autre mécanisme de gestion des secrets si vous avez l'intention de les utiliser dans le cadre de l'exécution du flux de travail.
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Balises à utiliser avec ce flux de travail.
+ `MaxConcurrentRuns` : nombre (entier).

  Vous pouvez utiliser ce paramètre pour empêcher plusieurs mises à jour indésirables des données, pour contrôler les coûts ou, dans certains cas, pour empêcher le dépassement du nombre maximal d’exécutions simultanées de l’un des travaux de composant. Si vous laissez ce paramètre vide, le nombre d’exécutions de flux de travail simultanées est illimité.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du flux de travail qui a été fourni dans le cadre de la requête.

**Erreurs**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentModificationException`

## UpdateWorkflow action (Python : update\$1workflow)
<a name="aws-glue-api-workflow-UpdateWorkflow"></a>

Met à jour un flux de travail existant.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du flux de travail à mettre à jour.
+ `Description` – Chaîne UTF-8, d’une longueur maximale de 120 000 octets.

  Description du flux de travail.
+ `DefaultRunProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8.

  Collection de propriétés à utiliser dans le cadre de chaque exécution du flux de travail.

  Les propriétés d’exécution peuvent être journalisées. Ne transmettez pas de secrets en texte clair comme propriétés. Récupérez les secrets d'une AWS Glue connexion, d'un Gestionnaire de AWS Secrets ou d'un autre mécanisme de gestion des secrets si vous avez l'intention de les utiliser dans le cadre de l'exécution du flux de travail.
+ `MaxConcurrentRuns` : nombre (entier).

  Vous pouvez utiliser ce paramètre pour empêcher plusieurs mises à jour indésirables des données, pour contrôler les coûts ou, dans certains cas, pour empêcher le dépassement du nombre maximal d’exécutions simultanées de l’un des travaux de composant. Si vous laissez ce paramètre vide, le nombre d’exécutions de flux de travail simultanées est illimité.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du flux de travail qui a été spécifié dans l’entrée.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`

## DeleteWorkflow action (Python : delete\$1workflow)
<a name="aws-glue-api-workflow-DeleteWorkflow"></a>

Supprime un flux de travail.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du flux de travail à supprimer.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du flux de travail spécifié dans l’entrée.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`

## GetWorkflow action (Python : get\$1workflow)
<a name="aws-glue-api-workflow-GetWorkflow"></a>

Récupère les métadonnées de ressource pour un flux de travail.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du flux de travail à récupérer.
+ `IncludeGraph` : booléen.

  Indique si un graphique doit être inclus lors du renvoi de métadonnées de ressource de flux de travail.

**Réponse**
+ `Workflow` – Un objet [Flux de travail](#aws-glue-api-workflow-Workflow).

  Métadonnées de ressource du flux de travail.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## ListWorkflows action (Python : list\$1workflows)
<a name="aws-glue-api-workflow-ListWorkflows"></a>

Affiche les noms des flux de travail créés dans le compte.

**Demande**
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’une requête de continuation.
+ `MaxResults`— Nombre (entier), pas moins de 1 ou plus de 25.

  La taille maximale d’une liste à renvoyer.

**Réponse**
+ `Workflows` – tableau de chaînes UTF-8, avec 1 chaîne minimum et 25 chaînes maximum.

  Liste des noms des flux de travail dans le compte.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, si tous les noms de flux de travail n’ont pas été retournés.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## BatchGetWorkflows action (Python : batch\$1get\$1workflows)
<a name="aws-glue-api-workflow-BatchGetWorkflows"></a>

Retourne la liste des métadonnées de ressource pour une liste donnée de noms de flux de travail. Après avoir appelé l’opération `ListWorkflows`, vous pouvez appeler cette opération pour accéder aux données sur lesquelles des autorisations vous ont été octroyées. Cette opération prend en charge toutes les autorisations IAM, y compris les conditions d’autorisation qui utilisent des balises.

**Demande**
+ `Names` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 25 chaînes maximum.

  Liste des noms de flux de travail, qui peuvent être les noms renvoyés à partir de l’opération `ListWorkflows`.
+ `IncludeGraph` : booléen.

  Indique si un graphique doit être inclus lors du renvoi de métadonnées de ressource de flux de travail.

**Réponse**
+ `Workflows` – tableau d’objets [Flux de travail](#aws-glue-api-workflow-Workflow), avec 1 structure minimum et 25 structures maximum.

  Liste de métadonnées de ressource de flux de travail.
+ `MissingWorkflows` – tableau de chaînes UTF-8, avec 1 chaîne minimum et 25 chaînes maximum.

  Liste des noms de flux de travail non trouvés.

**Erreurs**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`

## GetWorkflowRun action (Python : get\$1workflow\$1run)
<a name="aws-glue-api-workflow-GetWorkflowRun"></a>

Extrait les métadonnées pour une exécution de flux de travail donnée. L’historique d’exécution des tâches est accessible pendant 90 jours pour votre flux de travail et l’exécution des tâches.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du flux de travail en cours d’exécution.
+ `RunId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de l’exécution de flux de travail.
+ `IncludeGraph` : booléen.

  Indique si le graphique de flux de travail doit être inclus en réponse ou non.

**Réponse**
+ `Run` – Un objet [WorkflowRun](#aws-glue-api-workflow-WorkflowRun).

  Métadonnées d’exécution de flux de travail demandées.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetWorkflowRuns action (Python : get\$1workflow\$1runs)
<a name="aws-glue-api-workflow-GetWorkflowRuns"></a>

Extrait les métadonnées de toutes les exécutions d’un flux de travail donné.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du flux de travail dont les métadonnées des exécutions doivent être renvoyées.
+ `IncludeGraph` : booléen.

  Indique si le graphique de flux de travail doit être inclus en réponse ou non.
+ `NextToken` – Chaîne UTF-8.

  Taille maximale de la réponse.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximal d’exécutions de flux de travail à inclure dans la réponse.

**Réponse**
+ `Runs` – tableau d’objets [WorkflowRun](#aws-glue-api-workflow-WorkflowRun), avec 1 structure minimum et 1 000 structures maximum.

  Liste d’objets des métadonnées d’exécution de flux de travail.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, si toutes les exécutions de tâche demandées ne sont pas renvoyées.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetWorkflowRunProperties action (Python : get\$1workflow\$1run\$1properties)
<a name="aws-glue-api-workflow-GetWorkflowRunProperties"></a>

Extrait les propriétés d’exécution de flux de travail qui ont été définies au cours de l’exécution.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du flux de travail qui a été exécuté.
+ `RunId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de l’exécution de flux de travail dont les propriétés d’exécution doivent être renvoyées.

**Réponse**
+ `RunProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8.

  Propriétés d’exécution de flux de travail qui ont été définies au cours de l’exécution spécifiée.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## PutWorkflowRunProperties action (Python : put\$1workflow\$1run\$1properties)
<a name="aws-glue-api-workflow-PutWorkflowRunProperties"></a>

Place les propriétés d’exécution de flux de travail spécifiées pour l’exécution de flux de travail donnée. Si une propriété existe déjà pour l’exécution spécifiée, elle remplace la valeur et ajoute la propriété aux propriétés existantes.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du flux de travail qui a été exécuté.
+ `RunId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de l’exécution de flux de travail pour laquelle les propriétés d’exécution doivent être mises à jour.
+ `RunProperties` – *obligatoire :* tableau de mappage de paires clé-valeur.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8.

  Propriétés à placer pour l’exécution spécifiée.

  Les propriétés d’exécution peuvent être journalisées. Ne transmettez pas de secrets en texte clair comme propriétés. Récupérez les secrets d'une AWS Glue connexion, d'un Gestionnaire de AWS Secrets ou d'un autre mécanisme de gestion des secrets si vous avez l'intention de les utiliser dans le cadre de l'exécution du flux de travail.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `AlreadyExistsException`
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentModificationException`

## CreateBlueprint action (Python : créer\$1blueprint)
<a name="aws-glue-api-workflow-CreateBlueprint"></a>

Enregistre un plan avec AWS Glue.

**Demande**
+ `Name` – *obligatoire :* chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Nom du plan.
+ `Description` – chaîne UTF-8, d'une longueur comprise entre 1 et 512 octets.

  Description du plan.
+ `BlueprintLocation` – *obligatoire :* chaîne UTF-8, d’une longueur comprise entre 1 et 8 192 octets, correspondant au [Custom string pattern #32](aws-glue-api-common.md#regex_32).

  Spécifie un chemin dans Amazon S3 où le plan est publié.
+ `Tags` – tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Balises à appliquer à ce plan.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Renvoie le nom du plan qui a été enregistré.

**Erreurs**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `ResourceNumberLimitExceededException`

## UpdateBlueprint action (Python : update\$1blueprint)
<a name="aws-glue-api-workflow-UpdateBlueprint"></a>

Met à jour un plan enregistré.

**Demande**
+ `Name` – *obligatoire :* chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Nom du plan.
+ `Description` – chaîne UTF-8, d'une longueur comprise entre 1 et 512 octets.

  Description du plan.
+ `BlueprintLocation` – *obligatoire :* chaîne UTF-8, d’une longueur comprise entre 1 et 8 192 octets, correspondant au [Custom string pattern #32](aws-glue-api-common.md#regex_32).

  Spécifie un chemin dans Amazon S3 où le plan est publié.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Renvoie le nom du plan qui a été mis à jour.

**Erreurs**
+ `EntityNotFoundException`
+ `ConcurrentModificationException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `IllegalBlueprintStateException`

## DeleteBlueprint action (Python : delete\$1blueprint)
<a name="aws-glue-api-workflow-DeleteBlueprint"></a>

Supprime un plan existant.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du plan à supprimer.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Renvoie le nom du plan qui a été supprimé.

**Erreurs**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## ListBlueprints action (Python : list\$1blueprints)
<a name="aws-glue-api-workflow-ListBlueprints"></a>

Répertorie tous les noms de plan d’un compte.

**Demande**
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’une requête de continuation.
+ `MaxResults`— Nombre (entier), pas moins de 1 ou plus de 25.

  La taille maximale d’une liste à renvoyer.
+ `Tags` – tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Filtre la liste en fonction d'une balise de AWS ressource.

**Réponse**
+ `Blueprints` – Tableau de chaînes UTF-8.

  Liste des noms des plans dans le compte.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, si tous les noms de plan n’ont pas été renvoyés.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## BatchGetBlueprints action (Python : batch\$1get\$1blueprints)
<a name="aws-glue-api-workflow-BatchGetBlueprints"></a>

Extrait des informations sur une liste de plans.

**Demande**
+ `Names` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 25 chaînes maximum.

  Une liste de noms de plan.
+ `IncludeBlueprint` : booléen.

  Indique si le plan doit être inclus dans la réponse ou non.
+ `IncludeParameterSpec` : booléen.

  Spécifie s’il faut ou non inclure les paramètres, sous forme de chaîne JSON, pour le plan dans la réponse.

**Réponse**
+ `Blueprints` : un tableau d’objets [Plan ](#aws-glue-api-workflow-Blueprint).

  Renvoie la liste des plans sous forme d’objet `Blueprints`.
+ `MissingBlueprints` – Tableau de chaînes UTF-8.

  Renvoie une liste de `BlueprintNames` qui ont été introuvables.

**Erreurs**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`

## StartBlueprintRun action (Python : start\$1blueprint\$1run)
<a name="aws-glue-api-workflow-StartBlueprintRun"></a>

Démarre une nouvelle exécution du plan spécifié.

**Demande**
+ `BlueprintName` – *obligatoire :* chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Nom du plan.
+ `Parameters` – chaîne UTF-8, d'une longueur comprise entre 1 et 131 072 octets.

  Spécifie les paramètres en tant qu’objet `BlueprintParameters`.
+ `RoleArn` – *Obligatoire :* chaîne UTF-8, d’une longueur comprise entre 1 et 1024 octets, correspondant au [Custom string pattern #30](aws-glue-api-common.md#regex_30).

  Spécifie le rôle IAM utilisé pour créer le flux de travail.

**Réponse**
+ `RunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID d’exécution de cette exécution de plan.

**Erreurs**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `ResourceNumberLimitExceededException`
+ `EntityNotFoundException`
+ `IllegalBlueprintStateException`

## GetBlueprintRun action (Python : get\$1blueprint\$1run)
<a name="aws-glue-api-workflow-GetBlueprintRun"></a>

Récupère les détails d’une exécution de plan.

**Demande**
+ `BlueprintName` – *obligatoire :* chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #31](aws-glue-api-common.md#regex_31).

  Nom du plan.
+ `RunId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID d’exécution de l’exécution de plan que vous souhaitez récupérer.

**Réponse**
+ `BlueprintRun` – Un objet [BlueprintRun](#aws-glue-api-workflow-BlueprintRun).

  Renvoie un objet `BlueprintRun`.

**Erreurs**
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetBlueprintRuns action (Python : get\$1blueprint\$1runs)
<a name="aws-glue-api-workflow-GetBlueprintRuns"></a>

Récupère les détails des exécutions de plan pour un plan spécifié.

**Demande**
+ `BlueprintName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du plan.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’une requête de continuation.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  La taille maximale d’une liste à renvoyer.

**Réponse**
+ `BlueprintRuns` : un tableau d’objets [BlueprintRun](#aws-glue-api-workflow-BlueprintRun).

  Envoie la liste des objets `BlueprintRun`.
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, si toutes les exécutions de plan ne sont pas renvoyées.

**Erreurs**
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`

## StartWorkflowRun action (Python : start\$1workflow\$1run)
<a name="aws-glue-api-workflow-StartWorkflowRun"></a>

Démarre une nouvelle exécution du flux de travail spécifié.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du flux de travail à démarrer.
+ `RunProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne UTF-8.

  Les propriétés d’exécution de flux de travail pour la nouvelle exécution de flux de travail.

  Les propriétés d’exécution peuvent être journalisées. Ne transmettez pas de secrets en texte clair comme propriétés. Récupérez les secrets d'une AWS Glue connexion, d'un Gestionnaire de AWS Secrets ou d'un autre mécanisme de gestion des secrets si vous avez l'intention de les utiliser dans le cadre de l'exécution du flux de travail.

**Réponse**
+ `RunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID pour la nouvelle exécution.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentRunsExceededException`

## StopWorkflowRun action (Python : stop\$1workflow\$1run)
<a name="aws-glue-api-workflow-StopWorkflowRun"></a>

Arrête l’exécution du cycle de flux de travail spécifié.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du flux de travail à arrêter.
+ `RunId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de du cycle de flux de travail à arrêter.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `IllegalWorkflowStateException`

## ResumeWorkflowRun action (Python : resume\$1workflow\$1run)
<a name="aws-glue-api-workflow-ResumeWorkflowRun"></a>

Redémarre les nœuds sélectionnés d’une précédente exécution de flux de travail partiellement terminée et reprend l’exécution de flux de travail. Les nœuds sélectionnés et tous les nœuds en aval des nœuds sélectionnés sont exécutés.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du flux de travail à reprendre.
+ `RunId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de l’exécution du flux de travail à reprendre.
+ `NodeIds` – *obligatoire :* tableau de chaînes UTF-8.

  Liste IDs des nœuds que vous souhaitez redémarrer. Les nœuds qui doivent être redémarrés doivent avoir une tentative d’exécution dans l’exécution d’origine.

**Réponse**
+ `RunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nouvel ID attribué à l’exécution de flux de travail reprise. Chaque résumé d’exécution de flux de travail aura un nouvel ID d’exécution.
+ `NodeIds` – Tableau de chaînes UTF-8.

  Liste des nœuds IDs qui ont été réellement redémarrés.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentRunsExceededException`
+ `IllegalWorkflowStateException`

# Profils d'utilisation
<a name="aws-glue-api-usage-profiles"></a>

L'API des profils d'utilisation décrit les types de données et l'API liés à la création, à la mise à jour ou à l'affichage des profils d'utilisation dans AWS Glue.

## Types de données
<a name="aws-glue-api-usage-profiles-objects"></a>
+ [ProfileConfiguration structure](#aws-glue-api-usage-profiles-ProfileConfiguration)
+ [ConfigurationObject structure](#aws-glue-api-usage-profiles-ConfigurationObject)
+ [UsageProfileDefinition structure](#aws-glue-api-usage-profiles-UsageProfileDefinition)

## ProfileConfiguration structure
<a name="aws-glue-api-usage-profiles-ProfileConfiguration"></a>

Spécifie les valeurs de tâche et de session qu'un administrateur configure dans un profil AWS Glue d'utilisation.

**Champs**
+ `SessionConfiguration` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est un objet [ConfigurationObject](#aws-glue-api-usage-profiles-ConfigurationObject).

  Une carte clé-valeur des paramètres de configuration pour AWS Glue les sessions. 
+ `JobConfiguration` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est un objet [ConfigurationObject](#aws-glue-api-usage-profiles-ConfigurationObject).

  Une carte clé-valeur des paramètres de configuration pour AWS Glue les tâches. 

## ConfigurationObject structure
<a name="aws-glue-api-usage-profiles-ConfigurationObject"></a>

Spécifie les valeurs définies par un administrateur pour chaque paramètre de tâche ou de session configuré dans un profil AWS Glue d'utilisation.

**Champs**
+ `DefaultValue` – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #35](aws-glue-api-common.md#regex_35).

  Valeur par défaut du paramètre.
+ `AllowedValues` – Tableau de chaînes UTF-8.

  Liste de valeurs autorisées pour le paramètre.
+ `MinValue` – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #35](aws-glue-api-common.md#regex_35).

  Valeur minimale autorisée pour le paramètre.
+ `MaxValue` – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au [Custom string pattern #35](aws-glue-api-common.md#regex_35).

  Valeur maximale autorisée pour le paramètre.

## UsageProfileDefinition structure
<a name="aws-glue-api-usage-profiles-UsageProfileDefinition"></a>

Décrit un profil AWS Glue d'utilisation.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du profil d’utilisation.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description du profil d’utilisation.
+ `CreatedOn` – Horodatage.

  Date et heure de la création du profil d’utilisation.
+ `LastModifiedOn` – Horodatage.

  Date et heure auxquelles le profil d’utilisation a été modifié pour la dernière fois.

## Opérations
<a name="aws-glue-api-usage-profiles-actions"></a>
+ [CreateUsageProfile action (Python : create\$1usage\$1profile)](#aws-glue-api-usage-profiles-CreateUsageProfile)
+ [GetUsageProfile action (Python : get\$1usage\$1profile)](#aws-glue-api-usage-profiles-GetUsageProfile)
+ [UpdateUsageProfile action (Python : update\$1usage\$1profile)](#aws-glue-api-usage-profiles-UpdateUsageProfile)
+ [DeleteUsageProfile action (Python : delete\$1usage\$1profile)](#aws-glue-api-usage-profiles-DeleteUsageProfile)
+ [ListUsageProfiles action (Python : list\$1usage\$1profiles)](#aws-glue-api-usage-profiles-ListUsageProfiles)

## CreateUsageProfile action (Python : create\$1usage\$1profile)
<a name="aws-glue-api-usage-profiles-CreateUsageProfile"></a>

Crée un profil AWS Glue d'utilisation.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du profil d’utilisation.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description du profil d’utilisation.
+ `Configuration` – *Obligatoire :* un objet [ProfileConfiguration](#aws-glue-api-usage-profiles-ProfileConfiguration).

  Objet `ProfileConfiguration` spécifiant les valeurs de tâche et de session pour le profil.
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Liste de balises appliquées au profil d’utilisation.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du profil d’utilisation créé.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `AlreadyExistsException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `OperationNotSupportedException`

## GetUsageProfile action (Python : get\$1usage\$1profile)
<a name="aws-glue-api-usage-profiles-GetUsageProfile"></a>

Récupère les informations relatives au profil AWS Glue d'utilisation spécifié.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du profil d’utilisation à récupérer.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du profil d’utilisation.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description du profil d’utilisation.
+ `Configuration` – Un objet [ProfileConfiguration](#aws-glue-api-usage-profiles-ProfileConfiguration).

  Objet `ProfileConfiguration` spécifiant les valeurs de tâche et de session pour le profil.
+ `CreatedOn` – Horodatage.

  Date et heure de la création du profil d’utilisation.
+ `LastModifiedOn` – Horodatage.

  Date et heure auxquelles le profil d’utilisation a été modifié pour la dernière fois.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `OperationNotSupportedException`

## UpdateUsageProfile action (Python : update\$1usage\$1profile)
<a name="aws-glue-api-usage-profiles-UpdateUsageProfile"></a>

Mettez à jour un profil AWS Glue d'utilisation.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du profil d’utilisation.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description du profil d’utilisation.
+ `Configuration` – *Obligatoire :* un objet [ProfileConfiguration](#aws-glue-api-usage-profiles-ProfileConfiguration).

  Objet `ProfileConfiguration` spécifiant les valeurs de tâche et de session pour le profil.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du profil d’utilisation qui a été mis à jour.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `OperationNotSupportedException`
+ `ConcurrentModificationException`

## DeleteUsageProfile action (Python : delete\$1usage\$1profile)
<a name="aws-glue-api-usage-profiles-DeleteUsageProfile"></a>

Supprime le profil d'utilisation AWS Glue spécifié.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du profil d’utilisation à supprimer.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `OperationNotSupportedException`

## ListUsageProfiles action (Python : list\$1usage\$1profiles)
<a name="aws-glue-api-usage-profiles-ListUsageProfiles"></a>

Répertoriez tous les profils AWS Glue d'utilisation.

**Demande**
+ `NextToken` – Chaîne UTF-8, d'une longueur maximale de 400 000 octets.

  Jeton de continuation, inclus s’il s’agit d’un appel de continuation.
+ `MaxResults`— Nombre (entier), pas moins de 1 ou plus de 200.

  Nombre maximal de profils d’utilisation à renvoyer dans une seule réponse.

**Réponse**
+ `Profiles` : un tableau d’objets [UsageProfileDefinition](#aws-glue-api-usage-profiles-UsageProfileDefinition).

  Liste des objets du profil d’utilisation (`UsageProfileDefinition`).
+ `NextToken` – Chaîne UTF-8, d'une longueur maximale de 400 000 octets.

  Jeton de continuation, présent si le segment de liste actuel n'est pas le dernier.

**Erreurs**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `OperationNotSupportedException`

# API de Machine Learning
<a name="aws-glue-api-machine-learning-api"></a>

L’API Machine learning décrit les types de données du machine learning et inclut l’API de création, suppression ou mise à jour d’une transformation, ou de démarrage de l’exécution d’une tâche de machine learning.

## Types de données
<a name="aws-glue-api-machine-learning-api-objects"></a>
+ [TransformParameters structure](#aws-glue-api-machine-learning-api-TransformParameters)
+ [EvaluationMetrics structure](#aws-glue-api-machine-learning-api-EvaluationMetrics)
+ [MLTransform structure](#aws-glue-api-machine-learning-api-MLTransform)
+ [FindMatchesParameters structure](#aws-glue-api-machine-learning-api-FindMatchesParameters)
+ [FindMatchesMetrics structure](#aws-glue-api-machine-learning-api-FindMatchesMetrics)
+ [ConfusionMatrix structure](#aws-glue-api-machine-learning-api-ConfusionMatrix)
+ [GlueTable structure](#aws-glue-api-machine-learning-api-GlueTable)
+ [TaskRun structure](#aws-glue-api-machine-learning-api-TaskRun)
+ [TransformFilterCriteria structure](#aws-glue-api-machine-learning-api-TransformFilterCriteria)
+ [TransformSortCriteria structure](#aws-glue-api-machine-learning-api-TransformSortCriteria)
+ [TaskRunFilterCriteria structure](#aws-glue-api-machine-learning-api-TaskRunFilterCriteria)
+ [TaskRunSortCriteria structure](#aws-glue-api-machine-learning-api-TaskRunSortCriteria)
+ [TaskRunProperties structure](#aws-glue-api-machine-learning-api-TaskRunProperties)
+ [FindMatchesTaskRunProperties structure](#aws-glue-api-machine-learning-api-FindMatchesTaskRunProperties)
+ [ImportLabelsTaskRunProperties structure](#aws-glue-api-machine-learning-api-ImportLabelsTaskRunProperties)
+ [ExportLabelsTaskRunProperties structure](#aws-glue-api-machine-learning-api-ExportLabelsTaskRunProperties)
+ [LabelingSetGenerationTaskRunProperties structure](#aws-glue-api-machine-learning-api-LabelingSetGenerationTaskRunProperties)
+ [SchemaColumn structure](#aws-glue-api-machine-learning-api-SchemaColumn)
+ [TransformEncryption structure](#aws-glue-api-machine-learning-api-TransformEncryption)
+ [MLUserDataEncryption structure](#aws-glue-api-machine-learning-api-MLUserDataEncryption)
+ [ColumnImportance structure](#aws-glue-api-machine-learning-api-ColumnImportance)

## TransformParameters structure
<a name="aws-glue-api-machine-learning-api-TransformParameters"></a>

Paramètres propres à l’algorithme associés à la transformation Machine Learning.

**Champs**
+ `TransformType` – *Obligatoire* : Chaîne UTF-8 (valeurs valides : `FIND_MATCHES`).

  Type de transformation du Machine Learning.

  Pour de plus amples informations sur les types de transformation du Machine Learning, veuillez consulter [Création de transformations du Machine Learning](https://docs.aws.amazon.com/glue/latest/dg/add-job-machine-learning-transform.html).
+ `FindMatchesParameters` – Un objet [FindMatchesParameters](#aws-glue-api-machine-learning-api-FindMatchesParameters).

  Paramètres de l’algorithme de recherche de correspondances.

## EvaluationMetrics structure
<a name="aws-glue-api-machine-learning-api-EvaluationMetrics"></a>

Les métriques d'évaluation fournissent une estimation de la qualité de votre transformation du Machine Learning.

**Champs**
+ `TransformType` – *Obligatoire* : Chaîne UTF-8 (valeurs valides : `FIND_MATCHES`).

  Type de transformation du Machine Learning.
+ `FindMatchesMetrics` – Un objet [FindMatchesMetrics](#aws-glue-api-machine-learning-api-FindMatchesMetrics).

  Métriques d'évaluation de l'algorithme de recherche de correspondances.

## MLTransform structure
<a name="aws-glue-api-machine-learning-api-MLTransform"></a>

Structure d’une transformation du Machine Learning.

**Champs**
+ `TransformId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de transformation unique généré pour la transformation du Machine Learning. L’ID est garanti être unique et ne pas changer.
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom défini par l’utilisateur de la transformation Machine Learning. Les noms ne sont pas garantis être uniques et peuvent être modifiés à tout moment.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Longue description définie par l’utilisateur de la transformation Machine Learning. Les descriptions ne sont pas garanties être uniques et peuvent être modifiées à tout moment.
+ `Status` – Chaîne UTF-8 (valeurs valides : `NOT_READY` \$1 `READY` \$1 `DELETING`).

  Statut actuel de la transformation du Machine Learning.
+ `CreatedOn` – Horodatage.

  Horodatage. Heure et date auxquelles la transformation du Machine Learning a été créée.
+ `LastModifiedOn` – Horodatage.

  Horodatage. Dernier moment auquel cette transformation du Machine Learning a été modifiée.
+ `InputRecordTables` – Un tableau d'objets [GlueTable](#aws-glue-api-machine-learning-api-GlueTable), 10 structures au maximum.

  Liste des définitions de AWS Glue table utilisées par la transformation.
+ `Parameters` – Un objet [TransformParameters](#aws-glue-api-machine-learning-api-TransformParameters).

  Un objet `TransformParameters`. Vous pouvez utiliser des paramètres pour ajuster (personnaliser) le comportement de la transformation du Machine Learning : à cette fin, spécifiez les données apprises du Machine Learning, ainsi que vos préférences quant aux différents compromis à faire (valeur versus rappel, ou précision versus coût, par exemple).
+ `EvaluationMetrics` – Un objet [EvaluationMetrics](#aws-glue-api-machine-learning-api-EvaluationMetrics).

  Un objet `EvaluationMetrics`. Les métriques d'évaluation fournissent une estimation de la qualité de votre transformation du Machine Learning.
+ `LabelCount` : nombre (entier).

  Identifiant de comptage pour les fichiers d'étiquetage générés par AWS Glue cette transformation. Au fur et à mesure que vous créez une transformation de meilleure qualité, vous pouvez, de manière itérative, télécharger, étiqueter et charger le fichier d’étiquetage.
+ `Schema` – Un tableau d'objets [SchemaColumn](#aws-glue-api-machine-learning-api-SchemaColumn), 100 structures au maximum.

  Carte de paires clé-valeur correspondant aux colonnes et aux types de données sur lesquels la transformation peut s’exécuter. Comporte une limite supérieure de 100 colonnes.
+ `Role` – Chaîne UTF-8.

  Nom ou Amazon Resource Name (ARN) du rôle IAM avec les autorisations requises. Les autorisations requises incluent à la fois les autorisations de rôle de AWS Glue service sur les AWS Glue ressources et les autorisations Amazon S3 requises par la transformation. 
  + Ce rôle nécessite des autorisations AWS Glue de rôle de service pour autoriser l'accès aux ressources dans AWS Glue. Veuillez consulter la rubrique [Attacher une politique aux utilisateurs IAM accédant à AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/attach-policy-iam-user.html).
  + Ce rôle a besoin d'une autorisation pour vos sources, vos cibles, votre répertoire temporaire et vos scripts Amazon Simple Storage Service (Amazon S3), ainsi que pour les bibliothèques utilisées par l'exécution de la tâche dans le cadre de cette transformation.
+ `GlueVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Cette valeur détermine la version compatible avec laquelle AWS Glue cette transformation de machine learning est compatible. Glue 1.0 est recommandé pour la plupart des clients. Si la valeur n'est pas définie, la compatibilité Glue par défaut est Glue 0.9. Pour plus d'informations, veuillez consulter la rubrique [Versions AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html#release-notes-versions) dans le guide du développeur.
+ `MaxCapacity` – Nombre (double).

  Nombre d'unités de traitement de AWS Glue données (DPUs) allouées aux exécutions de tâches pour cette transformation. Vous pouvez allouer de 2 à 100 DPUs ; la valeur par défaut est 10. Un DPU est une mesure relative de la puissance de traitement composée de 4 V de capacité CPUs de calcul et de 16 Go de mémoire. Pour plus d'informations, consultez la page de tarification [AWS Glue](https://aws.amazon.com/glue/pricing/). 

  `MaxCapacity` est une option mutuellement exclusive avec `NumberOfWorkers` et `WorkerType`.
  + Si `NumberOfWorkers` ou `WorkerType` est défini, ne `MaxCapacity` peut pas être défini.
  + Si `MaxCapacity` est défini, ni `NumberOfWorkers` ni `WorkerType` ne peuvent être définis.
  + Si `WorkerType` est défini, `NumberOfWorkers` est obligatoire (et inversement).
  + `MaxCapacity` et `NumberOfWorkers` doivent être au moins égal à 1.

  Lorsque le champ `WorkerType` est défini sur une valeur autre que `Standard`, le champ `MaxCapacity` est défini automatiquement et passe en lecture seule.
+ `WorkerType` – Chaîne UTF-8 (valeurs valides: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  Type d’exécuteur prédéfini qui est alloué lorsqu’une tâche de cette transformation s’exécute. Accepte la valeur Standard, G.1X ou G.2X.
  + Pour le type de travail `Standard`, chaque travail fournit 4 vCPU, 16 Go de mémoire et 50 Go de disque, ainsi que 2 exécuteurs par travail.
  + Pour le type de travail `G.1X`, chaque travail fournit 4 vCPU, 16 Go de mémoire et 64 Go de disque, ainsi que 1 exécuteur par travail.
  + Pour le type de travail `G.2X`, chaque travail fournit 8 vCPU, 32 Go de mémoire et 128 Go de disque, ainsi que 1 exécuteur par travail.

  `MaxCapacity` est une option mutuellement exclusive avec `NumberOfWorkers` et `WorkerType`.
  + Si `NumberOfWorkers` ou `WorkerType` est défini, ne `MaxCapacity` peut pas être défini.
  + Si `MaxCapacity` est défini, ni `NumberOfWorkers` ni `WorkerType` ne peuvent être définis.
  + Si `WorkerType` est défini, `NumberOfWorkers` est obligatoire (et inversement).
  + `MaxCapacity` et `NumberOfWorkers` doivent être au moins égal à 1.
+ `NumberOfWorkers` : nombre (entier).

  Nombre d’exécuteurs d’un `workerType` défini qui sont alloués lorsqu’une tâche de la transformation s’exécute.

  Si `WorkerType` est défini, `NumberOfWorkers` est obligatoire (et inversement).
+ `Timeout` – Nombre (entier), au moins égal à 1.

  Délai d’expiration en minutes de la transformation Machine Learning.
+ `MaxRetries` : nombre (entier).

  Nombre maximal de tentatives autorisées après l’échec d’une exécution `MLTaskRun` de la transformation Machine Learning.
+ `TransformEncryption` – Un objet [TransformEncryption](#aws-glue-api-machine-learning-api-TransformEncryption).

  Les encryption-at-rest paramètres de la transformation qui s'appliquent à l'accès aux données utilisateur. Les transformations de machine learning peuvent accéder aux données utilisateur chiffrées dans Amazon S3 à l'aide de KMS.

## FindMatchesParameters structure
<a name="aws-glue-api-machine-learning-api-FindMatchesParameters"></a>

Paramètres de configuration de la transformation de la recherche des correspondances.

**Champs**
+ `PrimaryKeyColumnName` – Chaîne UTF-8, d'une longueur comprise entre 1 et 1024 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom d’une colonne qui identifie de façon unique les lignes de la table source. Utilisé pour vous aider à identifier les enregistrements correspondants.
+ `PrecisionRecallTradeoff` – Nombre (double), au plus égal à 1,0.

  Valeur sélectionnée lors du paramétrage de votre transformation pour un équilibre entre la précision et le rappel. Une valeur de 0,5 signifie aucune préférence ; une valeur de 1.0 signifie un écart uniquement pour la précision, et une valeur de 0,0 un écart pour le rappel. Comme il s’agit d’un compromis, le choix de valeurs proches de 1.0 signifie un rappel très faible et le choix de valeurs proches de 0.0 une très faible précision.

  La précision métrique indique la fréquence à laquelle votre modèle est correct lorsqu’il prédit une correspondance. 

  La métrique de rappel indique que pour une correspondance réelle, la fréquence à laquelle votre modèle prédit la correspondance.
+ `AccuracyCostTradeoff` – Nombre (double), au plus égal à 1,0.

  Valeur sélectionnée lors du paramétrage de votre transformation pour un équilibre entre la précision et le coût. Une valeur de 0,5 signifie que le système équilibre les préoccupations de précision et de coût. Une valeur de 1.0 signifie un biais uniquement pour la précision, ce qui entraîne généralement un coût plus élevé, et parfois beaucoup plus élevé. Une valeur de 0,0 signifie un biais uniquement pour le coût, ce qui se traduit par une transformation `FindMatches` moins précise, et parfois une précision inacceptable.

  La précision mesure la façon dont la transformation trouve les vrais positifs et les vrais négatifs. L’augmentation de la précision nécessite plus de ressources machine et des coûts supérieurs. Mais elle entraîne également une augmentation du rappel. 

  Le coût mesure le nombre de ressources de calcul, et donc le montant, consommées pour exécuter la transformation.
+ `EnforceProvidedLabels` : booléen.

  La valeur à activer ou désactiver pour forcer la sortie afin qu’elle corresponde aux étiquettes fournies par les utilisateurs. Si la valeur est `True`, la transformation `find matches` oblige la sortie à correspondre aux étiquettes fournies. Les résultats remplacent les résultats de combinaison normaux. Si la valeur est `False`, la transformation `find matches` ne garantit pas que toutes les étiquettes fournies sont respectées, et les résultats s’appuient sur le modèle formé.

  Notez que la définition de cette valeur sur true peut augmenter la durée d’exécution de la combinaison.

## FindMatchesMetrics structure
<a name="aws-glue-api-machine-learning-api-FindMatchesMetrics"></a>

Métriques d'évaluation de l'algorithme de recherche de correspondances. La qualité de votre transformation Machine Learning est mesurée en obtenant que votre transformation prédise certaines correspondances et en comparant les résultats pour connaître les correspondances du même jeu de données. Les métriques de qualité sont basées sur un sous-ensemble de vos données, afin qu’ils ne soient pas précis.

**Champs**
+ `AreaUnderPRCurve` – Nombre (double), au plus égal à 1,0.

  L'aire sous la precision/recall courbe (AUPRC) est un nombre unique qui mesure la qualité globale de la transformation, indépendamment du choix fait entre précision et rappel. Les valeurs élevées indiquent que vous avez un compromis précision vs. rappel plus attrayant.

  Pour en savoir plus, consultez [Précision et rappel](https://en.wikipedia.org/wiki/Precision_and_recall) dans Wikipédia.
+ `Precision` – Nombre (double), au plus égal à 1,0.

  La précision métrique indique à quelle fréquence votre transformation est correcte lorsqu’elle prédit une correspondance. Plus précisément, elle évalue la fréquence à laquelle la transformation trouve de vrais positifs à partir du total de vrais positifs possible.

  Pour en savoir plus, consultez [Précision et rappel](https://en.wikipedia.org/wiki/Precision_and_recall) dans Wikipédia.
+ `Recall` – Nombre (double), au plus égal à 1,0.

  La sensibilité métrique indique pour une correspondance réelle, la fréquence à laquelle votre transformation prédit la correspondance. Plus précisément, elle évalue la fréquence à laquelle la transformation trouve de vrais positifs à partir du total des enregistrements de la source de données.

  Pour en savoir plus, consultez [Précision et rappel](https://en.wikipedia.org/wiki/Precision_and_recall) dans Wikipédia.
+ `F1` – Nombre (double), au plus égal à 1,0.

  La métrique F1 maximale indique la précision de la transformation entre 0 et 1, où 1 est la meilleure précision.

  Pour plus d'informations, consultez la page Wikipedia relative au [score F1](https://en.wikipedia.org/wiki/F1_score).
+ `ConfusionMatrix` – Un objet [ConfusionMatrix](#aws-glue-api-machine-learning-api-ConfusionMatrix).

  La matrice de confusion vous explique ce que votre transformation prédit avec précision et quels types d'erreurs elle effectue.

  Pour plus d'informations, consultez [Matrice de confusion](https://en.wikipedia.org/wiki/Confusion_matrix) dans Wikipédia.
+ `ColumnImportances` – Un tableau d'objets [ColumnImportance](#aws-glue-api-machine-learning-api-ColumnImportance), 100 structures au maximum.

  Une liste de structures `ColumnImportance` contenant des métriques d’importance de colonne, triées par ordre d’importance décroissant.

## ConfusionMatrix structure
<a name="aws-glue-api-machine-learning-api-ConfusionMatrix"></a>

La matrice de confusion vous explique ce que votre transformation prédit avec précision et quels types d'erreurs elle effectue.

Pour plus d'informations, consultez [Matrice de confusion](https://en.wikipedia.org/wiki/Confusion_matrix) dans Wikipédia.

**Champs**
+ `NumTruePositives` – Nombre (long).

  Nombre de correspondances dans les données que la transformation a trouvées correctement, dans la matrice de confusion de votre transformation.
+ `NumFalsePositives` – Nombre (long).

  Le nombre de non-correspondances dans les données que la transformation a classées de manière incorrecte comme correspondance, dans la matrice de confusion de votre transformation.
+ `NumTrueNegatives` – Nombre (long).

  Nombre de non-correspondances dans les données que la transformation a rejetées correctement, dans la matrice de confusion de votre transformation.
+ `NumFalseNegatives` – Nombre (long).

  Nombre de correspondances dans les données que la transformation n’a pas trouvées, dans la matrice de confusion de votre transformation.

## GlueTable structure
<a name="aws-glue-api-machine-learning-api-GlueTable"></a>

Base de données et table utilisées pour AWS Glue Data Catalog les données d'entrée ou de sortie.

**Champs**
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données dans le AWS Glue Data Catalog.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table dans AWS Glue Data Catalog.
+ `CatalogId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique pour AWS Glue Data Catalog.
+ `ConnectionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la connexion à AWS Glue Data Catalog.
+ `AdditionalOptions` – Tableau de mappage de paires valeur-clé, pas moins de 1 ou plus de 10 paires..

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne Description, d’une longueur ne dépassant pas 2048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Options supplémentaires pour la table. Actuellement, deux clés sont prises en charge :
  + `pushDownPredicate` : pour filtrer les partitions sans avoir à répertorier ni lire tous les fichiers de votre jeu de données.
  + `catalogPartitionPredicate` : pour utiliser le nettoyage de partition côté serveur à l’aide des index de partition du AWS Glue Data Catalog.

## TaskRun structure
<a name="aws-glue-api-machine-learning-api-TaskRun"></a>

Paramètres d’échantillonnage qui sont associés à la transformation du Machine Learning.

**Champs**
+ `TransformId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la transformation.
+ `TaskRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la tâche exécutée.
+ `Status` – Chaîne UTF-8 (valeurs valides : `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  Statut actuel de la tâche demandée.
+ `LogGroupName` – Chaîne UTF-8.

  Nom du groupe de journaux pour une journalisation sécurisée, associée à la tâche exécutée.
+ `Properties` – Un objet [TaskRunProperties](#aws-glue-api-machine-learning-api-TaskRunProperties).

  Spécifie les propriétés de configuration associées à la tâche exécutée.
+ `ErrorString` – Chaîne UTF-8.

  Liste des chaînes d’erreur associées à la tâche exécutée.
+ `StartedOn` – Horodatage.

  Date et heure auxquelles la tâche exécutée a démarré.
+ `LastModifiedOn` – Horodatage.

  Dernière date de modification de la tâche exécutée demandée.
+ `CompletedOn` – Horodatage.

  Heure à laquelle l’exécution de la tâche demandée s’est terminée.
+ `ExecutionTime` : nombre (entier).

  Durée (en secondes) pendant laquelle la tâche exécutée a consommé des ressources.

## TransformFilterCriteria structure
<a name="aws-glue-api-machine-learning-api-TransformFilterCriteria"></a>

Critères utilisés pour filtrer les transformations du Machine Learning.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de transformation unique qui est utilisé pour filtrer les transformations du Machine Learning.
+ `TransformType` – Chaîne UTF-8 (valeurs valides : `FIND_MATCHES`).

  Type de transformation du Machine Learning utilisé pour filtrer les transformations du Machine Learning.
+ `Status` – Chaîne UTF-8 (valeurs valides : `NOT_READY` \$1 `READY` \$1 `DELETING`).

  Filtre la liste des transformations du Machine Learning sur le dernier état connu des transformations (pour indiquer si une transformation peut être utilisée ou non). L'un des états « NOT\$1READY », « READY » ou « DELETING ».
+ `GlueVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Cette valeur détermine la version compatible avec laquelle AWS Glue cette transformation de machine learning est compatible. Glue 1.0 est recommandé pour la plupart des clients. Si la valeur n'est pas définie, la compatibilité Glue par défaut est Glue 0.9. Pour plus d'informations, veuillez consulter la rubrique [Versions AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html#release-notes-versions) dans le guide du développeur.
+ `CreatedBefore` – Horodatage.

  Heure et date avant lesquelles les transformations ont été créées.
+ `CreatedAfter` – Horodatage.

  Heure et date après lesquelles les transformations ont été créées.
+ `LastModifiedBefore` – Horodatage.

  Filtre sur les dernières transformations modifiées avant cette date.
+ `LastModifiedAfter` – Horodatage.

  Filtre sur les dernières transformations modifiées après cette date.
+ `Schema` – Un tableau d'objets [SchemaColumn](#aws-glue-api-machine-learning-api-SchemaColumn), 100 structures au maximum.

  Filtre sur les ensembles de données avec un schéma spécifique. L’objet `Map<Column, Type>` est un tableau de paires clé-valeur qui représente le schéma que cette transformation accepte, où `Column` est le nom d’une colonne, et `Type` le type de données, comme nombre entier ou chaîne. Comporte une limite supérieure de 100 colonnes.

## TransformSortCriteria structure
<a name="aws-glue-api-machine-learning-api-TransformSortCriteria"></a>

Critères de tri associés à la transformation du Machine Learning.

**Champs**
+ `Column` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `NAME` \$1 `TRANSFORM_TYPE` \$1 `STATUS` \$1 `CREATED` \$1 `LAST_MODIFIED`).

  La colonne doit être utilisée dans les critères de tri associés à la transformation du Machine Learning.
+ `SortDirection` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `DESCENDING` \$1 `ASCENDING`).

  La direction de tri doit être utilisée dans les critères de tri associés à la transformation du Machine Learning.

## TaskRunFilterCriteria structure
<a name="aws-glue-api-machine-learning-api-TaskRunFilterCriteria"></a>

Critères utilisés pour filtrer les exécutions de tâche pour la transformation du Machine Learning.

**Champs**
+ `TaskRunType` – Chaîne UTF-8 (valeurs valides : `EVALUATION` \$1 `LABELING_SET_GENERATION` \$1 `IMPORT_LABELS` \$1 `EXPORT_LABELS` \$1 `FIND_MATCHES`).

  Type de tâche exécutée.
+ `Status` – Chaîne UTF-8 (valeurs valides : `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  Statut actuel de la tâche exécutée.
+ `StartedBefore` – Horodatage.

  Filtre sur les exécutions de tâche démarrées avant cette date.
+ `StartedAfter` – Horodatage.

  Filtre sur les exécutions de tâche démarrées après cette date.

## TaskRunSortCriteria structure
<a name="aws-glue-api-machine-learning-api-TaskRunSortCriteria"></a>

Critères de tri utilisés pour trier la liste des exécutions de tâche pour la transformation du Machine Learning.

**Champs**
+ `Column` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `TASK_RUN_TYPE` \$1 `STATUS` \$1 `STARTED`).

  La colonne doit être utilisé pour trier la liste des exécutions de tâche pour la transformation du Machine Learning.
+ `SortDirection` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `DESCENDING` \$1 `ASCENDING`).

  La direction de tri doit être utilisé pour trier la liste des exécutions de tâche pour la transformation du Machine Learning.

## TaskRunProperties structure
<a name="aws-glue-api-machine-learning-api-TaskRunProperties"></a>

Propriétés de configuration pour la tâche exécutée.

**Champs**
+ `TaskType` – Chaîne UTF-8 (valeurs valides : `EVALUATION` \$1 `LABELING_SET_GENERATION` \$1 `IMPORT_LABELS` \$1 `EXPORT_LABELS` \$1 `FIND_MATCHES`).

  Type de tâche exécutée.
+ `ImportLabelsTaskRunProperties` : un objet [ImportLabelsTaskRunProperties](#aws-glue-api-machine-learning-api-ImportLabelsTaskRunProperties).

  Propriétés de configuration d’une exécution de tâche d’importation des étiquettes.
+ `ExportLabelsTaskRunProperties` : un objet [ExportLabelsTaskRunProperties](#aws-glue-api-machine-learning-api-ExportLabelsTaskRunProperties).

  Propriétés de configuration d’une exécution de tâche d’exportation des étiquettes.
+ `LabelingSetGenerationTaskRunProperties` – Un objet [LabelingSetGenerationTaskRunProperties](#aws-glue-api-machine-learning-api-LabelingSetGenerationTaskRunProperties).

  Propriétés de configuration pour une exécution de tâches de génération d’ensemble d’étiquetage.
+ `FindMatchesTaskRunProperties` – Un objet [FindMatchesTaskRunProperties](#aws-glue-api-machine-learning-api-FindMatchesTaskRunProperties).

  Propriétés de configuration pour une exécution de tâche de recherche de correspondances.

## FindMatchesTaskRunProperties structure
<a name="aws-glue-api-machine-learning-api-FindMatchesTaskRunProperties"></a>

Spécifie les propriétés de configuration d’une exécution de tâche de recherche de correspondances.

**Champs**
+ `JobId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de tâche d’une exécution de tâche de recherche de correspondances.
+ `JobName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom attribué à la tâche pour l’exécution de tâche de recherche de correspondances.
+ `JobRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID d’exécution de tâche d’une exécution de tâche de recherche de correspondances.

## ImportLabelsTaskRunProperties structure
<a name="aws-glue-api-machine-learning-api-ImportLabelsTaskRunProperties"></a>

Spécifie les propriétés de configuration d’une exécution de tâche de l’importation des étiquettes.

**Champs**
+ `InputS3Path` – Chaîne UTF-8.

  Chemin Amazon Simple Storage Service (Amazon S3) à partir d’où vous allez importer les étiquettes.
+ `Replace` : booléen.

  Indique si vous souhaitez remplacer vos étiquettes existantes.

## ExportLabelsTaskRunProperties structure
<a name="aws-glue-api-machine-learning-api-ExportLabelsTaskRunProperties"></a>

Spécifie les propriétés de configuration d’une exécution de tâche d’exportation des étiquettes.

**Champs**
+ `OutputS3Path` – Chaîne UTF-8.

  Chemin Amazon Simple Storage Service (Amazon S3) où vous allez exporter les étiquettes.

## LabelingSetGenerationTaskRunProperties structure
<a name="aws-glue-api-machine-learning-api-LabelingSetGenerationTaskRunProperties"></a>

Spécifie les propriétés de configuration pour une exécution de tâches de génération d’ensemble d’étiquetage.

**Champs**
+ `OutputS3Path` – Chaîne UTF-8.

  Chemin Amazon Simple Storage Service (Amazon S3) où vous allez générer l’ensemble d’étiquetage.

## SchemaColumn structure
<a name="aws-glue-api-machine-learning-api-SchemaColumn"></a>

Paire clé-valeur qui représente une colonne et type de données sur lesquels cette transformation peut être exécuté. Le paramètre `Schema` de la `MLTransform` peut contenir jusqu’à 100 de ces structures.

**Champs**
+ `Name` – Chaîne UTF-8, d'une longueur comprise entre 1 et 1024 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de la colonne.
+ `DataType` – Chaîne UTF-8, d’une longueur maximale de 131 072 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Type de données de la colonne.

## TransformEncryption structure
<a name="aws-glue-api-machine-learning-api-TransformEncryption"></a>

Les encryption-at-rest paramètres de la transformation qui s'appliquent à l'accès aux données utilisateur. Les transformations de machine learning peuvent accéder aux données utilisateur chiffrées dans Amazon S3 à l'aide de KMS.

De plus, les étiquettes importées et les transformations formées peuvent désormais être chiffrées à l’aide d’une clé KMS fournie par le client.

**Champs**
+ `MlUserDataEncryption` – Un objet [MLUserDataEncryption](#aws-glue-api-machine-learning-api-MLUserDataEncryption).

  Objet `MLUserDataEncryption` contenant le mode de chiffrement et l’ID de la clé KMS fournie par le client.
+ `TaskRunSecurityConfigurationName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la configuration de sécurité.

## MLUserDataEncryption structure
<a name="aws-glue-api-machine-learning-api-MLUserDataEncryption"></a>

Les encryption-at-rest paramètres de la transformation qui s'appliquent à l'accès aux données utilisateur.

**Champs**
+ `MlUserDataEncryptionMode` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `DISABLED` \$1 `SSE-KMS="SSEKMS"`).

  Mode de chiffrement appliqué aux données utilisateur. Les valeurs valides sont :
  + DISABLED : le chiffrement est désactivé
  + SSEKMS : utilisation du chiffrement côté serveur avec AWS Key Management Service (SSE-KMS) pour les données utilisateur stockées dans Amazon S3.
+ `KmsKeyId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de la clé KMS fournie par le client.

## ColumnImportance structure
<a name="aws-glue-api-machine-learning-api-ColumnImportance"></a>

Structure contenant le nom de colonne et son score d’importance de colonne. 

L’importance des colonnes vous aide à comprendre comment elles contribuent à votre modèle, en identifiant les colonnes de vos enregistrements qui sont plus importantes que les autres.

**Champs**
+ `ColumnName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom d’une colonne.
+ `Importance` – Nombre (double), au plus égal à 1,0.

  Score d’importance de colonne pour la colonne, sous la forme d’une décimale.

## Opérations
<a name="aws-glue-api-machine-learning-api-actions"></a>
+ [Créer une MLTransform action (Python : create\$1ml\$1transform)](#aws-glue-api-machine-learning-api-CreateMLTransform)
+ [MLTransform Action de mise à jour (Python : update\$1ml\$1transform)](#aws-glue-api-machine-learning-api-UpdateMLTransform)
+ [MLTransform Action de suppression (Python : delete\$1ml\$1transform)](#aws-glue-api-machine-learning-api-DeleteMLTransform)
+ [Obtenir une MLTransform action (Python : get\$1ml\$1transform)](#aws-glue-api-machine-learning-api-GetMLTransform)
+ [Obtenir une MLTransforms action (Python : get\$1ml\$1transform)](#aws-glue-api-machine-learning-api-GetMLTransforms)
+ [MLTransforms Action de liste (Python : list\$1ml\$1transform)](#aws-glue-api-machine-learning-api-ListMLTransforms)
+ [Lancer MLEvaluation TaskRun l'action (Python : start\$1ml\$1evaluation\$1task\$1run)](#aws-glue-api-machine-learning-api-StartMLEvaluationTaskRun)
+ [Lancer MLLabeling SetGenerationTaskRun l'action (Python : start\$1ml\$1labeling\$1set\$1generation\$1task\$1run)](#aws-glue-api-machine-learning-api-StartMLLabelingSetGenerationTaskRun)
+ [Action Get MLTask Run (Python : get\$1ml\$1task\$1run)](#aws-glue-api-machine-learning-api-GetMLTaskRun)
+ [Action Get MLTask Runs (Python : get\$1ml\$1task\$1runs)](#aws-glue-api-machine-learning-api-GetMLTaskRuns)
+ [Annuler l'action MLTask Exécuter (Python : cancel\$1ml\$1task\$1run)](#aws-glue-api-machine-learning-api-CancelMLTaskRun)
+ [StartExportLabelsTaskRun action (Python : start\$1export\$1labels\$1task\$1run)](#aws-glue-api-machine-learning-api-StartExportLabelsTaskRun)
+ [StartImportLabelsTaskRun action (Python : start\$1import\$1labels\$1task\$1run)](#aws-glue-api-machine-learning-api-StartImportLabelsTaskRun)

## Créer une MLTransform action (Python : create\$1ml\$1transform)
<a name="aws-glue-api-machine-learning-api-CreateMLTransform"></a>

Crée une transformation basée sur le AWS Glue machine learning. Cette opération crée la transformation et tous les paramètres nécessaires pour la former.

Appelez cette opération comme première étape du processus d’utilisation d’une transformation du Machine Learning (comme la transformation `FindMatches`) pour la déduplication des données. Vous pouvez fournir une `Description` facultative, en plus des paramètres que vous souhaitez utiliser pour votre algorithme.

Vous devez également définir certains paramètres pour les tâches exécutées en votre nom AWS Glue dans le cadre de l'apprentissage à partir de vos données et de la création d'une transformation d'apprentissage automatique de haute qualité. Ces paramètres incluent `Role` et, le cas échéant, `AllocatedCapacity`, `Timeout` et `MaxRetries`. Pour en savoir plus, consultez [Jobs](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html) (Tâches).

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom unique que vous attribuez à la transformation lorsque vous la créez.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de la transformation du Machine Learning qui est définie. La valeur par défaut est une chaîne vide.
+ `InputRecordTables` – *Obligatoire :* Un tableau d’objets [GlueTable](#aws-glue-api-machine-learning-api-GlueTable), 10 structures au maximum.

  Liste des définitions de AWS Glue table utilisées par la transformation.
+ `Parameters` – *Obligatoire :* un objet [TransformParameters](#aws-glue-api-machine-learning-api-TransformParameters).

  Paramètres algorithmiques spécifiques au type de transformation utilisé. Dépendant de façon conditionnelle du type de transformation.
+ `Role` – *Obligatoire :* chaîne UTF-8.

  Nom ou Amazon Resource Name (ARN) du rôle IAM avec les autorisations requises. Les autorisations requises incluent à la fois les autorisations de rôle de AWS Glue service sur les AWS Glue ressources et les autorisations Amazon S3 requises par la transformation. 
  + Ce rôle nécessite des autorisations AWS Glue de rôle de service pour autoriser l'accès aux ressources dans AWS Glue. Veuillez consulter la rubrique [Attacher une politique aux utilisateurs IAM accédant à AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/attach-policy-iam-user.html).
  + Ce rôle a besoin d'une autorisation pour vos sources, vos cibles, votre répertoire temporaire et vos scripts Amazon Simple Storage Service (Amazon S3), ainsi que pour les bibliothèques utilisées par l'exécution de la tâche dans le cadre de cette transformation.
+ `GlueVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Cette valeur détermine la version compatible avec laquelle AWS Glue cette transformation de machine learning est compatible. Glue 1.0 est recommandé pour la plupart des clients. Si la valeur n'est pas définie, la compatibilité Glue par défaut est Glue 0.9. Pour plus d'informations, veuillez consulter la rubrique [Versions AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html#release-notes-versions) dans le guide du développeur.
+ `MaxCapacity` – Nombre (double).

  Nombre d'unités de traitement de AWS Glue données (DPUs) allouées aux exécutions de tâches pour cette transformation. Vous pouvez allouer de 2 à 100 DPUs ; la valeur par défaut est 10. Un DPU est une mesure relative de la puissance de traitement composée de 4 V de capacité CPUs de calcul et de 16 Go de mémoire. Pour plus d'informations, consultez la page de tarification [AWS Glue](https://aws.amazon.com/glue/pricing/). 

  `MaxCapacity` est une option mutuellement exclusive avec `NumberOfWorkers` et `WorkerType`.
  + Si `NumberOfWorkers` ou `WorkerType` est défini, ne `MaxCapacity` peut pas être défini.
  + Si `MaxCapacity` est défini, ni `NumberOfWorkers` ni `WorkerType` ne peuvent être définis.
  + Si `WorkerType` est défini, `NumberOfWorkers` est obligatoire (et inversement).
  + `MaxCapacity` et `NumberOfWorkers` doivent être au moins égal à 1.

  Lorsque le champ `WorkerType` est défini sur une valeur autre que `Standard`, le champ `MaxCapacity` est défini automatiquement et passe en lecture seule.

  Lorsque le champ `WorkerType` est défini sur une valeur autre que `Standard`, le champ `MaxCapacity` est défini automatiquement et passe en lecture seule.
+ `WorkerType` – Chaîne UTF-8 (valeurs valides: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  Type de travail prédéfini qui est alloué lorsqu'une tâche est exécutée. Accepte la valeur Standard, G.1X ou G.2X.
  + Pour le type de travail `Standard`, chaque travail fournit 4 vCPU, 16 Go de mémoire et 50 Go de disque, ainsi que 2 exécuteurs par travail.
  + Pour le type de travail `G.1X`, chaque travail fournit 4 vCPU, 16 Go de mémoire et 64 Go de disque, ainsi que 1 exécuteur par travail.
  + Pour le type de travail `G.2X`, chaque travail fournit 8 vCPU, 32 Go de mémoire et 128 Go de disque, ainsi que 1 exécuteur par travail.

  `MaxCapacity` est une option mutuellement exclusive avec `NumberOfWorkers` et `WorkerType`.
  + Si `NumberOfWorkers` ou `WorkerType` est défini, ne `MaxCapacity` peut pas être défini.
  + Si `MaxCapacity` est défini, ni `NumberOfWorkers` ni `WorkerType` ne peuvent être définis.
  + Si `WorkerType` est défini, `NumberOfWorkers` est obligatoire (et inversement).
  + `MaxCapacity` et `NumberOfWorkers` doivent être au moins égal à 1.
+ `NumberOfWorkers` : nombre (entier).

  Nombre de travaux d'un `workerType` défini qui sont attribués lorsqu'une tâche est exécutée.

  Si `WorkerType` est défini, `NumberOfWorkers` est obligatoire (et inversement).
+ `Timeout` – Nombre (entier), au moins égal à 1.

  Délai d’expiration de la tâche exécutée pour cette transformation en minutes. Durée maximale pendant laquelle l'exécution d'une tâche pour cette transformation peut utiliser des ressources avant qu'elle ne soit mise hors service et passe à l'état `TIMEOUT`. La valeur par défaut est de 2 880 minutes (48 heures).
+ `MaxRetries` : nombre (entier).

  Nombre maximal de nouvelles tentatives d'une tâche de cette transformation après l'échec de l'exécution d'une tâche.
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Balises à utiliser avec cette transformation de Machine Learning. Vous pouvez utiliser des balises pour limiter l’accès à la transformation de Machine Learning. Pour plus d'informations sur les tags in AWS Glue, voir [AWS Tags in AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html) dans le guide du développeur.
+ `TransformEncryption` – Un objet [TransformEncryption](#aws-glue-api-machine-learning-api-TransformEncryption).

  Les encryption-at-rest paramètres de la transformation qui s'appliquent à l'accès aux données utilisateur. Les transformations de machine learning peuvent accéder aux données utilisateur chiffrées dans Amazon S3 à l'aide de KMS.

**Réponse**
+ `TransformId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique généré pour la transformation.

**Erreurs**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `AccessDeniedException`
+ `ResourceNumberLimitExceededException`
+ `IdempotentParameterMismatchException`

## MLTransform Action de mise à jour (Python : update\$1ml\$1transform)
<a name="aws-glue-api-machine-learning-api-UpdateMLTransform"></a>

Met à jour une transformation du Machine Learning existante. Appelez cette opération pour ajuster les paramètres de l’algorithme afin d’obtenir de meilleurs résultats.

Après l’appel de cette opération, vous pouvez appeler l’opération `StartMLEvaluationTaskRun` pour évaluer comment vos nouveaux paramètres ont atteint vos objectifs (par exemple, améliorer la qualité de votre transformation Machine Learning, ou la rendre plus rentable).

**Demande**
+ `TransformId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique qui a été généré lorsque la transformation a été créée.
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom unique que vous avez donné à la transformation lorsque vous l’avez créée.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de la transformation. La valeur par défaut est une chaîne vide.
+ `Parameters` – Un objet [TransformParameters](#aws-glue-api-machine-learning-api-TransformParameters).

  Paramètres de configuration spécifiques au type de transformation (algorithme) utilisé. Dépendant de façon conditionnelle du type de transformation.
+ `Role` – Chaîne UTF-8.

  Nom ou Amazon Resource Name (ARN) du rôle IAM avec les autorisations requises.
+ `GlueVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Cette valeur détermine la version compatible avec laquelle AWS Glue cette transformation de machine learning est compatible. Glue 1.0 est recommandé pour la plupart des clients. Si la valeur n'est pas définie, la compatibilité Glue par défaut est Glue 0.9. Pour plus d'informations, veuillez consulter la rubrique [Versions AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html#release-notes-versions) dans le guide du développeur.
+ `MaxCapacity` – Nombre (double).

  Nombre d'unités de traitement de AWS Glue données (DPUs) allouées aux exécutions de tâches pour cette transformation. Vous pouvez allouer de 2 à 100 DPUs ; la valeur par défaut est 10. Un DPU est une mesure relative de la puissance de traitement composée de 4 V de capacité CPUs de calcul et de 16 Go de mémoire. Pour plus d'informations, consultez la page de tarification [AWS Glue](https://aws.amazon.com/glue/pricing/). 

  Lorsque le champ `WorkerType` est défini sur une valeur autre que `Standard`, le champ `MaxCapacity` est défini automatiquement et passe en lecture seule.
+ `WorkerType` – Chaîne UTF-8 (valeurs valides: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  Type de travail prédéfini qui est alloué lorsqu'une tâche est exécutée. Accepte la valeur Standard, G.1X ou G.2X.
  + Pour le type de travail `Standard`, chaque travail fournit 4 vCPU, 16 Go de mémoire et 50 Go de disque, ainsi que 2 exécuteurs par travail.
  + Pour le type de travail `G.1X`, chaque travail fournit 4 vCPU, 16 Go de mémoire et 64 Go de disque, ainsi que 1 exécuteur par travail.
  + Pour le type de travail `G.2X`, chaque travail fournit 8 vCPU, 32 Go de mémoire et 128 Go de disque, ainsi que 1 exécuteur par travail.
+ `NumberOfWorkers` : nombre (entier).

  Nombre de travaux d'un `workerType` défini qui sont attribués lorsqu'une tâche est exécutée.
+ `Timeout` – Nombre (entier), au moins égal à 1.

  Délai d'attente (en minutes) d'une tâche exécutée pour cette transformation. Durée maximale pendant laquelle l'exécution d'une tâche pour cette transformation peut utiliser des ressources avant qu'elle ne soit mise hors service et passe à l'état `TIMEOUT`. La valeur par défaut est de 2 880 minutes (48 heures).
+ `MaxRetries` : nombre (entier).

  Nombre maximal de nouvelles tentatives d'une tâche de cette transformation après l'échec de l'exécution d'une tâche.

**Réponse**
+ `TransformId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la transformation qui a été mise à jour.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `AccessDeniedException`

## MLTransform Action de suppression (Python : delete\$1ml\$1transform)
<a name="aws-glue-api-machine-learning-api-DeleteMLTransform"></a>

Supprime toute transformation AWS Glue de machine learning. Les transformations Machine Learning sont un type spécial de transformation qui utilisent le Machine Learning pour découvrir les détails de la transformation à exécuter par l'apprentissage à partir d'exemples fournis par les humains. Ces transformations sont ensuite enregistrées par AWS Glue. Si vous n’avez plus besoin d’une transformation, vous pouvez la supprimer en appelant `DeleteMLTransforms`. Cependant, les AWS Glue tâches qui font toujours référence à la transformation supprimée ne seront plus couronnées de succès.

**Demande**
+ `TransformId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la transformation à supprimer.

**Réponse**
+ `TransformId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la transformation qui a été supprimée.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## Obtenir une MLTransform action (Python : get\$1ml\$1transform)
<a name="aws-glue-api-machine-learning-api-GetMLTransform"></a>

Récupère un artefact de transformation basé sur le AWS Glue machine learning et toutes les métadonnées correspondantes. Les transformations Machine Learning sont un type spécial de transformation qui utilisent le Machine Learning pour découvrir les détails de la transformation à exécuter par l'apprentissage à partir d'exemples fournis par les humains. Ces transformations sont ensuite enregistrées par AWS Glue. Vous pouvez récupérer leurs métadonnées en appelant `GetMLTransform`.

**Demande**
+ `TransformId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la transformation, générée à l'heure à laquelle la transformation a été créée.

**Réponse**
+ `TransformId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la transformation, générée à l'heure à laquelle la transformation a été créée.
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom unique donné à la transformation lors de sa création.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de la transformation.
+ `Status` – Chaîne UTF-8 (valeurs valides : `NOT_READY` \$1 `READY` \$1 `DELETING`).

  Dernier état connu de la transformation (pour indiquer si elle peut être utilisée ou non). L'un des états « NOT\$1READY », « READY » ou « DELETING ».
+ `CreatedOn` – Horodatage.

  Date et heure de création de la transformation.
+ `LastModifiedOn` – Horodatage.

  Date et heure de la dernière modification de la transformation.
+ `InputRecordTables` – Un tableau d'objets [GlueTable](#aws-glue-api-machine-learning-api-GlueTable), 10 structures au maximum.

  Liste des définitions de AWS Glue table utilisées par la transformation.
+ `Parameters` – Un objet [TransformParameters](#aws-glue-api-machine-learning-api-TransformParameters).

  Paramètres de configuration spécifiques à l’algorithme utilisé.
+ `EvaluationMetrics` : un objet [EvaluationMetrics](#aws-glue-api-machine-learning-api-EvaluationMetrics).

  Dernières métriques d’évaluation.
+ `LabelCount` : nombre (entier).

  Nombre d’étiquettes disponibles pour cette transformation.
+ `Schema` – Un tableau d'objets [SchemaColumn](#aws-glue-api-machine-learning-api-SchemaColumn), 100 structures au maximum.

  Objet `Map<Column, Type>` qui représente le schéma que cette transformation accepte. Comporte une limite supérieure de 100 colonnes.
+ `Role` – Chaîne UTF-8.

  Nom ou Amazon Resource Name (ARN) du rôle IAM avec les autorisations requises.
+ `GlueVersion` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Cette valeur détermine la version compatible avec laquelle AWS Glue cette transformation de machine learning est compatible. Glue 1.0 est recommandé pour la plupart des clients. Si la valeur n'est pas définie, la compatibilité Glue par défaut est Glue 0.9. Pour plus d'informations, veuillez consulter la rubrique [Versions AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html#release-notes-versions) dans le guide du développeur.
+ `MaxCapacity` – Nombre (double).

  Nombre d'unités de traitement de AWS Glue données (DPUs) allouées aux exécutions de tâches pour cette transformation. Vous pouvez allouer de 2 à 100 DPUs ; la valeur par défaut est 10. Un DPU est une mesure relative de la puissance de traitement composée de 4 V de capacité CPUs de calcul et de 16 Go de mémoire. Pour plus d'informations, consultez la page de tarification [AWS Glue](https://aws.amazon.com/glue/pricing/). 

  Lorsque le champ `WorkerType` est défini sur une valeur autre que `Standard`, le champ `MaxCapacity` est défini automatiquement et passe en lecture seule.
+ `WorkerType` – Chaîne UTF-8 (valeurs valides: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  Type de travail prédéfini qui est alloué lorsqu'une tâche est exécutée. Accepte la valeur Standard, G.1X ou G.2X.
  + Pour le type de travail `Standard`, chaque travail fournit 4 vCPU, 16 Go de mémoire et 50 Go de disque, ainsi que 2 exécuteurs par travail.
  + Pour le type de travail `G.1X`, chaque travail fournit 4 vCPU, 16 Go de mémoire et 64 Go de disque, ainsi que 1 exécuteur par travail.
  + Pour le type de travail `G.2X`, chaque travail fournit 8 vCPU, 32 Go de mémoire et 128 Go de disque, ainsi que 1 exécuteur par travail.
+ `NumberOfWorkers` : nombre (entier).

  Nombre de travaux d'un `workerType` défini qui sont attribués lorsqu'une tâche est exécutée.
+ `Timeout` – Nombre (entier), au moins égal à 1.

  Délai d'attente (en minutes) d'une tâche exécutée pour cette transformation. Durée maximale pendant laquelle l'exécution d'une tâche pour cette transformation peut utiliser des ressources avant qu'elle ne soit mise hors service et passe à l'état `TIMEOUT`. La valeur par défaut est de 2 880 minutes (48 heures).
+ `MaxRetries` : nombre (entier).

  Nombre maximal de nouvelles tentatives d'une tâche de cette transformation après l'échec de l'exécution d'une tâche.
+ `TransformEncryption` – Un objet [TransformEncryption](#aws-glue-api-machine-learning-api-TransformEncryption).

  Les encryption-at-rest paramètres de la transformation qui s'appliquent à l'accès aux données utilisateur. Les transformations de machine learning peuvent accéder aux données utilisateur chiffrées dans Amazon S3 à l'aide de KMS.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## Obtenir une MLTransforms action (Python : get\$1ml\$1transform)
<a name="aws-glue-api-machine-learning-api-GetMLTransforms"></a>

Obtient une liste triable et filtrable des transformations d'apprentissage AWS Glue automatique existantes. Les transformations Machine Learning sont un type spécial de transformation qui utilisent le Machine Learning pour découvrir les détails de la transformation à exécuter par l'apprentissage à partir d'exemples fournis par les humains. Ces transformations sont ensuite enregistrées par AWS Glue, et vous pouvez récupérer leurs métadonnées en appelant`GetMLTransforms`.

**Demande**
+ `NextToken` – Chaîne UTF-8.

  Jeton de pagination pour décaler les résultats.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximal de résultats à renvoyer.
+ `Filter` – Un objet [TransformFilterCriteria](#aws-glue-api-machine-learning-api-TransformFilterCriteria).

  Critères de transformation du filtre.
+ `Sort` – Un objet [TransformSortCriteria](#aws-glue-api-machine-learning-api-TransformSortCriteria).

  Critères de tri.

**Réponse**
+ `Transforms` – *Obligatoire :* un tableau d’objets [MLTransform](#aws-glue-api-machine-learning-api-MLTransform).

  Liste de transformations du Machine Learning.
+ `NextToken` – Chaîne UTF-8.

  Un jeton de pagination, si d'autres résultats sont disponibles.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## MLTransforms Action de liste (Python : list\$1ml\$1transform)
<a name="aws-glue-api-machine-learning-api-ListMLTransforms"></a>

 Récupère une liste triable et filtrable des transformations de AWS Glue machine learning existantes dans ce AWS compte, ou des ressources avec le tag spécifié. Cette opération accepte le champ `Tags` facultatif que vous pouvez utiliser comme filtre sur les réponses, afin que les ressources balisées puissent être récupérées en tant que groupe. Si vous choisissez d’utiliser le filtrage des balises, seules les ressources avec les balises sont récupérées. 

**Demande**
+ `NextToken` – Chaîne UTF-8.

  Jeton de continuation, s’il s’agit d’une requête de continuation.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  La taille maximale d’une liste à renvoyer.
+ `Filter` – Un objet [TransformFilterCriteria](#aws-glue-api-machine-learning-api-TransformFilterCriteria).

  Élément `TransformFilterCriteria` utilisé pour filtrer les transformations de Machine Learning.
+ `Sort` – Un objet [TransformSortCriteria](#aws-glue-api-machine-learning-api-TransformSortCriteria).

  Élément `TransformSortCriteria` utilisé pour trier les transformations de Machine Learning.
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Spécifie de renvoyer uniquement les ressources balisées.

**Réponse**
+ `TransformIds` – *Obligatoire :* Tableau de chaînes UTF-8.

  Identifiants de toutes les transformations de Machine Learning dans le compte, ou les transformations de Machine Learning avec les balises spécifiées.
+ `NextToken` – Chaîne UTF-8.

  Jeton continuation, si la liste renvoyée ne contient pas la dernière métrique disponible.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## Lancer MLEvaluation TaskRun l'action (Python : start\$1ml\$1evaluation\$1task\$1run)
<a name="aws-glue-api-machine-learning-api-StartMLEvaluationTaskRun"></a>

Démarre une tâche pour estimer la qualité de la transformation. 

Lorsque vous fournissez des ensembles d'étiquettes comme exemples de vérité, l'apprentissage AWS Glue automatique utilise certains de ces exemples pour en tirer des leçons. Le reste des étiquettes est utilisé en tant que test pour estimer la qualité.

Retourne un identifiant unique pour l’exécution. Vous pouvez appeler `GetMLTaskRun` pour obtenir plus d’informations sur les statistiques de `EvaluationTaskRun`.

**Demande**
+ `TransformId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la transformation du Machine Learning.

**Réponse**
+ `TaskRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique associé à cette exécution.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `ConcurrentRunsExceededException`
+ `MLTransformNotReadyException`

## Lancer MLLabeling SetGenerationTaskRun l'action (Python : start\$1ml\$1labeling\$1set\$1generation\$1task\$1run)
<a name="aws-glue-api-machine-learning-api-StartMLLabelingSetGenerationTaskRun"></a>

Démarre le flux de travail de l’apprentissage actif d’apprentissage automatique pour votre transformation de Machine Learning afin d’améliorer la qualité de la transformation en générant des ensembles d’étiquette et en ajoutant des étiquettes.

Quand `StartMLLabelingSetGenerationTaskRun` a pris fin, AWS Glue aura généré un « jeu d’étiquetage » ou un ensemble de questions auxquelles les humains devront répondre.

Dans le cas de la transformation `FindMatches`, ces questions prennent la forme : « Quel est le bon moyen de regrouper conjointement ces lignes en groupes composés d'enregistrements correspondants ? » 

Une fois que le processus d’étiquetage est terminé, vous pouvez charger vos étiquettes avec un appel à `StartImportLabelsTaskRun`. Une fois `StartImportLabelsTaskRun` terminé, toutes les futures exécutions de la transformation du Machine Learning utiliseront les nouvelles étiquettes améliorées et effectueront une transformation de meilleure qualité.

Remarque : Le rôle utilisé pour écrire le jeu d’étiquetage généré sur le `OutputS3Path` est le rôle associé à la transformation du machine learning, spécifié dans l’API `CreateMLTransform`.

**Demande**
+ `TransformId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la transformation du Machine Learning.
+ `OutputS3Path` – *Obligatoire :* chaîne UTF-8.

  Chemin Amazon Simple Storage Service (Amazon S3) sur lequel vous générez l’ensemble d’étiquetage.

**Réponse**
+ `TaskRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant d’exécution unique associé à cette exécution de tâche.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `ConcurrentRunsExceededException`

## Action Get MLTask Run (Python : get\$1ml\$1task\$1run)
<a name="aws-glue-api-machine-learning-api-GetMLTaskRun"></a>

Permet d’obtenir les détails d’une exécution de tâche spécifique sur une transformation du Machine Learning. Les exécutions de tâches d'apprentissage automatique sont des tâches asynchrones exécutées AWS Glue en votre nom dans le cadre de différents flux de travail d'apprentissage automatique. Vous pouvez vérifier les statistiques de toutes les tâches exécutées en appelant `GetMLTaskRun` avec le `TaskRunID` et le `TransformID` de la transformation parent.

**Demande**
+ `TransformId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la transformation du Machine Learning.
+ `TaskRunId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la tâche exécutée.

**Réponse**
+ `TransformId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la tâche exécutée.
+ `TaskRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant d’exécution unique associé à cette exécution.
+ `Status` – Chaîne UTF-8 (valeurs valides : `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  Statut de la tâche exécutée.
+ `LogGroupName` – Chaîne UTF-8.

  Noms des groupes de journaux associés à la tâche exécutée.
+ `Properties` – Un objet [TaskRunProperties](#aws-glue-api-machine-learning-api-TaskRunProperties).

  Liste des propriétés associés à la tâche exécutée.
+ `ErrorString` – Chaîne UTF-8.

  Chaînes d’erreur associées à la tâche exécutée.
+ `StartedOn` – Horodatage.

  Date et heure de l’exécution de cette tâche.
+ `LastModifiedOn` – Horodatage.

  Date et heure de la dernière modification de cette exécution de tâche.
+ `CompletedOn` – Horodatage.

  Date et heure de fin de la dernière exécution de cette tâche.
+ `ExecutionTime` : nombre (entier).

  Durée (en secondes) pendant laquelle la tâche exécutée a consommé des ressources.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## Action Get MLTask Runs (Python : get\$1ml\$1task\$1runs)
<a name="aws-glue-api-machine-learning-api-GetMLTaskRuns"></a>

Permet d’obtenir la liste des exécutions d’une transformation du Machine Learning. Les exécutions de tâches d'apprentissage automatique sont des tâches asynchrones exécutées AWS Glue en votre nom dans le cadre de différents flux de travail d'apprentissage automatique. Vous pouvez obtenir une liste triable et filtrable des exécutions de tâche du Machine Learning en appelant `GetMLTaskRuns` avec le `TransformID` de sa transformation parent et d’autres paramètres facultatifs, comme décrit dans cette section.

Cette opération renvoie la liste des exécutions historiques et doit être paginée.

**Demande**
+ `TransformId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la transformation du Machine Learning.
+ `NextToken` – Chaîne UTF-8.

  Jeton pour la pagination des résultats. La valeur par défaut est vide.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximal de résultats à renvoyer. 
+ `Filter` – Un objet [TaskRunFilterCriteria](#aws-glue-api-machine-learning-api-TaskRunFilterCriteria).

  Critères de filtre, dans la structure `TaskRunFilterCriteria`, pour la tâche exécutée.
+ `Sort` – Un objet [TaskRunSortCriteria](#aws-glue-api-machine-learning-api-TaskRunSortCriteria).

  Critères de tri, dans la structure `TaskRunSortCriteria`, pour la tâche exécutée.

**Réponse**
+ `TaskRuns` : un tableau d’objets [TaskRun](#aws-glue-api-machine-learning-api-TaskRun).

  Liste des exécutions de tâches associées à la transformation.
+ `NextToken` – Chaîne UTF-8.

  Un jeton de pagination, si d'autres résultats sont disponibles.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## Annuler l'action MLTask Exécuter (Python : cancel\$1ml\$1task\$1run)
<a name="aws-glue-api-machine-learning-api-CancelMLTaskRun"></a>

Annule (arrête) une exécution de tâche. Les exécutions de tâches d'apprentissage automatique sont des tâches asynchrones exécutées AWS Glue en votre nom dans le cadre de différents flux de travail d'apprentissage automatique. Vous pouvez annuler une exécution de tâche du Machine Learning à tout moment en appelant `CancelMLTaskRun` avec le `TransformID` d’une transformation parent de la tâche exécutée et le `TaskRunId` de la tâche exécutée. 

**Demande**
+ `TransformId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la transformation du Machine Learning.
+ `TaskRunId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la tâche exécutée.

**Réponse**
+ `TransformId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la transformation du Machine Learning.
+ `TaskRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de l'exécution de la tâche.
+ `Status` – Chaîne UTF-8 (valeurs valides : `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  Statut de cette exécution.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## StartExportLabelsTaskRun action (Python : start\$1export\$1labels\$1task\$1run)
<a name="aws-glue-api-machine-learning-api-StartExportLabelsTaskRun"></a>

Commence une tâche asynchrone pour exporter toutes les données étiquetées pour une transformation particulière. Cette tâche est le seul appel d’API lié à l’étiquetage qui ne fasse pas partie du flux de travail d’apprentissage actif classique. Vous utilisez généralement `StartExportLabelsTaskRun` lorsque vous souhaitez utiliser tous vos étiquettes existantes en même temps, par exemple lorsque vous souhaitez supprimer ou modifier les étiquettes qui ont été soumises précédemment comme vraies. Cette opération d’API accepte le `TransformId` dont vous souhaitez exporter les étiquettes et un chemin Amazon Simple Storage Service (Amazon S3) vers lequel exporter les étiquettes. L’opération renvoie un `TaskRunId`. Vous pouvez vérifier le statut de votre tâche d’exécuter en appelant l’API `GetMLTaskRun`.

**Demande**
+ `TransformId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la transformation du Machine Learning.
+ `OutputS3Path` – *Obligatoire :* chaîne UTF-8.

  Chemin Amazon S3 où vous exportez les étiquettes.

**Réponse**
+ `TaskRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de l'exécution de la tâche.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## StartImportLabelsTaskRun action (Python : start\$1import\$1labels\$1task\$1run)
<a name="aws-glue-api-machine-learning-api-StartImportLabelsTaskRun"></a>

Vous permet de fournir des étiquettes supplémentaires (exemples de vérité) à utiliser afin d’enseigner la transformation du Machine Learning et d’améliorer sa qualité. Cette opération d’API est généralement utilisée dans le cadre du processus d’apprentissage active qui commence par l’appel `StartMLLabelingSetGenerationTaskRun` et qui se traduit finalement par l’amélioration de la qualité de votre transformation de Machine Learning. 

Une fois `StartMLLabelingSetGenerationTaskRun` terminé, le machine learning AWS Glue aura généré une série de questions pour que les humains y répondent. (La réponse à ces questions est souvent appelé « étiquette » dans les flux de travail du Machine Learning). Dans le cas de la transformation `FindMatches`, ces questions prennent la forme : « Quel est le bon moyen de regrouper conjointement ces lignes en groupes composés d'enregistrements correspondants ? » Une fois le processus d'étiquetage terminé, les utilisateurs les téléchargent answers/labels en appelant`StartImportLabelsTaskRun`. Une fois `StartImportLabelsTaskRun` terminé, toutes les exécutions futures de la transformation du Machine Learning utilisent les nouvelles étiquettes améliorées et effectuent une transformation de meilleure qualité.

Par défaut, `StartMLLabelingSetGenerationTaskRun` apprend en permanence et associe toutes les étiquettes que vous chargez, sauf si vous définissez `Replace` sur true. Si vous définissez `Replace` sur true, `StartImportLabelsTaskRun` supprime et oublie toutes les étiquettes précédemment chargées et apprend uniquement à partir de l’ensemble exact que vous chargez. Le remplacement des étiquettes peuvent être utiles si vous vous rendez compte que vous avez précédemment téléchargé les étiquettes incorrectes et que vous pensez qu’elles ont une incidence négative sur la qualité de votre transformation.

Vous pouvez vérifier le statut de votre exécution de tâche en appelant l’opération `GetMLTaskRun`. 

**Demande**
+ `TransformId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de la transformation du Machine Learning.
+ `InputS3Path` – *Obligatoire :* chaîne UTF-8.

  Chemin Amazon Simple Storage Service (Amazon S3) à partir duquel vous importez les étiquettes.
+ `ReplaceAllLabels` : booléen.

  Indique si vous souhaitez remplacer vos étiquettes existantes.

**Réponse**
+ `TaskRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique de l'exécution de la tâche.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`

# API Qualité des données
<a name="aws-glue-api-data-quality-api"></a>

L'API Qualité des données décrit les types de données de qualité et inclut l'API permettant de créer, supprimer ou de mettre à jour des ensembles de règles, exécutions et évaluations.

## Types de données
<a name="aws-glue-api-data-quality-api-objects"></a>
+ [DataSource structure](#aws-glue-api-data-quality-api-DataSource)
+ [DataQualityRulesetListDetails structure](#aws-glue-api-data-quality-api-DataQualityRulesetListDetails)
+ [DataQualityTargetTable structure](#aws-glue-api-data-quality-api-DataQualityTargetTable)
+ [DataQualityRulesetEvaluationRunDescription structure](#aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunDescription)
+ [DataQualityRulesetEvaluationRunFilter structure](#aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunFilter)
+ [DataQualityEvaluationRunAdditionalRunOptions structure](#aws-glue-api-data-quality-api-DataQualityEvaluationRunAdditionalRunOptions)
+ [DataQualityRuleRecommendationRunDescription structure](#aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunDescription)
+ [DataQualityRuleRecommendationRunFilter structure](#aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunFilter)
+ [DataQualityResult structure](#aws-glue-api-data-quality-api-DataQualityResult)
+ [DataQualityAnalyzerResult structure](#aws-glue-api-data-quality-api-DataQualityAnalyzerResult)
+ [DataQualityObservation structure](#aws-glue-api-data-quality-api-DataQualityObservation)
+ [MetricBasedObservation structure](#aws-glue-api-data-quality-api-MetricBasedObservation)
+ [DataQualityMetricValues structure](#aws-glue-api-data-quality-api-DataQualityMetricValues)
+ [DataQualityRuleResult structure](#aws-glue-api-data-quality-api-DataQualityRuleResult)
+ [DataQualityResultDescription structure](#aws-glue-api-data-quality-api-DataQualityResultDescription)
+ [DataQualityResultFilterCriteria structure](#aws-glue-api-data-quality-api-DataQualityResultFilterCriteria)
+ [DataQualityRulesetFilterCriteria structure](#aws-glue-api-data-quality-api-DataQualityRulesetFilterCriteria)
+ [DataQualityAggregatedMetrics structure](#aws-glue-api-data-quality-api-DataQualityAggregatedMetrics)
+ [StatisticAnnotation structure](#aws-glue-api-data-quality-api-StatisticAnnotation)
+ [TimestampedInclusionAnnotation structure](#aws-glue-api-data-quality-api-TimestampedInclusionAnnotation)
+ [AnnotationError structure](#aws-glue-api-data-quality-api-AnnotationError)
+ [DatapointInclusionAnnotation structure](#aws-glue-api-data-quality-api-DatapointInclusionAnnotation)
+ [StatisticSummaryList liste](#aws-glue-api-data-quality-api-StatisticSummaryList)
+ [StatisticSummary structure](#aws-glue-api-data-quality-api-StatisticSummary)
+ [RunIdentifier structure](#aws-glue-api-data-quality-api-RunIdentifier)
+ [StatisticModelResult structure](#aws-glue-api-data-quality-api-StatisticModelResult)
+ [DataQualityGlueTable structure](#aws-glue-api-data-quality-api-DataQualityGlueTable)

## DataSource structure
<a name="aws-glue-api-data-quality-api-DataSource"></a>

Source de données ( AWS Glue table) pour laquelle vous souhaitez obtenir des résultats de qualité.

**Champs**
+ `GlueTable` – Un objet [GlueTable](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-GlueTable).

  Et une AWS Glue table.
+ `DataQualityGlueTable` – Un objet [DataQualityGlueTable](#aws-glue-api-data-quality-api-DataQualityGlueTable).

  Un AWS Glue tableau pour les opérations relatives à la qualité des données.

## DataQualityRulesetListDetails structure
<a name="aws-glue-api-data-quality-api-DataQualityRulesetListDetails"></a>

Décrit un ensemble de règles de qualité des données renvoyé par `GetDataQualityRuleset`.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'ensemble de règles de qualité des données.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de l'ensemble de règles de qualité des données.
+ `CreatedOn` – Horodatage.

  Date et heure de création de l'ensemble de règles de qualité des données.
+ `LastModifiedOn` – Horodatage.

  Date et heure de la dernière modification de l'ensemble de règles de qualité des données.
+ `TargetTable` – Un objet [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable).

  Objet représentant une AWS Glue table.
+ `RecommendationRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Lors de la création d'un ensemble de règles à partir d'une exécution de recommandation, cet ID d'exécution est généré pour relier les deux.
+ `RuleCount` : nombre (entier).

  Nombre de règles dans l'ensemble de règles.

## DataQualityTargetTable structure
<a name="aws-glue-api-data-quality-api-DataQualityTargetTable"></a>

Objet représentant une AWS Glue table.

**Champs**
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de la AWS Glue table.
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données dans laquelle se trouve la AWS Glue table.
+ `CatalogId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'identifiant du catalogue où se trouve la AWS Glue table.

## DataQualityRulesetEvaluationRunDescription structure
<a name="aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunDescription"></a>

Décrit le résultat d'une exécution d'évaluation d'un ensemble de règles de qualité des données.

**Champs**
+ `RunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant d’exécution unique associé à cette exécution.
+ `Status` – Chaîne UTF-8 (valeurs valides : `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  Statut de cette exécution.
+ `StartedOn` – Horodatage.

  Date et heure de lancement de l'exécution.
+ `DataSource` – Un objet [DataSource](#aws-glue-api-data-quality-api-DataSource).

  La source de données (une AWS Glue table) associée à l'exécution.

## DataQualityRulesetEvaluationRunFilter structure
<a name="aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunFilter"></a>

Critères de filtrage.

**Champs**
+ `DataSource` – *Obligatoire :* un objet [DataSource](#aws-glue-api-data-quality-api-DataSource).

  Filtrez en fonction d'une source de données (une AWS Glue table) associée à l'exécution.
+ `StartedBefore` – Horodatage.

  Filtrez les résultats en fonction des exécutions qui ont débuté avant cette heure.
+ `StartedAfter` – Horodatage.

  Filtrez les résultats en fonction des exécutions qui ont débuté après cette heure.

## DataQualityEvaluationRunAdditionalRunOptions structure
<a name="aws-glue-api-data-quality-api-DataQualityEvaluationRunAdditionalRunOptions"></a>

Options d'exécution supplémentaires que vous pouvez spécifier pour une exécution d'évaluation.

**Champs**
+ `CloudWatchMetricsEnabled` : booléen.

  Activer ou non les CloudWatch métriques.
+ `ResultsS3Prefix` – Chaîne UTF-8.

  Préfixe permettant à Amazon S3 de stocker les résultats.
+ `CompositeRuleEvaluationMethod` – Chaîne UTF-8 (valeurs valides : `COLUMN` \$1 `ROW`).

  Définissez la méthode d’évaluation des règles composites du jeu de règles sur ROW/COLUMN.

## DataQualityRuleRecommendationRunDescription structure
<a name="aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunDescription"></a>

Décrit le résultat de l'exécution d'une recommandation de règle de qualité des données.

**Champs**
+ `RunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant d’exécution unique associé à cette exécution.
+ `Status` – Chaîne UTF-8 (valeurs valides : `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  Statut de cette exécution.
+ `StartedOn` – Horodatage.

  Date et heure de lancement de cette exécution.
+ `DataSource` – Un objet [DataSource](#aws-glue-api-data-quality-api-DataSource).

  Source de données (AWS Glue table) associée à l'exécution de la recommandation.

## DataQualityRuleRecommendationRunFilter structure
<a name="aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunFilter"></a>

Filtre permettant de répertorier les exécutions de recommandations relatives à la qualité des données.

**Champs**
+ `DataSource` – *Obligatoire :* un objet [DataSource](#aws-glue-api-data-quality-api-DataSource).

  Filtrez en fonction d'une source de données spécifiée (AWS Glue table).
+ `StartedBefore` – Horodatage.

  Filtrez en fonction de l'heure de début des résultats avant l'heure indiquée.
+ `StartedAfter` – Horodatage.

  Filtrez en fonction de l'heure de début des résultats après l'heure indiquée.

## DataQualityResult structure
<a name="aws-glue-api-data-quality-api-DataQualityResult"></a>

Décrit un résultat sur la qualité des données.

**Champs**
+ `ResultId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de résultat unique pour le résultat en matière de qualité des données.
+ `ProfileId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID de profil pour le résultat en matière de qualité des données.
+ `Score` – Nombre (double), au plus égal à 1,0.

  Score de qualité des données agrégées. Représente le rapport entre le nombre de règles transmises et le nombre total de règles.
+ `DataSource` – Un objet [DataSource](#aws-glue-api-data-quality-api-DataSource).

  Table associée au résultat sur la qualité des données, le cas échéant.
+ `RulesetName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'ensemble de règles associé au résultat sur la qualité des données.
+ `EvaluationContext` – Chaîne UTF-8.

  Dans le contexte d'une tâche dans AWS Glue Studio, chaque nœud du canevas se voit généralement attribuer un nom et les nœuds de qualité des données porteront un nom. Dans le cas de plusieurs nœuds, `evaluationContext` peut distinguer les nœuds.
+ `StartedOn` – Horodatage.

  Date et heure du début de cette exécution de l'évaluation de la qualité des données.
+ `CompletedOn` – Horodatage.

  Date et heure de fin de la dernière exécution de cette évaluation de la qualité des données.
+ `JobName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de tâche associé au résultat sur la qualité des données, le cas échéant.
+ `JobRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID d'exécution de la tâche associé au résultat sur la qualité des données, le cas échéant.
+ `RulesetEvaluationRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID d'exécution unique de l'évaluation de l'ensemble de règles pour ce résultat sur la qualité des données.
+ `RuleResults` – Un tableau d’objets [DataQualityRuleResult](#aws-glue-api-data-quality-api-DataQualityRuleResult), 2 000 structures au maximum.

  Liste d'objets `DataQualityRuleResult` représentant les résultats de chaque règle. 
+ `AnalyzerResults` – Un tableau d’objets [DataQualityAnalyzerResult](#aws-glue-api-data-quality-api-DataQualityAnalyzerResult), 2 000 structures au maximum.

  Liste d’objets `DataQualityAnalyzerResult` représentant les résultats de chaque analyseur. 
+ `Observations` – Un tableau d'objets [DataQualityObservation](#aws-glue-api-data-quality-api-DataQualityObservation), 50 structures maximum.

  Liste d’objets `DataQualityObservation` représentant les observations générées après évaluation des règles et des analyseurs. 
+ `AggregatedMetrics` – Un objet [DataQualityAggregatedMetrics](#aws-glue-api-data-quality-api-DataQualityAggregatedMetrics).

   Récapitulatif des `DataQualityAggregatedMetrics` objets indiquant le nombre total de lignes et de règles traitées, y compris leurs pass/fail statistiques basées sur les résultats au niveau des lignes. 

## DataQualityAnalyzerResult structure
<a name="aws-glue-api-data-quality-api-DataQualityAnalyzerResult"></a>

Décrit le résultat de l’évaluation d’un analyseur de qualité des données.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l’analyseur de qualité des données.
+ `Description` – Chaîne UTF-8, d'une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de l’analyseur de qualité des données.
+ `EvaluationMessage` – Chaîne UTF-8, d'une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Message d'évaluation.
+ `EvaluatedMetrics` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est un nombre (double).

  Carte des métriques associées à l’évaluation de l’analyseur.

## DataQualityObservation structure
<a name="aws-glue-api-data-quality-api-DataQualityObservation"></a>

Décrit l’observation générée après l’évaluation des règles et des analyseurs.

**Champs**
+ `Description` – Chaîne UTF-8, d'une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de l’observation de la qualité des données.
+ `MetricBasedObservation` – Un objet [MetricBasedObservation](#aws-glue-api-data-quality-api-MetricBasedObservation).

  Objet de type `MetricBasedObservation` représentant l’observation basée sur des métriques de qualité des données évaluées.

## MetricBasedObservation structure
<a name="aws-glue-api-data-quality-api-MetricBasedObservation"></a>

Décrit l’observation basée sur les métriques générée sur la base des métriques de qualité des données évaluées.

**Champs**
+ `MetricName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la métrique de qualité des données utilisée pour générer l’observation.
+ `StatisticId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID de statistique.
+ `MetricValues` – Un objet [DataQualityMetricValues](#aws-glue-api-data-quality-api-DataQualityMetricValues).

  Objet de type `DataQualityMetricValues` représentant l’analyse de la valeur de métrique de qualité des données.
+ `NewRules` – Tableau de chaînes UTF-8.

  Liste des nouvelles règles de qualité des données générées dans le cadre de l’observation basée sur la valeur de métrique de qualité des données.

## DataQualityMetricValues structure
<a name="aws-glue-api-data-quality-api-DataQualityMetricValues"></a>

Décrit la valeur de la métrique de qualité des données en fonction de l’analyse des données historiques.

**Champs**
+ `ActualValue` – Nombre (double).

  Valeur réelle de la métrique de qualité des données.
+ `ExpectedValue` – Nombre (double).

  Valeur attendue de la métrique de qualité des données selon l’analyse des données historiques.
+ `LowerLimit` – Nombre (double).

  Limite inférieure de la valeur de métrique de qualité des données selon l’analyse des données historiques.
+ `UpperLimit` – Nombre (double).

  Limite supérieure de la valeur de métrique de qualité des données selon l’analyse des données historiques.

## DataQualityRuleResult structure
<a name="aws-glue-api-data-quality-api-DataQualityRuleResult"></a>

Décrit le résultat de l'évaluation d'une règle de qualité des données.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la règle de qualité des données.
+ `Description` – Chaîne UTF-8, d'une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de la règle de qualité des données.
+ `EvaluationMessage` – Chaîne UTF-8, d'une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Message d'évaluation.
+ `Result` – Chaîne UTF-8 (valeurs valides : `PASS` \$1 `FAIL` \$1 `ERROR`).

  État de réussite ou d'échec de la règle.
+ `EvaluatedMetrics` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est un nombre (double).

  Une carte des métriques associées à l'évaluation de la règle.
+ `EvaluatedRule` – Chaîne UTF-8, d'une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Règle évaluée.
+ `RuleMetrics` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est un nombre (double).

  Carte contenant les métriques associées à l’évaluation de la règle en fonction des résultats au niveau des lignes. 

## DataQualityResultDescription structure
<a name="aws-glue-api-data-quality-api-DataQualityResultDescription"></a>

Décrit un résultat sur la qualité des données.

**Champs**
+ `ResultId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de résultat unique pour ce résultat sur la qualité des données.
+ `DataSource` – Un objet [DataSource](#aws-glue-api-data-quality-api-DataSource).

  Nom de la table associée au résultat sur la qualité des données.
+ `JobName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la tâche associée au résultat en matière de qualité des données.
+ `JobRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID d'exécution de la tâche associé au résultat en matière de qualité des données.
+ `StartedOn` – Horodatage.

  Heure du début de l'exécution pour ce résultat en matière de qualité des données.

## DataQualityResultFilterCriteria structure
<a name="aws-glue-api-data-quality-api-DataQualityResultFilterCriteria"></a>

Critères permettant de renvoyer des résultats en matière de qualité des données.

**Champs**
+ `DataSource` – Un objet [DataSource](#aws-glue-api-data-quality-api-DataSource).

  Filtrez les résultats en fonction de la source de données spécifiée. Par exemple, récupérer tous les résultats d'une AWS Glue table.
+ `JobName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Filtrez les résultats en fonction du nom de la tâche spécifiée.
+ `JobRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Filtrez les résultats en fonction de l'ID d'exécution de la tâche spécifiée.
+ `StartedAfter` – Horodatage.

  Filtrez les résultats en fonction des exécutions qui ont débuté après cette heure.
+ `StartedBefore` – Horodatage.

  Filtrez les résultats en fonction des exécutions qui ont débuté avant cette heure.

## DataQualityRulesetFilterCriteria structure
<a name="aws-glue-api-data-quality-api-DataQualityRulesetFilterCriteria"></a>

Critères permettant de filtrer les ensembles de règles de qualité des données.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom des critères de filtrage de l'ensemble de règles.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description des critères de filtrage de l'ensemble de règles.
+ `CreatedBefore` – Horodatage.

  Filtre sur les ensembles de règles créés avant cette date.
+ `CreatedAfter` – Horodatage.

  Filtre sur les ensembles de règles créés après cette date.
+ `LastModifiedBefore` – Horodatage.

  Filtre sur les derniers ensembles de règles modifiés avant cette date.
+ `LastModifiedAfter` – Horodatage.

  Filtre sur les derniers ensembles de règles modifiés après cette date.
+ `TargetTable` – Un objet [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable).

  Nom et nom de la base de données de la table cible.

## DataQualityAggregatedMetrics structure
<a name="aws-glue-api-data-quality-api-DataQualityAggregatedMetrics"></a>

Résumé des mesures indiquant le nombre total de lignes et de règles traitées, y compris leurs pass/fail statistiques basées sur les résultats au niveau des lignes.

**Champs**
+ `TotalRowsProcessed` – Nombre (double).

  Nombre total de lignes traitées lors de l’évaluation de la qualité des données.
+ `TotalRowsPassed` – Nombre (double).

  Nombre total de lignes ayant satisfait à toutes les règles de qualité des données applicables.
+ `TotalRowsFailed` – Nombre (double).

  Nombre total de lignes n’ayant pas respecté une ou plusieurs règles de qualité des données.
+ `TotalRulesProcessed` – Nombre (double).

  Nombre total de règles de qualité des données qui ont été évaluées.
+ `TotalRulesPassed` – Nombre (double).

  Nombre total de règles de qualité des données qui ont satisfait à leurs critères d’évaluation.
+ `TotalRulesFailed` – Nombre (double).

  Nombre total de règles de qualité des données qui n’ont pas satisfait à leurs critères d’évaluation.

## StatisticAnnotation structure
<a name="aws-glue-api-data-quality-api-StatisticAnnotation"></a>

Annotation statistique.

**Champs**
+ `ProfileId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID de profil.
+ `StatisticId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID de statistique.
+ `StatisticRecordedOn` – Horodatage.

  Horodatage de l’enregistrement de la statistique annotée.
+ `InclusionAnnotation` – Un objet [TimestampedInclusionAnnotation](#aws-glue-api-data-quality-api-TimestampedInclusionAnnotation).

  Annotation d’inclusion appliquée à la statistique.

## TimestampedInclusionAnnotation structure
<a name="aws-glue-api-data-quality-api-TimestampedInclusionAnnotation"></a>

Annotation d’inclusion horodatée.

**Champs**
+ `Value` – Chaîne UTF-8 (valeurs valides : `INCLUDE` \$1 `EXCLUDE`).

  Valeur de l’annotation d’inclusion.
+ `LastModifiedOn` – Horodatage.

  Horodatage de la dernière modification de l’annotation d’inclusion.

## AnnotationError structure
<a name="aws-glue-api-data-quality-api-AnnotationError"></a>

Annotation qui a échoué.

**Champs**
+ `ProfileId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de profil de l’annotation qui a échoué.
+ `StatisticId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de statistique de l’annotation qui a échoué.
+ `FailureReason` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Raison pour laquelle l’annotation a échoué.

## DatapointInclusionAnnotation structure
<a name="aws-glue-api-data-quality-api-DatapointInclusionAnnotation"></a>

Annotation d’inclusion.

**Champs**
+ `ProfileId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du profil de qualité des données auquel appartient la statistique.
+ `StatisticId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID de statistique.
+ `InclusionAnnotation` – Chaîne UTF-8 (valeurs valides : `INCLUDE` \$1 `EXCLUDE`).

  Valeur d’annotation d’inclusion à appliquer à la statistique.

## StatisticSummaryList liste
<a name="aws-glue-api-data-quality-api-StatisticSummaryList"></a>

Une liste de `StatisticSummary`.

Tableau d’objets [StatisticSummary](#aws-glue-api-data-quality-api-StatisticSummary).

Une liste de `StatisticSummary`.

## StatisticSummary structure
<a name="aws-glue-api-data-quality-api-StatisticSummary"></a>

Informations récapitulatives relatives à une statistique.

**Champs**
+ `StatisticId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID de statistique.
+ `ProfileId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID de profil.
+ `RunIdentifier` – Un objet [RunIdentifier](#aws-glue-api-data-quality-api-RunIdentifier).

  Identifiant de l’exécution.
+ `StatisticName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Custom string pattern #16](aws-glue-api-common.md#regex_16).

  Nom de la statistique.
+ `DoubleValue` – Nombre (double).

  Valeur de la statistique.
+ `EvaluationLevel` – Chaîne UTF-8 (valeurs valides : `Dataset="DATASET"` \$1 `Column="COLUMN"` \$1 `Multicolumn="MULTICOLUMN"`).

  Niveau d’évaluation de la statistique. Valeurs possibles :`Dataset`,`Column`,`Multicolumn`.
+ `ColumnsReferenced` – Tableau de chaînes UTF-8.

  Liste des colonnes référencées par la statistique.
+ `ReferencedDatasets` – Tableau de chaînes UTF-8.

  Liste des jeux de données référencés par la statistique.
+ `StatisticProperties` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne Description, d’une longueur ne dépassant pas 2048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  `StatisticPropertiesMap`, qui contient des valeurs `NameString` et `DescriptionString`.
+ `RecordedOn` – Horodatage.

  Horodatage de l’enregistrement de la statistique.
+ `InclusionAnnotation` – Un objet [TimestampedInclusionAnnotation](#aws-glue-api-data-quality-api-TimestampedInclusionAnnotation).

  Annotation d’inclusion pour la statistique.

## RunIdentifier structure
<a name="aws-glue-api-data-quality-api-RunIdentifier"></a>

Identifiant d’exécution.

**Champs**
+ `RunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de l’exécution.
+ `JobRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de l’exécution de la tâche.

## StatisticModelResult structure
<a name="aws-glue-api-data-quality-api-StatisticModelResult"></a>

Résultat du modèle statistique.

**Champs**
+ `LowerBound` – Nombre (double).

  Limite inférieure.
+ `UpperBound` – Nombre (double).

  Limite supérieure.
+ `PredictedValue` – Nombre (double).

  Valeur prédite.
+ `ActualValue` – Nombre (double).

  Valeur réelle.
+ `Date` – Horodatage.

  Date.
+ `InclusionAnnotation` – Chaîne UTF-8 (valeurs valides : `INCLUDE` \$1 `EXCLUDE`).

  Annotation d’inclusion.

## DataQualityGlueTable structure
<a name="aws-glue-api-data-quality-api-DataQualityGlueTable"></a>

Base de données et table utilisées pour AWS Glue Data Catalog les données d'entrée ou de sortie pour les opérations de qualité des données.

**Champs**
+ `DatabaseName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la base de données dans le AWS Glue Data Catalog.
+ `TableName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la table dans AWS Glue Data Catalog.
+ `CatalogId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant unique pour AWS Glue Data Catalog.
+ `ConnectionName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la connexion à AWS Glue Data Catalog.
+ `AdditionalOptions` – Tableau de mappage de paires valeur-clé, pas moins de 1 ou plus de 10 paires..

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est une chaîne Description, d’une longueur ne dépassant pas 2048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Options supplémentaires pour la table. Actuellement, deux clés sont prises en charge :
  + `pushDownPredicate` : pour filtrer les partitions sans avoir à répertorier ni lire tous les fichiers de votre jeu de données.
  + `catalogPartitionPredicate` : pour utiliser le nettoyage de partition côté serveur à l’aide des index de partition du AWS Glue Data Catalog.
+ `PreProcessingQuery`— Chaîne UTF-8, d'une longueur maximale de 51 200 octets, correspondant au. [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  Requête SQL au format SparkSQL qui peut être utilisée pour prétraiter les données de la table AWS Glue Data Catalog dans, avant d'exécuter l'opération de qualité des données.

## Opérations
<a name="aws-glue-api-data-quality-api-actions"></a>
+ [StartDataQualityRulesetEvaluationRun action (Python : start\$1data\$1quality\$1ruleset\$1evaluation\$1run)](#aws-glue-api-data-quality-api-StartDataQualityRulesetEvaluationRun)
+ [CancelDataQualityRulesetEvaluationRun action (Python : cancel\$1data\$1quality\$1ruleset\$1evaluation\$1run)](#aws-glue-api-data-quality-api-CancelDataQualityRulesetEvaluationRun)
+ [GetDataQualityRulesetEvaluationRun action (Python : get\$1data\$1quality\$1ruleset\$1evaluation\$1run)](#aws-glue-api-data-quality-api-GetDataQualityRulesetEvaluationRun)
+ [ListDataQualityRulesetEvaluationRuns action (Python : list\$1data\$1quality\$1ruleset\$1evaluation\$1runs)](#aws-glue-api-data-quality-api-ListDataQualityRulesetEvaluationRuns)
+ [StartDataQualityRuleRecommendationRun action (Python : start\$1data\$1quality\$1rule\$1recommendation\$1run)](#aws-glue-api-data-quality-api-StartDataQualityRuleRecommendationRun)
+ [CancelDataQualityRuleRecommendationRun action (Python : cancel\$1data\$1quality\$1rule\$1recommendation\$1run)](#aws-glue-api-data-quality-api-CancelDataQualityRuleRecommendationRun)
+ [GetDataQualityRuleRecommendationRun action (Python : get\$1data\$1quality\$1rule\$1recommendation\$1run)](#aws-glue-api-data-quality-api-GetDataQualityRuleRecommendationRun)
+ [ListDataQualityRuleRecommendationRuns action (Python : list\$1data\$1quality\$1rule\$1recommendation\$1runs)](#aws-glue-api-data-quality-api-ListDataQualityRuleRecommendationRuns)
+ [GetDataQualityResult action (Python : get\$1data\$1quality\$1result)](#aws-glue-api-data-quality-api-GetDataQualityResult)
+ [BatchGetDataQualityResult action (Python : batch\$1get\$1data\$1quality\$1result)](#aws-glue-api-data-quality-api-BatchGetDataQualityResult)
+ [ListDataQualityResults action (Python : list\$1data\$1quality\$1results)](#aws-glue-api-data-quality-api-ListDataQualityResults)
+ [CreateDataQualityRuleset action (Python : create\$1data\$1quality\$1ruleset)](#aws-glue-api-data-quality-api-CreateDataQualityRuleset)
+ [DeleteDataQualityRuleset action (Python : delete\$1data\$1quality\$1ruleset)](#aws-glue-api-data-quality-api-DeleteDataQualityRuleset)
+ [GetDataQualityRuleset action (Python : get\$1data\$1quality\$1ruleset)](#aws-glue-api-data-quality-api-GetDataQualityRuleset)
+ [ListDataQualityRulesets action (Python : list\$1data\$1quality\$1rulesets)](#aws-glue-api-data-quality-api-ListDataQualityRulesets)
+ [UpdateDataQualityRuleset action (Python : update\$1data\$1quality\$1ruleset)](#aws-glue-api-data-quality-api-UpdateDataQualityRuleset)
+ [ListDataQualityStatistics action (Python : list\$1data\$1quality\$1statistics)](#aws-glue-api-data-quality-api-ListDataQualityStatistics)
+ [TimestampFilter structure](#aws-glue-api-data-quality-api-TimestampFilter)
+ [CreateDataQualityRulesetRequest structure](#aws-glue-api-data-quality-api-CreateDataQualityRulesetRequest)
+ [GetDataQualityRulesetResponse structure](#aws-glue-api-data-quality-api-GetDataQualityRulesetResponse)
+ [GetDataQualityResultResponse structure](#aws-glue-api-data-quality-api-GetDataQualityResultResponse)
+ [StartDataQualityRuleRecommendationRunRequest structure](#aws-glue-api-data-quality-api-StartDataQualityRuleRecommendationRunRequest)
+ [GetDataQualityRuleRecommendationRunResponse structure](#aws-glue-api-data-quality-api-GetDataQualityRuleRecommendationRunResponse)
+ [BatchPutDataQualityStatisticAnnotation action (Python : batch\$1put\$1data\$1quality\$1statistic\$1annotation)](#aws-glue-api-data-quality-api-BatchPutDataQualityStatisticAnnotation)
+ [GetDataQualityModel action (Python : get\$1data\$1quality\$1model)](#aws-glue-api-data-quality-api-GetDataQualityModel)
+ [GetDataQualityModelResult action (Python : get\$1data\$1quality\$1model\$1result)](#aws-glue-api-data-quality-api-GetDataQualityModelResult)
+ [ListDataQualityStatisticAnnotations action (Python : list\$1data\$1quality\$1statistic\$1annotations)](#aws-glue-api-data-quality-api-ListDataQualityStatisticAnnotations)
+ [PutDataQualityProfileAnnotation action (Python : put\$1data\$1quality\$1profile\$1annotation)](#aws-glue-api-data-quality-api-PutDataQualityProfileAnnotation)

## StartDataQualityRulesetEvaluationRun action (Python : start\$1data\$1quality\$1ruleset\$1evaluation\$1run)
<a name="aws-glue-api-data-quality-api-StartDataQualityRulesetEvaluationRun"></a>

Une fois que vous avez une définition d'ensemble de règles (recommandée ou la vôtre), vous appelez cette opération pour évaluer l'ensemble de règles par rapport à une source de données (AWS Glue table). L'évaluation calcule les résultats que vous pouvez récupérer à l'aide de l'API `GetDataQualityResult`.

**Demande**
+ `DataSource` – *Obligatoire :* un objet [DataSource](#aws-glue-api-data-quality-api-DataSource).

  La source de données (AWS Glue table) associée à cette exécution.
+ `Role` – *Obligatoire :* chaîne UTF-8.

   IAM Rôle fourni pour chiffrer les résultats de l'exécution.
+ `NumberOfWorkers` : nombre (entier).

  Nombre d'employés `G.1X` à utiliser dans l'exécution. La valeur par défaut est 5.
+ `Timeout` – Nombre (entier), au moins égal à 1.

  Délai d'expiration d'une exécution en minutes. Durée maximale pendant laquelle une exécution peut consommer des ressources avant qu'elle ne se termine et n'entre dans l'état `TIMEOUT`. La valeur par défaut est de 2 880 minutes (48 heures).
+ `ClientToken` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Utilisée pour l'idempotence  ; il est recommandé de la définir sur un ID aléatoire (tel qu'un UUID) afin d'éviter de créer ou de démarrer plusieurs instances de la même ressource.
+ `AdditionalRunOptions` – Un objet [DataQualityEvaluationRunAdditionalRunOptions](#aws-glue-api-data-quality-api-DataQualityEvaluationRunAdditionalRunOptions).

  Options d'exécution supplémentaires que vous pouvez spécifier pour une exécution d'évaluation.
+ `RulesetNames` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 10 chaînes maximum.

  Liste de noms d'ensembles de règles.
+ `AdditionalDataSources` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est un objet [DataSource](#aws-glue-api-data-quality-api-DataSource).

  Une carte de chaînes de référence vers des sources de données supplémentaires que vous pouvez spécifier pour une exécution d'évaluation.

**Réponse**
+ `RunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant d’exécution unique associé à cette exécution.

**Erreurs**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `ConflictException`

## CancelDataQualityRulesetEvaluationRun action (Python : cancel\$1data\$1quality\$1ruleset\$1evaluation\$1run)
<a name="aws-glue-api-data-quality-api-CancelDataQualityRulesetEvaluationRun"></a>

Annule une exécution au cours de laquelle un ensemble de règles est évalué par rapport à une source de données.

**Demande**
+ `RunId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant d’exécution unique associé à cette exécution.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## GetDataQualityRulesetEvaluationRun action (Python : get\$1data\$1quality\$1ruleset\$1evaluation\$1run)
<a name="aws-glue-api-data-quality-api-GetDataQualityRulesetEvaluationRun"></a>

Récupère une exécution spécifique au cours de laquelle un ensemble de règles est évalué par rapport à une source de données.

**Demande**
+ `RunId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant d’exécution unique associé à cette exécution.

**Réponse**
+ `RunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant d’exécution unique associé à cette exécution.
+ `DataSource` – Un objet [DataSource](#aws-glue-api-data-quality-api-DataSource).

  La source de données (une AWS Glue table) associée à cette exécution d'évaluation.
+ `Role` – Chaîne UTF-8.

   IAM Rôle fourni pour chiffrer les résultats de l'exécution.
+ `NumberOfWorkers` : nombre (entier).

  Nombre d'employés `G.1X` à utiliser dans l'exécution. La valeur par défaut est 5.
+ `Timeout` – Nombre (entier), au moins égal à 1.

  Délai d'expiration d'une exécution en minutes. Durée maximale pendant laquelle une exécution peut consommer des ressources avant qu'elle ne se termine et n'entre dans l'état `TIMEOUT`. La valeur par défaut est de 2 880 minutes (48 heures).
+ `AdditionalRunOptions` – Un objet [DataQualityEvaluationRunAdditionalRunOptions](#aws-glue-api-data-quality-api-DataQualityEvaluationRunAdditionalRunOptions).

  Options d'exécution supplémentaires que vous pouvez spécifier pour une exécution d'évaluation.
+ `Status` – Chaîne UTF-8 (valeurs valides : `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  Statut de cette exécution.
+ `ErrorString` – Chaîne UTF-8.

  Chaînes d'erreur associées à l'exécution.
+ `StartedOn` – Horodatage.

  Date et heure de lancement de cette exécution.
+ `LastModifiedOn` – Horodatage.

  Horodatage. Dernier moment où cette exécution de recommandation de règle de qualité des données a été modifiée.
+ `CompletedOn` – Horodatage.

  Date et heure de fin de cette exécution.
+ `ExecutionTime` : nombre (entier).

  Durée (en secondes) pendant laquelle l'exécution a consommé des ressources.
+ `RulesetNames` – Tableau de chaînes UTF-8, avec 1 chaîne minimum et 10 chaînes maximum.

  Liste des noms des ensembles de règles utilisés pour l'exécution. Actuellement, ce paramètre ne peut avoir qu’un seul nom d’ensemble de règles.
+ `ResultIds` – Tableau de chaînes UTF-8, avec 1 chaîne minimum et 10 chaînes maximum.

  Liste des résultats IDs relatifs à la qualité des données obtenus lors de l'exécution.
+ `AdditionalDataSources` – Tableau de mappage de paires valeur-clé.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaque valeur est un objet [DataSource](#aws-glue-api-data-quality-api-DataSource).

  Une carte de chaînes de référence vers des sources de données supplémentaires que vous pouvez spécifier pour une exécution d'évaluation.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## ListDataQualityRulesetEvaluationRuns action (Python : list\$1data\$1quality\$1ruleset\$1evaluation\$1runs)
<a name="aws-glue-api-data-quality-api-ListDataQualityRulesetEvaluationRuns"></a>

Répertorie l'ensemble des exécutions répondant aux critères de filtrage, lorsqu'un ensemble de règles est évalué par rapport à une source de données.

**Demande**
+ `Filter` – Un objet [DataQualityRulesetEvaluationRunFilter](#aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunFilter).

  Critères de filtrage.
+ `NextToken` – Chaîne UTF-8.

  Jeton de pagination pour décaler les résultats.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximal de résultats à renvoyer.

**Réponse**
+ `Runs` : un tableau d’objets [DataQualityRulesetEvaluationRunDescription](#aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunDescription).

  Liste d'objets `DataQualityRulesetEvaluationRunDescription` représentant les exécutions d'un ensemble de règles en matière de qualité des données.
+ `NextToken` – Chaîne UTF-8.

  Un jeton de pagination, si d'autres résultats sont disponibles.

**Erreurs**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## StartDataQualityRuleRecommendationRun action (Python : start\$1data\$1quality\$1rule\$1recommendation\$1run)
<a name="aws-glue-api-data-quality-api-StartDataQualityRuleRecommendationRun"></a>

Lance une série de recommandations qui est utilisée pour générer des règles lorsque vous ne savez pas quelles règles écrire. AWS Glue Data Quality analyse les données et formule des recommandations pour un ensemble de règles potentiel. Vous pouvez ensuite trier l'ensemble de règles et modifier l'ensemble de règles généré selon votre convenance.

Les exécutions de recommandations sont automatiquement supprimées après 90 jours.

**Demande**

La demande de recommandation d’une règle de qualité des données.
+ `DataSource` – *Obligatoire :* un objet [DataSource](#aws-glue-api-data-quality-api-DataSource).

  La source de données (AWS Glue table) associée à cette exécution.
+ `Role` – *Obligatoire :* chaîne UTF-8.

   IAM Rôle fourni pour chiffrer les résultats de l'exécution.
+ `NumberOfWorkers` : nombre (entier).

  Nombre d'employés `G.1X` à utiliser dans l'exécution. La valeur par défaut est 5.
+ `Timeout` – Nombre (entier), au moins égal à 1.

  Délai d'expiration d'une exécution en minutes. Durée maximale pendant laquelle une exécution peut consommer des ressources avant qu'elle ne se termine et n'entre dans l'état `TIMEOUT`. La valeur par défaut est de 2 880 minutes (48 heures).
+ `CreatedRulesetName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'ensemble de règles.
+ `DataQualitySecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la configuration de sécurité créée avec l’option de chiffrement de la qualité des données.
+ `ClientToken` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Utilisée pour l'idempotence  ; il est recommandé de la définir sur un ID aléatoire (tel qu'un UUID) afin d'éviter de créer ou de démarrer plusieurs instances de la même ressource.

**Réponse**
+ `RunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant d’exécution unique associé à cette exécution.

**Erreurs**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `ConflictException`

## CancelDataQualityRuleRecommendationRun action (Python : cancel\$1data\$1quality\$1rule\$1recommendation\$1run)
<a name="aws-glue-api-data-quality-api-CancelDataQualityRuleRecommendationRun"></a>

Annule l'exécution de recommandation spécifiée qui était utilisée pour générer des règles.

**Demande**
+ `RunId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant d’exécution unique associé à cette exécution.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## GetDataQualityRuleRecommendationRun action (Python : get\$1data\$1quality\$1rule\$1recommendation\$1run)
<a name="aws-glue-api-data-quality-api-GetDataQualityRuleRecommendationRun"></a>

Obtient l'exécution de recommandation spécifiée qui a été utilisée pour générer des règles.

**Demande**
+ `RunId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant d’exécution unique associé à cette exécution.

**Réponse**

La réponse à l’exécution de la recommandation d’une règle de qualité des données.
+ `RunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant d’exécution unique associé à cette exécution.
+ `DataSource` – Un objet [DataSource](#aws-glue-api-data-quality-api-DataSource).

  La source de données (une AWS Glue table) associée à cette exécution.
+ `Role` – Chaîne UTF-8.

   IAM Rôle fourni pour chiffrer les résultats de l'exécution.
+ `NumberOfWorkers` : nombre (entier).

  Nombre d'employés `G.1X` à utiliser dans l'exécution. La valeur par défaut est 5.
+ `Timeout` – Nombre (entier), au moins égal à 1.

  Délai d'expiration d'une exécution en minutes. Durée maximale pendant laquelle une exécution peut consommer des ressources avant qu'elle ne se termine et n'entre dans l'état `TIMEOUT`. La valeur par défaut est de 2 880 minutes (48 heures).
+ `Status` – Chaîne UTF-8 (valeurs valides : `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  Statut de cette exécution.
+ `ErrorString` – Chaîne UTF-8.

  Chaînes d'erreur associées à l'exécution.
+ `StartedOn` – Horodatage.

  Date et heure de lancement de cette exécution.
+ `LastModifiedOn` – Horodatage.

  Horodatage. Dernier moment où cette exécution de recommandation de règle de qualité des données a été modifiée.
+ `CompletedOn` – Horodatage.

  Date et heure de fin de cette exécution.
+ `ExecutionTime` : nombre (entier).

  Durée (en secondes) pendant laquelle l'exécution a consommé des ressources.
+ `RecommendedRuleset` – Chaîne UTF-8, d'une longueur comprise entre 1 et 65536 octets.

  À la fin de l'exécution d'une recommandation de règle de démarrage, un ensemble de règles recommandé est créé. Ce membre dispose de ces règles au format DQDL (Data Quality Definition Language).
+ `CreatedRulesetName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'ensemble de règles créé par l'exécution.
+ `DataQualitySecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la configuration de sécurité créée avec l’option de chiffrement de la qualité des données.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## ListDataQualityRuleRecommendationRuns action (Python : list\$1data\$1quality\$1rule\$1recommendation\$1runs)
<a name="aws-glue-api-data-quality-api-ListDataQualityRuleRecommendationRuns"></a>

Répertorie les exécutions de recommandation répondant aux critères de filtrage.

**Demande**
+ `Filter` – Un objet [DataQualityRuleRecommendationRunFilter](#aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunFilter).

  Critères de filtrage.
+ `NextToken` – Chaîne UTF-8.

  Jeton de pagination pour décaler les résultats.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximal de résultats à renvoyer.

**Réponse**
+ `Runs` : un tableau d’objets [DataQualityRuleRecommendationRunDescription](#aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunDescription).

  Liste d’objets `DataQualityRuleRecommendationRunDescription`.
+ `NextToken` – Chaîne UTF-8.

  Un jeton de pagination, si d'autres résultats sont disponibles.

**Erreurs**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## GetDataQualityResult action (Python : get\$1data\$1quality\$1result)
<a name="aws-glue-api-data-quality-api-GetDataQualityResult"></a>

Récupère le résultat d'une évaluation des règles de qualité des données.

**Demande**
+ `ResultId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de résultat unique pour le résultat en matière de qualité des données.

**Réponse**

La réponse pour le résultat en matière de qualité des données.
+ `ResultId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de résultat unique pour le résultat en matière de qualité des données.
+ `ProfileId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID de profil pour le résultat en matière de qualité des données.
+ `Score` – Nombre (double), au plus égal à 1,0.

  Score de qualité des données agrégées. Représente le rapport entre le nombre de règles transmises et le nombre total de règles.
+ `DataSource` – Un objet [DataSource](#aws-glue-api-data-quality-api-DataSource).

  Table associée au résultat sur la qualité des données, le cas échéant.
+ `RulesetName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'ensemble de règles associé au résultat sur la qualité des données.
+ `EvaluationContext` – Chaîne UTF-8.

  Dans le contexte d'une tâche dans AWS Glue Studio, chaque nœud du canevas se voit généralement attribuer un nom et les nœuds de qualité des données porteront un nom. Dans le cas de plusieurs nœuds, `evaluationContext` peut distinguer les nœuds.
+ `StartedOn` – Horodatage.

  Date et heure du début de l'exécution de ce résultat en matière de qualité des données.
+ `CompletedOn` – Horodatage.

  Date et heure de fin de l'exécution de ce résultat en matière de qualité des données.
+ `JobName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de tâche associé au résultat sur la qualité des données, le cas échéant.
+ `JobRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID d'exécution de la tâche associé au résultat sur la qualité des données, le cas échéant.
+ `RulesetEvaluationRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID d'exécution unique associé à l'évaluation de l'ensemble de règles.
+ `RuleResults` – Un tableau d’objets [DataQualityRuleResult](#aws-glue-api-data-quality-api-DataQualityRuleResult), 2 000 structures au maximum.

  Liste d'objets `DataQualityRuleResult` représentant les résultats de chaque règle. 
+ `AnalyzerResults` – Un tableau d’objets [DataQualityAnalyzerResult](#aws-glue-api-data-quality-api-DataQualityAnalyzerResult), 2 000 structures au maximum.

  Liste d’objets `DataQualityAnalyzerResult` représentant les résultats de chaque analyseur. 
+ `Observations` – Un tableau d'objets [DataQualityObservation](#aws-glue-api-data-quality-api-DataQualityObservation), 50 structures maximum.

  Liste d’objets `DataQualityObservation` représentant les observations générées après évaluation des règles et des analyseurs. 
+ `AggregatedMetrics` – Un objet [DataQualityAggregatedMetrics](#aws-glue-api-data-quality-api-DataQualityAggregatedMetrics).

   Récapitulatif des `DataQualityAggregatedMetrics` objets indiquant le nombre total de lignes et de règles traitées, y compris leurs pass/fail statistiques basées sur les résultats au niveau des lignes. 

**Erreurs**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `EntityNotFoundException`

## BatchGetDataQualityResult action (Python : batch\$1get\$1data\$1quality\$1result)
<a name="aws-glue-api-data-quality-api-BatchGetDataQualityResult"></a>

Récupère une liste des résultats de qualité des données pour le résultat IDs spécifié.

**Demande**
+ `ResultIds` – *Obligatoire :* Tableau de chaînes UTF-8, avec 1 chaîne minimum et 100 chaînes maximum.

  Une liste de résultats uniques IDs pour les résultats relatifs à la qualité des données.

**Réponse**
+ `Results` – *Obligatoire :* un tableau d’objets [DataQualityResult](#aws-glue-api-data-quality-api-DataQualityResult).

  Liste d'objets `DataQualityResult` représentant les résultats en matière de qualité des données.
+ `ResultsNotFound` – Tableau de chaînes UTF-8, avec 1 chaîne minimum et 100 chaînes maximum.

  Liste des résultats IDs pour lesquels aucun résultat n'a été trouvé.

**Erreurs**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## ListDataQualityResults action (Python : list\$1data\$1quality\$1results)
<a name="aws-glue-api-data-quality-api-ListDataQualityResults"></a>

Renvoie tous les résultats d'exécution en matière de qualité des données pour votre compte.

**Demande**
+ `Filter` – Un objet [DataQualityResultFilterCriteria](#aws-glue-api-data-quality-api-DataQualityResultFilterCriteria).

  Critères de filtrage.
+ `NextToken` – Chaîne UTF-8.

  Jeton de pagination pour décaler les résultats.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximal de résultats à renvoyer.

**Réponse**
+ `Results` – *Obligatoire :* un tableau d’objets [DataQualityResultDescription](#aws-glue-api-data-quality-api-DataQualityResultDescription).

  Liste d’objets `DataQualityResultDescription`.
+ `NextToken` – Chaîne UTF-8.

  Un jeton de pagination, si d'autres résultats sont disponibles.

**Erreurs**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## CreateDataQualityRuleset action (Python : create\$1data\$1quality\$1ruleset)
<a name="aws-glue-api-data-quality-api-CreateDataQualityRuleset"></a>

Crée un ensemble de règles de qualité des données avec des règles DQDL appliquées à une table spécifiée AWS Glue .

Vous créez l'ensemble de règles au format DQDL (Data Quality Definition Language). Pour plus d'informations, consultez le guide du AWS Glue développeur.

**Demande**

Demande de création d’un ensemble de règles de qualité des données.
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom unique de l'ensemble de règles de qualité des données.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de l'ensemble de règles de qualité des données.
+ `Ruleset` – *Obligatoire :* chaîne UTF-8, d'une longueur comprise entre 1 et 65536 octets.

  Ensemble de règles DQDL (Data Quality Definition Language). Pour plus d'informations, consultez le guide du AWS Glue développeur.
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Liste de balises appliquées à l'ensemble de règles de qualité des données.
+ `TargetTable` – Un objet [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable).

  Table cible associée à l'ensemble de règles de qualité des données.
+ `RecommendationRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID d'exécution unique pour l'exécution recommandée.
+ `DataQualitySecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la configuration de sécurité créée avec l’option de chiffrement de la qualité des données.
+ `ClientToken` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Utilisée pour l'idempotence  ; il est recommandé de la définir sur un ID aléatoire (tel qu'un UUID) afin d'éviter de créer ou de démarrer plusieurs instances de la même ressource.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom unique de l'ensemble de règles de qualité des données.

**Erreurs**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `ResourceNumberLimitExceededException`

## DeleteDataQualityRuleset action (Python : delete\$1data\$1quality\$1ruleset)
<a name="aws-glue-api-data-quality-api-DeleteDataQualityRuleset"></a>

Supprime un ensemble de règles de qualité des données.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'ensemble de règles de qualité des données.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## GetDataQualityRuleset action (Python : get\$1data\$1quality\$1ruleset)
<a name="aws-glue-api-data-quality-api-GetDataQualityRuleset"></a>

Renvoie un ensemble de règles existant par identifiant ou nom.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de l'ensemble de règles.

**Réponse**

Renvoie la réponse de l’ensemble de règles de qualité des données.
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de l'ensemble de règles.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de l'ensemble de règles.
+ `Ruleset` – Chaîne UTF-8, d'une longueur comprise entre 1 et 65536 octets.

  Ensemble de règles DQDL (Data Quality Definition Language). Pour plus d'informations, consultez le guide du AWS Glue développeur.
+ `TargetTable` – Un objet [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable).

  Nom et nom de la base de données de la table cible.
+ `CreatedOn` – Horodatage.

  Horodatage. Date et heure de création de cet ensemble de règles de qualité des données.
+ `LastModifiedOn` – Horodatage.

  Horodatage. Dernier moment où cet ensemble de règles de qualité des données a été modifié.
+ `RecommendationRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Lors de la création d'un ensemble de règles à partir d'une exécution de recommandation, cet ID d'exécution est généré pour relier les deux.
+ `DataQualitySecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la configuration de sécurité créée avec l’option de chiffrement de la qualité des données.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## ListDataQualityRulesets action (Python : list\$1data\$1quality\$1rulesets)
<a name="aws-glue-api-data-quality-api-ListDataQualityRulesets"></a>

Renvoie une liste paginée d'ensembles de règles pour la liste de tables spécifiée. AWS Glue 

**Demande**
+ `NextToken` – Chaîne UTF-8.

  Jeton de pagination pour décaler les résultats.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximal de résultats à renvoyer.
+ `Filter` – Un objet [DataQualityRulesetFilterCriteria](#aws-glue-api-data-quality-api-DataQualityRulesetFilterCriteria).

  Critères de filtrage. 
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Liste de balises de paire clé-valeur.

**Réponse**
+ `Rulesets` : un tableau d’objets [DataQualityRulesetListDetails](#aws-glue-api-data-quality-api-DataQualityRulesetListDetails).

  Liste paginée d'ensembles de règles pour la liste de tables spécifiée. AWS Glue 
+ `NextToken` – Chaîne UTF-8.

  Un jeton de pagination, si d'autres résultats sont disponibles.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## UpdateDataQualityRuleset action (Python : update\$1data\$1quality\$1ruleset)
<a name="aws-glue-api-data-quality-api-UpdateDataQualityRuleset"></a>

Met à jour l'ensemble de règles de qualité des données spécifié.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'ensemble de règles de qualité des données.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de l'ensemble de règles.
+ `Ruleset` – Chaîne UTF-8, d'une longueur comprise entre 1 et 65536 octets.

  Ensemble de règles DQDL (Data Quality Definition Language). Pour plus d'informations, consultez le guide du AWS Glue développeur.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'ensemble de règles de qualité des données.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de l'ensemble de règles.
+ `Ruleset` – Chaîne UTF-8, d'une longueur comprise entre 1 et 65536 octets.

  Ensemble de règles DQDL (Data Quality Definition Language). Pour plus d'informations, consultez le guide du AWS Glue développeur.

**Erreurs**
+ `EntityNotFoundException`
+ `AlreadyExistsException`
+ `IdempotentParameterMismatchException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `ResourceNumberLimitExceededException`

## ListDataQualityStatistics action (Python : list\$1data\$1quality\$1statistics)
<a name="aws-glue-api-data-quality-api-ListDataQualityStatistics"></a>

Récupère la liste des statistiques de qualité des données.

**Demande**
+ `StatisticId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID de statistique.
+ `ProfileId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID de profil.
+ `TimestampFilter` – Un objet [TimestampFilter](#aws-glue-api-data-quality-api-TimestampFilter).

  Un filtre d’horodatage.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximal de résultats à renvoyer dans cette demande.
+ `NextToken` – Chaîne UTF-8.

  Un jeton de pagination pour demander la page de résultats suivante.

**Réponse**
+ `Statistics` : un tableau d’objets [StatisticSummary](#aws-glue-api-data-quality-api-StatisticSummary).

  Une `StatisticSummaryList`.
+ `NextToken` – Chaîne UTF-8.

  Un jeton de pagination pour demander la page de résultats suivante.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`

## TimestampFilter structure
<a name="aws-glue-api-data-quality-api-TimestampFilter"></a>

Un filtre d’horodatage.

**Champs**
+ `RecordedBefore` – Horodatage.

  Horodatage avant lequel les statistiques doivent être incluses dans les résultats.
+ `RecordedAfter` – Horodatage.

  Horodatage après lequel les statistiques doivent être incluses dans les résultats.

## CreateDataQualityRulesetRequest structure
<a name="aws-glue-api-data-quality-api-CreateDataQualityRulesetRequest"></a>

Demande de création d’un ensemble de règles de qualité des données.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom unique de l'ensemble de règles de qualité des données.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de l'ensemble de règles de qualité des données.
+ `Ruleset` – *Obligatoire :* chaîne UTF-8, d'une longueur comprise entre 1 et 65536 octets.

  Ensemble de règles DQDL (Data Quality Definition Language). Pour plus d'informations, consultez le guide du AWS Glue développeur.
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Liste de balises appliquées à l'ensemble de règles de qualité des données.
+ `TargetTable` – Un objet [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable).

  Table cible associée à l'ensemble de règles de qualité des données.
+ `RecommendationRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID d'exécution unique pour l'exécution recommandée.
+ `DataQualitySecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la configuration de sécurité créée avec l’option de chiffrement de la qualité des données.
+ `ClientToken` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Utilisée pour l'idempotence  ; il est recommandé de la définir sur un ID aléatoire (tel qu'un UUID) afin d'éviter de créer ou de démarrer plusieurs instances de la même ressource.

## GetDataQualityRulesetResponse structure
<a name="aws-glue-api-data-quality-api-GetDataQualityRulesetResponse"></a>

Renvoie la réponse de l’ensemble de règles de qualité des données.

**Champs**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de l'ensemble de règles.
+ `Description` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Description de l'ensemble de règles.
+ `Ruleset` – Chaîne UTF-8, d'une longueur comprise entre 1 et 65536 octets.

  Ensemble de règles DQDL (Data Quality Definition Language). Pour plus d'informations, consultez le guide du AWS Glue développeur.
+ `TargetTable` – Un objet [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable).

  Nom et nom de la base de données de la table cible.
+ `CreatedOn` – Horodatage.

  Horodatage. Date et heure de création de cet ensemble de règles de qualité des données.
+ `LastModifiedOn` – Horodatage.

  Horodatage. Dernier moment où cet ensemble de règles de qualité des données a été modifié.
+ `RecommendationRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Lors de la création d'un ensemble de règles à partir d'une exécution de recommandation, cet ID d'exécution est généré pour relier les deux.
+ `DataQualitySecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la configuration de sécurité créée avec l’option de chiffrement de la qualité des données.

## GetDataQualityResultResponse structure
<a name="aws-glue-api-data-quality-api-GetDataQualityResultResponse"></a>

La réponse pour le résultat en matière de qualité des données.

**Champs**
+ `ResultId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de résultat unique pour le résultat en matière de qualité des données.
+ `ProfileId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID de profil pour le résultat en matière de qualité des données.
+ `Score` – Nombre (double), au plus égal à 1,0.

  Score de qualité des données agrégées. Représente le rapport entre le nombre de règles transmises et le nombre total de règles.
+ `DataSource` – Un objet [DataSource](#aws-glue-api-data-quality-api-DataSource).

  Table associée au résultat sur la qualité des données, le cas échéant.
+ `RulesetName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'ensemble de règles associé au résultat sur la qualité des données.
+ `EvaluationContext` – Chaîne UTF-8.

  Dans le contexte d'une tâche dans AWS Glue Studio, chaque nœud du canevas se voit généralement attribuer un nom et les nœuds de qualité des données porteront un nom. Dans le cas de plusieurs nœuds, `evaluationContext` peut distinguer les nœuds.
+ `StartedOn` – Horodatage.

  Date et heure du début de l'exécution de ce résultat en matière de qualité des données.
+ `CompletedOn` – Horodatage.

  Date et heure de fin de l'exécution de ce résultat en matière de qualité des données.
+ `JobName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom de tâche associé au résultat sur la qualité des données, le cas échéant.
+ `JobRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID d'exécution de la tâche associé au résultat sur la qualité des données, le cas échéant.
+ `RulesetEvaluationRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID d'exécution unique associé à l'évaluation de l'ensemble de règles.
+ `RuleResults` – Un tableau d’objets [DataQualityRuleResult](#aws-glue-api-data-quality-api-DataQualityRuleResult), 2 000 structures au maximum.

  Liste d'objets `DataQualityRuleResult` représentant les résultats de chaque règle. 
+ `AnalyzerResults` – Un tableau d’objets [DataQualityAnalyzerResult](#aws-glue-api-data-quality-api-DataQualityAnalyzerResult), 2 000 structures au maximum.

  Liste d’objets `DataQualityAnalyzerResult` représentant les résultats de chaque analyseur. 
+ `Observations` – Un tableau d'objets [DataQualityObservation](#aws-glue-api-data-quality-api-DataQualityObservation), 50 structures maximum.

  Liste d’objets `DataQualityObservation` représentant les observations générées après évaluation des règles et des analyseurs. 
+ `AggregatedMetrics` – Un objet [DataQualityAggregatedMetrics](#aws-glue-api-data-quality-api-DataQualityAggregatedMetrics).

   Récapitulatif des `DataQualityAggregatedMetrics` objets indiquant le nombre total de lignes et de règles traitées, y compris leurs pass/fail statistiques basées sur les résultats au niveau des lignes. 

## StartDataQualityRuleRecommendationRunRequest structure
<a name="aws-glue-api-data-quality-api-StartDataQualityRuleRecommendationRunRequest"></a>

La demande de recommandation d’une règle de qualité des données.

**Champs**
+ `DataSource` – *Obligatoire :* un objet [DataSource](#aws-glue-api-data-quality-api-DataSource).

  La source de données (AWS Glue table) associée à cette exécution.
+ `Role` – *Obligatoire :* chaîne UTF-8.

   IAM Rôle fourni pour chiffrer les résultats de l'exécution.
+ `NumberOfWorkers` : nombre (entier).

  Nombre d'employés `G.1X` à utiliser dans l'exécution. La valeur par défaut est 5.
+ `Timeout` – Nombre (entier), au moins égal à 1.

  Délai d'expiration d'une exécution en minutes. Durée maximale pendant laquelle une exécution peut consommer des ressources avant qu'elle ne se termine et n'entre dans l'état `TIMEOUT`. La valeur par défaut est de 2 880 minutes (48 heures).
+ `CreatedRulesetName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'ensemble de règles.
+ `DataQualitySecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la configuration de sécurité créée avec l’option de chiffrement de la qualité des données.
+ `ClientToken` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Utilisée pour l'idempotence  ; il est recommandé de la définir sur un ID aléatoire (tel qu'un UUID) afin d'éviter de créer ou de démarrer plusieurs instances de la même ressource.

## GetDataQualityRuleRecommendationRunResponse structure
<a name="aws-glue-api-data-quality-api-GetDataQualityRuleRecommendationRunResponse"></a>

La réponse à l’exécution de la recommandation d’une règle de qualité des données.

**Champs**
+ `RunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Identifiant d’exécution unique associé à cette exécution.
+ `DataSource` – Un objet [DataSource](#aws-glue-api-data-quality-api-DataSource).

  La source de données (une AWS Glue table) associée à cette exécution.
+ `Role` – Chaîne UTF-8.

   IAM Rôle fourni pour chiffrer les résultats de l'exécution.
+ `NumberOfWorkers` : nombre (entier).

  Nombre d'employés `G.1X` à utiliser dans l'exécution. La valeur par défaut est 5.
+ `Timeout` – Nombre (entier), au moins égal à 1.

  Délai d'expiration d'une exécution en minutes. Durée maximale pendant laquelle une exécution peut consommer des ressources avant qu'elle ne se termine et n'entre dans l'état `TIMEOUT`. La valeur par défaut est de 2 880 minutes (48 heures).
+ `Status` – Chaîne UTF-8 (valeurs valides : `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  Statut de cette exécution.
+ `ErrorString` – Chaîne UTF-8.

  Chaînes d'erreur associées à l'exécution.
+ `StartedOn` – Horodatage.

  Date et heure de lancement de cette exécution.
+ `LastModifiedOn` – Horodatage.

  Horodatage. Dernier moment où cette exécution de recommandation de règle de qualité des données a été modifiée.
+ `CompletedOn` – Horodatage.

  Date et heure de fin de cette exécution.
+ `ExecutionTime` : nombre (entier).

  Durée (en secondes) pendant laquelle l'exécution a consommé des ressources.
+ `RecommendedRuleset` – Chaîne UTF-8, d'une longueur comprise entre 1 et 65536 octets.

  À la fin de l'exécution d'une recommandation de règle de démarrage, un ensemble de règles recommandé est créé. Ce membre dispose de ces règles au format DQDL (Data Quality Definition Language).
+ `CreatedRulesetName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de l'ensemble de règles créé par l'exécution.
+ `DataQualitySecurityConfiguration` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom de la configuration de sécurité créée avec l’option de chiffrement de la qualité des données.

## BatchPutDataQualityStatisticAnnotation action (Python : batch\$1put\$1data\$1quality\$1statistic\$1annotation)
<a name="aws-glue-api-data-quality-api-BatchPutDataQualityStatisticAnnotation"></a>

Annotez les points de données au fil du temps pour une statistique de qualité des données spécifique. L'API nécessite à la fois ProfileID et StatisticID dans le cadre de l'entrée. InclusionAnnotation L’API ne fonctionne que pour un seul élément statisticId sur plusieurs profils.

**Demande**
+ `InclusionAnnotations` – *Obligatoire :* un tableau d’objets [DatapointInclusionAnnotation](#aws-glue-api-data-quality-api-DatapointInclusionAnnotation).

  Une liste de `DatapointInclusionAnnotation`. Ils InclusionAnnotations doivent contenir un ProfileID et un StatisticID. S'il y en a plusieurs InclusionAnnotations, la liste doit faire référence à un seul StatisticID pour plusieurs ProfileID.
+ `ClientToken` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Jeton client.

**Réponse**
+ `FailedInclusionAnnotations` : un tableau d’objets [AnnotationError](#aws-glue-api-data-quality-api-AnnotationError).

  Une liste de `AnnotationError`.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `ResourceNumberLimitExceededException`

## GetDataQualityModel action (Python : get\$1data\$1quality\$1model)
<a name="aws-glue-api-data-quality-api-GetDataQualityModel"></a>

Récupérez l'état d'entraînement du modèle ainsi que des informations supplémentaires (CompletedOn, StartedOn, FailureReason).

**Demande**
+ `StatisticId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID de statistique.
+ `ProfileId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID de profil.

**Réponse**
+ `Status` – Chaîne UTF-8 (valeurs valides : `RUNNING` \$1 `SUCCEEDED` \$1 `FAILED`).

  Statut d’entraînement du modèle de qualité des données.
+ `StartedOn` – Horodatage.

  Horodatage du début de l’entraînement des modèles de qualité des données.
+ `CompletedOn` – Horodatage.

  Horodatage de l’achèvement de l’entraînement des modèles de qualité des données.
+ `FailureReason` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Motif de l’échec de l’entraînement.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## GetDataQualityModelResult action (Python : get\$1data\$1quality\$1model\$1result)
<a name="aws-glue-api-data-quality-api-GetDataQualityModelResult"></a>

Récupérez les prédictions d’une statistique pour un ID de profil donné.

**Demande**
+ `StatisticId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID de statistique.
+ `ProfileId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID de profil.

**Réponse**
+ `CompletedOn` – Horodatage.

  Horodatage de l’achèvement de l’entraînement des modèles de qualité des données.
+ `Model` : un tableau d’objets [StatisticModelResult](#aws-glue-api-data-quality-api-StatisticModelResult).

  Liste de `StatisticModelResult`.

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

## ListDataQualityStatisticAnnotations action (Python : list\$1data\$1quality\$1statistic\$1annotations)
<a name="aws-glue-api-data-quality-api-ListDataQualityStatisticAnnotations"></a>

Récupérez les annotations d’une statistique de qualité des données.

**Demande**
+ `StatisticId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID de statistique.
+ `ProfileId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L’ID de profil.
+ `TimestampFilter` – Un objet [TimestampFilter](#aws-glue-api-data-quality-api-TimestampFilter).

  Un filtre d’horodatage.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximal de résultats à renvoyer dans cette demande.
+ `NextToken` – Chaîne UTF-8.

  Jeton de pagination permettant de récupérer l’ensemble suivant de résultats.

**Réponse**
+ `Annotations` : un tableau d’objets [StatisticAnnotation](#aws-glue-api-data-quality-api-StatisticAnnotation).

  Liste de `StatisticAnnotation` appliquées à la statistique
+ `NextToken` – Chaîne UTF-8.

  Jeton de pagination permettant de récupérer l’ensemble suivant de résultats.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`

## PutDataQualityProfileAnnotation action (Python : put\$1data\$1quality\$1profile\$1annotation)
<a name="aws-glue-api-data-quality-api-PutDataQualityProfileAnnotation"></a>

Annotez tous les points de données d’un profil.

**Demande**
+ `ProfileId` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID du profil de surveillance de la qualité des données à annoter.
+ `InclusionAnnotation` – *Obligatoire :* Chaîne UTF-8 (valeurs valides : `INCLUDE` \$1 `EXCLUDE`).

  Valeur d’annotation d’inclusion à appliquer au profil.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`

# API Détection des données sensibles
<a name="aws-glue-api-sensitive-data-api"></a>

L'API de détection des données sensibles décrit les APIs méthodes utilisées pour détecter les données sensibles dans les colonnes et les lignes de vos données structurées. 

## Types de données
<a name="aws-glue-api-sensitive-data-api-objects"></a>
+ [CustomEntityType structure](#aws-glue-api-sensitive-data-api-CustomEntityType)

## CustomEntityType structure
<a name="aws-glue-api-sensitive-data-api-CustomEntityType"></a>

Objet représentant un modèle personnalisé permettant de détecter des données sensibles sur les colonnes et les lignes de vos données structurées.

**Champs**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du modèle personnalisé qui permet de le récupérer ou de le supprimer ultérieurement. Ce nom doit être unique par AWS compte.
+ `RegexString` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaîne d'expression régulière utilisée pour détecter des données sensibles dans un modèle personnalisé.
+ `ContextWords` – Tableau de chaînes UTF-8, entre 1 et 20 chaînes.

  Une liste de mots contextuels. Si aucun de ces mots contextuels n'est trouvé à proximité de l'expression régulière, les données ne seront pas détectées en tant que données sensibles.

  Si aucun mot contextuel n'est transmis, seule une expression régulière est vérifiée.

## Opérations
<a name="aws-glue-api-sensitive-data-api-actions"></a>
+ [CreateCustomEntityType action (Python : create\$1custom\$1entity\$1type)](#aws-glue-api-sensitive-data-api-CreateCustomEntityType)
+ [DeleteCustomEntityType action (Python : delete\$1custom\$1entity\$1type)](#aws-glue-api-sensitive-data-api-DeleteCustomEntityType)
+ [GetCustomEntityType action (Python : get\$1custom\$1entity\$1type)](#aws-glue-api-sensitive-data-api-GetCustomEntityType)
+ [BatchGetCustomEntityTypes action (Python : batch\$1get\$1custom\$1entity\$1types)](#aws-glue-api-sensitive-data-api-BatchGetCustomEntityTypes)
+ [ListCustomEntityTypes action (Python : list\$1custom\$1entity\$1types)](#aws-glue-api-sensitive-data-api-ListCustomEntityTypes)

## CreateCustomEntityType action (Python : create\$1custom\$1entity\$1type)
<a name="aws-glue-api-sensitive-data-api-CreateCustomEntityType"></a>

Crée un modèle personnalisé utilisé pour détecter les données sensibles sur les colonnes et les lignes de vos données structurées.

Chaque modèle personnalisé que vous créez spécifie une expression régulière et une liste facultative de mots contextuels. Si aucun mot contextuel n'est transmis, seule une expression régulière est vérifiée.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du modèle personnalisé qui permet de le récupérer ou de le supprimer ultérieurement. Ce nom doit être unique par AWS compte.
+ `RegexString` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaîne d'expression régulière utilisée pour détecter des données sensibles dans un modèle personnalisé.
+ `ContextWords` – Tableau de chaînes UTF-8, entre 1 et 20 chaînes.

  Une liste de mots contextuels. Si aucun de ces mots contextuels n'est trouvé à proximité de l'expression régulière, les données ne seront pas détectées en tant que données sensibles.

  Si aucun mot contextuel n'est transmis, seule une expression régulière est vérifiée.
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Liste de balises appliquées à un type d'entité personnalisé.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du modèle personnalisé que vous avez créé.

**Erreurs**
+ `AccessDeniedException`
+ `AlreadyExistsException`
+ `IdempotentParameterMismatchException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`

## DeleteCustomEntityType action (Python : delete\$1custom\$1entity\$1type)
<a name="aws-glue-api-sensitive-data-api-DeleteCustomEntityType"></a>

Supprime un modèle personnalisé en spécifiant son nom.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom du modèle personnalisé que vous souhaitez supprimer.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nom du modèle personnalisé que vous avez supprimé.

**Erreurs**
+ `EntityNotFoundException`
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `OperationTimeoutException`

## GetCustomEntityType action (Python : get\$1custom\$1entity\$1type)
<a name="aws-glue-api-sensitive-data-api-GetCustomEntityType"></a>

Récupère les détails d'un modèle personnalisé en spécifiant son nom.

**Demande**
+ `Name` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom du modèle personnalisé que vous souhaitez récupérer.

**Réponse**
+ `Name` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Le nom du modèle personnalisé que vous avez récupéré.
+ `RegexString` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Chaîne d'expression régulière utilisée pour détecter des données sensibles dans un modèle personnalisé.
+ `ContextWords` – Tableau de chaînes UTF-8, entre 1 et 20 chaînes.

  Liste de mots contextuels, s'il est spécifié lors de la création du modèle personnalisé. Si aucun de ces mots contextuels n'est trouvé à proximité de l'expression régulière, les données ne seront pas détectées en tant que données sensibles.

**Erreurs**
+ `EntityNotFoundException`
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `OperationTimeoutException`

## BatchGetCustomEntityTypes action (Python : batch\$1get\$1custom\$1entity\$1types)
<a name="aws-glue-api-sensitive-data-api-BatchGetCustomEntityTypes"></a>

Récupère les détails des modèles personnalisés spécifiés par une liste de noms.

**Demande**
+ `Names` – *Obligatoire :* tableau de chaînes UTF-8, avec 1 chaîne minimum et 50 chaînes maximum.

  Liste des noms des modèles personnalisés que vous souhaitez récupérer.

**Réponse**
+ `CustomEntityTypes` : un tableau d’objets [CustomEntityType](#aws-glue-api-sensitive-data-api-CustomEntityType).

  Une liste d’objets `CustomEntityType` représentant les modèles personnalisés que vous avez créés.
+ `CustomEntityTypesNotFound` – Tableau de chaînes UTF-8, entre 1 et 50 chaînes.

  Liste des noms de modèles personnalisés qui ont été introuvables.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## ListCustomEntityTypes action (Python : list\$1custom\$1entity\$1types)
<a name="aws-glue-api-sensitive-data-api-ListCustomEntityTypes"></a>

Répertorie tous les modèles personnalisés qui ont été créés.

**Demande**
+ `NextToken` – Chaîne UTF-8.

  Jeton de pagination pour décaler les résultats.
+ `MaxResults` – Nombre (entier), compris entre 1 et 1 000.

  Nombre maximal de résultats à renvoyer.
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Liste de balises de paire clé-valeur.

**Réponse**
+ `CustomEntityTypes` : un tableau d’objets [CustomEntityType](#aws-glue-api-sensitive-data-api-CustomEntityType).

  Une liste d’objets `CustomEntityType` représentant des motifs personnalisés.
+ `NextToken` – Chaîne UTF-8.

  Un jeton de pagination, si d'autres résultats sont disponibles.

**Erreurs**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`

# Marquage APIs AWS Glue
<a name="aws-glue-api-tags"></a>

## Types de données
<a name="aws-glue-api-tags-objects"></a>
+ [Structure Tag](#aws-glue-api-tags-Tag)

## Structure Tag
<a name="aws-glue-api-tags-Tag"></a>

L'`Tag`objet représente une étiquette que vous pouvez attribuer à une AWS ressource. Chaque balise est constituée d’une clé et d’une valeur facultative que vous définissez.

Pour plus d'informations sur les balises et le contrôle de l'accès aux ressources dans AWS Glue, voir [AWS Tags in AWS Glue et Specifying AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html) [Resource ARNs](https://docs.aws.amazon.com/glue/latest/dg/glue-specifying-resource-arns.html) dans le guide du développeur.

**Champs**
+ `key` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Identification de balise. La clé est obligatoire lorsque vous créez une balise sur un objet. La clé est sensible à la casse et ne doit pas contenir le préfixe aws.
+ `value` – Chaîne UTF-8, d’une longueur maximale de 256 octets.

  Valeur de balise. La valeur est facultative lorsque vous créez une balise sur un objet. La valeur est sensible à la casse et ne doit pas contenir le préfixe aws.

## Opérations
<a name="aws-glue-api-tags-actions"></a>
+ [TagResource action (Python : tag\$1resource)](#aws-glue-api-tags-TagResource)
+ [UntagResource action (Python : untag\$1resource)](#aws-glue-api-tags-UntagResource)
+ [GetTags action (Python : get\$1tags)](#aws-glue-api-tags-GetTags)

## TagResource action (Python : tag\$1resource)
<a name="aws-glue-api-tags-TagResource"></a>

Ajoute des balises à une ressource. Une étiquette est une étiquette que vous pouvez attribuer à une AWS ressource. Dans AWS Glue, vous ne pouvez étiqueter que certaines ressources. Pour obtenir des informations sur les ressources que vous pouvez baliser, veuillez consulter la rubrique [Balises AWS dans AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html).

Outre les autorisations de balisage liées aux balises d'appel APIs, vous devez également avoir l'`glue:GetConnection`autorisation de baliser les appels APIs sur les connexions et l'`glue:GetDatabase`autorisation de baliser les appels sur les bases de données APIs .

**Demande**
+ `ResourceArn` – *Obligatoire :* chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  L'ARN de la AWS Glue ressource à laquelle ajouter les balises. Pour plus d'informations sur les AWS Glue ressources ARNs, consultez le [modèle de chaîne AWS Glue ARN](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-common.html#aws-glue-api-regex-aws-glue-arn-id).
+ `TagsToAdd` – *Obligatoire :* Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Balises à ajouter à cette ressource.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `ResourceNotFoundException`

## UntagResource action (Python : untag\$1resource)
<a name="aws-glue-api-tags-UntagResource"></a>

Supprime les balises spécifiées d’une ressource d’intégration.

**Demande**
+ `ResourceArn` – *Obligatoire :* chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  Amazon Resource Name (ARN) de la ressource d’intégration.
+ `TagsToRemove` – *Obligatoire :* Tableau de chaînes UTF-8, avec 50 chaînes maximum.

  Liste des balises de métadonnés à supprimer de la ressource.

**Réponse**
+ *Paramètres d’absence de réponse.*

**Erreurs**
+ `ResourceNotFoundException`

## GetTags action (Python : get\$1tags)
<a name="aws-glue-api-tags-GetTags"></a>

Récupère la liste des balises associées à une ressource.

**Demande**
+ `ResourceArn` – *Obligatoire :* chaîne UTF-8, d'une longueur comprise entre 1 et 10 240 octets, correspondant au [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  Amazon Resource Name (ARN) de la ressource pour laquelle récupérer les balises.

**Réponse**
+ `Tags` – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

  Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

  Balises demandées.

**Erreurs**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `EntityNotFoundException`

# Types de données courants
<a name="aws-glue-api-common"></a>

Les types de données courants décrivent des types de données courants variés dans AWS Glue.

## Structure de balise
<a name="aws-glue-api-common-Tag"></a>

L'`Tag`objet représente une étiquette que vous pouvez attribuer à une AWS ressource. Chaque balise est constituée d’une clé et d’une valeur facultative que vous définissez.

Pour plus d'informations sur les balises et le contrôle de l'accès aux ressources dans AWS Glue, voir [AWS Tags in AWS Glue et Specifying AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html) [Resource ARNs](https://docs.aws.amazon.com/glue/latest/dg/glue-specifying-resource-arns.html) dans le guide du développeur.

**Champs**
+ `key` – Chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

  Identification de balise. La clé est obligatoire lorsque vous créez une balise sur un objet. La clé est sensible à la casse et ne doit pas contenir le préfixe aws.
+ `value` – Chaîne UTF-8, d’une longueur maximale de 256 octets.

  Valeur de balise. La valeur est facultative lorsque vous créez une balise sur un objet. La valeur est sensible à la casse et ne doit pas contenir le préfixe aws.

## DecimalNumber structure
<a name="aws-glue-api-common-DecimalNumber"></a>

Contient une valeur numérique au format décimal.

**Champs**
+ `UnscaledValue` – *obligatoire :* blob.

  Valeur numérique non mise à l'échelle.
+ `Scale` – *obligatoire :* nombre (entier).

  Échelle qui détermine où la virgule décimale tombe dans la valeur non mise à l'échelle.

## ErrorDetail structure
<a name="aws-glue-api-common-ErrorDetail"></a>

Contient des informations détaillées sur une erreur.

**Champs**
+ `ErrorCode` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](#aws-glue-api-regex-oneLine).

  Code associé à cette erreur.
+ `ErrorMessage` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](#aws-glue-api-regex-uri).

  Message décrivant l'erreur.

## PropertyPredicate structure
<a name="aws-glue-api-common-PropertyPredicate"></a>

Définit un prédicat de propriété.

**Champs**
+ `Key` : chaîne de valeurs, d’une longueur comprise entre 1 et 1 024 octets.

  Clé de la propriété.
+ `Value` : chaîne de valeurs, d’une longueur comprise entre 1 et 1 024 octets.

  Valeur de la propriété.
+ `Comparator` – Chaîne UTF-8 (valeurs valides : `EQUALS` \$1 `GREATER_THAN` \$1 `LESS_THAN` \$1 `GREATER_THAN_EQUALS` \$1 `LESS_THAN_EQUALS`).

  Comparateur utilisé pour comparer cette propriété à d'autres.

## ResourceUri structure
<a name="aws-glue-api-common-ResourceUri"></a>

Les ressources URIs de la fonction for.

**Champs**
+ `ResourceType` – Chaîne UTF-8 (valeurs valides : `JAR` \$1 `FILE` \$1 `ARCHIVE`).

  Type de la ressource.
+ `Uri` – Identificateur de ressource uniforme (URI), d'une longueur comprise entre 1 et 1024 octets, correspondant au [URI address multi-line string pattern](#aws-glue-api-regex-uri).

  URI pour accéder à la ressource.

## ColumnStatistics structure
<a name="aws-glue-api-common-ColumnStatistics"></a>

Représente les statistiques au niveau de la colonne générées pour une table ou une partition.

**Champs**
+ `ColumnName` – *Obligatoire :* Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](#aws-glue-api-regex-oneLine).

  Nom de la colonne à laquelle appartiennent les statistiques.
+ `ColumnType` – *obligatoire :* saisissez le nom, d'une longueur maximale de 20 000 octets, correspondant à [Single-line string pattern](#aws-glue-api-regex-oneLine).

  Type de données de la colonne.
+ `AnalyzedTime` – *obligatoire :* horodatage.

  Horodatage du moment où les statistiques de colonne ont été générées.
+ `StatisticsData` – *Obligatoire :* un objet [ColumnStatisticsData](#aws-glue-api-common-ColumnStatisticsData).

  `ColumnStatisticData` qui contient les valeurs de données statistiques.

## ColumnStatisticsError structure
<a name="aws-glue-api-common-ColumnStatisticsError"></a>

Encapsule un objet `ColumnStatistics` qui a échoué et la raison de l'échec.

**Champs**
+ `ColumnStatistics` – Un objet [ColumnStatistics](#aws-glue-api-common-ColumnStatistics).

  `ColumnStatistics` de la colonne.
+ `Error` : un objet [ErrorDetail](#aws-glue-api-common-ErrorDetail).

  Message d'erreur avec la raison de l'échec d'une opération.

## ColumnError structure
<a name="aws-glue-api-common-ColumnError"></a>

Encapsule un nom de colonne qui a échoué et la raison de l'échec.

**Champs**
+ `ColumnName` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](#aws-glue-api-regex-oneLine).

  Nom de la colonne ayant échoué.
+ `Error` : un objet [ErrorDetail](#aws-glue-api-common-ErrorDetail).

  Message d'erreur avec la raison de l'échec d'une opération.

## ColumnStatisticsData structure
<a name="aws-glue-api-common-ColumnStatisticsData"></a>

Contient chacun des types de données statistiques de colonne. Un seul objet de données doit être défini et indiqué par l'attribut `Type`.

**Champs**
+ `Type` – *obligatoire :* chaîne UTF-8 (valeurs valides : `BOOLEAN` \$1 `DATE` \$1 `DECIMAL` \$1 `DOUBLE` \$1 `LONG` \$1 `STRING` \$1 `BINARY`).

  Type de données statistiques de colonne.
+ `BooleanColumnStatisticsData` – Un objet [BooleanColumnStatisticsData](#aws-glue-api-common-BooleanColumnStatisticsData).

  Données statistiques de colonne booléennes.
+ `DateColumnStatisticsData` – Un objet [DateColumnStatisticsData](#aws-glue-api-common-DateColumnStatisticsData).

  Données statistiques de colonne de date.
+ `DecimalColumnStatisticsData` – Un objet [DecimalColumnStatisticsData](#aws-glue-api-common-DecimalColumnStatisticsData).

   Données statistiques sur les colonnes décimales. UnscaledValues à l'intérieur se trouvent des objets binaires codés en Base64 stockant des représentations complémentaires à deux de la valeur décimale non mise à l'échelle. 
+ `DoubleColumnStatisticsData` – Un objet [DoubleColumnStatisticsData](#aws-glue-api-common-DoubleColumnStatisticsData).

  Données statistiques à double colonne.
+ `LongColumnStatisticsData` – Un objet [LongColumnStatisticsData](#aws-glue-api-common-LongColumnStatisticsData).

  Données statistiques de colonne longue.
+ `StringColumnStatisticsData` – Un objet [StringColumnStatisticsData](#aws-glue-api-common-StringColumnStatisticsData).

  Données statistiques de colonne de chaîne.
+ `BinaryColumnStatisticsData` – Un objet [BinaryColumnStatisticsData](#aws-glue-api-common-BinaryColumnStatisticsData).

  Données de statistiques de colonne binaire.

## BooleanColumnStatisticsData structure
<a name="aws-glue-api-common-BooleanColumnStatisticsData"></a>

Définit les statistiques de colonne prises en charge pour les colonnes de données booléennes.

**Champs**
+ `NumberOfTrues` – *obligatoire :* nombre (entier), pas plus que None (Aucun).

  Nombre de valeurs true dans la colonne.
+ `NumberOfFalses` – *obligatoire :* nombre (entier), pas plus que None (Aucun).

  Nombre de valeurs false dans la colonne.
+ `NumberOfNulls` – *obligatoire :* nombre (entier), pas plus que None (Aucun).

  Nombre de valeurs null dans la colonne.

## DateColumnStatisticsData structure
<a name="aws-glue-api-common-DateColumnStatisticsData"></a>

Définit les statistiques de colonne prises en charge pour les colonnes de données d'horodatage.

**Champs**
+ `MinimumValue` – Horodatage.

  Valeur la plus faible dans la colonne.
+ `MaximumValue` – Horodatage.

  Valeur la plus élevée dans la colonne.
+ `NumberOfNulls` – *obligatoire :* nombre (entier), pas plus que None (Aucun).

  Nombre de valeurs null dans la colonne.
+ `NumberOfDistinctValues` – *obligatoire :* nombre (entier), pas plus que None (Aucun).

  Nombre de valeurs distinctes dans une colonne.

## DecimalColumnStatisticsData structure
<a name="aws-glue-api-common-DecimalColumnStatisticsData"></a>

Définit les statistiques de colonne prises en charge pour les colonnes de données à virgule fixe.

**Champs**
+ `MinimumValue` – Un objet [DecimalNumber](#aws-glue-api-common-DecimalNumber).

  Valeur la plus faible dans la colonne.
+ `MaximumValue` – Un objet [DecimalNumber](#aws-glue-api-common-DecimalNumber).

  Valeur la plus élevée dans la colonne.
+ `NumberOfNulls` – *obligatoire :* nombre (entier), pas plus que None (Aucun).

  Nombre de valeurs null dans la colonne.
+ `NumberOfDistinctValues` – *obligatoire :* nombre (entier), pas plus que None (Aucun).

  Nombre de valeurs distinctes dans une colonne.

## DoubleColumnStatisticsData structure
<a name="aws-glue-api-common-DoubleColumnStatisticsData"></a>

Définit les statistiques de colonne prises en charge pour les colonnes de données à virgule flottante.

**Champs**
+ `MinimumValue` – Nombre (double).

  Valeur la plus faible dans la colonne.
+ `MaximumValue` – Nombre (double).

  Valeur la plus élevée dans la colonne.
+ `NumberOfNulls` – *obligatoire :* nombre (entier), pas plus que None (Aucun).

  Nombre de valeurs null dans la colonne.
+ `NumberOfDistinctValues` – *obligatoire :* nombre (entier), pas plus que None (Aucun).

  Nombre de valeurs distinctes dans une colonne.

## LongColumnStatisticsData structure
<a name="aws-glue-api-common-LongColumnStatisticsData"></a>

Définit les statistiques de colonne prises en charge pour les colonnes de données entières.

**Champs**
+ `MinimumValue` – Nombre (long).

  Valeur la plus faible dans la colonne.
+ `MaximumValue` – Nombre (long).

  Valeur la plus élevée dans la colonne.
+ `NumberOfNulls` – *obligatoire :* nombre (entier), pas plus que None (Aucun).

  Nombre de valeurs null dans la colonne.
+ `NumberOfDistinctValues` – *obligatoire :* nombre (entier), pas plus que None (Aucun).

  Nombre de valeurs distinctes dans une colonne.

## StringColumnStatisticsData structure
<a name="aws-glue-api-common-StringColumnStatisticsData"></a>

Définit les statistiques de colonne prises en charge pour les valeurs de données de séquence de caractères.

**Champs**
+ `MaximumLength` – *obligatoire :* nombre (entier), pas plus que None (Aucun).

  Taille de la chaîne la plus longue dans la colonne.
+ `AverageLength` – *obligatoire :* nombre (double), pas plus que None (Aucun).

  Longueur moyenne de la chaîne dans la colonne.
+ `NumberOfNulls` – *obligatoire :* nombre (entier), pas plus que None (Aucun).

  Nombre de valeurs null dans la colonne.
+ `NumberOfDistinctValues` – *obligatoire :* nombre (entier), pas plus que None (Aucun).

  Nombre de valeurs distinctes dans une colonne.

## BinaryColumnStatisticsData structure
<a name="aws-glue-api-common-BinaryColumnStatisticsData"></a>

Définit les statistiques de colonne prises en charge pour les valeurs de données de séquence de bits.

**Champs**
+ `MaximumLength` – *obligatoire :* nombre (entier), pas plus que None (Aucun).

  Taille de la séquence de bits la plus longue de la colonne.
+ `AverageLength` – *obligatoire :* nombre (double), pas plus que None (Aucun).

  Longueur moyenne de la séquence de bits dans la colonne.
+ `NumberOfNulls` – *obligatoire :* nombre (entier), pas plus que None (Aucun).

  Nombre de valeurs null dans la colonne.

## Modèles de chaîne
<a name="aws-glue-api-common-_string-patterns"></a>

L'API utilise les expressions régulières suivantes pour définir le contenu valide pour différents paramètres et membres de chaîne :
+ Modèle de chaîne à ligne unique – "`[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\t]*`"
+ Modèle de chaîne à plusieurs lignes d'adresse URI – "`[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`"
+ Modèle de chaîne Logstash Grok – "`[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\t]*`"
+ Modèle de chaîne d'identifiant – "`[A-Za-z_][A-Za-z0-9_]*`"
+ Modèle de chaîne ARN AWS IAM – "`arn:aws:iam::\d{12}:role/.*`"
+ Modèle de chaîne de version – "`^[a-zA-Z0-9-_]+$`"
+ Modèle de chaîne de groupe de journaux – "`[\.\-_/#A-Za-z0-9]+`"
+ Modèle de chaîne de flux de journaux – "`[^:*]*`"
+ Modèle de chaîne personnalisée \$110 – "`[a-zA-Z0-9-_]+`"
+ Modèle de chaîne personnalisée \$111 – "`[-a-zA-Z0-9+=/:_]*`"
+ Modèle de chaîne personnalisée \$112 – "`[\S\s]*`"
+ Modèle de chaîne personnalisée \$113 – "`.*\S.*`"
+ Modèle de chaîne personnalisée \$114 – "`[a-zA-Z0-9-=._/@]+`"
+ Modèle de chaîne personnalisée \$115 – "`[1-9][0-9]*|[1-9][0-9]*-[1-9][0-9]*`"
+ Modèle de chaîne personnalisée \$116 – "`[A-Z][A-Za-z\.]+`"
+ Modèle de chaîne personnalisée \$117 – "`[\S]*`"
+ Modèle de chaîne personnalisée \$118 – "`[\w]*`"
+ Modèle de chaîne personnalisée \$119 – "`arn:aws[a-z\-]*:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`"
+ Modèle de chaîne personnalisée \$120 – "`subnet-[a-z0-9]+`"
+ Modèle de chaîne personnalisée \$121 – "`\d{12}`"
+ Modèle de chaîne personnalisée \$122 – "`([a-z]+)-([a-z]+-)?([a-z]+)-[0-9]+[a-z]+`"
+ Modèle de chaîne personnalisée \$123 – "`[a-zA-Z0-9.-]*`"
+ Modèle de chaîne personnalisée \$124 – « `arn:aws[a-z0-9\-]*:lambda:[a-z0-9\-]+:\d{12}:function:([\w\-]{1,64})` »
+ Modèle de chaîne personnalisée \$125 – « `^(?!(.*[.\/\\]|aws:)).*$` »
+ Modèle de chaîne personnalisée \$126 – « `[^\r\n]` »
+ Modèle de chaîne personnalisée \$127 – « `^\w+\.\w+\.\w+$` »
+ Modèle de chaîne personnalisée \$128 – « `^\w+\.\w+$` »
+ Modèle de chaîne personnalisée \$129 – « `^$|arn:aws[a-z0-9-]*:kms:.*` »
+ Modèle de chaîne personnalisée \$130 – « `arn:aws[^:]*:iam::[0-9]*:role/.+` »
+ Modèle de chaîne personnalisée \$131 – « `[\.\-_A-Za-z0-9]+` »
+ Modèle de chaîne personnalisée \$132 – « `^s3://([^/]+)/([^/]+/)*([^/]+)$` »
+ Modèle de chaîne personnalisée \$133 – « `.*` »
+ Modèle de chaîne personnalisée \$134 – « `^(Sun|Mon|Tue|Wed|Thu|Fri|Sat):([01]?[0-9]|2[0-3])$` »
+ Modèle de chaîne personnalisée n° 35 – « `[a-zA-Z0-9_.-]+` »
+ Schéma de chaîne personnalisé \$136 — « `^arn:aws(-(cn|us-gov|eusc|iso(-[bef])?))?:secretsmanager:.*$` »
+ Modèle de chaîne personnalisée n° 37 : « `\S+` »
+ Modèle de chaîne personnalisée n° 38 : « `^[\x20-\x7E]*$` »
+ Modèle de chaîne personnalisée n° 39 : « `^([a-zA-Z0-9_=]+)\.([a-zA-Z0-9_=]+)\.([a-zA-Z0-9_\-\+\/=]*)` »
+ Modèle de chaîne personnalisée n° 40 : « `^(https?)://[-a-zA-Z0-9+&@#/%?=~_|!:,.;]*[-a-zA-Z0-9+&@#/%=~_|]` »
+ Modèle de chaîne personnalisée n° 41 : « `^(https?):\/\/[^\s/$.?#].[^\s]*$` »
+ Modèle de chaîne personnalisée n° 42 : « `arn:aws:kms:.*` »
+ Modèle de chaîne personnalisée n° 43 : « `^subnet-[a-z0-9]+$` »
+ Modèle de chaîne personnalisée n° 44 : « `[\p{L}\p{N}\p{P}]*` »
+ Modèle de chaîne personnalisée n° 45 : « `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` »
+ Modèle de chaîne personnalisée n° 46 : « `[a-zA-Z0-9-_$#.]+` »
+ Modèle de chaîne personnalisée n° 47 : « `^\d{12}$` »
+ Modèle de chaîne personnalisée n° 48 : « `^(\w+\.)+\w+$` »
+ Modèle de chaîne personnalisée n° 49 : « `^([2-3]|3[.]9)$` »
+ Modèle de chaîne personnalisée n° 50 : « `arn:aws(-(cn|us-gov|eusc|iso(-[bef])?))?:glue:.*` »
+ Modèle de chaîne personnalisée n° 51 : « `[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}` »
+ Modèle de chaîne personnalisée n° 52 : « `(^arn:aws(-(cn|us-gov|eusc|iso(-[bef])?))?:iam::\w{12}:root)` »
+ Modèle de chaîne personnalisée n° 53 : « `^arn:aws(-(cn|us-gov|eusc|iso(-[bef])?))?:iam::[0-9]{12}:role/.+` »
+ Modèle de chaîne personnalisée n° 54 : « `[\s\S]*` »
+ Modèle de chaîne personnalisée n° 55 : « `([\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF]|[^\S\r\n"'= ;])*` »
+ Modèle de chaîne personnalisée n° 56 : « `^[A-Z\_]+$` »
+ Modèle de chaîne personnalisée n° 57 : « `^[A-Za-z0-9]+$` »
+ Modèle de chaîne personnalisée n° 58 : « `[*A-Za-z0-9_-]*` »
+ Modèle de chaîne personnalisée n° 59 : « `([\u0020-\u007E\r\s\n])*` »
+ Modèle de chaîne personnalisée n° 60 : « `[A-Za-z0-9_-]*` »
+ Modèle de chaîne personnalisée n° 61 : « `([\u0009\u000B\u000C\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF])*` »
+ Schéma de chaîne personnalisé \$162 — « `([\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\s])*` »
+ Schéma de chaîne personnalisé \$163 — « `([^\r\n])*` »

# Exceptions
<a name="aws-glue-api-exceptions"></a>

Cette section décrit les AWS Glue exceptions que vous pouvez utiliser pour identifier la source des problèmes et les résoudre. Pour plus d’informations sur les chaînes et les codes d’erreur HTTP des exceptions liées au machine learning, consultez [Exceptions AWS Glue liées au machine learning](exceptions-machine-learning.md).

## AccessDeniedException structure
<a name="aws-glue-api-exceptions-AccessDeniedException"></a>

L’accès à une ressource a été refusé.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## AlreadyExistsException structure
<a name="aws-glue-api-exceptions-AlreadyExistsException"></a>

Une ressource à créer ou à ajouter existe déjà.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## ConcurrentModificationException structure
<a name="aws-glue-api-exceptions-ConcurrentModificationException"></a>

Deux processus tentent de modifier une ressource simultanément.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## ConcurrentRunsExceededException structure
<a name="aws-glue-api-exceptions-ConcurrentRunsExceededException"></a>

Un trop grand nombre de tâches sont exécutées simultanément.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## CrawlerNotRunningException structure
<a name="aws-glue-api-exceptions-CrawlerNotRunningException"></a>

L’crawler spécifié n’est pas en cours d’exécution.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## CrawlerRunningException structure
<a name="aws-glue-api-exceptions-CrawlerRunningException"></a>

L’opération ne peut pas être effectuée car l’crawler est déjà en cours d’exécution.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## CrawlerStoppingException structure
<a name="aws-glue-api-exceptions-CrawlerStoppingException"></a>

L’crawler spécifié est en cours d’arrêt.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## EntityNotFoundException structure
<a name="aws-glue-api-exceptions-EntityNotFoundException"></a>

Une entité spécifiée n’existe pas.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.
+ `FromFederationSource` : booléen.

  Indique si l'exception concerne une source fédérée.

## FederationSourceException structure
<a name="aws-glue-api-exceptions-FederationSourceException"></a>

Une source de fédération a échoué.

**Champs**
+ `FederationSourceErrorCode`— Chaîne UTF-8 (valeurs valides : `AccessDeniedException` \$1 \$1 `EntityNotFoundException` \$1 `InvalidCredentialsException` \$1 `InvalidInputException` \$1 `InvalidResponseException` \$1 `OperationTimeoutException` \$1 `OperationNotSupportedException` `InternalServiceException` `PartialFailureException` \$1`ThrottlingException`).

  Le code d’erreur du problème.
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## FederationSourceRetryableException structure
<a name="aws-glue-api-exceptions-FederationSourceRetryableException"></a>

Une source de fédération a échoué, mais l’opération peut être tentée à nouveau.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## GlueEncryptionException structure
<a name="aws-glue-api-exceptions-GlueEncryptionException"></a>

Une opération de chiffrement a échoué.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## IdempotentParameterMismatchException structure
<a name="aws-glue-api-exceptions-IdempotentParameterMismatchException"></a>

Le même identifiant unique a été associé à deux enregistrements différents.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## IllegalWorkflowStateException structure
<a name="aws-glue-api-exceptions-IllegalWorkflowStateException"></a>

Le flux de travail est dans un état non valide pour effectuer une opération demandée.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## InternalServiceException structure
<a name="aws-glue-api-exceptions-InternalServiceException"></a>

Une erreur de service interne s’est produite.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## InvalidExecutionEngineException structure
<a name="aws-glue-api-exceptions-InvalidExecutionEngineException"></a>

Un moteur d’exécution inconnu ou non valide a été spécifié.

**Champs**
+ `message` – Chaîne UTF-8.

  Un message décrivant le problème.

## InvalidInputException structure
<a name="aws-glue-api-exceptions-InvalidInputException"></a>

L’entrée fournie n’est pas valide.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.
+ `FromFederationSource` : booléen.

  Indique si l'exception concerne une source fédérée.

## InvalidStateException structure
<a name="aws-glue-api-exceptions-InvalidStateException"></a>

Une erreur indiquant que vos données sont dans un état non valide.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## InvalidTaskStatusTransitionException structure
<a name="aws-glue-api-exceptions-InvalidTaskStatusTransitionException"></a>

Une transition correcte d’une tâche à une autre a échoué.

**Champs**
+ `message` – Chaîne UTF-8.

  Un message décrivant le problème.

## JobDefinitionErrorException structure
<a name="aws-glue-api-exceptions-JobDefinitionErrorException"></a>

Une définition de tâche n’est pas valide.

**Champs**
+ `message` – Chaîne UTF-8.

  Un message décrivant le problème.

## JobRunInTerminalStateException structure
<a name="aws-glue-api-exceptions-JobRunInTerminalStateException"></a>

L’état de mise hors service d’une exécution de tâche signale une défaillance.

**Champs**
+ `message` – Chaîne UTF-8.

  Un message décrivant le problème.

## JobRunInvalidStateTransitionException structure
<a name="aws-glue-api-exceptions-JobRunInvalidStateTransitionException"></a>

Une exécution de tâche a rencontré une transition non valide de l’état source vers l’état cible.

**Champs**
+ `jobRunId` – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID de l’exécution de tâche en question.
+ `message` – Chaîne UTF-8.

  Un message décrivant le problème.
+ `sourceState`— Chaîne UTF-8 (valeurs valides : `STARTING` \$1 \$1 `RUNNING` \$1 `STOPPING` \$1 `STOPPED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `TIMEOUT` `ERROR` `WAITING` \$1`EXPIRED`).

  État source.
+ `targetState`— Chaîne UTF-8 (valeurs valides : `STARTING` \$1 \$1 `RUNNING` \$1 `STOPPING` \$1 `STOPPED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `TIMEOUT` `ERROR` `WAITING` \$1`EXPIRED`).

  État cible.

## JobRunNotInTerminalStateException structure
<a name="aws-glue-api-exceptions-JobRunNotInTerminalStateException"></a>

Une exécution de tâche n’est pas dans un état de mise hors service.

**Champs**
+ `message` – Chaîne UTF-8.

  Un message décrivant le problème.

## LateRunnerException structure
<a name="aws-glue-api-exceptions-LateRunnerException"></a>

Un exécuteur de tâche est en retard.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## NoScheduleException structure
<a name="aws-glue-api-exceptions-NoScheduleException"></a>

Il n’y a pas de calendrier applicable.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## OperationTimeoutException structure
<a name="aws-glue-api-exceptions-OperationTimeoutException"></a>

L’opération a expiré.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## ResourceNotReadyException structure
<a name="aws-glue-api-exceptions-ResourceNotReadyException"></a>

Une ressource n’était pas prête pour une transaction.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## ResourceNumberLimitExceededException structure
<a name="aws-glue-api-exceptions-ResourceNumberLimitExceededException"></a>

Une limite numérique de ressource a été dépassée.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## SchedulerNotRunningException structure
<a name="aws-glue-api-exceptions-SchedulerNotRunningException"></a>

Le planificateur spécifié n’est pas en cours d’exécution.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## SchedulerRunningException structure
<a name="aws-glue-api-exceptions-SchedulerRunningException"></a>

Le planificateur spécifié est déjà en cours d’exécution.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## SchedulerTransitioningException structure
<a name="aws-glue-api-exceptions-SchedulerTransitioningException"></a>

Le planificateur spécifié est en cours de conversion.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## UnrecognizedRunnerException structure
<a name="aws-glue-api-exceptions-UnrecognizedRunnerException"></a>

L’ exécuteur de tâche na pas été reconnu.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## ValidationException structure
<a name="aws-glue-api-exceptions-ValidationException"></a>

Une valeur n’a pas pu être validée.

**Champs**
+ `Message` – Chaîne UTF-8.

  Un message décrivant le problème.

## VersionMismatchException structure
<a name="aws-glue-api-exceptions-VersionMismatchException"></a>

Un conflit de version s’est produit.

**Champs**
+ `message` – Chaîne UTF-8.

  Un message décrivant le problème.