diff --git a/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/SecretManagerServiceClient.java b/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/SecretManagerServiceClient.java index e8567618..a320b755 100644 --- a/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/SecretManagerServiceClient.java +++ b/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/SecretManagerServiceClient.java @@ -56,6 +56,16 @@ *
This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * ProjectName parent = ProjectName.of("[PROJECT]");
+ * String secretId = "secretId945974251";
+ * Secret secret = Secret.newBuilder().build();
+ * Secret response = secretManagerServiceClient.createSecret(parent, secretId, secret);
+ * }
+ * }
+ *
* Note: close() needs to be called on the SecretManagerServiceClient object to clean up * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). @@ -162,6 +172,18 @@ public SecretManagerServiceStub getStub() { /** * Lists [Secrets][google.cloud.secretmanager.v1.Secret]. * + *
Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * ProjectName parent = ProjectName.of("[PROJECT]");
+ * for (Secret element : secretManagerServiceClient.listSecrets(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
* @param parent Required. The resource name of the project associated with the
* [Secrets][google.cloud.secretmanager.v1.Secret], in the format `projects/*`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -178,6 +200,18 @@ public final ListSecretsPagedResponse listSecrets(ProjectName parent) {
/**
* Lists [Secrets][google.cloud.secretmanager.v1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String parent = ProjectName.of("[PROJECT]").toString();
+ * for (Secret element : secretManagerServiceClient.listSecrets(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
* @param parent Required. The resource name of the project associated with the
* [Secrets][google.cloud.secretmanager.v1.Secret], in the format `projects/*`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -191,6 +225,23 @@ public final ListSecretsPagedResponse listSecrets(String parent) {
/**
* Lists [Secrets][google.cloud.secretmanager.v1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * ListSecretsRequest request =
+ * ListSecretsRequest.newBuilder()
+ * .setParent(ProjectName.of("[PROJECT]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * for (Secret element : secretManagerServiceClient.listSecrets(request).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -203,6 +254,24 @@ public final ListSecretsPagedResponse listSecrets(ListSecretsRequest request) {
* Lists [Secrets][google.cloud.secretmanager.v1.Secret].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * ListSecretsRequest request =
+ * ListSecretsRequest.newBuilder()
+ * .setParent(ProjectName.of("[PROJECT]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.listSecretsPagedCallable().futureCall(request);
+ * // Do something.
+ * for (Secret element : future.get().iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * while (true) {
+ * ListSecretsResponse response =
+ * secretManagerServiceClient.listSecretsCallable().call(request);
+ * for (Secret element : response.getResponsesList()) {
+ * // doThingsWith(element);
+ * }
+ * String nextPageToken = response.getNextPageToken();
+ * if (!Strings.isNullOrEmpty(nextPageToken)) {
+ * request = request.toBuilder().setPageToken(nextPageToken).build();
+ * } else {
+ * break;
+ * }
+ * }
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * ProjectName parent = ProjectName.of("[PROJECT]");
+ * String secretId = "secretId945974251";
+ * Secret secret = Secret.newBuilder().build();
+ * Secret response = secretManagerServiceClient.createSecret(parent, secretId, secret);
+ * }
+ * }
+ *
* @param parent Required. The resource name of the project to associate with the
* [Secret][google.cloud.secretmanager.v1.Secret], in the format `projects/*`.
* @param secretId Required. This must be unique within the project.
@@ -249,6 +349,18 @@ public final Secret createSecret(ProjectName parent, String secretId, Secret sec
* Creates a new [Secret][google.cloud.secretmanager.v1.Secret] containing no
* [SecretVersions][google.cloud.secretmanager.v1.SecretVersion].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String parent = ProjectName.of("[PROJECT]").toString();
+ * String secretId = "secretId945974251";
+ * Secret secret = Secret.newBuilder().build();
+ * Secret response = secretManagerServiceClient.createSecret(parent, secretId, secret);
+ * }
+ * }
+ *
* @param parent Required. The resource name of the project to associate with the
* [Secret][google.cloud.secretmanager.v1.Secret], in the format `projects/*`.
* @param secretId Required. This must be unique within the project.
@@ -274,6 +386,21 @@ public final Secret createSecret(String parent, String secretId, Secret secret)
* Creates a new [Secret][google.cloud.secretmanager.v1.Secret] containing no
* [SecretVersions][google.cloud.secretmanager.v1.SecretVersion].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * CreateSecretRequest request =
+ * CreateSecretRequest.newBuilder()
+ * .setParent(ProjectName.of("[PROJECT]").toString())
+ * .setSecretId("secretId945974251")
+ * .setSecret(Secret.newBuilder().build())
+ * .build();
+ * Secret response = secretManagerServiceClient.createSecret(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -287,6 +414,22 @@ public final Secret createSecret(CreateSecretRequest request) {
* [SecretVersions][google.cloud.secretmanager.v1.SecretVersion].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * CreateSecretRequest request =
+ * CreateSecretRequest.newBuilder()
+ * .setParent(ProjectName.of("[PROJECT]").toString())
+ * .setSecretId("secretId945974251")
+ * .setSecret(Secret.newBuilder().build())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.createSecretCallable().futureCall(request);
+ * // Do something.
+ * Secret response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretName parent = SecretName.of("[PROJECT]", "[SECRET]");
+ * SecretPayload payload = SecretPayload.newBuilder().build();
+ * SecretVersion response = secretManagerServiceClient.addSecretVersion(parent, payload);
+ * }
+ * }
+ *
* @param parent Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret]
* to associate with the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the
* format `projects/*/secrets/*`.
@@ -318,6 +472,17 @@ public final SecretVersion addSecretVersion(SecretName parent, SecretPayload pay
* Creates a new [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] containing secret
* data and attaches it to an existing [Secret][google.cloud.secretmanager.v1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String parent = SecretName.of("[PROJECT]", "[SECRET]").toString();
+ * SecretPayload payload = SecretPayload.newBuilder().build();
+ * SecretVersion response = secretManagerServiceClient.addSecretVersion(parent, payload);
+ * }
+ * }
+ *
* @param parent Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret]
* to associate with the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the
* format `projects/*/secrets/*`.
@@ -336,6 +501,20 @@ public final SecretVersion addSecretVersion(String parent, SecretPayload payload
* Creates a new [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] containing secret
* data and attaches it to an existing [Secret][google.cloud.secretmanager.v1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * AddSecretVersionRequest request =
+ * AddSecretVersionRequest.newBuilder()
+ * .setParent(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .setPayload(SecretPayload.newBuilder().build())
+ * .build();
+ * SecretVersion response = secretManagerServiceClient.addSecretVersion(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -349,6 +528,21 @@ public final SecretVersion addSecretVersion(AddSecretVersionRequest request) {
* data and attaches it to an existing [Secret][google.cloud.secretmanager.v1.Secret].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * AddSecretVersionRequest request =
+ * AddSecretVersionRequest.newBuilder()
+ * .setParent(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .setPayload(SecretPayload.newBuilder().build())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.addSecretVersionCallable().futureCall(request);
+ * // Do something.
+ * SecretVersion response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretName name = SecretName.of("[PROJECT]", "[SECRET]");
+ * Secret response = secretManagerServiceClient.getSecret(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret],
* in the format `projects/*/secrets/*`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -372,6 +576,16 @@ public final Secret getSecret(SecretName name) {
/**
* Gets metadata for a given [Secret][google.cloud.secretmanager.v1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String name = SecretName.of("[PROJECT]", "[SECRET]").toString();
+ * Secret response = secretManagerServiceClient.getSecret(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret],
* in the format `projects/*/secrets/*`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -385,6 +599,19 @@ public final Secret getSecret(String name) {
/**
* Gets metadata for a given [Secret][google.cloud.secretmanager.v1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * GetSecretRequest request =
+ * GetSecretRequest.newBuilder()
+ * .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .build();
+ * Secret response = secretManagerServiceClient.getSecret(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -397,6 +624,19 @@ public final Secret getSecret(GetSecretRequest request) {
* Gets metadata for a given [Secret][google.cloud.secretmanager.v1.Secret].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * GetSecretRequest request =
+ * GetSecretRequest.newBuilder()
+ * .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .build();
+ * ApiFuture future = secretManagerServiceClient.getSecretCallable().futureCall(request);
+ * // Do something.
+ * Secret response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * Secret secret = Secret.newBuilder().build();
+ * FieldMask updateMask = FieldMask.newBuilder().build();
+ * Secret response = secretManagerServiceClient.updateSecret(secret, updateMask);
+ * }
+ * }
+ *
* @param secret Required. [Secret][google.cloud.secretmanager.v1.Secret] with updated field
* values.
* @param updateMask Required. Specifies the fields to be updated.
@@ -421,6 +672,20 @@ public final Secret updateSecret(Secret secret, FieldMask updateMask) {
/**
* Updates metadata of an existing [Secret][google.cloud.secretmanager.v1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * UpdateSecretRequest request =
+ * UpdateSecretRequest.newBuilder()
+ * .setSecret(Secret.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .build();
+ * Secret response = secretManagerServiceClient.updateSecret(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -433,6 +698,21 @@ public final Secret updateSecret(UpdateSecretRequest request) {
* Updates metadata of an existing [Secret][google.cloud.secretmanager.v1.Secret].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * UpdateSecretRequest request =
+ * UpdateSecretRequest.newBuilder()
+ * .setSecret(Secret.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.updateSecretCallable().futureCall(request);
+ * // Do something.
+ * Secret response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretName name = SecretName.of("[PROJECT]", "[SECRET]");
+ * secretManagerServiceClient.deleteSecret(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret]
* to delete in the format `projects/*/secrets/*`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -456,6 +746,16 @@ public final void deleteSecret(SecretName name) {
/**
* Deletes a [Secret][google.cloud.secretmanager.v1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String name = SecretName.of("[PROJECT]", "[SECRET]").toString();
+ * secretManagerServiceClient.deleteSecret(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret]
* to delete in the format `projects/*/secrets/*`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -469,6 +769,19 @@ public final void deleteSecret(String name) {
/**
* Deletes a [Secret][google.cloud.secretmanager.v1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * DeleteSecretRequest request =
+ * DeleteSecretRequest.newBuilder()
+ * .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .build();
+ * secretManagerServiceClient.deleteSecret(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -481,6 +794,20 @@ public final void deleteSecret(DeleteSecretRequest request) {
* Deletes a [Secret][google.cloud.secretmanager.v1.Secret].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * DeleteSecretRequest request =
+ * DeleteSecretRequest.newBuilder()
+ * .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.deleteSecretCallable().futureCall(request);
+ * // Do something.
+ * future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretName parent = SecretName.of("[PROJECT]", "[SECRET]");
+ * for (SecretVersion element :
+ * secretManagerServiceClient.listSecretVersions(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
* @param parent Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret]
* associated with the [SecretVersions][google.cloud.secretmanager.v1.SecretVersion] to list,
* in the format `projects/*/secrets/*`.
@@ -509,6 +849,19 @@ public final ListSecretVersionsPagedResponse listSecretVersions(SecretName paren
* Lists [SecretVersions][google.cloud.secretmanager.v1.SecretVersion]. This call does not return
* secret data.
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String parent = SecretName.of("[PROJECT]", "[SECRET]").toString();
+ * for (SecretVersion element :
+ * secretManagerServiceClient.listSecretVersions(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
* @param parent Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret]
* associated with the [SecretVersions][google.cloud.secretmanager.v1.SecretVersion] to list,
* in the format `projects/*/secrets/*`.
@@ -525,6 +878,24 @@ public final ListSecretVersionsPagedResponse listSecretVersions(String parent) {
* Lists [SecretVersions][google.cloud.secretmanager.v1.SecretVersion]. This call does not return
* secret data.
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * ListSecretVersionsRequest request =
+ * ListSecretVersionsRequest.newBuilder()
+ * .setParent(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * for (SecretVersion element :
+ * secretManagerServiceClient.listSecretVersions(request).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -539,6 +910,24 @@ public final ListSecretVersionsPagedResponse listSecretVersions(
* secret data.
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * ListSecretVersionsRequest request =
+ * ListSecretVersionsRequest.newBuilder()
+ * .setParent(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.listSecretVersionsPagedCallable().futureCall(request);
+ * // Do something.
+ * for (SecretVersion element : future.get().iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * while (true) {
+ * ListSecretVersionsResponse response =
+ * secretManagerServiceClient.listSecretVersionsCallable().call(request);
+ * for (SecretVersion element : response.getResponsesList()) {
+ * // doThingsWith(element);
+ * }
+ * String nextPageToken = response.getNextPageToken();
+ * if (!Strings.isNullOrEmpty(nextPageToken)) {
+ * request = request.toBuilder().setPageToken(nextPageToken).build();
+ * } else {
+ * break;
+ * }
+ * }
+ * }
+ * }
*/
public final UnaryCallable`projects/*/secrets/*/versions/latest` is an alias to the `latest` * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]. * + *
Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+ * SecretVersion response = secretManagerServiceClient.getSecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the format
* `projects/*/secrets/*/versions/*`.
@@ -584,6 +1002,16 @@ public final SecretVersion getSecretVersion(SecretVersionName name) {
* `projects/*/secrets/*/versions/latest` is an alias to the `latest` * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]. * + *
Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+ * SecretVersion response = secretManagerServiceClient.getSecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the format
* `projects/*/secrets/*/versions/*`.
@@ -603,6 +1031,19 @@ public final SecretVersion getSecretVersion(String name) {
* `projects/*/secrets/*/versions/latest` is an alias to the `latest` * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]. * + *
Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * GetSecretVersionRequest request =
+ * GetSecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * SecretVersion response = secretManagerServiceClient.getSecretVersion(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -618,6 +1059,20 @@ public final SecretVersion getSecretVersion(GetSecretVersionRequest request) {
* [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * GetSecretVersionRequest request =
+ * GetSecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.getSecretVersionCallable().futureCall(request);
+ * // Do something.
+ * SecretVersion response = future.get();
+ * }
+ * }
*/
public final UnaryCallable`projects/*/secrets/*/versions/latest` is an alias to the `latest` * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]. * + *
Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+ * AccessSecretVersionResponse response = secretManagerServiceClient.accessSecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the format
* `projects/*/secrets/*/versions/*`.
@@ -652,6 +1117,16 @@ public final AccessSecretVersionResponse accessSecretVersion(SecretVersionName n
* `projects/*/secrets/*/versions/latest` is an alias to the `latest` * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]. * + *
Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+ * AccessSecretVersionResponse response = secretManagerServiceClient.accessSecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the format
* `projects/*/secrets/*/versions/*`.
@@ -671,6 +1146,20 @@ public final AccessSecretVersionResponse accessSecretVersion(String name) {
* `projects/*/secrets/*/versions/latest` is an alias to the `latest` * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]. * + *
Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * AccessSecretVersionRequest request =
+ * AccessSecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * AccessSecretVersionResponse response =
+ * secretManagerServiceClient.accessSecretVersion(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -687,6 +1176,20 @@ public final AccessSecretVersionResponse accessSecretVersion(AccessSecretVersion
* [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * AccessSecretVersionRequest request =
+ * AccessSecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.accessSecretVersionCallable().futureCall(request);
+ * // Do something.
+ * AccessSecretVersionResponse response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+ * SecretVersion response = secretManagerServiceClient.disableSecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to disable in the format
* `projects/*/secrets/*/versions/*`.
@@ -722,6 +1235,16 @@ public final SecretVersion disableSecretVersion(SecretVersionName name) {
* [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to
* [DISABLED][google.cloud.secretmanager.v1.SecretVersion.State.DISABLED].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+ * SecretVersion response = secretManagerServiceClient.disableSecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to disable in the format
* `projects/*/secrets/*/versions/*`.
@@ -741,6 +1264,19 @@ public final SecretVersion disableSecretVersion(String name) {
* [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to
* [DISABLED][google.cloud.secretmanager.v1.SecretVersion.State.DISABLED].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * DisableSecretVersionRequest request =
+ * DisableSecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * SecretVersion response = secretManagerServiceClient.disableSecretVersion(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -757,6 +1293,20 @@ public final SecretVersion disableSecretVersion(DisableSecretVersionRequest requ
* [DISABLED][google.cloud.secretmanager.v1.SecretVersion.State.DISABLED].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * DisableSecretVersionRequest request =
+ * DisableSecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.disableSecretVersionCallable().futureCall(request);
+ * // Do something.
+ * SecretVersion response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+ * SecretVersion response = secretManagerServiceClient.enableSecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to enable in the format
* `projects/*/secrets/*/versions/*`.
@@ -792,6 +1352,16 @@ public final SecretVersion enableSecretVersion(SecretVersionName name) {
* [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to
* [ENABLED][google.cloud.secretmanager.v1.SecretVersion.State.ENABLED].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+ * SecretVersion response = secretManagerServiceClient.enableSecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to enable in the format
* `projects/*/secrets/*/versions/*`.
@@ -811,6 +1381,19 @@ public final SecretVersion enableSecretVersion(String name) {
* [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to
* [ENABLED][google.cloud.secretmanager.v1.SecretVersion.State.ENABLED].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * EnableSecretVersionRequest request =
+ * EnableSecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * SecretVersion response = secretManagerServiceClient.enableSecretVersion(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -827,6 +1410,20 @@ public final SecretVersion enableSecretVersion(EnableSecretVersionRequest reques
* [ENABLED][google.cloud.secretmanager.v1.SecretVersion.State.ENABLED].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * EnableSecretVersionRequest request =
+ * EnableSecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.enableSecretVersionCallable().futureCall(request);
+ * // Do something.
+ * SecretVersion response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+ * SecretVersion response = secretManagerServiceClient.destroySecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to destroy in the format
* `projects/*/secrets/*/versions/*`.
@@ -864,6 +1471,16 @@ public final SecretVersion destroySecretVersion(SecretVersionName name) {
* [DESTROYED][google.cloud.secretmanager.v1.SecretVersion.State.DESTROYED] and irrevocably
* destroys the secret data.
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+ * SecretVersion response = secretManagerServiceClient.destroySecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to destroy in the format
* `projects/*/secrets/*/versions/*`.
@@ -884,6 +1501,19 @@ public final SecretVersion destroySecretVersion(String name) {
* [DESTROYED][google.cloud.secretmanager.v1.SecretVersion.State.DESTROYED] and irrevocably
* destroys the secret data.
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * DestroySecretVersionRequest request =
+ * DestroySecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * SecretVersion response = secretManagerServiceClient.destroySecretVersion(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -901,6 +1531,20 @@ public final SecretVersion destroySecretVersion(DestroySecretVersionRequest requ
* destroys the secret data.
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * DestroySecretVersionRequest request =
+ * DestroySecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.destroySecretVersionCallable().futureCall(request);
+ * // Do something.
+ * SecretVersion response = future.get();
+ * }
+ * }
*/
public final UnaryCallablePermissions on [SecretVersions][google.cloud.secretmanager.v1.SecretVersion] are enforced * according to the policy set on the associated [Secret][google.cloud.secretmanager.v1.Secret]. * + *
Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SetIamPolicyRequest request =
+ * SetIamPolicyRequest.newBuilder()
+ * .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .setPolicy(Policy.newBuilder().build())
+ * .build();
+ * Policy response = secretManagerServiceClient.setIamPolicy(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -929,6 +1587,21 @@ public final Policy setIamPolicy(SetIamPolicyRequest request) {
* according to the policy set on the associated [Secret][google.cloud.secretmanager.v1.Secret].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SetIamPolicyRequest request =
+ * SetIamPolicyRequest.newBuilder()
+ * .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .setPolicy(Policy.newBuilder().build())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.setIamPolicyCallable().futureCall(request);
+ * // Do something.
+ * Policy response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * GetIamPolicyRequest request =
+ * GetIamPolicyRequest.newBuilder()
+ * .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .setOptions(GetPolicyOptions.newBuilder().build())
+ * .build();
+ * Policy response = secretManagerServiceClient.getIamPolicy(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -952,6 +1639,21 @@ public final Policy getIamPolicy(GetIamPolicyRequest request) {
* not have a policy set.
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * GetIamPolicyRequest request =
+ * GetIamPolicyRequest.newBuilder()
+ * .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .setOptions(GetPolicyOptions.newBuilder().build())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.getIamPolicyCallable().futureCall(request);
+ * // Do something.
+ * Policy response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * TestIamPermissionsRequest request =
+ * TestIamPermissionsRequest.newBuilder()
+ * .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .addAllPermissions(new ArrayList())
+ * .build();
+ * TestIamPermissionsResponse response = secretManagerServiceClient.testIamPermissions(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -983,6 +1699,21 @@ public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsReq
* warning.
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * TestIamPermissionsRequest request =
+ * TestIamPermissionsRequest.newBuilder()
+ * .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .addAllPermissions(new ArrayList())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.testIamPermissionsCallable().futureCall(request);
+ * // Do something.
+ * TestIamPermissionsResponse response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample for SecretManagerServiceClient: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * ProjectName parent = ProjectName.of("[PROJECT]");
+ * String secretId = "secretId945974251";
+ * Secret secret = Secret.newBuilder().build();
+ * Secret response = secretManagerServiceClient.createSecret(parent, secretId, secret);
+ * }
+ * }
*/
@Generated("by gapic-generator-java")
package com.google.cloud.secretmanager.v1;
diff --git a/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1beta1/SecretManagerServiceClient.java b/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1beta1/SecretManagerServiceClient.java
index dcd6f27a..bfcc3acb 100644
--- a/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1beta1/SecretManagerServiceClient.java
+++ b/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1beta1/SecretManagerServiceClient.java
@@ -56,6 +56,16 @@
* This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * ProjectName parent = ProjectName.of("[PROJECT]");
+ * String secretId = "secretId945974251";
+ * Secret secret = Secret.newBuilder().build();
+ * Secret response = secretManagerServiceClient.createSecret(parent, secretId, secret);
+ * }
+ * }
+ *
* Note: close() needs to be called on the SecretManagerServiceClient object to clean up * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). @@ -163,6 +173,18 @@ public SecretManagerServiceStub getStub() { /** * Lists [Secrets][google.cloud.secrets.v1beta1.Secret]. * + *
Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * ProjectName parent = ProjectName.of("[PROJECT]");
+ * for (Secret element : secretManagerServiceClient.listSecrets(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
* @param parent Required. The resource name of the project associated with the
* [Secrets][google.cloud.secrets.v1beta1.Secret], in the format `projects/*`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -179,6 +201,18 @@ public final ListSecretsPagedResponse listSecrets(ProjectName parent) {
/**
* Lists [Secrets][google.cloud.secrets.v1beta1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String parent = ProjectName.of("[PROJECT]").toString();
+ * for (Secret element : secretManagerServiceClient.listSecrets(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
* @param parent Required. The resource name of the project associated with the
* [Secrets][google.cloud.secrets.v1beta1.Secret], in the format `projects/*`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -192,6 +226,23 @@ public final ListSecretsPagedResponse listSecrets(String parent) {
/**
* Lists [Secrets][google.cloud.secrets.v1beta1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * ListSecretsRequest request =
+ * ListSecretsRequest.newBuilder()
+ * .setParent(ProjectName.of("[PROJECT]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * for (Secret element : secretManagerServiceClient.listSecrets(request).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -204,6 +255,24 @@ public final ListSecretsPagedResponse listSecrets(ListSecretsRequest request) {
* Lists [Secrets][google.cloud.secrets.v1beta1.Secret].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * ListSecretsRequest request =
+ * ListSecretsRequest.newBuilder()
+ * .setParent(ProjectName.of("[PROJECT]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.listSecretsPagedCallable().futureCall(request);
+ * // Do something.
+ * for (Secret element : future.get().iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * while (true) {
+ * ListSecretsResponse response =
+ * secretManagerServiceClient.listSecretsCallable().call(request);
+ * for (Secret element : response.getResponsesList()) {
+ * // doThingsWith(element);
+ * }
+ * String nextPageToken = response.getNextPageToken();
+ * if (!Strings.isNullOrEmpty(nextPageToken)) {
+ * request = request.toBuilder().setPageToken(nextPageToken).build();
+ * } else {
+ * break;
+ * }
+ * }
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * ProjectName parent = ProjectName.of("[PROJECT]");
+ * String secretId = "secretId945974251";
+ * Secret secret = Secret.newBuilder().build();
+ * Secret response = secretManagerServiceClient.createSecret(parent, secretId, secret);
+ * }
+ * }
+ *
* @param parent Required. The resource name of the project to associate with the
* [Secret][google.cloud.secrets.v1beta1.Secret], in the format `projects/*`.
* @param secretId Required. This must be unique within the project.
@@ -250,6 +350,18 @@ public final Secret createSecret(ProjectName parent, String secretId, Secret sec
* Creates a new [Secret][google.cloud.secrets.v1beta1.Secret] containing no
* [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String parent = ProjectName.of("[PROJECT]").toString();
+ * String secretId = "secretId945974251";
+ * Secret secret = Secret.newBuilder().build();
+ * Secret response = secretManagerServiceClient.createSecret(parent, secretId, secret);
+ * }
+ * }
+ *
* @param parent Required. The resource name of the project to associate with the
* [Secret][google.cloud.secrets.v1beta1.Secret], in the format `projects/*`.
* @param secretId Required. This must be unique within the project.
@@ -275,6 +387,21 @@ public final Secret createSecret(String parent, String secretId, Secret secret)
* Creates a new [Secret][google.cloud.secrets.v1beta1.Secret] containing no
* [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * CreateSecretRequest request =
+ * CreateSecretRequest.newBuilder()
+ * .setParent(ProjectName.of("[PROJECT]").toString())
+ * .setSecretId("secretId945974251")
+ * .setSecret(Secret.newBuilder().build())
+ * .build();
+ * Secret response = secretManagerServiceClient.createSecret(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -288,6 +415,22 @@ public final Secret createSecret(CreateSecretRequest request) {
* [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * CreateSecretRequest request =
+ * CreateSecretRequest.newBuilder()
+ * .setParent(ProjectName.of("[PROJECT]").toString())
+ * .setSecretId("secretId945974251")
+ * .setSecret(Secret.newBuilder().build())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.createSecretCallable().futureCall(request);
+ * // Do something.
+ * Secret response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretName parent = SecretName.of("[PROJECT]", "[SECRET]");
+ * SecretPayload payload = SecretPayload.newBuilder().build();
+ * SecretVersion response = secretManagerServiceClient.addSecretVersion(parent, payload);
+ * }
+ * }
+ *
* @param parent Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret]
* to associate with the [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] in the
* format `projects/*/secrets/*`.
@@ -319,6 +473,17 @@ public final SecretVersion addSecretVersion(SecretName parent, SecretPayload pay
* Creates a new [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] containing secret
* data and attaches it to an existing [Secret][google.cloud.secrets.v1beta1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String parent = SecretName.of("[PROJECT]", "[SECRET]").toString();
+ * SecretPayload payload = SecretPayload.newBuilder().build();
+ * SecretVersion response = secretManagerServiceClient.addSecretVersion(parent, payload);
+ * }
+ * }
+ *
* @param parent Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret]
* to associate with the [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] in the
* format `projects/*/secrets/*`.
@@ -337,6 +502,20 @@ public final SecretVersion addSecretVersion(String parent, SecretPayload payload
* Creates a new [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] containing secret
* data and attaches it to an existing [Secret][google.cloud.secrets.v1beta1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * AddSecretVersionRequest request =
+ * AddSecretVersionRequest.newBuilder()
+ * .setParent(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .setPayload(SecretPayload.newBuilder().build())
+ * .build();
+ * SecretVersion response = secretManagerServiceClient.addSecretVersion(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -350,6 +529,21 @@ public final SecretVersion addSecretVersion(AddSecretVersionRequest request) {
* data and attaches it to an existing [Secret][google.cloud.secrets.v1beta1.Secret].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * AddSecretVersionRequest request =
+ * AddSecretVersionRequest.newBuilder()
+ * .setParent(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .setPayload(SecretPayload.newBuilder().build())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.addSecretVersionCallable().futureCall(request);
+ * // Do something.
+ * SecretVersion response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretName name = SecretName.of("[PROJECT]", "[SECRET]");
+ * Secret response = secretManagerServiceClient.getSecret(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret],
* in the format `projects/*/secrets/*`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -373,6 +577,16 @@ public final Secret getSecret(SecretName name) {
/**
* Gets metadata for a given [Secret][google.cloud.secrets.v1beta1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String name = SecretName.of("[PROJECT]", "[SECRET]").toString();
+ * Secret response = secretManagerServiceClient.getSecret(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret],
* in the format `projects/*/secrets/*`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -386,6 +600,19 @@ public final Secret getSecret(String name) {
/**
* Gets metadata for a given [Secret][google.cloud.secrets.v1beta1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * GetSecretRequest request =
+ * GetSecretRequest.newBuilder()
+ * .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .build();
+ * Secret response = secretManagerServiceClient.getSecret(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -398,6 +625,19 @@ public final Secret getSecret(GetSecretRequest request) {
* Gets metadata for a given [Secret][google.cloud.secrets.v1beta1.Secret].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * GetSecretRequest request =
+ * GetSecretRequest.newBuilder()
+ * .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .build();
+ * ApiFuture future = secretManagerServiceClient.getSecretCallable().futureCall(request);
+ * // Do something.
+ * Secret response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * Secret secret = Secret.newBuilder().build();
+ * FieldMask updateMask = FieldMask.newBuilder().build();
+ * Secret response = secretManagerServiceClient.updateSecret(secret, updateMask);
+ * }
+ * }
+ *
* @param secret Required. [Secret][google.cloud.secrets.v1beta1.Secret] with updated field
* values.
* @param updateMask Required. Specifies the fields to be updated.
@@ -422,6 +673,20 @@ public final Secret updateSecret(Secret secret, FieldMask updateMask) {
/**
* Updates metadata of an existing [Secret][google.cloud.secrets.v1beta1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * UpdateSecretRequest request =
+ * UpdateSecretRequest.newBuilder()
+ * .setSecret(Secret.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .build();
+ * Secret response = secretManagerServiceClient.updateSecret(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -434,6 +699,21 @@ public final Secret updateSecret(UpdateSecretRequest request) {
* Updates metadata of an existing [Secret][google.cloud.secrets.v1beta1.Secret].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * UpdateSecretRequest request =
+ * UpdateSecretRequest.newBuilder()
+ * .setSecret(Secret.newBuilder().build())
+ * .setUpdateMask(FieldMask.newBuilder().build())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.updateSecretCallable().futureCall(request);
+ * // Do something.
+ * Secret response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretName name = SecretName.of("[PROJECT]", "[SECRET]");
+ * secretManagerServiceClient.deleteSecret(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret] to
* delete in the format `projects/*/secrets/*`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -457,6 +747,16 @@ public final void deleteSecret(SecretName name) {
/**
* Deletes a [Secret][google.cloud.secrets.v1beta1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String name = SecretName.of("[PROJECT]", "[SECRET]").toString();
+ * secretManagerServiceClient.deleteSecret(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret] to
* delete in the format `projects/*/secrets/*`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -470,6 +770,19 @@ public final void deleteSecret(String name) {
/**
* Deletes a [Secret][google.cloud.secrets.v1beta1.Secret].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * DeleteSecretRequest request =
+ * DeleteSecretRequest.newBuilder()
+ * .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .build();
+ * secretManagerServiceClient.deleteSecret(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -482,6 +795,20 @@ public final void deleteSecret(DeleteSecretRequest request) {
* Deletes a [Secret][google.cloud.secrets.v1beta1.Secret].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * DeleteSecretRequest request =
+ * DeleteSecretRequest.newBuilder()
+ * .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.deleteSecretCallable().futureCall(request);
+ * // Do something.
+ * future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretName parent = SecretName.of("[PROJECT]", "[SECRET]");
+ * for (SecretVersion element :
+ * secretManagerServiceClient.listSecretVersions(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
* @param parent Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret]
* associated with the [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion] to list,
* in the format `projects/*/secrets/*`.
@@ -510,6 +850,19 @@ public final ListSecretVersionsPagedResponse listSecretVersions(SecretName paren
* Lists [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion]. This call does not return
* secret data.
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String parent = SecretName.of("[PROJECT]", "[SECRET]").toString();
+ * for (SecretVersion element :
+ * secretManagerServiceClient.listSecretVersions(parent).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
* @param parent Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret]
* associated with the [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion] to list,
* in the format `projects/*/secrets/*`.
@@ -526,6 +879,24 @@ public final ListSecretVersionsPagedResponse listSecretVersions(String parent) {
* Lists [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion]. This call does not return
* secret data.
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * ListSecretVersionsRequest request =
+ * ListSecretVersionsRequest.newBuilder()
+ * .setParent(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * for (SecretVersion element :
+ * secretManagerServiceClient.listSecretVersions(request).iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -540,6 +911,24 @@ public final ListSecretVersionsPagedResponse listSecretVersions(
* secret data.
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * ListSecretVersionsRequest request =
+ * ListSecretVersionsRequest.newBuilder()
+ * .setParent(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .setPageSize(883849137)
+ * .setPageToken("pageToken873572522")
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.listSecretVersionsPagedCallable().futureCall(request);
+ * // Do something.
+ * for (SecretVersion element : future.get().iterateAll()) {
+ * // doThingsWith(element);
+ * }
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * while (true) {
+ * ListSecretVersionsResponse response =
+ * secretManagerServiceClient.listSecretVersionsCallable().call(request);
+ * for (SecretVersion element : response.getResponsesList()) {
+ * // doThingsWith(element);
+ * }
+ * String nextPageToken = response.getNextPageToken();
+ * if (!Strings.isNullOrEmpty(nextPageToken)) {
+ * request = request.toBuilder().setPageToken(nextPageToken).build();
+ * } else {
+ * break;
+ * }
+ * }
+ * }
+ * }
*/
public final UnaryCallable`projects/*/secrets/*/versions/latest` is an alias to the `latest` * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion]. * + *
Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+ * SecretVersion response = secretManagerServiceClient.getSecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] in the format
* `projects/*/secrets/*/versions/*`.
@@ -585,6 +1003,16 @@ public final SecretVersion getSecretVersion(SecretVersionName name) {
* `projects/*/secrets/*/versions/latest` is an alias to the `latest` * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion]. * + *
Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+ * SecretVersion response = secretManagerServiceClient.getSecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] in the format
* `projects/*/secrets/*/versions/*`.
@@ -604,6 +1032,19 @@ public final SecretVersion getSecretVersion(String name) {
* `projects/*/secrets/*/versions/latest` is an alias to the `latest` * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion]. * + *
Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * GetSecretVersionRequest request =
+ * GetSecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * SecretVersion response = secretManagerServiceClient.getSecretVersion(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -619,6 +1060,20 @@ public final SecretVersion getSecretVersion(GetSecretVersionRequest request) {
* [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * GetSecretVersionRequest request =
+ * GetSecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.getSecretVersionCallable().futureCall(request);
+ * // Do something.
+ * SecretVersion response = future.get();
+ * }
+ * }
*/
public final UnaryCallable`projects/*/secrets/*/versions/latest` is an alias to the `latest` * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion]. * + *
Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+ * AccessSecretVersionResponse response = secretManagerServiceClient.accessSecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] in the format
* `projects/*/secrets/*/versions/*`.
@@ -653,6 +1118,16 @@ public final AccessSecretVersionResponse accessSecretVersion(SecretVersionName n
* `projects/*/secrets/*/versions/latest` is an alias to the `latest` * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion]. * + *
Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+ * AccessSecretVersionResponse response = secretManagerServiceClient.accessSecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] in the format
* `projects/*/secrets/*/versions/*`.
@@ -672,6 +1147,20 @@ public final AccessSecretVersionResponse accessSecretVersion(String name) {
* `projects/*/secrets/*/versions/latest` is an alias to the `latest` * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion]. * + *
Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * AccessSecretVersionRequest request =
+ * AccessSecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * AccessSecretVersionResponse response =
+ * secretManagerServiceClient.accessSecretVersion(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -688,6 +1177,20 @@ public final AccessSecretVersionResponse accessSecretVersion(AccessSecretVersion
* [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * AccessSecretVersionRequest request =
+ * AccessSecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.accessSecretVersionCallable().futureCall(request);
+ * // Do something.
+ * AccessSecretVersionResponse response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+ * SecretVersion response = secretManagerServiceClient.disableSecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to disable in the format
* `projects/*/secrets/*/versions/*`.
@@ -723,6 +1236,16 @@ public final SecretVersion disableSecretVersion(SecretVersionName name) {
* [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to
* [DISABLED][google.cloud.secrets.v1beta1.SecretVersion.State.DISABLED].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+ * SecretVersion response = secretManagerServiceClient.disableSecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to disable in the format
* `projects/*/secrets/*/versions/*`.
@@ -742,6 +1265,19 @@ public final SecretVersion disableSecretVersion(String name) {
* [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to
* [DISABLED][google.cloud.secrets.v1beta1.SecretVersion.State.DISABLED].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * DisableSecretVersionRequest request =
+ * DisableSecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * SecretVersion response = secretManagerServiceClient.disableSecretVersion(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -758,6 +1294,20 @@ public final SecretVersion disableSecretVersion(DisableSecretVersionRequest requ
* [DISABLED][google.cloud.secrets.v1beta1.SecretVersion.State.DISABLED].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * DisableSecretVersionRequest request =
+ * DisableSecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.disableSecretVersionCallable().futureCall(request);
+ * // Do something.
+ * SecretVersion response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+ * SecretVersion response = secretManagerServiceClient.enableSecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to enable in the format
* `projects/*/secrets/*/versions/*`.
@@ -793,6 +1353,16 @@ public final SecretVersion enableSecretVersion(SecretVersionName name) {
* [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to
* [ENABLED][google.cloud.secrets.v1beta1.SecretVersion.State.ENABLED].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+ * SecretVersion response = secretManagerServiceClient.enableSecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to enable in the format
* `projects/*/secrets/*/versions/*`.
@@ -812,6 +1382,19 @@ public final SecretVersion enableSecretVersion(String name) {
* [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to
* [ENABLED][google.cloud.secrets.v1beta1.SecretVersion.State.ENABLED].
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * EnableSecretVersionRequest request =
+ * EnableSecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * SecretVersion response = secretManagerServiceClient.enableSecretVersion(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -828,6 +1411,20 @@ public final SecretVersion enableSecretVersion(EnableSecretVersionRequest reques
* [ENABLED][google.cloud.secrets.v1beta1.SecretVersion.State.ENABLED].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * EnableSecretVersionRequest request =
+ * EnableSecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.enableSecretVersionCallable().futureCall(request);
+ * // Do something.
+ * SecretVersion response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+ * SecretVersion response = secretManagerServiceClient.destroySecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to destroy in the format
* `projects/*/secrets/*/versions/*`.
@@ -865,6 +1472,16 @@ public final SecretVersion destroySecretVersion(SecretVersionName name) {
* [DESTROYED][google.cloud.secrets.v1beta1.SecretVersion.State.DESTROYED] and irrevocably
* destroys the secret data.
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+ * SecretVersion response = secretManagerServiceClient.destroySecretVersion(name);
+ * }
+ * }
+ *
* @param name Required. The resource name of the
* [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to destroy in the format
* `projects/*/secrets/*/versions/*`.
@@ -885,6 +1502,19 @@ public final SecretVersion destroySecretVersion(String name) {
* [DESTROYED][google.cloud.secrets.v1beta1.SecretVersion.State.DESTROYED] and irrevocably
* destroys the secret data.
*
+ * Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * DestroySecretVersionRequest request =
+ * DestroySecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * SecretVersion response = secretManagerServiceClient.destroySecretVersion(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -902,6 +1532,20 @@ public final SecretVersion destroySecretVersion(DestroySecretVersionRequest requ
* destroys the secret data.
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * DestroySecretVersionRequest request =
+ * DestroySecretVersionRequest.newBuilder()
+ * .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.destroySecretVersionCallable().futureCall(request);
+ * // Do something.
+ * SecretVersion response = future.get();
+ * }
+ * }
*/
public final UnaryCallablePermissions on [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion] are enforced * according to the policy set on the associated [Secret][google.cloud.secrets.v1beta1.Secret]. * + *
Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SetIamPolicyRequest request =
+ * SetIamPolicyRequest.newBuilder()
+ * .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .setPolicy(Policy.newBuilder().build())
+ * .build();
+ * Policy response = secretManagerServiceClient.setIamPolicy(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -930,6 +1588,21 @@ public final Policy setIamPolicy(SetIamPolicyRequest request) {
* according to the policy set on the associated [Secret][google.cloud.secrets.v1beta1.Secret].
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * SetIamPolicyRequest request =
+ * SetIamPolicyRequest.newBuilder()
+ * .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .setPolicy(Policy.newBuilder().build())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.setIamPolicyCallable().futureCall(request);
+ * // Do something.
+ * Policy response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * GetIamPolicyRequest request =
+ * GetIamPolicyRequest.newBuilder()
+ * .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .setOptions(GetPolicyOptions.newBuilder().build())
+ * .build();
+ * Policy response = secretManagerServiceClient.getIamPolicy(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -953,6 +1640,21 @@ public final Policy getIamPolicy(GetIamPolicyRequest request) {
* not have a policy set.
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * GetIamPolicyRequest request =
+ * GetIamPolicyRequest.newBuilder()
+ * .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .setOptions(GetPolicyOptions.newBuilder().build())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.getIamPolicyCallable().futureCall(request);
+ * // Do something.
+ * Policy response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * TestIamPermissionsRequest request =
+ * TestIamPermissionsRequest.newBuilder()
+ * .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .addAllPermissions(new ArrayList())
+ * .build();
+ * TestIamPermissionsResponse response = secretManagerServiceClient.testIamPermissions(request);
+ * }
+ * }
+ *
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -984,6 +1700,21 @@ public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsReq
* warning.
*
* Sample code: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * TestIamPermissionsRequest request =
+ * TestIamPermissionsRequest.newBuilder()
+ * .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+ * .addAllPermissions(new ArrayList())
+ * .build();
+ * ApiFuture future =
+ * secretManagerServiceClient.testIamPermissionsCallable().futureCall(request);
+ * // Do something.
+ * TestIamPermissionsResponse response = future.get();
+ * }
+ * }
*/
public final UnaryCallableSample for SecretManagerServiceClient: + * + *
{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ * SecretManagerServiceClient.create()) {
+ * ProjectName parent = ProjectName.of("[PROJECT]");
+ * String secretId = "secretId945974251";
+ * Secret secret = Secret.newBuilder().build();
+ * Secret response = secretManagerServiceClient.createSecret(parent, secretId, secret);
+ * }
+ * }
*/
@Generated("by gapic-generator-java")
package com.google.cloud.secretmanager.v1beta1;
diff --git a/synth.metadata b/synth.metadata
index 202af4b7..1e981ae2 100644
--- a/synth.metadata
+++ b/synth.metadata
@@ -4,15 +4,15 @@
"git": {
"name": ".",
"remote": "https://github.com/googleapis/java-secretmanager.git",
- "sha": "5822b254a545c0316241b7142fa551ff266daa0b"
+ "sha": "77ecec01eb733b0b1871591dade7743d9f35bb29"
}
},
{
"git": {
"name": "googleapis",
"remote": "https://github.com/googleapis/googleapis.git",
- "sha": "9ecdacc9a00e1dd443b11bf10215d6e7648db8a7",
- "internalRef": "352563582"
+ "sha": "8d8c008e56f1af31d57f75561e0f1848ffb29eeb",
+ "internalRef": "356341083"
}
},
{