Registre de schémas - AWS Glue

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.

Registre de schémas

Le registre des schémas API décrit les types de données et les informations API relatives à l'utilisation des schémas dans AWS Glue.

Types de données

RegistryId structure

Une structure d'enveloppe qui peut contenir le nom du registre et le nom de la ressource Amazon (ARN).

Champs
  • RegistryName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du registre. Utilisé uniquement pour la recherche. RegistryArn ou RegistryName doit être fourni.

  • RegistryArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    ARN du registre à mettre à jour. RegistryArn ou RegistryName doit être fourni.

RegistryListItem structure

Une structure contenant les détails d'un registre.

Champs
  • RegistryName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du registre.

  • RegistryArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de ressource Amazon (ARN) du registre.

  • Description – Chaîne de description, d'une longueur maximale de 2 048 octets, correspondant au URI address multi-line string pattern.

    Description du registre.

  • Status— Chaîne UTF -8 (valeurs valides : AVAILABLE |DELETING).

    Statut du registre.

  • CreatedTime— UTF -8 chaînes.

    Données que le registre a été créé.

  • UpdatedTime— UTF -8 chaînes.

    Date à laquelle le registre a été mis à jour.

MetadataInfo structure

Structure contenant des informations de métadonnées pour une version de schéma.

Champs
  • MetadataValue— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 256 octets, correspondant auCustom string pattern #34.

    Valeur correspondant à une clé de métadonnées.

  • CreatedTime— UTF -8 chaînes.

    Heure à laquelle l'entrée a été créée.

  • OtherMetadataValueList – Un tableau d'objets OtherMetadataValueListItem.

    Autres métadonnées appartenant à la même clé de métadonnées.

OtherMetadataValueListItem structure

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 d'au moins 1 ou supérieure à 256 octets, correspondant auCustom string pattern #34.

    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— UTF -8 chaînes.

    Heure à laquelle l'entrée a été créée.

SchemaListItem structure

Objet qui contient des détails minimaux pour un schéma.

Champs
  • RegistryName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du registre dans lequel se trouve le schéma.

  • SchemaName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du schéma.

  • SchemaArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de la ressource Amazon (ARN) 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.

    Description du schéma.

  • SchemaStatus— Chaîne UTF -8 (valeurs valides : AVAILABLE | PENDING |DELETING).

    Statut du schéma.

  • CreatedTime— UTF -8 chaînes.

    Date et heure de création d'un schéma.

  • UpdatedTime— UTF -8 chaînes.

    Date et heure de mise à jour d'un schéma.

SchemaVersionListItem structure

Objet contenant les détails d'une version de schéma.

Champs
  • SchemaArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de la ressource Amazon (ARN) du schéma.

  • SchemaVersionId— Chaîne UTF -8, d'au moins 36 octets ou d'au plus 36 octets, correspondant auCustom string pattern #17.

    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 | | PENDING FAILURE |DELETING).

    Statut de la version du schéma.

  • CreatedTime— UTF -8 chaînes.

    Date et heure de création à laquelle la version de schéma a été créée.

MetadataKeyValuePair structure

Structure contenant une paire de valeurs clé pour les métadonnées.

Champs
  • MetadataKey— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 128 octets, correspondant auCustom string pattern #34.

    Clé de métadonnées.

  • MetadataValue— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 256 octets, correspondant auCustom string pattern #34.

    Valeur correspondant à une clé de métadonnées.

SchemaVersionErrorItem structure

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.

    Détails de l'erreur pour la version du schéma.

ErrorDetails structure

Objet contenant des détails d'erreur.

Champs
  • ErrorCode— UTF -8 chaînes.

    Code d'erreur correspondant à une erreur.

  • ErrorMessage— UTF -8 chaînes.

    Message d'erreur pour une erreur.

SchemaVersionNumber structure

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

ID unique du schéma dans le registre des AWS Glue schémas.

Champs
  • SchemaArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de la ressource Amazon (ARN) du schéma. SchemaArn ou SchemaName doit être fourni.

  • SchemaName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du schéma. SchemaArn ou SchemaName doit être fourni.

  • RegistryName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du registre de schémas contenant le schéma.

Opérations

CreateRegistry action (Python : create_registry)

Crée un registre qui peut être utilisé pour contenir une collection de schémas.

Demande
  • RegistryNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auCustom string pattern #18.

    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.

    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 d'au moins 1 ou d'au plus 128 octets.

    Chaque valeur est une chaîne de 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 ouAPI.

