XRayAsyncClient (AWS SDK for Java

All Superinterfaces:

AutoCloseable, SdkAutoCloseable, SdkClient
```
@Generated(value="software.amazon.awssdk:codegen")
public interface XRayAsyncClient
extends SdkClient
```
Service client for accessing AWS X-Ray asynchronously. This can be created using the static builder() method.
AWS X-Ray provides APIs for managing debug traces and retrieving service maps and other data created by processing those traces.

Field Summary

Fields
Modifier and Type Field and Description

static String SERVICE_NAME

Fields
Modifier and Type	Field and Description
`static String`	`SERVICE_NAME`

Method Summary

All Methods Static Methods Instance Methods Default Methods
Modifier and Type	Method and Description
`default CompletableFuture<BatchGetTracesResponse>`	`batchGetTraces(BatchGetTracesRequest batchGetTracesRequest)` Retrieves a list of traces specified by ID.
`default CompletableFuture<BatchGetTracesResponse>`	`batchGetTraces(Consumer<BatchGetTracesRequest.Builder> batchGetTracesRequest)` Retrieves a list of traces specified by ID.
`default BatchGetTracesPublisher`	`batchGetTracesPaginator(BatchGetTracesRequest batchGetTracesRequest)` Retrieves a list of traces specified by ID.
`default BatchGetTracesPublisher`	`batchGetTracesPaginator(Consumer<BatchGetTracesRequest.Builder> batchGetTracesRequest)` Retrieves a list of traces specified by ID.
`static XRayAsyncClientBuilder`	`builder()` Create a builder that can be used to configure and create a `XRayAsyncClient`.
`static XRayAsyncClient`	`create()` Create a `XRayAsyncClient` with the region loaded from the `DefaultAwsRegionProviderChain` and credentials loaded from the `DefaultCredentialsProvider`.
`default CompletableFuture<CreateGroupResponse>`	`createGroup(Consumer<CreateGroupRequest.Builder> createGroupRequest)` Creates a group resource with a name and a filter expression.
`default CompletableFuture<CreateGroupResponse>`	`createGroup(CreateGroupRequest createGroupRequest)` Creates a group resource with a name and a filter expression.
`default CompletableFuture<CreateSamplingRuleResponse>`	`createSamplingRule(Consumer<CreateSamplingRuleRequest.Builder> createSamplingRuleRequest)` Creates a rule to control sampling behavior for instrumented applications.
`default CompletableFuture<CreateSamplingRuleResponse>`	`createSamplingRule(CreateSamplingRuleRequest createSamplingRuleRequest)` Creates a rule to control sampling behavior for instrumented applications.
`default CompletableFuture<DeleteGroupResponse>`	`deleteGroup(Consumer<DeleteGroupRequest.Builder> deleteGroupRequest)` Deletes a group resource.
`default CompletableFuture<DeleteGroupResponse>`	`deleteGroup(DeleteGroupRequest deleteGroupRequest)` Deletes a group resource.
`default CompletableFuture<DeleteSamplingRuleResponse>`	`deleteSamplingRule(Consumer<DeleteSamplingRuleRequest.Builder> deleteSamplingRuleRequest)` Deletes a sampling rule.
`default CompletableFuture<DeleteSamplingRuleResponse>`	`deleteSamplingRule(DeleteSamplingRuleRequest deleteSamplingRuleRequest)` Deletes a sampling rule.
`default CompletableFuture<GetEncryptionConfigResponse>`	`getEncryptionConfig()` Retrieves the current encryption configuration for X-Ray data.
`default CompletableFuture<GetEncryptionConfigResponse>`	`getEncryptionConfig(Consumer<GetEncryptionConfigRequest.Builder> getEncryptionConfigRequest)` Retrieves the current encryption configuration for X-Ray data.
`default CompletableFuture<GetEncryptionConfigResponse>`	`getEncryptionConfig(GetEncryptionConfigRequest getEncryptionConfigRequest)` Retrieves the current encryption configuration for X-Ray data.
`default CompletableFuture<GetGroupResponse>`	`getGroup(Consumer<GetGroupRequest.Builder> getGroupRequest)` Retrieves group resource details.
`default CompletableFuture<GetGroupResponse>`	`getGroup(GetGroupRequest getGroupRequest)` Retrieves group resource details.
`default CompletableFuture<GetGroupsResponse>`	`getGroups()` Retrieves all active group details.
`default CompletableFuture<GetGroupsResponse>`	`getGroups(Consumer<GetGroupsRequest.Builder> getGroupsRequest)` Retrieves all active group details.
`default CompletableFuture<GetGroupsResponse>`	`getGroups(GetGroupsRequest getGroupsRequest)` Retrieves all active group details.
`default CompletableFuture<GetSamplingRulesResponse>`	`getSamplingRules()` Retrieves all sampling rules.
`default CompletableFuture<GetSamplingRulesResponse>`	`getSamplingRules(Consumer<GetSamplingRulesRequest.Builder> getSamplingRulesRequest)` Retrieves all sampling rules.
`default CompletableFuture<GetSamplingRulesResponse>`	`getSamplingRules(GetSamplingRulesRequest getSamplingRulesRequest)` Retrieves all sampling rules.
`default CompletableFuture<GetSamplingStatisticSummariesResponse>`	`getSamplingStatisticSummaries()` Retrieves information about recent sampling results for all sampling rules.
`default CompletableFuture<GetSamplingStatisticSummariesResponse>`	`getSamplingStatisticSummaries(Consumer<GetSamplingStatisticSummariesRequest.Builder> getSamplingStatisticSummariesRequest)` Retrieves information about recent sampling results for all sampling rules.
`default CompletableFuture<GetSamplingStatisticSummariesResponse>`	`getSamplingStatisticSummaries(GetSamplingStatisticSummariesRequest getSamplingStatisticSummariesRequest)` Retrieves information about recent sampling results for all sampling rules.
`default CompletableFuture<GetSamplingTargetsResponse>`	`getSamplingTargets(Consumer<GetSamplingTargetsRequest.Builder> getSamplingTargetsRequest)` Requests a sampling quota for rules that the service is using to sample requests.
`default CompletableFuture<GetSamplingTargetsResponse>`	`getSamplingTargets(GetSamplingTargetsRequest getSamplingTargetsRequest)` Requests a sampling quota for rules that the service is using to sample requests.
`default CompletableFuture<GetServiceGraphResponse>`	`getServiceGraph(Consumer<GetServiceGraphRequest.Builder> getServiceGraphRequest)` Retrieves a document that describes services that process incoming requests, and downstream services that they call as a result.
`default CompletableFuture<GetServiceGraphResponse>`	`getServiceGraph(GetServiceGraphRequest getServiceGraphRequest)` Retrieves a document that describes services that process incoming requests, and downstream services that they call as a result.
`default GetServiceGraphPublisher`	`getServiceGraphPaginator(Consumer<GetServiceGraphRequest.Builder> getServiceGraphRequest)` Retrieves a document that describes services that process incoming requests, and downstream services that they call as a result.
`default GetServiceGraphPublisher`	`getServiceGraphPaginator(GetServiceGraphRequest getServiceGraphRequest)` Retrieves a document that describes services that process incoming requests, and downstream services that they call as a result.
`default CompletableFuture<GetTraceGraphResponse>`	`getTraceGraph(Consumer<GetTraceGraphRequest.Builder> getTraceGraphRequest)` Retrieves a service graph for one or more specific trace IDs.
`default CompletableFuture<GetTraceGraphResponse>`	`getTraceGraph(GetTraceGraphRequest getTraceGraphRequest)` Retrieves a service graph for one or more specific trace IDs.
`default GetTraceGraphPublisher`	`getTraceGraphPaginator(Consumer<GetTraceGraphRequest.Builder> getTraceGraphRequest)` Retrieves a service graph for one or more specific trace IDs.
`default GetTraceGraphPublisher`	`getTraceGraphPaginator(GetTraceGraphRequest getTraceGraphRequest)` Retrieves a service graph for one or more specific trace IDs.
`default CompletableFuture<GetTraceSummariesResponse>`	`getTraceSummaries(Consumer<GetTraceSummariesRequest.Builder> getTraceSummariesRequest)` Retrieves IDs and metadata for traces available for a specified time frame using an optional filter.
`default CompletableFuture<GetTraceSummariesResponse>`	`getTraceSummaries(GetTraceSummariesRequest getTraceSummariesRequest)` Retrieves IDs and metadata for traces available for a specified time frame using an optional filter.
`default GetTraceSummariesPublisher`	`getTraceSummariesPaginator(Consumer<GetTraceSummariesRequest.Builder> getTraceSummariesRequest)` Retrieves IDs and metadata for traces available for a specified time frame using an optional filter.
`default GetTraceSummariesPublisher`	`getTraceSummariesPaginator(GetTraceSummariesRequest getTraceSummariesRequest)` Retrieves IDs and metadata for traces available for a specified time frame using an optional filter.
`default CompletableFuture<PutEncryptionConfigResponse>`	`putEncryptionConfig(Consumer<PutEncryptionConfigRequest.Builder> putEncryptionConfigRequest)` Updates the encryption configuration for X-Ray data.
`default CompletableFuture<PutEncryptionConfigResponse>`	`putEncryptionConfig(PutEncryptionConfigRequest putEncryptionConfigRequest)` Updates the encryption configuration for X-Ray data.
`default CompletableFuture<PutTelemetryRecordsResponse>`	`putTelemetryRecords(Consumer<PutTelemetryRecordsRequest.Builder> putTelemetryRecordsRequest)` Used by the AWS X-Ray daemon to upload telemetry.
`default CompletableFuture<PutTelemetryRecordsResponse>`	`putTelemetryRecords(PutTelemetryRecordsRequest putTelemetryRecordsRequest)` Used by the AWS X-Ray daemon to upload telemetry.
`default CompletableFuture<PutTraceSegmentsResponse>`	`putTraceSegments(Consumer<PutTraceSegmentsRequest.Builder> putTraceSegmentsRequest)` Uploads segment documents to AWS X-Ray.
`default CompletableFuture<PutTraceSegmentsResponse>`	`putTraceSegments(PutTraceSegmentsRequest putTraceSegmentsRequest)` Uploads segment documents to AWS X-Ray.
`default CompletableFuture<UpdateGroupResponse>`	`updateGroup(Consumer<UpdateGroupRequest.Builder> updateGroupRequest)` Updates a group resource.
`default CompletableFuture<UpdateGroupResponse>`	`updateGroup(UpdateGroupRequest updateGroupRequest)` Updates a group resource.
`default CompletableFuture<UpdateSamplingRuleResponse>`	`updateSamplingRule(Consumer<UpdateSamplingRuleRequest.Builder> updateSamplingRuleRequest)` Modifies a sampling rule's configuration.
`default CompletableFuture<UpdateSamplingRuleResponse>`	`updateSamplingRule(UpdateSamplingRuleRequest updateSamplingRuleRequest)` Modifies a sampling rule's configuration.

Methods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName

Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
close

- Field Detail
  - SERVICE_NAME
```
static final String SERVICE_NAME
```
    See Also:
    
    Constant Field Values
- Method Detail
  - create
```
static XRayAsyncClient create()
```
    Create a XRayAsyncClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.
  - builder
```
static XRayAsyncClientBuilder builder()
```
    Create a builder that can be used to configure and create a XRayAsyncClient.
  - batchGetTraces
```
default CompletableFuture<BatchGetTracesResponse> batchGetTraces(BatchGetTracesRequest batchGetTracesRequest)
```
    Retrieves a list of traces specified by ID. Each trace is a collection of segment documents that originates from a single request. Use GetTraceSummaries to get a list of trace IDs.
    Parameters:
    
    batchGetTracesRequest -
    
    Returns:
    A Java Future containing the result of the BatchGetTraces operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - batchGetTraces
```
default CompletableFuture<BatchGetTracesResponse> batchGetTraces(Consumer<BatchGetTracesRequest.Builder> batchGetTracesRequest)
```
    Retrieves a list of traces specified by ID. Each trace is a collection of segment documents that originates from a single request. Use GetTraceSummaries to get a list of trace IDs.
    
    This is a convenience which creates an instance of the BatchGetTracesRequest.Builder avoiding the need to create one manually via BatchGetTracesRequest.builder()
    Parameters:
    
    batchGetTracesRequest - A Consumer that will call methods on BatchGetTracesRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the BatchGetTraces operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - batchGetTracesPaginator
```
default BatchGetTracesPublisher batchGetTracesPaginator(BatchGetTracesRequest batchGetTracesRequest)
```
    Retrieves a list of traces specified by ID. Each trace is a collection of segment documents that originates from a single request. Use GetTraceSummaries to get a list of trace IDs.
    
    This is a variant of batchGetTraces(software.amazon.awssdk.services.xray.model.BatchGetTracesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.
    
    When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.
    
    The following are few ways to use the response class:
    1) Using the subscribe helper method
```
 
 software.amazon.awssdk.services.xray.paginators.BatchGetTracesPublisher publisher = client.batchGetTracesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
 
 
```
    2) Using a custom subscriber
