Les projets Google Cloud constituent une base pour la création, l'activation et l'utilisation de tous les services Google Cloud, comme la gestion des API, la facturation, l'ajout et la suppression de collaborateurs, et la gestion des autorisations pour les ressources Google Cloud.
Cette page explique comment créer et gérer des projets Google Cloud à l'aide de l'API Cloud Resource Manager et la console Google Cloud.
Avant de commencer
Pour en savoir plus sur les ressources du projet, consultez la présentation de la hiérarchie des ressources. Pour obtenir des conseils sur la configuration de votre hiérarchie de ressources, consultez la page Choisir une hiérarchie de ressources pour votre zone de destination Google Cloud.
Les éléments suivants sont utilisés pour identifier votre projet:
Nom de projet : nom lisible attribué à votre projet.
Le nom de projet n'est utilisé par aucune API Google. Vous pouvez modifier le nom d'un projet à tout moment, aussi bien pendant qu'après la création du projet. Les noms de projet ne doivent pas nécessairement être uniques.
ID de projet : identifiant unique global pour votre projet.
Un ID de projet est une chaîne unique utilisée pour différencier votre projet des autres dans Google Cloud. Une fois que vous avez saisi un nom de projet, la console Google Cloud génère un ID de projet unique qui peut être une combinaison de lettres, de chiffres et de traits d'union. Nous vous recommandons d'utiliser l'ID de projet généré, mais vous pouvez le modifier lors de la création du projet. Une fois le projet créé, son ID est permanent.
Un ID de projet doit respecter les exigences suivantes :
- L'ID doit contenir entre 6 et 30 caractères.
- L'ID ne peut contenir que des lettres minuscules, des chiffres et des traits d'union.
- Doit commencer par une lettre.
- Il ne peut pas se terminer par un trait d'union.
- Il ne peut pas être déjà utilisé ou avoir été utilisé précédemment (y compris pour des projets supprimés).
- Il ne peut pas contenir de chaînes restreintes comme
google,null,undefinedetssl.
Numéro de projet : identifiant unique généré automatiquement pour votre projet.
N'incluez pas d'informations sensibles, telles que des informations permettant d'identifier personnellement l'utilisateur. ou de sécurité dans le nom de votre projet, son ID ou d'autres noms de ressources. L'ID du projet est utilisé dans le nom de nombreuses autres ressources Google Cloud. au projet ou aux ressources associées expose l'ID du projet et le nom de la ressource.
Créer un projet
Pour créer un projet, vous devez disposer de l'autorisation resourcemanager.projects.create. Cette autorisation est incluse dans des rôles tels que le rôle de créateur de projet (roles/resourcemanager.projectCreator). Ce rôle est attribué par défaut à l'ensemble du domaine d'une nouvelle ressource d'organisation et aux utilisateurs de l'essai gratuit.
Découvrez comment attribuer le rôle à des utilisateurs et limiter les ressources de l'organisation
pour un accès étendu, consultez le document Managing Default Organization
Rôles.
Si vous ne spécifiez pas la ressource parente, une ressource parente est sélectionnée. automatiquement, le cas échéant, en fonction du domaine du compte d'utilisateur.
Vous pouvez créer un projet à l'aide de la console Google Cloud,
la Google Cloud CLI, ou
le projects.create()
.
Console
Pour créer un projet, procédez comme suit :
-
Accédez à la page Gérer les ressources de la console Google Cloud.
Accéder à la page Gérer les ressources
Les étapes restantes s'affichent dans la console Google Cloud.
- Dans la liste déroulante Sélectionner une organisation en haut de la page, sélectionnez la ressource d'organisation dans laquelle vous souhaitez créer un projet. Si vous êtes un utilisateur de la version d'essai sans frais, vous pouvez ignorer cette étape. Cette liste n'apparaîtra pas.
- Cliquez sur Créer un projet.
- Dans la fenêtre Nouveau projet qui s'affiche, saisissez un nom de projet, puis sélectionnez un compte de facturation si nécessaire. Le nom du projet ne peut contenir que des lettres, des chiffres, des guillemets simples, des traits d'union, des espaces ou des points d'exclamation. Il doit comporter entre 4 et 30 caractères.
- Indiquez l'organisation ou le dossier parent dans la zone Emplacement. Cette ressource sera le parent hiérarchique du nouveau projet. Si l'option Aucune organisation est proposée, vous pouvez la sélectionner pour créer votre projet en tant que niveau supérieur de sa propre hiérarchie de ressources.
- Une fois les détails du nouveau projet renseignés, cliquez sur Créer.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Pour créer un projet, utilisez la commande
gcloud projects create:gcloud projects create PROJECT_IDPROJECT_ID correspond à l'ID du projet que vous souhaitez créer. L'ID du projet doit commencer par une lettre en minuscule et ne peut contenir que des lettres ASCII, des chiffres et des tirets. Il doit comporter entre 6 et 30 caractères.
Pour créer un projet avec une ressource Organisation ou un dossier comme parent, utilisez la classe Options
--organizationou--folder. Comme une ressource ne peut avoir qu'un parent, seul l'un de ces indicateurs peut être utilisé.gcloud projects create PROJECT_ID --organization=ORGANIZATION_IDgcloud projects create PROJECT_ID --folder=FOLDER_ID
API
Certains mots ne peuvent pas être utilisés dans l'ID d'un projet créé à l'aide de la méthode projects.create(). Exemples : google, null, undefined et ssl.
Si vous utilisez l'un de ces mots, la requête renvoie une erreur INVALID_ARGUMENT.
La requête ci-dessous crée uniquement un projet et ne l'associe pas automatiquement à un compte de facturation. La méthode projects.updateBillingInfo permet de définir ou de mettre à jour le compte de facturation associé à un projet.
Requête pour créer un projet :
POST https://cloudresourcemanager.googleapis.com/v3/projects/
Authorization: *************
Content-Type: application/json
{
"projectId": "our-project-123",
"name": "my project",
"labels": {
"mylabel": "prod"
}
}
Réponse pour la création du projet :
{
"name": "operations/pc.123456789",
}
Requête pour l'opération Get :
GET https://cloudresourcemanager.googleapis.com/v3/operations/pc.123456789
Authorization: *************
Content-Type: application/json
Réponse pour l'opération Get :
{
"name": "operations/pc.123456789",
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloudresourcemanager.v3.Project",
"projectNumber": "464036093014",
"projectId": "our-project-123",
"lifecycleState": "ACTIVE",
"name": "my project",
"labels": {
"mylabel": "prod"
},
"createTime": "2016-01-07T21:59:43.314Z"
}
}
Ajouter des tags lors de la création du projet
Les tags permettent de créer des annotations pour les ressources. Vous pouvez ajouter des tags au moment de la création des projets. Vous devez attribuer le rôle Utilisateur de balise lorsque vous ajoutez des balises. Pour en savoir plus sur les autorisations attribuées à ce rôle, consultez Gérer les tags sur les ressources. Vous ne pouvez ajouter l'espace de noms pour les paires clé-valeur du tag que de l'une des manières suivantes:
gcloud
Pour ajouter des tags lors de la création d'un projet, exécutez la commande suivante :
gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID --tags=KEY_VALUE_PAIRS
Remplacez les éléments suivants :
- PROJECT_ID est l'identifiant unique du projet.
- ORGANIZATION_ID est l'identifiant unique de l'organisation.
- KEY_VALUE_PAIRS est une liste de paires clé-valeur séparées par des virgules que vous pouvez attribuer à votre ressource.
123/environment=production, 456/create=testresourceest un exemple de paires clé-valeur séparées par une virgule.
API
L'extrait de code suivant est une requête JSON dans laquelle vous créez un projet et et lui ajouter des tags.
POST https://cloudresourcemanager.googleapis.com/v3/projects/
Authorization: *************
Content-Type: application/json
{
"projectId": "our-project-456",
"name": "my project",
"parent": "organizations/123",
"tags": {
"key": "123/environment"
"value": "production"
},
"tags": {
"key": "123/costCenter"
"value": "marketing"
}
}
Créer un projet à l'aide d'un compte de service
Vous pouvez utiliser un compte de service pour automatiser la création de projet. Comme les comptes d’utilisateurs,
comptes de service peuvent être autorisés à créer des projets dans un
ressource d'organisation. Les comptes de service ne sont pas autorisés à créer de projets en dehors d'une ressource d'organisation et doivent spécifier la ressource parente lors de la création d'un projet.
Les comptes de service peuvent créer un projet à l'aide de gcloud CLI ou de la
projects.create().
Gérer des quotas de projets
S'il vous reste moins de 30 projets dans votre quota, une notification affiche le nombre de projets restants sur la page Nouveau projet. Une fois que vous avez atteint votre limite de projets. Pour créer davantage de projets, vous devez demander une limite de projets. augmenter. Vous pouvez également planifier la suppression de certains projets au bout de 30 jours sur la page Gérer les ressources. Les projets des utilisateurs supprimé de façon réversible est comptabilisée dans votre quota. Ces projets sont entièrement supprimés après 30 jours.
Pour demander une plus grande capacité pour les projets dans votre quota, utilisez le formulaire de demande d'augmentation de quota de projet. Pour en savoir plus sur les quotas et leur utilisation, consultez la page d'assistance concernant les demandes de quota de projets dans le cadre de l'essai gratuit. Pour en savoir plus sur les rapports de facturation, consultez la page d'assistance Rapports de facturation.
Trouver le nom, le numéro et l'ID du projet
Pour interagir avec les ressources Google Cloud, vous devez fournir des informations permettant l'identification du projet pour chaque requête. Un projet est identifié par son ID de projet et son numéro de projet.
Accédez à la page Bienvenue dans la console Google Cloud.
Dans le sélecteur de projets situé en haut de la page, sélectionnez votre projet.
Le nom, le numéro et l'ID du projet apparaissent après le Bienvenue.
Obtenir un projet existant
Vous pouvez obtenir un projet existant à l'aide de la Google Cloud CLI ou
le projects.get()
.
Si vous n'êtes pas propriétaire d'un projet, vous devez disposer des autorisations incluses dans le rôle Navigateur (roles/browser).
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Pour obtenir les métadonnées d'un projet, utilisez la commande
gcloud projects describe:gcloud projects describe PROJECT_IDRemplacez
PROJECT_IDpar l'ID du projet.
API
Requête :
GET https://cloudresourcemanager.googleapis.com/v3/projects/<var>PROJECT_ID</var>
Remplacez PROJECT_ID par l'ID du projet.
Réponse :
{
"projectNumber": "464036093014",
"projectId": "our-project-123",
"lifecycleState": "ACTIVE",
"name": "my project",
"labels": {
"mylabel": "prod"
},
"createTime": "2016-01-07T21:59:43.314Z"
}
Répertorier tous les projets d'une ressource
Pour répertorier tous les projets qui sont des enfants directs d'une ressource, utilisez la méthode projects.list v3 avec la ressource parente spécifiée dans la requête :
Requête :
GET https://cloudresourcemanager.googleapis.com/v3/projects
{
"parent": "folders/662951040570"
}
Réponse :
{
"projects": [
{
"name": "projects/951040570662",
"parent": "folders/662951040570",
"projectId": "tokyo-rain-123",
"state": "ACTIVE",
"displayName": "Tokyo Rain"
"createTime": "2013-11-13T20:31:53.308Z"
"updateTime": "2013-11-13T20:31:53.308Z"
"etag": "BwWUlZ6XEfY="
}
]
}
Rechercher des projets
Pour rechercher des projets correspondant à la requête spécifiée, utilisez gcloud alpha resource-manager
projects search en transmettant la requête dans l'option --query. Le champ d'application de la recherche correspond à tous les projets pour lesquels l'utilisateur dispose de l'autorisation projects.get.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Pour obtenir la liste de tous les projets, utilisez
gcloud alpha projects searchcommande:gcloud alpha projects search --query="displayName=rek*" <table output showing the projects with display names starting from rek eg. rekey-project-2, rekha-project>gcloud alpha projects search --query="state:DELETE_REQUESTED" <table output showing the projects for which delete has been requested>
API
Vous pouvez utiliser la méthode projects.search et une chaîne de requête pour renvoyer des ressources de projet spécifiques qui correspondent au filtre.
Les résultats ne contiennent que des projets pour lesquels vous disposez de l'autorisation resourcemanager.projects.get.
L'extrait de code suivant renvoie la ressource de projet nommée "Tokyo Rain" :
Requête :
GET https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain
Réponse :
{
"projects": [
{
"name": "projects/951040570662",
"parent": "folders/662951040570",
"projectId": "tokyo-rain-123",
"state": "ACTIVE",
"displayName": "Tokyo Rain",
"createTime": "2013-11-13T20:31:53.308Z",
"updateTime": "2013-11-13T20:31:53.308Z",
"etag": "BwWUlZ6XEfY="
}
]
}
L'extrait de code suivant renvoie toutes les ressources de projet présentant un libellé "red" (rouge) :
Requête :
GET https://cloudresourcemanager.googleapis.com/v3/projects:search?query=labels.color%3Ared
Réponse :
{
"projects": [
{
"name": "projects/951054970012",
"parent": "folders/662951040570",
"projectId": "Osaka-rain-234",
"state": "ACTIVE",
"displayName": "Osaka Rain",
"createTime": "2013-11-13T20:31:53.308Z",
"updateTime": "2013-11-13T20:31:53.308Z",
"etag": "BwWUlZ6XEfY=",
"labels": {
"color": "red"
}
}
]
}
Si vous spécifiez les champs parent.type et parent.id dans le corps de la requête, l'autorisation resourcemanager.projects.list est vérifiée au niveau du parent. Si l'utilisateur dispose de cette autorisation, tous les projets situés sous le parent seront affichés une fois les filtres restants appliqués.
Si l'utilisateur ne dispose pas de cette autorisation, tous les projets pour lesquels il dispose de l'autorisation resourcemanager.projects.get seront renvoyés une fois les filtres restants appliqués.
Si aucun filtre n'est spécifié, l'appel renvoie les projets pour lesquels l'utilisateur dispose des autorisations resourcemanager.projects.get.
Mettre à jour des projets
Vous pouvez mettre à jour des projets à l'aide de la console Google Cloud ou du
projects.patch()
.
Les seuls champs pouvant être mis à jour sont ceux du nom du projet et des libellés. Pour en savoir plus sur la mise à jour des projets, consultez la page concernant la ressource "Projet" dans la documentation de référence sur les API.
Pour déplacer un projet dans la hiérarchie de vos ressources, consultez la page Déplacer un projet. Pour migrer un projet d'un ressource d'organisation vers une autre, consultez la section Migrer des projets.
Console
Pour mettre à jour le nom ou les libellés d'un projet à l'aide de la console Google Cloud, procédez comme suit :
- Dans la console Google Cloud, accédez à la page Paramètres de la section IAM et administration.
Accéder à la page Paramètres de la section IAM et administration
Les étapes restantes s'affichent dans la console Google Cloud.
- En haut de l'écran, cliquez sur la liste déroulante de sélection de projets.
- Dans la fenêtre Sélectionnez une organisation qui s'affiche, cliquez sur la liste déroulante des organisations, puis sélectionnez votre organisation. Si vous êtes un utilisateur de la version d'essai sans frais, ignorez cette étape car cette liste n'apparaîtra pas.
- Sélectionnez votre projet dans la liste qui apparaît.
- Pour changer le nom du projet, modifiez le nom du projet, puis cliquez sur Enregistrer.
- Pour changer les libellés, cliquez sur Libellés dans la barre de navigation de gauche.
En savoir plus sur l'utilisation des libellés.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Pour mettre à jour le nom ou les libellés d'un projet, exécutez la commande
gcloud alpha projects update:gcloud alpha projects update PROJECT_ID \ --name=NAME \ --update-labels=KEY=VALUE, ...Où :
PROJECT_ID est l'ID du projet que vous souhaitez mettre à jour.
NAME est le nouveau nom que vous souhaitez attribuer au projet.
KEY = VALUE, ... est une liste des paires clé/valeur correspondant aux libellés que vous souhaitez mettre à jour. Si un libellé existe déjà, sa valeur est modifiée. Si ce n'est pas le cas, un libellé est créé.
Pour en savoir plus et obtenir des options supplémentaires pouvant être utilisées avec cette commande, consultez le SDK Google Cloud CLI.
API
Pour mettre à jour un projet, procédez comme suit :
Récupérez l'objet
projectà l'aide de la méthodeprojects.get.Modifiez les champs que vous souhaitez mettre à jour.
Appelez la méthode
projects.patch.
L'exemple suivant met à jour le nom à afficher du projet en myproject et définit le libellé color sur red :
Requête :
PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NUMBER?updateMask=displayName,labels
Où PROJECT_NUMBER correspond à l'ID numérique du projet souhaité.
à mettre à jour.
Corps JSON de la requête :
{
"displayName": "myproject",
"labels": {
"color": "red"
}
}
Réponse :
{
"projects": [
{
"name": "projects/951054970012",
"parent": "folders/662951040570",
"projectId": "Osaka-rain-234",
"state": "ACTIVE",
"displayName": "myproject",
"createTime": "2013-11-13T20:31:53.308Z",
"updateTime": "2013-11-13T20:35:42.308Z",
"etag": "BwWUlZ6XEfY=",
"labels": {
"color": "red"
}
}
]
}
Arrêter (supprimer) des projets
Vous pouvez arrêter des projets à l'aide de la console Google Cloud ou
projects.delete
de l'API. Pour pouvoir être arrêté, un projet doit avoir l'état de cycle de vie ACTIVE
de cette manière.
Cette méthode marque immédiatement un projet à supprimer. Un e-mail de notification est envoyé à l'utilisateur à l'origine de l'opération de suppression et à l'agent de catégorie de contacts qui sont répertoriés dans Contacts essentiels au mieux, Si l'envoi de la notification échoue, le projet est tout de même marqué pour être supprimé. S'il n'y a pas de contact dans la catégorie Technique, le contact de remplacement n'en est pas informé.
Un projet marqué "à supprimer" n'est pas utilisable. Si un compte de facturation est associé au projet, cette association est interrompue et n'est pas rétablie si l'opération de suppression du projet est annulée. Après 30 jours, le projet est complètement supprimé. Jusqu'à sa suppression complète, il est possible que le projet soit toujours visible, bien qu'elle ne soit pas utilisable.
Pour arrêter le processus de suppression du projet pendant cette période de 30 jours, consultez les étapes à suivre pour restaurer un projet.
À la fin de cette période de 30 jours, le projet et toutes ses ressources sont supprimés et ne peuvent pas être récupérés. Jusqu'à sa suppression, le projet est pris en compte dans votre quota de projets.
Pour vous assurer de ne supprimer aucun projet important, vous pouvez activer les recommandations sur les risques liés au changement. Risque lié à la modification les recommandations génèrent des avertissements lorsque vous essayez de supprimer des projets identifiés comme importants.
Si vous avez configuré la facturation pour un projet, il risque de ne pas être complètement supprimé tant que le cycle de facturation en cours n'est pas fini et que votre compte n'est pas débité. Le nombre et les types de services utilisés peuvent également avoir une influence sur le moment où le système supprime définitivement un projet. Pour en savoir plus sur la conservation et la suppression sécurisée des données, consultez la page Comment Google conserve-t-il les données recueillies ?.
Arrêter un projet
Console
-
Dans la console Google Cloud, accédez à la page Paramètres de la section IAM et administration.
Accéder à la page Paramètres de la section IAM et administration
Les étapes restantes s'affichent dans la console Google Cloud.
-
Sur la page IAM et Paramètres de l'administrateur, sélectionnez le projet que vous souhaitez supprimer, puis
cliquez sur Arrêter.
L'option Arrêter ne s'affiche que pour les utilisateurs disposant du rôle
resourcemanager.projects.delete. dans le projet actuel. - Cliquez sur Arrêter.
- Saisissez l'ID du projet, puis cliquez sur Arrêter quand même.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Pour supprimer un projet, utilisez la commande
gcloud projects delete:gcloud projects delete PROJECT_IDPROJECT_ID correspond à l'ID du projet que vous souhaitez supprimer.
API
L'extrait de code suivant supprime le projet spécifié :
Requête :
DELETE https://cloudresourcemanager.googleapis.com/v3/projects/my-project-123
Résoudre les problèmes de suppression de projets
Si le processus d'arrêt d'un projet échoue, consultez la page Résoudre les problèmes de suppression de projets pour en savoir plus.
Restaurer un projet
Les propriétaires de projets peuvent restaurer un projet supprimé tout au long de la période de récupération de 30 jours, qui commence à l'arrêt du projet. La restauration d'un projet le ramène à l'état dans lequel elle se trouvait avant son arrêt, à quelques exceptions près:
- La facturation est désactivée pour le projet lorsque le projet est arrêté et la facturation n'est pas automatiquement activée pour les projets restaurés. La Le compte de facturation Cloud doit être associé manuellement après la restauration du projet. Vous devrez peut-être attendre quelques heures avant de pouvoir associer un projet récemment restauré à un compte de facturation de service.
- Vous pouvez récupérer la plupart des ressources si vous restaurez un projet dans le délai de 30 jours période.
- La restauration de certains services est retardée, et vous devrez peut-être attendre un certain temps (jusqu'à 36 heures) pour que les services soient restaurés.
- Certaines ressources, telles que les ressources Cloud Storage ou Pub/Sub, sont supprimées beaucoup plus tôt. Ces ressources risquent de ne pas être entièrement récupérables, même si vous restaurez le projet avant la fin des 30 jours.
- Certains services peuvent avoir besoin d'être redémarrés manuellement. Pour en savoir plus, consultez la page Redémarrage des services Google Cloud Platform.
Vous devez disposer de l'autorisation resourcemanager.projects.undelete sur le projet que vous souhaitez restaurer. Pour restaurer un projet :
Console
Pour afficher le projet dans la console Google Cloud, vous devez disposer des autorisations suivantes :
resourcemanager.projects.listresourcemanager.folders.listresourcemanager.projects.get
Accédez à la page Gérer les ressources de la console Google Cloud.
Dans l'outil de sélection de projets situé en haut de la page, sélectionnez la ressource de votre organisation.
Sous la liste des ressources, des dossiers et des projets de l'organisation, cliquez sur Ressources en attente de suppression.
Cochez la case correspondant au projet que vous souhaitez restaurer, puis cliquez sur Restaurer. Dans la boîte de dialogue qui s'affiche, confirmez que vous souhaitez restaurer le projet.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Pour restaurer un projet, exécutez la commande
gcloud projects undelete:gcloud projects undelete PROJECT_IDPROJECT_ID est l'ID ou le numéro de projet du le projet que vous souhaitez restaurer.
API
L'extrait de code suivant restaure le projet spécifié :
Requête :
POST https://cloudresourcemanager.googleapis.com/v3/projects/my-project-123:undelete