feat: add kernel_rootkit field to finding's list of attributes

docs: miscellaneous style improvements

PiperOrigin-RevId: 493119809

Source-Link: googleapis/googleapis@6aff678

Source-Link: googleapis/googleapis-gen@ee52194
Copy-Tag: eyJwIjoiYXBpcy9Hb29nbGUuQ2xvdWQuU2VjdXJpdHlDZW50ZXIuVjEvLk93bEJvdC55YW1sIiwiaCI6ImVlNTIxOTQwYTAxN2YzOTNmY2U3NzMxZTRjMjJhNDNhZmY2YjAwMGUifQ==

apis/Google.Cloud.SecurityCenter.V1/Google.Cloud.SecurityCenter.V1/ExternalSystem.g.cs

@@ -109,11 +109,10 @@ public sealed partial class ExternalSystem : pb::IMessage<ExternalSystem>
     public const int NameFieldNumber = 1;
     private string name_ = "";
     /// <summary>
-    /// External System Name e.g. jira, demisto, etc.
-    ///  e.g.:
-    ///  `organizations/1234/sources/5678/findings/123456/externalSystems/jira`
-    /// `folders/1234/sources/5678/findings/123456/externalSystems/jira`
-    /// `projects/1234/sources/5678/findings/123456/externalSystems/jira`
+    /// Full resource name of the external system, for example:
+    /// "organizations/1234/sources/5678/findings/123456/externalSystems/jira",
+    /// "folders/1234/sources/5678/findings/123456/externalSystems/jira",
+    /// "projects/1234/sources/5678/findings/123456/externalSystems/jira"
     /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     [global::System.CodeDom.Compiler.GeneratedCode("protoc", null)]

apis/Google.Cloud.SecurityCenter.V1/Google.Cloud.SecurityCenter.V1/NotificationConfig.g.cs

@@ -123,7 +123,9 @@ public sealed partial class NotificationConfig : pb::IMessage<NotificationConfig
     /// The relative resource name of this notification config. See:
     /// https://cloud.google.com/apis/design/resource_names#relative_resource_name
     /// Example:
-    /// "organizations/{organization_id}/notificationConfigs/notify_public_bucket".
+    /// "organizations/{organization_id}/notificationConfigs/notify_public_bucket",
+    /// "folders/{folder_id}/notificationConfigs/notify_public_bucket",
+    /// or "projects/{project_id}/notificationConfigs/notify_public_bucket".
     /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     [global::System.CodeDom.Compiler.GeneratedCode("protoc", null)]

apis/Google.Cloud.SecurityCenter.V1/Google.Cloud.SecurityCenter.V1/PackageApiMetadata.g.cs

