*
* You can use Amazon CloudWatch Evidently to safely validate new features by serving them to a specified percentage of * your users while you roll out the feature. You can monitor the performance of the new feature to help you decide when * to ramp up traffic to your users. This helps you reduce risk and identify unintended consequences before you fully * launch the feature. *
** You can also conduct A/B experiments to make feature design decisions based on evidence and data. An experiment can * test as many as five variations at once. Evidently collects experiment data and analyzes it using statistical * methods. It also provides clear recommendations about which variations perform better. You can test both user-facing * features and backend features. *
*/ @ThreadSafe @Generated("com.amazonaws:aws-java-sdk-code-generator") public class AmazonCloudWatchEvidentlyClient extends AmazonWebServiceClient implements AmazonCloudWatchEvidently { /** Provider for AWS credentials. */ private final AWSCredentialsProvider awsCredentialsProvider; private static final Log log = LogFactory.getLog(AmazonCloudWatchEvidently.class); /** Default signing name for the service. */ private static final String DEFAULT_SIGNING_NAME = "evidently"; /** Client configuration factory providing ClientConfigurations tailored to this client */ protected static final ClientConfigurationFactory configFactory = new ClientConfigurationFactory(); private final AdvancedConfig advancedConfig; private static final com.amazonaws.protocol.json.SdkJsonProtocolFactory protocolFactory = new com.amazonaws.protocol.json.SdkJsonProtocolFactory( new JsonClientMetadata() .withProtocolVersion("1.1") .withSupportsCbor(false) .withSupportsIon(false) .withContentTypeOverride("application/json") .addErrorMetadata( new JsonErrorShapeMetadata().withErrorCode("ThrottlingException").withExceptionUnmarshaller( com.amazonaws.services.cloudwatchevidently.model.transform.ThrottlingExceptionUnmarshaller.getInstance())) .addErrorMetadata( new JsonErrorShapeMetadata().withErrorCode("ServiceQuotaExceededException").withExceptionUnmarshaller( com.amazonaws.services.cloudwatchevidently.model.transform.ServiceQuotaExceededExceptionUnmarshaller.getInstance())) .addErrorMetadata( new JsonErrorShapeMetadata().withErrorCode("InternalServerException").withExceptionUnmarshaller( com.amazonaws.services.cloudwatchevidently.model.transform.InternalServerExceptionUnmarshaller.getInstance())) .addErrorMetadata( new JsonErrorShapeMetadata().withErrorCode("AccessDeniedException").withExceptionUnmarshaller( com.amazonaws.services.cloudwatchevidently.model.transform.AccessDeniedExceptionUnmarshaller.getInstance())) .addErrorMetadata( new JsonErrorShapeMetadata().withErrorCode("ConflictException").withExceptionUnmarshaller( com.amazonaws.services.cloudwatchevidently.model.transform.ConflictExceptionUnmarshaller.getInstance())) .addErrorMetadata( new JsonErrorShapeMetadata().withErrorCode("ResourceNotFoundException").withExceptionUnmarshaller( com.amazonaws.services.cloudwatchevidently.model.transform.ResourceNotFoundExceptionUnmarshaller.getInstance())) .addErrorMetadata( new JsonErrorShapeMetadata().withErrorCode("ValidationException").withExceptionUnmarshaller( com.amazonaws.services.cloudwatchevidently.model.transform.ValidationExceptionUnmarshaller.getInstance())) .addErrorMetadata( new JsonErrorShapeMetadata().withErrorCode("ServiceUnavailableException").withExceptionUnmarshaller( com.amazonaws.services.cloudwatchevidently.model.transform.ServiceUnavailableExceptionUnmarshaller.getInstance())) .withBaseServiceExceptionClass(com.amazonaws.services.cloudwatchevidently.model.AmazonCloudWatchEvidentlyException.class)); public static AmazonCloudWatchEvidentlyClientBuilder builder() { return AmazonCloudWatchEvidentlyClientBuilder.standard(); } /** * Constructs a new client to invoke service methods on Amazon CloudWatch Evidently using the specified parameters. * ** All service calls made using this new client object are blocking, and will not return until the service call * completes. * * @param clientParams * Object providing client parameters. */ AmazonCloudWatchEvidentlyClient(AwsSyncClientParams clientParams) { this(clientParams, false); } /** * Constructs a new client to invoke service methods on Amazon CloudWatch Evidently using the specified parameters. * *
* All service calls made using this new client object are blocking, and will not return until the service call * completes. * * @param clientParams * Object providing client parameters. */ AmazonCloudWatchEvidentlyClient(AwsSyncClientParams clientParams, boolean endpointDiscoveryEnabled) { super(clientParams); this.awsCredentialsProvider = clientParams.getCredentialsProvider(); this.advancedConfig = clientParams.getAdvancedConfig(); init(); } private void init() { setServiceNameIntern(DEFAULT_SIGNING_NAME); setEndpointPrefix(ENDPOINT_PREFIX); // calling this.setEndPoint(...) will also modify the signer accordingly setEndpoint("evidently.us-east-1.amazonaws.com"); HandlerChainFactory chainFactory = new HandlerChainFactory(); requestHandler2s.addAll(chainFactory.newRequestHandlerChain("/com/amazonaws/services/cloudwatchevidently/request.handlers")); requestHandler2s.addAll(chainFactory.newRequestHandler2Chain("/com/amazonaws/services/cloudwatchevidently/request.handler2s")); requestHandler2s.addAll(chainFactory.getGlobalHandlers()); } /** *
* This operation assigns feature variation to user sessions. For each user session, you pass in an
* entityID that represents the user. Evidently then checks the evaluation rules and assigns the
* variation.
*
* The first rules that are evaluated are the override rules. If the user's entityID matches an
* override rule, the user is served the variation specified by that rule.
*
* Next, if there is a launch of the feature, the user might be assigned to a variation in the launch. The chance of * this depends on the percentage of users that are allocated to that launch. If the user is enrolled in the launch, * the variation they are served depends on the allocation of the various feature variations used for the launch. *
** If the user is not assigned to a launch, and there is an ongoing experiment for this feature, the user might be * assigned to a variation in the experiment. The chance of this depends on the percentage of users that are * allocated to that experiment. If the user is enrolled in the experiment, the variation they are served depends on * the allocation of the various feature variations used for the experiment. *
** If the user is not assigned to a launch or experiment, they are served the default variation. *
* * @param batchEvaluateFeatureRequest * @return Result of the BatchEvaluateFeature operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.BatchEvaluateFeature * @see AWS * API Documentation */ @Override public BatchEvaluateFeatureResult batchEvaluateFeature(BatchEvaluateFeatureRequest request) { request = beforeClientExecution(request); return executeBatchEvaluateFeature(request); } @SdkInternalApi final BatchEvaluateFeatureResult executeBatchEvaluateFeature(BatchEvaluateFeatureRequest batchEvaluateFeatureRequest) { ExecutionContext executionContext = createExecutionContext(batchEvaluateFeatureRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Creates an Evidently experiment. Before you create an experiment, you must create the feature to use for * the experiment. *
** An experiment helps you make feature design decisions based on evidence and data. An experiment can test as many * as five variations at once. Evidently collects experiment data and analyzes it by statistical methods, and * provides clear recommendations about which variations perform better. *
*
* You can optionally specify a segment to have the experiment consider only certain audience types in
* the experiment, such as using only user sessions from a certain location or who use a certain internet browser.
*
* Don't use this operation to update an existing experiment. Instead, use UpdateExperiment. *
* * @param createExperimentRequest * @return Result of the CreateExperiment operation returned by the service. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ServiceQuotaExceededException * The request would cause a service quota to be exceeded. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.CreateExperiment * @see AWS API * Documentation */ @Override public CreateExperimentResult createExperiment(CreateExperimentRequest request) { request = beforeClientExecution(request); return executeCreateExperiment(request); } @SdkInternalApi final CreateExperimentResult executeCreateExperiment(CreateExperimentRequest createExperimentRequest) { ExecutionContext executionContext = createExecutionContext(createExperimentRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Creates an Evidently feature that you want to launch or test. You can define up to five variations of a * feature, and use these variations in your launches and experiments. A feature must be created in a project. For * information about creating a project, see CreateProject. *
** Don't use this operation to update an existing feature. Instead, use UpdateFeature. *
* * @param createFeatureRequest * @return Result of the CreateFeature operation returned by the service. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ServiceQuotaExceededException * The request would cause a service quota to be exceeded. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.CreateFeature * @see AWS API * Documentation */ @Override public CreateFeatureResult createFeature(CreateFeatureRequest request) { request = beforeClientExecution(request); return executeCreateFeature(request); } @SdkInternalApi final CreateFeatureResult executeCreateFeature(CreateFeatureRequest createFeatureRequest) { ExecutionContext executionContext = createExecutionContext(createFeatureRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Creates a launch of a given feature. Before you create a launch, you must create the feature to use for * the launch. *
** You can use a launch to safely validate new features by serving them to a specified percentage of your users * while you roll out the feature. You can monitor the performance of the new feature to help you decide when to * ramp up traffic to more users. This helps you reduce risk and identify unintended consequences before you fully * launch the feature. *
** Don't use this operation to update an existing launch. Instead, use UpdateLaunch. *
* * @param createLaunchRequest * @return Result of the CreateLaunch operation returned by the service. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ServiceQuotaExceededException * The request would cause a service quota to be exceeded. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.CreateLaunch * @see AWS API * Documentation */ @Override public CreateLaunchResult createLaunch(CreateLaunchRequest request) { request = beforeClientExecution(request); return executeCreateLaunch(request); } @SdkInternalApi final CreateLaunchResult executeCreateLaunch(CreateLaunchRequest createLaunchRequest) { ExecutionContext executionContext = createExecutionContext(createLaunchRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Creates a project, which is the logical object in Evidently that can contain features, launches, and experiments. * Use projects to group similar features together. *
** To update an existing project, use UpdateProject. *
* * @param createProjectRequest * @return Result of the CreateProject operation returned by the service. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ServiceQuotaExceededException * The request would cause a service quota to be exceeded. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.CreateProject * @see AWS API * Documentation */ @Override public CreateProjectResult createProject(CreateProjectRequest request) { request = beforeClientExecution(request); return executeCreateProject(request); } @SdkInternalApi final CreateProjectResult executeCreateProject(CreateProjectRequest createProjectRequest) { ExecutionContext executionContext = createExecutionContext(createProjectRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Use this operation to define a segment of your audience. A segment is a portion of your audience that * share one or more characteristics. Examples could be Chrome browser users, users in Europe, or Firefox browser * users in Europe who also fit other criteria that your application collects, such as age. *
** Using a segment in an experiment limits that experiment to evaluate only the users who match the segment * criteria. Using one or more segments in a launch allows you to define different traffic splits for the different * audience segments. *
** For more information about segment pattern syntax, see Segment rule pattern syntax. *
*
* The pattern that you define for a segment is matched against the value of evaluationContext, which
* is passed into Evidently in the EvaluateFeature operation, when Evidently assigns a feature variation to a user.
*
* Deletes an Evidently experiment. The feature used for the experiment is not deleted. *
** To stop an experiment without deleting it, use StopExperiment. *
* * @param deleteExperimentRequest * @return Result of the DeleteExperiment operation returned by the service. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws InternalServerException * Unexpected error while processing the request. Retry the request. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ServiceUnavailableException * The service was unavailable. Retry the request. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.DeleteExperiment * @see AWS API * Documentation */ @Override public DeleteExperimentResult deleteExperiment(DeleteExperimentRequest request) { request = beforeClientExecution(request); return executeDeleteExperiment(request); } @SdkInternalApi final DeleteExperimentResult executeDeleteExperiment(DeleteExperimentRequest deleteExperimentRequest) { ExecutionContext executionContext = createExecutionContext(deleteExperimentRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Deletes an Evidently feature. *
* * @param deleteFeatureRequest * @return Result of the DeleteFeature operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.DeleteFeature * @see AWS API * Documentation */ @Override public DeleteFeatureResult deleteFeature(DeleteFeatureRequest request) { request = beforeClientExecution(request); return executeDeleteFeature(request); } @SdkInternalApi final DeleteFeatureResult executeDeleteFeature(DeleteFeatureRequest deleteFeatureRequest) { ExecutionContext executionContext = createExecutionContext(deleteFeatureRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Deletes an Evidently launch. The feature used for the launch is not deleted. *
** To stop a launch without deleting it, use StopLaunch. *
* * @param deleteLaunchRequest * @return Result of the DeleteLaunch operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.DeleteLaunch * @see AWS API * Documentation */ @Override public DeleteLaunchResult deleteLaunch(DeleteLaunchRequest request) { request = beforeClientExecution(request); return executeDeleteLaunch(request); } @SdkInternalApi final DeleteLaunchResult executeDeleteLaunch(DeleteLaunchRequest deleteLaunchRequest) { ExecutionContext executionContext = createExecutionContext(deleteLaunchRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Deletes an Evidently project. Before you can delete a project, you must delete all the features that the project * contains. To delete a feature, use DeleteFeature. *
* * @param deleteProjectRequest * @return Result of the DeleteProject operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.DeleteProject * @see AWS API * Documentation */ @Override public DeleteProjectResult deleteProject(DeleteProjectRequest request) { request = beforeClientExecution(request); return executeDeleteProject(request); } @SdkInternalApi final DeleteProjectResult executeDeleteProject(DeleteProjectRequest deleteProjectRequest) { ExecutionContext executionContext = createExecutionContext(deleteProjectRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Deletes a segment. You can't delete a segment that is being used in a launch or experiment, even if that launch * or experiment is not currently running. *
* * @param deleteSegmentRequest * @return Result of the DeleteSegment operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.DeleteSegment * @see AWS API * Documentation */ @Override public DeleteSegmentResult deleteSegment(DeleteSegmentRequest request) { request = beforeClientExecution(request); return executeDeleteSegment(request); } @SdkInternalApi final DeleteSegmentResult executeDeleteSegment(DeleteSegmentRequest deleteSegmentRequest) { ExecutionContext executionContext = createExecutionContext(deleteSegmentRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request
* This operation assigns a feature variation to one given user session. You pass in an entityID that
* represents the user. Evidently then checks the evaluation rules and assigns the variation.
*
* The first rules that are evaluated are the override rules. If the user's entityID matches an
* override rule, the user is served the variation specified by that rule.
*
* If there is a current launch with this feature that uses segment overrides, and if the user session's
* evaluationContext matches a segment rule defined in a segment override, the configuration in the
* segment overrides is used. For more information about segments, see CreateSegment and Use
* segments to focus your audience.
*
* If there is a launch with no segment overrides, the user might be assigned to a variation in the launch. The * chance of this depends on the percentage of users that are allocated to that launch. If the user is enrolled in * the launch, the variation they are served depends on the allocation of the various feature variations used for * the launch. *
** If the user is not assigned to a launch, and there is an ongoing experiment for this feature, the user might be * assigned to a variation in the experiment. The chance of this depends on the percentage of users that are * allocated to that experiment. *
*
* If the experiment uses a segment, then only user sessions with evaluationContext values that match
* the segment rule are used in the experiment.
*
* If the user is enrolled in the experiment, the variation they are served depends on the allocation of the various * feature variations used for the experiment. *
** If the user is not assigned to a launch or experiment, they are served the default variation. *
* * @param evaluateFeatureRequest * @return Result of the EvaluateFeature operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.EvaluateFeature * @see AWS API * Documentation */ @Override public EvaluateFeatureResult evaluateFeature(EvaluateFeatureRequest request) { request = beforeClientExecution(request); return executeEvaluateFeature(request); } @SdkInternalApi final EvaluateFeatureResult executeEvaluateFeature(EvaluateFeatureRequest evaluateFeatureRequest) { ExecutionContext executionContext = createExecutionContext(evaluateFeatureRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Returns the details about one experiment. You must already know the experiment name. To retrieve a list of * experiments in your account, use ListExperiments. *
* * @param getExperimentRequest * @return Result of the GetExperiment operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.GetExperiment * @see AWS API * Documentation */ @Override public GetExperimentResult getExperiment(GetExperimentRequest request) { request = beforeClientExecution(request); return executeGetExperiment(request); } @SdkInternalApi final GetExperimentResult executeGetExperiment(GetExperimentRequest getExperimentRequest) { ExecutionContext executionContext = createExecutionContext(getExperimentRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Retrieves the results of a running or completed experiment. No results are available until there have been 100 * events for each variation and at least 10 minutes have passed since the start of the experiment. To increase the * statistical power, Evidently performs an additional offline p-value analysis at the end of the experiment. * Offline p-value analysis can detect statistical significance in some cases where the anytime p-values used during * the experiment do not find statistical significance. *
** Experiment results are available up to 63 days after the start of the experiment. They are not available after * that because of CloudWatch data retention policies. *
* * @param getExperimentResultsRequest * @return Result of the GetExperimentResults operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.GetExperimentResults * @see AWS * API Documentation */ @Override public GetExperimentResultsResult getExperimentResults(GetExperimentResultsRequest request) { request = beforeClientExecution(request); return executeGetExperimentResults(request); } @SdkInternalApi final GetExperimentResultsResult executeGetExperimentResults(GetExperimentResultsRequest getExperimentResultsRequest) { ExecutionContext executionContext = createExecutionContext(getExperimentResultsRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Returns the details about one feature. You must already know the feature name. To retrieve a list of features in * your account, use ListFeatures. *
* * @param getFeatureRequest * @return Result of the GetFeature operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.GetFeature * @see AWS API * Documentation */ @Override public GetFeatureResult getFeature(GetFeatureRequest request) { request = beforeClientExecution(request); return executeGetFeature(request); } @SdkInternalApi final GetFeatureResult executeGetFeature(GetFeatureRequest getFeatureRequest) { ExecutionContext executionContext = createExecutionContext(getFeatureRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Returns the details about one launch. You must already know the launch name. To retrieve a list of launches in * your account, use ListLaunches. *
* * @param getLaunchRequest * @return Result of the GetLaunch operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.GetLaunch * @see AWS API * Documentation */ @Override public GetLaunchResult getLaunch(GetLaunchRequest request) { request = beforeClientExecution(request); return executeGetLaunch(request); } @SdkInternalApi final GetLaunchResult executeGetLaunch(GetLaunchRequest getLaunchRequest) { ExecutionContext executionContext = createExecutionContext(getLaunchRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Returns the details about one launch. You must already know the project name. To retrieve a list of projects in * your account, use ListProjects. *
* * @param getProjectRequest * @return Result of the GetProject operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.GetProject * @see AWS API * Documentation */ @Override public GetProjectResult getProject(GetProjectRequest request) { request = beforeClientExecution(request); return executeGetProject(request); } @SdkInternalApi final GetProjectResult executeGetProject(GetProjectRequest getProjectRequest) { ExecutionContext executionContext = createExecutionContext(getProjectRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Returns information about the specified segment. Specify the segment you want to view by specifying its ARN. *
* * @param getSegmentRequest * @return Result of the GetSegment operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.GetSegment * @see AWS API * Documentation */ @Override public GetSegmentResult getSegment(GetSegmentRequest request) { request = beforeClientExecution(request); return executeGetSegment(request); } @SdkInternalApi final GetSegmentResult executeGetSegment(GetSegmentRequest getSegmentRequest) { ExecutionContext executionContext = createExecutionContext(getSegmentRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Returns configuration details about all the experiments in the specified project. *
* * @param listExperimentsRequest * @return Result of the ListExperiments operation returned by the service. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.ListExperiments * @see AWS API * Documentation */ @Override public ListExperimentsResult listExperiments(ListExperimentsRequest request) { request = beforeClientExecution(request); return executeListExperiments(request); } @SdkInternalApi final ListExperimentsResult executeListExperiments(ListExperimentsRequest listExperimentsRequest) { ExecutionContext executionContext = createExecutionContext(listExperimentsRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Returns configuration details about all the features in the specified project. *
* * @param listFeaturesRequest * @return Result of the ListFeatures operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.ListFeatures * @see AWS API * Documentation */ @Override public ListFeaturesResult listFeatures(ListFeaturesRequest request) { request = beforeClientExecution(request); return executeListFeatures(request); } @SdkInternalApi final ListFeaturesResult executeListFeatures(ListFeaturesRequest listFeaturesRequest) { ExecutionContext executionContext = createExecutionContext(listFeaturesRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Returns configuration details about all the launches in the specified project. *
* * @param listLaunchesRequest * @return Result of the ListLaunches operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.ListLaunches * @see AWS API * Documentation */ @Override public ListLaunchesResult listLaunches(ListLaunchesRequest request) { request = beforeClientExecution(request); return executeListLaunches(request); } @SdkInternalApi final ListLaunchesResult executeListLaunches(ListLaunchesRequest listLaunchesRequest) { ExecutionContext executionContext = createExecutionContext(listLaunchesRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Returns configuration details about all the projects in the current Region in your account. *
* * @param listProjectsRequest * @return Result of the ListProjects operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.ListProjects * @see AWS API * Documentation */ @Override public ListProjectsResult listProjects(ListProjectsRequest request) { request = beforeClientExecution(request); return executeListProjects(request); } @SdkInternalApi final ListProjectsResult executeListProjects(ListProjectsRequest listProjectsRequest) { ExecutionContext executionContext = createExecutionContext(listProjectsRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Use this operation to find which experiments or launches are using a specified segment. *
* * @param listSegmentReferencesRequest * @return Result of the ListSegmentReferences operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.ListSegmentReferences * @see AWS API Documentation */ @Override public ListSegmentReferencesResult listSegmentReferences(ListSegmentReferencesRequest request) { request = beforeClientExecution(request); return executeListSegmentReferences(request); } @SdkInternalApi final ListSegmentReferencesResult executeListSegmentReferences(ListSegmentReferencesRequest listSegmentReferencesRequest) { ExecutionContext executionContext = createExecutionContext(listSegmentReferencesRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Returns a list of audience segments that you have created in your account in this Region. *
* * @param listSegmentsRequest * @return Result of the ListSegments operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.ListSegments * @see AWS API * Documentation */ @Override public ListSegmentsResult listSegments(ListSegmentsRequest request) { request = beforeClientExecution(request); return executeListSegments(request); } @SdkInternalApi final ListSegmentsResult executeListSegments(ListSegmentsRequest listSegmentsRequest) { ExecutionContext executionContext = createExecutionContext(listSegmentsRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Displays the tags associated with an Evidently resource. *
* * @param listTagsForResourceRequest * @return Result of the ListTagsForResource operation returned by the service. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @sample AmazonCloudWatchEvidently.ListTagsForResource * @see AWS * API Documentation */ @Override public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request) { request = beforeClientExecution(request); return executeListTagsForResource(request); } @SdkInternalApi final ListTagsForResourceResult executeListTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) { ExecutionContext executionContext = createExecutionContext(listTagsForResourceRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Sends performance events to Evidently. These events can be used to evaluate a launch or an experiment. *
* * @param putProjectEventsRequest * @return Result of the PutProjectEvents operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.PutProjectEvents * @see AWS API * Documentation */ @Override public PutProjectEventsResult putProjectEvents(PutProjectEventsRequest request) { request = beforeClientExecution(request); return executePutProjectEvents(request); } @SdkInternalApi final PutProjectEventsResult executePutProjectEvents(PutProjectEventsRequest putProjectEventsRequest) { ExecutionContext executionContext = createExecutionContext(putProjectEventsRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Starts an existing experiment. To create an experiment, use CreateExperiment. *
* * @param startExperimentRequest * @return Result of the StartExperiment operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ServiceQuotaExceededException * The request would cause a service quota to be exceeded. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.StartExperiment * @see AWS API * Documentation */ @Override public StartExperimentResult startExperiment(StartExperimentRequest request) { request = beforeClientExecution(request); return executeStartExperiment(request); } @SdkInternalApi final StartExperimentResult executeStartExperiment(StartExperimentRequest startExperimentRequest) { ExecutionContext executionContext = createExecutionContext(startExperimentRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Starts an existing launch. To create a launch, use CreateLaunch. *
* * @param startLaunchRequest * @return Result of the StartLaunch operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ServiceQuotaExceededException * The request would cause a service quota to be exceeded. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.StartLaunch * @see AWS API * Documentation */ @Override public StartLaunchResult startLaunch(StartLaunchRequest request) { request = beforeClientExecution(request); return executeStartLaunch(request); } @SdkInternalApi final StartLaunchResult executeStartLaunch(StartLaunchRequest startLaunchRequest) { ExecutionContext executionContext = createExecutionContext(startLaunchRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Stops an experiment that is currently running. If you stop an experiment, you can't resume it or restart it. *
* * @param stopExperimentRequest * @return Result of the StopExperiment operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ServiceQuotaExceededException * The request would cause a service quota to be exceeded. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.StopExperiment * @see AWS API * Documentation */ @Override public StopExperimentResult stopExperiment(StopExperimentRequest request) { request = beforeClientExecution(request); return executeStopExperiment(request); } @SdkInternalApi final StopExperimentResult executeStopExperiment(StopExperimentRequest stopExperimentRequest) { ExecutionContext executionContext = createExecutionContext(stopExperimentRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Stops a launch that is currently running. After you stop a launch, you will not be able to resume it or restart * it. Also, it will not be evaluated as a rule for traffic allocation, and the traffic that was allocated to the * launch will instead be available to the feature's experiment, if there is one. Otherwise, all traffic will be * served the default variation after the launch is stopped. *
* * @param stopLaunchRequest * @return Result of the StopLaunch operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.StopLaunch * @see AWS API * Documentation */ @Override public StopLaunchResult stopLaunch(StopLaunchRequest request) { request = beforeClientExecution(request); return executeStopLaunch(request); } @SdkInternalApi final StopLaunchResult executeStopLaunch(StopLaunchRequest stopLaunchRequest) { ExecutionContext executionContext = createExecutionContext(stopLaunchRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Assigns one or more tags (key-value pairs) to the specified CloudWatch Evidently resource. Projects, features, * launches, and experiments can be tagged. *
** Tags can help you organize and categorize your resources. You can also use them to scope user permissions by * granting a user permission to access or change only resources with certain tag values. *
** Tags don't have any semantic meaning to Amazon Web Services and are interpreted strictly as strings of * characters. *
*
* You can use the TagResource action with a resource that already has tags. If you specify a new tag
* key for the resource, this tag is appended to the list of tags associated with the alarm. If you specify a tag
* key that is already associated with the resource, the new tag value that you specify replaces the previous value
* for that tag.
*
* You can associate as many as 50 tags with a resource. *
** For more information, see Tagging Amazon * Web Services resources. *
* * @param tagResourceRequest * @return Result of the TagResource operation returned by the service. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @sample AmazonCloudWatchEvidently.TagResource * @see AWS API * Documentation */ @Override public TagResourceResult tagResource(TagResourceRequest request) { request = beforeClientExecution(request); return executeTagResource(request); } @SdkInternalApi final TagResourceResult executeTagResource(TagResourceRequest tagResourceRequest) { ExecutionContext executionContext = createExecutionContext(tagResourceRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Use this operation to test a rules pattern that you plan to use to create an audience segment. For more * information about segments, see CreateSegment. *
* * @param testSegmentPatternRequest * @return Result of the TestSegmentPattern operation returned by the service. * @throws ThrottlingException * The request was denied because of request throttling. Retry the request. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.TestSegmentPattern * @see AWS * API Documentation */ @Override public TestSegmentPatternResult testSegmentPattern(TestSegmentPatternRequest request) { request = beforeClientExecution(request); return executeTestSegmentPattern(request); } @SdkInternalApi final TestSegmentPatternResult executeTestSegmentPattern(TestSegmentPatternRequest testSegmentPatternRequest) { ExecutionContext executionContext = createExecutionContext(testSegmentPatternRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Removes one or more tags from the specified resource. *
* * @param untagResourceRequest * @return Result of the UntagResource operation returned by the service. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @sample AmazonCloudWatchEvidently.UntagResource * @see AWS API * Documentation */ @Override public UntagResourceResult untagResource(UntagResourceRequest request) { request = beforeClientExecution(request); return executeUntagResource(request); } @SdkInternalApi final UntagResourceResult executeUntagResource(UntagResourceRequest untagResourceRequest) { ExecutionContext executionContext = createExecutionContext(untagResourceRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Updates an Evidently experiment. *
** Don't use this operation to update an experiment's tag. Instead, use TagResource. *
* * @param updateExperimentRequest * @return Result of the UpdateExperiment operation returned by the service. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.UpdateExperiment * @see AWS API * Documentation */ @Override public UpdateExperimentResult updateExperiment(UpdateExperimentRequest request) { request = beforeClientExecution(request); return executeUpdateExperiment(request); } @SdkInternalApi final UpdateExperimentResult executeUpdateExperiment(UpdateExperimentRequest updateExperimentRequest) { ExecutionContext executionContext = createExecutionContext(updateExperimentRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Updates an existing feature. *
** You can't use this operation to update the tags of an existing feature. Instead, use TagResource. *
* * @param updateFeatureRequest * @return Result of the UpdateFeature operation returned by the service. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ServiceQuotaExceededException * The request would cause a service quota to be exceeded. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.UpdateFeature * @see AWS API * Documentation */ @Override public UpdateFeatureResult updateFeature(UpdateFeatureRequest request) { request = beforeClientExecution(request); return executeUpdateFeature(request); } @SdkInternalApi final UpdateFeatureResult executeUpdateFeature(UpdateFeatureRequest updateFeatureRequest) { ExecutionContext executionContext = createExecutionContext(updateFeatureRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Updates a launch of a given feature. *
** Don't use this operation to update the tags of an existing launch. Instead, use TagResource. *
* * @param updateLaunchRequest * @return Result of the UpdateLaunch operation returned by the service. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.UpdateLaunch * @see AWS API * Documentation */ @Override public UpdateLaunchResult updateLaunch(UpdateLaunchRequest request) { request = beforeClientExecution(request); return executeUpdateLaunch(request); } @SdkInternalApi final UpdateLaunchResult executeUpdateLaunch(UpdateLaunchRequest updateLaunchRequest) { ExecutionContext executionContext = createExecutionContext(updateLaunchRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Updates the description of an existing project. *
** To create a new project, use CreateProject. *
** Don't use this operation to update the data storage options of a project. Instead, use UpdateProjectDataDelivery. *
** Don't use this operation to update the tags of a project. Instead, use TagResource. *
* * @param updateProjectRequest * @return Result of the UpdateProject operation returned by the service. * @throws ValidationException * The value of a parameter in the request caused an error. * @throws ConflictException * A resource was in an inconsistent state during an update or a deletion. * @throws ServiceQuotaExceededException * The request would cause a service quota to be exceeded. * @throws ResourceNotFoundException * The request references a resource that does not exist. * @throws AccessDeniedException * You do not have sufficient permissions to perform this action. * @sample AmazonCloudWatchEvidently.UpdateProject * @see AWS API * Documentation */ @Override public UpdateProjectResult updateProject(UpdateProjectRequest request) { request = beforeClientExecution(request); return executeUpdateProject(request); } @SdkInternalApi final UpdateProjectResult executeUpdateProject(UpdateProjectRequest updateProjectRequest) { ExecutionContext executionContext = createExecutionContext(updateProjectRequest); AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics(); awsRequestMetrics.startEvent(Field.ClientExecuteTime); Request* Updates the data storage options for this project. If you store evaluation events, you an keep them and analyze * them on your own. If you choose not to store evaluation events, Evidently deletes them after using them to * produce metrics and other experiment results that you can view. *
*
* You can't specify both cloudWatchLogs and s3Destination in the same operation.
*
* Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic
* information for an executed request, you should use this method to retrieve it as soon as possible after
* executing the request.
*
* @param request
* The originally executed request
*
* @return The response metadata for the specified request, or null if none is available.
*/
public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request) {
return client.getResponseMetadataForRequest(request);
}
/**
* Normal invoke with authentication. Credentials are required and may be overriden at the request level.
**/
private