feat: Etags in Secret Manager (#481)

This PR was generated using Autosynth. 🌈 Synth log will be available here: https://source.cloud.google.com/results/invocations/359cfa48-17e7-4967-a6fe-099f36284b4a/targets - [ ] To automatically regenerate this PR, check this box. (May take up to 24 hours.) PiperOrigin-RevId: 373836373 Source-Link: googleapis/googleapis@bff8074
googleapis · May 21, 2021 · b2b9934 · b2b9934
1 parent ccb4b00
commit b2b9934
Show file tree

Hide file tree

Showing 26 changed files with 1,626 additions and 219 deletions.
diff --git a/...etmanager/src/main/java/com/google/cloud/secretmanager/v1/SecretManagerServiceClient.java b/...etmanager/src/main/java/com/google/cloud/secretmanager/v1/SecretManagerServiceClient.java
@@ -783,6 +783,7 @@ public final void deleteSecret(String name) {
    *   DeleteSecretRequest request =
    *       DeleteSecretRequest.newBuilder()
    *           .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setEtag("etag3123477")
    *           .build();
    *   secretManagerServiceClient.deleteSecret(request);
    * }
@@ -807,6 +808,7 @@ public final void deleteSecret(DeleteSecretRequest request) {
    *   DeleteSecretRequest request =
    *       DeleteSecretRequest.newBuilder()
    *           .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setEtag("etag3123477")
    *           .build();
    *   ApiFuture<Empty> future =
    *       secretManagerServiceClient.deleteSecretCallable().futureCall(request);
@@ -981,7 +983,7 @@ public final ListSecretVersionsPagedResponse listSecretVersions(
   /**
    * Gets metadata for a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
-   * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
+   * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the most recently created
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
    * <p>Sample code:
@@ -997,7 +999,7 @@ public final ListSecretVersionsPagedResponse listSecretVersions(
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
-   *     `projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
+   *     <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the most recently created
    *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -1011,7 +1013,7 @@ public final SecretVersion getSecretVersion(SecretVersionName name) {
   /**
    * Gets metadata for a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
-   * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
+   * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the most recently created
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
    * <p>Sample code:
@@ -1027,7 +1029,7 @@ public final SecretVersion getSecretVersion(SecretVersionName name) {
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
-   *     `projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
+   *     <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the most recently created
    *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -1040,7 +1042,7 @@ public final SecretVersion getSecretVersion(String name) {
   /**
    * Gets metadata for a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
-   * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
+   * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the most recently created
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
    * <p>Sample code:
@@ -1067,7 +1069,7 @@ public final SecretVersion getSecretVersion(GetSecretVersionRequest request) {
   /**
    * Gets metadata for a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
-   * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
+   * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the most recently created
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
    * <p>Sample code:
@@ -1095,7 +1097,7 @@ public final UnaryCallable<GetSecretVersionRequest, SecretVersion> getSecretVers
    * Accesses a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]. This call returns the
    * secret data.
    *
-   * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
+   * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the most recently created
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
    * <p>Sample code:
@@ -1111,6 +1113,8 @@ public final UnaryCallable<GetSecretVersionRequest, SecretVersion> getSecretVers
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
+   *     <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the most recently created
+   *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final AccessSecretVersionResponse accessSecretVersion(SecretVersionName name) {
@@ -1126,7 +1130,7 @@ public final AccessSecretVersionResponse accessSecretVersion(SecretVersionName n
    * Accesses a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]. This call returns the
    * secret data.
    *
-   * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
+   * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the most recently created
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
    * <p>Sample code:
@@ -1142,6 +1146,8 @@ public final AccessSecretVersionResponse accessSecretVersion(SecretVersionName n
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
+   *     <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the most recently created
+   *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final AccessSecretVersionResponse accessSecretVersion(String name) {
@@ -1155,7 +1161,7 @@ public final AccessSecretVersionResponse accessSecretVersion(String name) {
    * Accesses a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]. This call returns the
    * secret data.
    *
-   * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
+   * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the most recently created
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
    * <p>Sample code:
@@ -1184,7 +1190,7 @@ public final AccessSecretVersionResponse accessSecretVersion(AccessSecretVersion
    * Accesses a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]. This call returns the
    * secret data.
    *
-   * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
+   * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the most recently created
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
    * <p>Sample code:
@@ -1284,6 +1290,7 @@ public final SecretVersion disableSecretVersion(String name) {
    *   DisableSecretVersionRequest request =
    *       DisableSecretVersionRequest.newBuilder()
    *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .setEtag("etag3123477")
    *           .build();
    *   SecretVersion response = secretManagerServiceClient.disableSecretVersion(request);
    * }
@@ -1312,6 +1319,7 @@ public final SecretVersion disableSecretVersion(DisableSecretVersionRequest requ
    *   DisableSecretVersionRequest request =
    *       DisableSecretVersionRequest.newBuilder()
    *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .setEtag("etag3123477")
    *           .build();
    *   ApiFuture<SecretVersion> future =
    *       secretManagerServiceClient.disableSecretVersionCallable().futureCall(request);
@@ -1401,6 +1409,7 @@ public final SecretVersion enableSecretVersion(String name) {
    *   EnableSecretVersionRequest request =
    *       EnableSecretVersionRequest.newBuilder()
    *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .setEtag("etag3123477")
    *           .build();
    *   SecretVersion response = secretManagerServiceClient.enableSecretVersion(request);
    * }
@@ -1429,6 +1438,7 @@ public final SecretVersion enableSecretVersion(EnableSecretVersionRequest reques
    *   EnableSecretVersionRequest request =
    *       EnableSecretVersionRequest.newBuilder()
    *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .setEtag("etag3123477")
    *           .build();
    *   ApiFuture<SecretVersion> future =
    *       secretManagerServiceClient.enableSecretVersionCallable().futureCall(request);
@@ -1521,6 +1531,7 @@ public final SecretVersion destroySecretVersion(String name) {
    *   DestroySecretVersionRequest request =
    *       DestroySecretVersionRequest.newBuilder()
    *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .setEtag("etag3123477")
    *           .build();
    *   SecretVersion response = secretManagerServiceClient.destroySecretVersion(request);
    * }
@@ -1550,6 +1561,7 @@ public final SecretVersion destroySecretVersion(DestroySecretVersionRequest requ
    *   DestroySecretVersionRequest request =
    *       DestroySecretVersionRequest.newBuilder()
    *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .setEtag("etag3123477")
    *           .build();
    *   ApiFuture<SecretVersion> future =
    *       secretManagerServiceClient.destroySecretVersionCallable().futureCall(request);

diff --git a/...nager/src/test/java/com/google/cloud/secretmanager/v1/SecretManagerServiceClientTest.java b/...nager/src/test/java/com/google/cloud/secretmanager/v1/SecretManagerServiceClientTest.java
@@ -189,6 +189,7 @@ public void createSecretTest() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .putAllLabels(new HashMap<String, String>())
             .addAllTopics(new ArrayList<Topic>())
+            .setEtag("etag3123477")
             .setRotation(Rotation.newBuilder().build())
             .build();
     mockSecretManagerService.addResponse(expectedResponse);
@@ -238,6 +239,7 @@ public void createSecretTest2() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .putAllLabels(new HashMap<String, String>())
             .addAllTopics(new ArrayList<Topic>())
+            .setEtag("etag3123477")
             .setRotation(Rotation.newBuilder().build())
             .build();
     mockSecretManagerService.addResponse(expectedResponse);
@@ -286,6 +288,7 @@ public void addSecretVersionTest() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .setDestroyTime(Timestamp.newBuilder().build())
             .setReplicationStatus(ReplicationStatus.newBuilder().build())
+            .setEtag("etag3123477")
             .build();
     mockSecretManagerService.addResponse(expectedResponse);
 
@@ -330,6 +333,7 @@ public void addSecretVersionTest2() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .setDestroyTime(Timestamp.newBuilder().build())
             .setReplicationStatus(ReplicationStatus.newBuilder().build())
+            .setEtag("etag3123477")
             .build();
     mockSecretManagerService.addResponse(expectedResponse);
 
@@ -375,6 +379,7 @@ public void getSecretTest() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .putAllLabels(new HashMap<String, String>())
             .addAllTopics(new ArrayList<Topic>())
+            .setEtag("etag3123477")
             .setRotation(Rotation.newBuilder().build())
             .build();
     mockSecretManagerService.addResponse(expectedResponse);
@@ -418,6 +423,7 @@ public void getSecretTest2() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .putAllLabels(new HashMap<String, String>())
             .addAllTopics(new ArrayList<Topic>())
+            .setEtag("etag3123477")
             .setRotation(Rotation.newBuilder().build())
             .build();
     mockSecretManagerService.addResponse(expectedResponse);
@@ -461,6 +467,7 @@ public void updateSecretTest() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .putAllLabels(new HashMap<String, String>())
             .addAllTopics(new ArrayList<Topic>())
+            .setEtag("etag3123477")
             .setRotation(Rotation.newBuilder().build())
             .build();
     mockSecretManagerService.addResponse(expectedResponse);
@@ -662,6 +669,7 @@ public void getSecretVersionTest() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .setDestroyTime(Timestamp.newBuilder().build())
             .setReplicationStatus(ReplicationStatus.newBuilder().build())
+            .setEtag("etag3123477")
             .build();
     mockSecretManagerService.addResponse(expectedResponse);
 
@@ -703,6 +711,7 @@ public void getSecretVersionTest2() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .setDestroyTime(Timestamp.newBuilder().build())
             .setReplicationStatus(ReplicationStatus.newBuilder().build())
+            .setEtag("etag3123477")
             .build();
     mockSecretManagerService.addResponse(expectedResponse);
 
@@ -822,6 +831,7 @@ public void disableSecretVersionTest() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .setDestroyTime(Timestamp.newBuilder().build())
             .setReplicationStatus(ReplicationStatus.newBuilder().build())
+            .setEtag("etag3123477")
             .build();
     mockSecretManagerService.addResponse(expectedResponse);
 
@@ -864,6 +874,7 @@ public void disableSecretVersionTest2() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .setDestroyTime(Timestamp.newBuilder().build())
             .setReplicationStatus(ReplicationStatus.newBuilder().build())
+            .setEtag("etag3123477")
             .build();
     mockSecretManagerService.addResponse(expectedResponse);
 
@@ -906,6 +917,7 @@ public void enableSecretVersionTest() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .setDestroyTime(Timestamp.newBuilder().build())
             .setReplicationStatus(ReplicationStatus.newBuilder().build())
+            .setEtag("etag3123477")
             .build();
     mockSecretManagerService.addResponse(expectedResponse);
 
@@ -947,6 +959,7 @@ public void enableSecretVersionTest2() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .setDestroyTime(Timestamp.newBuilder().build())
             .setReplicationStatus(ReplicationStatus.newBuilder().build())
+            .setEtag("etag3123477")
             .build();
     mockSecretManagerService.addResponse(expectedResponse);
 
@@ -988,6 +1001,7 @@ public void destroySecretVersionTest() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .setDestroyTime(Timestamp.newBuilder().build())
             .setReplicationStatus(ReplicationStatus.newBuilder().build())
+            .setEtag("etag3123477")
             .build();
     mockSecretManagerService.addResponse(expectedResponse);
 
@@ -1030,6 +1044,7 @@ public void destroySecretVersionTest2() throws Exception {
             .setCreateTime(Timestamp.newBuilder().build())
             .setDestroyTime(Timestamp.newBuilder().build())
             .setReplicationStatus(ReplicationStatus.newBuilder().build())
+            .setEtag("etag3123477")
             .build();
     mockSecretManagerService.addResponse(expectedResponse);