1<?php
2/*
3 * Copyright 2014 Google Inc.
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
6 * use this file except in compliance with the License. You may obtain a copy of
7 * the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
13 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
14 * License for the specific language governing permissions and limitations under
15 * the License.
16 */
17
18namespace Google\Service\DataprocMetastore\Resource;
19
20use Google\Service\DataprocMetastore\Policy;
21use Google\Service\DataprocMetastore\SetIamPolicyRequest;
22use Google\Service\DataprocMetastore\TestIamPermissionsRequest;
23use Google\Service\DataprocMetastore\TestIamPermissionsResponse;
24
25/**
26 * The "databases" collection of methods.
27 * Typical usage is:
28 *  <code>
29 *   $metastoreService = new Google\Service\DataprocMetastore(...);
30 *   $databases = $metastoreService->databases;
31 *  </code>
32 */
33class ProjectsLocationsServicesDatabases extends \Google\Service\Resource
34{
35  /**
36   * Gets the access control policy for a resource. Returns an empty policy if the
37   * resource exists and does not have a policy set. (databases.getIamPolicy)
38   *
39   * @param string $resource REQUIRED: The resource for which the policy is being
40   * requested. See the operation documentation for the appropriate value for this
41   * field.
42   * @param array $optParams Optional parameters.
43   *
44   * @opt_param int options.requestedPolicyVersion Optional. The maximum policy
45   * version that will be used to format the policy.Valid values are 0, 1, and 3.
46   * Requests specifying an invalid value will be rejected.Requests for policies
47   * with any conditional role bindings must specify version 3. Policies with no
48   * conditional role bindings may specify any valid value or leave the field
49   * unset.The policy in the response might use the policy version that you
50   * specified, or it might use a lower policy version. For example, if you
51   * specify version 3, but the policy has no conditional role bindings, the
52   * response uses version 1.To learn which resources support conditions in their
53   * IAM policies, see the IAM documentation
54   * (https://cloud.google.com/iam/help/conditions/resource-policies).
55   * @return Policy
56   */
57  public function getIamPolicy($resource, $optParams = [])
58  {
59    $params = ['resource' => $resource];
60    $params = array_merge($params, $optParams);
61    return $this->call('getIamPolicy', [$params], Policy::class);
62  }
63  /**
64   * Sets the access control policy on the specified resource. Replaces any
65   * existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED
66   * errors. (databases.setIamPolicy)
67   *
68   * @param string $resource REQUIRED: The resource for which the policy is being
69   * specified. See the operation documentation for the appropriate value for this
70   * field.
71   * @param SetIamPolicyRequest $postBody
72   * @param array $optParams Optional parameters.
73   * @return Policy
74   */
75  public function setIamPolicy($resource, SetIamPolicyRequest $postBody, $optParams = [])
76  {
77    $params = ['resource' => $resource, 'postBody' => $postBody];
78    $params = array_merge($params, $optParams);
79    return $this->call('setIamPolicy', [$params], Policy::class);
80  }
81  /**
82   * Returns permissions that a caller has on the specified resource. If the
83   * resource does not exist, this will return an empty set of permissions, not a
84   * NOT_FOUND error.Note: This operation is designed to be used for building
85   * permission-aware UIs and command-line tools, not for authorization checking.
86   * This operation may "fail open" without warning.
87   * (databases.testIamPermissions)
88   *
89   * @param string $resource REQUIRED: The resource for which the policy detail is
90   * being requested. See the operation documentation for the appropriate value
91   * for this field.
92   * @param TestIamPermissionsRequest $postBody
93   * @param array $optParams Optional parameters.
94   * @return TestIamPermissionsResponse
95   */
96  public function testIamPermissions($resource, TestIamPermissionsRequest $postBody, $optParams = [])
97  {
98    $params = ['resource' => $resource, 'postBody' => $postBody];
99    $params = array_merge($params, $optParams);
100    return $this->call('testIamPermissions', [$params], TestIamPermissionsResponse::class);
101  }
102}
103
104// Adding a class alias for backwards compatibility with the previous class name.
105class_alias(ProjectsLocationsServicesDatabases::class, 'Google_Service_DataprocMetastore_Resource_ProjectsLocationsServicesDatabases');
106