Cr�er et g�rer des projets

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, undefined et ssl.

• 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() .

POST https://cloudresourcemanager.googleapis.com/v3/projects/
Authorization: *************
Content-Type: application/json

{
    "projectId": "our-project-123",
    "name": "my project",
    "labels": {
      "mylabel": "prod"
    }
}

{
    "name": "operations/pc.123456789",
}

GET https://cloudresourcemanager.googleapis.com/v3/operations/pc.123456789
Authorization: *************
Content-Type: application/json

{
    "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 projects create PROJECT_ID --organization=ORGANIZATION_ID --tags=KEY_VALUE_PAIRS

  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.

1. Accédez à la page Bienvenue dans la console Google Cloud.

   Accéder à la page d'accueil

2. 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).

GET https://cloudresourcemanager.googleapis.com/v3/projects/<var>PROJECT_ID</var>

{
    "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.

GET https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain

{
  "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="
    }
  ]
}

GET https://cloudresourcemanager.googleapis.com/v3/projects:search?query=labels.color%3Ared

{
  "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.

PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NUMBER?updateMask=displayName,labels

{
  "displayName": "myproject",
  "labels": {
    "color": "red"
  }
}

{
  "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

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�:

POST https://cloudresourcemanager.googleapis.com/v3/projects/my-project-123:undelete