```
 
 software.amazon.awssdk.services.xray.paginators.BatchGetTracesPublisher publisher = client.batchGetTracesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.xray.model.BatchGetTracesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.xray.model.BatchGetTracesResponse response) { //... };
 });
 
```
    As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
    Note: If you prefer to have control on service calls, use the batchGetTraces(software.amazon.awssdk.services.xray.model.BatchGetTracesRequest) operation.
    Parameters:
    
    batchGetTracesRequest -
    
    Returns:
    A custom publisher that can be subscribed to request a stream of response pages.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - batchGetTracesPaginator
```
default BatchGetTracesPublisher batchGetTracesPaginator(Consumer<BatchGetTracesRequest.Builder> batchGetTracesRequest)
```
    Retrieves a list of traces specified by ID. Each trace is a collection of segment documents that originates from a single request. Use GetTraceSummaries to get a list of trace IDs.
    
    This is a variant of batchGetTraces(software.amazon.awssdk.services.xray.model.BatchGetTracesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.
    
    When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.
    
    The following are few ways to use the response class:
    1) Using the subscribe helper method
```
 
 software.amazon.awssdk.services.xray.paginators.BatchGetTracesPublisher publisher = client.batchGetTracesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
 
 
```
    2) Using a custom subscriber
```
 
 software.amazon.awssdk.services.xray.paginators.BatchGetTracesPublisher publisher = client.batchGetTracesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.xray.model.BatchGetTracesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.xray.model.BatchGetTracesResponse response) { //... };
 });
 
```
    As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
    Note: If you prefer to have control on service calls, use the batchGetTraces(software.amazon.awssdk.services.xray.model.BatchGetTracesRequest) operation.
    
    This is a convenience which creates an instance of the BatchGetTracesRequest.Builder avoiding the need to create one manually via BatchGetTracesRequest.builder()
    Parameters:
    
    batchGetTracesRequest - A Consumer that will call methods on BatchGetTracesRequest.Builder to create a request.
    
    Returns:
    A custom publisher that can be subscribed to request a stream of response pages.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - createGroup
