Security Command Center API (securitycenter:v1beta1)

2026-05-31

23 updated methods

Updates

    Methods
  • securitycenter.organizations.getOrganizationSettings

      Parameters :

        name

          Description : Required. Name of the organization to get organization settings for. Its format is "organizations/[organization_id]/organizationSettings".

          Pattern : ^organizations/[^/]+/organizationSettings$

          Location : path

          Required : Yes

          Type : string

  • securitycenter.organizations.updateOrganizationSettings

      Parameters :

        name

          Description : The relative resource name of the settings. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/organizationSettings".

          Pattern : ^organizations/[^/]+/organizationSettings$

          Location : path

          Required : Yes

          Type : string

        updateMask

          Description : The FieldMask to use when updating the settings resource.

          Location : query

          Type : string

          Format : google-fieldmask

  • securitycenter.organizations.operations.list

      Parameters :

        name

          Description : The name of the operation's parent resource.

          Pattern : ^organizations/[^/]+/operations$

          Location : path

          Required : Yes

          Type : string

        filter

          Description : The standard list filter.

          Location : query

          Type : string

        pageSize

          Description : The standard list page size.

          Location : query

          Type : integer

          Format : int32

        pageToken

          Description : The standard list page token.

          Location : query

          Type : string

        returnPartialSuccess

          Description : When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `"projects/example/locations/-"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.

          Location : query

          Type : boolean

  • securitycenter.organizations.operations.get

      Parameters :

        name

          Description : The name of the operation resource.

          Pattern : ^organizations/[^/]+/operations/[^/]+$

          Location : path

          Required : Yes

          Type : string

  • securitycenter.organizations.operations.delete

      Parameters :

        name

          Description : The name of the operation resource to be deleted.

          Pattern : ^organizations/[^/]+/operations/[^/]+$

          Location : path

          Required : Yes

          Type : string

  • securitycenter.organizations.operations.cancel

      Parameters :

        name

          Description : The name of the operation resource to be cancelled.

          Pattern : ^organizations/[^/]+/operations/[^/]+$

          Location : path

          Required : Yes

          Type : string

  • securitycenter.organizations.sources.create

      Parameters :

        parent

          Description : Required. Resource name of the new source's parent. Its format should be "organizations/[organization_id]".

          Pattern : ^organizations/[^/]+$

          Location : path

          Required : Yes

          Type : string

  • securitycenter.organizations.sources.getIamPolicy

      Parameters :

        resource

          Description : REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.

          Pattern : ^organizations/[^/]+/sources/[^/]+$

          Location : path

          Required : Yes

          Type : string

  • securitycenter.organizations.sources.get

      Parameters :

        name

          Description : Required. Relative resource name of the source. Its format is "organizations/[organization_id]/source/[source_id]".

          Pattern : ^organizations/[^/]+/sources/[^/]+$

          Location : path

          Required : Yes

          Type : string

  • securitycenter.organizations.sources.list

      Parameters :

        parent

          Description : Required. Resource name of the parent of sources to list. Its format should be "organizations/[organization_id]".

          Pattern : ^organizations/[^/]+$

          Location : path

          Required : Yes

          Type : string

        pageToken

          Description : 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.

          Location : query

          Type : string

        pageSize

          Description : The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000.

          Location : query

          Type : integer

          Format : int32

  • securitycenter.organizations.sources.setIamPolicy

      Parameters :

        resource

          Description : REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.

          Pattern : ^organizations/[^/]+/sources/[^/]+$

          Location : path

          Required : Yes

          Type : string

  • securitycenter.organizations.sources.testIamPermissions

      Parameters :

        resource

          Description : REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.

          Pattern : ^organizations/[^/]+/sources/[^/]+$

          Location : path

          Required : Yes

          Type : string

  • securitycenter.organizations.sources.patch

      Parameters :

        name

          Description : The relative resource name of this source. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}"

          Pattern : ^organizations/[^/]+/sources/[^/]+$

          Location : path

          Required : Yes

          Type : string

        updateMask

          Description : The FieldMask to use when updating the source resource.

          Location : query

          Type : string

          Format : google-fieldmask

  • securitycenter.organizations.sources.findings.create

      Parameters :

        parent

          Description : Required. Resource name of the new finding's parent. Its format should be "organizations/[organization_id]/sources/[source_id]".

          Pattern : ^organizations/[^/]+/sources/[^/]+$

          Location : path

          Required : Yes

          Type : string

        findingId

          Description : Required. 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.

          Location : query

          Type : string

  • securitycenter.organizations.sources.findings.group

      Parameters :

        parent

          Description : Required. 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/{organization_id}/sources/-

          Pattern : ^organizations/[^/]+/sources/[^/]+$

          Location : path

          Required : Yes

          Type : string

  • securitycenter.organizations.sources.findings.list

      Parameters :

        parent

          Description : Required. 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/{organization_id}/sources/-

          Pattern : ^organizations/[^/]+/sources/[^/]+$

          Location : path

          Required : Yes

          Type : string

        filter

          Description : 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 ` ` 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.

          Location : query

          Type : string

        orderBy

          Description : 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.

          Location : query

          Type : string

        readTime

          Description : 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.

          Location : query

          Type : string

          Format : google-datetime

        fieldMask

          Description : Optional. A field mask to specify the Finding fields to be listed in the response. An empty field mask will list all fields.

          Location : query

          Type : string

          Format : google-fieldmask

        pageToken

          Description : 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.

          Location : query

          Type : string

        pageSize

          Description : The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000.

          Location : query

          Type : integer

          Format : int32

  • securitycenter.organizations.sources.findings.setState

      Parameters :

        name

          Description : 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}/finding/{finding_id}".

          Pattern : ^organizations/[^/]+/sources/[^/]+/findings/[^/]+$

          Location : path

          Required : Yes

          Type : string

  • securitycenter.organizations.sources.findings.patch

      Parameters :

        name

          Description : The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"

          Pattern : ^organizations/[^/]+/sources/[^/]+/findings/[^/]+$

          Location : path

          Required : Yes

          Type : string

        updateMask

          Description : The FieldMask to use when updating the finding resource. This field should not be specified when creating a finding.

          Location : query

          Type : string

          Format : google-fieldmask

  • securitycenter.organizations.sources.findings.updateSecurityMarks

      Parameters :

        name

          Description : The relative resource name of the SecurityMarks. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Examples: "organizations/{organization_id}/assets/{asset_id}/securityMarks" "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}/securityMarks".

          Pattern : ^organizations/[^/]+/sources/[^/]+/findings/[^/]+/securityMarks$

          Location : path

          Required : Yes

          Type : string

        updateMask

          Description : The FieldMask to use when updating the security marks resource.

          Location : query

          Type : string

          Format : google-fieldmask

        startTime

          Description : The time at which the updated SecurityMarks take effect.

          Location : query

          Type : string

          Format : google-datetime

  • securitycenter.organizations.assets.group

      Parameters :

        parent

          Description : Required. Name of the organization to groupBy. Its format is "organizations/[organization_id]".

          Pattern : ^organizations/[^/]+$

          Location : path

          Required : Yes

          Type : string

  • securitycenter.organizations.assets.list

      Parameters :

        parent

          Description : Required. Name of the organization assets should belong to. Its format is "organizations/[organization_id]".

          Pattern : ^organizations/[^/]+$

          Location : path

          Required : Yes

          Type : string

        filter

          Description : 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 ` ` 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.

          Location : query

          Type : string

        orderBy

          Description : 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.

          Location : query

          Type : string

        readTime

          Description : 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.

          Location : query

          Type : string

          Format : google-datetime

        compareDuration

          Description : 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.

          Location : query

          Type : string

          Format : google-duration

        fieldMask

          Description : Optional. A field mask to specify the ListAssetsResult fields to be listed in the response. An empty field mask will list all fields.

          Location : query

          Type : string

          Format : google-fieldmask

        pageToken

          Description : 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.

          Location : query

          Type : string

        pageSize

          Description : The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000.

          Location : query

          Type : integer

          Format : int32

  • securitycenter.organizations.assets.runDiscovery

      Parameters :

        parent

          Description : Required. Name of the organization to run asset discovery for. Its format is "organizations/[organization_id]".

          Pattern : ^organizations/[^/]+$

          Location : path

          Required : Yes

          Type : string

  • securitycenter.organizations.assets.updateSecurityMarks

      Parameters :

        name

          Description : The relative resource name of the SecurityMarks. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Examples: "organizations/{organization_id}/assets/{asset_id}/securityMarks" "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}/securityMarks".

          Pattern : ^organizations/[^/]+/assets/[^/]+/securityMarks$

          Location : path

          Required : Yes

          Type : string

        updateMask

          Description : The FieldMask to use when updating the security marks resource.

          Location : query

          Type : string

          Format : google-fieldmask

        startTime

          Description : The time at which the updated SecurityMarks take effect.

          Location : query

          Type : string

          Format : google-datetime