com.google.cloud.resourcemanager
A client for Cloud Resource Manager - Centrally manage all your projects, IAM, and resource containers.
Here's a simple usage example for using google-cloud from App/Compute Engine. This example creates a project if it does not exist. For the complete source code see GetOrCreateProject.java.
ResourceManager resourceManager = ResourceManagerOptions.getDefaultInstance().getService();
String projectId = "my-globally-unique-project-id"; // Change to a unique project ID.
Project project = resourceManager.get(projectId);
if (project == null) {
project = resourceManager.create(ProjectInfo.builder(projectId).build());
}
System.out.println("Got project " + project.getProjectId() + " from the server.");
This second example shows how to update a project if it exists and list all projects the user has permission to view. For the complete source code see UpdateAndListProjects.java.
ResourceManager resourceManager = ResourceManagerOptions.getDefaultInstance().getService();
Project project = resourceManager.get("some-project-id"); // Use an existing project's ID
if (project != null) {
Project newProject = project.toBuilder()
.addLabel("launch-status", "in-development")
.build()
.replace();
System.out.println("Updated the labels of project " + newProject.getProjectId()
+ " to be " + newProject.getLabels());
}
Iterator<Project> projectIterator = resourceManager.list().iterateAll();
System.out.println("Projects I can view:");
while (projectIterator.hasNext()) {
System.out.println(projectIterator.next().getProjectId());
}
Remember that you must authenticate using the Google Cloud SDK. See more about providing credentials here. See Also: Google Cloud Resource Manager
com.google.cloud.resourcemanager.spi
com.google.cloud.resourcemanager.spi.v1beta1
com.google.cloud.resourcemanager.testing
A testing helper for Google Cloud Resource Manager.
A simple usage example: Before the test:
LocalResourceManagerHelper resourceManagerHelper = LocalResourceManagerHelper.create();
resourceManagerHelper.start();
ResourceManager resourceManager = resourceManagerHelper.getOptions().getService();
After the test:
resourceManagerHelper.stop();
com.google.cloud.resourcemanager.v3
The interfaces provided are listed below, along with usage samples.
FoldersClient
Service Description: Manages Cloud Platform folder resources. Folders can be used to organize the resources under an organization and to control the policies applied to groups of resources.
Sample for FoldersClient:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (FoldersClient foldersClient = FoldersClient.create()) {
FolderName name = FolderName.of("[FOLDER]");
Folder response = foldersClient.getFolder(name);
}
OrganizationsClient
Service Description: Allows users to manage their organization resources.
Sample for OrganizationsClient:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (OrganizationsClient organizationsClient = OrganizationsClient.create()) {
OrganizationName name = OrganizationName.of("[ORGANIZATION]");
Organization response = organizationsClient.getOrganization(name);
}
ProjectsClient
Service Description: Manages Google Cloud Projects.
Sample for ProjectsClient:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (ProjectsClient projectsClient = ProjectsClient.create()) {
ProjectName name = ProjectName.of("[PROJECT]");
Project response = projectsClient.getProject(name);
}
TagBindingsClient
Service Description: Allow users to create and manage TagBindings between TagValues and different cloud resources throughout the GCP resource hierarchy.
Sample for TagBindingsClient:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (TagBindingsClient tagBindingsClient = TagBindingsClient.create()) {
ResourceName parent = FolderName.of("[FOLDER]");
for (TagBinding element : tagBindingsClient.listTagBindings(parent).iterateAll()) {
// doThingsWith(element);
}
}
TagKeysClient
Service Description: Allow users to create and manage tag keys.
Sample for TagKeysClient:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (TagKeysClient tagKeysClient = TagKeysClient.create()) {
TagKeyName name = TagKeyName.of("[TAG_KEY]");
TagKey response = tagKeysClient.getTagKey(name);
}
TagValuesClient
Service Description: Allow users to create and manage tag values.
Sample for TagValuesClient:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (TagValuesClient tagValuesClient = TagValuesClient.create()) {
TagValueName name = TagValueName.of("[TAG_VALUE]");
TagValue response = tagValuesClient.getTagValue(name);
}