v1beta1/doc/google/cloud/securitycenter/v1beta1/doc_securitycenter_service.js

// Copyright 2019 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.

// Note: this file is purely for documentation. Any contents are not expected
// to be loaded as the JS file.

/**
 * Request message for creating a finding.
 *
 * @property {string} parent
 *   Resource name of the new finding's parent. Its format should be
 *   "organizations/[organization_id]/sources/[source_id]".
 *
 * @property {string} findingId
 *   Unique identifier provided by the client within the parent scope.
 *   It must be alphanumeric and less than or equal to 32 characters and
 *   greater than 0 characters in length.
 *
 * @property {Object} finding
 *   The Finding being created. The name and security_marks will be ignored as
 *   they are both output only fields on this resource.
 *
 *   This object should have the same structure as [Finding]{@link google.cloud.securitycenter.v1beta1.Finding}
 *
 * @typedef CreateFindingRequest
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.CreateFindingRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const CreateFindingRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for creating a source.
 *
 * @property {string} parent
 *   Resource name of the new source's parent. Its format should be
 *   "organizations/[organization_id]".
 *
 * @property {Object} source
 *   The Source being created, only the display_name and description will be
 *   used. All other fields will be ignored.
 *
 *   This object should have the same structure as [Source]{@link google.cloud.securitycenter.v1beta1.Source}
 *
 * @typedef CreateSourceRequest
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.CreateSourceRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const CreateSourceRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for getting organization settings.
 *
 * @property {string} name
 *   Name of the organization to get organization settings for. Its format is
 *   "organizations/[organization_id]/organizationSettings".
 *
 * @typedef GetOrganizationSettingsRequest
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.GetOrganizationSettingsRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const GetOrganizationSettingsRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for getting a source.
 *
 * @property {string} name
 *   Relative resource name of the source. Its format is
 *   "organizations/[organization_id]/source/[source_id]".
 *
 * @typedef GetSourceRequest
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.GetSourceRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const GetSourceRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for grouping by assets.
 *
 * @property {string} parent
 *   Name of the organization to groupBy. Its format is
 *   "organizations/[organization_id]".
 *
 * @property {string} filter
 *   Expression that defines the filter to apply across assets.
 *   The expression is a list of zero or more restrictions combined via logical
 *   operators `AND` and `OR`.
 *   Parentheses are not supported, and `OR` has higher precedence than `AND`.
 *
 *   Restrictions have the form `<field> <operator> <value>` and may have a `-`
 *   character in front of them to indicate negation. The fields map to those
 *   defined in the Asset resource. Examples include:
 *
 *   * name
 *   * security_center_properties.resource_name
 *   * resource_properties.a_property
 *   * security_marks.marks.marka
 *
 *   The supported operators are:
 *
 *   * `=` for all value types.
 *   * `>`, `<`, `>=`, `<=` for integer values.
 *   * `:`, meaning substring matching, for strings.
 *
 *   The supported value types are:
 *
 *   * string literals in quotes.
 *   * integer literals without quotes.
 *   * boolean literals `true` and `false` without quotes.
 *
 *   For example, `resource_properties.size = 100` is a valid filter string.
 *
 * @property {string} groupBy
 *   Expression that defines what assets fields to use for grouping. The string
 *   value should follow SQL syntax: comma separated list of fields. For
 *   example:
 *   "security_center_properties.resource_project,security_center_properties.project".
 *
 *   The following fields are supported when compare_duration is not set:
 *
 *   * security_center_properties.resource_project
 *   * security_center_properties.resource_type
 *   * security_center_properties.resource_parent
 *
 *   The following fields are supported when compare_duration is set:
 *
 *   * security_center_properties.resource_type
 *
 * @property {Object} compareDuration
 *   When compare_duration is set, the Asset's "state" property is updated to
 *   indicate whether the asset was added, removed, or remained present during
 *   the compare_duration period of time that precedes the read_time. This is
 *   the time between (read_time - compare_duration) and read_time.
 *
 *   The state value is derived based on the presence of the asset at the two
 *   points in time. Intermediate state changes between the two times don't
 *   affect the result. For example, the results aren't affected if the asset is
 *   removed and re-created again.
 *
 *   Possible "state" values when compare_duration is specified:
 *
 *   * "ADDED": indicates that the asset was not present before
 *                compare_duration, but present at reference_time.
 *   * "REMOVED": indicates that the asset was present at the start of
 *                compare_duration, but not present at reference_time.
 *   * "ACTIVE": indicates that the asset was present at both the
 *                start and the end of the time period defined by
 *                compare_duration and reference_time.
 *
 *   This field is ignored if `state` is not a field in `group_by`.
 *
 *   This object should have the same structure as [Duration]{@link google.protobuf.Duration}
 *
 * @property {Object} readTime
 *   Time used as a reference point when filtering assets. The filter is limited
 *   to assets existing at the supplied time and their values are those at that
 *   specific time. Absence of this field will default to the API's version of
 *   NOW.
 *
 *   This object should have the same structure as [Timestamp]{@link google.protobuf.Timestamp}
 *
 * @property {string} pageToken
 *   The value returned by the last `GroupAssetsResponse`; indicates
 *   that this is a continuation of a prior `GroupAssets` call, and that the
 *   system should return the next page of data.
 *
 * @property {number} pageSize
 *   The maximum number of results to return in a single response. Default is
 *   10, minimum is 1, maximum is 1000.
 *
 * @typedef GroupAssetsRequest
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.GroupAssetsRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const GroupAssetsRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Response message for grouping by assets.
 *
 * @property {Object[]} groupByResults
 *   Group results. There exists an element for each existing unique
 *   combination of property/values. The element contains a count for the number
 *   of times those specific property/values appear.
 *
 *   This object should have the same structure as [GroupResult]{@link google.cloud.securitycenter.v1beta1.GroupResult}
 *
 * @property {Object} readTime
 *   Time used for executing the groupBy request.
 *
 *   This object should have the same structure as [Timestamp]{@link google.protobuf.Timestamp}
 *
 * @property {string} nextPageToken
 *   Token to retrieve the next page of results, or empty if there are no more
 *   results.
 *
 * @typedef GroupAssetsResponse
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.GroupAssetsResponse definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const GroupAssetsResponse = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for grouping by findings.
 *
 * @property {string} parent
 *   Name of the source to groupBy. Its format is
 *   "organizations/[organization_id]/sources/[source_id]". To groupBy across
 *   all sources provide a source_id of `-`. For example:
 *   organizations/123/sources/-
 *
 * @property {string} filter
 *   Expression that defines the filter to apply across findings.
 *   The expression is a list of one or more restrictions combined via logical
 *   operators `AND` and `OR`.
 *   Parentheses are not supported, and `OR` has higher precedence than `AND`.
 *
 *   Restrictions have the form `<field> <operator> <value>` and may have a `-`
 *   character in front of them to indicate negation. Examples include:
 *
 *    * name
 *    * source_properties.a_property
 *    * security_marks.marks.marka
 *
 *   The supported operators are:
 *
 *   * `=` for all value types.
 *   * `>`, `<`, `>=`, `<=` for integer values.
 *   * `:`, meaning substring matching, for strings.
 *
 *   The supported value types are:
 *
 *   * string literals in quotes.
 *   * integer literals without quotes.
 *   * boolean literals `true` and `false` without quotes.
 *
 *   For example, `source_properties.size = 100` is a valid filter string.
 *
 * @property {string} groupBy
 *   Expression that defines what assets fields to use for grouping (including
 *   `state`). The string value should follow SQL syntax: comma separated list
 *   of fields. For example:
 *   "parent,resource_name".
 *
 *   The following fields are supported:
 *
 *   * resource_name
 *   * category
 *   * state
 *   * parent
 *
 * @property {Object} readTime
 *   Time used as a reference point when filtering findings. The filter is
 *   limited to findings existing at the supplied time and their values are
 *   those at that specific time. Absence of this field will default to the
 *   API's version of NOW.
 *
 *   This object should have the same structure as [Timestamp]{@link google.protobuf.Timestamp}
 *
 * @property {string} pageToken
 *   The value returned by the last `GroupFindingsResponse`; indicates
 *   that this is a continuation of a prior `GroupFindings` call, and
 *   that the system should return the next page of data.
 *
 * @property {number} pageSize
 *   The maximum number of results to return in a single response. Default is
 *   10, minimum is 1, maximum is 1000.
 *
 * @typedef GroupFindingsRequest
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.GroupFindingsRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const GroupFindingsRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Response message for group by findings.
 *
 * @property {Object[]} groupByResults
 *   Group results. There exists an element for each existing unique
 *   combination of property/values. The element contains a count for the number
 *   of times those specific property/values appear.
 *
 *   This object should have the same structure as [GroupResult]{@link google.cloud.securitycenter.v1beta1.GroupResult}
 *
 * @property {Object} readTime
 *   Time used for executing the groupBy request.
 *
 *   This object should have the same structure as [Timestamp]{@link google.protobuf.Timestamp}
 *
 * @property {string} nextPageToken
 *   Token to retrieve the next page of results, or empty if there are no more
 *   results.
 *
 * @typedef GroupFindingsResponse
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.GroupFindingsResponse definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const GroupFindingsResponse = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Result containing the properties and count of a groupBy request.
 *
 * @property {Object.<string, Object>} properties
 *   Properties matching the groupBy fields in the request.
 *
 * @property {number} count
 *   Total count of resources for the given properties.
 *
 * @typedef GroupResult
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.GroupResult definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const GroupResult = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for listing sources.
 *
 * @property {string} parent
 *   Resource name of the parent of sources to list. Its format should be
 *   "organizations/[organization_id]".
 *
 * @property {string} pageToken
 *   The value returned by the last `ListSourcesResponse`; indicates
 *   that this is a continuation of a prior `ListSources` call, and
 *   that the system should return the next page of data.
 *
 * @property {number} pageSize
 *   The maximum number of results to return in a single response. Default is
 *   10, minimum is 1, maximum is 1000.
 *
 * @typedef ListSourcesRequest
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.ListSourcesRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const ListSourcesRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Response message for listing sources.
 *
 * @property {Object[]} sources
 *   Sources belonging to the requested parent.
 *
 *   This object should have the same structure as [Source]{@link google.cloud.securitycenter.v1beta1.Source}
 *
 * @property {string} nextPageToken
 *   Token to retrieve the next page of results, or empty if there are no more
 *   results.
 *
 * @typedef ListSourcesResponse
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.ListSourcesResponse definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const ListSourcesResponse = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for listing assets.
 *
 * @property {string} parent
 *   Name of the organization assets should belong to. Its format is
 *   "organizations/[organization_id]".
 *
 * @property {string} filter
 *   Expression that defines the filter to apply across assets.
 *   The expression is a list of zero or more restrictions combined via logical
 *   operators `AND` and `OR`.
 *   Parentheses are not supported, and `OR` has higher precedence than `AND`.
 *
 *   Restrictions have the form `<field> <operator> <value>` and may have a `-`
 *   character in front of them to indicate negation. The fields map to those
 *   defined in the Asset resource. Examples include:
 *
 *   * name
 *   * security_center_properties.resource_name
 *   * resource_properties.a_property
 *   * security_marks.marks.marka
 *
 *   The supported operators are:
 *
 *   * `=` for all value types.
 *   * `>`, `<`, `>=`, `<=` for integer values.
 *   * `:`, meaning substring matching, for strings.
 *
 *   The supported value types are:
 *
 *   * string literals in quotes.
 *   * integer literals without quotes.
 *   * boolean literals `true` and `false` without quotes.
 *
 *   For example, `resource_properties.size = 100` is a valid filter string.
 *
 * @property {string} orderBy
 *   Expression that defines what fields and order to use for sorting. The
 *   string value should follow SQL syntax: comma separated list of fields. For
 *   example: "name,resource_properties.a_property". The default sorting order
 *   is ascending. To specify descending order for a field, a suffix " desc"
 *   should be appended to the field name. For example: "name
 *   desc,resource_properties.a_property". Redundant space characters in the
 *   syntax are insignificant. "name desc,resource_properties.a_property" and "
 *   name     desc  ,   resource_properties.a_property  " are equivalent.
 *
 * @property {Object} readTime
 *   Time used as a reference point when filtering assets. The filter is limited
 *   to assets existing at the supplied time and their values are those at that
 *   specific time. Absence of this field will default to the API's version of
 *   NOW.
 *
 *   This object should have the same structure as [Timestamp]{@link google.protobuf.Timestamp}
 *
 * @property {Object} compareDuration
 *   When compare_duration is set, the ListAssetResult's "state" attribute is
 *   updated to indicate whether the asset was added, removed, or remained
 *   present during the compare_duration period of time that precedes the
 *   read_time. This is the time between (read_time -
 *   compare_duration) and read_time.
 *
 *   The state value is derived based on the presence of the asset at the two
 *   points in time. Intermediate state changes between the two times don't
 *   affect the result. For example, the results aren't affected if the asset is
 *   removed and re-created again.
 *
 *   Possible "state" values when compare_duration is specified:
 *
 *   * "ADDED": indicates that the asset was not present before
 *                compare_duration, but present at read_time.
 *   * "REMOVED": indicates that the asset was present at the start of
 *                compare_duration, but not present at read_time.
 *   * "ACTIVE": indicates that the asset was present at both the
 *                start and the end of the time period defined by
 *                compare_duration and read_time.
 *
 *   If compare_duration is not specified, then the only possible state is
 *   "UNUSED", which indicates that the asset is present at read_time.
 *
 *   This object should have the same structure as [Duration]{@link google.protobuf.Duration}
 *
 * @property {Object} fieldMask
 *   Optional.
 *
 *   A field mask to specify the ListAssetsResult fields to be listed in the
 *   response.
 *   An empty field mask will list all fields.
 *
 *   This object should have the same structure as [FieldMask]{@link google.protobuf.FieldMask}
 *
 * @property {string} pageToken
 *   The value returned by the last `ListAssetsResponse`; indicates
 *   that this is a continuation of a prior `ListAssets` call, and
 *   that the system should return the next page of data.
 *
 * @property {number} pageSize
 *   The maximum number of results to return in a single response. Default is
 *   10, minimum is 1, maximum is 1000.
 *
 * @typedef ListAssetsRequest
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.ListAssetsRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const ListAssetsRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Response message for listing assets.
 *
 * @property {Object[]} listAssetsResults
 *   Assets matching the list request.
 *
 *   This object should have the same structure as [ListAssetsResult]{@link google.cloud.securitycenter.v1beta1.ListAssetsResult}
 *
 * @property {Object} readTime
 *   Time used for executing the list request.
 *
 *   This object should have the same structure as [Timestamp]{@link google.protobuf.Timestamp}
 *
 * @property {string} nextPageToken
 *   Token to retrieve the next page of results, or empty if there are no more
 *   results.
 *
 * @property {number} totalSize
 *   The total number of assets matching the query.
 *
 * @typedef ListAssetsResponse
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.ListAssetsResponse definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const ListAssetsResponse = {
  // This is for documentation. Actual contents will be loaded by gRPC.

  /**
   * Result containing the Asset and its State.
   *
   * @property {Object} asset
   *   Asset matching the search request.
   *
   *   This object should have the same structure as [Asset]{@link google.cloud.securitycenter.v1beta1.Asset}
   *
   * @property {number} state
   *   State of the asset.
   *
   *   The number should be among the values of [State]{@link google.cloud.securitycenter.v1beta1.State}
   *
   * @typedef ListAssetsResult
   * @memberof google.cloud.securitycenter.v1beta1
   * @see [google.cloud.securitycenter.v1beta1.ListAssetsResponse.ListAssetsResult definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
   */
  ListAssetsResult: {
    // This is for documentation. Actual contents will be loaded by gRPC.

    /**
     * State of the asset.
     *
     * When querying across two points in time this describes
     * the change between the two points: ADDED, REMOVED, or ACTIVE.
     * If there was no compare_duration supplied in the request the state should
     * be: UNUSED
     *
     * @enum {number}
     * @memberof google.cloud.securitycenter.v1beta1
     */
    State: {

      /**
       * Unspecified state.
       */
      STATE_UNSPECIFIED: 0,

      /**
       * Request did not specify use of this field in the result.
       */
      UNUSED: 1,

      /**
       * Asset was added between the points in time.
       */
      ADDED: 2,

      /**
       * Asset was removed between the points in time.
       */
      REMOVED: 3,

      /**
       * Asset was active at both point(s) in time.
       */
      ACTIVE: 4
    }
  }
};