```
default CompletableFuture<CreateGroupResponse> createGroup(CreateGroupRequest createGroupRequest)
```
    Creates a group resource with a name and a filter expression.
    Parameters:
    
    createGroupRequest -
    
    Returns:
    A Java Future containing the result of the CreateGroup operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - createGroup
```
default CompletableFuture<CreateGroupResponse> createGroup(Consumer<CreateGroupRequest.Builder> createGroupRequest)
```
    Creates a group resource with a name and a filter expression.
    
    This is a convenience which creates an instance of the CreateGroupRequest.Builder avoiding the need to create one manually via CreateGroupRequest.builder()
    Parameters:
    
    createGroupRequest - A Consumer that will call methods on CreateGroupRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the CreateGroup operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - createSamplingRule
```
default CompletableFuture<CreateSamplingRuleResponse> createSamplingRule(CreateSamplingRuleRequest createSamplingRuleRequest)
```
    Creates a rule to control sampling behavior for instrumented applications. Services retrieve rules with GetSamplingRules, and evaluate each rule in ascending order of priority for each request. If a rule matches, the service records a trace, borrowing it from the reservoir size. After 10 seconds, the service reports back to X-Ray with GetSamplingTargets to get updated versions of each in-use rule. The updated rule contains a trace quota that the service can use instead of borrowing from the reservoir.
    Parameters:
    
    createSamplingRuleRequest -
    
    Returns:
    A Java Future containing the result of the CreateSamplingRule operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    RuleLimitExceededException You have reached the maximum number of sampling rules.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - createSamplingRule
```
default CompletableFuture<CreateSamplingRuleResponse> createSamplingRule(Consumer<CreateSamplingRuleRequest.Builder> createSamplingRuleRequest)
```
    Creates a rule to control sampling behavior for instrumented applications. Services retrieve rules with GetSamplingRules, and evaluate each rule in ascending order of priority for each request. If a rule matches, the service records a trace, borrowing it from the reservoir size. After 10 seconds, the service reports back to X-Ray with GetSamplingTargets to get updated versions of each in-use rule. The updated rule contains a trace quota that the service can use instead of borrowing from the reservoir.
    
    This is a convenience which creates an instance of the CreateSamplingRuleRequest.Builder avoiding the need to create one manually via CreateSamplingRuleRequest.builder()
    Parameters:
    
    createSamplingRuleRequest - A Consumer that will call methods on CreateSamplingRuleRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the CreateSamplingRule operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    RuleLimitExceededException You have reached the maximum number of sampling rules.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - deleteGroup
```
default CompletableFuture<DeleteGroupResponse> deleteGroup(DeleteGroupRequest deleteGroupRequest)
```
    Deletes a group resource.
    Parameters:
    
    deleteGroupRequest -
    
    Returns:
    A Java Future containing the result of the DeleteGroup operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - deleteGroup
