@@ -662,7 +662,8 @@ testIAMPermissionsRequest =
664-- | The set of permissions to check for the \`resource\`. Permissions with
664-- | 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.
666tiprPermissions :: Lens' TestIAMPermissionsRequest [Text]
667tiprPermissions :: Lens' TestIAMPermissionsRequest [Text]
667tiprPermissions
668tiprPermissions
668 = lens _tiprPermissions
669 = lens _tiprPermissions
@@ -808,7 +809,7 @@ instance ToJSON TestIAMPermissionsResponse where
808-- \"bindings\": [ { \"role\": \"roles\/owner\", \"members\": [
809-- \"bindings\": [ { \"role\": \"roles\/owner\", \"members\": [
809-- \"user:mike\'example.com\", \"group:admins\'example.com\",
810-- \"user:mike\'example.com\", \"group:admins\'example.com\",
810-- \"domain:google.com\",
811-- \"domain:google.com\",
811−-- \"serviceAccount:my-other-app\'appspot.gserviceaccount.com\"] }, {
812+-- \"serviceAccount:my-other-app\'appspot.gserviceaccount.com\", ] }, {
812-- \"role\": \"roles\/viewer\", \"members\": [\"user:sean\'example.com\"] }
813-- \"role\": \"roles\/viewer\", \"members\": [\"user:sean\'example.com\"] }
813-- ] } For a description of IAM and its features, see the [IAM developer\'s
814-- ] } For a description of IAM and its features, see the [IAM developer\'s
814-- guide](https:\/\/cloud.google.com\/iam).
815-- guide](https:\/\/cloud.google.com\/iam).
@@ -838,7 +839,15 @@ policy =
838 , _pBindings = Nothing
839 , _pBindings = Nothing
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.
842pEtag :: Lens' Policy (Maybe Word8)
851pEtag :: Lens' Policy (Maybe Word8)
844 = lens _pEtag (\ s a -> s{_pEtag = a}) .
853 = lens _pEtag (\ s a -> s{_pEtag = a}) .
@@ -981,14 +990,14 @@ sName = lens _sName (\ s a -> s{_sName = a})
981-- before the subscriber should acknowledge the message. After message
990-- before the subscriber should acknowledge the message. After message
982-- delivery but before the ack deadline expires and before the message is
991-- delivery but before the ack deadline expires and before the message is
983-- acknowledged, it is an outstanding message and will not be delivered
992-- 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
993+-- again during that time (on a best-effort basis). For pull subscriptions,
985−-- value is used as the initial value for the ack deadline. To override
994+-- this value is used as the initial value for the ack deadline. To
986−-- this value for a given message, call \`ModifyAckDeadline\` with the
995+-- override this value for a given message, call \`ModifyAckDeadline\` with
987−-- corresponding \`ack_id\`. For push delivery, this value is also used to
996+-- the corresponding \`ack_id\` if using pull. For push delivery, this
988−-- set the request timeout for the call to the push endpoint. If the
997+-- value is also used to set the request timeout for the call to the push
989−-- subscriber never acknowledges the message, the Pub\/Sub system will
998+-- endpoint. If the subscriber never acknowledges the message, the Pub\/Sub
990−-- eventually redeliver the message. If this parameter is not set, the
999+-- system will eventually redeliver the message. If this parameter is not
991−-- default value of 10 seconds is used.
1000+-- set, the default value of 10 seconds is used.
992sAckDeadlineSeconds :: Lens' Subscription (Maybe Int32)
1001sAckDeadlineSeconds :: Lens' Subscription (Maybe Int32)
993sAckDeadlineSeconds
1002sAckDeadlineSeconds
994 = lens _sAckDeadlineSeconds
1003 = lens _sAckDeadlineSeconds
@@ -1090,7 +1099,7 @@ binding =
1092-- | Specifies the identities requesting access for a Cloud Platform
1101-- | 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
1094-- special identifier that represents anyone who is on the internet; with
1103-- special identifier that represents anyone who is on the internet; with
1095-- or without a Google account. * \`allAuthenticatedUsers\`: A special
1104-- or without a Google account. * \`allAuthenticatedUsers\`: A special
1096-- identifier that represents anyone who is authenticated with a Google
1105-- identifier that represents anyone who is authenticated with a Google