diff --git a/.github/.OwlBot.lock.yaml b/.github/.OwlBot.lock.yaml index a86dc465..419ccb9a 100644 --- a/.github/.OwlBot.lock.yaml +++ b/.github/.OwlBot.lock.yaml @@ -1,3 +1,3 @@ docker: image: gcr.io/repo-automation-bots/owlbot-java:latest - digest: sha256:a9b83a276c82987d284b733713fe86a3c8a2cc457933767eeb2688b882e54c6a + digest: sha256:2904b9ad921ecc1343d1cf815bfaafbcc1115c1f39593aef9f8e333ffda552f7 diff --git a/.github/readme/synth.metadata/synth.metadata b/.github/readme/synth.metadata/synth.metadata index 59282dac..9c088058 100644 --- a/.github/readme/synth.metadata/synth.metadata +++ b/.github/readme/synth.metadata/synth.metadata @@ -4,14 +4,14 @@ "git": { "name": ".", "remote": "https://github.com/googleapis/java-resourcemanager.git", - "sha": "eaff33d0dce0f7d999bc8523b37767de92a66961" + "sha": "c7d7e6244ad5fb6244bc6e88d2256e63fac42db2" } }, { "git": { "name": "synthtool", "remote": "https://github.com/googleapis/synthtool.git", - "sha": "9763f20e4b7bb1091082462b2f7970e965d0d414" + "sha": "3d32990b6f4b57be77455e3ca89e6e21cd0c06b3" } } ] diff --git a/.github/sync-repo-settings.yaml b/.github/sync-repo-settings.yaml index e100454f..807ec483 100644 --- a/.github/sync-repo-settings.yaml +++ b/.github/sync-repo-settings.yaml @@ -39,6 +39,7 @@ branchProtectionRules: - "units (11)" - "Kokoro - Test: Integration" - "cla/google" + - "OwlBot Post Processor" # List of explicit permissions to add (additive only) permissionRules: - team: yoshi-admins diff --git a/.readme-partials.yaml b/.readme-partials.yaml index e9dff8a0..edfedc5a 100644 --- a/.readme-partials.yaml +++ b/.readme-partials.yaml @@ -84,7 +84,7 @@ custom_content: | Then add the following code to print a list of projects you can view: ```java - Iterator projectIterator = resourceManager.list().iterateAll(); + Iterator projectIterator = resourceManager.list().iterateAll().iterator(); System.out.println("Projects I can view:"); while (projectIterator.hasNext()) { System.out.println(projectIterator.next().getProjectId()); @@ -138,4 +138,4 @@ custom_content: | The third program modifies the IAM policy associated with a project using the read-modify-write pattern. Complete source code can be found at - [ModifyPolicy.java](https://github.com/googleapis/google-cloud-java/blob/master/google-cloud-examples/src/main/java/com/google/cloud/examples/resourcemanager/snippets/ModifyPolicy.java) \ No newline at end of file + [ModifyPolicy.java](https://github.com/googleapis/google-cloud-java/blob/master/google-cloud-examples/src/main/java/com/google/cloud/examples/resourcemanager/snippets/ModifyPolicy.java) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9b55ac6d..68e6e951 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,12 @@ # Changelog +### [0.119.9](https://www.github.com/googleapis/java-resourcemanager/compare/v0.119.8...v0.119.9) (2021-07-28) + + +### Dependencies + +* update dependency com.google.errorprone:error_prone_annotations to v2.8.0 ([#551](https://www.github.com/googleapis/java-resourcemanager/issues/551)) ([19b1b9f](https://www.github.com/googleapis/java-resourcemanager/commit/19b1b9f2dfb708a1f42c69f02326d6fa12485e57)) + ### [0.119.8](https://www.github.com/googleapis/java-resourcemanager/compare/v0.119.7...v0.119.8) (2021-07-05) diff --git a/README.md b/README.md index 3db1d442..3d9d7848 100644 --- a/README.md +++ b/README.md @@ -11,16 +11,18 @@ Java idiomatic client for [Resource Manager API][product-docs]. > Note: This client is a work-in-progress, and may occasionally > make backwards-incompatible changes. + ## Quickstart If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file + ```xml com.google.cloud libraries-bom - 20.6.0 + 20.9.0 pom import @@ -37,35 +39,43 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file If you are using Maven without BOM, add this to your dependencies: + ```xml com.google.cloud google-cloud-resourcemanager - 0.119.6-alpha + 0.119.8-alpha ``` If you are using Gradle 5.x or later, add this to your dependencies + ```Groovy -implementation platform('com.google.cloud:libraries-bom:20.7.0') +implementation platform('com.google.cloud:libraries-bom:20.9.0') compile 'com.google.cloud:google-cloud-resourcemanager' ``` If you are using Gradle without BOM, add this to your dependencies + ```Groovy -compile 'com.google.cloud:google-cloud-resourcemanager:0.119.7-alpha' +compile 'com.google.cloud:google-cloud-resourcemanager:0.119.8-alpha' ``` If you are using SBT, add this to your dependencies + ```Scala -libraryDependencies += "com.google.cloud" % "google-cloud-resourcemanager" % "0.119.7-alpha" +libraryDependencies += "com.google.cloud" % "google-cloud-resourcemanager" % "0.119.8-alpha" ``` ## Authentication See the [Authentication][authentication] section in the base directory's README. +## Authorization + +The client application making API calls must be granted [authorization scopes][auth-scopes] required for the desired Resource Manager API APIs, and the authenticated principal must have the [IAM role(s)][predefined-iam-roles] required to access GCP resources using the Resource Manager API API calls. + ## Getting Started ### Prerequisites @@ -175,7 +185,7 @@ import java.util.Iterator; Then add the following code to print a list of projects you can view: ```java -Iterator projectIterator = resourceManager.list().iterateAll(); +Iterator projectIterator = resourceManager.list().iterateAll().iterator(); System.out.println("Projects I can view:"); while (projectIterator.hasNext()) { System.out.println(projectIterator.next().getProjectId()); @@ -234,6 +244,7 @@ pattern. Complete source code can be found at + ## Troubleshooting To get help, follow the instructions in the [shared Troubleshooting document][troubleshooting]. @@ -242,10 +253,50 @@ To get help, follow the instructions in the [shared Troubleshooting document][tr Resource Manager API uses HTTP/JSON for the transport layer. -## Java Versions +## Supported Java Versions Java 7 or above is required for using this client. +Google's Java client libraries, +[Google Cloud Client Libraries][cloudlibs] +and +[Google Cloud API Libraries][apilibs], +follow the +[Oracle Java SE support roadmap][oracle] +(see the Oracle Java SE Product Releases section). + +### For new development + +In general, new feature development occurs with support for the lowest Java +LTS version covered by Oracle's Premier Support (which typically lasts 5 years +from initial General Availability). If the minimum required JVM for a given +library is changed, it is accompanied by a [semver][semver] major release. + +Java 11 and (in September 2021) Java 17 are the best choices for new +development. + +### Keeping production systems current + +Google tests its client libraries with all current LTS versions covered by +Oracle's Extended Support (which typically lasts 8 years from initial +General Availability). + +#### Legacy support + +Google's client libraries support legacy versions of Java runtimes with long +term stable libraries that don't receive feature updates on a best efforts basis +as it may not be possible to backport all patches. + +Google provides updates on a best efforts basis to apps that continue to use +Java 7, though apps might need to upgrade to current versions of the library +that supports their JVM. + +#### Where to find specific information + +The latest versions and the supported Java versions are identified on +the individual GitHub repository `github.com/GoogleAPIs/java-SERVICENAME` +and on [google-cloud-java][g-c-j]. + ## Versioning @@ -255,6 +306,7 @@ This library follows [Semantic Versioning](http://semver.org/). It is currently in major version zero (``0.y.z``), which means that anything may change at any time and the public API should not be considered stable. + ## Contributing @@ -266,6 +318,7 @@ Please note that this project is released with a Contributor Code of Conduct. By this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more information. + ## License Apache 2.0 - See [LICENSE][license] for more information. @@ -298,6 +351,9 @@ Java is a registered trademark of Oracle and/or its affiliates. [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-resourcemanager.svg [maven-version-link]: https://search.maven.org/search?q=g:com.google.cloud%20AND%20a:google-cloud-resourcemanager&core=gav [authentication]: https://github.com/googleapis/google-cloud-java#authentication +[auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes +[predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles +[iam-policy]: https://cloud.google.com/iam/docs/overview#cloud-iam-policy [developer-console]: https://console.developers.google.com/ [create-project]: https://cloud.google.com/resource-manager/docs/creating-managing-projects [cloud-sdk]: https://cloud.google.com/sdk/ @@ -309,3 +365,9 @@ Java is a registered trademark of Oracle and/or its affiliates. [enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=cloudresourcemanager.googleapis.com [libraries-bom]: https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM [shell_img]: https://gstatic.com/cloudssh/images/open-btn.png + +[semver]: https://semver.org/ +[cloudlibs]: https://cloud.google.com/apis/docs/client-libraries-explained +[apilibs]: https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries +[oracle]: https://www.oracle.com/java/technologies/java-se-support-roadmap.html +[g-c-j]: http://github.com/googleapis/google-cloud-java diff --git a/google-cloud-resourcemanager-bom/pom.xml b/google-cloud-resourcemanager-bom/pom.xml index 9506305e..62c72201 100644 --- a/google-cloud-resourcemanager-bom/pom.xml +++ b/google-cloud-resourcemanager-bom/pom.xml @@ -3,12 +3,12 @@ 4.0.0 com.google.cloud google-cloud-resourcemanager-bom - 0.119.8-alpha + 0.119.9-alpha pom com.google.cloud google-cloud-shared-config - 0.12.0 + 0.13.1 Google Resource Manager API BOM @@ -56,17 +56,17 @@ com.google.cloud google-cloud-resourcemanager - 0.119.8-alpha + 0.119.9-alpha com.google.api.grpc grpc-google-cloud-resourcemanager-v3 - 0.119.8-alpha + 0.119.9-alpha com.google.api.grpc proto-google-cloud-resourcemanager-v3 - 0.119.8-alpha + 0.119.9-alpha diff --git a/google-cloud-resourcemanager/pom.xml b/google-cloud-resourcemanager/pom.xml index be6129c3..6a977377 100644 --- a/google-cloud-resourcemanager/pom.xml +++ b/google-cloud-resourcemanager/pom.xml @@ -4,7 +4,7 @@ com.google.cloud google-cloud-resourcemanager jar - 0.119.8-alpha + 0.119.9-alpha Google Cloud Resource Manager https://github.com/googleapis/java-resourcemanager @@ -14,7 +14,7 @@ com.google.cloud google-cloud-resourcemanager-parent - 0.119.8-alpha + 0.119.9-alpha @@ -41,16 +41,7 @@ https://github.com/googleapis/java-resourcemanager/issues GitHub Issues - - - sonatype-nexus-snapshots - https://oss.sonatype.org/content/repositories/snapshots - - - sonatype-nexus-staging - https://oss.sonatype.org/service/local/staging/deploy/maven2/ - - + Apache-2.0 @@ -77,7 +68,7 @@ com.google.errorprone error_prone_annotations - 2.7.1 + 2.8.0 diff --git a/grpc-google-cloud-resourcemanager-v3/pom.xml b/grpc-google-cloud-resourcemanager-v3/pom.xml index 6faaecae..fd006abb 100644 --- a/grpc-google-cloud-resourcemanager-v3/pom.xml +++ b/grpc-google-cloud-resourcemanager-v3/pom.xml @@ -4,13 +4,13 @@ 4.0.0 com.google.api.grpc grpc-google-cloud-resourcemanager-v3 - 0.119.8-alpha + 0.119.9-alpha grpc-google-cloud-resourcemanager-v3 GRPC library for google-cloud-resourcemanager com.google.cloud google-cloud-resourcemanager-parent - 0.119.8-alpha + 0.119.9-alpha diff --git a/java.header b/java.header index 3a9b503a..d0970ba7 100644 --- a/java.header +++ b/java.header @@ -1,5 +1,5 @@ ^/\*$ -^ \* Copyright \d\d\d\d,? Google (Inc\.|LLC)( All [rR]ights [rR]eserved\.)?$ +^ \* Copyright \d\d\d\d,? Google (Inc\.|LLC)$ ^ \*$ ^ \* Licensed under the Apache License, Version 2\.0 \(the "License"\);$ ^ \* you may not use this file except in compliance with the License\.$ diff --git a/pom.xml b/pom.xml index 1ec2a86c..ea8ecc21 100644 --- a/pom.xml +++ b/pom.xml @@ -4,7 +4,7 @@ com.google.cloud google-cloud-resourcemanager-parent pom - 0.119.8-alpha + 0.119.9-alpha Google Resource Manager API Parent https://github.com/googleapis/java-resourcemanager @@ -14,7 +14,7 @@ com.google.cloud google-cloud-shared-config - 0.12.0 + 0.13.1 @@ -60,18 +60,18 @@ com.google.cloud google-cloud-resourcemanager - 0.119.8-alpha + 0.119.9-alpha com.google.api.grpc proto-google-cloud-resourcemanager-v3 - 0.119.8-alpha + 0.119.9-alpha com.google.api.grpc grpc-google-cloud-resourcemanager-v3 - 0.119.8-alpha + 0.119.9-alpha com.google.cloud diff --git a/proto-google-cloud-resourcemanager-v3/pom.xml b/proto-google-cloud-resourcemanager-v3/pom.xml index 46098d69..9fe2aa83 100644 --- a/proto-google-cloud-resourcemanager-v3/pom.xml +++ b/proto-google-cloud-resourcemanager-v3/pom.xml @@ -4,13 +4,13 @@ 4.0.0 com.google.api.grpc proto-google-cloud-resourcemanager-v3 - 0.119.8-alpha + 0.119.9-alpha proto-google-cloud-resourcemanager-v3 Proto library for google-cloud-resourcemanager com.google.cloud google-cloud-resourcemanager-parent - 0.119.8-alpha + 0.119.9-alpha diff --git a/renovate.json b/renovate.json index d70e6219..dcbe2ad2 100644 --- a/renovate.json +++ b/renovate.json @@ -69,5 +69,8 @@ } ], "semanticCommits": true, - "masterIssue": true + "dependencyDashboard": true, + "dependencyDashboardLabels": [ + "type: process" + ] } diff --git a/samples/install-without-bom/pom.xml b/samples/install-without-bom/pom.xml index f1893952..0175644b 100644 --- a/samples/install-without-bom/pom.xml +++ b/samples/install-without-bom/pom.xml @@ -29,7 +29,7 @@ com.google.cloud google-cloud-resourcemanager - 0.119.7-alpha + 0.119.8-alpha diff --git a/samples/snapshot/pom.xml b/samples/snapshot/pom.xml index 50720ae6..5c5b5a66 100644 --- a/samples/snapshot/pom.xml +++ b/samples/snapshot/pom.xml @@ -28,7 +28,7 @@ com.google.cloud google-cloud-resourcemanager - 0.119.7-alpha + 0.119.8-alpha diff --git a/samples/snippets/pom.xml b/samples/snippets/pom.xml index 0bf4f4a9..fd5fc601 100644 --- a/samples/snippets/pom.xml +++ b/samples/snippets/pom.xml @@ -30,7 +30,7 @@ com.google.cloud libraries-bom - 20.7.0 + 20.9.0 pom import diff --git a/versions.txt b/versions.txt index 0898f374..f40f5bf9 100644 --- a/versions.txt +++ b/versions.txt @@ -1,6 +1,6 @@ # Format: # module:released-version:current-version -google-cloud-resourcemanager:0.119.8-alpha:0.119.8-alpha -grpc-google-cloud-resourcemanager-v3:0.119.8-alpha:0.119.8-alpha -proto-google-cloud-resourcemanager-v3:0.119.8-alpha:0.119.8-alpha +google-cloud-resourcemanager:0.119.9-alpha:0.119.9-alpha +grpc-google-cloud-resourcemanager-v3:0.119.9-alpha:0.119.9-alpha +proto-google-cloud-resourcemanager-v3:0.119.9-alpha:0.119.9-alpha