Skip to content

Commit 5e93c83

Browse files
cloud-java-botcloud-java-bot
authored
feat: [parametermanager] new module for parametermanager (#11412)
* feat: [parametermanager] new module for parametermanager * chore: generate libraries at Tue Jan 28 21:33:40 UTC 2025 * chore: generate libraries at Tue Jan 28 21:37:17 UTC 2025
1 parent ec63a90 commit 5e93c83

File tree

127 files changed

+39700
-18
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

127 files changed

+39700
-18
lines changed

‎gapic-libraries-bom/pom.xml

+7
Original file line numberDiff line numberDiff line change
@@ -871,6 +871,13 @@
871871
<type>pom</type>
872872
<scope>import</scope>
873873
</dependency>
874+
<dependency>
875+
<groupId>com.google.cloud</groupId>
876+
<artifactId>google-cloud-parametermanager-bom</artifactId>
877+
<version>0.0.1-SNAPSHOT</version><!-- {x-version-update:google-cloud-parametermanager:current} -->
878+
<type>pom</type>
879+
<scope>import</scope>
880+
</dependency>
874881
<dependency>
875882
<groupId>com.google.cloud</groupId>
876883
<artifactId>google-cloud-phishingprotection-bom</artifactId>

‎generation_config.yaml

+36-18
Original file line numberDiff line numberDiff line change
@@ -1435,24 +1435,6 @@ libraries:
14351435
- proto_path: google/cloud/memcache/v1
14361436
- proto_path: google/cloud/memcache/v1beta2
14371437

1438-
- api_shortname: memorystore
1439-
name_pretty: Memorystore API
1440-
product_documentation: https://cloud.google.com/memorystore/docs/valkey
1441-
api_description: Memorystore for Valkey is a fully managed Valkey Cluster service
1442-
for Google Cloud.
1443-
client_documentation:
1444-
https://cloud.google.com/java/docs/reference/google-cloud-memorystore/latest/overview
1445-
release_level: stable
1446-
api_id: memorystore.googleapis.com
1447-
library_type: GAPIC_AUTO
1448-
group_id: com.google.cloud
1449-
cloud_api: true
1450-
library_name: valkey
1451-
GAPICs:
1452-
- proto_path: google/cloud/memorystore/v1
1453-
- proto_path: google/cloud/memorystore/v1beta
1454-
requires_billing: true
1455-
rest_documentation: https://cloud.google.com/memorystore/docs/valkey/reference/rest
14561438
- api_shortname: migrationcenter
14571439
name_pretty: Migration Center API
14581440
product_documentation: https://cloud.google.com/migration-center/docs/migration-center-overview
@@ -1672,6 +1654,24 @@ libraries:
16721654
- proto_path: google/cloud/parallelstore/v1beta
16731655
- proto_path: google/cloud/parallelstore/v1
16741656
requires_billing: true
1657+
- api_shortname: parametermanager
1658+
name_pretty: Parameter Manager API
1659+
product_documentation: https://cloud.google.com/secret-manager/parameter-manager/docs/overview
1660+
api_description: (Public Preview) Parameter Manager is a single source of truth
1661+
to store, access and manage the lifecycle of your workload parameters. Parameter Manager
1662+
aims to make management of sensitive application parameters effortless for
1663+
customers without diminishing focus on security.
1664+
client_documentation:
1665+
https://cloud.google.com/java/docs/reference/google-cloud-parametermanager/latest/overview
1666+
release_level: preview
1667+
distribution_name: com.google.cloud:google-cloud-parametermanager
1668+
api_id: parametermanager.googleapis.com
1669+
library_type: GAPIC_AUTO
1670+
group_id: com.google.cloud
1671+
cloud_api: true
1672+
GAPICs:
1673+
- proto_path: google/cloud/parametermanager/v1
1674+
requires_billing: true
16751675
- api_shortname: phishingprotection
16761676
name_pretty: Phishing Protection
16771677
product_documentation: https://cloud.google.com/phishing-protection/docs/
@@ -2344,6 +2344,24 @@ libraries:
23442344
- proto_path: google/cloud/translate/v3
23452345
- proto_path: google/cloud/translate/v3beta1
23462346

2347+
- api_shortname: memorystore
2348+
name_pretty: Memorystore API
2349+
product_documentation: https://cloud.google.com/memorystore/docs/valkey
2350+
api_description: Memorystore for Valkey is a fully managed Valkey Cluster service
2351+
for Google Cloud.
2352+
client_documentation:
2353+
https://cloud.google.com/java/docs/reference/google-cloud-memorystore/latest/overview
2354+
release_level: stable
2355+
api_id: memorystore.googleapis.com
2356+
library_type: GAPIC_AUTO
2357+
group_id: com.google.cloud
2358+
cloud_api: true
2359+
library_name: valkey
2360+
GAPICs:
2361+
- proto_path: google/cloud/memorystore/v1
2362+
- proto_path: google/cloud/memorystore/v1beta
2363+
requires_billing: true
2364+
rest_documentation: https://cloud.google.com/memorystore/docs/valkey/reference/rest
23472365
- api_shortname: videointelligence
23482366
name_pretty: Cloud Video Intelligence
23492367
product_documentation: https://cloud.google.com/video-intelligence/docs/

‎java-parametermanager/.OwlBot-hermetic.yaml

+35
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# Copyright 2024 Google LLC
2+
#
3+
# Licensed under the Apache License, Version 2.0 (the "License");
4+
# you may not use this file except in compliance with the License.
5+
# You may obtain a copy of the License at
6+
#
7+
# http://www.apache.org/licenses/LICENSE-2.0
8+
#
9+
# Unless required by applicable law or agreed to in writing, software
10+
# distributed under the License is distributed on an "AS IS" BASIS,
11+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
# See the License for the specific language governing permissions and
13+
# limitations under the License.
14+
15+
16+
deep-remove-regex:
17+
- "/java-parametermanager/grpc-google-.*/src"
18+
- "/java-parametermanager/proto-google-.*/src"
19+
- "/java-parametermanager/google-.*/src"
20+
- "/java-parametermanager/samples/snippets/generated"
21+
22+
deep-preserve-regex:
23+
- "/java-parametermanager/google-.*/src/test/java/com/google/cloud/.*/v.*/it/IT.*Test.java"
24+
25+
deep-copy-regex:
26+
- source: "/google/cloud/parametermanager/(v.*)/.*-java/proto-google-.*/src"
27+
dest: "/owl-bot-staging/java-parametermanager/$1/proto-google-cloud-parametermanager-$1/src"
28+
- source: "/google/cloud/parametermanager/(v.*)/.*-java/grpc-google-.*/src"
29+
dest: "/owl-bot-staging/java-parametermanager/$1/grpc-google-cloud-parametermanager-$1/src"
30+
- source: "/google/cloud/parametermanager/(v.*)/.*-java/gapic-google-.*/src"
31+
dest: "/owl-bot-staging/java-parametermanager/$1/google-cloud-parametermanager/src"
32+
- source: "/google/cloud/parametermanager/(v.*)/.*-java/samples/snippets/generated"
33+
dest: "/owl-bot-staging/java-parametermanager/$1/samples/snippets/generated"
34+
35+
api-name: parametermanager

‎java-parametermanager/.repo-metadata.json

+16
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
{
2+
"api_shortname": "parametermanager",
3+
"name_pretty": "Parameter Manager API",
4+
"product_documentation": "https://cloud.google.com/secret-manager/parameter-manager/docs/overview",
5+
"api_description": "(Public Preview) Parameter Manager is a single source of truth to store, access and manage the lifecycle of your workload parameters. Parameter Manager aims to make management of sensitive application parameters effortless for customers without diminishing focus on security.",
6+
"client_documentation": "https://cloud.google.com/java/docs/reference/google-cloud-parametermanager/latest/overview",
7+
"release_level": "preview",
8+
"transport": "both",
9+
"language": "java",
10+
"repo": "googleapis/google-cloud-java",
11+
"repo_short": "java-parametermanager",
12+
"distribution_name": "com.google.cloud:google-cloud-parametermanager",
13+
"api_id": "parametermanager.googleapis.com",
14+
"library_type": "GAPIC_AUTO",
15+
"requires_billing": true
16+
}

‎java-parametermanager/README.md

+224
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,224 @@
1+
# Google Parameter Manager API Client for Java
2+
3+
Java idiomatic client for [Parameter Manager API][product-docs].
4+
5+
[![Maven][maven-version-image]][maven-version-link]
6+
![Stability][stability-image]
7+
8+
- [Product Documentation][product-docs]
9+
- [Client Library Documentation][javadocs]
10+
11+
> Note: This client is a work-in-progress, and may occasionally
12+
> make backwards-incompatible changes.
13+
14+
15+
## Quickstart
16+
17+
18+
If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
19+
20+
```xml
21+
<dependencyManagement>
22+
<dependencies>
23+
<dependency>
24+
<groupId>com.google.cloud</groupId>
25+
<artifactId>libraries-bom</artifactId>
26+
<version>26.53.0</version>
27+
<type>pom</type>
28+
<scope>import</scope>
29+
</dependency>
30+
</dependencies>
31+
</dependencyManagement>
32+
33+
<dependencies>
34+
<dependency>
35+
<groupId>com.google.cloud</groupId>
36+
<artifactId>google-cloud-parametermanager</artifactId>
37+
</dependency>
38+
</dependencies>
39+
```
40+
41+
If you are using Maven without the BOM, add this to your dependencies:
42+
43+
44+
```xml
45+
<dependency>
46+
<groupId>com.google.cloud</groupId>
47+
<artifactId>google-cloud-parametermanager</artifactId>
48+
<version>0.0.0</version>
49+
</dependency>
50+
```
51+
52+
If you are using Gradle without BOM, add this to your dependencies:
53+
54+
```Groovy
55+
implementation 'com.google.cloud:google-cloud-parametermanager:0.0.0'
56+
```
57+
58+
If you are using SBT, add this to your dependencies:
59+
60+
```Scala
61+
libraryDependencies += "com.google.cloud" % "google-cloud-parametermanager" % "0.0.0"
62+
```
63+
64+
## Authentication
65+
66+
See the [Authentication][authentication] section in the base directory's README.
67+
68+
## Authorization
69+
70+
The client application making API calls must be granted [authorization scopes][auth-scopes] required for the desired Parameter Manager API APIs, and the authenticated principal must have the [IAM role(s)][predefined-iam-roles] required to access GCP resources using the Parameter Manager API API calls.
71+
72+
## Getting Started
73+
74+
### Prerequisites
75+
76+
You will need a [Google Cloud Platform Console][developer-console] project with the Parameter Manager API [API enabled][enable-api].
77+
You will need to [enable billing][enable-billing] to use Google Parameter Manager API.
78+
[Follow these instructions][create-project] to get your project set up. You will also need to set up the local development environment by
79+
[installing the Google Cloud Command Line Interface][cloud-cli] and running the following commands in command line:
80+
`gcloud auth login` and `gcloud config set project [YOUR PROJECT ID]`.
81+
82+
### Installation and setup
83+
84+
You'll need to obtain the `google-cloud-parametermanager` library. See the [Quickstart](#quickstart) section
85+
to add `google-cloud-parametermanager` as a dependency in your code.
86+
87+
## About Parameter Manager API
88+
89+
90+
[Parameter Manager API][product-docs] (Public Preview) Parameter Manager is a single source of truth to store, access and manage the lifecycle of your workload parameters. Parameter Manager aims to make management of sensitive application parameters effortless for customers without diminishing focus on security.
91+
92+
See the [Parameter Manager API client library docs][javadocs] to learn how to
93+
use this Parameter Manager API Client Library.
94+
95+
96+
97+
98+
99+
100+
## Troubleshooting
101+
102+
To get help, follow the instructions in the [shared Troubleshooting document][troubleshooting].
103+
104+
## Transport
105+
106+
Parameter Manager API uses both gRPC and HTTP/JSON for the transport layer.
107+
108+
## Supported Java Versions
109+
110+
Java 8 or above is required for using this client.
111+
112+
Google's Java client libraries,
113+
[Google Cloud Client Libraries][cloudlibs]
114+
and
115+
[Google Cloud API Libraries][apilibs],
116+
follow the
117+
[Oracle Java SE support roadmap][oracle]
118+
(see the Oracle Java SE Product Releases section).
119+
120+
### For new development
121+
122+
In general, new feature development occurs with support for the lowest Java
123+
LTS version covered by Oracle's Premier Support (which typically lasts 5 years
124+
from initial General Availability). If the minimum required JVM for a given
125+
library is changed, it is accompanied by a [semver][semver] major release.
126+
127+
Java 11 and (in September 2021) Java 17 are the best choices for new
128+
development.
129+
130+
### Keeping production systems current
131+
132+
Google tests its client libraries with all current LTS versions covered by
133+
Oracle's Extended Support (which typically lasts 8 years from initial
134+
General Availability).
135+
136+
#### Legacy support
137+
138+
Google's client libraries support legacy versions of Java runtimes with long
139+
term stable libraries that don't receive feature updates on a best efforts basis
140+
as it may not be possible to backport all patches.
141+
142+
Google provides updates on a best efforts basis to apps that continue to use
143+
Java 7, though apps might need to upgrade to current versions of the library
144+
that supports their JVM.
145+
146+
#### Where to find specific information
147+
148+
The latest versions and the supported Java versions are identified on
149+
the individual GitHub repository `github.com/GoogleAPIs/java-SERVICENAME`
150+
and on [google-cloud-java][g-c-j].
151+
152+
## Versioning
153+
154+
155+
This library follows [Semantic Versioning](http://semver.org/).
156+
157+
158+
It is currently in major version zero (``0.y.z``), which means that anything may change at any time
159+
and the public API should not be considered stable.
160+
161+
162+
## Contributing
163+
164+
165+
Contributions to this library are always welcome and highly encouraged.
166+
167+
See [CONTRIBUTING][contributing] for more information how to get started.
168+
169+
Please note that this project is released with a Contributor Code of Conduct. By participating in
170+
this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more
171+
information.
172+
173+
174+
## License
175+
176+
Apache 2.0 - See [LICENSE][license] for more information.
177+
178+
## CI Status
179+
180+
Java Version | Status
181+
------------ | ------
182+
Java 8 | [![Kokoro CI][kokoro-badge-image-2]][kokoro-badge-link-2]
183+
Java 8 OSX | [![Kokoro CI][kokoro-badge-image-3]][kokoro-badge-link-3]
184+
Java 8 Windows | [![Kokoro CI][kokoro-badge-image-4]][kokoro-badge-link-4]
185+
Java 11 | [![Kokoro CI][kokoro-badge-image-5]][kokoro-badge-link-5]
186+
187+
Java is a registered trademark of Oracle and/or its affiliates.
188+
189+
[product-docs]: https://cloud.google.com/secret-manager/parameter-manager/docs/overview
190+
[javadocs]: https://cloud.google.com/java/docs/reference/google-cloud-parametermanager/latest/overview
191+
[kokoro-badge-image-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java7.svg
192+
[kokoro-badge-link-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java7.html
193+
[kokoro-badge-image-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java8.svg
194+
[kokoro-badge-link-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java8.html
195+
[kokoro-badge-image-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java8-osx.svg
196+
[kokoro-badge-link-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java8-osx.html
197+
[kokoro-badge-image-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java8-win.svg
198+
[kokoro-badge-link-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java8-win.html
199+
[kokoro-badge-image-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.svg
200+
[kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
201+
[stability-image]: https://img.shields.io/badge/stability-preview-yellow
202+
[maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-parametermanager.svg
203+
[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-parametermanager/0.0.0
204+
[authentication]: https://github.com/googleapis/google-cloud-java#authentication
205+
[auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
206+
[predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles
207+
[iam-policy]: https://cloud.google.com/iam/docs/overview#cloud-iam-policy
208+
[developer-console]: https://console.developers.google.com/
209+
[create-project]: https://cloud.google.com/resource-manager/docs/creating-managing-projects
210+
[cloud-cli]: https://cloud.google.com/cli
211+
[troubleshooting]: https://github.com/googleapis/google-cloud-java/blob/main/TROUBLESHOOTING.md
212+
[contributing]: https://github.com/googleapis/google-cloud-java/blob/main/CONTRIBUTING.md
213+
[code-of-conduct]: https://github.com/googleapis/google-cloud-java/blob/main/CODE_OF_CONDUCT.md#contributor-code-of-conduct
214+
[license]: https://github.com/googleapis/google-cloud-java/blob/main/LICENSE
215+
[enable-billing]: https://cloud.google.com/apis/docs/getting-started#enabling_billing
216+
[enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=parametermanager.googleapis.com
217+
[libraries-bom]: https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM
218+
[shell_img]: https://gstatic.com/cloudssh/images/open-btn.png
219+
220+
[semver]: https://semver.org/
221+
[cloudlibs]: https://cloud.google.com/apis/docs/client-libraries-explained
222+
[apilibs]: https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries
223+
[oracle]: https://www.oracle.com/java/technologies/java-se-support-roadmap.html
224+
[g-c-j]: http://github.com/googleapis/google-cloud-java

0 commit comments

Comments
 (0)