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 la organización.
Cómo obtener un recurso de organización
Un recurso de la organización está disponible para los clientes de Google Workspace y Cloud Identity:
- Google Workspace: Regístrate en Google Workspace.
- Cloud Identity: Regístrate en 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 eres nuevo en Google Cloud y aún no creaste un proyecto, se creará el recurso de la organización cuando accedas a la consola de Google Cloud y aceptes los Términos y Condiciones.
-
Si ya eres usuario de Google Cloud, se creará el recurso de la organización cuando crees un proyecto nuevo o una cuenta de facturación. Todos los proyectos que hayas creado anteriormente aparecerán en “Sin organización” y esto es normal. Aparecerá el recurso de la organización y se vinculará automáticamente el proyecto nuevo que creaste.
Deberás mover cualquier proyecto que hayas creado en “Sin organización” a tu recurso nuevo de organización. Para obtener instrucciones sobre cómo trasladar tus proyectos, consulta Migrar 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 cuentas de facturación creados en tu dominio de Google Workspace o Cloud Identity serán recursos secundarios de este recurso de organización.
- Para obtener información sobre cómo migrar los proyectos preexistentes, consulta Migra proyectos existentes a la organización.
Cada cuenta de Google Workspace o Cloud Identity se asocia con un solo recurso de organización. Un recurso de organización se asocia con un solo 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 un amplio control sobre tu organización y todos sus recursos subyacentes. Por este motivo, no recomendamos usar las cuentas de administrador avanzado de Google Workspace o Cloud Identity para la administración diaria 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 le deben asignar el rol de Identity and Access Management (IAM) de Administrador de la organización (roles/resourcemanager.organizationAdmin) a un usuario o grupo. Si quieres obtener los pasos para configurar tu recurso de organización, consulta Configura tu recurso de organización.
- Cuando se crea el recurso de la organización, a todos los usuarios de tu dominio se les otorgan automáticamente los roles de IAM de creador de proyectos (
roles/resourcemanager.projectCreator) y creador de cuentas de facturación (roles/billing.creator) a nivel del recurso 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 el recurso de la organización de forma activa. Luego, puede cambiar los permisos predeterminados y aplicar de forma forzosa las 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 visualizarlo, puedes crear proyectos y cuentas de facturación. Estos se crean de forma automática en el recurso de la organización, incluso si no puedes verlo.
Cómo obtener el ID de tu recurso de organización
El ID del recurso de la organización es un identificador único de un recurso de la organización y se crea automáticamente cuando se crea el recurso de la organización. Los IDs de los recursos de la organización tienen el formato de números decimales y no pueden tener ceros a la izquierda.
Puedes obtener el ID de recurso de tu organización mediante la consola de Google Cloud, gcloud CLI o la API de Cloud Resource Manager.
Console
Para obtener el ID de recurso de tu organización con la consola de Google Cloud, haz lo siguiente:
- Ve a la consola de Google Cloud:
Ve a la consola de Google Cloud.
- En el selector de proyectos en la parte superior de la página, selecciona el recurso de tu organización.
- 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 tu recurso de organización.
gcloud
Para encontrar el ID de tu recurso de organización, ejecuta el siguiente comando:
gcloud organizations list
Con este comando, se muestra una lista de todos los recursos de la organización a los que perteneces y sus IDs correspondientes.
API
Para encontrar el ID de recurso de tu organización con la API de Cloud Resource Manager, usa el método organizations.search(), incluida una consulta para tu 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 proporcionará de forma automática un recurso de la 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 esta 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 hayan configurado los permisos adecuados.
Los administradores avanzados de Google Workspace o Cloud Identity y el Administrador de la organización de Google Cloud son roles clave durante el proceso de configuración y para controlar el ciclo de vida del recurso de organización. En general, los dos roles se le asignan a distintos usuarios o grupos, aunque esto depende de la estructura y las necesidades de los recursos de la organización.
Las responsabilidades del administrador avanzado de Google Workspace o Cloud Identity, en el contexto de la configuración de recursos de la organización de Google Cloud, son las siguientes:
- Asignar el rol 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 la sección sobre cómo borrar un recurso de la organización
El administrador de la organización, una vez asignado, puede asignar roles de Identity and Access Management a otros usuarios. Las responsabilidades del rol de Administrador de la organización son las siguientes:
- Definir las 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, este rol 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 roles adicionales a su cuenta.
Tener dos roles distintos garantiza la separación de tareas 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 estos pasos para agregar un administrador de la organización:
Cómo agregar un administrador de la organización
Console
Para agregar un administrador de la organización, sigue estos pasos:
Accede a la consola de Google Cloud como un administrador avanzado de Google Workspace o Cloud Identity y ve a la página IAM y administración:
Selecciona el recurso de la organización que deseas editar:
Haz clic en la lista desplegable de proyectos en la parte superior de la página.
En el cuadro de diálogo Seleccionar de, haz clic en la lista desplegable de organizaciones y selecciona el recurso de la organización al que deseas agregar un administrador de la organización.
En la lista que aparece, haz clic en el recurso de la organización para abrir su página de Permisos de IAM.
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.
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:
Puede tomar el control total del recurso 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 la sección sobre cómo obtener un recurso de la organización, a todos los usuarios del dominio se les otorgan los roles de creador de proyectos y creador de cuentas de facturación a nivel del recurso de la organización de forma predeterminada. Esto garantiza que los usuarios de Google Cloud no sufran interrupciones 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 la carpeta o del proyecto). Ten en cuenta que, dado que las políticas de IAM se heredan de la jerarquía, tener el rol de creador de proyectos asignado en todo el dominio (domain:mycompany.com) a nivel del recurso de la organización implica que todos los usuarios en el dominio pueden crear proyectos en cualquier nivel de la jerarquía.
Crea proyectos en el recurso de tu organización
Console
Puedes crear un proyecto en el recurso de la organización con la consola de Google Cloud después de que el recurso de la organización esté habilitado en tu dominio.
Para crear un proyecto nuevo en el recurso de la organización, haz lo siguiente:
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.
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 visualizar y enumerar los proyectos a los que tienen acceso mediante los roles de IAM. El administrador de la organización puede ver 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, haz lo siguiente:
Ve a la consola de Google Cloud:
Haz clic en el menú desplegable Organización en la parte superior de la página.
Selecciona el recurso de tu organización.
Haz clic en el menú desplegable Proyecto en la parte superior de la página y, luego, haz clic 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 de 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 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:
- Agrega tu dominio a las funciones
Project CreatoryBilling Account Creator. - 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 tu organización y todos los recursos asociados a él. Por lo tanto, si deseas borrar el recurso de tu organización, puedes borrar 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