feat: added support OutputResult in ExportAssetsResponse. docs: updat…

…ed existing docs. (#381)

Clients receive detailed OutputResult in ExportAssetsResponse.

PiperOrigin-RevId: 326582222

Source-Author: Google APIs <noreply@google.com>
Source-Date: Thu Aug 13 20:45:57 2020 -0700
Source-Repo: googleapis/googleapis
Source-Sha: 3a54e988edcbdef1e47c6ac19d3074a87214f667
Source-Link: googleapis/googleapis@3a54e98

packages/google-cloud-asset/protos/google/cloud/asset/v1/assets.proto

@@ -16,7 +16,6 @@ syntax = "proto3";
 
 package google.cloud.asset.v1;
 
-import "google/api/annotations.proto";
 import "google/api/resource.proto";
 import "google/cloud/orgpolicy/v1/orgpolicy.proto";
 import "google/iam/v1/policy.proto";
@@ -27,6 +26,7 @@ import "google/protobuf/any.proto";
 import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
 import "google/rpc/code.proto";
+import "google/api/annotations.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.Asset.V1";
@@ -150,8 +150,7 @@ message Asset {
 
  // Please also refer to the [service perimeter user
  // guide](https://cloud.google.com/vpc-service-controls/docs/overview).
- google.identity.accesscontextmanager.v1.ServicePerimeter service_perimeter =
- 9;
+ google.identity.accesscontextmanager.v1.ServicePerimeter service_perimeter = 9;
  }
 
  // The ancestry path of an asset in Google Cloud [resource
@@ -215,7 +214,7 @@ message Resource {
  string location = 8;
 }
 
-// A result of Resource Search, containing information of a cloud resoure.
+// A result of Resource Search, containing information of a cloud resource.
 message ResourceSearchResult {
  // The full resource name of this resource. Example:
  // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
@@ -225,8 +224,8 @@ message ResourceSearchResult {
  //
  // To search against the `name`:
  //
- // * use a field query. Example: `name : "instance1"`
- // * use a free text query. Example: `"instance1"`
+ // * use a field query. Example: `name:instance1`
+ // * use a free text query. Example: `instance1`
  string name = 1;
 
  // The type of this resource. Example: `compute.googleapis.com/Disk`.
@@ -248,7 +247,7 @@ message ResourceSearchResult {
  //
  // To search against the `display_name`:
  //
- // * use a field query. Example: `displayName : "My Instance"`
+ // * use a field query. Example: `displayName:"My Instance"`
  // * use a free text query. Example: `"My Instance"`
  string display_name = 4;
 
@@ -257,7 +256,7 @@ message ResourceSearchResult {
  //
  // To search against the `description`:
  //
- // * use a field query. Example: `description : "*important instance*"`
+ // * use a field query. Example: `description:"*important instance*"`
  // * use a free text query. Example: `"*important instance*"`
  string description = 5;
 
@@ -266,8 +265,8 @@ message ResourceSearchResult {
  //
  // To search against the `location`:
  //
- // * use a field query. Example: `location : "us-west*"`
- // * use a free text query. Example: `"us-west*"`
+ // * use a field query. Example: `location:us-west*`
+ // * use a free text query. Example: `us-west*`
  string location = 6;
 
  // Labels associated with this resource. See [Labelling and grouping GCP
@@ -276,11 +275,11 @@ message ResourceSearchResult {
  //
  // To search against the `labels`:
  //
- // * use a field query, as following:
- // - query on any label's key or value. Example: `labels : "prod"`
- // - query by a given label. Example: `labels.env : "prod"`
- // - query by a given label'sexistence. Example: `labels.env : *`
- // * use a free text query. Example: `"prod"`
+ // * use a field query:
+ // - query on any label's key or value. Example: `labels:prod`
+ // - query by a given label. Example: `labels.env:prod`
+ // - query by a given label's existence. Example: `labels.env:*`
+ // * use a free text query. Example: `prod`
  map<string, string> labels = 7;
 
  // Network tags associated with this resource. Like labels, network tags are a
@@ -290,19 +289,29 @@ message ResourceSearchResult {
  //
  // To search against the `network_tags`:
  //
- // * use a field query. Example: `networkTags : "internal"`
- // * use a free text query. Example: `"internal"`
+ // * use a field query. Example: `networkTags:internal`
+ // * use a free text query. Example: `internal`
  repeated string network_tags = 8;
 
- // The additional attributes of this resource. The attributes may vary from
- // one resource type to another. Examples: `projectId` for Project,
- // `dnsName` for DNS ManagedZone.
+ // The additional searchable attributes of this resource. The attributes may
+ // vary from one resource type to another. Examples: `projectId` for Project,
+ // `dnsName` for DNS ManagedZone. This field contains a subset of the resource
+ // metadata fields that are returned by the List or Get APIs provided by the
+ // corresponding GCP service (e.g., Compute Engine). see [API references and
+ // supported searchable
+ // attributes](https://cloud.google.com/asset-inventory/docs/supported-asset-types#searchable_asset_types)
+ // for more information.
+ //
+ // You can search values of these fields through free text search. However,
+ // you should not consume the field programically as the field names and
+ // values may change as the GCP service updates to a new incompatible API
+ // version.
  //
  // To search against the `additional_attributes`:
  //
  // * use a free text query to match the attributes values. Example: to search
  // `additional_attributes = { dnsName: "foobar" }`, you can issue a query
- // `"foobar"`.
+ // `foobar`.
  google.protobuf.Struct additional_attributes = 9;
 }
 
@@ -318,7 +327,7 @@ message IamPolicySearchResult {
 
  // The map from roles to their included permissions that match the
  // permission query (i.e., a query containing `policy.role.permissions:`).
- // Example: if query `policy.role.permissions : "compute.disk.get"`
+ // Example: if query `policy.role.permissions:compute.disk.get`
  // matches a policy binding that contains owner role, the
  // matched_permissions will be `{"roles/owner": ["compute.disk.get"]}`. The
  // roles can also be found in the returned `policy` bindings. Note that the
@@ -335,7 +344,7 @@ message IamPolicySearchResult {
  //
  // To search against the `resource`:
  //
- // * use a field query. Example: `resource : "organizations/123"`
+ // * use a field query. Example: `resource:organizations/123`
  string resource = 1;
 
  // The project that the associated GCP resource belongs to, in the form of
@@ -356,13 +365,13 @@ message IamPolicySearchResult {
  //
  // To search against the `policy` bindings:
  //
- // * use a field query, as following:
+ // * use a field query:
  // - query by the policy contained members. Example:
- // `policy : "amy@gmail.com"`
+ // `policy:amy@gmail.com`
  // - query by the policy contained roles. Example:
- // `policy : "roles/compute.admin"`
- // - query by the policy contained roles' implied permissions. Example:
- // `policy.role.permissions : "compute.instances.create"`
+ // `policy:roles/compute.admin`
+ // - query by the policy contained roles' included permissions. Example:
+ // `policy.role.permissions:compute.instances.create`
  google.iam.v1.Policy policy = 3;
 
  // Explanation about the IAM policy search result. It contains additional