@@ -28,6 +28,7 @@ internal static class PackageApiMetadata
     {
         /// <summary>The <see cref="gaxgrpc::ApiMetadata"/> for services in this package.</summary>
         internal static gaxgrpc::ApiMetadata ApiMetadata { get; } = new gaxgrpc::ApiMetadata("Google.Cloud.SecurityCenter.V1", GetFileDescriptors)
+            .WithRequestNumericEnumJsonEncoding(true)
             .WithHttpRuleOverrides(new scg::Dictionary<string, proto::ByteString>
             {
                 {
@@ -69,6 +70,7 @@ internal static class PackageApiMetadata
             yield return FolderReflection.Descriptor;
             yield return IamBindingReflection.Descriptor;
             yield return IndicatorReflection.Descriptor;
+            yield return KernelRootkitReflection.Descriptor;
             yield return KubernetesReflection.Descriptor;
             yield return LabelReflection.Descriptor;
             yield return MitreAttackReflection.Descriptor;

apis/Google.Cloud.SecurityCenter.V1/Google.Cloud.SecurityCenter.V1/SecuritycenterService.g.cs

@@ -1620,8 +1620,8 @@ public sealed partial class CreateNotificationConfigRequest : pb::IMessage<Creat
     /// <summary>
     /// Required.
     /// Unique identifier provided by the client within the parent scope.
-    /// It must be between 1 and 128 characters, and contains alphanumeric
-    /// characters, underscores or hyphens only.
+    /// It must be between 1 and 128 characters and contain alphanumeric
+    /// characters, underscores, or hyphens only.
     /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     [global::System.CodeDom.Compiler.GeneratedCode("protoc", null)]
@@ -2335,7 +2335,9 @@ public sealed partial class DeleteNotificationConfigRequest : pb::IMessage<Delet
     private string name_ = "";
     /// <summary>
     /// Required. Name of the notification config to delete. Its format is
-    /// "organizations/[organization_id]/notificationConfigs/[config_id]".
+    /// "organizations/[organization_id]/notificationConfigs/[config_id]",
+    /// "folders/[folder_id]/notificationConfigs/[config_id]",
+    /// or "projects/[project_id]/notificationConfigs/[config_id]".
     /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     [global::System.CodeDom.Compiler.GeneratedCode("protoc", null)]
@@ -2480,7 +2482,7 @@ public sealed partial class DeleteNotificationConfigRequest : pb::IMessage<Delet
   }
 
   /// <summary>
-  /// Request message for retrieving a big query export.
+  /// Request message for retrieving a BigQuery export.
   /// </summary>
   public sealed partial class GetBigQueryExportRequest : pb::IMessage<GetBigQueryExportRequest>
   #if !GOOGLE_PROTOBUF_REFSTRUCT_COMPATIBILITY_MODE
@@ -2530,7 +2532,7 @@ public sealed partial class GetBigQueryExportRequest : pb::IMessage<GetBigQueryE
     public const int NameFieldNumber = 1;
     private string name_ = "";
     /// <summary>
-    /// Required. Name of the big query export to retrieve. Its format is
+    /// Required. Name of the BigQuery export to retrieve. Its format is
     /// organizations/{organization}/bigQueryExports/{export_id},
     /// folders/{folder}/bigQueryExports/{export_id}, or
     /// projects/{project}/bigQueryExports/{export_id}
@@ -2927,7 +2929,9 @@ public sealed partial class GetNotificationConfigRequest : pb::IMessage<GetNotif
     private string name_ = "";
     /// <summary>
     /// Required. Name of the notification config to get. Its format is
-    /// "organizations/[organization_id]/notificationConfigs/[config_id]".
+    /// "organizations/[organization_id]/notificationConfigs/[config_id]",
+    /// "folders/[folder_id]/notificationConfigs/[config_id]",
+    /// or "projects/[project_id]/notificationConfigs/[config_id]".
     /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     [global::System.CodeDom.Compiler.GeneratedCode("protoc", null)]
@@ -3520,7 +3524,7 @@ public sealed partial class GroupAssetsRequest : pb::IMessage<GroupAssetsRequest
     public const int ParentFieldNumber = 1;
     private string parent_ = "";
     /// <summary>
-    /// Required. Name of the organization to groupBy. Its format is
+    /// Required. The name of the parent to group the assets by. Its format is
     /// "organizations/[organization_id], folders/[folder_id], or
     /// projects/[project_id]".
     /// </summary>
@@ -6015,9 +6019,9 @@ public sealed partial class ListNotificationConfigsRequest : pb::IMessage<ListNo
     public const int ParentFieldNumber = 1;
     private string parent_ = "";
     /// <summary>
-    /// Required. Name of the organization to list notification configs. Its format
-    /// is "organizations/[organization_id]", "folders/[folder_id]", or
-    /// "projects/[project_id]".
+    /// Required. The name of the parent in which to list the notification
+    /// configurations. Its format is "organizations/[organization_id]",
+    /// "folders/[folder_id]", or "projects/[project_id]".
     /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     [global::System.CodeDom.Compiler.GeneratedCode("protoc", null)]
@@ -7030,8 +7034,8 @@ public sealed partial class ListAssetsRequest : pb::IMessage<ListAssetsRequest>
     public const int ParentFieldNumber = 1;
     private string parent_ = "";
     /// <summary>
-    /// Required. Name of the organization assets should belong to. Its format is
-    /// "organizations/[organization_id], folders/[folder_id], or
+    /// Required. The name of the parent that the listed assets belong to. Its
+    /// format is "organizations/[organization_id], folders/[folder_id], or
     /// projects/[project_id]".
     /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
@@ -9990,10 +9994,12 @@ public sealed partial class SetFindingStateRequest : pb::IMessage<SetFindingStat
     public const int NameFieldNumber = 1;
     private string name_ = "";
     /// <summary>
-    /// Required. The relative resource name of the finding. See:
-    /// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-    /// Example:
-    /// "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}".
+    /// Required. The [relative resource
+    /// name](https://cloud.google.com/apis/design/resource_names#relative_resource_name)
+    /// of the finding. Example:
+    /// "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}",
+    /// "folders/{folder_id}/sources/{source_id}/findings/{finding_id}",
+    /// "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
     /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     [global::System.CodeDom.Compiler.GeneratedCode("protoc", null)]
@@ -10276,9 +10282,9 @@ public sealed partial class SetMuteRequest : pb::IMessage<SetMuteRequest>
     public const int NameFieldNumber = 1;
     private string name_ = "";
     /// <summary>
-    /// Required. The relative resource name of the finding. See:
-    /// https://cloud.google.com/apis/design/resource_names#relative_resource_name
-    /// Example:
+    /// Required. The [relative resource
+    /// name](https://cloud.google.com/apis/design/resource_names#relative_resource_name)
+    /// of the finding. Example:
     /// "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}",
     /// "folders/{folder_id}/sources/{source_id}/findings/{finding_id}",
     /// "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
@@ -12508,7 +12514,7 @@ public sealed partial class UpdateSecurityMarksRequest : pb::IMessage<UpdateSecu
   }
 
   /// <summary>
-  /// Request message for creating a big query export.
+  /// Request message for creating a BigQuery export.
   /// </summary>
   public sealed partial class CreateBigQueryExportRequest : pb::IMessage<CreateBigQueryExportRequest>
   #if !GOOGLE_PROTOBUF_REFSTRUCT_COMPATIBILITY_MODE
@@ -12560,8 +12566,8 @@ public sealed partial class CreateBigQueryExportRequest : pb::IMessage<CreateBig
     public const int ParentFieldNumber = 1;
     private string parent_ = "";
     /// <summary>
-    /// Required. Resource name of the new big query export's parent. Its format is
-    /// "organizations/[organization_id]", "folders/[folder_id]", or
+    /// Required. The name of the parent resource of the new BigQuery export. Its
+    /// format is "organizations/[organization_id]", "folders/[folder_id]", or
     /// "projects/[project_id]".
     /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
@@ -12577,7 +12583,7 @@ public sealed partial class CreateBigQueryExportRequest : pb::IMessage<CreateBig
     public const int BigQueryExportFieldNumber = 2;
     private global::Google.Cloud.SecurityCenter.V1.BigQueryExport bigQueryExport_;
     /// <summary>
-    /// Required. The big query export being created.
+    /// Required. The BigQuery export being created.
     /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     [global::System.CodeDom.Compiler.GeneratedCode("protoc", null)]
@@ -13560,7 +13566,7 @@ public sealed partial class ListBigQueryExportsResponse : pb::IMessage<ListBigQu
   }
 
   /// <summary>
-  /// Request message for deleting a big query export.
+  /// Request message for deleting a BigQuery export.
   /// </summary>
   public sealed partial class DeleteBigQueryExportRequest : pb::IMessage<DeleteBigQueryExportRequest>
   #if !GOOGLE_PROTOBUF_REFSTRUCT_COMPATIBILITY_MODE
@@ -13610,7 +13616,7 @@ public sealed partial class DeleteBigQueryExportRequest : pb::IMessage<DeleteBig
     public const int NameFieldNumber = 1;
     private string name_ = "";
     /// <summary>
-    /// Required. Name of the big query export to delete. Its format is
+    /// Required. The name of the BigQuery export to delete. Its format is
     /// organizations/{organization}/bigQueryExports/{export_id},
     /// folders/{folder}/bigQueryExports/{export_id}, or
     /// projects/{project}/bigQueryExports/{export_id}

apis/Google.Cloud.SecurityCenter.V1/Google.Cloud.SecurityCenter.V1/SecuritycenterServiceGrpc.g.cs

@@ -562,7 +562,7 @@ public abstract partial class SecurityCenterBase
       }
 
       /// <summary>
