Aperçu du service de passerelle d'API
Le service Passerelle d'API vous permet de publier des API avec des points d'extrémité privés qui sont accessibles depuis votre réseau, mais que vous pouvez exposer avec des adresses IP publiques si vous souhaitez qu'elles acceptent le trafic Internet. Les points d'extrémité prennent en charge la validation, la transformation des demandes et des réponses, la spécification CORS, l'authentification et l'autorisation, ainsi que la limitation des demandes pour les API.
À l'aide du service Passerelle d'API, vous créez une ou plusieurs passerelles d'API dans un sous-réseau régional pour traiter le trafic en provenance des clients d'API et l'acheminer vers les services dorsaux. Vous pouvez utiliser une passerelle d'API unique pour lier plusieurs services dorsaux (tels que des équilibreurs de charge, des instances de calcul et des fonctions pour OCI) dans un seul point d'extrémité d'API consolidée.
Vous pouvez accéder au service Passerelle d'API pour définir des passerelles et des déploiements d'API à l'aide de la console et de l'API REST.
Le service Passerelle d'API est intégré au service Gestion des identités et des accès (GIA) pour Oracle Cloud Infrastructure, qui permet l'authentification avec la fonctionnalité native de gestion des identités d'Oracle Cloud Infrastructure.
Pour être opérationnel rapidement avec le service de passerelle d'API, voir le guide QuickStart. Plusieurs tutoriels pour développeurs connexes sont également disponibles.
Méthodes d'accès à Oracle Cloud Infrastructure
Vous pouvez accéder à Oracle Cloud Infrastructure (OCI) à l'aide de la console (interface basée sur un navigateur), de l'API REST ou de l'interface de ligne de commande OCI. Les instructions relatives à la console, à l'API et à l'interface de ligne de commande sont incluses dans les rubriques de cette documentation. Pour une liste des trousses SDK disponibles, voir Trousses SDK et interface de ligne de commande.
Pour accéder à la console, vous devez utiliser un explorateur pris en charge. Pour accéder à la page de connexion de la console, ouvrez le menu de navigation en haut de cette page et sélectionnez Console Infrastructure. Vous êtes invité à entrer votre location Oracle Cloud, votre nom d'utilisateur et votre mot de passe.
Pour des informations générales sur l'utilisation de l'API, voir API REST.
Identificateurs de ressource
La plupart des types de ressource Oracle Cloud Infrastructure ont un identificateur unique affecté par Oracle, appelé identificateur Oracle Cloud (OCID). Pour des informations sur le format des OCID et sur les autres moyens d'identifier vos ressources, voir Identificateurs de ressource.
Authentification et autorisation
Chaque service d'Oracle Cloud Infrastructure est intégré avec le service de gestion des identités et des accès GIA aux fins d'authentification et d'autorisation, pour toutes les interfaces (console, trousse SDK ou interface de ligne de commande et API REST).
Un administrateur d'une organisation doit configurer les groupes , les compartiments et les politiques qui déterminent les utilisateurs pouvant accéder aux services et aux ressources, ainsi que le type d'accès. Par exemple, les politiques contrôlent qui peut créer des utilisateurs, créer et gérer le réseau en nuage, créer des instances, créer des seaux, télécharger des objets, etc. Pour plus d'informations, voir Gestion des domaines d'identité. Pour des détails précis sur l'écriture de politiques pour les différents services, voir Informations de référence sur les politiques.
Si vous êtes un utilisateur régulier (pas un administrateur) qui doit utiliser les ressources Oracle Cloud Infrastructure de la société, demandez à un administrateur de configurer un ID utilisateur pour vous. L'administrateur vous indiquera les compartiments que vous pouvez utiliser.
Capacités et limites du service de passerelle d'API
Le nombre de passerelles et de ressources d'API ainsi que de ressources de certificat du service de passerelle d'API que vous pouvez définir dans une région est contrôlé par les limites du service de passerelle d'API (voir Limites). Les limites de service par défaut varient selon le mode de paiement. Si vous avez besoin de plus de capacité, vous pouvez soumettre une demande pour augmenter les limites de service par défaut (voir Demande d'une augmentation de limite de service).
Certaines autres capacités et limites du service Passerelle d'API sont fixes. Vous pouvez toutefois en modifier un certain nombre. Voir Limites internes du service de passerelle d'API.
Pour définir des limites propres à un compartiment pour une ressource ou une famille de ressources, les administrateurs peuvent utiliser des quotas de compartiment.
Politique GIA requise
Pour utiliser Oracle Cloud Infrastructure, un administrateur doit être membre d'un groupe auquel l'accès de sécurité est accordé dans une politique par un administrateur de location. Cet accès est requis que vous utilisiez la console ou l'API REST avec une trousse SDK, l'interface de ligne de commande ou un autre outil. Si vous obtenez un message indiquant que vous ne disposez pas de l'autorisation requise, vérifiez auprès de l'administrateur de la location quel type d'accès vous avez et dans quel compartiment votre accès fonctionne.
Pour en connaître davantage sur les politiques, voir Introduction aux politiques et Politiques communes.
Pour plus de détails sur les politiques du service Passerelle d'API, voir :