Asignar roles mediante bibliotecas de cliente
Consulta cómo empezar a usar los métodos de gestión de identidades y accesos de la API Resource Manager en tu lenguaje de programación favorito.
Para seguir las instrucciones paso a paso de esta tarea directamente en la Google Cloud consola, haga clic en Ayúdame:
Antes de empezar
Crea un Google Cloud proyecto
Para esta guía de inicio rápido, necesitas un proyecto Google Cloud nuevo.
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
Install the Google Cloud CLI.
-
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
-
Para inicializar gcloud CLI, ejecuta el siguiente comando:
gcloud init
-
Create or select a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator
(
roles/resourcemanager.projectCreator
), which contains theresourcemanager.projects.create
permission. Learn how to grant roles.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
Enable the Resource Manager API:
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin
), which contains theserviceusage.services.enable
permission. Learn how to grant roles.gcloud services enable cloudresourcemanager.googleapis.com
-
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/resourcemanager.projectIamAdmin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Replace the following:
PROJECT_ID
: your project ID.USER_IDENTIFIER
: the identifier for your user account—for example,myemail@example.com
.ROLE
: the IAM role that you grant to your user account.
-
Install the Google Cloud CLI.
-
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
-
Para inicializar gcloud CLI, ejecuta el siguiente comando:
gcloud init
-
Create or select a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator
(
roles/resourcemanager.projectCreator
), which contains theresourcemanager.projects.create
permission. Learn how to grant roles.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
Enable the Resource Manager API:
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin
), which contains theserviceusage.services.enable
permission. Learn how to grant roles.gcloud services enable cloudresourcemanager.googleapis.com
-
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/resourcemanager.projectIamAdmin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Replace the following:
PROJECT_ID
: your project ID.USER_IDENTIFIER
: the identifier for your user account—for example,myemail@example.com
.ROLE
: the IAM role that you grant to your user account.
- Inicializa el servicio Resource Manager, que gestiona los Google Cloud proyectos.
- Lee la política de permiso de tu proyecto.
- Modifica la política de permisos concediendo el rol Escritor de registros (
roles/logging.logWriter
) a tu cuenta de Google. - Escribe la política de permiso actualizada.
- Imprime todas las entidades que tienen el rol Escritor de registros (
roles/logging.logWriter
) a nivel de proyecto. - Revoca el rol Escritor de registros.
your-project
: el ID de tu proyecto.your-member
: la dirección de correo de tu cuenta de usuario. Por ejemplo,user:my-user@example.com
.-
Optional: Revoke the authentication credentials that you created, and delete the local credential file.
gcloud auth application-default revoke
-
Optional: Revoke credentials from the gcloud CLI.
gcloud auth revoke
- Consulta cómo funciona la gestión de identidades y accesos.
- Consulta más información sobre cómo conceder, cambiar y revocar el acceso.
- Soluciona los problemas de acceso con el solucionador de problemas de políticas.
Instalar la biblioteca cliente
C#
Para obtener más información sobre cómo configurar tu entorno de desarrollo de C#, consulta la guía de configuración del entorno de desarrollo de C#.
install-package Google.Apis.Iam.v1 install-package Google.Apis.CloudResourceManager.v1
Go
go get golang.org/x/oauth2/google go get google.golang.org/api/cloudresourcemanager/v1
Java
Para obtener más información sobre cómo configurar tu entorno de desarrollo de Java, consulta la guía de configuración del entorno de desarrollo de Java.
Si usas Maven, añade esto a tu archivopom.xml
.
Python
Para obtener más información sobre cómo configurar tu entorno de desarrollo de Python, consulta la guía de configuración del entorno de desarrollo de Python.
pip install --upgrade google-api-python-client google-auth google-auth-httplib2
Leer, modificar y escribir una política de permiso
El fragmento de código de esta guía de inicio rápido hace lo siguiente:
Sustituye los siguientes valores antes de ejecutar el fragmento de código:
C#
Para saber cómo instalar y usar la biblioteca de cliente de Resource Manager, consulta Bibliotecas de cliente de Resource Manager. Para obtener más información, consulta la documentación de referencia de la API C# Resource Manager.
Para autenticarte en Resource Manager, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Go
Para saber cómo instalar y usar la biblioteca de cliente de Resource Manager, consulta Bibliotecas de cliente de Resource Manager. Para obtener más información, consulta la documentación de referencia de la API Go Resource Manager.
Para autenticarte en Resource Manager, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Java
Para saber cómo instalar y usar la biblioteca de cliente de Resource Manager, consulta Bibliotecas de cliente de Resource Manager. Para obtener más información, consulta la documentación de referencia de la API Java Resource Manager.
Para autenticarte en Resource Manager, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Python
Para saber cómo instalar y usar la biblioteca de cliente de Resource Manager, consulta Bibliotecas de cliente de Resource Manager. Para obtener más información, consulta la documentación de referencia de la API Python Resource Manager.
Para autenticarte en Resource Manager, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
¡Enhorabuena! Has usado los métodos de IAM de la API Resource Manager para modificar el acceso a un proyecto.
¿Cómo ha ido?
Limpieza
Siguientes pasos