Crea y administra recursos de la organización

El recurso de organización es el nodo raíz en la jerarquía de recursos de Google Cloud y es el supernodo jerárquico de los proyectos. En esta página, se explica cómo adquirir y administrar un recurso de la organización.

Antes de comenzar

Lee una descripción general del recurso de organización.

Obtén un recurso de organización

Hay un recurso de organización disponible para los clientes de Google Workspace y Cloud Identity:

Una vez que hayas creado tu cuenta de Google Workspace o Cloud Identity y la asocies con un dominio, el recurso de tu organización se creará automáticamente. El recurso se aprovisionará en diferentes momentos según el estado de tu cuenta:

  • Si es la primera vez que usas Google Cloud y aún no creaste un proyecto, el recurso de la organización se creará cuando accedas a la consola de Google Cloud y aceptes los Términos y Condiciones.
  • Si ya eres usuario de Google Cloud, el recurso de la organización se creará cuando crees un proyecto o una cuenta de facturación nuevos. Cualquier proyecto que hayas creado antes aparecerá en “Sin organización”, y esto es normal. Aparecerá el recurso de la organización y se vinculará automáticamente el nuevo proyecto que creaste.

    Deberás mover los proyectos que creaste en “Sin organización” al nuevo recurso de organización. Si quieres obtener instrucciones para trasladar tus proyectos, consulta Migra proyectos a un recurso de la organización.

El recurso de organización que se cree se vinculará a tu cuenta de Google Workspace o Cloud Identity con el proyecto o la cuenta de facturación que creaste configurada como recurso secundario. Todos los proyectos y las cuentas de facturación creados en tu dominio de Google Workspace o Cloud Identity serán elementos secundarios de este recurso de la organización.

Cada cuenta de Google Workspace o Cloud Identity se asocia con exactamente un recurso de la organización. Un recurso de organización se asocia con exactamente un dominio, que se establece cuando se crea el recurso de organización.

Cuando se crea el recurso de la organización, le comunicamos su disponibilidad a los administradores avanzados de Google Workspace o Cloud Identity. Estas cuentas de administrador avanzado deben usarse con cuidado, ya que tienen mucho control sobre los recursos de tu organización y todos los recursos subyacentes. Por este motivo, recomendamos no usar las cuentas de administrador avanzado de Google Workspace o Cloud Identity para la administración diaria de los recursos de tu organización. Para obtener más información sobre cómo usar las cuentas de administrador avanzado de Google Workspace o Cloud Identity en Google Cloud, consulta las prácticas recomendadas de las cuentas de administrador avanzado.

Para adoptar de forma activa el recurso de la organización, los administradores avanzados de Google Workspace o Cloud Identity deben asignar la función de administrador de la organización (roles/resourcemanager.organizationAdmin) de Identity and Access Management (IAM) a un usuario o grupo. Si quieres conocer los pasos para configurar tu recurso de organización, consulta la sección Configura el recurso de tu organización.

  • Cuando se crea el recurso de organización, a todos los usuarios de tu dominio se les otorgan de forma automática las funciones de IAM de Creador de proyectos (roles/resourcemanager.projectCreator) y Creador de cuentas de facturación (roles/billing.creator) a nivel de recursos de la organización. Esto permite que los usuarios de tu dominio sigan creando proyectos sin interrupciones.
  • El administrador de la organización decidirá cuándo quiere comenzar a usar de forma activa el recurso de la organización. Luego, pueden cambiar los permisos predeterminados y aplicar políticas más restrictivas según sea necesario.
  • Si el recurso de la organización está disponible y no tienes los permisos de IAM para verlo, aún puedes crear proyectos y cuentas de facturación. Estos se crean automáticamente en el recurso de la organización, incluso si no puedes verlo.

Obtén el ID de recurso de tu organización

El ID de recurso de la organización es un identificador único para un recurso de la organización y se crea de forma automática cuando se crea el recurso de tu organización. Los ID de recursos de la organización tienen el formato de números decimales y no pueden tener ceros a la izquierda.

Puedes obtener el ID del recurso de tu organización con la consola de Google Cloud, gcloud CLI o la API de Cloud Resource Manager.

Console

Para obtener el ID del recurso de la organización con la consola de Google Cloud, haz lo siguiente:

  1. Ve a la consola de Google Cloud:

    Ve a la consola de Google Cloud.

  2. En el selector de proyectos en la parte superior de la página, selecciona el recurso de tu organización.
  3. En el lado derecho, haz clic en Más y, luego, en Configuración.