```
default CompletableFuture<DeleteGroupResponse> deleteGroup(Consumer<DeleteGroupRequest.Builder> deleteGroupRequest)
```
    Deletes a group resource.
    
    This is a convenience which creates an instance of the DeleteGroupRequest.Builder avoiding the need to create one manually via DeleteGroupRequest.builder()
    Parameters:
    
    deleteGroupRequest - A Consumer that will call methods on DeleteGroupRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the DeleteGroup operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - deleteSamplingRule
```
default CompletableFuture<DeleteSamplingRuleResponse> deleteSamplingRule(DeleteSamplingRuleRequest deleteSamplingRuleRequest)
```
    Deletes a sampling rule.
    Parameters:
    
    deleteSamplingRuleRequest -
    
    Returns:
    A Java Future containing the result of the DeleteSamplingRule operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - deleteSamplingRule
```
default CompletableFuture<DeleteSamplingRuleResponse> deleteSamplingRule(Consumer<DeleteSamplingRuleRequest.Builder> deleteSamplingRuleRequest)
```
    Deletes a sampling rule.
    
    This is a convenience which creates an instance of the DeleteSamplingRuleRequest.Builder avoiding the need to create one manually via DeleteSamplingRuleRequest.builder()
    Parameters:
    
    deleteSamplingRuleRequest - A Consumer that will call methods on DeleteSamplingRuleRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the DeleteSamplingRule operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getEncryptionConfig
```
default CompletableFuture<GetEncryptionConfigResponse> getEncryptionConfig(GetEncryptionConfigRequest getEncryptionConfigRequest)
```
    Retrieves the current encryption configuration for X-Ray data.
    Parameters:
    
    getEncryptionConfigRequest -
    
    Returns:
    A Java Future containing the result of the GetEncryptionConfig operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getEncryptionConfig
```
default CompletableFuture<GetEncryptionConfigResponse> getEncryptionConfig(Consumer<GetEncryptionConfigRequest.Builder> getEncryptionConfigRequest)
```
    Retrieves the current encryption configuration for X-Ray data.
    
    This is a convenience which creates an instance of the GetEncryptionConfigRequest.Builder avoiding the need to create one manually via GetEncryptionConfigRequest.builder()
    Parameters:
    
    getEncryptionConfigRequest - A Consumer that will call methods on GetEncryptionConfigRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the GetEncryptionConfig operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getEncryptionConfig
```
default CompletableFuture<GetEncryptionConfigResponse> getEncryptionConfig()
```
    Retrieves the current encryption configuration for X-Ray data.
    Returns:
    A Java Future containing the result of the GetEncryptionConfig operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getGroup
```
default CompletableFuture<GetGroupResponse> getGroup(GetGroupRequest getGroupRequest)
```
    Retrieves group resource details.
    Parameters:
    
    getGroupRequest -
    
    Returns:
    A Java Future containing the result of the GetGroup operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getGroup
```
default CompletableFuture<GetGroupResponse> getGroup(Consumer<GetGroupRequest.Builder> getGroupRequest)
```
    Retrieves group resource details.
    
    This is a convenience which creates an instance of the GetGroupRequest.Builder avoiding the need to create one manually via GetGroupRequest.builder()
    Parameters:
    
    getGroupRequest - A Consumer that will call methods on GetGroupRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the GetGroup operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getGroups
```
default CompletableFuture<GetGroupsResponse> getGroups(GetGroupsRequest getGroupsRequest)
```
    Retrieves all active group details.
    Parameters:
    
    getGroupsRequest -
    
    Returns:
    A Java Future containing the result of the GetGroups operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getGroups
```
default CompletableFuture<GetGroupsResponse> getGroups(Consumer<GetGroupsRequest.Builder> getGroupsRequest)
```
    Retrieves all active group details.
    
    This is a convenience which creates an instance of the GetGroupsRequest.Builder avoiding the need to create one manually via GetGroupsRequest.builder()
    Parameters:
    
    getGroupsRequest - A Consumer that will call methods on GetGroupsRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the GetGroups operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getGroups
```
default CompletableFuture<GetGroupsResponse> getGroups()
```
    Retrieves all active group details.
    Returns:
    A Java Future containing the result of the GetGroups operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getSamplingRules
```
default CompletableFuture<GetSamplingRulesResponse> getSamplingRules(GetSamplingRulesRequest getSamplingRulesRequest)
```
    Retrieves all sampling rules.
    Parameters:
    
    getSamplingRulesRequest -
    
    Returns:
    A Java Future containing the result of the GetSamplingRules operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getSamplingRules
```
default CompletableFuture<GetSamplingRulesResponse> getSamplingRules(Consumer<GetSamplingRulesRequest.Builder> getSamplingRulesRequest)
```
    Retrieves all sampling rules.
    
    This is a convenience which creates an instance of the GetSamplingRulesRequest.Builder avoiding the need to create one manually via GetSamplingRulesRequest.builder()
    Parameters:
    
    getSamplingRulesRequest - A Consumer that will call methods on GetSamplingRulesRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the GetSamplingRules operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getSamplingRules
```
default CompletableFuture<GetSamplingRulesResponse> getSamplingRules()
```
    Retrieves all sampling rules.
    Returns:
    A Java Future containing the result of the GetSamplingRules operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getSamplingStatisticSummaries
```
default CompletableFuture<GetSamplingStatisticSummariesResponse> getSamplingStatisticSummaries(GetSamplingStatisticSummariesRequest getSamplingStatisticSummariesRequest)
```
    Retrieves information about recent sampling results for all sampling rules.
    Parameters:
    
    getSamplingStatisticSummariesRequest -
    
    Returns:
    A Java Future containing the result of the GetSamplingStatisticSummaries operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getSamplingStatisticSummaries
```
default CompletableFuture<GetSamplingStatisticSummariesResponse> getSamplingStatisticSummaries(Consumer<GetSamplingStatisticSummariesRequest.Builder> getSamplingStatisticSummariesRequest)
```
    Retrieves information about recent sampling results for all sampling rules.
    
    This is a convenience which creates an instance of the GetSamplingStatisticSummariesRequest.Builder avoiding the need to create one manually via GetSamplingStatisticSummariesRequest.builder()
    Parameters:
    
    getSamplingStatisticSummariesRequest - A Consumer that will call methods on GetSamplingStatisticSummariesRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the GetSamplingStatisticSummaries operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getSamplingStatisticSummaries
