Los proyectos de Google Cloud forman la base para crear, habilitar y usar todos los servicios de Google Cloud, incluidos la administración de las API, la habilitación de la facturación, el agregado y la eliminación de los colaboradores, y la administración de los permisos de los recursos de Google Cloud.
En esta página, se explica cómo crear y administrar proyectos de Google Cloud con la API de Cloud Resource Manager y la consola de Google Cloud.
Antes de comenzar
Lee sobre el recurso del proyecto en la Descripción general de la jerarquía de recursos. Si necesitas orientación para configurar tu jerarquía de recursos, consulta Decide una jerarquía de recursos para tu zona de destino de Google Cloud.
Los siguientes se usan para identificar tu proyecto:
Nombre del proyecto: Un nombre legible para tu proyecto.
El nombre del proyecto no se usa en las API de Google. Puedes editar el nombre del proyecto en cualquier momento durante o después de su creación. No es necesario que los nombres de los proyectos sean únicos.
ID del proyecto: Un identificador único global para tu proyecto.
Un ID del proyecto es una string única que se usa para diferenciar su proyecto de todos los demás en Google Cloud. Luego de que ingresas el nombre de un proyecto, La consola de Google Cloud genera un ID del proyecto único que puede ser una combinación letras, números y guiones. Te recomendamos usar el ID del proyecto generado, pero puedes editarla durante la creación del proyecto. Una vez creado el proyecto, el ID del proyecto es permanente.
Un ID del proyecto tiene los siguientes requisitos:
- Debe tener entre 6 y 30 caracteres.
- Solo puede contener letras minúsculas, números y guiones.
- Debe comenzar con una letra.
- No puede terminar con un guion.
- No puede estar en uso ni haber usado anteriormente. incluidos los proyectos borrados.
- No puede contener cadenas restringidas, como
google
,null
,undefined
yssl
.
Número de proyecto: Un identificador único generado de forma automática para tu proyecto.
No incluyas información sensible, como información de identificación personal (PII) o datos de seguridad en el nombre del proyecto, el ID del proyecto o en otros nombres de recursos. El ID del proyecto se usa en el nombre de muchos otros recursos de Google Cloud y cualquier la referencia al proyecto o a los recursos relacionados expone el ID del proyecto y el nombre del recurso.
Crea un proyecto
Para crear un proyecto, debes tener el permiso resourcemanager.projects.create
. Este permiso se incluye en funciones como la de Creador de proyectos
(roles/resourcemanager.projectCreator
). Se otorga el rol Creador del proyecto
de forma predeterminada a todo el dominio de un nuevo recurso de la organización y a los usuarios de la prueba gratuita.
Para obtener información sobre cómo otorgar el rol a las personas y limitar los recursos
acceso amplio, consulta la documentación sobre cómo administrar la organización
Roles.
Si no especificas el recurso superior, se seleccionará uno superior. automáticamente, si corresponde, según el dominio de la cuenta del usuario.
Puedes crear un nuevo proyecto usando la consola de Google Cloud,
Google Cloud CLI
el projects.create()
.
Console
Para crear un proyecto nuevo, haz lo siguiente:
-
Ve a la página Administrar recursos en la consola de Google Cloud.
Los pasos restantes aparecen en la consola de Google Cloud.
- En la lista desplegable Seleccionar una organización, en la parte superior de la página, selecciona el recurso de la organización en la que deseas crear un proyecto. Si eres un usuario de prueba gratuita, omite este paso, ya que no aparece esta lista.
- Haz clic en Crear proyecto.
- En la ventana Proyecto nuevo que aparece, ingresa un nombre de proyecto y selecciona una cuenta de facturación según corresponda. El nombre de un proyecto solo puede contener letras, números, comillas simples, guiones, espacios o signos de exclamación, y debe tener entre 4 y 30 caracteres.
- Ingresa el recurso de la organización o la carpeta superior en el cuadro Ubicación. Ese recurso será el superior de la jerarquía del proyecto nuevo. Si aparece Sin organización como opción, puedes seleccionarla para crear tu proyecto nuevo como el nivel superior de su propia jerarquía de recursos.
- Cuando hayas terminado de ingresar los detalles del proyecto nuevo, haz clic en Crear.
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.
Para crear un proyecto nuevo, usa el comando
gcloud projects create
:gcloud projects create PROJECT_ID
En este comando, PROJECT_ID es el ID del proyecto que quieres crear. El ID de un proyecto debe comenzar con una letra minúscula, contener solo letras, dígitos y guiones ASCII, y tener entre 6 y 30 caracteres.
Para crear un proyecto con un recurso de organización o una carpeta como superior, usa el Las marcas
--organization
o--folder
. Como un recurso puede tener solo un superior, se puede usar solo una de estas marcas:gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID
gcloud projects create PROJECT_ID --folder=FOLDER_ID
API
No puedes usar ciertas palabras en el ID del proyecto cuando creas un proyecto nuevo con el método projects.create()
. Algunos ejemplos incluyen google
, null
, undefined
y ssl
.
Cuando usas una palabra restringida, la solicitud muestra
un error INVALID_ARGUMENT
.
La siguiente solicitud solo crea un proyecto, no lo asocia de forma automática con una cuenta de facturación. Usa el método projects.updateBillingInfo
para configurar o actualizar la cuenta de facturación asociada con un proyecto.
Crea una solicitud de proyecto:
POST https://cloudresourcemanager.googleapis.com/v3/projects/
Authorization: *************
Content-Type: application/json
{
"projectId": "our-project-123",
"name": "my project",
"labels": {
"mylabel": "prod"
}
}
Crea una respuesta de proyecto:
{
"name": "operations/pc.123456789",
}
Obtén una solicitud de operación:
GET https://cloudresourcemanager.googleapis.com/v3/operations/pc.123456789
Authorization: *************
Content-Type: application/json
Obtén una respuesta de operación:
{
"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"
}
}
Agrega etiquetas durante la creación del proyecto
Las etiquetas proporcionan una forma de crear anotaciones para los recursos. Puedes agregar etiquetas al momento de crear los proyectos. Tú Debes asignar el rol Usuario de etiquetas cuando agregues etiquetas. Para obtener más información sobre los permisos asignados para este rol, consulta Administra etiquetas en los recursos. Solo puedes agregar el espacio de nombres para los pares clave-valor de la etiqueta de una de las siguientes maneras:
gcloud
Para agregar etiquetas durante la creación del proyecto, ejecuta el siguiente comando:
gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID --tags=KEY_VALUE_PAIRS
Reemplaza lo siguiente:
- PROJECT_ID es el identificador único del proyecto.
- ORGANIZATION_ID es el identificador único de la organización.
- KEY_VALUE_PAIRS es una lista de pares clave-valor separados por comas que puedes asignar a tu
recurso. Un ejemplo de pares clave-valor separados por comas es
123/environment=production, 456/create=testresource
.
API
El siguiente fragmento es una solicitud JSON en la que creas un proyecto y agregarle etiquetas.
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"
}
}
Crea un proyecto con una cuenta de servicio
Puedes usar una cuenta de servicio para automatizar la creación de proyectos. Al igual que las cuentas de usuario,
a las cuentas de servicio se les puede otorgar permiso para crear proyectos dentro de
recurso de la organización. Las cuentas de servicio no pueden crear proyectos fuera de un
recurso de la organización y debe especificar el recurso superior cuando se crea un proyecto.
Las cuentas de servicio pueden crear un proyecto nuevo con gcloud CLI o
projects.create()
.
Administra las cuotas del proyecto
Si quedan menos de 30 proyectos en tu cuota, la cantidad de proyectos restantes en tu cuota se mostrará en una notificación en la página Nuevo proyecto. Cuando hayas alcanzado el límite de tu proyecto, debes solicitar un aumento del límite de proyectos para crear más proyectos. Como alternativa, puedes programar algunos proyectos para que se borren después de 30 días en la página Administrar recursos. Los proyectos que los usuarios hayan borrado de forma no definitiva se descontarán de tu cuota. Estos proyectos se borran por completo después de 30 días.
Si quieres solicitar capacidad adicional para los proyectos de tu cuota, usa el Solicita un aumento de la cuota del proyecto formulario. Puedes encontrar más información sobre las cuotas y la razón de su uso en la página de asistencia sobre las solicitudes de cuotas del proyecto de prueba gratuita. Para obtener más información sobre los informes de facturación, consulta la página de asistencia Informes de facturación.
Identifica proyectos
Para interactuar con los recursos de Google Cloud, debes proporcionar la información de identificación del proyecto en cada solicitud. Un proyecto se identifica por el ID y el número de proyecto.
Para obtener el ID y el número del proyecto, haz lo siguiente:
Ve a la página Panel en la consola de Google Cloud.
Haz clic en la lista desplegable Seleccionar desde en la parte superior de la página. En la ventana Seleccionar desde que aparece, selecciona tu proyecto.
El ID y el número del proyecto se muestran en la tarjeta de Información del proyecto (Project info) del panel del proyecto:
![](https://cloud.google.com/static/resource-manager/img/project_id.png?authuser=0000&hl=es)
En el ejemplo anterior, el nombre del proyecto es My Sample Project y el ID del proyecto es my-sample-project-191923.
Obtén un proyecto existente
Puedes obtener un proyecto existente usando la consola de Google Cloud o
el projects.get()
.
Si no eres propietario del proyecto, debes tener los permisos que se incluyen en
Rol del navegador (roles/browser
).
Console
Para ver un proyecto con la consola de Google Cloud, haz lo siguiente:
- Ve a la página Panel en la consola de Google Cloud.
- En el selector de proyectos de la parte superior de la página, selecciona tu proyecto.
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.
Para obtener los metadatos de un proyecto, usa el comando
gcloud projects describe
:gcloud projects describe PROJECT_ID
En este comando, PROJECT_ID es el ID del proyecto que deseas ver.
API
Solicitud:
GET https://cloudresourcemanager.googleapis.com/v3/projects/our-project-123
Respuesta:
{
"projectNumber": "464036093014",
"projectId": "our-project-123",
"lifecycleState": "ACTIVE",
"name": "my project",
"labels": {
"mylabel": "prod"
},
"createTime": "2016-01-07T21:59:43.314Z"
}
Enumera los proyectos
Enumerar todos los proyectos de un recurso
Para enumerar todos los proyectos que son secundarios directos de un recurso, usa el comando
v3 projects.list
,
con el recurso superior especificado en la consulta:
Solicitud:
GET https://cloudresourcemanager.googleapis.com/v3/projects
{
"parent": "folders/662951040570"
}
Respuesta:
{
"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="
}
]
}
Busca proyectos
Para buscar proyectos que coincidan con la consulta especificada, usa gcloud alpha resource-manager
projects search
y pasa la consulta en la marca --query
. El alcance de la búsqueda
son todos los proyectos para los que el usuario tiene el permiso 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.
Para obtener la lista de todos los proyectos, usa
gcloud alpha projects search
: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
Puedes usar la
Método projects.search
y una cadena de consulta para obtener recursos específicos del proyecto que coincidan con el filtro.
Los resultados contienen solo proyectos en los que se te otorgó la
resourcemanager.projects.get
.
En el siguiente fragmento de código, se muestra el recurso Project con el nombre visible "Tokyo Rain":
Solicitud:
GET https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain
Respuesta:
{
"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="
}
]
}
En el siguiente fragmento de código, se muestran todos los recursos del proyecto con una etiqueta roja:
Solicitud:
GET https://cloudresourcemanager.googleapis.com/v3/projects:search?query=labels.color%3Ared
Respuesta:
{
"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 especificas los campos parent.type
y parent.id
en el cuerpo de la solicitud, entonces el permiso resourcemanager.projects.list
se verificará en el superior. Si el usuario tiene este permiso, todos los proyectos del superior se mostrarán después de que se hayan aplicado los filtros restantes.
Si el usuario no tiene este permiso, todos los proyectos en los que tiene el permiso resourcemanager.projects.get
se mostrarán después de que se hayan aplicado los filtros restantes.
Si no se especifica ningún filtro, la llamada mostrará los proyectos en los que el usuario
tiene los permisos resourcemanager.projects.get
.
Actualiza los proyectos
Puedes actualizar los proyectos con la consola de Google Cloud o
projects.patch()
.
Los únicos campos que se pueden actualizar son las etiquetas y el nombre del proyecto. Para obtener más información sobre la actualización de proyectos, consulta el página de referencia de la API del proyecto
Para mover un proyecto dentro de tu jerarquía de recursos, consulta Traslada un proyecto. Para migrar un proyecto desde un de una organización a otro, consulta Migra proyectos.
Console
Para actualizar el nombre o las etiquetas de un proyecto con la consola de Google Cloud, haz lo siguiente:
- En la consola de Google Cloud, ve a la página Configuración de IAM y administración.
Ir a IAM y Configuración del administrador
Los pasos restantes aparecen en la consola de Google Cloud.
- En la parte superior de la pantalla, haz clic en la lista desplegable de selección de proyectos.
- En la ventana Seleccionar desde que aparece, haz clic en la lista desplegable de las organizaciones y, luego, selecciona tu organización. Si eres un usuario de prueba gratuita, omite este paso, ya que la lista de organizaciones no aparece.
- Selecciona tu proyecto en la lista que aparece.
- Para cambiar el nombre del proyecto, edita el Nombre del proyecto y, luego, haz clic en Guardar.
- Para cambiar las etiquetas, haz clic en Etiquetas en el navegador izquierdo.
Obtén más información para usar etiquetas.
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.
Para actualizar el nombre o las etiquetas de un proyecto, usa el comando
gcloud alpha projects update
:gcloud alpha projects update PROJECT_ID \ --name=NAME \ --update-labels=KEY=VALUE, ...
Donde:
PROJECT_ID es el ID del proyecto que deseas actualizar.
NAME es el nuevo nombre que deseas asignar al proyecto.
KEY=VALUE, ... es una lista de los pares clave-valor de etiquetas que quieres actualizar. Si ya existe una etiqueta, su valor se modifica. Si no existe, se crea una etiqueta nueva.
Para obtener más información y otras marcas que se pueden usar con esto consulta la SDK de Google Cloud CLI.
API
Para actualizar un proyecto, haz lo siguiente:
Obtén el objeto
project
con elprojects.get
.Modifica los campos que deseas actualizar.
Realiza una llamada al método
projects.patch
.
En el siguiente ejemplo, se actualiza el nombre visible del proyecto a
myproject
y establece la etiqueta color
en red
:
Solicitud:
PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NUMBER?updateMask=displayName,labels
En el ejemplo anterior, PROJECT_NUMBER
es el ID numérico del proyecto que deseas.
para actualizarlo.
Cuerpo JSON de la solicitud:
{
"displayName": "myproject",
"labels": {
"color": "red"
}
}
Respuesta:
{
"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"
}
}
]
}
Desactivar (borrar) proyectos
Puedes cerrar los proyectos con la consola de Google Cloud o
projects.delete
en la API. Para poder cerrarse, un proyecto debe tener un estado de ciclo de vida ACTIVE
de esta manera.
Con este método, se marca de forma inmediata un proyecto para que se borre. Se envía un correo electrónico de notificación al usuario que inició la operación de eliminación y a los contactos de categoría técnica que se enumeran en Contactos esenciales según el criterio del mejor esfuerzo. Si no se envía la notificación, el proyecto se marcará para borrarse. Si no hay ningún contacto en la categoría Técnica, no se notifica al contacto de resguardo.
No se puede usar un proyecto que se haya marcado para que se elimine. Si el proyecto tiene una cuenta de facturación asociada, se rompe esa asociación y no se restablece si se cancela la operación de eliminación del proyecto. Después de 30 días, el proyecto se borra por completo. Hasta que se haya borrado por completo, el proyecto puede ser visible, aunque no se pueda usar.
Para detener el proceso de eliminación del proyecto durante el período de 30 días, consulta los pasos para restablecer un proyecto.
Al final del período de 30 días, el proyecto y todos sus recursos se borran y no se pueden recuperar. Hasta que se haya borrado, el proyecto se contará en la cuota de tu proyecto.
Para asegurarte de no borrar proyectos importantes, puedes habilitar las recomendaciones de cambio de riesgo. Riesgo de cambio las recomendaciones generan advertencias cuando intentas borrar proyectos que Google Cloud tiene identificaste como importantes.
Si configuraste la facturación de un proyecto, es posible que no se borre por completo hasta que finalice el ciclo de facturación actual y tu cuenta se cargue con éxito. La cantidad y los tipos de servicios en uso también pueden afectar el momento en que el sistema borra de forma permanente un proyecto. Para obtener más información sobre la eliminación segura y la retención de datos, consulta la página sobre cómo conserva Google los datos que recopila.
Para cerrar un proyecto, sigue estos pasos:
Console
-
En la consola de Google Cloud, ve a la página Configuración de IAM y administración.
Ir a IAM y Configuración del administrador
Los pasos restantes aparecen en la consola de Google Cloud.
-
En la pestaña IAM y Configuración del administrador, selecciona el proyecto que quieres borrar y, luego,
Haz clic en Apagar.
La opción Apagar solo aparece para los usuarios que tienen
resourcemanager.projects.delete
. permiso en el proyecto actual. - Haz clic en Cerrar.
- Ingresa el ID del proyecto y, luego, haz clic en Cerrar de todas formas.
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.
Para borrar un proyecto, usa el comando
gcloud projects delete
:gcloud projects delete PROJECT_ID
En este comando, PROJECT_ID es el ID del proyecto que deseas borrar.
API
Con el siguiente fragmento de código, se borra el proyecto especificado:
Solicitud:
DELETE https://cloudresourcemanager.googleapis.com/v3/projects/my-project-123
Soluciona problemas de eliminación de proyectos
Si el proceso para cerrar un proyecto falla, puedes encontrar más información en Soluciona problemas de eliminación de proyectos.
Restablece un proyecto
Los propietarios del proyecto pueden restablecer un proyecto borrado dentro del período de recuperación de 30 días, que comienza cuando se cierra el proyecto. Si restableces un proyecto, se devolverá a el estado en el que estaba antes de que se apagara, con ciertas excepciones:
- La facturación se inhabilita en el proyecto cuando se cierra el proyecto y la facturación no se habilita automáticamente en los proyectos restablecidos. El La cuenta de Facturación de Cloud se debe vincular manualmente luego de que se restablezca el proyecto. Es posible que debas esperar unas horas para poder vincular correctamente un proyecto restablecido recientemente a un plan de de servicio predeterminada.
- Puedes recuperar la mayoría de los recursos si restableces un proyecto dentro del plazo de 30 días período. El restablecimiento de algunos servicios presenta demoras, por lo que es posible que debas esperar. para que se restablezcan los servicios.
- Algunos recursos, como Cloud Storage o Pub/Sub, se borran mucho antes. Es posible que estos recursos no se puedan recuperar por completo, incluso si restableces el proyecto dentro del período de 30 días.
- Es posible que algunos servicios deban reiniciarse de forma manual. Para obtener más información, consulta Reinicia los servicios de Google Cloud Platform.
Debes tener el permiso resourcemanager.projects.undelete
en el proyecto
que deseas restablecer. Para restablecer un proyecto, sigue estos pasos:
Console
Para ver el proyecto en la consola de Google Cloud, necesitas lo siguiente: permisos:
resourcemanager.projects.list
resourcemanager.folders.list
resourcemanager.projects.get
Para restablecer un proyecto con la consola de Google Cloud, sigue estos pasos:
Ve a la página Administrar recursos en la consola de Google Cloud.
En el Selector de proyectos de la parte superior de la página, selecciona tu recurso de la organización.
Debajo de la lista de recursos, carpetas y proyectos de la organización, haz clic en Recursos pendientes de eliminación.
Marca la casilla del proyecto que deseas restablecer y, luego, haz clic en Restablecer. En el cuadro de diálogo que aparece, confirma que deseas restablecer el proyecto.
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.
Para restablecer un proyecto, usa el comando
gcloud projects undelete
:gcloud projects undelete PROJECT_ID
En este comando, PROJECT_ID es el ID del proyecto o el número del proyecto que deseas restablecer.
API
Con el siguiente fragmento de código, se restablece el proyecto especificado:
Solicitud:
POST https://cloudresourcemanager.googleapis.com/v3/projects/my-project-123:undelete