-      /// Gets a big query export.
+      /// Gets a BigQuery export.
       /// </summary>
       /// <param name="request">The request received from the client.</param>
       /// <param name="context">The context of the server-side call handler being invoked.</param>
@@ -880,7 +880,7 @@ public abstract partial class SecurityCenterBase
       }
 
       /// <summary>
-      /// Creates a big query export.
+      /// Creates a BigQuery export.
       /// </summary>
       /// <param name="request">The request received from the client.</param>
       /// <param name="context">The context of the server-side call handler being invoked.</param>
@@ -892,7 +892,7 @@ public abstract partial class SecurityCenterBase
       }
 
       /// <summary>
-      /// Deletes an existing big query export.
+      /// Deletes an existing BigQuery export.
       /// </summary>
       /// <param name="request">The request received from the client.</param>
       /// <param name="context">The context of the server-side call handler being invoked.</param>
@@ -1309,7 +1309,7 @@ protected SecurityCenterClient(ClientBaseConfiguration configuration) : base(con
         return CallInvoker.AsyncUnaryCall(__Method_DeleteNotificationConfig, null, options, request);
       }
       /// <summary>
-      /// Gets a big query export.
+      /// Gets a BigQuery export.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="headers">The initial metadata to send with the call. This parameter is optional.</param>
@@ -1322,7 +1322,7 @@ protected SecurityCenterClient(ClientBaseConfiguration configuration) : base(con
         return GetBigQueryExport(request, new grpc::CallOptions(headers, deadline, cancellationToken));
       }
       /// <summary>