En la página Configuración, se muestra el ID de recurso de tu organización.

gcloud

Para encontrar el ID del recurso de tu organización, ejecuta el siguiente comando:

gcloud organizations list

Con este comando, se enumeran todos los recursos de la organización a los que perteneces y sus ID de recursos de organización correspondientes.

API

Para encontrar el ID del recurso de tu organización con la API de Cloud Resource Manager, usa el método organizations.search(), incluida una consulta para el dominio. Por ejemplo:

GET https://cloudresourcemanager.googleapis.com/v3/organizations:search{query=domain:altostrat.com}

La respuesta contiene los metadatos del recurso de la organización que pertenece a altostrat.com, que incluye el ID del recurso de la organización.

Configura el recurso de tu organización

Si eres cliente de Google Workspace o Cloud Identity, se te proporciona automáticamente un recurso de organización.

Los administradores avanzados de Google Workspace o Cloud Identity son los primeros usuarios que pueden acceder al recurso de la organización cuando se crea. Todos los demás usuarios o grupos podrán usar Google Cloud como antes. Podrán ver el recurso de la organización, pero solo podrán modificarlo una vez que se establezcan los permisos correctos.

Los administradores avanzados de Google Workspace o Cloud Identity y el Administrador de la organización de Google Cloud son funciones clave durante el proceso de configuración y para el control del ciclo de vida del recurso de la organización. En general, las dos funciones se asignan a diferentes usuarios o grupos, aunque esto depende de la estructura y las necesidades del recurso de la organización.

En el contexto de la configuración de los recursos de la organización de Google Cloud, las responsabilidades de los administradores avanzados de Google Workspace o Cloud Identity son las siguientes:

  • Asignar la función de Administrador de la organización a algunos usuarios
  • Ser un punto de contacto en caso de problemas de recuperación.
  • Controlar el ciclo de vida de la cuenta de Google Workspace o Cloud Identity y del recurso de la organización como se explica en Borra un recurso de la organización

El Administrador de la organización, una vez asignado, puede asignar funciones de Identity and Access Management a otros usuarios. Las responsabilidades de la función de Administrador de la organización son las siguientes:

  • Definir políticas de IAM y otorgar roles de IAM a otros usuarios
  • Ver la estructura de la jerarquía de recursos

De acuerdo con el principio de privilegio mínimo, esta función no incluye el permiso para realizar otras acciones, como crear carpetas o proyectos. Para obtener estos permisos, un administrador de la organización debe asignarle funciones adicionales a su cuenta.

Tener dos funciones distintas garantiza la separación de obligaciones entre los administradores avanzados de Google Workspace o Cloud Identity y el administrador de la organización de Google Cloud. Esto suele ser un requisito ya que, en general, a los dos productos de Google los administran distintos departamentos de la organización del cliente.

Si quieres comenzar a usar el recurso de la organización de forma activa, sigue los pasos que se indican a continuación para agregar un administrador de la organización:

Agrega un administrador de la organización

Console

Para agregar un administrador de la organización, haz lo siguiente:

  1. Accede a la consola de Google Cloud como administrador avanzado de Google Workspace o Cloud Identity y navega a la página IAM y administración:

    Abrir la página IAM y administración

  2. Selecciona el recurso de organización que deseas editar:

    1. Haz clic en la lista desplegable de proyectos en la parte superior de la página.

    2. En el cuadro de diálogo Seleccionar de, haz clic en la lista desplegable de la organización y selecciona el recurso de la organización al que deseas agregar un administrador de la organización.

    3. En la lista que aparece, haz clic en el recurso de la organización para abrir la página Permisos de IAM.

  3. Haz clic en Agregar y, luego, ingresa la dirección de correo electrónico de uno o más usuarios que desees establecer como Administradores de la organización.

  4. En la lista desplegable Seleccionar una función, selecciona Administrador de recursos > Administrador de la organización y, luego, haz clic en Guardar.

    El administrador de la organización puede hacer lo siguiente:

    • Toma el control total de los recursos de la organización. Se establece la separación de responsabilidades entre el administrador avanzado de Google Workspace o Cloud Identity y el administrador de Google Cloud.

    • Puedes delegar la responsabilidad sobre las funciones esenciales mediante la asignación de las funciones relevantes de IAM.

