Vous consultez la documentation Apigee Edge.
Accédez à la documentation Apigee X.
Cette rubrique vous explique comment créer et modifier des mappages clé-valeur dans l'UI. Les KVM que vous créez dans l'UI sont limitées à l'environnement. Pour en savoir plus sur les KVM et le champ d'application, consultez Utiliser des mappages clé-valeur.
Gérer vos mappages clé-valeur d'environnement
Gérez vos KVM, comme décrit ci-dessous. Les KVM sont définis au niveau de l'environnement. Par exemple, si vous créez un KVM dans l'environnement de test, les proxys d'API exécutés dans l'environnement de production n'y auront pas accès.
Edge
Pour gérer les KVM à l'aide de l'interface utilisateur Edge :
- Connectez-vous à apigee.com/edge.
- Dans la barre de navigation de gauche, sélectionnez Administrateur > Environnements > Mappages clé-valeur.
- Pour créer un KVM :
- Cliquez sur + Mappage clé-valeur.
- Saisissez les valeurs de propriété pour le nouveau KVM. Le tableau suivant décrit les paramètres.
Nom de la propriété Description Nom Nom du KVM. Doit être unique dans l'environnement. Référencez ce nom à partir des règles qui interagissent avec le KVM. Chiffré Indicateur qui spécifie si le KVM est chiffré. Dans l'UI, les valeurs chiffrées s'affichent sous forme d'astérisques (*****). Le chiffrement est défini sur l'ensemble de la carte. Vous ne pouvez pas configurer le chiffrement entrée par entrée.
Remarque : Vous ne pouvez chiffrer les KVM que lorsque vous les créez. Vous ne pouvez pas chiffrer ni déchiffrer une carte de valeurs clés une fois qu'elle a été créée. - Cliquez sur Ajouter.
- Pour ajouter une entrée à un KVM :
- Cliquez sur le nom de la KMV dans la liste pour afficher les entrées actuelles.
- Cliquez sur le signe +.
- Saisissez les valeurs des propriétés pour la nouvelle entrée KVM, comme décrit ci-dessous.
Nom de la propriété Description Clé Nom de clé que vous utiliserez pour accéder à la valeur des données dans vos proxys d'API.
Avec Apigee Edge pour le cloud public, les noms de clés ne peuvent pas dépasser 2 Ko.
Dans l'interface utilisateur Edge, les noms ne peuvent pas contenir "/".
Valeur Valeur de la clé. Saisissez n'importe quelle combinaison de chiffres, de lettres ou de caractères spéciaux.
Remarque : La taille totale d'un mappage clé-valeur ne peut pas dépasser 15 Mo.
- Cliquez sur Ajouter.
- Pour gérer les entrées de clé dans un KVM :
- Cliquez sur le nom du KVM dans la liste pour afficher les entrées actuelles.
- Placez le curseur sur l'entrée KVM pour afficher le menu d'actions, puis effectuez l'une des tâches suivantes :
- Pour copier la valeur d'une entrée, cliquez sur
. - Pour modifier une entrée, cliquez sur
. Modifiez ensuite l'entrée et cliquez sur Mettre à jour. - Pour supprimer une entrée, cliquez sur
. Cliquez ensuite sur Supprimer pour confirmer l'opération.
- Pour copier la valeur d'une entrée, cliquez sur
Nouvelle interface utilisateur Edge (cloud privé)
Pour gérer les KVM à l'aide de la nouvelle interface utilisateur Edge :
- Connectez-vous à la nouvelle interface utilisateur Edge à l'adresse
http://host:3001/edge, où host correspond à l'adresse IP ou au nom DNS de l'hôte exécutant la nouvelle interface utilisateur Edge. - Dans la barre de navigation de gauche, sélectionnez Administrateur > Environnements > Mappages clé-valeur.
- Sélectionnez l'environnement pour lequel vous souhaitez configurer des KVM, par exemple test ou prod.
- Pour créer un KVM :
- Cliquez sur + Mappage clé-valeur.
- Saisissez les valeurs de propriété pour le nouveau KVM. Le tableau suivant décrit les paramètres.
Nom de la propriété Description Nom Nom du KVM. Doit être unique dans l'environnement. Référencez ce nom à partir des règles qui interagissent avec le KVM. Chiffré Indicateur qui spécifie si le KVM est chiffré. Dans l'UI, les valeurs chiffrées s'affichent sous forme d'astérisques (*****). Le chiffrement est défini sur l'ensemble du mappage. Vous ne pouvez pas configurer le chiffrement entrée par entrée.
Remarque : Vous ne pouvez chiffrer les KVM que lorsque vous les créez. Vous ne pouvez pas chiffrer ni déchiffrer une carte de valeurs clés une fois qu'elle a été créée. - Cliquez sur Ajouter.
- Pour ajouter une entrée à un KVM :
- Cliquez sur le nom du KVM dans la liste pour afficher les entrées actuelles.
- Cliquez sur le signe +.
- Saisissez les valeurs des propriétés pour la nouvelle entrée KVM, comme décrit ci-dessous.
Nom de la propriété Description Clé Nom de clé que vous utiliserez pour accéder à la valeur des données dans vos proxys d'API.
Dans la nouvelle interface utilisateur Edge, les noms ne peuvent pas contenir "/".
Valeur Valeur de la clé. Saisissez n'importe quelle combinaison de chiffres, de lettres ou de caractères spéciaux.
Remarque : La taille totale d'un mappage clé-valeur ne peut pas dépasser 15 Mo.
- Cliquez sur Ajouter.
- Pour gérer les entrées de clé dans un KVM :
- Cliquez sur le nom du KVM dans la liste pour afficher les entrées actuelles.
- Placez le curseur sur l'entrée KVM pour afficher le menu d'actions et effectuez l'une des tâches suivantes :
- Pour copier la valeur d'une entrée, cliquez sur .
- Pour modifier une entrée, cliquez sur . Modifiez ensuite l'entrée et cliquez sur Mettre à jour.
- Pour supprimer une entrée, cliquez sur . Cliquez ensuite sur Supprimer pour confirmer l'opération.
- Pour copier la valeur d'une entrée, cliquez sur