chore: Add SecretManager service regional code samples (#2880)

Author: YashSaraf11

secretmanager/api/SecretManager.Samples.Tests/AccessRegionalSecretVersionTests.cs

@@ -0,0 +1,49 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+using Google.Cloud.SecretManager.V1;
+using Xunit;
+
+[Collection(nameof(RegionalSecretManagerFixture))]
+public class AccessRegionalSecretVersionTests
+{
+    private readonly RegionalSecretManagerFixture _fixture;
+    private readonly AccessRegionalSecretVersionSample _sample;
+
+    public AccessRegionalSecretVersionTests(RegionalSecretManagerFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new AccessRegionalSecretVersionSample();
+    }
+
+    [Fact]
+    public void AccessRegionalSecretVersion()
+    {
+        // Get the secret version name.
+        SecretVersionName secretVersionName = _fixture.SecretVersion.SecretVersionName;
+
+        // Run the code sample.
+        string result = _sample.AccessRegionalSecretVersion(
+          projectId: secretVersionName.ProjectId,
+          locationId: secretVersionName.LocationId,
+          secretId: secretVersionName.SecretId,
+          secretVersionId: secretVersionName.SecretVersionId
+        );
+
+        // Assert that the secret was created with the correct value.
+        Assert.Equal("my super secret data", result);
+    }
+}

secretmanager/api/SecretManager.Samples.Tests/AddRegionalSecretVersionTests.cs

@@ -0,0 +1,56 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+using Google.Cloud.SecretManager.V1;
+using Xunit;
+
+[Collection(nameof(RegionalSecretManagerFixture))]
+public class AddRegionalSecretVersionTests
+{
+    private readonly RegionalSecretManagerFixture _fixture;
+    private readonly AddRegionalSecretVersionSample _sample;
+
+    public AddRegionalSecretVersionTests(RegionalSecretManagerFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new AddRegionalSecretVersionSample();
+    }
+
+    [Fact]
+    public void AddsRegionalSecretVersions()
+    {
+        string data = "my secret data";
+
+        // Create the secret and add secret version.
+        Secret secret = _fixture.CreateSecret(_fixture.RandomId());
+        SecretName secretName = secret.SecretName;
+        SecretVersion secretVersion = _sample.AddRegionalSecretVersion(
+          projectId: secretName.ProjectId,
+          locationId: secretName.LocationId,
+          secretId: secretName.SecretId,
+          data: data
+        );
+
+        // Access the secret version.
+        AccessSecretVersionResponse result = _fixture.Client.AccessSecretVersion(secretVersion.SecretVersionName);
+
+        // Assert that the secret version was added with the correct data.
+        Assert.Equal(data, result.Payload.Data.ToStringUtf8());
+
+        // Clean the created secret.
+        _fixture.DeleteSecret(secret.SecretName);
+    }
+}

secretmanager/api/SecretManager.Samples.Tests/CreateRegionalSecretTests.cs

@@ -0,0 +1,49 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+using Google.Cloud.SecretManager.V1;
+using System;
+using Xunit;
+
+[Collection(nameof(RegionalSecretManagerFixture))]
+public class CreateRegionalSecretTests
+{
+    private readonly RegionalSecretManagerFixture _fixture;
+    private readonly CreateRegionalSecretSample _sample;
+
+    public CreateRegionalSecretTests(RegionalSecretManagerFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new CreateRegionalSecretSample();
+    }
+
+    [Fact]
+    public void CreatesRegionalSecrets()
+    {
+        // Get the SecretName from the set ProjectId & LocationId.
+        SecretName secretName = SecretName.FromProjectLocationSecret(_fixture.ProjectId, _fixture.LocationId, _fixture.RandomId());
+
+        // Run the sample code.
+        Secret result = _sample.CreateRegionalSecret(
+          projectId: secretName.ProjectId, locationId: secretName.LocationId, secretId: secretName.SecretId);
+
+        // Assert that the secret was created with the correct secretId.
+        Assert.Equal(result.SecretName.SecretId, secretName.SecretId);
+
+        // Clean the created secret.
+        _fixture.DeleteSecret(secretName);
+    }
+}

secretmanager/api/SecretManager.Samples.Tests/CreateRegionalSecretWithAnnotationsTests.cs

@@ -0,0 +1,57 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+using Google.Cloud.SecretManager.V1;
+using System;
+using Xunit;
+
+
+[Collection(nameof(RegionalSecretManagerFixture))]
+public class CreateRegionalSecretWithAnnotationsTests
+{
+    private readonly RegionalSecretManagerFixture _fixture;
+    private readonly CreateRegionalSecretWithAnnotationsSample _sample;
+
+    public CreateRegionalSecretWithAnnotationsTests(RegionalSecretManagerFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new CreateRegionalSecretWithAnnotationsSample();
+    }
+
+    [Fact]
+    public void CreatesRegionalSecretsWithAnnotations()
+    {
+        // Get the SecretName from the set ProjectId & LocationId.
+        SecretName secretName = SecretName.FromProjectLocationSecret(_fixture.ProjectId, _fixture.LocationId, _fixture.RandomId());
+
+        // Get the annotation key & value from the fixture class.
+        string annotationKey = _fixture.AnnotationKey;
+        string annotationValue = _fixture.AnnotationValue;
+
+        // Run the code sample.
+        Secret result = _sample.CreateRegionalSecretWithAnnotations(
+          projectId: secretName.ProjectId, locationId: secretName.LocationId, secretId: secretName.SecretId, annotationKey: annotationKey, annotationValue: annotationValue);
+
+        // Assert that the secretId is same as expected.
+        Assert.Equal(result.SecretName.SecretId, secretName.SecretId);
+
+        // Assert that the annotation values matches with the expected value.
+        Assert.Equal(result.Annotations[annotationKey], annotationValue);
+
+        // Clean the created secret.
+        _fixture.DeleteSecret(secretName);
+    }
+}

secretmanager/api/SecretManager.Samples.Tests/CreateRegionalSecretWithLabelsTests.cs

@@ -0,0 +1,57 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+using Google.Cloud.SecretManager.V1;
+using System;
+using Xunit;
+
+
+[Collection(nameof(RegionalSecretManagerFixture))]
+public class CreateRegionalSecretWithLabelsTests
+{
+    private readonly RegionalSecretManagerFixture _fixture;
+    private readonly CreateRegionalSecretWithLabelsSample _sample;
+
+    public CreateRegionalSecretWithLabelsTests(RegionalSecretManagerFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new CreateRegionalSecretWithLabelsSample();
+    }
+
+    [Fact]
+    public void CreatesRegionalSecretsWithLabels()
+    {
+        // Get the SecretName from the set ProjectId & LocationId.
+        SecretName secretName = SecretName.FromProjectLocationSecret(_fixture.ProjectId, _fixture.LocationId, _fixture.RandomId());
+
+        // Get the label value and key and from fixture class.
+        string labelKey = _fixture.AnnotationKey;
+        string labelValue = _fixture.AnnotationValue;
+
+        // Run the code sample.
+        Secret result = _sample.CreateRegionalSecretWithLabels(
+          projectId: secretName.ProjectId, locationId: secretName.LocationId, secretId: secretName.SecretId, labelKey: labelKey, labelValue: labelValue);
+
+        // Assert that the secretId is equal to the expected value.
+        Assert.Equal(result.SecretName.SecretId, secretName.SecretId);
+
+        // Assert that the label value matches with the expected value.
+        Assert.Equal(result.Labels[labelKey], labelValue);
+
+        // Clean the created secret.
+        _fixture.DeleteSecret(secretName);
+    }
+}

secretmanager/api/SecretManager.Samples.Tests/DeleteRegionalSecretTests.cs

@@ -0,0 +1,51 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+using Google.Cloud.SecretManager.V1;
+using Xunit;
+
+[Collection(nameof(RegionalSecretManagerFixture))]
+public class DeleteRegionalSecretTests
+{
+    private readonly RegionalSecretManagerFixture _fixture;
+    private readonly DeleteRegionalSecretSample _sample;
+
+    public DeleteRegionalSecretTests(RegionalSecretManagerFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new DeleteRegionalSecretSample();
+    }
+
+    [Fact]
+    public void DeletesRegionalSecrets()
+    {
+        // Create the secret.
+        Secret secret = _fixture.CreateSecret(_fixture.RandomId());
+
+        // Get the secretName from the created secret.
+        SecretName secretName = secret.SecretName;
+
+        // Run the sample.
+        _sample.DeleteRegionalSecret(
+          projectId: secretName.ProjectId,
+          locationId: secretName.LocationId,
+          secretId: secretName.SecretId
+        );
+
+        // Assert that the secret was deleted.
+        Assert.Throws<Grpc.Core.RpcException>(() => _fixture.Client.GetSecret(secretName));
+    }
+}

secretmanager/api/SecretManager.Samples.Tests/DeleteRegionalSecretWithEtagTests.cs

@@ -0,0 +1,58 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+using Google.Cloud.SecretManager.V1;
+using Xunit;
+
+[Collection(nameof(RegionalSecretManagerFixture))]
+public class DeleteRegionalSecretWithEtagTests
+{
+    private readonly RegionalSecretManagerFixture _fixture;
+    private readonly DeleteRegionalSecretWithEtagSample _sample;
+
+    public DeleteRegionalSecretWithEtagTests(RegionalSecretManagerFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new DeleteRegionalSecretWithEtagSample();
+    }
+
+    [Fact]
+    public void DeletesRegionalSecretsWithEtag()
+    {
+        // Create the secret.
+        Secret secret = _fixture.CreateSecret(_fixture.RandomId());
+
+        // Get the secret name.
+        SecretName secretName = secret.SecretName;
+
+        // Get the secret from the cloud.
+        Secret secretFetched = _fixture.Client.GetSecret(secretName);
+
+        // Set the updated etag fetched.
+        string updatedEtag = secretFetched.Etag;
+
+        // Run the sample to delete the secret with etag.
+        _sample.DeleteRegionalSecretWithEtag(
+          projectId: secretName.ProjectId,
+          locationId: secretName.LocationId,
+          secretId: secretName.SecretId,
+          etag: updatedEtag
+        );
+
+        // Assert that the secret was deleted and not found.
+        Assert.Throws<Grpc.Core.RpcException>(() => _fixture.Client.GetSecret(secretName));
+    }
+}