> Discover all available pages from the documentation index: https://mastra.zisheng.pro/fr/llms.txt

# Mastra.getGatewayById()

Récupère une passerelle à partir de son ID unique (la propriété `id` de l’instance de passerelle). Cette méthode est utile pour rechercher une passerelle par son identifiant intrinsèque plutôt que par sa clé d’enregistrement.

## Exemple d’utilisation

```typescript
import { Mastra } from '@mastra/core'

const mastra = new Mastra({
  gateways: {
    customKey: new MyCustomGateway(), // id = 'my-custom-gateway'
  },
})

// Retrieve by ID (not registration key)
const gateway = mastra.getGatewayById('my-custom-gateway')
console.log(gateway.name) // 'My Custom Gateway'
```

## Cas d’utilisation

- Versionnement des passerelles : différentes versions avec des ID uniques (`'gateway-v1'`, `'gateway-v2'`)
- Recherche de passerelles lorsque les clés d’enregistrement sont inconnues
- Identification de passerelles entre différentes instances Mastra

## Paramètres

**id** (`string`): ID unique de la passerelle (propriété gateway.id)

## Valeur renvoyée

**gateway** (`MastraModelGateway | undefined`): Instance de passerelle, ou undefined si elle est introuvable

## Voir aussi

- [Mastra.getGateway()](https://mastra.zisheng.pro/fr/reference/core/getGateway): Récupérer une passerelle par clé d’enregistrement
- [Mastra.listGateways()](https://mastra.zisheng.pro/fr/reference/core/listGateways): Lister toutes les passerelles
- [Mastra.addGateway()](https://mastra.zisheng.pro/fr/reference/core/addGateway): Ajouter une passerelle
- [MastraModelGateway](https://mastra.zisheng.pro/fr/reference/core/mastra-model-gateway): Classe de base des passerelles
- [Guide des passerelles personnalisées](https://mastra.zisheng.pro/fr/models/gateways/custom-gateways): Créer des passerelles personnalisées