@@ -776,6 +776,130 @@ class GoldenKitchenSinkClient {
776776 StatusOr<google::cloud::location::Location>
777777 GetLocation (google::cloud::location::GetLocationRequest const & request, Options opts = {});
778778
779+ // clang-format off
780+ // /
781+ // / Gets the access control policy for a resource.
782+ // / Returns an empty policy if the resource exists and does not have a policy
783+ // / set.
784+ // /
785+ // / @param request Unary RPCs, such as the one wrapped by this
786+ // / function, receive a single `request` proto message which includes all
787+ // / the inputs for the RPC. In this case, the proto message is a
788+ // / [google.iam.v1.GetIamPolicyRequest].
789+ // / Proto messages are converted to C++ classes by Protobuf, using the
790+ // / [Protobuf mapping rules].
791+ // / @param opts Optional. Override the class-level options, such as retry and
792+ // / backoff policies.
793+ // / @return the result of the RPC. The response message type
794+ // / ([google.iam.v1.Policy])
795+ // / is mapped to a C++ class using the [Protobuf mapping rules].
796+ // / If the request fails, the [`StatusOr`] contains the error details.
797+ // /
798+ // / [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/
799+ // / [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator
800+ // / [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string
801+ // / [`future`]: @ref google::cloud::future
802+ // / [`StatusOr`]: @ref google::cloud::StatusOr
803+ // / [`Status`]: @ref google::cloud::Status
804+ // / [google.iam.v1.GetIamPolicyRequest]: @googleapis_reference_link{google/iam/v1/iam_policy.proto#L123}
805+ // / [google.iam.v1.Policy]: @googleapis_reference_link{google/iam/v1/policy.proto#L102}
806+ // /
807+ // clang-format on
808+ StatusOr<google::iam::v1::Policy>
809+ GetIamPolicy (google::iam::v1::GetIamPolicyRequest const & request, Options opts = {});
810+
811+ // clang-format off
812+ // /
813+ // / Lists operations that match the specified filter in the request. If the
814+ // / server doesn't support this method, it returns `UNIMPLEMENTED`.
815+ // /
816+ // / NOTE: the `name` binding allows API services to override the binding
817+ // / to use different resource name schemes, such as `users/*/operations`. To
818+ // / override the binding, API services can add a binding such as
819+ // / `"/v1/{name=users/*}/operations"` to their service configuration.
820+ // / For backwards compatibility, the default name includes the operations
821+ // / collection id, however overriding users must ensure the name binding
822+ // / is the parent resource, without the operations collection id.
823+ // /
824+ // / @param name The name of the operation's parent resource.
825+ // / @param filter The standard list filter.
826+ // / @param opts Optional. Override the class-level options, such as retry and
827+ // / backoff policies.
828+ // / @return a [StreamRange](@ref google::cloud::StreamRange)
829+ // / to iterate of the results. See the documentation of this type for
830+ // / details. In brief, this class has `begin()` and `end()` member
831+ // / functions returning a iterator class meeting the
832+ // / [input iterator requirements]. The value type for this iterator is a
833+ // / [`StatusOr`] as the iteration may fail even after some values are
834+ // / retrieved successfully, for example, if there is a network disconnect.
835+ // / An empty set of results does not indicate an error, it indicates
836+ // / that there are no resources meeting the request criteria.
837+ // / On a successful iteration the `StatusOr<T>` contains elements of type
838+ // / [google.longrunning.Operation], or rather,
839+ // / the C++ class generated by Protobuf from that type. Please consult the
840+ // / Protobuf documentation for details on the [Protobuf mapping rules].
841+ // /
842+ // / [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/
843+ // / [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator
844+ // / [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string
845+ // / [`future`]: @ref google::cloud::future
846+ // / [`StatusOr`]: @ref google::cloud::StatusOr
847+ // / [`Status`]: @ref google::cloud::Status
848+ // / [google.longrunning.ListOperationsRequest]: @googleapis_reference_link{google/longrunning/operations.proto#L171}
849+ // / [google.longrunning.Operation]: @googleapis_reference_link{google/longrunning/operations.proto#L128}
850+ // /
851+ // clang-format on
852+ StreamRange<google::longrunning::Operation>
853+ ListOperations (std::string const & name, std::string const & filter, Options opts = {});
854+
855+ // clang-format off
856+ // /
857+ // / Lists operations that match the specified filter in the request. If the
858+ // / server doesn't support this method, it returns `UNIMPLEMENTED`.
859+ // /
860+ // / NOTE: the `name` binding allows API services to override the binding
861+ // / to use different resource name schemes, such as `users/*/operations`. To
862+ // / override the binding, API services can add a binding such as
863+ // / `"/v1/{name=users/*}/operations"` to their service configuration.
864+ // / For backwards compatibility, the default name includes the operations
865+ // / collection id, however overriding users must ensure the name binding
866+ // / is the parent resource, without the operations collection id.
867+ // /
868+ // / @param request Unary RPCs, such as the one wrapped by this
869+ // / function, receive a single `request` proto message which includes all
870+ // / the inputs for the RPC. In this case, the proto message is a
871+ // / [google.longrunning.ListOperationsRequest].
872+ // / Proto messages are converted to C++ classes by Protobuf, using the
873+ // / [Protobuf mapping rules].
874+ // / @param opts Optional. Override the class-level options, such as retry and
875+ // / backoff policies.
876+ // / @return a [StreamRange](@ref google::cloud::StreamRange)
877+ // / to iterate of the results. See the documentation of this type for
878+ // / details. In brief, this class has `begin()` and `end()` member
879+ // / functions returning a iterator class meeting the
880+ // / [input iterator requirements]. The value type for this iterator is a
881+ // / [`StatusOr`] as the iteration may fail even after some values are
882+ // / retrieved successfully, for example, if there is a network disconnect.
883+ // / An empty set of results does not indicate an error, it indicates
884+ // / that there are no resources meeting the request criteria.
885+ // / On a successful iteration the `StatusOr<T>` contains elements of type
886+ // / [google.longrunning.Operation], or rather,
887+ // / the C++ class generated by Protobuf from that type. Please consult the
888+ // / Protobuf documentation for details on the [Protobuf mapping rules].
889+ // /
890+ // / [Protobuf mapping rules]: https://protobuf.dev/reference/cpp/cpp-generated/
891+ // / [input iterator requirements]: https://en.cppreference.com/w/cpp/named_req/InputIterator
892+ // / [`std::string`]: https://en.cppreference.com/w/cpp/string/basic_string
893+ // / [`future`]: @ref google::cloud::future
894+ // / [`StatusOr`]: @ref google::cloud::StatusOr
895+ // / [`Status`]: @ref google::cloud::Status
896+ // / [google.longrunning.ListOperationsRequest]: @googleapis_reference_link{google/longrunning/operations.proto#L171}
897+ // / [google.longrunning.Operation]: @googleapis_reference_link{google/longrunning/operations.proto#L128}
898+ // /
899+ // clang-format on
900+ StreamRange<google::longrunning::Operation>
901+ ListOperations (google::longrunning::ListOperationsRequest request, Options opts = {});
902+
779903 private:
780904 std::shared_ptr<GoldenKitchenSinkConnection> connection_;
781905 Options options_;
0 commit comments