Coverage for /pythoncovmergedfiles/medio/medio/usr/local/lib/python3.11/site-packages/google/cloud/secretmanager_v1beta1/services/secret_manager_service/async

1868 :literal:`` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 }`\ \`

1869

1870 **YAML example:**

1871

1872 :literal:`` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3`\ \`

1873

1874 For a description of IAM and its features, see the

1875 [IAM

1876 documentation](https://cloud.google.com/iam/docs/).

1877

1878 """

1879 # Create or coerce a protobuf request object.

1880 # - The request isn't a proto-plus wrapped type,

1881 # so it must be constructed via keyword expansion.

1882 if isinstance(request, dict):

1883 request = iam_policy_pb2.SetIamPolicyRequest(**request)

1884 elif not request:

1885 request = iam_policy_pb2.SetIamPolicyRequest()

1886

1887 # Wrap the RPC method; this adds retry and timeout information,

1888 # and friendly error handling.

1889 rpc = self._client._transport._wrapped_methods[

1890 self._client._transport.set_iam_policy

1891 ]

1892

1893 # Certain fields should be provided within the metadata header;

1894 # add these here.

1895 metadata = tuple(metadata) + (

1896 gapic_v1.routing_header.to_grpc_metadata((("resource", request.resource),)),

1897 )

1898

1899 # Validate the universe domain.

1900 self._client._validate_universe_domain()

1901

1902 # Send the request.

1903 response = await rpc(

1904 request,

1905 retry=retry,

1906 timeout=timeout,

1907 metadata=metadata,

1908 )

1909

1910 # Done; return the response.

1911 return response

1912

1913 async def get_iam_policy(

1914 self,

1915 request: Optional[Union[iam_policy_pb2.GetIamPolicyRequest, dict]] = None,

1916 *,

1917 retry: OptionalRetry = gapic_v1.method.DEFAULT,

1918 timeout: Union[float, object] = gapic_v1.method.DEFAULT,

1919 metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),

1920 ) -> policy_pb2.Policy:

1921 r"""Gets the access control policy for a secret.

1922 Returns empty policy if the secret exists and does not

1923 have a policy set.

1924

1925 .. code-block:: python

1926

1927 # This snippet has been automatically generated and should be regarded as a

1928 # code template only.

1929 # It will require modifications to work:

1930 # - It may require correct/in-range values for request initialization.

1931 # - It may require specifying regional endpoints when creating the service

1932 # client as shown in:

1933 # https://googleapis.dev/python/google-api-core/latest/client_options.html

1934 from google.cloud import secretmanager_v1beta1

1935 import google.iam.v1.iam_policy_pb2 as iam_policy_pb2 # type: ignore

1936

1937 async def sample_get_iam_policy():

1938 # Create a client

1939 client = secretmanager_v1beta1.SecretManagerServiceAsyncClient()

1940

1941 # Initialize request argument(s)

1942 request = iam_policy_pb2.GetIamPolicyRequest(

1943 resource="resource_value",

1944 )

1945

1946 # Make the request

1947 response = await client.get_iam_policy(request=request)

1948

1949 # Handle the response

1950 print(response)

1951

1952 Args:

1953 request (Optional[Union[google.iam.v1.iam_policy_pb2.GetIamPolicyRequest, dict]]):

1954 The request object. Request message for ``GetIamPolicy`` method.

1955 retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any,

1956 should be retried.

1957 timeout (float): The timeout for this request.

1958 metadata (Sequence[Tuple[str, Union[str, bytes]]]): Key/value pairs which should be

1959 sent along with the request as metadata. Normally, each value must be of type `str`,

1960 but for metadata keys ending with the suffix `-bin`, the corresponding values must

1961 be of type `bytes`.

1962

1963 Returns:

1964 google.iam.v1.policy_pb2.Policy:

1965 An Identity and Access Management (IAM) policy, which specifies access

1966 controls for Google Cloud resources.

1967

1968 A Policy is a collection of bindings. A binding binds

1969 one or more members, or principals, to a single role.

1970 Principals can be user accounts, service accounts,

1971 Google groups, and domains (such as G Suite). A role

1972 is a named list of permissions; each role can be an

1973 IAM predefined role or a user-created custom role.

1974

1975 For some types of Google Cloud resources, a binding

1976 can also specify a condition, which is a logical

1977 expression that allows access to a resource only if

1978 the expression evaluates to true. A condition can add

1979 constraints based on attributes of the request, the

1980 resource, or both. To learn which resources support

1981 conditions in their IAM policies, see the [IAM

1982 documentation](https://cloud.google.com/iam/help/conditions/resource-policies).

1983

1984 **JSON example:**

1985

1986 :literal:`` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 }`\ \`

1987

1988 **YAML example:**

1989

1990 :literal:`` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3`\ \`

1991

1992 For a description of IAM and its features, see the

1993 [IAM

1994 documentation](https://cloud.google.com/iam/docs/).

1995

1996 """

1997 # Create or coerce a protobuf request object.

1998 # - The request isn't a proto-plus wrapped type,

1999 # so it must be constructed via keyword expansion.

2000 if isinstance(request, dict):

2001 request = iam_policy_pb2.GetIamPolicyRequest(**request)

2002 elif not request: