feat(secretmanager): Adding labels and annotations sample

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

@@ -0,0 +1,63 @@
+/*
+ * Copyright 2026 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 System.IO;
+using Xunit;
+
+[Collection(nameof(RegionalSecretManagerFixture))]
+public class DeleteRegionalSecretAnnotationTests
+{
+    private readonly RegionalSecretManagerFixture _fixture;
+    private readonly DeleteRegionalSecretAnnotationSample _sample;
+
+    public DeleteRegionalSecretAnnotationTests(RegionalSecretManagerFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new DeleteRegionalSecretAnnotationSample();
+    }
+
+    [Fact]
+    public void DeleteRegionalSecretAnnotation()
+    {
+        // Create a secret with annotations
+        Secret secret = _fixture.CreateSecret(_fixture.RandomId());
+        SecretName secretName = secret.SecretName;
+        try
+        {
+            // Get a key from the existing annotations
+            string annotationKey = _fixture.AnnotationKey;
+
+            // Verify the secret has annotations
+            Assert.NotEmpty(secret.Annotations);
+            Assert.True(secret.Annotations.ContainsKey(annotationKey));
+
+            // Run the sample code to delete the annotation
+            Secret result = _sample.DeleteRegionalSecretAnnotation(
+                projectId: secretName.ProjectId,
+                locationId: secretName.LocationId,
+                secretId: secretName.SecretId);
+
+            Assert.Empty(result.Annotations);
+        }
+        finally
+        {
+            // Clean the created secret.
+            _fixture.DeleteSecret(secretName);
+        }
+    }
+}

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

@@ -0,0 +1,59 @@
+/*
+ * Copyright 2026 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 System.IO;
+using Xunit;
+
+[Collection(nameof(RegionalSecretManagerFixture))]
+public class DeleteRegionalSecretLabelTests
+{
+    private readonly RegionalSecretManagerFixture _fixture;
+    private readonly DeleteRegionalSecretLabelSample _sample;
+
+    public DeleteRegionalSecretLabelTests(RegionalSecretManagerFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new DeleteRegionalSecretLabelSample();
+    }
+
+    [Fact]
+    public void DeleteRegionalSecretLabel()
+    {
+        Secret secret = _fixture.CreateSecret(_fixture.RandomId());
+        SecretName secretName = secret.SecretName;
+        try
+        {
+            // Verify the secret has labels
+            Assert.NotEmpty(secret.Labels);
+
+            // Run the sample code to delete all labels
+            Secret result = _sample.DeleteRegionalSecretLabel(
+
+                projectId: secretName.ProjectId,
+                locationId: secretName.LocationId,
+                secretId: secretName.SecretId);
+
+            Assert.Empty(result.Labels);
+        }
+        finally
+        {
+            // Clean the created secret.
+            _fixture.DeleteSecret(secretName);
+        }
+    }
+}

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

@@ -0,0 +1,57 @@
+/*
+ * Copyright 2026 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 System.IO;
+using Xunit;
+
+[Collection(nameof(SecretManagerFixture))]
+public class DeleteSecretAnnotationTests
+{
+    private readonly SecretManagerFixture _fixture;
+    private readonly DeleteSecretAnnotationSample _sample;
+
+    public DeleteSecretAnnotationTests(SecretManagerFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new DeleteSecretAnnotationSample();
+    }
+
+    [Fact]
+    public void DeleteSecretAnnotation()
+    {
+        // Create the secret.
+        Secret secret = _fixture.CreateSecret(_fixture.RandomId());
+        // Get the secretName from the created secret.
+        SecretName secretName = secret.SecretName;
+        try
+        {
+            Assert.NotEmpty(secret.Annotations);
+            // Call the code sample function to delete the annotations
+            Secret result = _sample.DeleteSecretAnnotation(
+              projectId: secretName.ProjectId, secretId: secretName.SecretId);
+
+            // Assert that the label is deleted.
+            Assert.Empty(result.Annotations);
+        }
+        finally
+        {
+            // Clean the created secret.
+            _fixture.DeleteSecret(secretName);
+        }
+    }
+}

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

@@ -0,0 +1,58 @@
+/*
+ * Copyright 2026 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 System.IO;
+using Xunit;
+
+[Collection(nameof(SecretManagerFixture))]
+public class DeleteSecretLabelTests
+{
+    private readonly SecretManagerFixture _fixture;
+    private readonly DeleteSecretLabelSample _sample;
+
+    public DeleteSecretLabelTests(SecretManagerFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new DeleteSecretLabelSample();
+    }
+
+    [Fact]
+    public void DeleteSecretLabel()
+    {
+        // Create the secret.
+        Secret secret = _fixture.CreateSecret(_fixture.RandomId());
+
+        // Get the secretName from the created secret.
+        SecretName secretName = secret.SecretName;
+        try
+        {
+            Assert.NotEmpty(secret.Labels);
+            // Call the code sample function to delete the label
+            Secret result = _sample.DeleteSecretLabel(
+              projectId: secretName.ProjectId, secretId: secretName.SecretId);
+
+            // Assert that the label is deleted.
+            Assert.Empty(result.Labels);
+        }
+        finally
+        {
+            // Clean the created secret.
+            _fixture.DeleteSecret(secretName);
+        }
+    }
+}

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

@@ -0,0 +1,46 @@
+/*
+ * Copyright 2026 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 System.IO;
+using Xunit;
+
+[Collection(nameof(SecretManagerFixture))]
+public class EditSecretLabelTests
+{
+    private readonly SecretManagerFixture _fixture;
+    private readonly EditSecretLabelSample _sample;
+
+    public EditSecretLabelTests(SecretManagerFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new EditSecretLabelSample();
+    }
+
+    [Fact]
+    public void EditSecretLabel()
+    {
+        // Get the SecretName to create Secret.
+        SecretName secretName = _fixture.Secret.SecretName;
+
+        // Call the code sample function.
+        Secret result = _sample.EditSecretLabel(
+          projectId: secretName.ProjectId, secretId: secretName.SecretId);
+
+        Assert.Equal("my-label-value", result.Labels["my-label-key"]);
+    }
+}

secretmanager/api/SecretManager.Samples/DeleteRegionalSecretAnnotation.cs

@@ -0,0 +1,56 @@
+/*
+ * Copyright 2026 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.
+ */
+
+// [START secretmanager_delete_regional_secret_annotation]
+
+using Google.Cloud.SecretManager.V1;
+using Google.Protobuf.WellKnownTypes;
+using System;
+
+public class DeleteRegionalSecretAnnotationSample
+{
+    public Secret DeleteRegionalSecretAnnotation(
+        string projectId = "my-project",
+        string locationId = "my-location",
+        string secretId = "my-secret")
+    {
+        // Create the Regional Secret Manager Client.
+        SecretManagerServiceClient client = new SecretManagerServiceClientBuilder
+        {
+            Endpoint = $"secretmanager.{locationId}.rep.googleapis.com"
+        }.Build();
+
+        // Build the resource name of the secret.
+        SecretName secretName = SecretName.FromProjectLocationSecret(projectId, locationId, secretId);
+
+        // Get the secret.
+        Secret secret = client.GetSecret(secretName);
+
+        // Delete the annotation
+        secret.Annotations.Clear();
+
+        // Build the field mask.
+        FieldMask updateMask = FieldMask.FromString("annotations");
+
+        // Update the secret.
+        Secret updatedSecret = client.UpdateSecret(secret, updateMask);
+
+        // Print the new secret name.
+        Console.WriteLine($"Updated secret: {updatedSecret.Name}");
+        return updatedSecret;
+    }
+}
+// [END secretmanager_delete_regional_secret_annotation]