CreateSlotTypeVersion - Amazon Lex V1

Si vous utilisez Amazon Lex V2, consultez plutôt le guide Amazon Lex V2.

 

Si vous utilisez Amazon Lex V1, nous vous recommandons de mettre à niveau vos robots vers Amazon Lex V2. Nous n'ajoutons plus de nouvelles fonctionnalités à la V1 et recommandons vivement d'utiliser la V2 pour tous les nouveaux robots.

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.

CreateSlotTypeVersion

Crée une nouvelle version d'un type d'emplacement en fonction de la $LATEST version du type d'emplacement spécifié. Si la $LATEST version de cette ressource n'a pas changé depuis la dernière version que vous avez créée, Amazon Lex ne crée pas de nouvelle version. Elle renvoie la dernière version que vous avez créée.

Note

Vous ne pouvez mettre à jour que la $LATEST version d'un type de slot. Vous ne pouvez pas mettre à jour les versions numérotées que vous créez avec cette CreateSlotTypeVersion opération.

Lorsque vous créez une version d'un type de slot, Amazon Lex définit la version sur 1. Les versions suivantes sont incrémentées de 1. Pour de plus amples informations, veuillez consulter Gestion des versions.

Cette opération exige des autorisations pour l'action lex:CreateSlotTypeVersion.

Syntaxe de la demande

POST /slottypes/name/versions HTTP/1.1 Content-type: application/json { "checksum": "string" }

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

name

Nom du type de slot pour lequel vous souhaitez créer une nouvelle version. Le nom est sensible à la casse.

Contraintes de longueur : longueur minimum de 1. Longueur maximum de 100.

Modèle : ^([A-Za-z]_?)+$

Obligatoire : oui

Corps de la demande

Cette demande accepte les données suivantes au format JSON.

checksum

Somme de contrôle correspondant à la $LATEST version du type de slot que vous souhaitez publier. Si vous spécifiez une somme de contrôle et que la $LATEST version du type d'emplacement possède une somme de contrôle différente, Amazon Lex renvoie une PreconditionFailedException exception et ne publie pas la nouvelle version. Si vous ne spécifiez pas de somme de contrôle, Amazon Lex publie la $LATEST version.

Type : chaîne

Obligatoire : non

Syntaxe de la réponse

HTTP/1.1 201 Content-type: application/json { "checksum": "string", "createdDate": number, "description": "string", "enumerationValues": [ { "synonyms": [ "string" ], "value": "string" } ], "lastUpdatedDate": number, "name": "string", "parentSlotTypeSignature": "string", "slotTypeConfigurations": [ { "regexConfiguration": { "pattern": "string" } } ], "valueSelectionStrategy": "string", "version": "string" }

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 201.

Les données suivantes sont renvoyées au format JSON par le service.

checksum

Somme de contrôle de la $LATEST version du type de slot.

Type : chaîne

createdDate

Date à laquelle le type de slot a été créé.

Type : Timestamp

description

Une description du type d'emplacement.

Type : chaîne

Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

enumerationValues

Liste d'EnumerationValueobjets qui définit les valeurs que le type de slot peut prendre.

Type : tableau d’objets EnumerationValue

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 000 articles.

lastUpdatedDate

Date à laquelle le type de slot a été mis à jour. Lorsque vous créez une ressource, la date de création et la date de dernière mise à jour sont identiques.

Type : Timestamp

name

Nom du type d'option.

Type : chaîne

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.

Modèle : ^([A-Za-z]_?)+$

parentSlotTypeSignature

Le type d'emplacement intégré était utilisé comme parent du type d'emplacement.

Type : chaîne

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.

Modèle : ^((AMAZON\.)_?|[A-Za-z]_?)+

slotTypeConfigurations

Informations de configuration qui étendent le type de slot intégré du parent.

Type : tableau d’objets SlotTypeConfiguration

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 10 éléments.

valueSelectionStrategy

Stratégie utilisée par Amazon Lex pour déterminer la valeur de l'emplacement. Pour de plus amples informations, veuillez consulter PutSlotType.

Type : chaîne

Valeurs valides : ORIGINAL_VALUE | TOP_RESOLUTION

version

Version attribuée à la nouvelle version de type de slot.

Type : chaîne

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

Modèle : \$LATEST|[0-9]+

Erreurs

BadRequestException

La demande n'est pas bien formulée. Par exemple, une valeur n'est pas valide ou un champ obligatoire est manquant. Vérifiez les valeurs des champs, puis réessayez.

Code d’état HTTP : 400

ConflictException

Un conflit s'est produit lors du traitement de la demande. Réessayez votre demande.

Code d’état HTTP : 409

InternalFailureException

Une erreur interne Amazon Lex s'est produite. Réessayez votre demande.

Code d’état HTTP : 500

LimitExceededException

La demande a dépassé une limite. Réessayez votre demande.

Code d’état HTTP : 429

NotFoundException

La ressource spécifiée dans la demande est introuvable. Vérifiez la ressource et réessayez.

Code d’état HTTP : 404

PreconditionFailedException

La somme de contrôle de la ressource que vous essayez de modifier ne correspond pas à la somme de contrôle de la demande. Vérifiez le checksum de la ressource et réessayez.

Code d’état HTTP : 412

consultez aussi

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :