legacy-libs/google-proto-files/google/cloud/securitycenter/v1/asset.proto

   1 // Copyright 2019 Google LLC.
   2 //
   3 // Licensed under the Apache License, Version 2.0 (the "License");
   4 // you may not use this file except in compliance with the License.
   5 // You may obtain a copy of the License at
   6 //
   7 //     http://www.apache.org/licenses/LICENSE-2.0
   8 //
   9 // Unless required by applicable law or agreed to in writing, software
  10 // distributed under the License is distributed on an "AS IS" BASIS,
  11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12 // See the License for the specific language governing permissions and
  13 // limitations under the License.
  14 //
  15
  16 syntax = "proto3";
  17
  18 package google.cloud.securitycenter.v1;
  19
  20 import "google/api/annotations.proto";
  21 import "google/cloud/securitycenter/v1/security_marks.proto";
  22 import "google/protobuf/struct.proto";
  23 import "google/protobuf/timestamp.proto";
  24
  25 option csharp_namespace = "Google.Cloud.SecurityCenter.V1";
  26 option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter";
  27 option java_multiple_files = true;
  28 option java_package = "com.google.cloud.securitycenter.v1";
  29
  30 // Cloud Security Command Center's (Cloud SCC) representation of a Google Cloud
  31 // Platform (GCP) resource.
  32 //
  33 // The Asset is a Cloud SCC resource that captures information about a single
  34 // GCP resource. All modifications to an Asset are only within the context of
  35 // Cloud SCC and don't affect the referenced GCP resource.
  36 message Asset {
  37   // Cloud SCC managed properties. These properties are managed by Cloud SCC and
  38   // cannot be modified by the user.
  39   message SecurityCenterProperties {
  40     // The full resource name of the GCP resource this asset
  41     // represents. This field is immutable after create time. See:
  42     // https://cloud.google.com/apis/design/resource_names#full_resource_name
  43     string resource_name = 1;
  44
  45     // The type of the GCP resource. Examples include: APPLICATION,
  46     // PROJECT, and ORGANIZATION. This is a case insensitive field defined by
  47     // Cloud SCC and/or the producer of the resource and is immutable
  48     // after create time.
  49     string resource_type = 2;
  50
  51     // The full resource name of the immediate parent of the resource. See:
  52     // https://cloud.google.com/apis/design/resource_names#full_resource_name
  53     string resource_parent = 3;
  54
  55     // The full resource name of the project the resource belongs to. See:
  56     // https://cloud.google.com/apis/design/resource_names#full_resource_name
  57     string resource_project = 4;
  58
  59     // Owners of the Google Cloud resource.
  60     repeated string resource_owners = 5;
  61   }
  62
  63   // IAM Policy information associated with the GCP resource described by the
  64   // Cloud SCC asset. This information is managed and defined by the GCP
  65   // resource and cannot be modified by the user.
  66   message IamPolicy {
  67     // The JSON representation of the Policy associated with the asset.
  68     // See https://cloud.google.com/iam/reference/rest/v1/Policy for format
  69     // details.
  70     string policy_blob = 1;
  71   }
  72
  73   // The relative resource name of this asset. See:
  74   // https://cloud.google.com/apis/design/resource_names#relative_resource_name
  75   // Example:
  76   // "organizations/123/assets/456".
  77   string name = 1;
  78
  79   // Cloud SCC managed properties. These properties are managed by
  80   // Cloud SCC and cannot be modified by the user.
  81   SecurityCenterProperties security_center_properties = 2;
  82
  83   // Resource managed properties. These properties are managed and defined by
  84   // the GCP resource and cannot be modified by the user.
  85   map<string, google.protobuf.Value> resource_properties = 7;
  86
  87   // User specified security marks. These marks are entirely managed by the user
  88   // and come from the SecurityMarks resource that belongs to the asset.
  89   SecurityMarks security_marks = 8;
  90
  91   // The time at which the asset was created in Cloud SCC.
  92   google.protobuf.Timestamp create_time = 9;
  93
  94   // The time at which the asset was last updated, added, or deleted in Cloud
  95   // SCC.
  96   google.protobuf.Timestamp update_time = 10;
  97
  98   // IAM Policy information associated with the GCP resource described by the
  99   // Cloud SCC asset. This information is managed and defined by the GCP
 100   // resource and cannot be modified by the user.
 101   IamPolicy iam_policy = 11;
 102 }