/**
 * Request message for listing findings.
 *
 * @property {string} parent
 *   Name of the source the findings belong to. Its format is
 *   "organizations/[organization_id]/sources/[source_id]". To list across all
 *   sources provide a source_id of `-`. For example:
 *   organizations/123/sources/-
 *
 * @property {string} filter
 *   Expression that defines the filter to apply across findings.
 *   The expression is a list of one or more restrictions combined via logical
 *   operators `AND` and `OR`.
 *   Parentheses are not supported, and `OR` has higher precedence than `AND`.
 *
 *   Restrictions have the form `<field> <operator> <value>` and may have a `-`
 *   character in front of them to indicate negation. Examples include:
 *
 *    * name
 *    * source_properties.a_property
 *    * security_marks.marks.marka
 *
 *   The supported operators are:
 *
 *   * `=` for all value types.
 *   * `>`, `<`, `>=`, `<=` for integer values.
 *   * `:`, meaning substring matching, for strings.
 *
 *   The supported value types are:
 *
 *   * string literals in quotes.
 *   * integer literals without quotes.
 *   * boolean literals `true` and `false` without quotes.
 *
 *   For example, `source_properties.size = 100` is a valid filter string.
 *
 * @property {string} orderBy
 *   Expression that defines what fields and order to use for sorting. The
 *   string value should follow SQL syntax: comma separated list of fields. For
 *   example: "name,resource_properties.a_property". The default sorting order
 *   is ascending. To specify descending order for a field, a suffix " desc"
 *   should be appended to the field name. For example: "name
 *   desc,source_properties.a_property". Redundant space characters in the
 *   syntax are insignificant. "name desc,source_properties.a_property" and "
 *   name     desc  ,   source_properties.a_property  " are equivalent.
 *
 * @property {Object} readTime
 *   Time used as a reference point when filtering findings. The filter is
 *   limited to findings existing at the supplied time and their values are
 *   those at that specific time. Absence of this field will default to the
 *   API's version of NOW.
 *
 *   This object should have the same structure as [Timestamp]{@link google.protobuf.Timestamp}
 *
 * @property {Object} fieldMask
 *   Optional.
 *
 *   A field mask to specify the Finding fields to be listed in the response.
 *   An empty field mask will list all fields.
 *
 *   This object should have the same structure as [FieldMask]{@link google.protobuf.FieldMask}
 *
 * @property {string} pageToken
 *   The value returned by the last `ListFindingsResponse`; indicates
 *   that this is a continuation of a prior `ListFindings` call, and
 *   that the system should return the next page of data.
 *
 * @property {number} pageSize
 *   The maximum number of results to return in a single response. Default is
 *   10, minimum is 1, maximum is 1000.
 *
 * @typedef ListFindingsRequest
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.ListFindingsRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const ListFindingsRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Response message for listing findings.
 *
 * @property {Object[]} findings
 *   Findings matching the list request.
 *
 *   This object should have the same structure as [Finding]{@link google.cloud.securitycenter.v1beta1.Finding}
 *
 * @property {Object} readTime
 *   Time used for executing the list request.
 *
 *   This object should have the same structure as [Timestamp]{@link google.protobuf.Timestamp}
 *
 * @property {string} nextPageToken
 *   Token to retrieve the next page of results, or empty if there are no more
 *   results.
 *
 * @property {number} totalSize
 *   The total number of findings matching the query.
 *
 * @typedef ListFindingsResponse
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.ListFindingsResponse definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const ListFindingsResponse = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for updating a finding's state.
 *
 * @property {string} name
 *   The relative resource name of the finding. See:
 *   https://cloud.google.com/apis/design/resource_names#relative_resource_name
 *   Example:
 *   "organizations/123/sources/456/finding/789".
 *
 * @property {number} state
 *   The desired State of the finding.
 *
 *   The number should be among the values of [State]{@link google.cloud.securitycenter.v1beta1.State}
 *
 * @property {Object} startTime
 *   The time at which the updated state takes effect.
 *
 *   This object should have the same structure as [Timestamp]{@link google.protobuf.Timestamp}
 *
 * @typedef SetFindingStateRequest
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.SetFindingStateRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const SetFindingStateRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for running asset discovery for an organization.
 *
 * @property {string} parent
 *   Name of the organization to run asset discovery for. Its format is
 *   "organizations/[organization_id]".
 *
 * @typedef RunAssetDiscoveryRequest
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.RunAssetDiscoveryRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const RunAssetDiscoveryRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for updating or creating a finding.
 *
 * @property {Object} finding
 *   The finding resource to update or create if it does not already exist.
 *   parent, security_marks, and update_time will be ignored.
 *
 *   In the case of creation, the finding id portion of the name must
 *   alphanumeric and less than or equal to 32 characters and greater than 0
 *   characters in length.
 *
 *   This object should have the same structure as [Finding]{@link google.cloud.securitycenter.v1beta1.Finding}
 *
 * @property {Object} updateMask
 *   The FieldMask to use when updating the finding resource. This field should
 *   not be specified when creating a finding.
 *
 *   This object should have the same structure as [FieldMask]{@link google.protobuf.FieldMask}
 *
 * @typedef UpdateFindingRequest
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.UpdateFindingRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const UpdateFindingRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for updating an organization's settings.
 *
 * @property {Object} organizationSettings
 *   The organization settings resource to update.
 *
 *   This object should have the same structure as [OrganizationSettings]{@link google.cloud.securitycenter.v1beta1.OrganizationSettings}
 *
 * @property {Object} updateMask
 *   The FieldMask to use when updating the settings resource.
 *
 *   This object should have the same structure as [FieldMask]{@link google.protobuf.FieldMask}
 *
 * @typedef UpdateOrganizationSettingsRequest
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.UpdateOrganizationSettingsRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const UpdateOrganizationSettingsRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for updating a source.
 *
 * @property {Object} source
 *   The source resource to update.
 *
 *   This object should have the same structure as [Source]{@link google.cloud.securitycenter.v1beta1.Source}
 *
 * @property {Object} updateMask
 *   The FieldMask to use when updating the source resource.
 *
 *   This object should have the same structure as [FieldMask]{@link google.protobuf.FieldMask}
 *
 * @typedef UpdateSourceRequest
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.UpdateSourceRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const UpdateSourceRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};

/**
 * Request message for updating a SecurityMarks resource.
 *
 * @property {Object} securityMarks
 *   The security marks resource to update.
 *
 *   This object should have the same structure as [SecurityMarks]{@link google.cloud.securitycenter.v1beta1.SecurityMarks}
 *
 * @property {Object} updateMask
 *   The FieldMask to use when updating the security marks resource.
 *
 *   This object should have the same structure as [FieldMask]{@link google.protobuf.FieldMask}
 *
 * @property {Object} startTime
 *   The time at which the updated SecurityMarks take effect.
 *
 *   This object should have the same structure as [Timestamp]{@link google.protobuf.Timestamp}
 *
 * @typedef UpdateSecurityMarksRequest
 * @memberof google.cloud.securitycenter.v1beta1
 * @see [google.cloud.securitycenter.v1beta1.UpdateSecurityMarksRequest definition in proto format]{@link https://github.com/googleapis/googleapis/blob/master/google/cloud/securitycenter/v1beta1/securitycenter_service.proto}
 */
const UpdateSecurityMarksRequest = {
  // This is for documentation. Actual contents will be loaded by gRPC.
};