Découvrez ce qu'est un ID de projet, pourquoi il est important et comment vous pouvez l'utiliser efficacement pour interagir avec vos projets via l'interface de ligne de commande (CLI).

Table des matières

1. Qu'est-ce qu'un ID de projet?
2. Différence entre le nom du projet et l'ID du projet
3. Pourquoi utiliser des ID de projet?
4. Utilisation des ID de projet dans les commandes CLI
5. Meilleures pratiques pour la gestion des ID de projet
6. Dépannage des problèmes courants
7. Glossaire

---

Qu'est-ce qu'un ID de projet?

Un ID de projet est un identifiant unique et immuable attribué à chaque projet lors de sa création. Contrairement aux noms de projet, qui peuvent être modifiés ou dupliqués entre les espaces de noms, l'ID de projet est garanti unique et persistant.

Considérez l'ID de projet comme l'empreinte digitale du projet — un moyen d'identifier et d'interagir de manière fiable avec le projet par programmation.

---

Différence entre le nom du projet et l'ID du projet

Aspect	Nom du projet	Numéro de projet
Unicité	Unique par espace de noms	Globalement unique au monde
Mutabilité	Peut être changé	Immutable
Human-friendly	Oui, généralement lisible	Typiquement un UUID ou un hash
Utilisation	Affichage, URLs	Appels API, commandes CLI

---

Pourquoi utiliser des ID de projet?

• Fiabilité: Évitez l'ambiguïté lors du référencement des projets, en particulier si les noms changent.
• Automatisation: Les scripts et les pipelines CI/CD peuvent utiliser des ID de projet pour interagir de manière cohérente.
• Sécurité: Les identifiants de projet peuvent être plus difficiles à deviner, ce qui réduit les accès accidentels ou non autorisés.
• Intégration: Les API et les outils tiers nécessitent souvent des ID de projet pour des actions précises.

---

Utilisation des ID de projet dans les commandes CLI

Lorsque vous utilisez la CLI pour gérer des projets, vous devez généralement référencer votre projet par son ID. Voici quelques exemples courants:

# List all projects to find the ID
cli-tool projects list

# Get detailed info about a project
cli-tool projects get --id <project-id>

# Deploy a build to a project using its ID
cli-tool deploy --project-id <project-id> --env production

# Delete a project by its ID
cli-tool projects delete --id <project-id>