# Copyright 2019 Google LLC. All Rights Reserved.
#
# 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
#
#    http://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.

- release_tracks: [ALPHA, BETA, GA]
  deprecate:
    is_removed: false
    warning: |
      Security Command Center Asset APIs are deprecated and will be removed on or after
      June 26, 2024. Use Cloud Asset Inventory instead [(gcloud asset)](https://cloud.google.com/sdk/gcloud/reference/asset).
      For more information, [see the deprecation notice at Assets Page](https://cloud.google.com/security-command-center/docs/how-to-use-security-command-center#assets_page).

  help_text:
    brief: Scan an organization for new/modified/deleted assets.
    description: Scan an organization for new/modified/deleted assets. Note that this API can only
      be called with limited frequency for an organization. If it is called too frequently the
      caller will receive a TOO_MANY_REQUESTS error.
    examples: |
      Run new scan for organization (123456):

        $ {command} 123456

  request:
    collection: securitycenter.organizations.assets
    api_version: v1
    method: runDiscovery

  arguments:
    resource:
      help_text: The organization for which scan should be run.
      override_resource_collection: true
      spec: !REF googlecloudsdk.command_lib.scc.resources:organization