-      /// Gets a big query export.
+      /// Gets a BigQuery export.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="options">The options for the call.</param>
@@ -1333,7 +1333,7 @@ protected SecurityCenterClient(ClientBaseConfiguration configuration) : base(con
         return CallInvoker.BlockingUnaryCall(__Method_GetBigQueryExport, null, options, request);
       }
       /// <summary>
-      /// Gets a big query export.
+      /// Gets a BigQuery export.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="headers">The initial metadata to send with the call. This parameter is optional.</param>
@@ -1346,7 +1346,7 @@ protected SecurityCenterClient(ClientBaseConfiguration configuration) : base(con
         return GetBigQueryExportAsync(request, new grpc::CallOptions(headers, deadline, cancellationToken));
       }
       /// <summary>
-      /// Gets a big query export.
+      /// Gets a BigQuery export.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="options">The options for the call.</param>
@@ -2581,7 +2581,7 @@ protected SecurityCenterClient(ClientBaseConfiguration configuration) : base(con
         return CallInvoker.AsyncUnaryCall(__Method_UpdateSecurityMarks, null, options, request);
       }
       /// <summary>
-      /// Creates a big query export.
+      /// Creates a BigQuery export.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="headers">The initial metadata to send with the call. This parameter is optional.</param>
@@ -2594,7 +2594,7 @@ protected SecurityCenterClient(ClientBaseConfiguration configuration) : base(con
         return CreateBigQueryExport(request, new grpc::CallOptions(headers, deadline, cancellationToken));
       }
       /// <summary>
-      /// Creates a big query export.
+      /// Creates a BigQuery export.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="options">The options for the call.</param>
@@ -2605,7 +2605,7 @@ protected SecurityCenterClient(ClientBaseConfiguration configuration) : base(con
         return CallInvoker.BlockingUnaryCall(__Method_CreateBigQueryExport, null, options, request);
       }
       /// <summary>
-      /// Creates a big query export.
+      /// Creates a BigQuery export.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="headers">The initial metadata to send with the call. This parameter is optional.</param>
@@ -2618,7 +2618,7 @@ protected SecurityCenterClient(ClientBaseConfiguration configuration) : base(con
         return CreateBigQueryExportAsync(request, new grpc::CallOptions(headers, deadline, cancellationToken));
       }
       /// <summary>
-      /// Creates a big query export.
+      /// Creates a BigQuery export.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="options">The options for the call.</param>
@@ -2629,7 +2629,7 @@ protected SecurityCenterClient(ClientBaseConfiguration configuration) : base(con
         return CallInvoker.AsyncUnaryCall(__Method_CreateBigQueryExport, null, options, request);
       }
       /// <summary>
-      /// Deletes an existing big query export.
+      /// Deletes an existing BigQuery export.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="headers">The initial metadata to send with the call. This parameter is optional.</param>
@@ -2642,7 +2642,7 @@ protected SecurityCenterClient(ClientBaseConfiguration configuration) : base(con
         return DeleteBigQueryExport(request, new grpc::CallOptions(headers, deadline, cancellationToken));
       }
       /// <summary>
-      /// Deletes an existing big query export.
+      /// Deletes an existing BigQuery export.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="options">The options for the call.</param>
@@ -2653,7 +2653,7 @@ protected SecurityCenterClient(ClientBaseConfiguration configuration) : base(con
         return CallInvoker.BlockingUnaryCall(__Method_DeleteBigQueryExport, null, options, request);
       }
       /// <summary>
-      /// Deletes an existing big query export.
+      /// Deletes an existing BigQuery export.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="headers">The initial metadata to send with the call. This parameter is optional.</param>
@@ -2666,7 +2666,7 @@ protected SecurityCenterClient(ClientBaseConfiguration configuration) : base(con
         return DeleteBigQueryExportAsync(request, new grpc::CallOptions(headers, deadline, cancellationToken));
       }
       /// <summary>
-      /// Deletes an existing big query export.
+      /// Deletes an existing BigQuery export.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="options">The options for the call.</param>