As of January 1, 2020 this library no longer supports Python 2 on the latest released version. Library versions released prior to that date will continue to be available. For more information please visit Python 2 support on Google Cloud.

Python Client for IAM Policy Troubleshooter

IAM Policy Troubleshooter makes it easier to understand why a user has access to a resource or doesn’t have permission to call an API. Given an email, resource, and permission, Policy Troubleshooter examines all Identity and Access Management (IAM) policies that apply to the resource. It then reveals whether the member’s roles include the permission on that resource and, if so, which policies bind the member to those roles.

• Client Library Documentation

• Product Documentation

Quick Start

In order to use this library, you first need to go through the following steps:

1. Select or create a Cloud Platform project.

2. Enable billing for your project.

3. Enable the Resource Manager API Service.

4. Setup Authentication.

Installation

Install this library in a virtualenv using pip. virtualenv is a tool to create isolated Python environments. The basic problem it addresses is one of dependencies and versions, and indirectly permissions.

With virtualenv, it’s possible to install this library without needing system install permissions, and without clashing with the installed system dependencies.

Mac/Linux

pip install virtualenv
virtualenv <your-env>
source <your-env>/bin/activate
<your-env>/bin/pip install google-cloud-policy-troubleshooter

Windows

pip install virtualenv
virtualenv <your-env>
<your-env>\Scripts\activate
<your-env>\Scripts\pip.exe install google-cloud-policy-troubleshooter

Next Steps

• Read the Client Library Documentation for IAM Policy Troubleshooter to see other available methods on the client.

• Read the IAM Policy Troubleshooter Product documentation to learn more about the product and see How-to Guides.

• View this README to see the full list of Cloud APIs that we cover.

Note

Because this client uses grpc library, it is safe to share instances across threads. In multiprocessing scenarios, the best practice is to create client instances after the invocation of os.fork() by multiprocessing.pool.Pool or multiprocessing.Process.

API Reference

• Services for Google Cloud Policytroubleshooter v1 API
  • IamChecker
• Types for Google Cloud Policytroubleshooter v1 API

Changelog

For a list of all google-cloud-policy-troubleshooter releases:

• Changelog
  • 1.12.1 (2024-11-11)
  • 1.12.0 (2024-10-24)
  • 1.11.5 (2024-07-30)
  • 1.11.4 (2024-07-08)
  • 1.11.3 (2024-03-05)
  • 1.11.2 (2024-02-22)
  • 1.11.1 (2024-02-06)
  • 1.11.0 (2024-02-01)
  • 1.10.0 (2023-12-07)
  • 1.9.1 (2023-09-19)
  • 1.9.0 (2023-07-20)
  • 1.8.2 (2023-07-05)
  • 1.8.1 (2023-03-23)
  • 1.8.0 (2023-02-09)
  • 1.7.1 (2023-01-23)
  • 1.7.0 (2023-01-10)
  • 1.6.0 (2022-12-13)
  • 1.5.4 (2022-10-07)
  • 1.5.3 (2022-09-29)
  • 1.5.2 (2022-08-11)
  • 1.5.1 (2022-07-14)
  • 1.5.0 (2022-07-07)
  • 1.4.2 (2022-06-03)
  • 1.4.1 (2022-03-05)
  • 1.4.0 (2022-02-26)
  • 1.3.1 (2021-11-01)
  • 1.3.0 (2021-10-18)
  • 1.2.0 (2021-10-08)
  • 1.1.3 (2021-09-24)
  • 1.1.2 (2021-07-29)
  • 1.1.1 (2021-07-21)
  • 1.1.0 (2021-07-14)
  • 1.0.0 (2021-06-02)
  • 0.2.0 (2021-05-28)
  • 0.1.0 (2021-03-24)