```
default CompletableFuture<GetSamplingStatisticSummariesResponse> getSamplingStatisticSummaries()
```
    Retrieves information about recent sampling results for all sampling rules.
    Returns:
    A Java Future containing the result of the GetSamplingStatisticSummaries operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getSamplingTargets
```
default CompletableFuture<GetSamplingTargetsResponse> getSamplingTargets(GetSamplingTargetsRequest getSamplingTargetsRequest)
```
    Requests a sampling quota for rules that the service is using to sample requests.
    Parameters:
    
    getSamplingTargetsRequest -
    
    Returns:
    A Java Future containing the result of the GetSamplingTargets operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getSamplingTargets
```
default CompletableFuture<GetSamplingTargetsResponse> getSamplingTargets(Consumer<GetSamplingTargetsRequest.Builder> getSamplingTargetsRequest)
```
    Requests a sampling quota for rules that the service is using to sample requests.
    
    This is a convenience which creates an instance of the GetSamplingTargetsRequest.Builder avoiding the need to create one manually via GetSamplingTargetsRequest.builder()
    Parameters:
    
    getSamplingTargetsRequest - A Consumer that will call methods on GetSamplingTargetsRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the GetSamplingTargets operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getServiceGraph
```
default CompletableFuture<GetServiceGraphResponse> getServiceGraph(GetServiceGraphRequest getServiceGraphRequest)
```
    Retrieves a document that describes services that process incoming requests, and downstream services that they call as a result. Root services process incoming requests and make calls to downstream services. Root services are applications that use the AWS X-Ray SDK. Downstream services can be other applications, AWS resources, HTTP web APIs, or SQL databases.
    Parameters:
    
    getServiceGraphRequest -
    
    Returns:
    A Java Future containing the result of the GetServiceGraph operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getServiceGraph
```
default CompletableFuture<GetServiceGraphResponse> getServiceGraph(Consumer<GetServiceGraphRequest.Builder> getServiceGraphRequest)
```
    Retrieves a document that describes services that process incoming requests, and downstream services that they call as a result. Root services process incoming requests and make calls to downstream services. Root services are applications that use the AWS X-Ray SDK. Downstream services can be other applications, AWS resources, HTTP web APIs, or SQL databases.
    
    This is a convenience which creates an instance of the GetServiceGraphRequest.Builder avoiding the need to create one manually via GetServiceGraphRequest.builder()
    Parameters:
    
    getServiceGraphRequest - A Consumer that will call methods on GetServiceGraphRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the GetServiceGraph operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getServiceGraphPaginator
```
default GetServiceGraphPublisher getServiceGraphPaginator(GetServiceGraphRequest getServiceGraphRequest)
```
    Retrieves a document that describes services that process incoming requests, and downstream services that they call as a result. Root services process incoming requests and make calls to downstream services. Root services are applications that use the AWS X-Ray SDK. Downstream services can be other applications, AWS resources, HTTP web APIs, or SQL databases.
    
    This is a variant of getServiceGraph(software.amazon.awssdk.services.xray.model.GetServiceGraphRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.
    
    When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.
    
    The following are few ways to use the response class:
    1) Using the subscribe helper method
```
 
 software.amazon.awssdk.services.xray.paginators.GetServiceGraphPublisher publisher = client.getServiceGraphPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
 
 
```
    2) Using a custom subscriber
```
 
 software.amazon.awssdk.services.xray.paginators.GetServiceGraphPublisher publisher = client.getServiceGraphPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.xray.model.GetServiceGraphResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.xray.model.GetServiceGraphResponse response) { //... };
 });
 
```
    As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
    Note: If you prefer to have control on service calls, use the getServiceGraph(software.amazon.awssdk.services.xray.model.GetServiceGraphRequest) operation.
    Parameters:
    
    getServiceGraphRequest -
    
    Returns:
    A custom publisher that can be subscribed to request a stream of response pages.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getServiceGraphPaginator
```
default GetServiceGraphPublisher getServiceGraphPaginator(Consumer<GetServiceGraphRequest.Builder> getServiceGraphRequest)
```
    Retrieves a document that describes services that process incoming requests, and downstream services that they call as a result. Root services process incoming requests and make calls to downstream services. Root services are applications that use the AWS X-Ray SDK. Downstream services can be other applications, AWS resources, HTTP web APIs, or SQL databases.
    
    This is a variant of getServiceGraph(software.amazon.awssdk.services.xray.model.GetServiceGraphRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.
    
    When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.
    
    The following are few ways to use the response class:
    1) Using the subscribe helper method
```
 
 software.amazon.awssdk.services.xray.paginators.GetServiceGraphPublisher publisher = client.getServiceGraphPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
 
 
```
    2) Using a custom subscriber
```
 
 software.amazon.awssdk.services.xray.paginators.GetServiceGraphPublisher publisher = client.getServiceGraphPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.xray.model.GetServiceGraphResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.xray.model.GetServiceGraphResponse response) { //... };
 });
 
```
    As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
    Note: If you prefer to have control on service calls, use the getServiceGraph(software.amazon.awssdk.services.xray.model.GetServiceGraphRequest) operation.
    
    This is a convenience which creates an instance of the GetServiceGraphRequest.Builder avoiding the need to create one manually via GetServiceGraphRequest.builder()
    Parameters:
    
    getServiceGraphRequest - A Consumer that will call methods on GetServiceGraphRequest.Builder to create a request.
    
    Returns:
    A custom publisher that can be subscribed to request a stream of response pages.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getTraceGraph
```
default CompletableFuture<GetTraceGraphResponse> getTraceGraph(GetTraceGraphRequest getTraceGraphRequest)
```
    Retrieves a service graph for one or more specific trace IDs.
    Parameters:
    
    getTraceGraphRequest -
    
    Returns:
    A Java Future containing the result of the GetTraceGraph operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getTraceGraph
