1 files changed, 10 insertions, 12 deletions
diff --git a/google/iam/v1/iam_policy.proto b/google/iam/v1/iam_policy.proto
index c102ff722..7cd1b0b9b 100644
--- a/google/iam/v1/iam_policy.proto
+++ b/google/iam/v1/iam_policy.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2016 Google Inc.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,15 +11,13 @@
 // 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.
-//
 
 syntax = "proto3";
 
 package google.iam.v1;
 
-import "google/api/resource.proto";
-import "google/iam/v1/policy.proto";
 import "google/api/annotations.proto";
+import "google/iam/v1/policy.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.Iam.V1";
@@ -77,11 +75,8 @@ service IAMPolicy {
   // Returns permissions that a caller has on the specified resource.
   // If the resource does not exist, this will return an empty set of
   // permissions, not a NOT_FOUND error.
-  //
-  // Note: This operation is designed to be used for building permission-aware
-  // UIs and command-line tools, not for authorization checking. This operation
-  // may "fail open" without warning.
-  rpc TestIamPermissions(TestIamPermissionsRequest) returns (TestIamPermissionsResponse) {
+  rpc TestIamPermissions(TestIamPermissionsRequest)
+      returns (TestIamPermissionsResponse) {
     option (google.api.http) = {
       post: "/v1/{resource=**}:testIamPermissions"
       body: "*"
@@ -92,7 +87,8 @@ service IAMPolicy {
 // Request message for `SetIamPolicy` method.
 message SetIamPolicyRequest {
   // REQUIRED: The resource for which the policy is being specified.
-  // See the operation documentation for the appropriate value for this field.
+  // `resource` is usually specified as a path. For example, a Project
+  // resource is specified as `projects/{project}`.
   string resource = 1;
 
   // REQUIRED: The complete policy to be applied to the `resource`. The size of
@@ -105,14 +101,16 @@ message SetIamPolicyRequest {
 // Request message for `GetIamPolicy` method.
 message GetIamPolicyRequest {
   // REQUIRED: The resource for which the policy is being requested.
-  // See the operation documentation for the appropriate value for this field.
+  // `resource` is usually specified as a path. For example, a Project
+  // resource is specified as `projects/{project}`.
   string resource = 1;
 }
 
 // Request message for `TestIamPermissions` method.
 message TestIamPermissionsRequest {
   // REQUIRED: The resource for which the policy detail is being requested.
-  // See the operation documentation for the appropriate value for this field.
+  // `resource` is usually specified as a path. For example, a Project
+  // resource is specified as `projects/{project}`.
   string resource = 1;
 
   // The set of permissions to check for the `resource`. Permissions with