async def test_export_iam_policy_analysis_field_headers_async(): client = AssetServiceAsyncClient( credentials=credentials.AnonymousCredentials(), ) # Any value that is part of the HTTP/1.1 URI should be sent as # a field header. Set these to a non-empty value. request = asset_service.ExportIamPolicyAnalysisRequest() request.analysis_query.parent = "analysis_query.parent/value" # Mock the actual call within the gRPC stub, and fake the request. with mock.patch.object(type(client.transport.export_iam_policy_analysis), "__call__") as call: call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( operations_pb2.Operation(name="operations/op")) await client.export_iam_policy_analysis(request) # Establish that the underlying gRPC stub method was called. assert len(call.mock_calls) _, args, _ = call.mock_calls[0] assert args[0] == request # Establish that the field header was sent. _, _, kw = call.mock_calls[0] assert ( "x-goog-request-params", "analysis_query.parent=analysis_query.parent/value", ) in kw["metadata"]
async def test_export_iam_policy_analysis_async( transport: str = "grpc_asyncio", request_type=asset_service.ExportIamPolicyAnalysisRequest, ): client = AssetServiceAsyncClient( credentials=credentials.AnonymousCredentials(), transport=transport, ) # Everything is optional in proto3 as far as the runtime is concerned, # and we are mocking out the actual API, so just send an empty request. request = request_type() # Mock the actual call within the gRPC stub, and fake the request. with mock.patch.object(type(client.transport.export_iam_policy_analysis), "__call__") as call: # Designate an appropriate return value for the call. call.return_value = grpc_helpers_async.FakeUnaryUnaryCall( operations_pb2.Operation(name="operations/spam")) response = await client.export_iam_policy_analysis(request) # Establish that the underlying gRPC stub method was called. assert len(call.mock_calls) _, args, _ = call.mock_calls[0] assert args[0] == asset_service.ExportIamPolicyAnalysisRequest() # Establish that the response is the type that we expect. assert isinstance(response, future.Future)
def test_export_iam_policy_analysis_empty_call(): # This test is a coverage failsafe to make sure that totally empty calls, # i.e. request == None and no flattened fields passed, work. client = AssetServiceClient( credentials=credentials.AnonymousCredentials(), transport="grpc", ) # Mock the actual call within the gRPC stub, and fake the request. with mock.patch.object(type(client.transport.export_iam_policy_analysis), "__call__") as call: client.export_iam_policy_analysis() call.assert_called() _, args, _ = call.mock_calls[0] assert args[0] == asset_service.ExportIamPolicyAnalysisRequest()
def export_iam_policy_analysis( self, request: asset_service.ExportIamPolicyAnalysisRequest = None, *, retry: retries.Retry = gapic_v1.method.DEFAULT, timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> operation.Operation: r"""Exports IAM policy analysis based on the specified request. This API implements the [google.longrunning.Operation][google.longrunning.Operation] API allowing you to keep track of the export. The metadata contains the request to help callers to map responses to requests. Args: request (:class:`~.asset_service.ExportIamPolicyAnalysisRequest`): The request object. A request message for [AssetService.ExportIamPolicyAnalysis][google.cloud.asset.v1p4beta1.AssetService.ExportIamPolicyAnalysis]. retry (google.api_core.retry.Retry): Designation of what errors, if any, should be retried. timeout (float): The timeout for this request. metadata (Sequence[Tuple[str, str]]): Strings which should be sent along with the request as metadata. Returns: ~.operation.Operation: An object representing a long-running operation. The result type for the operation will be :class:``~.asset_service.ExportIamPolicyAnalysisResponse``: The export IAM policy analysis response. This message is returned by the [google.longrunning.Operations.GetOperation][] method in the returned [google.longrunning.Operation.response][] field. """ # Create or coerce a protobuf request object. # Minor optimization to avoid making a copy if the user passes # in a asset_service.ExportIamPolicyAnalysisRequest. # There's no risk of modifying the input as we've already verified # there are no flattened fields. if not isinstance(request, asset_service.ExportIamPolicyAnalysisRequest): request = asset_service.ExportIamPolicyAnalysisRequest(request) # Wrap the RPC method; this adds retry and timeout information, # and friendly error handling. rpc = self._transport._wrapped_methods[ self._transport.export_iam_policy_analysis] # Certain fields should be provided within the metadata header; # add these here. metadata = tuple(metadata) + (gapic_v1.routing_header.to_grpc_metadata( (("analysis_query.parent", request.analysis_query.parent), )), ) # Send the request. response = rpc( request, retry=retry, timeout=timeout, metadata=metadata, ) # Wrap the response in an operation future. response = operation.from_gapic( response, self._transport.operations_client, asset_service.ExportIamPolicyAnalysisResponse, metadata_type=asset_service.ExportIamPolicyAnalysisRequest, ) # Done; return the response. return response
def export_iam_policy_analysis( self, request: Union[asset_service.ExportIamPolicyAnalysisRequest, dict] = None, *, retry: OptionalRetry = gapic_v1.method.DEFAULT, timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> operation.Operation: r"""Exports IAM policy analysis based on the specified request. This API implements the [google.longrunning.Operation][google.longrunning.Operation] API allowing you to keep track of the export. The metadata contains the request to help callers to map responses to requests. .. code-block:: python from google.cloud import asset_v1p4beta1 def sample_export_iam_policy_analysis(): # Create a client client = asset_v1p4beta1.AssetServiceClient() # Initialize request argument(s) analysis_query = asset_v1p4beta1.IamPolicyAnalysisQuery() analysis_query.parent = "parent_value" output_config = asset_v1p4beta1.IamPolicyAnalysisOutputConfig() output_config.gcs_destination.uri = "uri_value" request = asset_v1p4beta1.ExportIamPolicyAnalysisRequest( analysis_query=analysis_query, output_config=output_config, ) # Make the request operation = client.export_iam_policy_analysis(request=request) print("Waiting for operation to complete...") response = operation.result() # Handle the response print(response) Args: request (Union[google.cloud.asset_v1p4beta1.types.ExportIamPolicyAnalysisRequest, dict]): The request object. A request message for [AssetService.ExportIamPolicyAnalysis][google.cloud.asset.v1p4beta1.AssetService.ExportIamPolicyAnalysis]. retry (google.api_core.retry.Retry): Designation of what errors, if any, should be retried. timeout (float): The timeout for this request. metadata (Sequence[Tuple[str, str]]): Strings which should be sent along with the request as metadata. Returns: google.api_core.operation.Operation: An object representing a long-running operation. The result type for the operation will be :class:`google.cloud.asset_v1p4beta1.types.ExportIamPolicyAnalysisResponse` The export IAM policy analysis response. This message is returned by the [google.longrunning.Operations.GetOperation][] method in the returned [google.longrunning.Operation.response][] field. """ # Create or coerce a protobuf request object. # Minor optimization to avoid making a copy if the user passes # in a asset_service.ExportIamPolicyAnalysisRequest. # There's no risk of modifying the input as we've already verified # there are no flattened fields. if not isinstance(request, asset_service.ExportIamPolicyAnalysisRequest): request = asset_service.ExportIamPolicyAnalysisRequest(request) # Wrap the RPC method; this adds retry and timeout information, # and friendly error handling. rpc = self._transport._wrapped_methods[ self._transport.export_iam_policy_analysis] # Certain fields should be provided within the metadata header; # add these here. metadata = tuple(metadata) + (gapic_v1.routing_header.to_grpc_metadata( (("analysis_query.parent", request.analysis_query.parent), )), ) # Send the request. response = rpc( request, retry=retry, timeout=timeout, metadata=metadata, ) # Wrap the response in an operation future. response = operation.from_gapic( response, self._transport.operations_client, asset_service.ExportIamPolicyAnalysisResponse, metadata_type=asset_service.ExportIamPolicyAnalysisRequest, ) # Done; return the response. return response
async def export_iam_policy_analysis( self, request: asset_service.ExportIamPolicyAnalysisRequest = None, *, retry: retries.Retry = gapic_v1.method.DEFAULT, timeout: float = None, metadata: Sequence[Tuple[str, str]] = (), ) -> operation_async.AsyncOperation: r"""Exports IAM policy analysis based on the specified request. This API implements the [google.longrunning.Operation][google.longrunning.Operation] API allowing you to keep track of the export. The metadata contains the request to help callers to map responses to requests. Args: request (:class:`google.cloud.asset_v1p4beta1.types.ExportIamPolicyAnalysisRequest`): The request object. A request message for [AssetService.ExportIamPolicyAnalysis][google.cloud.asset.v1p4beta1.AssetService.ExportIamPolicyAnalysis]. retry (google.api_core.retry.Retry): Designation of what errors, if any, should be retried. timeout (float): The timeout for this request. metadata (Sequence[Tuple[str, str]]): Strings which should be sent along with the request as metadata. Returns: google.api_core.operation_async.AsyncOperation: An object representing a long-running operation. The result type for the operation will be :class:`google.cloud.asset_v1p4beta1.types.ExportIamPolicyAnalysisResponse` The export IAM policy analysis response. This message is returned by the [google.longrunning.Operations.GetOperation][] method in the returned [google.longrunning.Operation.response][] field. """ # Create or coerce a protobuf request object. request = asset_service.ExportIamPolicyAnalysisRequest(request) # Wrap the RPC method; this adds retry and timeout information, # and friendly error handling. rpc = gapic_v1.method_async.wrap_method( self._client._transport.export_iam_policy_analysis, default_timeout=60.0, client_info=DEFAULT_CLIENT_INFO, ) # Certain fields should be provided within the metadata header; # add these here. metadata = tuple(metadata) + ( gapic_v1.routing_header.to_grpc_metadata( (("analysis_query.parent", request.analysis_query.parent),) ), ) # Send the request. response = await rpc(request, retry=retry, timeout=timeout, metadata=metadata,) # Wrap the response in an operation future. response = operation_async.from_gapic( response, self._client._transport.operations_client, asset_service.ExportIamPolicyAnalysisResponse, metadata_type=asset_service.ExportIamPolicyAnalysisRequest, ) # Done; return the response. return response