```
default CompletableFuture<GetTraceGraphResponse> getTraceGraph(Consumer<GetTraceGraphRequest.Builder> getTraceGraphRequest)
```
    Retrieves a service graph for one or more specific trace IDs.
    
    This is a convenience which creates an instance of the GetTraceGraphRequest.Builder avoiding the need to create one manually via GetTraceGraphRequest.builder()
    Parameters:
    
    getTraceGraphRequest - A Consumer that will call methods on GetTraceGraphRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the GetTraceGraph operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getTraceGraphPaginator
```
default GetTraceGraphPublisher getTraceGraphPaginator(GetTraceGraphRequest getTraceGraphRequest)
```
    Retrieves a service graph for one or more specific trace IDs.
    
    This is a variant of getTraceGraph(software.amazon.awssdk.services.xray.model.GetTraceGraphRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.
    
    When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.
    
    The following are few ways to use the response class:
    1) Using the subscribe helper method
```
 
 software.amazon.awssdk.services.xray.paginators.GetTraceGraphPublisher publisher = client.getTraceGraphPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
 
 
```
    2) Using a custom subscriber
```
 
 software.amazon.awssdk.services.xray.paginators.GetTraceGraphPublisher publisher = client.getTraceGraphPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.xray.model.GetTraceGraphResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.xray.model.GetTraceGraphResponse response) { //... };
 });
 
```
    As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
    Note: If you prefer to have control on service calls, use the getTraceGraph(software.amazon.awssdk.services.xray.model.GetTraceGraphRequest) operation.
    Parameters:
    
    getTraceGraphRequest -
    
    Returns:
    A custom publisher that can be subscribed to request a stream of response pages.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getTraceGraphPaginator
```
default GetTraceGraphPublisher getTraceGraphPaginator(Consumer<GetTraceGraphRequest.Builder> getTraceGraphRequest)
```
    Retrieves a service graph for one or more specific trace IDs.
    
    This is a variant of getTraceGraph(software.amazon.awssdk.services.xray.model.GetTraceGraphRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.
    
    When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.
    
    The following are few ways to use the response class:
    1) Using the subscribe helper method
```
 
 software.amazon.awssdk.services.xray.paginators.GetTraceGraphPublisher publisher = client.getTraceGraphPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
 
 
```
    2) Using a custom subscriber
```
 
 software.amazon.awssdk.services.xray.paginators.GetTraceGraphPublisher publisher = client.getTraceGraphPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.xray.model.GetTraceGraphResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.xray.model.GetTraceGraphResponse response) { //... };
 });
 
```
    As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
    Note: If you prefer to have control on service calls, use the getTraceGraph(software.amazon.awssdk.services.xray.model.GetTraceGraphRequest) operation.
    
    This is a convenience which creates an instance of the GetTraceGraphRequest.Builder avoiding the need to create one manually via GetTraceGraphRequest.builder()
    Parameters:
    
    getTraceGraphRequest - A Consumer that will call methods on GetTraceGraphRequest.Builder to create a request.
    
    Returns:
    A custom publisher that can be subscribed to request a stream of response pages.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getTraceSummaries
```
default CompletableFuture<GetTraceSummariesResponse> getTraceSummaries(GetTraceSummariesRequest getTraceSummariesRequest)
```
    Retrieves IDs and metadata for traces available for a specified time frame using an optional filter. To get the full traces, pass the trace IDs to BatchGetTraces.
    
    A filter expression can target traced requests that hit specific service nodes or edges, have errors, or come from a known user. For example, the following filter expression targets traces that pass through api.example.com:
    
    service("api.example.com")
    
    This filter expression finds traces that have an annotation named account with the value 12345:
    
    annotation.account = "12345"
    
    For a full list of indexed fields and keywords that you can use in filter expressions, see Using Filter Expressions in the AWS X-Ray Developer Guide.
    Parameters:
    
    getTraceSummariesRequest -
    
    Returns:
    A Java Future containing the result of the GetTraceSummaries operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getTraceSummaries
```
default CompletableFuture<GetTraceSummariesResponse> getTraceSummaries(Consumer<GetTraceSummariesRequest.Builder> getTraceSummariesRequest)
```
    Retrieves IDs and metadata for traces available for a specified time frame using an optional filter. To get the full traces, pass the trace IDs to BatchGetTraces.
    
    A filter expression can target traced requests that hit specific service nodes or edges, have errors, or come from a known user. For example, the following filter expression targets traces that pass through api.example.com:
    
    service("api.example.com")
    
    This filter expression finds traces that have an annotation named account with the value 12345:
    
    annotation.account = "12345"
    
    For a full list of indexed fields and keywords that you can use in filter expressions, see Using Filter Expressions in the AWS X-Ray Developer Guide.
    
    This is a convenience which creates an instance of the GetTraceSummariesRequest.Builder avoiding the need to create one manually via GetTraceSummariesRequest.builder()
    Parameters:
    
    getTraceSummariesRequest - A Consumer that will call methods on GetTraceSummariesRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the GetTraceSummaries operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getTraceSummariesPaginator
```
default GetTraceSummariesPublisher getTraceSummariesPaginator(GetTraceSummariesRequest getTraceSummariesRequest)
```
    Retrieves IDs and metadata for traces available for a specified time frame using an optional filter. To get the full traces, pass the trace IDs to BatchGetTraces.
    
    A filter expression can target traced requests that hit specific service nodes or edges, have errors, or come from a known user. For example, the following filter expression targets traces that pass through api.example.com:
    
    service("api.example.com")
    
    This filter expression finds traces that have an annotation named account with the value 12345:
    
    annotation.account = "12345"
    
    For a full list of indexed fields and keywords that you can use in filter expressions, see Using Filter Expressions in the AWS X-Ray Developer Guide.
    
    This is a variant of getTraceSummaries(software.amazon.awssdk.services.xray.model.GetTraceSummariesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.
    
    When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.
    
    The following are few ways to use the response class:
    1) Using the subscribe helper method
```
 
 software.amazon.awssdk.services.xray.paginators.GetTraceSummariesPublisher publisher = client.getTraceSummariesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
 
 
```
    2) Using a custom subscriber
```
 
 software.amazon.awssdk.services.xray.paginators.GetTraceSummariesPublisher publisher = client.getTraceSummariesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.xray.model.GetTraceSummariesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.xray.model.GetTraceSummariesResponse response) { //... };
 });
 
```
    As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
    Note: If you prefer to have control on service calls, use the getTraceSummaries(software.amazon.awssdk.services.xray.model.GetTraceSummariesRequest) operation.
    Parameters:
    
    getTraceSummariesRequest -
    
    Returns:
    A custom publisher that can be subscribed to request a stream of response pages.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - getTraceSummariesPaginator
```
default GetTraceSummariesPublisher getTraceSummariesPaginator(Consumer<GetTraceSummariesRequest.Builder> getTraceSummariesRequest)
```
    Retrieves IDs and metadata for traces available for a specified time frame using an optional filter. To get the full traces, pass the trace IDs to BatchGetTraces.
    
    A filter expression can target traced requests that hit specific service nodes or edges, have errors, or come from a known user. For example, the following filter expression targets traces that pass through api.example.com:
    
    service("api.example.com")
    
    This filter expression finds traces that have an annotation named account with the value 12345:
    
    annotation.account = "12345"
    
    For a full list of indexed fields and keywords that you can use in filter expressions, see Using Filter Expressions in the AWS X-Ray Developer Guide.
    
    This is a variant of getTraceSummaries(software.amazon.awssdk.services.xray.model.GetTraceSummariesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.
    
    When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.
    
    The following are few ways to use the response class:
    1) Using the subscribe helper method
```
 
 software.amazon.awssdk.services.xray.paginators.GetTraceSummariesPublisher publisher = client.getTraceSummariesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
 
 
```
    2) Using a custom subscriber
```
 
 software.amazon.awssdk.services.xray.paginators.GetTraceSummariesPublisher publisher = client.getTraceSummariesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.xray.model.GetTraceSummariesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.xray.model.GetTraceSummariesResponse response) { //... };
 });
 
```
    As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.
    Note: If you prefer to have control on service calls, use the getTraceSummaries(software.amazon.awssdk.services.xray.model.GetTraceSummariesRequest) operation.
    
    This is a convenience which creates an instance of the GetTraceSummariesRequest.Builder avoiding the need to create one manually via GetTraceSummariesRequest.builder()
    Parameters:
    
    getTraceSummariesRequest - A Consumer that will call methods on GetTraceSummariesRequest.Builder to create a request.
    
    Returns:
    A custom publisher that can be subscribed to request a stream of response pages.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - putEncryptionConfig
```
default CompletableFuture<PutEncryptionConfigResponse> putEncryptionConfig(PutEncryptionConfigRequest putEncryptionConfigRequest)
```
    Updates the encryption configuration for X-Ray data.
    Parameters:
    
    putEncryptionConfigRequest -
    
    Returns:
    A Java Future containing the result of the PutEncryptionConfig operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - putEncryptionConfig
```
default CompletableFuture<PutEncryptionConfigResponse> putEncryptionConfig(Consumer<PutEncryptionConfigRequest.Builder> putEncryptionConfigRequest)
```
    Updates the encryption configuration for X-Ray data.
    
    This is a convenience which creates an instance of the PutEncryptionConfigRequest.Builder avoiding the need to create one manually via PutEncryptionConfigRequest.builder()
    Parameters:
    
    putEncryptionConfigRequest - A Consumer that will call methods on PutEncryptionConfigRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the PutEncryptionConfig operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - putTelemetryRecords
```
default CompletableFuture<PutTelemetryRecordsResponse> putTelemetryRecords(PutTelemetryRecordsRequest putTelemetryRecordsRequest)
```
    Used by the AWS X-Ray daemon to upload telemetry.
    Parameters:
    
    putTelemetryRecordsRequest -
    
    Returns:
    A Java Future containing the result of the PutTelemetryRecords operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - putTelemetryRecords
```
default CompletableFuture<PutTelemetryRecordsResponse> putTelemetryRecords(Consumer<PutTelemetryRecordsRequest.Builder> putTelemetryRecordsRequest)
```
    Used by the AWS X-Ray daemon to upload telemetry.
    
    This is a convenience which creates an instance of the PutTelemetryRecordsRequest.Builder avoiding the need to create one manually via PutTelemetryRecordsRequest.builder()
    Parameters:
    
    putTelemetryRecordsRequest - A Consumer that will call methods on PutTelemetryRecordsRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the PutTelemetryRecords operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - putTraceSegments
```
default CompletableFuture<PutTraceSegmentsResponse> putTraceSegments(PutTraceSegmentsRequest putTraceSegmentsRequest)
```
    Uploads segment documents to AWS X-Ray. The X-Ray SDK generates segment documents and sends them to the X-Ray daemon, which uploads them in batches. A segment document can be a completed segment, an in-progress segment, or an array of subsegments.
    
    Segments must include the following fields. For the full segment document schema, see AWS X-Ray Segment Documents in the AWS X-Ray Developer Guide.
    
    Required Segment Document Fields
    - name - The name of the service that handled the request.
    - id - A 64-bit identifier for the segment, unique among segments in the same trace, in 16 hexadecimal digits.
    - trace_id - A unique identifier that connects all segments and subsegments originating from a single client request.
    - start_time - Time the segment or subsegment was created, in floating point seconds in epoch time, accurate to milliseconds. For example, 1480615200.010 or 1.480615200010E9.
    - end_time - Time the segment or subsegment was closed. For example, 1480615200.090 or 1.480615200090E9. Specify either an end_time or in_progress.
    - in_progress - Set to true instead of specifying an end_time to record that a segment has been started, but is not complete. Send an in progress segment when your application receives a request that will take a long time to serve, to trace the fact that the request was received. When the response is sent, send the complete segment to overwrite the in-progress segment.
    A trace_id consists of three numbers separated by hyphens. For example, 1-58406520-a006649127e371903a2de979. This includes:
    
    Trace ID Format
    - The version number, i.e. 1.
    - The time of the original request, in Unix epoch time, in 8 hexadecimal digits. For example, 10:00AM December 2nd, 2016 PST in epoch time is 1480615200 seconds, or 58406520 in hexadecimal.
    - A 96-bit identifier for the trace, globally unique, in 24 hexadecimal digits.
    Parameters:
    
    putTraceSegmentsRequest -
    
    Returns:
    A Java Future containing the result of the PutTraceSegments operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - putTraceSegments