Réponse
  • RegistryArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de ressource Amazon (ARN) du registre nouvellement créé.

  • RegistryName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du registre.

  • Description – Chaîne de description, d'une longueur maximale de 2 048 octets, correspondant au URI address multi-line string pattern.

    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 d'au moins 1 ou d'au plus 128 octets.

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

    Balises pour le registre.

Erreurs
  • InvalidInputException

  • AccessDeniedException

  • AlreadyExistsException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

  • InternalServiceException

CreateSchema action (Python : créer_schéma)

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 l'ajout de versions de schéma supplémentaires 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 le RegisterSchemaVersion API est utilisé.

Lorsqu'il API est appelé sans unRegistryId, cela créera une entrée pour un « registre par défaut » dans les tables de base de données du registre, s'il n'est pas déjà présent.

Demande
  • RegistryId – Un objet 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 ARN format pour la même chose sera :arn:aws:glue:us-east-2:<customer id>:registry/default-registry:random-5-letter-id.

  • SchemaNameObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 255 octets de long, correspondant auCustom string pattern #18.

    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.

  • DataFormatObligatoire : chaîne UTF -8 (valeurs valides : AVRO | JSON |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 | DISABLED | BACKWARD | BACKWARD_ALL | FORWARD | FORWARD_ALL FULL |FULL_ALL).

    Mode de compatibilité du schéma. Les valeurs possibles sont :

    • NONE: 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: ce choix de compatibilité empêche le versionnement d'un schéma particulier. Vous pouvez utiliser ce choix pour empêcher la gestion des versions futures d'un schéma.

    • BACKWARD: 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 précédente 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_ ALL : Ce choix de compatibilité permet aux récepteurs de données de lire à la fois la version actuelle et toutes les versions précédentes 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.

    • FORWARD: 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.

    • FORWARD_ ALL : Ce choix de compatibilité permet aux récepteurs de données de lire les textes écrits 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.

    • FULL: 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.

    • FULL_ ALL : Ce choix de compatibilité permet aux récepteurs de données de lire les données écrites par les producteurs en 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.

    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 d'au moins 1 ou d'au plus 128 octets.

    Chaque valeur est une chaîne de 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 ouAPI. Si spécifié, suit le AWS tags-on-create modèle.

  • SchemaDefinition— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 170 000 octets, correspondant au. Custom string pattern #33

    Définition de schéma à l'aide du paramètre DataFormat pour SchemaName.

Réponse
  • RegistryName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du registre.

  • RegistryArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de ressource Amazon (ARN) du registre.

  • SchemaName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du schéma.

  • SchemaArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de la ressource Amazon (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.

    Description du schéma si spécifié lors de sa création.

  • DataFormat— Chaîne UTF -8 (valeurs valides : AVRO | JSON |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 | DISABLED | BACKWARD | BACKWARD_ALL | FORWARD | FORWARD_ALL FULL |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 | PENDING |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 d'au moins 1 ou d'au plus 128 octets.

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

    Balises pour le schéma.

  • SchemaVersionId— Chaîne UTF -8, d'au moins 36 octets ou d'au plus 36 octets, correspondant auCustom string pattern #17.

    Identifiant unique de la première version du schéma.

  • SchemaVersionStatus— Chaîne UTF -8 (valeurs valides : AVAILABLE | | PENDING FAILURE |DELETING).

    Statut de la première version du schéma créée.

Erreurs
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • AlreadyExistsException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

  • InternalServiceException

GetSchema action (Python : get_schema)

Décrit en détail le schéma spécifié.

Demande
  • SchemaIdObligatoire : un objet SchemaId.

    Structure d'encapsulation contenant les champs d'identité de schéma. La structure contient :

    • SchemaId$ SchemaArn : Le nom de la ressource Amazon (ARN) du schéma. Il faut fournir soit SchemaArn, soit SchemaName et RegistryName.

    • SchemaId$ SchemaName : nom du schéma. Il faut fournir soit SchemaArn, soit SchemaName et RegistryName.

Réponse
  • RegistryName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du registre.

  • RegistryArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de ressource Amazon (ARN) du registre.

  • SchemaName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du schéma.

  • SchemaArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de la ressource Amazon (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.

    Description du schéma si spécifié lors de sa création

  • DataFormat— Chaîne UTF -8 (valeurs valides : AVRO | JSON |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 | DISABLED | BACKWARD | BACKWARD_ALL | FORWARD | FORWARD_ALL FULL |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 | PENDING |DELETING).

    Statut du schéma.

  • CreatedTime— UTF -8 chaînes.

    Date et heure de création du schéma.

  • UpdatedTime— UTF -8 chaînes.

    Date et heure de mise à jour du schéma.

Erreurs
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • InternalServiceException

ListSchemaVersions action (Python : list_schema_versions)

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
  • SchemaIdObligatoire : un objet SchemaId.

    Structure d'encapsulation contenant les champs d'identité de schéma. La structure contient :

    • SchemaId$ SchemaArn : Le nom de la ressource Amazon (ARN) du schéma. Il faut fournir soit SchemaArn, soit SchemaName et RegistryName.

    • SchemaId$ 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— UTF -8 chaînes.

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

Réponse
  • Schemas – Un tableau d'objets SchemaVersionListItem.

    Tableau d'objets SchemaVersionList contenant les détails de chaque version de schéma.

  • NextToken— UTF -8 chaînes.

    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

  • InternalServiceException

GetSchemaVersion action (Python : get_schema_version)

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.

    Structure d'encapsulation contenant les champs d'identité de schéma. La structure contient :

    • SchemaId$ SchemaArn : Le nom de la ressource Amazon (ARN) du schéma. Il faut fournir soit SchemaArn, soit SchemaName et RegistryName.

    • SchemaId$ SchemaName : nom du schéma. Il faut fournir soit SchemaArn, soit SchemaName et RegistryName.

  • SchemaVersionId— Chaîne UTF -8, d'au moins 36 octets ou d'au plus 36 octets, correspondant auCustom string pattern #17.

    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.

    Numéro de version du schéma.

Réponse
  • SchemaVersionId— Chaîne UTF -8, d'au moins 36 octets ou d'au plus 36 octets, correspondant auCustom string pattern #17.

    Le SchemaVersionId de la version du schéma.

  • SchemaDefinition— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 170 000 octets, correspondant au. Custom string pattern #33

    La définition du schéma pour l'ID du schéma.

  • DataFormat— Chaîne UTF -8 (valeurs valides : AVRO | JSON |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 d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de la ressource Amazon (ARN) 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 | | PENDING FAILURE |DELETING).

    Statut de la version du schéma.

  • CreatedTime— UTF -8 chaînes.

    Date et heure de création à laquelle la version de schéma a été créée.

Erreurs
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • InternalServiceException

GetSchemaVersionsDiff action (Python : get_schema_versions_diff)

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.

Cela vous API permet de comparer deux versions de schéma entre deux définitions de schéma dans le même schéma.

Demande
  • SchemaIdObligatoire : un objet SchemaId.

    Structure d'encapsulation contenant les champs d'identité de schéma. La structure contient :

    • SchemaId$ SchemaArn : Le nom de la ressource Amazon (ARN) du schéma. SchemaArn ou SchemaName doit être fourni.

    • SchemaId$ SchemaName : nom du schéma. SchemaArn ou SchemaName doit être fourni.

  • FirstSchemaVersionNumberObligatoire : un objet SchemaVersionNumber.

    La première des deux versions de schéma à comparer.

  • SecondSchemaVersionNumberObligatoire : un objet SchemaVersionNumber.

    La seconde des deux versions de schéma à comparer.

  • SchemaDiffTypeObligatoire : 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'au moins 1 ou plus de 340 000 octets, correspondant au. Custom string pattern #33

    La différence entre les schémas sous forme de chaîne de JsonPatch caractères.

Erreurs
  • InvalidInputException

  • EntityNotFoundException

  • AccessDeniedException

  • InternalServiceException

ListRegistries action (Python : list_registries)

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— UTF -8 chaînes.

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

Réponse
  • Registries – Un tableau d'objets RegistryListItem.

    Tableau d'objets RegistryDetailedListItem contenant des détails minimaux de chaque registre.

  • NextToken— UTF -8 chaînes.

    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

  • InternalServiceException

ListSchemas action (Python : list_schemas)

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 le n'RegistryIdest pas fourni, tous les schémas des registres feront partie de la API réponse.

Demande
  • RegistryId – Un objet RegistryId.

    Une structure d'enveloppe qui peut contenir le nom du registre et le nom de la ressource Amazon (ARN).

  • 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— UTF -8 chaînes.

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

Réponse
  • Schemas – Un tableau d'objets SchemaListItem.

    Tableau d'objets SchemaListItem contenant les détails de chaque schéma.

  • NextToken— UTF -8 chaînes.

    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

  • InternalServiceException

RegisterSchemaVersion action (Python : register_schema_version)

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. Cela ne API créera pas de nouvel ensemble de schémas et renverra une erreur 404 si le jeu de schémas n'est pas déjà présent dans le registre des schémas.

S'il s'agit de la première définition de schéma enregistrée dans le registre des schémas, la version du schéma API sera stockée et renvoyée immédiatement. Sinon, cet appel peut s'exécuter plus longtemps que d'autres opérations en raison des modes de compatibilité. Vous pouvez appeler le GetSchemaVersion API 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
  • SchemaIdObligatoire : un objet SchemaId.

    Structure d'encapsulation contenant les champs d'identité de schéma. La structure contient :

    • SchemaId$ SchemaArn : Le nom de la ressource Amazon (ARN) du schéma. Il faut fournir soit SchemaArn, soit SchemaName et RegistryName.

    • SchemaId$ SchemaName : nom du schéma. Il faut fournir soit SchemaArn, soit SchemaName et RegistryName.

  • SchemaDefinitionObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 170 000 octets, correspondant au. Custom string pattern #33

    Définition de schéma à l'aide du paramètre DataFormat pour SchemaName.

Réponse
  • SchemaVersionId— Chaîne UTF -8, d'au moins 36 octets ou d'au plus 36 octets, correspondant auCustom string pattern #17.

    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 | | PENDING FAILURE |DELETING).

    Statut de la version du schéma.

Erreurs
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

  • InternalServiceException

UpdateSchema action (Python : update_schema)

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. Cela API validera le numéro de version du point de contrôle pour des raisons de cohérence.

Si la valeur pour VersionNumber (point de contrôle) est fournie, Compatibility est facultatif et cela peut être utilisé pour définir/réinitialiser un point de contrôle pour le schéma.

Cette mise à jour n'aura lieu que si le schéma est en bon AVAILABLE état.

Demande
  • SchemaIdObligatoire : un objet SchemaId.

    Structure d'encapsulation contenant les champs d'identité de schéma. La structure contient :

    • SchemaId$ SchemaArn : Le nom de la ressource Amazon (ARN) du schéma. SchemaArn ou SchemaName doit être fourni.

    • SchemaId$ SchemaName : nom du schéma. SchemaArn ou SchemaName doit être fourni.

  • SchemaVersionNumber – Un objet 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 | DISABLED | BACKWARD | BACKWARD_ALL | FORWARD | FORWARD_ALL FULL |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.

    Nouvelle description du schéma.

Réponse
  • SchemaArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de la ressource Amazon (ARN) du schéma.

  • SchemaName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du schéma.

  • RegistryName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du registre contenant le schéma.

Erreurs
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • ConcurrentModificationException

  • InternalServiceException

CheckSchemaVersionValidity action (Python : check_schema_version_validity)

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
  • DataFormatObligatoire : chaîne UTF -8 (valeurs valides : AVRO | JSON |PROTOBUF).

    Format de données de la définition de schéma. À l'heure actuelle, AVRO, JSON et PROTOBUF sont pris en charge.

  • SchemaDefinitionObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 170 000 octets, correspondant au. Custom string pattern #33

    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— UTF -8 chaînes, d'une longueur d'au moins 1 ou supérieure à 5 000 octets.

    Message d'erreur d'échec de validation.

Erreurs
  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

UpdateRegistry action (Python : update_registry)

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
  • RegistryIdObligatoire : un objet RegistryId.

    Il s'agit d'une structure d'enveloppe qui peut contenir le nom du registre et le nom de la ressource Amazon (ARN).

  • DescriptionObligatoire : Chaîne de description, d'une longueur maximale de 2 048 octets, correspondant au URI address multi-line string pattern.

    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 d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du registre mis à jour.

  • RegistryArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de la ressource Amazon (ARN) du registre mis à jour.

Erreurs
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • ConcurrentModificationException

  • InternalServiceException

GetSchemaByDefinition action (Python : get_schema_by_definition)

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 au champ d'application du SchemaName ou ARN (ou du registre par défaut, si aucun n'est fourni), les métadonnées de ce schéma sont renvoyé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
  • SchemaIdObligatoire : un objet SchemaId.

    Structure d'encapsulation contenant les champs d'identité de schéma. La structure contient :

    • SchemaId$ SchemaArn : Le nom de la ressource Amazon (ARN) du schéma. SchemaArn ou SchemaName doit être fourni.

    • SchemaId$ SchemaName : nom du schéma. SchemaArn ou SchemaName doit être fourni.

  • SchemaDefinitionObligatoire : UTF -8 chaînes, d'au moins 1 ou plus de 170 000 octets, correspondant au. Custom string pattern #33

    Définition du schéma pour lequel les détails du schéma sont requis.

Réponse
  • SchemaVersionId— Chaîne UTF -8, d'au moins 36 octets ou d'au plus 36 octets, correspondant auCustom string pattern #17.

    ID de schéma de la version du schéma.

  • SchemaArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de la ressource Amazon (ARN) du schéma.

  • DataFormat— Chaîne UTF -8 (valeurs valides : AVRO | JSON |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 | | PENDING FAILURE |DELETING).

    Statut de la version du schéma.

  • CreatedTime— UTF -8 chaînes.

    Date et heure de création du schéma.

Erreurs
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • InternalServiceException

GetRegistry action (Python : get_registry)

Décrit en détail le registre spécifié.

Demande
  • RegistryIdObligatoire : un objet RegistryId.

    Il s'agit d'une structure d'enveloppe qui peut contenir le nom du registre et le nom de la ressource Amazon (ARN).

Réponse
  • RegistryName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du registre.

  • RegistryArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de ressource Amazon (ARN) du registre.

  • Description – Chaîne de description, d'une longueur maximale de 2 048 octets, correspondant au URI address multi-line string pattern.

    Description du registre.

  • Status— Chaîne UTF -8 (valeurs valides : AVAILABLE |DELETING).

    Statut du registre.

  • CreatedTime— UTF -8 chaînes.

    Date et heure de création du registre.

  • UpdatedTime— UTF -8 chaînes.

    Date et heure de mise à jour du registre.

Erreurs
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • InternalServiceException

PutSchemaVersionMetadata action (Python : put_schema_version_metadata)

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.

    ID unique du schéma.

  • SchemaVersionNumber – Un objet SchemaVersionNumber.

    Numéro de version du schéma.

  • SchemaVersionId— Chaîne UTF -8, d'au moins 36 octets ou d'au plus 36 octets, correspondant auCustom string pattern #17.

    ID de version unique de la version du schéma.

  • MetadataKeyValueObligatoire : un objet MetadataKeyValuePair.

    Valeur correspondant à une clé de métadonnées.

Réponse
  • SchemaArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de la ressource Amazon (ARN) pour le schéma.

  • SchemaName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du schéma.

  • RegistryName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    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'au moins 36 octets ou d'au plus 36 octets, correspondant auCustom string pattern #17.

    ID de version unique de la version du schéma.

  • MetadataKey— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 128 octets, correspondant auCustom string pattern #34.

    Clé de métadonnées.

  • MetadataValue— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 256 octets, correspondant auCustom string pattern #34.

    Valeur de la clé de métadonnées.

Erreurs
  • InvalidInputException

  • AccessDeniedException

  • AlreadyExistsException

  • EntityNotFoundException

  • ResourceNumberLimitExceededException

QuerySchemaVersionMetadata action (Python : query_schema_version_metadata)

Requêtes pour les informations de métadonnées de version du schéma.

Demande
  • SchemaId – Un objet SchemaId.

    Une structure d'enveloppe qui peut contenir le nom du schéma et le nom de la ressource Amazon (ARN).

  • SchemaVersionNumber – Un objet SchemaVersionNumber.

    Numéro de version du schéma.

  • SchemaVersionId— Chaîne UTF -8, d'au moins 36 octets ou d'au plus 36 octets, correspondant auCustom string pattern #17.

    ID de version unique de la version du schéma.

  • MetadataList – Un tableau d'objets 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— UTF -8 chaînes.

    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 d'au moins 1 ou supérieure à 128 octets, correspondant auCustom string pattern #34.

    Chaque valeur est un objet MetadataInfo.

    Carte d'une clé de métadonnées et des valeurs associées.

  • SchemaVersionId— Chaîne UTF -8, d'au moins 36 octets ou d'au plus 36 octets, correspondant auCustom string pattern #17.

    ID de version unique de la version du schéma.

  • NextToken— UTF -8 chaînes.

    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

RemoveSchemaVersionMetadata action (Python : remove_schema_version_metadata)

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.

    Une structure d'enveloppe qui peut contenir le nom du schéma et le nom de la ressource Amazon (ARN).

  • SchemaVersionNumber – Un objet SchemaVersionNumber.

    Numéro de version du schéma.

  • SchemaVersionId— Chaîne UTF -8, d'au moins 36 octets ou d'au plus 36 octets, correspondant auCustom string pattern #17.

    ID de version unique de la version du schéma.

  • MetadataKeyValueObligatoire : un objet MetadataKeyValuePair.

    Valeur de la clé de métadonnées.

Réponse
  • SchemaArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de la ressource Amazon (ARN) du schéma.

  • SchemaName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du schéma.

  • RegistryName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    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'au moins 36 octets ou d'au plus 36 octets, correspondant auCustom string pattern #17.

    ID de version pour la version du schéma.

  • MetadataKey— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 128 octets, correspondant auCustom string pattern #34.

    Clé de métadonnées.

  • MetadataValue— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 256 octets, correspondant auCustom string pattern #34.

    Valeur de la clé de métadonnées.

Erreurs
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

DeleteRegistry action (Python : supprimer_registre)

Supprimer l'intégralité du registre, y compris le schéma et toutes ses versions. Pour connaître le statut de l'opération de suppression, vous pouvez appeler le GetRegistry API après l'appel asynchrone. La suppression d'un registre désactivera toutes les opérations en ligne du registre, telles que leUpdateRegistry, CreateSchemaUpdateSchema, et RegisterSchemaVersionAPIs.

Demande
  • RegistryIdObligatoire : un objet RegistryId.

    Il s'agit d'une structure d'enveloppe qui peut contenir le nom du registre et le nom de la ressource Amazon (ARN).

Réponse
  • RegistryName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du registre en cours de suppression.

  • RegistryArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de ressource Amazon (ARN) du registre en cours de suppression.

  • Status— Chaîne UTF -8 (valeurs valides : AVAILABLE |DELETING).

    Statut du registre. La réussite de l'opération retournera le statut Deleting.

Erreurs
  • InvalidInputException

  • EntityNotFoundException

  • AccessDeniedException

  • ConcurrentModificationException

DeleteSchema action (Python : supprimer_schéma)

Supprime l'ensemble de schémas, y compris le jeu de schémas et toutes ses versions. Pour connaître le statut de l'opération de suppression, vous pouvez appeler GetSchema API après l'appel asynchrone. La suppression d'un registre désactivera toutes les opérations en ligne pour le schéma, telles que leGetSchemaByDefinition, et RegisterSchemaVersionAPIs.

Demande
  • SchemaIdObligatoire : un objet SchemaId.

    Il s'agit d'une structure d'enveloppe qui peut contenir le nom du schéma et le nom de la ressource Amazon (ARN).

Réponse
  • SchemaArn— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 10 240 octets, correspondant au. Custom string pattern #22

    Le nom de ressource Amazon (ARN) du schéma en cours de suppression.

  • SchemaName— Chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 255 octets, correspondant auCustom string pattern #18.

    Nom du schéma en cours de suppression.

  • Status— Chaîne UTF -8 (valeurs valides : AVAILABLE | PENDING |DELETING).

    Statut du schéma.

Erreurs
  • InvalidInputException

  • EntityNotFoundException

  • AccessDeniedException

  • ConcurrentModificationException

DeleteSchemaVersions action (Python : delete_schema_versions)

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 _FULL, une erreur est renvoyée. L'appel GetSchemaVersions API après cet appel indiquera l'état des versions supprimées.

Lorsque la plage de numéros de version contient une version cochéeAPI, un conflit 409 est renvoyé et la suppression est interrompue. Vous devez d'abord supprimer le point de contrôle en utilisant le DeleteSchemaCheckpoint API avant de l'utiliser. API

Vous ne pouvez pas utiliser le DeleteSchemaVersions API pour supprimer la première version du schéma dans le jeu de schémas. La première version du schéma ne peut être supprimée que par le DeleteSchemaAPI. 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 _FULL, une erreur est renvoyée.

Demande
  • SchemaIdObligatoire : un objet SchemaId.

    Il s'agit d'une structure d'enveloppe qui peut contenir le nom du schéma et le nom de la ressource Amazon (ARN).

  • VersionsObligatoire : chaîne UTF -8, d'une longueur d'au moins 1 ou supérieure à 100 000 octets, correspondant au. Custom string pattern #35

    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.

    Une liste d'objets SchemaVersionErrorItem, chacun contenant une version d'erreur et de schéma.

Erreurs
  • InvalidInputException

  • EntityNotFoundException

  • AccessDeniedException

  • ConcurrentModificationException