Définition des propriétés d'API

Outre les propriétés d'API préfournies que vous pouvez utiliser pour contrôler le comportement des stratégies API Connect , vous pouvez définir vos propres propriétés d'API. Les propriétés que vous définissez peuvent être référencées dans vos définitions d'API.

A propos de cette tâche

Remarque :
  • Cette tâche concerne la configuration d'une définition d'API OpenAPI 3.0. Pour plus de détails sur la configuration d'une définition d'API OpenAPI 2.0 , voir Edition d'une définition d'API OpenAPI 2.0.
  • Les API OpenAPI 3.0 sont prises en charge uniquement avec le DataPower® API Gatewayet non avec le DataPower Gateway (v5 compatible).
  • Pour plus de détails sur les limitations actuelles de la prise en charge d' OpenAPI 3.0 , voir Prise en charge d'OpenAPI 3.0 dans IBM® API Connect.

Vous pouvez effectuer cette tâche soit à l'aide de l'application d'interface utilisateur API Designer , soit à l'aide de l'interface utilisateur API Manager basée sur un navigateur.

Les propriétés d'API incluent le nom et la valeur de propriété, ainsi que le catalogue auquel la valeur de propriété s'applique. Pour obtenir la liste des propriétés d'API préfournies relatives à différentes stratégies, voir Propriétés d'API.
Remarque: une fois définie, une propriété d'API est en lecture seule.

Pour plus d'informations sur la manière de référencer une propriété dans une définition d'API, voir Références de variables dans API Connect.

Il est également possible de définir des propriétés spécifiques à un catalogue et qui peuvent être référencées par l'une des API de ce catalogue. Pour plus d'informations, voir Création et configuration de catalogues. Notez que si vous définissez une propriété de catalogue du même nom qu'une propriété d'API, la propriété d'API est prioritaire sur la propriété de catalogue.

A tout moment, vous pouvez passer directement à la source YAML OpenAPI sous-jacente en cliquant sur l'icône Source OpenAPI Icône Source. Pour revenir au formulaire de conception, cliquez sur l'icône Formulaire Icône de formulaire.

Astuce: Si vous ajoutez ou modifiez une propriété d'API sur une API qui est déjà mise en préproduction ou publiée, vous devez remettre en préproduction ou republier le produit qui contient l'API mise à jour pour que la modification soit prise en compte.

Procédure

  1. Ouvrez l'API à des fins d'édition, comme décrit dans Edition d'une définition d'API OpenAPI 3.0.
  2. Sélectionnez l'onglet Passerelle , développez Paramètres de passerelle et de portail , puis, si une ou plusieurs propriétés d'API sont déjà définies, développez Propriétés.
  3. Configurez une propriété d'API.
    • Pour définir une nouvelle propriété d'API, procédez comme suit :
      1. Cliquez sur l'icône d'ajout OpenAPI 3.0 Icône d'ajout d'API en regard de Propriétés dans le panneau de navigation.
      2. Fournissez les informations suivantes :
        • Nom de la propriété : Entrez un nom pour la propriété. Ce nom est utilisé pour référencer la propriété. Le jeu de caractères suivant est pris en charge pour le Nom d'une propriété d'API : [A-Za-z0-9_-]+. Les espaces sont autorisés.
        • Valeur: valeur par défaut de la propriété. Laissez cette zone vide si la propriété doit avoir une valeur NULL par défaut.
        • Description : Description facultative de la propriété. Vous pouvez utiliser la syntaxeCommonMark pour la représentation de texte enrichi.
        • Sélectionnez Coder si vous souhaitez masquer les valeurs des propriétés ou dissimuler les mots de passe utilisateur.
          Remarque: Si vous codez une valeur de propriété, elle est sauvegardée au format codé Base64 ; elle n'est pas chiffrée. Si vous décochez par la suite la case Coder, la valeur d'origine de la propriété est restaurée dans son format non codé.
      3. Cliquez sur Créer.
    • Pour modifier une propriété d'API existante, cliquez sur le nom de la propriété dans le panneau de navigation. Vous pouvez ensuite modifier les paramètres de configuration.
  4. Cliquez sur Sauvegarder pour sauvegarder vos modifications.

Etape suivante

Vous pouvez éventuellement définir une valeur pour la propriété spécifique à un catalogue particulier ; voir Définition de valeurs de propriété spécifiques à un catalogue.