Google Cloud Resource Manager API client library
Project description
Google Cloud Resource Manager API provides methods that you can use to programmatically manage your projects in the Google Cloud Platform. With this API, you can do the following:
Get a list of all projects associated with an account
Create new projects
Update existing projects
Delete projects
Undelete, or recover, projects that you don’t want to delete
Quick Start
In order to use this library, you first need to go through the following steps:
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.
Supported Python Versions
Python >= 3.5
Deprecated Python Versions
Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
Mac/Linux
pip install virtualenv
virtualenv <your-env>
source <your-env>/bin/activate
<your-env>/bin/pip install google-cloud-resource-managerWindows
pip install virtualenv
virtualenv <your-env>
<your-env>\Scripts\activate
<your-env>\Scripts\pip.exe install google-cloud-resource-managerAuthentication
Unlike the other APIs, the Resource Manager API is focused on managing your various projects inside Google Cloud Platform. What this means (currently, as of August 2015) is that you can’t use a Service Account to work with some parts of this API (for example, creating projects).
The reason is actually pretty simple: if your API call is trying to do something like create a project, what project’s Service Account can you use? Currently none.
This means that for this API you should always use the credentials provided by the Google Cloud SDK, which you can get by running gcloud auth login.
Once you run that command, google-cloud-python will automatically pick up the credentials, and you can use the “automatic discovery” feature of the library.
Start by authenticating:
$ gcloud auth loginAnd then simply create a client:
from google.cloud import resource_manager
client = resource_manager.Client()Using the API
Here’s a quick example of the full life-cycle:
from google.cloud import resource_manager
client = resource_manager.Client()
# List all projects you have access to
for project in client.list_projects():
print(project)
# Create a new project
new_project = client.new_project(
'your-project-id-here', name='My new project')
new_project.create()
# Update an existing project
project = client.fetch_project('my-existing-project')
project.name = 'Modified name'
project.update()
# Delete a project
project = client.new_project('my-existing-project')
project.delete()
# Undelete a project
project = client.new_project('my-existing-project')
project.undelete()Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file google-cloud-resource-manager-0.29.0.tar.gz.
File metadata
- Download URL: google-cloud-resource-manager-0.29.0.tar.gz
- Upload date:
- Size: 16.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.6.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 09f3ed4c4b422fa34d4a46087f32a0cdb62a2b24dd02a28af3c8151b7fcf48f7 |
|
| MD5 | fd0fc35f0ed533c98963295178caba04 |
|
| BLAKE2b-256 | b3e0d7d1d7f472e3fb0d296cf863072fa67c489dc887bf8942d628f52d88b219 |
Provenance
File details
Details for the file google_cloud_resource_manager-0.29.0-py2.py3-none-any.whl.
File metadata
- Download URL: google_cloud_resource_manager-0.29.0-py2.py3-none-any.whl
- Upload date:
- Size: 15.4 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.6.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 898abc74afc8c4c8845a9ab03193aa7bbb17fc92ffdf7736eeee798889a675c8 |
|
| MD5 | deaffa12ed7dbd0c6fa0fb1033d9b13e |
|
| BLAKE2b-256 | 863a32ae22b4756994528acc17e2483af4063aa90f092f4eb2a440b23e270e72 |
