Crea y administra proyectos

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 acerca del recurso del proyecto en la descripción general de la jerarquía de recursos. Para obtener orientación sobre cómo configurar tu jerarquía de recursos, consulta Elige una jerarquía de recursos para la 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. Después de ingresar un nombre de proyecto, la consola de Google Cloud genera un ID de proyecto único que puede ser una combinación de letras, números y guiones. Te recomendamos usar el ID del proyecto generado, pero puedes editarla durante la creación del proyecto. Después de crear 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 se puede estar usando ni se puede haber usado anteriormente, lo que incluye los proyectos borrados.
  • No puede contener cadenas restringidas, como google, null, undefined y ssl.

• 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 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 proyecto nuevo con la consola de Google Cloud, Google Cloud CLI o el método 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"
    }
}

Agrega etiquetas durante la creación del proyecto

Las etiquetas proporcionan una forma de crear anotaciones para los recursos. Puedes agregar etiquetas cuando creas proyectos. Tú Debes asignar el rol Usuario de etiquetas cuando agregues etiquetas. Para obtener más información sobre los permisos asignados a 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 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"
  }
}

Crea un proyecto con una cuenta de servicio

Puedes usar una cuenta de servicio para automatizar la creación de proyectos. Al igual que a las cuentas de usuario, a las cuentas de servicio se les puede otorgar permiso para crear proyectos dentro de un recurso de organización. Las cuentas de servicio no pueden crear proyectos fuera de un recurso de organización y deben especificar el recurso superior durante la creación de 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. Después de haber alcanzado su límite de proyectos; para crear más, debes solicitar un límite el aumento de la demanda. 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.

Busca el nombre, el número y el ID del proyecto

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.

1. Ve a la página Te damos la bienvenida en la consola de Google Cloud.

   Ir a Te damos la bienvenida

2. En el selector de proyectos de la parte superior de la página, selecciona tu proyecto.

   El nombre, el número y el ID del proyecto aparecen después del encabezado Te damos la bienvenida.

Obtén un proyecto existente

Puedes obtener un proyecto existente usando Google Cloud CLI el projects.get() .

Si no eres propietario del proyecto, debes tener los permisos que se incluyen en Rol del navegador (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"
}

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.

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 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 el método 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.

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

Desactivar (borrar) proyectos

Puedes cerrar los proyectos con la consola de Google Cloud o projects.delete en la API. Un proyecto debe tener un estado de ciclo de vida ACTIVE para que se pueda cerrar de esta forma.

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 ningún proyecto importante, puedes habilitar las recomendaciones de riesgo de cambios. Las recomendaciones de riesgos de cambios generan advertencias cuando intentas borrar proyectos que Google Cloud identificó 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.

Cómo cerrar un proyecto

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.

Cómo restablecer 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. El restablecimiento de un proyecto lo devuelve al estado en el que estaba antes de ser cerrado, con ciertas excepciones:

• La facturación se inhabilita en el proyecto cuando se cierra y 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 período de 30 días.
• Se retrasó el restablecimiento de algunos servicios, por lo que es posible que debas esperar un poco. (hasta 36 horas) 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 quieres restablecer. Para restablecer un proyecto, sigue estos pasos:

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