@@ -662,7 +662,8 @@ testIAMPermissionsRequest =
662662 }
663663
664664-- | The set of permissions to check for the \`resource\`. Permissions with
665−-- wildcards (such as \'*\' or \'storage.*\') are not allowed.
665+-- wildcards (such as \'*\' or \'storage.*\') are not allowed. For more
666+-- information see IAM Overview.
666667tiprPermissions :: Lens' TestIAMPermissionsRequest [Text]
667668tiprPermissions
668669 = lens _tiprPermissions
@@ -808,7 +809,7 @@ instance ToJSON TestIAMPermissionsResponse where
808809-- \"bindings\": [ { \"role\": \"roles\/owner\", \"members\": [
809810-- \"user:mike\'example.com\", \"group:admins\'example.com\",
810811-- \"domain:google.com\",
811−-- \"serviceAccount:my-other-app\'appspot.gserviceaccount.com\"] }, {
812+-- \"serviceAccount:my-other-app\'appspot.gserviceaccount.com\", ] }, {
812813-- \"role\": \"roles\/viewer\", \"members\": [\"user:sean\'example.com\"] }
813814-- ] } For a description of IAM and its features, see the [IAM developer\'s
814815-- guide](https:\/\/cloud.google.com\/iam).
@@ -838,7 +839,15 @@ policy =
838839 , _pBindings = Nothing
839840 }
840841
841−-- | Can be used to perform a read-modify-write.
842+-- | \`etag\` is used for optimistic concurrency control as a way to help
843+-- prevent simultaneous updates of a policy from overwriting each other. It
844+-- is strongly suggested that systems make use of the \`etag\` in the
845+-- read-modify-write cycle to perform policy updates in order to avoid race
846+-- conditions: An \`etag\` is returned in the response to \`getIamPolicy\`,
847+-- and systems are expected to put that etag in the request to
848+-- \`setIamPolicy\` to ensure that their change will be applied to the same
849+-- version of the policy. If no \`etag\` is provided in the call to
850+-- \`setIamPolicy\`, then the existing policy is overwritten blindly.
842851pEtag :: Lens' Policy (Maybe Word8)
843852pEtag
844853 = lens _pEtag (\ s a -> s{_pEtag = a}) .
@@ -981,14 +990,14 @@ sName = lens _sName (\ s a -> s{_sName = a})
981990-- before the subscriber should acknowledge the message. After message
982991-- delivery but before the ack deadline expires and before the message is
983992-- acknowledged, it is an outstanding message and will not be delivered
984−-- again during that time (on a best-effort basis). For pull delivery this
985−-- value is used as the initial value for the ack deadline. To override
986−-- this value for a given message, call \`ModifyAckDeadline\` with the
987−-- corresponding \`ack_id\`. For push delivery, this value is also used to
988−-- set the request timeout for the call to the push endpoint. If the
989−-- subscriber never acknowledges the message, the Pub\/Sub system will
990−-- eventually redeliver the message. If this parameter is not set, the
991−-- default value of 10 seconds is used.
993+-- again during that time (on a best-effort basis). For pull subscriptions,
994+-- this value is used as the initial value for the ack deadline. To
995+-- override this value for a given message, call \`ModifyAckDeadline\` with
996+-- the corresponding \`ack_id\` if using pull. For push delivery, this
997+-- value is also used to set the request timeout for the call to the push
998+-- endpoint. If the subscriber never acknowledges the message, the Pub\/Sub
999+-- system will eventually redeliver the message. If this parameter is not
1000+-- set, the default value of 10 seconds is used.
9921001sAckDeadlineSeconds :: Lens' Subscription (Maybe Int32)
9931002sAckDeadlineSeconds
9941003 = lens _sAckDeadlineSeconds
@@ -1090,7 +1099,7 @@ binding =
10901099 }
10911100
10921101-- | Specifies the identities requesting access for a Cloud Platform
1093−-- resource. \`members\` can have the following formats: * \`allUsers\`: A
1102+-- resource. \`members\` can have the following values: * \`allUsers\`: A
10941103-- special identifier that represents anyone who is on the internet; with
10951104-- or without a Google account. * \`allAuthenticatedUsers\`: A special
10961105-- identifier that represents anyone who is authenticated with a Google