Como se explica en Adquiere un recurso de organización, cuando se crea, a todos los usuarios del dominio se les otorgan las funciones de Creador de proyectos y Creador de cuentas de facturación en el nivel de recurso de la organización de forma predeterminada. Esto garantiza que no se causen interrupciones a los usuarios de Google Cloud cuando se crea el recurso de la organización. A medida que el Administrador de la organización toma el control, es posible que quieras quitar estos permisos a nivel de la organización para comenzar a bloquear el acceso con mayor nivel de detalle (por ejemplo, a nivel de carpeta o proyecto). Ten en cuenta que, debido a que las políticas de IAM se heredan en la jerarquía, tener la función de Creador de proyectos asignada a todo el dominio (domain:mycompany.com) a nivel de recursos de la organización implica que cada usuario en el dominio puede crear proyectos en cualquier lugar de la jerarquía.

Crea proyectos en el recurso de tu organización

Console


Puedes crear un proyecto en el recurso de organización con la consola de Google Cloud después de que el recurso de organización esté habilitado para tu dominio.

Sigue estos pasos para crear un proyecto nuevo en el recurso de la organización:

Para crear un proyecto nuevo, haz lo siguiente:

  1. Ve a la página Administrar recursos en la consola de Google Cloud.

    Ir a Administrar recursos

    Los pasos restantes aparecerán automáticamente en la consola de Google Cloud.

  2. 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.
  3. Haz clic en Crear proyecto.
  4. 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.
  5. 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.
  6. Cuando hayas terminado de ingresar los detalles del proyecto nuevo, haz clic en Crear.

API


Puedes crear un proyecto nuevo en el recurso de la organización si creas un project y configuras su campo parent como el organizationId del recurso de la organización.

En el siguiente fragmento de código, se muestra cómo crear un proyecto en un recurso de organización:

...

project = crm.projects().create(
    body={
        'project_id': flags.projectId,
        'name': 'My New Project',
        'parent': {
            'type': 'organization',
            'id': flags.organizationId
         }
}).execute()

...

Visualiza proyectos en un recurso de organización

Los usuarios solo pueden ver y enumerar los proyectos a los que tienen acceso mediante los roles de IAM. El administrador de la organización puede visualizar y enumerar todos los proyectos del recurso de la organización.

Console


Para ver todos los proyectos en un recurso de organización con la consola de Google Cloud, sigue estos pasos:

  1. Ve a la consola de Google Cloud:

    Ir a la consola de Google Cloud

  2. Haz clic en el menú desplegable Organización en la parte superior de la página.

  3. Selecciona tu recurso de organización.

  4. Haz clic en el menú desplegable Proyecto en la parte superior de la página y, luego, en Ver más proyectos. Todos los proyectos del recurso de la organización se enumeran en la página.

Con la opción Sin organización del menú desplegable Organización, se enumeran los siguientes proyectos:

  • Proyectos que aún no pertenecen al recurso de la organización
  • Proyectos a los que el usuario tiene acceso, pero que están en un recurso de organización al que el usuario no tiene acceso

gcloud


Para ver todos los proyectos en un recurso de organización, ejecuta el siguiente comando:

gcloud projects list --filter 'parent.id=[ORGANIZATION_ID] AND \
    parent.type=organization'

API


Usa el método projects.list() para enumerar todos los proyectos de un recurso superior, como se muestra en el siguiente fragmento de código:

...

filter = 'parent.type:organization parent.id:%s' % flags.organizationId
projects = crm.projects().list(filter=filter).execute()

...

Borra un recurso de la organización

El recurso de la organización está vinculado a tu cuenta de Google Workspace o Cloud Identity.

Si prefieres no usar el recurso de la organización, te recomendamos restablecer la política de IAM del recurso de la organización al estado original mediante los siguientes pasos:

  1. Agrega tu dominio a las funciones Project Creator y Billing Account Creator.
  2. Quita todas las demás entradas de la política de IAM del recurso de la organización.

Esto permitirá que tus usuarios sigan creando proyectos y cuentas de facturación y, a la vez, les permitirá a los administradores avanzados de Google Workspace o Cloud Identity recuperar la administración central más tarde.

Si borras tu cuenta de Google Workspace, se borrará el recurso de la organización y todos los recursos asociados a ella. Por lo tanto, si deseas borrar tu recurso de organización, puedes hacerlo borrando tu cuenta de Google Workspace. Para los usuarios de Cloud Identity, cancela todos los demás servicios de Google y, luego, borra tu Cuenta de Google. Es posible que esta acción sea muy perjudicial y que sea imposible de revertir por completo, por lo que se recomienda realizar esta acción solo si estás seguro de que no hay recursos activos.

Pruébalo tú mismo

Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

Comenzar gratis