```
default CompletableFuture<PutTraceSegmentsResponse> putTraceSegments(Consumer<PutTraceSegmentsRequest.Builder> putTraceSegmentsRequest)
```
    Uploads segment documents to AWS X-Ray. The X-Ray SDK generates segment documents and sends them to the X-Ray daemon, which uploads them in batches. A segment document can be a completed segment, an in-progress segment, or an array of subsegments.
    
    Segments must include the following fields. For the full segment document schema, see AWS X-Ray Segment Documents in the AWS X-Ray Developer Guide.
    
    Required Segment Document Fields
    - name - The name of the service that handled the request.
    - id - A 64-bit identifier for the segment, unique among segments in the same trace, in 16 hexadecimal digits.
    - trace_id - A unique identifier that connects all segments and subsegments originating from a single client request.
    - start_time - Time the segment or subsegment was created, in floating point seconds in epoch time, accurate to milliseconds. For example, 1480615200.010 or 1.480615200010E9.
    - end_time - Time the segment or subsegment was closed. For example, 1480615200.090 or 1.480615200090E9. Specify either an end_time or in_progress.
    - in_progress - Set to true instead of specifying an end_time to record that a segment has been started, but is not complete. Send an in progress segment when your application receives a request that will take a long time to serve, to trace the fact that the request was received. When the response is sent, send the complete segment to overwrite the in-progress segment.
    A trace_id consists of three numbers separated by hyphens. For example, 1-58406520-a006649127e371903a2de979. This includes:
    
    Trace ID Format
    - The version number, i.e. 1.
    - The time of the original request, in Unix epoch time, in 8 hexadecimal digits. For example, 10:00AM December 2nd, 2016 PST in epoch time is 1480615200 seconds, or 58406520 in hexadecimal.
    - A 96-bit identifier for the trace, globally unique, in 24 hexadecimal digits.
    This is a convenience which creates an instance of the PutTraceSegmentsRequest.Builder avoiding the need to create one manually via PutTraceSegmentsRequest.builder()
    Parameters:
    
    putTraceSegmentsRequest - A Consumer that will call methods on PutTraceSegmentsRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the PutTraceSegments operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - updateGroup
```
default CompletableFuture<UpdateGroupResponse> updateGroup(UpdateGroupRequest updateGroupRequest)
```
    Updates a group resource.
    Parameters:
    
    updateGroupRequest -
    
    Returns:
    A Java Future containing the result of the UpdateGroup operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - updateGroup
```
default CompletableFuture<UpdateGroupResponse> updateGroup(Consumer<UpdateGroupRequest.Builder> updateGroupRequest)
```
    Updates a group resource.
    
    This is a convenience which creates an instance of the UpdateGroupRequest.Builder avoiding the need to create one manually via UpdateGroupRequest.builder()
    Parameters:
    
    updateGroupRequest - A Consumer that will call methods on UpdateGroupRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the UpdateGroup operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - updateSamplingRule
```
default CompletableFuture<UpdateSamplingRuleResponse> updateSamplingRule(UpdateSamplingRuleRequest updateSamplingRuleRequest)
```
    Modifies a sampling rule's configuration.
    Parameters:
    
    updateSamplingRuleRequest -
    
    Returns:
    A Java Future containing the result of the UpdateSamplingRule operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation
  - updateSamplingRule
```
default CompletableFuture<UpdateSamplingRuleResponse> updateSamplingRule(Consumer<UpdateSamplingRuleRequest.Builder> updateSamplingRuleRequest)
```
    Modifies a sampling rule's configuration.
    
    This is a convenience which creates an instance of the UpdateSamplingRuleRequest.Builder avoiding the need to create one manually via UpdateSamplingRuleRequest.builder()
    Parameters:
    
    updateSamplingRuleRequest - A Consumer that will call methods on UpdateSamplingRuleRequest.Builder to create a request.
    
    Returns:
    A Java Future containing the result of the UpdateSamplingRule operation returned by the service.
    The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
    
    InvalidRequestException The request is missing required parameters or has invalid parameters.
    
    ThrottledException The request exceeds the maximum number of requests per second.
    
    SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
    
    SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
    
    XRayException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
    See Also:
    
    AWS API Documentation

Interface XRayAsyncClient

Field Summary

Method Summary

Methods inherited from interface software.amazon.awssdk.core.SdkClient

Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable

Field Detail

SERVICE_NAME

Method Detail

create

builder

batchGetTraces

batchGetTraces

batchGetTracesPaginator

batchGetTracesPaginator

createGroup

createGroup

createSamplingRule

createSamplingRule

deleteGroup

deleteGroup

deleteSamplingRule

deleteSamplingRule

getEncryptionConfig

getEncryptionConfig

getEncryptionConfig

getGroup

getGroup

getGroups

getGroups

getGroups

getSamplingRules

getSamplingRules

getSamplingRules

getSamplingStatisticSummaries

getSamplingStatisticSummaries

getSamplingStatisticSummaries

getSamplingTargets

getSamplingTargets

getServiceGraph

getServiceGraph

getServiceGraphPaginator

getServiceGraphPaginator

getTraceGraph

getTraceGraph

getTraceGraphPaginator

getTraceGraphPaginator

getTraceSummaries

getTraceSummaries

getTraceSummariesPaginator

getTraceSummariesPaginator

putEncryptionConfig

putEncryptionConfig

putTelemetryRecords

putTelemetryRecords

putTraceSegments

putTraceSegments

updateGroup

updateGroup

updateSamplingRule

updateSamplingRule