com.amazonaws.services.gamelift.AmazonGameLiftClient Maven / Gradle / Ivy
/*
* Copyright 2019-2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
* the License. A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
* and limitations under the License.
*/
package com.amazonaws.services.gamelift;
import org.w3c.dom.*;
import java.net.*;
import java.util.*;
import javax.annotation.Generated;
import org.apache.commons.logging.*;
import com.amazonaws.*;
import com.amazonaws.annotation.SdkInternalApi;
import com.amazonaws.auth.*;
import com.amazonaws.handlers.*;
import com.amazonaws.http.*;
import com.amazonaws.internal.*;
import com.amazonaws.internal.auth.*;
import com.amazonaws.metrics.*;
import com.amazonaws.regions.*;
import com.amazonaws.transform.*;
import com.amazonaws.util.*;
import com.amazonaws.protocol.json.*;
import com.amazonaws.util.AWSRequestMetrics.Field;
import com.amazonaws.annotation.ThreadSafe;
import com.amazonaws.client.AwsSyncClientParams;
import com.amazonaws.client.builder.AdvancedConfig;
import com.amazonaws.services.gamelift.AmazonGameLiftClientBuilder;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.services.gamelift.model.*;
import com.amazonaws.services.gamelift.model.transform.*;
/**
* Client for accessing Amazon GameLift. All service calls made using this client are blocking, and will not return
* until the service call completes.
*
*
* Amazon GameLift provides solutions for hosting session-based multiplayer game servers in the cloud, including tools
* for deploying, operating, and scaling game servers. Built on Amazon Web Services global computing infrastructure,
* GameLift helps you deliver high-performance, high-reliability, low-cost game servers while dynamically scaling your
* resource usage to meet player demand.
*
*
* About Amazon GameLift solutions
*
*
* Get more information on these Amazon GameLift solutions in the Amazon GameLift Developer Guide.
*
*
* -
*
* Amazon GameLift managed hosting -- Amazon GameLift offers a fully managed service to set up and maintain computing
* machines for hosting, manage game session and player session life cycle, and handle security, storage, and
* performance tracking. You can use automatic scaling tools to balance player demand and hosting costs, configure your
* game session management to minimize player latency, and add FlexMatch for matchmaking.
*
*
* -
*
* Managed hosting with Realtime Servers -- With Amazon GameLift Realtime Servers, you can quickly configure and set up
* ready-to-go game servers for your game. Realtime Servers provides a game server framework with core Amazon GameLift
* infrastructure already built in. Then use the full range of Amazon GameLift managed hosting features, including
* FlexMatch, for your game.
*
*
* -
*
* Amazon GameLift FleetIQ -- Use Amazon GameLift FleetIQ as a standalone service while hosting your games using EC2
* instances and Auto Scaling groups. Amazon GameLift FleetIQ provides optimizations for game hosting, including
* boosting the viability of low-cost Spot Instances gaming. For a complete solution, pair the Amazon GameLift FleetIQ
* and FlexMatch standalone services.
*
*
* -
*
* Amazon GameLift FlexMatch -- Add matchmaking to your game hosting solution. FlexMatch is a customizable matchmaking
* service for multiplayer games. Use FlexMatch as integrated with Amazon GameLift managed hosting or incorporate
* FlexMatch as a standalone service into your own hosting solution.
*
*
*
*
* About this API Reference
*
*
* This reference guide describes the low-level service API for Amazon GameLift. With each topic in this guide, you can
* find links to language-specific SDK guides and the Amazon Web Services CLI reference. Useful links:
*
*
* -
*
*
* -
*
*
*
*/
@ThreadSafe
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public class AmazonGameLiftClient extends AmazonWebServiceClient implements AmazonGameLift {
/** Provider for AWS credentials. */
private final AWSCredentialsProvider awsCredentialsProvider;
private static final Log log = LogFactory.getLog(AmazonGameLift.class);
/** Default signing name for the service. */
private static final String DEFAULT_SIGNING_NAME = "gamelift";
/** 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)
.addErrorMetadata(
new JsonErrorShapeMetadata().withErrorCode("InvalidRequestException").withExceptionUnmarshaller(
com.amazonaws.services.gamelift.model.transform.InvalidRequestExceptionUnmarshaller.getInstance()))
.addErrorMetadata(
new JsonErrorShapeMetadata().withErrorCode("LimitExceededException").withExceptionUnmarshaller(
com.amazonaws.services.gamelift.model.transform.LimitExceededExceptionUnmarshaller.getInstance()))
.addErrorMetadata(
new JsonErrorShapeMetadata().withErrorCode("FleetCapacityExceededException").withExceptionUnmarshaller(
com.amazonaws.services.gamelift.model.transform.FleetCapacityExceededExceptionUnmarshaller.getInstance()))
.addErrorMetadata(
new JsonErrorShapeMetadata().withErrorCode("IdempotentParameterMismatchException").withExceptionUnmarshaller(
com.amazonaws.services.gamelift.model.transform.IdempotentParameterMismatchExceptionUnmarshaller.getInstance()))
.addErrorMetadata(
new JsonErrorShapeMetadata().withErrorCode("TerminalRoutingStrategyException").withExceptionUnmarshaller(
com.amazonaws.services.gamelift.model.transform.TerminalRoutingStrategyExceptionUnmarshaller.getInstance()))
.addErrorMetadata(
new JsonErrorShapeMetadata().withErrorCode("InvalidGameSessionStatusException").withExceptionUnmarshaller(
com.amazonaws.services.gamelift.model.transform.InvalidGameSessionStatusExceptionUnmarshaller.getInstance()))
.addErrorMetadata(
new JsonErrorShapeMetadata().withErrorCode("InternalServiceException").withExceptionUnmarshaller(
com.amazonaws.services.gamelift.model.transform.InternalServiceExceptionUnmarshaller.getInstance()))
.addErrorMetadata(
new JsonErrorShapeMetadata().withErrorCode("OutOfCapacityException").withExceptionUnmarshaller(
com.amazonaws.services.gamelift.model.transform.OutOfCapacityExceptionUnmarshaller.getInstance()))
.addErrorMetadata(
new JsonErrorShapeMetadata().withErrorCode("GameSessionFullException").withExceptionUnmarshaller(
com.amazonaws.services.gamelift.model.transform.GameSessionFullExceptionUnmarshaller.getInstance()))
.addErrorMetadata(
new JsonErrorShapeMetadata().withErrorCode("NotReadyException").withExceptionUnmarshaller(
com.amazonaws.services.gamelift.model.transform.NotReadyExceptionUnmarshaller.getInstance()))
.addErrorMetadata(
new JsonErrorShapeMetadata().withErrorCode("NotFoundException").withExceptionUnmarshaller(
com.amazonaws.services.gamelift.model.transform.NotFoundExceptionUnmarshaller.getInstance()))
.addErrorMetadata(
new JsonErrorShapeMetadata().withErrorCode("TaggingFailedException").withExceptionUnmarshaller(
com.amazonaws.services.gamelift.model.transform.TaggingFailedExceptionUnmarshaller.getInstance()))
.addErrorMetadata(
new JsonErrorShapeMetadata().withErrorCode("UnsupportedRegionException").withExceptionUnmarshaller(
com.amazonaws.services.gamelift.model.transform.UnsupportedRegionExceptionUnmarshaller.getInstance()))
.addErrorMetadata(
new JsonErrorShapeMetadata().withErrorCode("UnauthorizedException").withExceptionUnmarshaller(
com.amazonaws.services.gamelift.model.transform.UnauthorizedExceptionUnmarshaller.getInstance()))
.addErrorMetadata(
new JsonErrorShapeMetadata().withErrorCode("InvalidFleetStatusException").withExceptionUnmarshaller(
com.amazonaws.services.gamelift.model.transform.InvalidFleetStatusExceptionUnmarshaller.getInstance()))
.addErrorMetadata(
new JsonErrorShapeMetadata().withErrorCode("ConflictException").withExceptionUnmarshaller(
com.amazonaws.services.gamelift.model.transform.ConflictExceptionUnmarshaller.getInstance()))
.withBaseServiceExceptionClass(com.amazonaws.services.gamelift.model.AmazonGameLiftException.class));
/**
* Constructs a new client to invoke service methods on Amazon GameLift. A credentials provider chain will be used
* that searches for credentials in this order:
*
* - Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
* - Java System Properties - aws.accessKeyId and aws.secretKey
* - Instance profile credentials delivered through the Amazon EC2 metadata service
*
*
*
* All service calls made using this new client object are blocking, and will not return until the service call
* completes.
*
* @see DefaultAWSCredentialsProviderChain
* @deprecated use {@link AmazonGameLiftClientBuilder#defaultClient()}
*/
@Deprecated
public AmazonGameLiftClient() {
this(DefaultAWSCredentialsProviderChain.getInstance(), configFactory.getConfig());
}
/**
* Constructs a new client to invoke service methods on Amazon GameLift. A credentials provider chain will be used
* that searches for credentials in this order:
*
* - Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
* - Java System Properties - aws.accessKeyId and aws.secretKey
* - Instance profile credentials delivered through the Amazon EC2 metadata service
*
*
*
* All service calls made using this new client object are blocking, and will not return until the service call
* completes.
*
* @param clientConfiguration
* The client configuration options controlling how this client connects to Amazon GameLift (ex: proxy
* settings, retry counts, etc.).
*
* @see DefaultAWSCredentialsProviderChain
* @deprecated use {@link AmazonGameLiftClientBuilder#withClientConfiguration(ClientConfiguration)}
*/
@Deprecated
public AmazonGameLiftClient(ClientConfiguration clientConfiguration) {
this(DefaultAWSCredentialsProviderChain.getInstance(), clientConfiguration);
}
/**
* Constructs a new client to invoke service methods on Amazon GameLift using the specified AWS account credentials.
*
*
* All service calls made using this new client object are blocking, and will not return until the service call
* completes.
*
* @param awsCredentials
* The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.
* @deprecated use {@link AmazonGameLiftClientBuilder#withCredentials(AWSCredentialsProvider)} for example:
* {@code AmazonGameLiftClientBuilder.standard().withCredentials(new AWSStaticCredentialsProvider(awsCredentials)).build();}
*/
@Deprecated
public AmazonGameLiftClient(AWSCredentials awsCredentials) {
this(awsCredentials, configFactory.getConfig());
}
/**
* Constructs a new client to invoke service methods on Amazon GameLift using the specified AWS account credentials
* and client configuration options.
*
*
* All service calls made using this new client object are blocking, and will not return until the service call
* completes.
*
* @param awsCredentials
* The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.
* @param clientConfiguration
* The client configuration options controlling how this client connects to Amazon GameLift (ex: proxy
* settings, retry counts, etc.).
* @deprecated use {@link AmazonGameLiftClientBuilder#withCredentials(AWSCredentialsProvider)} and
* {@link AmazonGameLiftClientBuilder#withClientConfiguration(ClientConfiguration)}
*/
@Deprecated
public AmazonGameLiftClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration) {
super(clientConfiguration);
this.awsCredentialsProvider = new StaticCredentialsProvider(awsCredentials);
this.advancedConfig = AdvancedConfig.EMPTY;
init();
}
/**
* Constructs a new client to invoke service methods on Amazon GameLift using the specified AWS account credentials
* provider.
*
*
* All service calls made using this new client object are blocking, and will not return until the service call
* completes.
*
* @param awsCredentialsProvider
* The AWS credentials provider which will provide credentials to authenticate requests with AWS services.
* @deprecated use {@link AmazonGameLiftClientBuilder#withCredentials(AWSCredentialsProvider)}
*/
@Deprecated
public AmazonGameLiftClient(AWSCredentialsProvider awsCredentialsProvider) {
this(awsCredentialsProvider, configFactory.getConfig());
}
/**
* Constructs a new client to invoke service methods on Amazon GameLift using the specified AWS account credentials
* provider and client configuration options.
*
*
* All service calls made using this new client object are blocking, and will not return until the service call
* completes.
*
* @param awsCredentialsProvider
* The AWS credentials provider which will provide credentials to authenticate requests with AWS services.
* @param clientConfiguration
* The client configuration options controlling how this client connects to Amazon GameLift (ex: proxy
* settings, retry counts, etc.).
* @deprecated use {@link AmazonGameLiftClientBuilder#withCredentials(AWSCredentialsProvider)} and
* {@link AmazonGameLiftClientBuilder#withClientConfiguration(ClientConfiguration)}
*/
@Deprecated
public AmazonGameLiftClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration) {
this(awsCredentialsProvider, clientConfiguration, null);
}
/**
* Constructs a new client to invoke service methods on Amazon GameLift using the specified AWS account credentials
* provider, client configuration options, and request metric collector.
*
*
* All service calls made using this new client object are blocking, and will not return until the service call
* completes.
*
* @param awsCredentialsProvider
* The AWS credentials provider which will provide credentials to authenticate requests with AWS services.
* @param clientConfiguration
* The client configuration options controlling how this client connects to Amazon GameLift (ex: proxy
* settings, retry counts, etc.).
* @param requestMetricCollector
* optional request metric collector
* @deprecated use {@link AmazonGameLiftClientBuilder#withCredentials(AWSCredentialsProvider)} and
* {@link AmazonGameLiftClientBuilder#withClientConfiguration(ClientConfiguration)} and
* {@link AmazonGameLiftClientBuilder#withMetricsCollector(RequestMetricCollector)}
*/
@Deprecated
public AmazonGameLiftClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration,
RequestMetricCollector requestMetricCollector) {
super(clientConfiguration, requestMetricCollector);
this.awsCredentialsProvider = awsCredentialsProvider;
this.advancedConfig = AdvancedConfig.EMPTY;
init();
}
public static AmazonGameLiftClientBuilder builder() {
return AmazonGameLiftClientBuilder.standard();
}
/**
* Constructs a new client to invoke service methods on Amazon GameLift 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.
*/
AmazonGameLiftClient(AwsSyncClientParams clientParams) {
this(clientParams, false);
}
/**
* Constructs a new client to invoke service methods on Amazon GameLift 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.
*/
AmazonGameLiftClient(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("https://gamelift.us-east-1.amazonaws.com");
HandlerChainFactory chainFactory = new HandlerChainFactory();
requestHandler2s.addAll(chainFactory.newRequestHandlerChain("/com/amazonaws/services/gamelift/request.handlers"));
requestHandler2s.addAll(chainFactory.newRequestHandler2Chain("/com/amazonaws/services/gamelift/request.handler2s"));
requestHandler2s.addAll(chainFactory.getGlobalHandlers());
}
/**
*
* Registers a player's acceptance or rejection of a proposed FlexMatch match. A matchmaking configuration may
* require player acceptance; if so, then matches built with that configuration cannot be completed unless all
* players accept the proposed match within a specified time limit.
*
*
* When FlexMatch builds a match, all the matchmaking tickets involved in the proposed match are placed into status
* REQUIRES_ACCEPTANCE. This is a trigger for your game to get acceptance from all players in each
* ticket. Calls to this action are only valid for tickets that are in this status; calls for tickets not in this
* status result in an error.
*
*
* To register acceptance, specify the ticket ID, one or more players, and an acceptance response. When all players
* have accepted, Amazon GameLift advances the matchmaking tickets to status PLACING, and attempts to
* create a new game session for the match.
*
*
* If any player rejects the match, or if acceptances are not received before a specified timeout, the proposed
* match is dropped. Each matchmaking ticket in the failed match is handled as follows:
*
*
* -
*
* If the ticket has one or more players who rejected the match or failed to respond, the ticket status is set
* CANCELLED and processing is terminated.
*
*
* -
*
* If all players in the ticket accepted the match, the ticket status is returned to SEARCHING to find
* a new match.
*
*
*
*
* Learn more
*
*
* Add FlexMatch to a game
* client
*
*
* FlexMatch events
* (reference)
*
*
* @param acceptMatchRequest
* @return Result of the AcceptMatch operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.AcceptMatch
* @see AWS API
* Documentation
*/
@Override
public AcceptMatchResult acceptMatch(AcceptMatchRequest request) {
request = beforeClientExecution(request);
return executeAcceptMatch(request);
}
@SdkInternalApi
final AcceptMatchResult executeAcceptMatch(AcceptMatchRequest acceptMatchRequest) {
ExecutionContext executionContext = createExecutionContext(acceptMatchRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new AcceptMatchRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(acceptMatchRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "AcceptMatch");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new AcceptMatchResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation is used with the Amazon GameLift FleetIQ solution and game server groups.
*
*
* Locates an available game server and temporarily reserves it to host gameplay and players. This operation is
* called from a game client or client service (such as a matchmaker) to request hosting resources for a new game
* session. In response, Amazon GameLift FleetIQ locates an available game server, places it in CLAIMED
* status for 60 seconds, and returns connection information that players can use to connect to the game server.
*
*
* To claim a game server, identify a game server group. You can also specify a game server ID, although this
* approach bypasses Amazon GameLift FleetIQ placement optimization. Optionally, include game data to pass to the
* game server at the start of a game session, such as a game map or player information. Add filter options to
* further restrict how a game server is chosen, such as only allowing game servers on ACTIVE instances
* to be claimed.
*
*
* When a game server is successfully claimed, connection information is returned. A claimed game server's
* utilization status remains AVAILABLE while the claim status is set to CLAIMED for up to
* 60 seconds. This time period gives the game server time to update its status to UTILIZED after
* players join. If the game server's status is not updated within 60 seconds, the game server reverts to unclaimed
* status and is available to be claimed by another request. The claim time period is a fixed value and is not
* configurable.
*
*
* If you try to claim a specific game server, this request will fail in the following cases:
*
*
* -
*
* If the game server utilization status is UTILIZED.
*
*
* -
*
* If the game server claim status is CLAIMED.
*
*
* -
*
* If the game server is running on an instance in DRAINING status and the provided filter option does
* not allow placing on DRAINING instances.
*
*
*
*
* Learn more
*
*
* Amazon GameLift FleetIQ
* Guide
*
*
* @param claimGameServerRequest
* @return Result of the ClaimGameServer operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws ConflictException
* The requested operation would cause a conflict with the current state of a service resource associated
* with the request. Resolve the conflict before retrying this request.
* @throws OutOfCapacityException
* The specified game server group has no available game servers to fulfill a ClaimGameServer
* request. Clients can retry such requests immediately or after a waiting period.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.ClaimGameServer
* @see AWS API
* Documentation
*/
@Override
public ClaimGameServerResult claimGameServer(ClaimGameServerRequest request) {
request = beforeClientExecution(request);
return executeClaimGameServer(request);
}
@SdkInternalApi
final ClaimGameServerResult executeClaimGameServer(ClaimGameServerRequest claimGameServerRequest) {
ExecutionContext executionContext = createExecutionContext(claimGameServerRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ClaimGameServerRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(claimGameServerRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "ClaimGameServer");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new ClaimGameServerResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Creates an alias for a fleet. In most situations, you can use an alias ID in place of a fleet ID. An alias
* provides a level of abstraction for a fleet that is useful when redirecting player traffic from one fleet to
* another, such as when updating your game build.
*
*
* Amazon GameLift supports two types of routing strategies for aliases: simple and terminal. A simple alias points
* to an active fleet. A terminal alias is used to display messaging or link to a URL instead of routing players to
* an active fleet. For example, you might use a terminal alias when a game version is no longer supported and you
* want to direct players to an upgrade site.
*
*
* To create a fleet alias, specify an alias name, routing strategy, and optional description. Each simple alias can
* point to only one fleet, but a fleet can have multiple aliases. If successful, a new alias record is returned,
* including an alias ID and an ARN. You can reassign an alias to another fleet by calling UpdateAlias.
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param createAliasRequest
* @return Result of the CreateAlias operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws ConflictException
* The requested operation would cause a conflict with the current state of a service resource associated
* with the request. Resolve the conflict before retrying this request.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws LimitExceededException
* The requested operation would cause the resource to exceed the allowed service limit. Resolve the issue
* before retrying.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @sample AmazonGameLift.CreateAlias
* @see AWS API
* Documentation
*/
@Override
public CreateAliasResult createAlias(CreateAliasRequest request) {
request = beforeClientExecution(request);
return executeCreateAlias(request);
}
@SdkInternalApi
final CreateAliasResult executeCreateAlias(CreateAliasRequest createAliasRequest) {
ExecutionContext executionContext = createExecutionContext(createAliasRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreateAliasRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(createAliasRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreateAlias");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new CreateAliasResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Creates a new Amazon GameLift build resource for your game server binary files. Combine game server binaries into
* a zip file for use with Amazon GameLift.
*
*
*
* When setting up a new game build for Amazon GameLift, we recommend using the CLI command upload-build . This
* helper command combines two tasks: (1) it uploads your build files from a file directory to an Amazon GameLift
* Amazon S3 location, and (2) it creates a new build resource.
*
*
*
* You can use the CreateBuild operation in the following scenarios:
*
*
* -
*
* Create a new game build with build files that are in an Amazon S3 location under an Amazon Web Services account
* that you control. To use this option, you give Amazon GameLift access to the Amazon S3 bucket. With permissions
* in place, specify a build name, operating system, and the Amazon S3 storage location of your game build.
*
*
* -
*
* Upload your build files to a Amazon GameLift Amazon S3 location. To use this option, specify a build name and
* operating system. This operation creates a new build resource and also returns an Amazon S3 location with
* temporary access credentials. Use the credentials to manually upload your build files to the specified Amazon S3
* location. For more information, see Uploading Objects in the
* Amazon S3 Developer Guide. After you upload build files to the Amazon GameLift Amazon S3 location, you
* can't update them.
*
*
*
*
* If successful, this operation creates a new build resource with a unique build ID and places it in
* INITIALIZED status. A build must be in READY status before you can create fleets with
* it.
*
*
* Learn more
*
*
*
* Create a Build with Files in Amazon S3
*
*
* All APIs by task
*
*
* @param createBuildRequest
* @return Result of the CreateBuild operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws ConflictException
* The requested operation would cause a conflict with the current state of a service resource associated
* with the request. Resolve the conflict before retrying this request.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.CreateBuild
* @see AWS API
* Documentation
*/
@Override
public CreateBuildResult createBuild(CreateBuildRequest request) {
request = beforeClientExecution(request);
return executeCreateBuild(request);
}
@SdkInternalApi
final CreateBuildResult executeCreateBuild(CreateBuildRequest createBuildRequest) {
ExecutionContext executionContext = createExecutionContext(createBuildRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreateBuildRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(createBuildRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreateBuild");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new CreateBuildResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation is used with the Amazon GameLift containers feature, which is currently in public preview.
*
*
* Creates a ContainerGroupDefinition resource that describes a set of containers for hosting your game
* server with Amazon GameLift managed EC2 hosting. An Amazon GameLift container group is similar to a container
* "task" and "pod". Each container group can have one or more containers.
*
*
* Use container group definitions when you create a container fleet. Container group definitions determine how
* Amazon GameLift deploys your containers to each instance in a container fleet.
*
*
* You can create two types of container groups, based on scheduling strategy:
*
*
* -
*
* A replica container group manages the containers that run your game server application and supporting
* software. Replica container groups might be replicated multiple times on each fleet instance, depending on
* instance resources.
*
*
* -
*
* A daemon container group manages containers that run other software, such as background services, logging,
* or test processes. You might use a daemon container group for processes that need to run only once per fleet
* instance, or processes that need to persist independently of the replica container group.
*
*
*
*
* To create a container group definition, specify a group name, a list of container definitions, and maximum total
* CPU and memory requirements for the container group. Specify an operating system and scheduling strategy or use
* the default values. When using the Amazon Web Services CLI tool, you can pass in your container definitions as a
* JSON file.
*
*
*
* This operation requires Identity and Access Management (IAM) permissions to access container images in Amazon ECR
* repositories. See IAM
* permissions for Amazon GameLift for help setting the appropriate permissions.
*
*
*
* If successful, this operation creates a new ContainerGroupDefinition resource with an ARN value
* assigned. You can't change the properties of a container group definition. Instead, create a new one.
*
*
* Learn more
*
*
* -
*
*
* -
*
*
* -
*
*
*
*
* @param createContainerGroupDefinitionRequest
* @return Result of the CreateContainerGroupDefinition operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws ConflictException
* The requested operation would cause a conflict with the current state of a service resource associated
* with the request. Resolve the conflict before retrying this request.
* @throws LimitExceededException
* The requested operation would cause the resource to exceed the allowed service limit. Resolve the issue
* before retrying.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.CreateContainerGroupDefinition
* @see AWS API Documentation
*/
@Override
public CreateContainerGroupDefinitionResult createContainerGroupDefinition(CreateContainerGroupDefinitionRequest request) {
request = beforeClientExecution(request);
return executeCreateContainerGroupDefinition(request);
}
@SdkInternalApi
final CreateContainerGroupDefinitionResult executeCreateContainerGroupDefinition(CreateContainerGroupDefinitionRequest createContainerGroupDefinitionRequest) {
ExecutionContext executionContext = createExecutionContext(createContainerGroupDefinitionRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreateContainerGroupDefinitionRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(createContainerGroupDefinitionRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreateContainerGroupDefinition");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new CreateContainerGroupDefinitionResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation has been expanded to use with the Amazon GameLift containers feature, which is currently in
* public preview.
*
*
* Creates a fleet of compute resources to host your game servers. Use this operation to set up the following types
* of fleets based on compute type:
*
*
* Managed EC2 fleet
*
*
* An EC2 fleet is a set of Amazon Elastic Compute Cloud (Amazon EC2) instances. Your game server build is deployed
* to each fleet instance. Amazon GameLift manages the fleet's instances and controls the lifecycle of game server
* processes, which host game sessions for players. EC2 fleets can have instances in multiple locations. Each
* instance in the fleet is designated a Compute.
*
*
* To create an EC2 fleet, provide these required parameters:
*
*
* -
*
* Either BuildId or ScriptId
*
*
* -
*
* ComputeType set to EC2 (the default value)
*
*
* -
*
* EC2InboundPermissions
*
*
* -
*
* EC2InstanceType
*
*
* -
*
* FleetType
*
*
* -
*
* Name
*
*
* -
*
* RuntimeConfiguration with at least one ServerProcesses configuration
*
*
*
*
* If successful, this operation creates a new fleet resource and places it in NEW status while Amazon
* GameLift initiates the fleet creation workflow. To debug your fleet, fetch logs, view performance metrics or other actions on the
* fleet, create a development fleet with port 22/3389 open. As a best practice, we recommend opening ports for
* remote access only when you need them and closing them when you're finished.
*
*
* When the fleet status is ACTIVE, you can adjust capacity settings and turn autoscaling on/off for each location.
*
*
* Managed container fleet
*
*
* A container fleet is a set of Amazon Elastic Compute Cloud (Amazon EC2) instances. Your container architecture is
* deployed to each fleet instance based on the fleet configuration. Amazon GameLift manages the containers on each
* fleet instance and controls the lifecycle of game server processes, which host game sessions for players.
* Container fleets can have instances in multiple locations. Each container on an instance that runs game server
* processes is registered as a Compute.
*
*
* To create a container fleet, provide these required parameters:
*
*
* -
*
* ComputeType set to CONTAINER
*
*
* -
*
* ContainerGroupsConfiguration
*
*
* -
*
* EC2InboundPermissions
*
*
* -
*
* EC2InstanceType
*
*
* -
*
* FleetType set to ON_DEMAND
*
*
* -
*
* Name
*
*
* -
*
* RuntimeConfiguration with at least one ServerProcesses configuration
*
*
*
*
* If successful, this operation creates a new fleet resource and places it in NEW status while Amazon
* GameLift initiates the fleet creation workflow.
*
*
* When the fleet status is ACTIVE, you can adjust capacity settings and turn autoscaling on/off for each location.
*
*
* Anywhere fleet
*
*
* An Anywhere fleet represents compute resources that are not owned or managed by Amazon GameLift. You might create
* an Anywhere fleet with your local machine for testing, or use one to host game servers with on-premises hardware
* or other game hosting solutions.
*
*
* To create an Anywhere fleet, provide these required parameters:
*
*
* -
*
* ComputeType set to ANYWHERE
*
*
* -
*
* Locations specifying a custom location
*
*
* -
*
* Name
*
*
*
*
* If successful, this operation creates a new fleet resource and places it in ACTIVE status. You can
* register computes with a fleet in ACTIVE status.
*
*
* Learn more
*
*
*
* Setting up a
* container fleet
*
*
* Debug fleet creation issues
*
*
*
* @param createFleetRequest
* @return Result of the CreateFleet operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws NotReadyException
* The operation failed because Amazon GameLift has not yet finished validating this compute. We recommend
* attempting 8 to 10 retries over 3 to 5 minutes with exponential backoffs and jitter.
* @throws ConflictException
* The requested operation would cause a conflict with the current state of a service resource associated
* with the request. Resolve the conflict before retrying this request.
* @throws LimitExceededException
* The requested operation would cause the resource to exceed the allowed service limit. Resolve the issue
* before retrying.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.CreateFleet
* @see AWS API
* Documentation
*/
@Override
public CreateFleetResult createFleet(CreateFleetRequest request) {
request = beforeClientExecution(request);
return executeCreateFleet(request);
}
@SdkInternalApi
final CreateFleetResult executeCreateFleet(CreateFleetRequest createFleetRequest) {
ExecutionContext executionContext = createExecutionContext(createFleetRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreateFleetRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(createFleetRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreateFleet");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new CreateFleetResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation has been expanded to use with the Amazon GameLift containers feature, which is currently in
* public preview.
*
*
* Adds remote locations to an EC2 or container fleet and begins populating the new locations with instances. The
* new instances conform to the fleet's instance type, auto-scaling, and other configuration settings.
*
*
*
* You can't add remote locations to a fleet that resides in an Amazon Web Services Region that doesn't support
* multiple locations. Fleets created prior to March 2021 can't support multiple locations.
*
*
*
* To add fleet locations, specify the fleet to be updated and provide a list of one or more locations.
*
*
* If successful, this operation returns the list of added locations with their status set to NEW.
* Amazon GameLift initiates the process of starting an instance in each added location. You can track the status of
* each new location by monitoring location creation events using DescribeFleetEvents.
*
*
* Learn more
*
*
*
*
* @param createFleetLocationsRequest
* @return Result of the CreateFleetLocations operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws NotReadyException
* The operation failed because Amazon GameLift has not yet finished validating this compute. We recommend
* attempting 8 to 10 retries over 3 to 5 minutes with exponential backoffs and jitter.
* @throws InvalidFleetStatusException
* The requested operation would cause a conflict with the current state of a resource associated with the
* request and/or the fleet. Resolve the conflict before retrying.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @throws ConflictException
* The requested operation would cause a conflict with the current state of a service resource associated
* with the request. Resolve the conflict before retrying this request.
* @throws LimitExceededException
* The requested operation would cause the resource to exceed the allowed service limit. Resolve the issue
* before retrying.
* @sample AmazonGameLift.CreateFleetLocations
* @see AWS
* API Documentation
*/
@Override
public CreateFleetLocationsResult createFleetLocations(CreateFleetLocationsRequest request) {
request = beforeClientExecution(request);
return executeCreateFleetLocations(request);
}
@SdkInternalApi
final CreateFleetLocationsResult executeCreateFleetLocations(CreateFleetLocationsRequest createFleetLocationsRequest) {
ExecutionContext executionContext = createExecutionContext(createFleetLocationsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreateFleetLocationsRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(createFleetLocationsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreateFleetLocations");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new CreateFleetLocationsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation is used with the Amazon GameLift FleetIQ solution and game server groups.
*
*
* Creates a Amazon GameLift FleetIQ game server group for managing game hosting on a collection of Amazon Elastic
* Compute Cloud instances for game hosting. This operation creates the game server group, creates an Auto Scaling
* group in your Amazon Web Services account, and establishes a link between the two groups. You can view the status
* of your game server groups in the Amazon GameLift console. Game server group metrics and events are emitted to
* Amazon CloudWatch.
*
*
* Before creating a new game server group, you must have the following:
*
*
* -
*
* An Amazon Elastic Compute Cloud launch template that specifies how to launch Amazon Elastic Compute Cloud
* instances with your game server build. For more information, see Launching an Instance from
* a Launch Template in the Amazon Elastic Compute Cloud User Guide.
*
*
* -
*
* An IAM role that extends limited access to your Amazon Web Services account to allow Amazon GameLift FleetIQ to
* create and interact with the Auto Scaling group. For more information, see Create IAM roles
* for cross-service interaction in the Amazon GameLift FleetIQ Developer Guide.
*
*
*
*
* To create a new game server group, specify a unique group name, IAM role and Amazon Elastic Compute Cloud launch
* template, and provide a list of instance types that can be used in the group. You must also set initial maximum
* and minimum limits on the group's instance count. You can optionally set an Auto Scaling policy with target
* tracking based on a Amazon GameLift FleetIQ metric.
*
*
* Once the game server group and corresponding Auto Scaling group are created, you have full access to change the
* Auto Scaling group's configuration as needed. Several properties that are set when creating a game server group,
* including maximum/minimum size and auto-scaling policy settings, must be updated directly in the Auto Scaling
* group. Keep in mind that some Auto Scaling group properties are periodically updated by Amazon GameLift FleetIQ
* as part of its balancing activities to optimize for availability and cost.
*
*
* Learn more
*
*
* Amazon GameLift FleetIQ
* Guide
*
*
* @param createGameServerGroupRequest
* @return Result of the CreateGameServerGroup operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws ConflictException
* The requested operation would cause a conflict with the current state of a service resource associated
* with the request. Resolve the conflict before retrying this request.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws LimitExceededException
* The requested operation would cause the resource to exceed the allowed service limit. Resolve the issue
* before retrying.
* @sample AmazonGameLift.CreateGameServerGroup
* @see AWS
* API Documentation
*/
@Override
public CreateGameServerGroupResult createGameServerGroup(CreateGameServerGroupRequest request) {
request = beforeClientExecution(request);
return executeCreateGameServerGroup(request);
}
@SdkInternalApi
final CreateGameServerGroupResult executeCreateGameServerGroup(CreateGameServerGroupRequest createGameServerGroupRequest) {
ExecutionContext executionContext = createExecutionContext(createGameServerGroupRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreateGameServerGroupRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(createGameServerGroupRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreateGameServerGroup");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory
.createResponseHandler(new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new CreateGameServerGroupResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Creates a multiplayer game session for players in a specific fleet location. This operation prompts an available
* server process to start a game session and retrieves connection information for the new game session. As an
* alternative, consider using the Amazon GameLift game session placement feature with StartGameSessionPlacement , which uses the FleetIQ algorithm and queues to optimize the placement process.
*
*
* When creating a game session, you specify exactly where you want to place it and provide a set of game session
* configuration settings. The target fleet must be in ACTIVE status.
*
*
* You can use this operation in the following ways:
*
*
* -
*
* To create a game session on an instance in a fleet's home Region, provide a fleet or alias ID along with your
* game session configuration.
*
*
* -
*
* To create a game session on an instance in a fleet's remote location, provide a fleet or alias ID and a location
* name, along with your game session configuration.
*
*
* -
*
* To create a game session on an instance in an Anywhere fleet, specify the fleet's custom location.
*
*
*
*
* If successful, Amazon GameLift initiates a workflow to start a new game session and returns a
* GameSession object containing the game session configuration and status. When the game session
* status is ACTIVE, it is updated with connection information and you can create player sessions for
* the game session. By default, newly created game sessions are open to new players. You can restrict new player
* access by using UpdateGameSession
* to change the game session's player session creation policy.
*
*
* Amazon GameLift retains logs for active for 14 days. To access the logs, call GetGameSessionLogUrl to download the log files.
*
*
* Available in Amazon GameLift Local.
*
*
* Learn more
*
*
*
* All APIs by task
*
*
* @param createGameSessionRequest
* @return Result of the CreateGameSession operation returned by the service.
* @throws ConflictException
* The requested operation would cause a conflict with the current state of a service resource associated
* with the request. Resolve the conflict before retrying this request.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidFleetStatusException
* The requested operation would cause a conflict with the current state of a resource associated with the
* request and/or the fleet. Resolve the conflict before retrying.
* @throws TerminalRoutingStrategyException
* The service is unable to resolve the routing for a particular alias because it has a terminal
* RoutingStrategy associated with it. The message returned in this exception is the message
* defined in the routing strategy itself. Such requests should only be retried if the routing strategy for
* the specified alias is modified.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws FleetCapacityExceededException
* The specified fleet has no available instances to fulfill a CreateGameSession request.
* Clients can retry such requests immediately or after a waiting period.
* @throws LimitExceededException
* The requested operation would cause the resource to exceed the allowed service limit. Resolve the issue
* before retrying.
* @throws IdempotentParameterMismatchException
* A game session with this custom ID string already exists in this fleet. Resolve this conflict before
* retrying this request.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.CreateGameSession
* @see AWS API
* Documentation
*/
@Override
public CreateGameSessionResult createGameSession(CreateGameSessionRequest request) {
request = beforeClientExecution(request);
return executeCreateGameSession(request);
}
@SdkInternalApi
final CreateGameSessionResult executeCreateGameSession(CreateGameSessionRequest createGameSessionRequest) {
ExecutionContext executionContext = createExecutionContext(createGameSessionRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreateGameSessionRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(createGameSessionRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreateGameSession");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new CreateGameSessionResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Creates a placement queue that processes requests for new game sessions. A queue uses FleetIQ algorithms to
* determine the best placement locations and find an available game server there, then prompts the game server
* process to start a new game session.
*
*
* A game session queue is configured with a set of destinations (Amazon GameLift fleets or aliases), which
* determine the locations where the queue can place new game sessions. These destinations can span multiple fleet
* types (Spot and On-Demand), instance types, and Amazon Web Services Regions. If the queue includes multi-location
* fleets, the queue is able to place game sessions in all of a fleet's remote locations. You can opt to filter out
* individual locations if needed.
*
*
* The queue configuration also determines how FleetIQ selects the best available placement for a new game session.
* Before searching for an available game server, FleetIQ first prioritizes the queue's destinations and locations,
* with the best placement locations on top. You can set up the queue to use the FleetIQ default prioritization or
* provide an alternate set of priorities.
*
*
* To create a new queue, provide a name, timeout value, and a list of destinations. Optionally, specify a sort
* configuration and/or a filter, and define a set of latency cap policies. You can also include the ARN for an
* Amazon Simple Notification Service (SNS) topic to receive notifications of game session placement activity.
* Notifications using SNS or CloudWatch events is the preferred way to track placement activity.
*
*
* If successful, a new GameSessionQueue object is returned with an assigned queue ARN. New game
* session requests, which are submitted to queue with StartGameSessionPlacement or StartMatchmaking,
* reference a queue's name or ARN.
*
*
* Learn more
*
*
* Design a game session
* queue
*
*
* Create a game session
* queue
*
*
* Related actions
*
*
*
* CreateGameSessionQueue | DescribeGameSessionQueues | UpdateGameSessionQueue | DeleteGameSessionQueue | All APIs by task
*
*
* @param createGameSessionQueueRequest
* @return Result of the CreateGameSessionQueue operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws LimitExceededException
* The requested operation would cause the resource to exceed the allowed service limit. Resolve the issue
* before retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @sample AmazonGameLift.CreateGameSessionQueue
* @see AWS API Documentation
*/
@Override
public CreateGameSessionQueueResult createGameSessionQueue(CreateGameSessionQueueRequest request) {
request = beforeClientExecution(request);
return executeCreateGameSessionQueue(request);
}
@SdkInternalApi
final CreateGameSessionQueueResult executeCreateGameSessionQueue(CreateGameSessionQueueRequest createGameSessionQueueRequest) {
ExecutionContext executionContext = createExecutionContext(createGameSessionQueueRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreateGameSessionQueueRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(createGameSessionQueueRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreateGameSessionQueue");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new CreateGameSessionQueueResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Creates a custom location for use in an Anywhere fleet.
*
*
* @param createLocationRequest
* @return Result of the CreateLocation operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws LimitExceededException
* The requested operation would cause the resource to exceed the allowed service limit. Resolve the issue
* before retrying.
* @throws ConflictException
* The requested operation would cause a conflict with the current state of a service resource associated
* with the request. Resolve the conflict before retrying this request.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.CreateLocation
* @see AWS API
* Documentation
*/
@Override
public CreateLocationResult createLocation(CreateLocationRequest request) {
request = beforeClientExecution(request);
return executeCreateLocation(request);
}
@SdkInternalApi
final CreateLocationResult executeCreateLocation(CreateLocationRequest createLocationRequest) {
ExecutionContext executionContext = createExecutionContext(createLocationRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreateLocationRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(createLocationRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreateLocation");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new CreateLocationResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Defines a new matchmaking configuration for use with FlexMatch. Whether your are using FlexMatch with Amazon
* GameLift hosting or as a standalone matchmaking service, the matchmaking configuration sets out rules for
* matching players and forming teams. If you're also using Amazon GameLift hosting, it defines how to start game
* sessions for each match. Your matchmaking system can use multiple configurations to handle different game
* scenarios. All matchmaking requests identify the matchmaking configuration to use and provide player attributes
* consistent with that configuration.
*
*
* To create a matchmaking configuration, you must provide the following: configuration name and FlexMatch mode
* (with or without Amazon GameLift hosting); a rule set that specifies how to evaluate players and find acceptable
* matches; whether player acceptance is required; and the maximum time allowed for a matchmaking attempt. When
* using FlexMatch with Amazon GameLift hosting, you also need to identify the game session queue to use when
* starting a game session for the match.
*
*
* In addition, you must set up an Amazon Simple Notification Service topic to receive matchmaking notifications.
* Provide the topic ARN in the matchmaking configuration.
*
*
* Learn more
*
*
* Design a FlexMatch
* matchmaker
*
*
* Set up FlexMatch
* event notification
*
*
* @param createMatchmakingConfigurationRequest
* @return Result of the CreateMatchmakingConfiguration operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws LimitExceededException
* The requested operation would cause the resource to exceed the allowed service limit. Resolve the issue
* before retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @sample AmazonGameLift.CreateMatchmakingConfiguration
* @see AWS API Documentation
*/
@Override
public CreateMatchmakingConfigurationResult createMatchmakingConfiguration(CreateMatchmakingConfigurationRequest request) {
request = beforeClientExecution(request);
return executeCreateMatchmakingConfiguration(request);
}
@SdkInternalApi
final CreateMatchmakingConfigurationResult executeCreateMatchmakingConfiguration(CreateMatchmakingConfigurationRequest createMatchmakingConfigurationRequest) {
ExecutionContext executionContext = createExecutionContext(createMatchmakingConfigurationRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreateMatchmakingConfigurationRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(createMatchmakingConfigurationRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreateMatchmakingConfiguration");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new CreateMatchmakingConfigurationResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Creates a new rule set for FlexMatch matchmaking. A rule set describes the type of match to create, such as the
* number and size of teams. It also sets the parameters for acceptable player matches, such as minimum skill level
* or character type.
*
*
* To create a matchmaking rule set, provide unique rule set name and the rule set body in JSON format. Rule sets
* must be defined in the same Region as the matchmaking configuration they are used with.
*
*
* Since matchmaking rule sets cannot be edited, it is a good idea to check the rule set syntax using ValidateMatchmakingRuleSet before creating a new rule set.
*
*
* Learn more
*
*
* -
*
* Build a rule set
*
*
* -
*
*
* -
*
*
*
*
* @param createMatchmakingRuleSetRequest
* @return Result of the CreateMatchmakingRuleSet operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws LimitExceededException
* The requested operation would cause the resource to exceed the allowed service limit. Resolve the issue
* before retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @sample AmazonGameLift.CreateMatchmakingRuleSet
* @see AWS API Documentation
*/
@Override
public CreateMatchmakingRuleSetResult createMatchmakingRuleSet(CreateMatchmakingRuleSetRequest request) {
request = beforeClientExecution(request);
return executeCreateMatchmakingRuleSet(request);
}
@SdkInternalApi
final CreateMatchmakingRuleSetResult executeCreateMatchmakingRuleSet(CreateMatchmakingRuleSetRequest createMatchmakingRuleSetRequest) {
ExecutionContext executionContext = createExecutionContext(createMatchmakingRuleSetRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreateMatchmakingRuleSetRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(createMatchmakingRuleSetRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreateMatchmakingRuleSet");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new CreateMatchmakingRuleSetResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Reserves an open player slot in a game session for a player. New player sessions can be created in any game
* session with an open slot that is in ACTIVE status and has a player creation policy of
* ACCEPT_ALL. You can add a group of players to a game session with CreatePlayerSessions .
*
*
* To create a player session, specify a game session ID, player ID, and optionally a set of player data.
*
*
* If successful, a slot is reserved in the game session for the player and a new PlayerSessions object
* is returned with a player session ID. The player references the player session ID when sending a connection
* request to the game session, and the game server can use it to validate the player reservation with the Amazon
* GameLift service. Player sessions cannot be updated.
*
*
* The maximum number of players per game session is 200. It is not adjustable.
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param createPlayerSessionRequest
* @return Result of the CreatePlayerSession operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidGameSessionStatusException
* The requested operation would cause a conflict with the current state of a resource associated with the
* request and/or the game instance. Resolve the conflict before retrying.
* @throws GameSessionFullException
* The game instance is currently full and cannot allow the requested player(s) to join. Clients can retry
* such requests immediately or after a waiting period.
* @throws TerminalRoutingStrategyException
* The service is unable to resolve the routing for a particular alias because it has a terminal
* RoutingStrategy associated with it. The message returned in this exception is the message
* defined in the routing strategy itself. Such requests should only be retried if the routing strategy for
* the specified alias is modified.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @sample AmazonGameLift.CreatePlayerSession
* @see AWS
* API Documentation
*/
@Override
public CreatePlayerSessionResult createPlayerSession(CreatePlayerSessionRequest request) {
request = beforeClientExecution(request);
return executeCreatePlayerSession(request);
}
@SdkInternalApi
final CreatePlayerSessionResult executeCreatePlayerSession(CreatePlayerSessionRequest createPlayerSessionRequest) {
ExecutionContext executionContext = createExecutionContext(createPlayerSessionRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreatePlayerSessionRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(createPlayerSessionRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreatePlayerSession");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new CreatePlayerSessionResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Reserves open slots in a game session for a group of players. New player sessions can be created in any game
* session with an open slot that is in ACTIVE status and has a player creation policy of
* ACCEPT_ALL. To add a single player to a game session, use CreatePlayerSession
*
*
* To create player sessions, specify a game session ID and a list of player IDs. Optionally, provide a set of
* player data for each player ID.
*
*
* If successful, a slot is reserved in the game session for each player, and new PlayerSession objects
* are returned with player session IDs. Each player references their player session ID when sending a connection
* request to the game session, and the game server can use it to validate the player reservation with the Amazon
* GameLift service. Player sessions cannot be updated.
*
*
* The maximum number of players per game session is 200. It is not adjustable.
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param createPlayerSessionsRequest
* @return Result of the CreatePlayerSessions operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidGameSessionStatusException
* The requested operation would cause a conflict with the current state of a resource associated with the
* request and/or the game instance. Resolve the conflict before retrying.
* @throws GameSessionFullException
* The game instance is currently full and cannot allow the requested player(s) to join. Clients can retry
* such requests immediately or after a waiting period.
* @throws TerminalRoutingStrategyException
* The service is unable to resolve the routing for a particular alias because it has a terminal
* RoutingStrategy associated with it. The message returned in this exception is the message
* defined in the routing strategy itself. Such requests should only be retried if the routing strategy for
* the specified alias is modified.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @sample AmazonGameLift.CreatePlayerSessions
* @see AWS
* API Documentation
*/
@Override
public CreatePlayerSessionsResult createPlayerSessions(CreatePlayerSessionsRequest request) {
request = beforeClientExecution(request);
return executeCreatePlayerSessions(request);
}
@SdkInternalApi
final CreatePlayerSessionsResult executeCreatePlayerSessions(CreatePlayerSessionsRequest createPlayerSessionsRequest) {
ExecutionContext executionContext = createExecutionContext(createPlayerSessionsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreatePlayerSessionsRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(createPlayerSessionsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreatePlayerSessions");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new CreatePlayerSessionsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Creates a new script record for your Realtime Servers script. Realtime scripts are JavaScript that provide
* configuration settings and optional custom game logic for your game. The script is deployed when you create a
* Realtime Servers fleet to host your game sessions. Script logic is executed during an active game session.
*
*
* To create a new script record, specify a script name and provide the script file(s). The script files and all
* dependencies must be zipped into a single file. You can pull the zip file from either of these locations:
*
*
* -
*
* A locally available directory. Use the ZipFile parameter for this option.
*
*
* -
*
* An Amazon Simple Storage Service (Amazon S3) bucket under your Amazon Web Services account. Use the
* StorageLocation parameter for this option. You'll need to have an Identity Access Management (IAM) role
* that allows the Amazon GameLift service to access your S3 bucket.
*
*
*
*
* If the call is successful, a new script record is created with a unique script ID. If the script file is provided
* as a local file, the file is uploaded to an Amazon GameLift-owned S3 bucket and the script record's storage
* location reflects this location. If the script file is provided as an S3 bucket, Amazon GameLift accesses the
* file at this storage location as needed for deployment.
*
*
* Learn more
*
*
* Amazon GameLift Realtime
* Servers
*
*
* Set Up a Role for
* Amazon GameLift Access
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param createScriptRequest
* @return Result of the CreateScript operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws ConflictException
* The requested operation would cause a conflict with the current state of a service resource associated
* with the request. Resolve the conflict before retrying this request.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.CreateScript
* @see AWS API
* Documentation
*/
@Override
public CreateScriptResult createScript(CreateScriptRequest request) {
request = beforeClientExecution(request);
return executeCreateScript(request);
}
@SdkInternalApi
final CreateScriptResult executeCreateScript(CreateScriptRequest createScriptRequest) {
ExecutionContext executionContext = createExecutionContext(createScriptRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreateScriptRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(createScriptRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreateScript");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new CreateScriptResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Requests authorization to create or delete a peer connection between the VPC for your Amazon GameLift fleet and a
* virtual private cloud (VPC) in your Amazon Web Services account. VPC peering enables the game servers on your
* fleet to communicate directly with other Amazon Web Services resources. After you've received authorization, use
*
* CreateVpcPeeringConnection to establish the peering connection. For more information, see VPC Peering with Amazon
* GameLift Fleets.
*
*
* You can peer with VPCs that are owned by any Amazon Web Services account you have access to, including the
* account that you use to manage your Amazon GameLift fleets. You cannot peer with VPCs that are in different
* Regions.
*
*
* To request authorization to create a connection, call this operation from the Amazon Web Services account with
* the VPC that you want to peer to your Amazon GameLift fleet. For example, to enable your game servers to retrieve
* data from a DynamoDB table, use the account that manages that DynamoDB resource. Identify the following values:
* (1) The ID of the VPC that you want to peer with, and (2) the ID of the Amazon Web Services account that you use
* to manage Amazon GameLift. If successful, VPC peering is authorized for the specified VPC.
*
*
* To request authorization to delete a connection, call this operation from the Amazon Web Services account with
* the VPC that is peered with your Amazon GameLift fleet. Identify the following values: (1) VPC ID that you want
* to delete the peering connection for, and (2) ID of the Amazon Web Services account that you use to manage Amazon
* GameLift.
*
*
* The authorization remains valid for 24 hours unless it is canceled. You must create or delete the peering
* connection while the authorization is valid.
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param createVpcPeeringAuthorizationRequest
* @return Result of the CreateVpcPeeringAuthorization operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.CreateVpcPeeringAuthorization
* @see AWS API Documentation
*/
@Override
public CreateVpcPeeringAuthorizationResult createVpcPeeringAuthorization(CreateVpcPeeringAuthorizationRequest request) {
request = beforeClientExecution(request);
return executeCreateVpcPeeringAuthorization(request);
}
@SdkInternalApi
final CreateVpcPeeringAuthorizationResult executeCreateVpcPeeringAuthorization(CreateVpcPeeringAuthorizationRequest createVpcPeeringAuthorizationRequest) {
ExecutionContext executionContext = createExecutionContext(createVpcPeeringAuthorizationRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreateVpcPeeringAuthorizationRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(createVpcPeeringAuthorizationRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreateVpcPeeringAuthorization");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new CreateVpcPeeringAuthorizationResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Establishes a VPC peering connection between a virtual private cloud (VPC) in an Amazon Web Services account with
* the VPC for your Amazon GameLift fleet. VPC peering enables the game servers on your fleet to communicate
* directly with other Amazon Web Services resources. You can peer with VPCs in any Amazon Web Services account that
* you have access to, including the account that you use to manage your Amazon GameLift fleets. You cannot peer
* with VPCs that are in different Regions. For more information, see VPC Peering with Amazon
* GameLift Fleets.
*
*
* Before calling this operation to establish the peering connection, you first need to use CreateVpcPeeringAuthorization and identify the VPC you want to peer with. Once the authorization for the
* specified VPC is issued, you have 24 hours to establish the connection. These two operations handle all tasks
* necessary to peer the two VPCs, including acceptance, updating routing tables, etc.
*
*
* To establish the connection, call this operation from the Amazon Web Services account that is used to manage the
* Amazon GameLift fleets. Identify the following values: (1) The ID of the fleet you want to be enable a VPC
* peering connection for; (2) The Amazon Web Services account with the VPC that you want to peer with; and (3) The
* ID of the VPC you want to peer with. This operation is asynchronous. If successful, a connection request is
* created. You can use continuous polling to track the request's status using DescribeVpcPeeringConnections , or by monitoring fleet events for success or failure using DescribeFleetEvents .
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param createVpcPeeringConnectionRequest
* @return Result of the CreateVpcPeeringConnection operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.CreateVpcPeeringConnection
* @see AWS API Documentation
*/
@Override
public CreateVpcPeeringConnectionResult createVpcPeeringConnection(CreateVpcPeeringConnectionRequest request) {
request = beforeClientExecution(request);
return executeCreateVpcPeeringConnection(request);
}
@SdkInternalApi
final CreateVpcPeeringConnectionResult executeCreateVpcPeeringConnection(CreateVpcPeeringConnectionRequest createVpcPeeringConnectionRequest) {
ExecutionContext executionContext = createExecutionContext(createVpcPeeringConnectionRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreateVpcPeeringConnectionRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(createVpcPeeringConnectionRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "CreateVpcPeeringConnection");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new CreateVpcPeeringConnectionResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Deletes an alias. This operation removes all record of the alias. Game clients attempting to access a server
* process using the deleted alias receive an error. To delete an alias, specify the alias ID to be deleted.
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param deleteAliasRequest
* @return Result of the DeleteAlias operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.DeleteAlias
* @see AWS API
* Documentation
*/
@Override
public DeleteAliasResult deleteAlias(DeleteAliasRequest request) {
request = beforeClientExecution(request);
return executeDeleteAlias(request);
}
@SdkInternalApi
final DeleteAliasResult executeDeleteAlias(DeleteAliasRequest deleteAliasRequest) {
ExecutionContext executionContext = createExecutionContext(deleteAliasRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeleteAliasRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(deleteAliasRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeleteAlias");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DeleteAliasResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Deletes a build. This operation permanently deletes the build resource and any uploaded build files. Deleting a
* build does not affect the status of any active fleets using the build, but you can no longer create new fleets
* with the deleted build.
*
*
* To delete a build, specify the build ID.
*
*
* Learn more
*
*
* Upload a Custom
* Server Build
*
*
* All APIs by task
*
*
* @param deleteBuildRequest
* @return Result of the DeleteBuild operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @sample AmazonGameLift.DeleteBuild
* @see AWS API
* Documentation
*/
@Override
public DeleteBuildResult deleteBuild(DeleteBuildRequest request) {
request = beforeClientExecution(request);
return executeDeleteBuild(request);
}
@SdkInternalApi
final DeleteBuildResult executeDeleteBuild(DeleteBuildRequest deleteBuildRequest) {
ExecutionContext executionContext = createExecutionContext(deleteBuildRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeleteBuildRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(deleteBuildRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeleteBuild");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DeleteBuildResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation is used with the Amazon GameLift containers feature, which is currently in public preview.
*
*
* Deletes a container group definition resource. You can delete a container group definition if there are no fleets
* using the definition.
*
*
* To delete a container group definition, identify the resource to delete.
*
*
* Learn more
*
*
* -
*
*
*
*
* @param deleteContainerGroupDefinitionRequest
* @return Result of the DeleteContainerGroupDefinition operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.DeleteContainerGroupDefinition
* @see AWS API Documentation
*/
@Override
public DeleteContainerGroupDefinitionResult deleteContainerGroupDefinition(DeleteContainerGroupDefinitionRequest request) {
request = beforeClientExecution(request);
return executeDeleteContainerGroupDefinition(request);
}
@SdkInternalApi
final DeleteContainerGroupDefinitionResult executeDeleteContainerGroupDefinition(DeleteContainerGroupDefinitionRequest deleteContainerGroupDefinitionRequest) {
ExecutionContext executionContext = createExecutionContext(deleteContainerGroupDefinitionRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeleteContainerGroupDefinitionRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(deleteContainerGroupDefinitionRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeleteContainerGroupDefinition");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DeleteContainerGroupDefinitionResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Deletes all resources and information related to a fleet and shuts down any currently running fleet instances,
* including those in remote locations.
*
*
*
* If the fleet being deleted has a VPC peering connection, you first need to get a valid authorization (good for 24
* hours) by calling CreateVpcPeeringAuthorization. You don't need to explicitly delete the VPC peering connection.
*
*
*
* To delete a fleet, specify the fleet ID to be terminated. During the deletion process, the fleet status is
* changed to DELETING. When completed, the status switches to TERMINATED and the fleet
* event FLEET_DELETED is emitted.
*
*
* Learn more
*
*
* Setting up Amazon GameLift
* Fleets
*
*
* @param deleteFleetRequest
* @return Result of the DeleteFleet operation returned by the service.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws InvalidFleetStatusException
* The requested operation would cause a conflict with the current state of a resource associated with the
* request and/or the fleet. Resolve the conflict before retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @sample AmazonGameLift.DeleteFleet
* @see AWS API
* Documentation
*/
@Override
public DeleteFleetResult deleteFleet(DeleteFleetRequest request) {
request = beforeClientExecution(request);
return executeDeleteFleet(request);
}
@SdkInternalApi
final DeleteFleetResult executeDeleteFleet(DeleteFleetRequest deleteFleetRequest) {
ExecutionContext executionContext = createExecutionContext(deleteFleetRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeleteFleetRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(deleteFleetRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeleteFleet");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DeleteFleetResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Removes locations from a multi-location fleet. When deleting a location, all game server process and all
* instances that are still active in the location are shut down.
*
*
* To delete fleet locations, identify the fleet ID and provide a list of the locations to be deleted.
*
*
* If successful, GameLift sets the location status to DELETING, and begins to shut down existing
* server processes and terminate instances in each location being deleted. When completed, the location status
* changes to TERMINATED.
*
*
* Learn more
*
*
* Setting up Amazon GameLift
* fleets
*
*
* @param deleteFleetLocationsRequest
* @return Result of the DeleteFleetLocations operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.DeleteFleetLocations
* @see AWS
* API Documentation
*/
@Override
public DeleteFleetLocationsResult deleteFleetLocations(DeleteFleetLocationsRequest request) {
request = beforeClientExecution(request);
return executeDeleteFleetLocations(request);
}
@SdkInternalApi
final DeleteFleetLocationsResult executeDeleteFleetLocations(DeleteFleetLocationsRequest deleteFleetLocationsRequest) {
ExecutionContext executionContext = createExecutionContext(deleteFleetLocationsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeleteFleetLocationsRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(deleteFleetLocationsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeleteFleetLocations");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DeleteFleetLocationsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation is used with the Amazon GameLift FleetIQ solution and game server groups.
*
*
* Terminates a game server group and permanently deletes the game server group record. You have several options for
* how these resources are impacted when deleting the game server group. Depending on the type of delete operation
* selected, this operation might affect these resources:
*
*
* -
*
* The game server group
*
*
* -
*
* The corresponding Auto Scaling group
*
*
* -
*
* All game servers that are currently running in the group
*
*
*
*
* To delete a game server group, identify the game server group to delete and specify the type of delete operation
* to initiate. Game server groups can only be deleted if they are in ACTIVE or ERROR
* status.
*
*
* If the delete request is successful, a series of operations are kicked off. The game server group status is
* changed to DELETE_SCHEDULED, which prevents new game servers from being registered and stops
* automatic scaling activity. Once all game servers in the game server group are deregistered, Amazon GameLift
* FleetIQ can begin deleting resources. If any of the delete operations fail, the game server group is placed in
* ERROR status.
*
*
* Amazon GameLift FleetIQ emits delete events to Amazon CloudWatch.
*
*
* Learn more
*
*
* Amazon GameLift FleetIQ
* Guide
*
*
* @param deleteGameServerGroupRequest
* @return Result of the DeleteGameServerGroup operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.DeleteGameServerGroup
* @see AWS
* API Documentation
*/
@Override
public DeleteGameServerGroupResult deleteGameServerGroup(DeleteGameServerGroupRequest request) {
request = beforeClientExecution(request);
return executeDeleteGameServerGroup(request);
}
@SdkInternalApi
final DeleteGameServerGroupResult executeDeleteGameServerGroup(DeleteGameServerGroupRequest deleteGameServerGroupRequest) {
ExecutionContext executionContext = createExecutionContext(deleteGameServerGroupRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeleteGameServerGroupRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(deleteGameServerGroupRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeleteGameServerGroup");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory
.createResponseHandler(new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DeleteGameServerGroupResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Deletes a game session queue. Once a queue is successfully deleted, unfulfilled StartGameSessionPlacement requests that reference the queue will fail. To delete a queue, specify the queue
* name.
*
*
* @param deleteGameSessionQueueRequest
* @return Result of the DeleteGameSessionQueue operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @sample AmazonGameLift.DeleteGameSessionQueue
* @see AWS API Documentation
*/
@Override
public DeleteGameSessionQueueResult deleteGameSessionQueue(DeleteGameSessionQueueRequest request) {
request = beforeClientExecution(request);
return executeDeleteGameSessionQueue(request);
}
@SdkInternalApi
final DeleteGameSessionQueueResult executeDeleteGameSessionQueue(DeleteGameSessionQueueRequest deleteGameSessionQueueRequest) {
ExecutionContext executionContext = createExecutionContext(deleteGameSessionQueueRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeleteGameSessionQueueRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(deleteGameSessionQueueRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeleteGameSessionQueue");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DeleteGameSessionQueueResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Deletes a custom location.
*
*
* Before deleting a custom location, review any fleets currently using the custom location and deregister the
* location if it is in use. For more information, see DeregisterCompute.
*
*
* @param deleteLocationRequest
* @return Result of the DeleteLocation operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.DeleteLocation
* @see AWS API
* Documentation
*/
@Override
public DeleteLocationResult deleteLocation(DeleteLocationRequest request) {
request = beforeClientExecution(request);
return executeDeleteLocation(request);
}
@SdkInternalApi
final DeleteLocationResult executeDeleteLocation(DeleteLocationRequest deleteLocationRequest) {
ExecutionContext executionContext = createExecutionContext(deleteLocationRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeleteLocationRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(deleteLocationRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeleteLocation");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DeleteLocationResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Permanently removes a FlexMatch matchmaking configuration. To delete, specify the configuration name. A
* matchmaking configuration cannot be deleted if it is being used in any active matchmaking tickets.
*
*
* @param deleteMatchmakingConfigurationRequest
* @return Result of the DeleteMatchmakingConfiguration operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @sample AmazonGameLift.DeleteMatchmakingConfiguration
* @see AWS API Documentation
*/
@Override
public DeleteMatchmakingConfigurationResult deleteMatchmakingConfiguration(DeleteMatchmakingConfigurationRequest request) {
request = beforeClientExecution(request);
return executeDeleteMatchmakingConfiguration(request);
}
@SdkInternalApi
final DeleteMatchmakingConfigurationResult executeDeleteMatchmakingConfiguration(DeleteMatchmakingConfigurationRequest deleteMatchmakingConfigurationRequest) {
ExecutionContext executionContext = createExecutionContext(deleteMatchmakingConfigurationRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeleteMatchmakingConfigurationRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(deleteMatchmakingConfigurationRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeleteMatchmakingConfiguration");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DeleteMatchmakingConfigurationResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Deletes an existing matchmaking rule set. To delete the rule set, provide the rule set name. Rule sets cannot be
* deleted if they are currently being used by a matchmaking configuration.
*
*
* Learn more
*
*
* -
*
* Build a rule set
*
*
*
*
* @param deleteMatchmakingRuleSetRequest
* @return Result of the DeleteMatchmakingRuleSet operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @sample AmazonGameLift.DeleteMatchmakingRuleSet
* @see AWS API Documentation
*/
@Override
public DeleteMatchmakingRuleSetResult deleteMatchmakingRuleSet(DeleteMatchmakingRuleSetRequest request) {
request = beforeClientExecution(request);
return executeDeleteMatchmakingRuleSet(request);
}
@SdkInternalApi
final DeleteMatchmakingRuleSetResult executeDeleteMatchmakingRuleSet(DeleteMatchmakingRuleSetRequest deleteMatchmakingRuleSetRequest) {
ExecutionContext executionContext = createExecutionContext(deleteMatchmakingRuleSetRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeleteMatchmakingRuleSetRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(deleteMatchmakingRuleSetRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeleteMatchmakingRuleSet");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DeleteMatchmakingRuleSetResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Deletes a fleet scaling policy. Once deleted, the policy is no longer in force and Amazon GameLift removes all
* record of it. To delete a scaling policy, specify both the scaling policy name and the fleet ID it is associated
* with.
*
*
* To temporarily suspend scaling policies, use StopFleetActions.
* This operation suspends all policies for the fleet.
*
*
* @param deleteScalingPolicyRequest
* @return Result of the DeleteScalingPolicy operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @sample AmazonGameLift.DeleteScalingPolicy
* @see AWS
* API Documentation
*/
@Override
public DeleteScalingPolicyResult deleteScalingPolicy(DeleteScalingPolicyRequest request) {
request = beforeClientExecution(request);
return executeDeleteScalingPolicy(request);
}
@SdkInternalApi
final DeleteScalingPolicyResult executeDeleteScalingPolicy(DeleteScalingPolicyRequest deleteScalingPolicyRequest) {
ExecutionContext executionContext = createExecutionContext(deleteScalingPolicyRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeleteScalingPolicyRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(deleteScalingPolicyRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeleteScalingPolicy");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DeleteScalingPolicyResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Deletes a Realtime script. This operation permanently deletes the script record. If script files were uploaded,
* they are also deleted (files stored in an S3 bucket are not deleted).
*
*
* To delete a script, specify the script ID. Before deleting a script, be sure to terminate all fleets that are
* deployed with the script being deleted. Fleet instances periodically check for script updates, and if the script
* record no longer exists, the instance will go into an error state and be unable to host game sessions.
*
*
* Learn more
*
*
* Amazon GameLift Realtime
* Servers
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param deleteScriptRequest
* @return Result of the DeleteScript operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.DeleteScript
* @see AWS API
* Documentation
*/
@Override
public DeleteScriptResult deleteScript(DeleteScriptRequest request) {
request = beforeClientExecution(request);
return executeDeleteScript(request);
}
@SdkInternalApi
final DeleteScriptResult executeDeleteScript(DeleteScriptRequest deleteScriptRequest) {
ExecutionContext executionContext = createExecutionContext(deleteScriptRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeleteScriptRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(deleteScriptRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeleteScript");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DeleteScriptResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Cancels a pending VPC peering authorization for the specified VPC. If you need to delete an existing VPC peering
* connection, use DeleteVpcPeeringConnection.
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param deleteVpcPeeringAuthorizationRequest
* @return Result of the DeleteVpcPeeringAuthorization operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.DeleteVpcPeeringAuthorization
* @see AWS API Documentation
*/
@Override
public DeleteVpcPeeringAuthorizationResult deleteVpcPeeringAuthorization(DeleteVpcPeeringAuthorizationRequest request) {
request = beforeClientExecution(request);
return executeDeleteVpcPeeringAuthorization(request);
}
@SdkInternalApi
final DeleteVpcPeeringAuthorizationResult executeDeleteVpcPeeringAuthorization(DeleteVpcPeeringAuthorizationRequest deleteVpcPeeringAuthorizationRequest) {
ExecutionContext executionContext = createExecutionContext(deleteVpcPeeringAuthorizationRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeleteVpcPeeringAuthorizationRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(deleteVpcPeeringAuthorizationRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeleteVpcPeeringAuthorization");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DeleteVpcPeeringAuthorizationResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Removes a VPC peering connection. To delete the connection, you must have a valid authorization for the VPC
* peering connection that you want to delete..
*
*
* Once a valid authorization exists, call this operation from the Amazon Web Services account that is used to
* manage the Amazon GameLift fleets. Identify the connection to delete by the connection ID and fleet ID. If
* successful, the connection is removed.
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param deleteVpcPeeringConnectionRequest
* @return Result of the DeleteVpcPeeringConnection operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.DeleteVpcPeeringConnection
* @see AWS API Documentation
*/
@Override
public DeleteVpcPeeringConnectionResult deleteVpcPeeringConnection(DeleteVpcPeeringConnectionRequest request) {
request = beforeClientExecution(request);
return executeDeleteVpcPeeringConnection(request);
}
@SdkInternalApi
final DeleteVpcPeeringConnectionResult executeDeleteVpcPeeringConnection(DeleteVpcPeeringConnectionRequest deleteVpcPeeringConnectionRequest) {
ExecutionContext executionContext = createExecutionContext(deleteVpcPeeringConnectionRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeleteVpcPeeringConnectionRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(deleteVpcPeeringConnectionRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeleteVpcPeeringConnection");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DeleteVpcPeeringConnectionResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation has been expanded to use with the Amazon GameLift containers feature, which is currently in
* public preview.
*
*
* Removes a compute resource from an Amazon GameLift Anywhere fleet or container fleet. Deregistered computes can
* no longer host game sessions through Amazon GameLift.
*
*
* For an Anywhere fleet or a container fleet that's running the Amazon GameLift Agent, the Agent handles all
* compute registry tasks for you. For an Anywhere fleet that doesn't use the Agent, call this operation to
* deregister fleet computes.
*
*
* To deregister a compute, call this operation from the compute that's being deregistered and specify the compute
* name and the fleet ID.
*
*
* @param deregisterComputeRequest
* @return Result of the DeregisterCompute operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.DeregisterCompute
* @see AWS API
* Documentation
*/
@Override
public DeregisterComputeResult deregisterCompute(DeregisterComputeRequest request) {
request = beforeClientExecution(request);
return executeDeregisterCompute(request);
}
@SdkInternalApi
final DeregisterComputeResult executeDeregisterCompute(DeregisterComputeRequest deregisterComputeRequest) {
ExecutionContext executionContext = createExecutionContext(deregisterComputeRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeregisterComputeRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(deregisterComputeRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeregisterCompute");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DeregisterComputeResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation is used with the Amazon GameLift FleetIQ solution and game server groups.
*
*
* Removes the game server from a game server group. As a result of this operation, the deregistered game server can
* no longer be claimed and will not be returned in a list of active game servers.
*
*
* To deregister a game server, specify the game server group and game server ID. If successful, this operation
* emits a CloudWatch event with termination timestamp and reason.
*
*
* Learn more
*
*
* Amazon GameLift FleetIQ
* Guide
*
*
* @param deregisterGameServerRequest
* @return Result of the DeregisterGameServer operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.DeregisterGameServer
* @see AWS
* API Documentation
*/
@Override
public DeregisterGameServerResult deregisterGameServer(DeregisterGameServerRequest request) {
request = beforeClientExecution(request);
return executeDeregisterGameServer(request);
}
@SdkInternalApi
final DeregisterGameServerResult executeDeregisterGameServer(DeregisterGameServerRequest deregisterGameServerRequest) {
ExecutionContext executionContext = createExecutionContext(deregisterGameServerRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeregisterGameServerRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(deregisterGameServerRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DeregisterGameServer");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DeregisterGameServerResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves properties for an alias. This operation returns all alias metadata and settings. To get an alias's
* target fleet ID only, use ResolveAlias.
*
*
* To get alias properties, specify the alias ID. If successful, the requested alias record is returned.
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param describeAliasRequest
* @return Result of the DescribeAlias operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.DescribeAlias
* @see AWS API
* Documentation
*/
@Override
public DescribeAliasResult describeAlias(DescribeAliasRequest request) {
request = beforeClientExecution(request);
return executeDescribeAlias(request);
}
@SdkInternalApi
final DescribeAliasResult executeDescribeAlias(DescribeAliasRequest describeAliasRequest) {
ExecutionContext executionContext = createExecutionContext(describeAliasRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeAliasRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(describeAliasRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeAlias");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DescribeAliasResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves properties for a custom game build. To request a build resource, specify a build ID. If successful, an
* object containing the build properties is returned.
*
*
* Learn more
*
*
* Upload a Custom
* Server Build
*
*
* All APIs by task
*
*
* @param describeBuildRequest
* @return Result of the DescribeBuild operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.DescribeBuild
* @see AWS API
* Documentation
*/
@Override
public DescribeBuildResult describeBuild(DescribeBuildRequest request) {
request = beforeClientExecution(request);
return executeDescribeBuild(request);
}
@SdkInternalApi
final DescribeBuildResult executeDescribeBuild(DescribeBuildRequest describeBuildRequest) {
ExecutionContext executionContext = createExecutionContext(describeBuildRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeBuildRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(describeBuildRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeBuild");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DescribeBuildResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation has been expanded to use with the Amazon GameLift containers feature, which is currently in
* public preview.
*
*
* Retrieves properties for a compute resource in an Amazon GameLift fleet. To get a list of all computes in a
* fleet, call ListCompute.
*
*
* To request information on a specific compute, provide the fleet ID and compute name.
*
*
* If successful, this operation returns details for the requested compute resource. Depending on the fleet's
* compute type, the result includes the following information:
*
*
* -
*
* For EC2 fleets, this operation returns information about the EC2 instance.
*
*
* -
*
* For ANYWHERE fleets, this operation returns information about the registered compute.
*
*
* -
*
* For CONTAINER fleets, this operation returns information about the container that's registered as a
* compute, and the instance it's running on. The compute name is the container name.
*
*
*
*
* @param describeComputeRequest
* @return Result of the DescribeCompute operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.DescribeCompute
* @see AWS API
* Documentation
*/
@Override
public DescribeComputeResult describeCompute(DescribeComputeRequest request) {
request = beforeClientExecution(request);
return executeDescribeCompute(request);
}
@SdkInternalApi
final DescribeComputeResult executeDescribeCompute(DescribeComputeRequest describeComputeRequest) {
ExecutionContext executionContext = createExecutionContext(describeComputeRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeComputeRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(describeComputeRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeCompute");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DescribeComputeResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation is used with the Amazon GameLift containers feature, which is currently in public preview.
*
*
* Retrieves the properties of a container group definition, including all container definitions in the group.
*
*
* To retrieve a container group definition, provide a resource identifier. If successful, this operation returns
* the complete properties of the container group definition.
*
*
* Learn more
*
*
* -
*
*
*
*
* @param describeContainerGroupDefinitionRequest
* @return Result of the DescribeContainerGroupDefinition operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.DescribeContainerGroupDefinition
* @see AWS API Documentation
*/
@Override
public DescribeContainerGroupDefinitionResult describeContainerGroupDefinition(DescribeContainerGroupDefinitionRequest request) {
request = beforeClientExecution(request);
return executeDescribeContainerGroupDefinition(request);
}
@SdkInternalApi
final DescribeContainerGroupDefinitionResult executeDescribeContainerGroupDefinition(
DescribeContainerGroupDefinitionRequest describeContainerGroupDefinitionRequest) {
ExecutionContext executionContext = createExecutionContext(describeContainerGroupDefinitionRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeContainerGroupDefinitionRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeContainerGroupDefinitionRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeContainerGroupDefinition");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeContainerGroupDefinitionResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves the instance limits and current utilization for an Amazon Web Services Region or location. Instance
* limits control the number of instances, per instance type, per location, that your Amazon Web Services account
* can use. Learn more at Amazon EC2 Instance Types. The
* information returned includes the maximum number of instances allowed and your account's current usage across all
* fleets. This information can affect your ability to scale your Amazon GameLift fleets. You can request a limit
* increase for your account by using the Service limits page in the Amazon GameLift console.
*
*
* Instance limits differ based on whether the instances are deployed in a fleet's home Region or in a remote
* location. For remote locations, limits also differ based on the combination of home Region and remote location.
* All requests must specify an Amazon Web Services Region (either explicitly or as your default settings). To get
* the limit for a remote location, you must also specify the location. For example, the following requests all
* return different results:
*
*
* -
*
* Request specifies the Region ap-northeast-1 with no location. The result is limits and usage data on
* all instance types that are deployed in us-east-2, by all of the fleets that reside in
* ap-northeast-1.
*
*
* -
*
* Request specifies the Region us-east-1 with location ca-central-1. The result is limits
* and usage data on all instance types that are deployed in ca-central-1, by all of the fleets that
* reside in us-east-2. These limits do not affect fleets in any other Regions that deploy instances to
* ca-central-1.
*
*
* -
*
* Request specifies the Region eu-west-1 with location ca-central-1. The result is limits
* and usage data on all instance types that are deployed in ca-central-1, by all of the fleets that
* reside in eu-west-1.
*
*
*
*
* This operation can be used in the following ways:
*
*
* -
*
* To get limit and usage data for all instance types that are deployed in an Amazon Web Services Region by fleets
* that reside in the same Region: Specify the Region only. Optionally, specify a single instance type to retrieve
* information for.
*
*
* -
*
* To get limit and usage data for all instance types that are deployed to a remote location by fleets that reside
* in different Amazon Web Services Region: Provide both the Amazon Web Services Region and the remote location.
* Optionally, specify a single instance type to retrieve information for.
*
*
*
*
* If successful, an EC2InstanceLimits object is returned with limits and usage data for each requested
* instance type.
*
*
* Learn more
*
*
* Setting up Amazon GameLift
* fleets
*
*
* @param describeEC2InstanceLimitsRequest
* @return Result of the DescribeEC2InstanceLimits operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.DescribeEC2InstanceLimits
* @see AWS API Documentation
*/
@Override
public DescribeEC2InstanceLimitsResult describeEC2InstanceLimits(DescribeEC2InstanceLimitsRequest request) {
request = beforeClientExecution(request);
return executeDescribeEC2InstanceLimits(request);
}
@SdkInternalApi
final DescribeEC2InstanceLimitsResult executeDescribeEC2InstanceLimits(DescribeEC2InstanceLimitsRequest describeEC2InstanceLimitsRequest) {
ExecutionContext executionContext = createExecutionContext(describeEC2InstanceLimitsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeEC2InstanceLimitsRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeEC2InstanceLimitsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeEC2InstanceLimits");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeEC2InstanceLimitsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation has been expanded to use with the Amazon GameLift containers feature, which is currently in
* public preview.
*
*
* Retrieves core fleet-wide properties for fleets in an Amazon Web Services Region. Properties include the
* computing hardware and deployment configuration for instances in the fleet.
*
*
* You can use this operation in the following ways:
*
*
* -
*
* To get attributes for specific fleets, provide a list of fleet IDs or fleet ARNs.
*
*
* -
*
* To get attributes for all fleets, do not provide a fleet identifier.
*
*
*
*
* When requesting attributes for multiple fleets, use the pagination parameters to retrieve results as a set of
* sequential pages.
*
*
* If successful, a FleetAttributes object is returned for each fleet requested, unless the fleet
* identifier is not found.
*
*
*
* Some API operations limit the number of fleet IDs that allowed in one request. If a request exceeds this limit,
* the request fails and the error message contains the maximum allowed number.
*
*
*
* Learn more
*
*
* Setting up Amazon GameLift
* fleets
*
*
* @param describeFleetAttributesRequest
* @return Result of the DescribeFleetAttributes operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @sample AmazonGameLift.DescribeFleetAttributes
* @see AWS API Documentation
*/
@Override
public DescribeFleetAttributesResult describeFleetAttributes(DescribeFleetAttributesRequest request) {
request = beforeClientExecution(request);
return executeDescribeFleetAttributes(request);
}
@SdkInternalApi
final DescribeFleetAttributesResult executeDescribeFleetAttributes(DescribeFleetAttributesRequest describeFleetAttributesRequest) {
ExecutionContext executionContext = createExecutionContext(describeFleetAttributesRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeFleetAttributesRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeFleetAttributesRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeFleetAttributes");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeFleetAttributesResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation has been expanded to use with the Amazon GameLift containers feature, which is currently in
* public preview.
*
*
* Retrieves the resource capacity settings for one or more fleets. For a container fleet, this operation also
* returns counts for replica container groups.
*
*
* With multi-location fleets, this operation retrieves data for the fleet's home Region only. To retrieve capacity
* for remote locations, see DescribeFleetLocationCapacity.
*
*
* This operation can be used in the following ways:
*
*
* -
*
* To get capacity data for one or more specific fleets, provide a list of fleet IDs or fleet ARNs.
*
*
* -
*
* To get capacity data for all fleets, do not provide a fleet identifier.
*
*
*
*
* When requesting multiple fleets, use the pagination parameters to retrieve results as a set of sequential pages.
*
*
* If successful, a FleetCapacity object is returned for each requested fleet ID. Each
* FleetCapacity object includes a Location property, which is set to the fleet's home
* Region. Capacity values are returned only for fleets that currently exist.
*
*
*
* Some API operations may limit the number of fleet IDs that are allowed in one request. If a request exceeds this
* limit, the request fails and the error message includes the maximum allowed.
*
*
*
* Learn more
*
*
* Setting up Amazon GameLift
* fleets
*
*
* GameLift metrics for fleets
*
*
* @param describeFleetCapacityRequest
* @return Result of the DescribeFleetCapacity operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @sample AmazonGameLift.DescribeFleetCapacity
* @see AWS
* API Documentation
*/
@Override
public DescribeFleetCapacityResult describeFleetCapacity(DescribeFleetCapacityRequest request) {
request = beforeClientExecution(request);
return executeDescribeFleetCapacity(request);
}
@SdkInternalApi
final DescribeFleetCapacityResult executeDescribeFleetCapacity(DescribeFleetCapacityRequest describeFleetCapacityRequest) {
ExecutionContext executionContext = createExecutionContext(describeFleetCapacityRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeFleetCapacityRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(describeFleetCapacityRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeFleetCapacity");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory
.createResponseHandler(new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeFleetCapacityResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves entries from a fleet's event log. Fleet events are initiated by changes in status, such as during fleet
* creation and termination, changes in capacity, etc. If a fleet has multiple locations, events are also initiated
* by changes to status and capacity in remote locations.
*
*
* You can specify a time range to limit the result set. Use the pagination parameters to retrieve results as a set
* of sequential pages.
*
*
* If successful, a collection of event log entries matching the request are returned.
*
*
* Learn more
*
*
* Setting up Amazon GameLift
* fleets
*
*
* @param describeFleetEventsRequest
* @return Result of the DescribeFleetEvents operation returned by the service.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @sample AmazonGameLift.DescribeFleetEvents
* @see AWS
* API Documentation
*/
@Override
public DescribeFleetEventsResult describeFleetEvents(DescribeFleetEventsRequest request) {
request = beforeClientExecution(request);
return executeDescribeFleetEvents(request);
}
@SdkInternalApi
final DescribeFleetEventsResult executeDescribeFleetEvents(DescribeFleetEventsRequest describeFleetEventsRequest) {
ExecutionContext executionContext = createExecutionContext(describeFleetEventsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeFleetEventsRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(describeFleetEventsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeFleetEvents");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DescribeFleetEventsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves information on a fleet's remote locations, including life-cycle status and any suspended fleet
* activity.
*
*
* This operation can be used in the following ways:
*
*
* -
*
* To get data for specific locations, provide a fleet identifier and a list of locations. Location data is returned
* in the order that it is requested.
*
*
* -
*
* To get data for all locations, provide a fleet identifier only. Location data is returned in no particular order.
*
*
*
*
* When requesting attributes for multiple locations, use the pagination parameters to retrieve results as a set of
* sequential pages.
*
*
* If successful, a LocationAttributes object is returned for each requested location. If the fleet
* does not have a requested location, no information is returned. This operation does not return the home Region.
* To get information on a fleet's home Region, call DescribeFleetAttributes.
*
*
* Learn more
*
*
* Setting up Amazon GameLift
* fleets
*
*
* @param describeFleetLocationAttributesRequest
* @return Result of the DescribeFleetLocationAttributes operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.DescribeFleetLocationAttributes
* @see AWS API Documentation
*/
@Override
public DescribeFleetLocationAttributesResult describeFleetLocationAttributes(DescribeFleetLocationAttributesRequest request) {
request = beforeClientExecution(request);
return executeDescribeFleetLocationAttributes(request);
}
@SdkInternalApi
final DescribeFleetLocationAttributesResult executeDescribeFleetLocationAttributes(
DescribeFleetLocationAttributesRequest describeFleetLocationAttributesRequest) {
ExecutionContext executionContext = createExecutionContext(describeFleetLocationAttributesRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeFleetLocationAttributesRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeFleetLocationAttributesRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeFleetLocationAttributes");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeFleetLocationAttributesResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves the resource capacity settings for a fleet location. The data returned includes the current capacity
* (number of EC2 instances) and some scaling settings for the requested fleet location. For a container fleet, this
* operation also returns counts for replica container groups.
*
*
* Use this operation to retrieve capacity information for a fleet's remote location or home Region (you can also
* retrieve home Region capacity by calling DescribeFleetCapacity).
*
*
* To retrieve capacity data, identify a fleet and location.
*
*
* If successful, a FleetCapacity object is returned for the requested fleet location.
*
*
* Learn more
*
*
* Setting up Amazon GameLift
* fleets
*
*
* GameLift metrics for fleets
*
*
* @param describeFleetLocationCapacityRequest
* @return Result of the DescribeFleetLocationCapacity operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.DescribeFleetLocationCapacity
* @see AWS API Documentation
*/
@Override
public DescribeFleetLocationCapacityResult describeFleetLocationCapacity(DescribeFleetLocationCapacityRequest request) {
request = beforeClientExecution(request);
return executeDescribeFleetLocationCapacity(request);
}
@SdkInternalApi
final DescribeFleetLocationCapacityResult executeDescribeFleetLocationCapacity(DescribeFleetLocationCapacityRequest describeFleetLocationCapacityRequest) {
ExecutionContext executionContext = createExecutionContext(describeFleetLocationCapacityRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeFleetLocationCapacityRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeFleetLocationCapacityRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeFleetLocationCapacity");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeFleetLocationCapacityResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves current usage data for a fleet location. Utilization data provides a snapshot of current game hosting
* activity at the requested location. Use this operation to retrieve utilization information for a fleet's remote
* location or home Region (you can also retrieve home Region utilization by calling
* DescribeFleetUtilization).
*
*
* To retrieve utilization data, identify a fleet and location.
*
*
* If successful, a FleetUtilization object is returned for the requested fleet location.
*
*
* Learn more
*
*
* Setting up Amazon GameLift
* fleets
*
*
* GameLift metrics for fleets
*
*
* @param describeFleetLocationUtilizationRequest
* @return Result of the DescribeFleetLocationUtilization operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.DescribeFleetLocationUtilization
* @see AWS API Documentation
*/
@Override
public DescribeFleetLocationUtilizationResult describeFleetLocationUtilization(DescribeFleetLocationUtilizationRequest request) {
request = beforeClientExecution(request);
return executeDescribeFleetLocationUtilization(request);
}
@SdkInternalApi
final DescribeFleetLocationUtilizationResult executeDescribeFleetLocationUtilization(
DescribeFleetLocationUtilizationRequest describeFleetLocationUtilizationRequest) {
ExecutionContext executionContext = createExecutionContext(describeFleetLocationUtilizationRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeFleetLocationUtilizationRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeFleetLocationUtilizationRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeFleetLocationUtilization");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeFleetLocationUtilizationResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves a fleet's inbound connection permissions. Connection permissions specify IP addresses and port settings
* that incoming traffic can use to access server processes in the fleet. Game server processes that are running in
* the fleet must use a port that falls within this range. To connect to game server processes on a container fleet,
* the port settings should include one or more of the fleet's connection ports.
*
*
* Use this operation in the following ways:
*
*
* -
*
* To retrieve the port settings for a fleet, identify the fleet's unique identifier.
*
*
* -
*
* To check the status of recent updates to a fleet remote location, specify the fleet ID and a location. Port
* setting updates can take time to propagate across all locations.
*
*
*
*
* If successful, a set of IpPermission objects is returned for the requested fleet ID. When specifying
* a location, this operation returns a pending status. If the requested fleet has been deleted, the result set is
* empty.
*
*
* Learn more
*
*
* Setting up Amazon GameLift
* fleets
*
*
* @param describeFleetPortSettingsRequest
* @return Result of the DescribeFleetPortSettings operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.DescribeFleetPortSettings
* @see AWS API Documentation
*/
@Override
public DescribeFleetPortSettingsResult describeFleetPortSettings(DescribeFleetPortSettingsRequest request) {
request = beforeClientExecution(request);
return executeDescribeFleetPortSettings(request);
}
@SdkInternalApi
final DescribeFleetPortSettingsResult executeDescribeFleetPortSettings(DescribeFleetPortSettingsRequest describeFleetPortSettingsRequest) {
ExecutionContext executionContext = createExecutionContext(describeFleetPortSettingsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeFleetPortSettingsRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeFleetPortSettingsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeFleetPortSettings");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeFleetPortSettingsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves utilization statistics for one or more fleets. Utilization data provides a snapshot of how the fleet's
* hosting resources are currently being used. For fleets with remote locations, this operation retrieves data for
* the fleet's home Region only. See DescribeFleetLocationUtilization to get utilization statistics for a fleet's remote locations.
*
*
* This operation can be used in the following ways:
*
*
* -
*
* To get utilization data for one or more specific fleets, provide a list of fleet IDs or fleet ARNs.
*
*
* -
*
* To get utilization data for all fleets, do not provide a fleet identifier.
*
*
*
*
* When requesting multiple fleets, use the pagination parameters to retrieve results as a set of sequential pages.
*
*
* If successful, a FleetUtilization
* object is returned for each requested fleet ID, unless the fleet identifier is not found. Each fleet utilization
* object includes a Location property, which is set to the fleet's home Region.
*
*
*
* Some API operations may limit the number of fleet IDs allowed in one request. If a request exceeds this limit,
* the request fails and the error message includes the maximum allowed.
*
*
*
* Learn more
*
*
* Setting up Amazon GameLift
* Fleets
*
*
* GameLift Metrics for Fleets
*
*
* @param describeFleetUtilizationRequest
* @return Result of the DescribeFleetUtilization operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @sample AmazonGameLift.DescribeFleetUtilization
* @see AWS API Documentation
*/
@Override
public DescribeFleetUtilizationResult describeFleetUtilization(DescribeFleetUtilizationRequest request) {
request = beforeClientExecution(request);
return executeDescribeFleetUtilization(request);
}
@SdkInternalApi
final DescribeFleetUtilizationResult executeDescribeFleetUtilization(DescribeFleetUtilizationRequest describeFleetUtilizationRequest) {
ExecutionContext executionContext = createExecutionContext(describeFleetUtilizationRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeFleetUtilizationRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeFleetUtilizationRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeFleetUtilization");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeFleetUtilizationResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation is used with the Amazon GameLift FleetIQ solution and game server groups.
*
*
* Retrieves information for a registered game server. Information includes game server status, health check info,
* and the instance that the game server is running on.
*
*
* To retrieve game server information, specify the game server ID. If successful, the requested game server object
* is returned.
*
*
* Learn more
*
*
* Amazon GameLift FleetIQ
* Guide
*
*
* @param describeGameServerRequest
* @return Result of the DescribeGameServer operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.DescribeGameServer
* @see AWS
* API Documentation
*/
@Override
public DescribeGameServerResult describeGameServer(DescribeGameServerRequest request) {
request = beforeClientExecution(request);
return executeDescribeGameServer(request);
}
@SdkInternalApi
final DescribeGameServerResult executeDescribeGameServer(DescribeGameServerRequest describeGameServerRequest) {
ExecutionContext executionContext = createExecutionContext(describeGameServerRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeGameServerRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(describeGameServerRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeGameServer");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DescribeGameServerResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation is used with the Amazon GameLift FleetIQ solution and game server groups.
*
*
* Retrieves information on a game server group. This operation returns only properties related to Amazon GameLift
* FleetIQ. To view or update properties for the corresponding Auto Scaling group, such as launch template, auto
* scaling policies, and maximum/minimum group size, access the Auto Scaling group directly.
*
*
* To get attributes for a game server group, provide a group name or ARN value. If successful, a
* GameServerGroup object is returned.
*
*
* Learn more
*
*
* Amazon GameLift FleetIQ
* Guide
*
*
* @param describeGameServerGroupRequest
* @return Result of the DescribeGameServerGroup operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.DescribeGameServerGroup
* @see AWS API Documentation
*/
@Override
public DescribeGameServerGroupResult describeGameServerGroup(DescribeGameServerGroupRequest request) {
request = beforeClientExecution(request);
return executeDescribeGameServerGroup(request);
}
@SdkInternalApi
final DescribeGameServerGroupResult executeDescribeGameServerGroup(DescribeGameServerGroupRequest describeGameServerGroupRequest) {
ExecutionContext executionContext = createExecutionContext(describeGameServerGroupRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeGameServerGroupRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeGameServerGroupRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeGameServerGroup");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeGameServerGroupResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation is used with the Amazon GameLift FleetIQ solution and game server groups.
*
*
* Retrieves status information about the Amazon EC2 instances associated with a Amazon GameLift FleetIQ game server
* group. Use this operation to detect when instances are active or not available to host new game servers.
*
*
* To request status for all instances in the game server group, provide a game server group ID only. To request
* status for specific instances, provide the game server group ID and one or more instance IDs. Use the pagination
* parameters to retrieve results in sequential segments. If successful, a collection of
* GameServerInstance objects is returned.
*
*
* This operation is not designed to be called with every game server claim request; this practice can cause you to
* exceed your API limit, which results in errors. Instead, as a best practice, cache the results and refresh your
* cache no more than once every 10 seconds.
*
*
* Learn more
*
*
* Amazon GameLift FleetIQ
* Guide
*
*
* @param describeGameServerInstancesRequest
* @return Result of the DescribeGameServerInstances operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.DescribeGameServerInstances
* @see AWS API Documentation
*/
@Override
public DescribeGameServerInstancesResult describeGameServerInstances(DescribeGameServerInstancesRequest request) {
request = beforeClientExecution(request);
return executeDescribeGameServerInstances(request);
}
@SdkInternalApi
final DescribeGameServerInstancesResult executeDescribeGameServerInstances(DescribeGameServerInstancesRequest describeGameServerInstancesRequest) {
ExecutionContext executionContext = createExecutionContext(describeGameServerInstancesRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeGameServerInstancesRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeGameServerInstancesRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeGameServerInstances");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeGameServerInstancesResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves additional game session properties, including the game session protection policy in force, a set of one
* or more game sessions in a specific fleet location. You can optionally filter the results by current game session
* status.
*
*
* This operation can be used in the following ways:
*
*
* -
*
* To retrieve details for all game sessions that are currently running on all locations in a fleet, provide a fleet
* or alias ID, with an optional status filter. This approach returns details from the fleet's home Region and all
* remote locations.
*
*
* -
*
* To retrieve details for all game sessions that are currently running on a specific fleet location, provide a
* fleet or alias ID and a location name, with optional status filter. The location can be the fleet's home Region
* or any remote location.
*
*
* -
*
* To retrieve details for a specific game session, provide the game session ID. This approach looks for the game
* session ID in all fleets that reside in the Amazon Web Services Region defined in the request.
*
*
*
*
* Use the pagination parameters to retrieve results as a set of sequential pages.
*
*
* If successful, a GameSessionDetail object is returned for each game session that matches the
* request.
*
*
* Learn more
*
*
*
* All APIs by task
*
*
* @param describeGameSessionDetailsRequest
* @return Result of the DescribeGameSessionDetails operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws TerminalRoutingStrategyException
* The service is unable to resolve the routing for a particular alias because it has a terminal
* RoutingStrategy associated with it. The message returned in this exception is the message
* defined in the routing strategy itself. Such requests should only be retried if the routing strategy for
* the specified alias is modified.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.DescribeGameSessionDetails
* @see AWS API Documentation
*/
@Override
public DescribeGameSessionDetailsResult describeGameSessionDetails(DescribeGameSessionDetailsRequest request) {
request = beforeClientExecution(request);
return executeDescribeGameSessionDetails(request);
}
@SdkInternalApi
final DescribeGameSessionDetailsResult executeDescribeGameSessionDetails(DescribeGameSessionDetailsRequest describeGameSessionDetailsRequest) {
ExecutionContext executionContext = createExecutionContext(describeGameSessionDetailsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeGameSessionDetailsRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeGameSessionDetailsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeGameSessionDetails");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeGameSessionDetailsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves information, including current status, about a game session placement request.
*
*
* To get game session placement details, specify the placement ID.
*
*
* This operation is not designed to be continually called to track game session status. This practice can cause you
* to exceed your API limit, which results in errors. Instead, you must configure configure an Amazon Simple
* Notification Service (SNS) topic to receive notifications from FlexMatch or queues. Continuously polling with
* DescribeGameSessionPlacement should only be used for games in development with low game session
* usage.
*
*
* @param describeGameSessionPlacementRequest
* @return Result of the DescribeGameSessionPlacement operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @sample AmazonGameLift.DescribeGameSessionPlacement
* @see AWS API Documentation
*/
@Override
public DescribeGameSessionPlacementResult describeGameSessionPlacement(DescribeGameSessionPlacementRequest request) {
request = beforeClientExecution(request);
return executeDescribeGameSessionPlacement(request);
}
@SdkInternalApi
final DescribeGameSessionPlacementResult executeDescribeGameSessionPlacement(DescribeGameSessionPlacementRequest describeGameSessionPlacementRequest) {
ExecutionContext executionContext = createExecutionContext(describeGameSessionPlacementRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeGameSessionPlacementRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeGameSessionPlacementRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeGameSessionPlacement");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeGameSessionPlacementResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves the properties for one or more game session queues. When requesting multiple queues, use the pagination
* parameters to retrieve results as a set of sequential pages. When specifying a list of queues, objects are
* returned only for queues that currently exist in the Region.
*
*
* Learn more
*
*
* View Your Queues
*
*
* @param describeGameSessionQueuesRequest
* @return Result of the DescribeGameSessionQueues operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @sample AmazonGameLift.DescribeGameSessionQueues
* @see AWS API Documentation
*/
@Override
public DescribeGameSessionQueuesResult describeGameSessionQueues(DescribeGameSessionQueuesRequest request) {
request = beforeClientExecution(request);
return executeDescribeGameSessionQueues(request);
}
@SdkInternalApi
final DescribeGameSessionQueuesResult executeDescribeGameSessionQueues(DescribeGameSessionQueuesRequest describeGameSessionQueuesRequest) {
ExecutionContext executionContext = createExecutionContext(describeGameSessionQueuesRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeGameSessionQueuesRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeGameSessionQueuesRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeGameSessionQueues");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeGameSessionQueuesResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves a set of one or more game sessions in a specific fleet location. You can optionally filter the results
* by current game session status.
*
*
* This operation can be used in the following ways:
*
*
* -
*
* To retrieve all game sessions that are currently running on all locations in a fleet, provide a fleet or alias
* ID, with an optional status filter. This approach returns all game sessions in the fleet's home Region and all
* remote locations.
*
*
* -
*
* To retrieve all game sessions that are currently running on a specific fleet location, provide a fleet or alias
* ID and a location name, with optional status filter. The location can be the fleet's home Region or any remote
* location.
*
*
* -
*
* To retrieve a specific game session, provide the game session ID. This approach looks for the game session ID in
* all fleets that reside in the Amazon Web Services Region defined in the request.
*
*
*
*
* Use the pagination parameters to retrieve results as a set of sequential pages.
*
*
* If successful, a GameSession object is returned for each game session that matches the request.
*
*
* This operation is not designed to be continually called to track game session status. This practice can cause you
* to exceed your API limit, which results in errors. Instead, you must configure an Amazon Simple Notification
* Service (SNS) topic to receive notifications from FlexMatch or queues. Continuously polling with
* DescribeGameSessions should only be used for games in development with low game session usage.
*
*
* Available in Amazon GameLift Local.
*
*
* Learn more
*
*
*
* All APIs by task
*
*
* @param describeGameSessionsRequest
* @return Result of the DescribeGameSessions operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws TerminalRoutingStrategyException
* The service is unable to resolve the routing for a particular alias because it has a terminal
* RoutingStrategy associated with it. The message returned in this exception is the message
* defined in the routing strategy itself. Such requests should only be retried if the routing strategy for
* the specified alias is modified.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.DescribeGameSessions
* @see AWS
* API Documentation
*/
@Override
public DescribeGameSessionsResult describeGameSessions(DescribeGameSessionsRequest request) {
request = beforeClientExecution(request);
return executeDescribeGameSessions(request);
}
@SdkInternalApi
final DescribeGameSessionsResult executeDescribeGameSessions(DescribeGameSessionsRequest describeGameSessionsRequest) {
ExecutionContext executionContext = createExecutionContext(describeGameSessionsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeGameSessionsRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(describeGameSessionsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeGameSessions");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DescribeGameSessionsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves information about the EC2 instances in an Amazon GameLift managed fleet, including instance ID,
* connection data, and status. You can use this operation with a multi-location fleet to get location-specific
* instance information. As an alternative, use the operations ListCompute and DescribeCompute to
* retrieve information for compute resources, including EC2 and Anywhere fleets.
*
*
* You can call this operation in the following ways:
*
*
* -
*
* To get information on all instances in a fleet's home Region, specify the fleet ID.
*
*
* -
*
* To get information on all instances in a fleet's remote location, specify the fleet ID and location name.
*
*
* -
*
* To get information on a specific instance in a fleet, specify the fleet ID and instance ID.
*
*
*
*
* Use the pagination parameters to retrieve results as a set of sequential pages.
*
*
* If successful, this operation returns Instance objects for each requested instance, listed in no
* particular order. If you call this operation for an Anywhere fleet, you receive an InvalidRequestException.
*
*
* Learn more
*
*
* Remotely connect
* to fleet instances
*
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param describeInstancesRequest
* @return Result of the DescribeInstances operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.DescribeInstances
* @see AWS API
* Documentation
*/
@Override
public DescribeInstancesResult describeInstances(DescribeInstancesRequest request) {
request = beforeClientExecution(request);
return executeDescribeInstances(request);
}
@SdkInternalApi
final DescribeInstancesResult executeDescribeInstances(DescribeInstancesRequest describeInstancesRequest) {
ExecutionContext executionContext = createExecutionContext(describeInstancesRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeInstancesRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(describeInstancesRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeInstances");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DescribeInstancesResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves one or more matchmaking tickets. Use this operation to retrieve ticket information, including--after a
* successful match is made--connection information for the resulting new game session.
*
*
* To request matchmaking tickets, provide a list of up to 10 ticket IDs. If the request is successful, a ticket
* object is returned for each requested ID that currently exists.
*
*
* This operation is not designed to be continually called to track matchmaking ticket status. This practice can
* cause you to exceed your API limit, which results in errors. Instead, as a best practice, set up an Amazon Simple
* Notification Service to receive notifications, and provide the topic ARN in the matchmaking configuration.
*
*
*
* Learn more
*
*
* Add FlexMatch to a game
* client
*
*
* Set Up FlexMatch
* event notification
*
*
* @param describeMatchmakingRequest
* @return Result of the DescribeMatchmaking operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.DescribeMatchmaking
* @see AWS
* API Documentation
*/
@Override
public DescribeMatchmakingResult describeMatchmaking(DescribeMatchmakingRequest request) {
request = beforeClientExecution(request);
return executeDescribeMatchmaking(request);
}
@SdkInternalApi
final DescribeMatchmakingResult executeDescribeMatchmaking(DescribeMatchmakingRequest describeMatchmakingRequest) {
ExecutionContext executionContext = createExecutionContext(describeMatchmakingRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeMatchmakingRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(describeMatchmakingRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeMatchmaking");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DescribeMatchmakingResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves the details of FlexMatch matchmaking configurations.
*
*
* This operation offers the following options: (1) retrieve all matchmaking configurations, (2) retrieve
* configurations for a specified list, or (3) retrieve all configurations that use a specified rule set name. When
* requesting multiple items, use the pagination parameters to retrieve results as a set of sequential pages.
*
*
* If successful, a configuration is returned for each requested name. When specifying a list of names, only
* configurations that currently exist are returned.
*
*
* Learn more
*
*
* Setting up FlexMatch
* matchmakers
*
*
* @param describeMatchmakingConfigurationsRequest
* @return Result of the DescribeMatchmakingConfigurations operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.DescribeMatchmakingConfigurations
* @see AWS API Documentation
*/
@Override
public DescribeMatchmakingConfigurationsResult describeMatchmakingConfigurations(DescribeMatchmakingConfigurationsRequest request) {
request = beforeClientExecution(request);
return executeDescribeMatchmakingConfigurations(request);
}
@SdkInternalApi
final DescribeMatchmakingConfigurationsResult executeDescribeMatchmakingConfigurations(
DescribeMatchmakingConfigurationsRequest describeMatchmakingConfigurationsRequest) {
ExecutionContext executionContext = createExecutionContext(describeMatchmakingConfigurationsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeMatchmakingConfigurationsRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeMatchmakingConfigurationsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeMatchmakingConfigurations");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeMatchmakingConfigurationsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves the details for FlexMatch matchmaking rule sets. You can request all existing rule sets for the Region,
* or provide a list of one or more rule set names. When requesting multiple items, use the pagination parameters to
* retrieve results as a set of sequential pages. If successful, a rule set is returned for each requested name.
*
*
* Learn more
*
*
* -
*
* Build a rule set
*
*
*
*
* @param describeMatchmakingRuleSetsRequest
* @return Result of the DescribeMatchmakingRuleSets operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.DescribeMatchmakingRuleSets
* @see AWS API Documentation
*/
@Override
public DescribeMatchmakingRuleSetsResult describeMatchmakingRuleSets(DescribeMatchmakingRuleSetsRequest request) {
request = beforeClientExecution(request);
return executeDescribeMatchmakingRuleSets(request);
}
@SdkInternalApi
final DescribeMatchmakingRuleSetsResult executeDescribeMatchmakingRuleSets(DescribeMatchmakingRuleSetsRequest describeMatchmakingRuleSetsRequest) {
ExecutionContext executionContext = createExecutionContext(describeMatchmakingRuleSetsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeMatchmakingRuleSetsRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeMatchmakingRuleSetsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeMatchmakingRuleSets");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeMatchmakingRuleSetsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves properties for one or more player sessions.
*
*
* This action can be used in the following ways:
*
*
* -
*
* To retrieve a specific player session, provide the player session ID only.
*
*
* -
*
* To retrieve all player sessions in a game session, provide the game session ID only.
*
*
* -
*
* To retrieve all player sessions for a specific player, provide a player ID only.
*
*
*
*
* To request player sessions, specify either a player session ID, game session ID, or player ID. You can filter
* this request by player session status. If you provide a specific PlayerSessionId or
* PlayerId, Amazon GameLift ignores the filter criteria. Use the pagination parameters to retrieve
* results as a set of sequential pages.
*
*
* If successful, a PlayerSession object is returned for each session that matches the request.
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param describePlayerSessionsRequest
* @return Result of the DescribePlayerSessions operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @sample AmazonGameLift.DescribePlayerSessions
* @see AWS API Documentation
*/
@Override
public DescribePlayerSessionsResult describePlayerSessions(DescribePlayerSessionsRequest request) {
request = beforeClientExecution(request);
return executeDescribePlayerSessions(request);
}
@SdkInternalApi
final DescribePlayerSessionsResult executeDescribePlayerSessions(DescribePlayerSessionsRequest describePlayerSessionsRequest) {
ExecutionContext executionContext = createExecutionContext(describePlayerSessionsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribePlayerSessionsRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(describePlayerSessionsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribePlayerSessions");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribePlayerSessionsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves a fleet's runtime configuration settings. The runtime configuration determines which server processes
* run, and how, on computes in the fleet. For managed EC2 fleets, the runtime configuration describes server
* processes that run on each fleet instance. For container fleets, the runtime configuration describes server
* processes that run in each replica container group. You can update a fleet's runtime configuration at any time
* using UpdateRuntimeConfiguration.
*
*
* To get the current runtime configuration for a fleet, provide the fleet ID.
*
*
* If successful, a RuntimeConfiguration object is returned for the requested fleet. If the requested
* fleet has been deleted, the result set is empty.
*
*
* Learn more
*
*
* Setting up Amazon GameLift
* fleets
*
*
* Running multiple
* processes on a fleet
*
*
* @param describeRuntimeConfigurationRequest
* @return Result of the DescribeRuntimeConfiguration operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @sample AmazonGameLift.DescribeRuntimeConfiguration
* @see AWS API Documentation
*/
@Override
public DescribeRuntimeConfigurationResult describeRuntimeConfiguration(DescribeRuntimeConfigurationRequest request) {
request = beforeClientExecution(request);
return executeDescribeRuntimeConfiguration(request);
}
@SdkInternalApi
final DescribeRuntimeConfigurationResult executeDescribeRuntimeConfiguration(DescribeRuntimeConfigurationRequest describeRuntimeConfigurationRequest) {
ExecutionContext executionContext = createExecutionContext(describeRuntimeConfigurationRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeRuntimeConfigurationRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeRuntimeConfigurationRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeRuntimeConfiguration");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeRuntimeConfigurationResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves all scaling policies applied to a fleet.
*
*
* To get a fleet's scaling policies, specify the fleet ID. You can filter this request by policy status, such as to
* retrieve only active scaling policies. Use the pagination parameters to retrieve results as a set of sequential
* pages. If successful, set of ScalingPolicy objects is returned for the fleet.
*
*
* A fleet may have all of its scaling policies suspended. This operation does not affect the status of the scaling
* policies, which remains ACTIVE.
*
*
* @param describeScalingPoliciesRequest
* @return Result of the DescribeScalingPolicies operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.DescribeScalingPolicies
* @see AWS API Documentation
*/
@Override
public DescribeScalingPoliciesResult describeScalingPolicies(DescribeScalingPoliciesRequest request) {
request = beforeClientExecution(request);
return executeDescribeScalingPolicies(request);
}
@SdkInternalApi
final DescribeScalingPoliciesResult executeDescribeScalingPolicies(DescribeScalingPoliciesRequest describeScalingPoliciesRequest) {
ExecutionContext executionContext = createExecutionContext(describeScalingPoliciesRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeScalingPoliciesRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeScalingPoliciesRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeScalingPolicies");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeScalingPoliciesResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves properties for a Realtime script.
*
*
* To request a script record, specify the script ID. If successful, an object containing the script properties is
* returned.
*
*
* Learn more
*
*
* Amazon GameLift Realtime
* Servers
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param describeScriptRequest
* @return Result of the DescribeScript operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @sample AmazonGameLift.DescribeScript
* @see AWS API
* Documentation
*/
@Override
public DescribeScriptResult describeScript(DescribeScriptRequest request) {
request = beforeClientExecution(request);
return executeDescribeScript(request);
}
@SdkInternalApi
final DescribeScriptResult executeDescribeScript(DescribeScriptRequest describeScriptRequest) {
ExecutionContext executionContext = createExecutionContext(describeScriptRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeScriptRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(describeScriptRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeScript");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new DescribeScriptResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves valid VPC peering authorizations that are pending for the Amazon Web Services account. This operation
* returns all VPC peering authorizations and requests for peering. This includes those initiated and received by
* this account.
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param describeVpcPeeringAuthorizationsRequest
* @return Result of the DescribeVpcPeeringAuthorizations operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.DescribeVpcPeeringAuthorizations
* @see AWS API Documentation
*/
@Override
public DescribeVpcPeeringAuthorizationsResult describeVpcPeeringAuthorizations(DescribeVpcPeeringAuthorizationsRequest request) {
request = beforeClientExecution(request);
return executeDescribeVpcPeeringAuthorizations(request);
}
@SdkInternalApi
final DescribeVpcPeeringAuthorizationsResult executeDescribeVpcPeeringAuthorizations(
DescribeVpcPeeringAuthorizationsRequest describeVpcPeeringAuthorizationsRequest) {
ExecutionContext executionContext = createExecutionContext(describeVpcPeeringAuthorizationsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeVpcPeeringAuthorizationsRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeVpcPeeringAuthorizationsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeVpcPeeringAuthorizations");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeVpcPeeringAuthorizationsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves information on VPC peering connections. Use this operation to get peering information for all fleets or
* for one specific fleet ID.
*
*
* To retrieve connection information, call this operation from the Amazon Web Services account that is used to
* manage the Amazon GameLift fleets. Specify a fleet ID or leave the parameter empty to retrieve all connection
* records. If successful, the retrieved information includes both active and pending connections. Active
* connections identify the IpV4 CIDR block that the VPC uses to connect.
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param describeVpcPeeringConnectionsRequest
* @return Result of the DescribeVpcPeeringConnections operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.DescribeVpcPeeringConnections
* @see AWS API Documentation
*/
@Override
public DescribeVpcPeeringConnectionsResult describeVpcPeeringConnections(DescribeVpcPeeringConnectionsRequest request) {
request = beforeClientExecution(request);
return executeDescribeVpcPeeringConnections(request);
}
@SdkInternalApi
final DescribeVpcPeeringConnectionsResult executeDescribeVpcPeeringConnections(DescribeVpcPeeringConnectionsRequest describeVpcPeeringConnectionsRequest) {
ExecutionContext executionContext = createExecutionContext(describeVpcPeeringConnectionsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DescribeVpcPeeringConnectionsRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(describeVpcPeeringConnectionsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "DescribeVpcPeeringConnections");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new DescribeVpcPeeringConnectionsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation has been expanded to use with the Amazon GameLift containers feature, which is currently in
* public preview.
*
*
* Requests authorization to remotely connect to a hosting resource in a Amazon GameLift managed fleet. This
* operation is not used with Amazon GameLift Anywhere fleets
*
*
* To request access, specify the compute name and the fleet ID. If successful, this operation returns a set of
* temporary Amazon Web Services credentials, including a two-part access key and a session token.
*
*
* EC2 fleets
*
*
* With an EC2 fleet (where compute type is EC2), use these credentials with Amazon EC2 Systems Manager
* (SSM) to start a session with the compute. For more details, see Starting a session (CLI) in the Amazon EC2 Systems Manager User Guide.
*
*
* Container fleets
*
*
* With a container fleet (where compute type is CONTAINER), use these credentials and the target value
* with SSM to connect to the fleet instance where the container is running. After you're connected to the instance,
* use Docker commands to interact with the container.
*
*
* Learn more
*
*
* -
*
*
* -
*
*
* -
*
*
*
*
* @param getComputeAccessRequest
* @return Result of the GetComputeAccess operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.GetComputeAccess
* @see AWS API
* Documentation
*/
@Override
public GetComputeAccessResult getComputeAccess(GetComputeAccessRequest request) {
request = beforeClientExecution(request);
return executeGetComputeAccess(request);
}
@SdkInternalApi
final GetComputeAccessResult executeGetComputeAccess(GetComputeAccessRequest getComputeAccessRequest) {
ExecutionContext executionContext = createExecutionContext(getComputeAccessRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new GetComputeAccessRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(getComputeAccessRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "GetComputeAccess");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new GetComputeAccessResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Requests an authentication token from Amazon GameLift for a compute resource in an Amazon GameLift Anywhere fleet
* or container fleet. Game servers that are running on the compute use this token to communicate with the Amazon
* GameLift service, such as when calling the Amazon GameLift server SDK action InitSDK().
* Authentication tokens are valid for a limited time span, so you need to request a fresh token before the current
* token expires.
*
*
* Use this operation based on the fleet compute type:
*
*
* -
*
* For EC2 fleets, auth token retrieval and refresh is handled automatically. All game servers that are
* running on all fleet instances have access to a valid auth token.
*
*
* -
*
* For ANYWHERE and CONTAINER fleets, if you're using the Amazon GameLift Agent, auth
* token retrieval and refresh is handled automatically for any container or Anywhere compute where the Agent is
* running. If you're not using the Agent, create a mechanism to retrieve and refresh auth tokens for computes that
* are running game server processes.
*
*
*
*
* Learn more
*
*
* -
*
*
* -
*
*
* -
*
* Server SDK
* reference guides (for version 5.x)
*
*
*
*
* @param getComputeAuthTokenRequest
* @return Result of the GetComputeAuthToken operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.GetComputeAuthToken
* @see AWS
* API Documentation
*/
@Override
public GetComputeAuthTokenResult getComputeAuthToken(GetComputeAuthTokenRequest request) {
request = beforeClientExecution(request);
return executeGetComputeAuthToken(request);
}
@SdkInternalApi
final GetComputeAuthTokenResult executeGetComputeAuthToken(GetComputeAuthTokenRequest getComputeAuthTokenRequest) {
ExecutionContext executionContext = createExecutionContext(getComputeAuthTokenRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new GetComputeAuthTokenRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(getComputeAuthTokenRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "GetComputeAuthToken");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new GetComputeAuthTokenResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves the location of stored game session logs for a specified game session on Amazon GameLift managed
* fleets. When a game session is terminated, Amazon GameLift automatically stores the logs in Amazon S3 and retains
* them for 14 days. Use this URL to download the logs.
*
*
*
* See the Amazon
* Web Services Service Limits page for maximum log file sizes. Log files that exceed this limit are not saved.
*
*
*
* All APIs by task
*
*
* @param getGameSessionLogUrlRequest
* @return Result of the GetGameSessionLogUrl operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @sample AmazonGameLift.GetGameSessionLogUrl
* @see AWS
* API Documentation
*/
@Override
public GetGameSessionLogUrlResult getGameSessionLogUrl(GetGameSessionLogUrlRequest request) {
request = beforeClientExecution(request);
return executeGetGameSessionLogUrl(request);
}
@SdkInternalApi
final GetGameSessionLogUrlResult executeGetGameSessionLogUrl(GetGameSessionLogUrlRequest getGameSessionLogUrlRequest) {
ExecutionContext executionContext = createExecutionContext(getGameSessionLogUrlRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new GetGameSessionLogUrlRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(getGameSessionLogUrlRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "GetGameSessionLogUrl");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new GetGameSessionLogUrlResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Requests authorization to remotely connect to an instance in an Amazon GameLift managed fleet. Use this operation
* to connect to instances with game servers that use Amazon GameLift server SDK 4.x or earlier. To connect to
* instances with game servers that use server SDK 5.x or later, call GetComputeAccess.
*
*
* To request access to an instance, specify IDs for the instance and the fleet it belongs to. You can retrieve
* instance IDs for a fleet by calling DescribeInstances
* with the fleet ID.
*
*
* If successful, this operation returns an IP address and credentials. The returned credentials match the operating
* system of the instance, as follows:
*
*
* -
*
* For a Windows instance: returns a user name and secret (password) for use with a Windows Remote Desktop client.
*
*
* -
*
* For a Linux instance: returns a user name and secret (RSA private key) for use with an SSH client. You must save
* the secret to a .pem file. If you're using the CLI, see the example Get credentials for a Linux instance for tips on automatically saving the secret to a .pem
* file.
*
*
*
*
* Learn more
*
*
* Remotely connect
* to fleet instances
*
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param getInstanceAccessRequest
* @return Result of the GetInstanceAccess operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.GetInstanceAccess
* @see AWS API
* Documentation
*/
@Override
public GetInstanceAccessResult getInstanceAccess(GetInstanceAccessRequest request) {
request = beforeClientExecution(request);
return executeGetInstanceAccess(request);
}
@SdkInternalApi
final GetInstanceAccessResult executeGetInstanceAccess(GetInstanceAccessRequest getInstanceAccessRequest) {
ExecutionContext executionContext = createExecutionContext(getInstanceAccessRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new GetInstanceAccessRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(getInstanceAccessRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "GetInstanceAccess");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new GetInstanceAccessResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves all aliases for this Amazon Web Services account. You can filter the result set by alias name and/or
* routing strategy type. Use the pagination parameters to retrieve results in sequential pages.
*
*
*
* Returned aliases are not listed in any particular order.
*
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param listAliasesRequest
* @return Result of the ListAliases operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.ListAliases
* @see AWS API
* Documentation
*/
@Override
public ListAliasesResult listAliases(ListAliasesRequest request) {
request = beforeClientExecution(request);
return executeListAliases(request);
}
@SdkInternalApi
final ListAliasesResult executeListAliases(ListAliasesRequest listAliasesRequest) {
ExecutionContext executionContext = createExecutionContext(listAliasesRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ListAliasesRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(listAliasesRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "ListAliases");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new ListAliasesResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves build resources for all builds associated with the Amazon Web Services account in use. You can limit
* results to builds that are in a specific status by using the Status parameter. Use the pagination
* parameters to retrieve results in a set of sequential pages.
*
*
*
* Build resources are not listed in any particular order.
*
*
*
* Learn more
*
*
* Upload a Custom
* Server Build
*
*
* All APIs by task
*
*
* @param listBuildsRequest
* @return Result of the ListBuilds operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.ListBuilds
* @see AWS API
* Documentation
*/
@Override
public ListBuildsResult listBuilds(ListBuildsRequest request) {
request = beforeClientExecution(request);
return executeListBuilds(request);
}
@SdkInternalApi
final ListBuildsResult executeListBuilds(ListBuildsRequest listBuildsRequest) {
ExecutionContext executionContext = createExecutionContext(listBuildsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ListBuildsRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(listBuildsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "ListBuilds");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(new JsonOperationMetadata()
.withPayloadJson(true).withHasStreamingSuccessResponse(false), new ListBuildsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation has been expanded to use with the Amazon GameLift containers feature, which is currently in
* public preview.
*
*
* Retrieves information on the compute resources in an Amazon GameLift fleet.
*
*
* To request a list of computes, specify the fleet ID. Use the pagination parameters to retrieve results in a set
* of sequential pages.
*
*
* You can filter the result set by location.
*
*
* If successful, this operation returns information on all computes in the requested fleet. Depending on the
* fleet's compute type, the result includes the following information:
*
*
* -
*
* For EC2 fleets, this operation returns information about the EC2 instance. Compute names are
* instance IDs.
*
*
* -
*
* For ANYWHERE fleets, this operation returns the compute names and details provided when the compute
* was registered with RegisterCompute. The GameLiftServiceSdkEndpoint or
* GameLiftAgentEndpoint is included.
*
*
* -
*
* For CONTAINER fleets, this operation returns information about containers that are registered as
* computes, and the instances they're running on. Compute names are container names.
*
*
*
*
* @param listComputeRequest
* @return Result of the ListCompute operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.ListCompute
* @see AWS API
* Documentation
*/
@Override
public ListComputeResult listCompute(ListComputeRequest request) {
request = beforeClientExecution(request);
return executeListCompute(request);
}
@SdkInternalApi
final ListComputeResult executeListCompute(ListComputeRequest listComputeRequest) {
ExecutionContext executionContext = createExecutionContext(listComputeRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ListComputeRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(listComputeRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "ListCompute");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new ListComputeResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation is used with the Amazon GameLift containers feature, which is currently in public preview.
*
*
* Retrieves all container group definitions for the Amazon Web Services account and Amazon Web Services Region that
* are currently in use. You can filter the result set by the container groups' scheduling strategy. Use the
* pagination parameters to retrieve results in a set of sequential pages.
*
*
*
* This operation returns the list of container group definitions in no particular order.
*
*
*
* Learn more
*
*
* -
*
*
*
*
* @param listContainerGroupDefinitionsRequest
* @return Result of the ListContainerGroupDefinitions operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws UnsupportedRegionException
* The requested operation is not supported in the Region specified.
* @sample AmazonGameLift.ListContainerGroupDefinitions
* @see AWS API Documentation
*/
@Override
public ListContainerGroupDefinitionsResult listContainerGroupDefinitions(ListContainerGroupDefinitionsRequest request) {
request = beforeClientExecution(request);
return executeListContainerGroupDefinitions(request);
}
@SdkInternalApi
final ListContainerGroupDefinitionsResult executeListContainerGroupDefinitions(ListContainerGroupDefinitionsRequest listContainerGroupDefinitionsRequest) {
ExecutionContext executionContext = createExecutionContext(listContainerGroupDefinitionsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ListContainerGroupDefinitionsRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(listContainerGroupDefinitionsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "ListContainerGroupDefinitions");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new ListContainerGroupDefinitionsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation has been expanded to use with the Amazon GameLift containers feature, which is currently in
* public preview.
*
*
* Retrieves a collection of fleet resources in an Amazon Web Services Region. You can filter the result set to find
* only those fleets that are deployed with a specific build or script. For fleets that have multiple locations,
* this operation retrieves fleets based on their home Region only.
*
*
* You can use operation in the following ways:
*
*
* -
*
* To get a list of all fleets in a Region, don't provide a build or script identifier.
*
*
* -
*
* To get a list of all fleets where a specific game build is deployed, provide the build ID.
*
*
* -
*
* To get a list of all Realtime Servers fleets with a specific configuration script, provide the script ID.
*
*
* -
*
* To get a list of all fleets with a specific container group definition, provide the
* ContainerGroupDefinition ID.
*
*
*
*
* Use the pagination parameters to retrieve results as a set of sequential pages.
*
*
* If successful, this operation returns a list of fleet IDs that match the request parameters. A NextToken value is
* also returned if there are more result pages to retrieve.
*
*
*
* Fleet IDs are returned in no particular order.
*
*
*
* @param listFleetsRequest
* @return Result of the ListFleets operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @sample AmazonGameLift.ListFleets
* @see AWS API
* Documentation
*/
@Override
public ListFleetsResult listFleets(ListFleetsRequest request) {
request = beforeClientExecution(request);
return executeListFleets(request);
}
@SdkInternalApi
final ListFleetsResult executeListFleets(ListFleetsRequest listFleetsRequest) {
ExecutionContext executionContext = createExecutionContext(listFleetsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ListFleetsRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(listFleetsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "ListFleets");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(new JsonOperationMetadata()
.withPayloadJson(true).withHasStreamingSuccessResponse(false), new ListFleetsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Lists a game server groups.
*
*
* @param listGameServerGroupsRequest
* @return Result of the ListGameServerGroups operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.ListGameServerGroups
* @see AWS
* API Documentation
*/
@Override
public ListGameServerGroupsResult listGameServerGroups(ListGameServerGroupsRequest request) {
request = beforeClientExecution(request);
return executeListGameServerGroups(request);
}
@SdkInternalApi
final ListGameServerGroupsResult executeListGameServerGroups(ListGameServerGroupsRequest listGameServerGroupsRequest) {
ExecutionContext executionContext = createExecutionContext(listGameServerGroupsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ListGameServerGroupsRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(listGameServerGroupsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "ListGameServerGroups");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new ListGameServerGroupsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation is used with the Amazon GameLift FleetIQ solution and game server groups.
*
*
* Retrieves information on all game servers that are currently active in a specified game server group. You can opt
* to sort the list by game server age. Use the pagination parameters to retrieve results in a set of sequential
* segments.
*
*
* Learn more
*
*
* Amazon GameLift FleetIQ
* Guide
*
*
* @param listGameServersRequest
* @return Result of the ListGameServers operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.ListGameServers
* @see AWS API
* Documentation
*/
@Override
public ListGameServersResult listGameServers(ListGameServersRequest request) {
request = beforeClientExecution(request);
return executeListGameServers(request);
}
@SdkInternalApi
final ListGameServersResult executeListGameServers(ListGameServersRequest listGameServersRequest) {
ExecutionContext executionContext = createExecutionContext(listGameServersRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ListGameServersRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(listGameServersRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "ListGameServers");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new ListGameServersResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Lists all custom and Amazon Web Services locations.
*
*
* @param listLocationsRequest
* @return Result of the ListLocations operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.ListLocations
* @see AWS API
* Documentation
*/
@Override
public ListLocationsResult listLocations(ListLocationsRequest request) {
request = beforeClientExecution(request);
return executeListLocations(request);
}
@SdkInternalApi
final ListLocationsResult executeListLocations(ListLocationsRequest listLocationsRequest) {
ExecutionContext executionContext = createExecutionContext(listLocationsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ListLocationsRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(listLocationsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "ListLocations");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new ListLocationsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves script records for all Realtime scripts that are associated with the Amazon Web Services account in
* use.
*
*
* Learn more
*
*
* Amazon GameLift Realtime
* Servers
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param listScriptsRequest
* @return Result of the ListScripts operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.ListScripts
* @see AWS API
* Documentation
*/
@Override
public ListScriptsResult listScripts(ListScriptsRequest request) {
request = beforeClientExecution(request);
return executeListScripts(request);
}
@SdkInternalApi
final ListScriptsResult executeListScripts(ListScriptsRequest listScriptsRequest) {
ExecutionContext executionContext = createExecutionContext(listScriptsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ListScriptsRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(listScriptsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "ListScripts");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new ListScriptsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves all tags assigned to a Amazon GameLift resource. Use resource tags to organize Amazon Web Services
* resources for a range of purposes. This operation handles the permissions necessary to manage tags for Amazon
* GameLift resources that support tagging.
*
*
* To list tags for a resource, specify the unique ARN value for the resource.
*
*
* Learn more
*
*
* Tagging Amazon Web Services
* Resources in the Amazon Web Services General Reference
*
*
* Amazon Web Services Tagging
* Strategies
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param listTagsForResourceRequest
* @return Result of the ListTagsForResource operation returned by the service.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws TaggingFailedException
* The requested tagging operation did not succeed. This may be due to invalid tag format or the maximum tag
* limit may have been exceeded. Resolve the issue before retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.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 request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ListTagsForResourceRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(listTagsForResourceRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "ListTagsForResource");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new ListTagsForResourceResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Creates or updates a scaling policy for a fleet. Scaling policies are used to automatically scale a fleet's
* hosting capacity to meet player demand. An active scaling policy instructs Amazon GameLift to track a fleet
* metric and automatically change the fleet's capacity when a certain threshold is reached. There are two types of
* scaling policies: target-based and rule-based. Use a target-based policy to quickly and efficiently manage fleet
* scaling; this option is the most commonly used. Use rule-based policies when you need to exert fine-grained
* control over auto-scaling.
*
*
* Fleets can have multiple scaling policies of each type in force at the same time; you can have one target-based
* policy, one or multiple rule-based scaling policies, or both. We recommend caution, however, because multiple
* auto-scaling policies can have unintended consequences.
*
*
* Learn more about how to work with auto-scaling in Set Up Fleet Automatic
* Scaling.
*
*
* Target-based policy
*
*
* A target-based policy tracks a single metric: PercentAvailableGameSessions. This metric tells us how much of a
* fleet's hosting capacity is ready to host game sessions but is not currently in use. This is the fleet's buffer;
* it measures the additional player demand that the fleet could handle at current capacity. With a target-based
* policy, you set your ideal buffer size and leave it to Amazon GameLift to take whatever action is needed to
* maintain that target.
*
*
* For example, you might choose to maintain a 10% buffer for a fleet that has the capacity to host 100 simultaneous
* game sessions. This policy tells Amazon GameLift to take action whenever the fleet's available capacity falls
* below or rises above 10 game sessions. Amazon GameLift will start new instances or stop unused instances in order
* to return to the 10% buffer.
*
*
* To create or update a target-based policy, specify a fleet ID and name, and set the policy type to "TargetBased".
* Specify the metric to track (PercentAvailableGameSessions) and reference a TargetConfiguration
* object with your desired buffer value. Exclude all other parameters. On a successful request, the policy name is
* returned. The scaling policy is automatically in force as soon as it's successfully created. If the fleet's
* auto-scaling actions are temporarily suspended, the new policy will be in force once the fleet actions are
* restarted.
*
*
* Rule-based policy
*
*
* A rule-based policy tracks specified fleet metric, sets a threshold value, and specifies the type of action to
* initiate when triggered. With a rule-based policy, you can select from several available fleet metrics. Each
* policy specifies whether to scale up or scale down (and by how much), so you need one policy for each type of
* action.
*
*
* For example, a policy may make the following statement:
* "If the percentage of idle instances is greater than 20% for more than 15 minutes, then reduce the fleet capacity by 10%."
*
*
* A policy's rule statement has the following structure:
*
*
* If [MetricName] is [ComparisonOperator] [Threshold] for
* [EvaluationPeriods] minutes, then [ScalingAdjustmentType] to/by
* [ScalingAdjustment].
*
*
* To implement the example, the rule statement would look like this:
*
*
* If [PercentIdleInstances] is [GreaterThanThreshold] [20] for
* [15] minutes, then [PercentChangeInCapacity] to/by [10].
*
*
* To create or update a scaling policy, specify a unique combination of name and fleet ID, and set the policy type
* to "RuleBased". Specify the parameter values for a policy rule statement. On a successful request, the policy
* name is returned. Scaling policies are automatically in force as soon as they're successfully created. If the
* fleet's auto-scaling actions are temporarily suspended, the new policy will be in force once the fleet actions
* are restarted.
*
*
* @param putScalingPolicyRequest
* @return Result of the PutScalingPolicy operation returned by the service.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @sample AmazonGameLift.PutScalingPolicy
* @see AWS API
* Documentation
*/
@Override
public PutScalingPolicyResult putScalingPolicy(PutScalingPolicyRequest request) {
request = beforeClientExecution(request);
return executePutScalingPolicy(request);
}
@SdkInternalApi
final PutScalingPolicyResult executePutScalingPolicy(PutScalingPolicyRequest putScalingPolicyRequest) {
ExecutionContext executionContext = createExecutionContext(putScalingPolicyRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new PutScalingPolicyRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(putScalingPolicyRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "PutScalingPolicy");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new PutScalingPolicyResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation has been expanded to use with the Amazon GameLift containers feature, which is currently in
* public preview.
*
*
* Registers a compute resource in an Amazon GameLift fleet. Register computes with an Amazon GameLift Anywhere
* fleet or a container fleet.
*
*
* For an Anywhere fleet or a container fleet that's running the Amazon GameLift Agent, the Agent handles all
* compute registry tasks for you. For an Anywhere fleet that doesn't use the Agent, call this operation to register
* fleet computes.
*
*
* To register a compute, give the compute a name (must be unique within the fleet) and specify the compute
* resource's DNS name or IP address. Provide a fleet ID and a fleet location to associate with the compute being
* registered. You can optionally include the path to a TLS certificate on the compute resource.
*
*
* If successful, this operation returns compute details, including an Amazon GameLift SDK endpoint or Agent
* endpoint. Game server processes running on the compute can use this endpoint to communicate with the Amazon
* GameLift service. Each server process includes the SDK endpoint in its call to the Amazon GameLift server SDK
* action InitSDK().
*
*
* To view compute details, call DescribeCompute with
* the compute name.
*
*
* Learn more
*
*
* -
*
*
* -
*
*
* -
*
* Server SDK
* reference guides (for version 5.x)
*
*
*
*
* @param registerComputeRequest
* @return Result of the RegisterCompute operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws ConflictException
* The requested operation would cause a conflict with the current state of a service resource associated
* with the request. Resolve the conflict before retrying this request.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @throws NotReadyException
* The operation failed because Amazon GameLift has not yet finished validating this compute. We recommend
* attempting 8 to 10 retries over 3 to 5 minutes with exponential backoffs and jitter.
* @throws LimitExceededException
* The requested operation would cause the resource to exceed the allowed service limit. Resolve the issue
* before retrying.
* @sample AmazonGameLift.RegisterCompute
* @see AWS API
* Documentation
*/
@Override
public RegisterComputeResult registerCompute(RegisterComputeRequest request) {
request = beforeClientExecution(request);
return executeRegisterCompute(request);
}
@SdkInternalApi
final RegisterComputeResult executeRegisterCompute(RegisterComputeRequest registerComputeRequest) {
ExecutionContext executionContext = createExecutionContext(registerComputeRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new RegisterComputeRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(registerComputeRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "RegisterCompute");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new RegisterComputeResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* This operation is used with the Amazon GameLift FleetIQ solution and game server groups.
*
*
* Creates a new game server resource and notifies Amazon GameLift FleetIQ that the game server is ready to host
* gameplay and players. This operation is called by a game server process that is running on an instance in a game
* server group. Registering game servers enables Amazon GameLift FleetIQ to track available game servers and
* enables game clients and services to claim a game server for a new game session.
*
*
* To register a game server, identify the game server group and instance where the game server is running, and
* provide a unique identifier for the game server. You can also include connection and game server data.
*
*
* Once a game server is successfully registered, it is put in status AVAILABLE. A request to register
* a game server may fail if the instance it is running on is in the process of shutting down as part of instance
* balancing or scale-down activity.
*
*
* Learn more
*
*
* Amazon GameLift FleetIQ
* Guide
*
*
* @param registerGameServerRequest
* @return Result of the RegisterGameServer operation returned by the service.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws ConflictException
* The requested operation would cause a conflict with the current state of a service resource associated
* with the request. Resolve the conflict before retrying this request.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws LimitExceededException
* The requested operation would cause the resource to exceed the allowed service limit. Resolve the issue
* before retrying.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.RegisterGameServer
* @see AWS
* API Documentation
*/
@Override
public RegisterGameServerResult registerGameServer(RegisterGameServerRequest request) {
request = beforeClientExecution(request);
return executeRegisterGameServer(request);
}
@SdkInternalApi
final RegisterGameServerResult executeRegisterGameServer(RegisterGameServerRequest registerGameServerRequest) {
ExecutionContext executionContext = createExecutionContext(registerGameServerRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new RegisterGameServerRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(registerGameServerRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "RegisterGameServer");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new RegisterGameServerResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Retrieves a fresh set of credentials for use when uploading a new set of game build files to Amazon GameLift's
* Amazon S3. This is done as part of the build creation process; see CreateBuild.
*
*
* To request new credentials, specify the build ID as returned with an initial CreateBuild request. If
* successful, a new set of credentials are returned, along with the S3 storage location associated with the build
* ID.
*
*
* Learn more
*
*
* Create a Build with Files in S3
*
*
* All APIs by task
*
*
* @param requestUploadCredentialsRequest
* @return Result of the RequestUploadCredentials operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.RequestUploadCredentials
* @see AWS API Documentation
*/
@Override
public RequestUploadCredentialsResult requestUploadCredentials(RequestUploadCredentialsRequest request) {
request = beforeClientExecution(request);
return executeRequestUploadCredentials(request);
}
@SdkInternalApi
final RequestUploadCredentialsResult executeRequestUploadCredentials(RequestUploadCredentialsRequest requestUploadCredentialsRequest) {
ExecutionContext executionContext = createExecutionContext(requestUploadCredentialsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new RequestUploadCredentialsRequestProtocolMarshaller(protocolFactory).marshall(super
.beforeMarshalling(requestUploadCredentialsRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "RequestUploadCredentials");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false),
new RequestUploadCredentialsResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*
* Attempts to retrieve a fleet ID that is associated with an alias. Specify a unique alias identifier.
*
*
* If the alias has a SIMPLE routing strategy, Amazon GameLift returns a fleet ID. If the alias has a
* TERMINAL routing strategy, the result is a TerminalRoutingStrategyException.
*
*
* Related actions
*
*
* All APIs by task
*
*
* @param resolveAliasRequest
* @return Result of the ResolveAlias operation returned by the service.
* @throws UnauthorizedException
* The client failed authentication. Clients should not retry such requests.
* @throws InvalidRequestException
* One or more parameter values in the request are invalid. Correct the invalid parameter values before
* retrying.
* @throws NotFoundException
* THe requested resources was not found. The resource was either not created yet or deleted.
* @throws TerminalRoutingStrategyException
* The service is unable to resolve the routing for a particular alias because it has a terminal
* RoutingStrategy associated with it. The message returned in this exception is the message
* defined in the routing strategy itself. Such requests should only be retried if the routing strategy for
* the specified alias is modified.
* @throws InternalServiceException
* The service encountered an unrecoverable internal failure while processing the request. Clients can retry
* such requests immediately or after a waiting period.
* @sample AmazonGameLift.ResolveAlias
* @see AWS API
* Documentation
*/
@Override
public ResolveAliasResult resolveAlias(ResolveAliasRequest request) {
request = beforeClientExecution(request);
return executeResolveAlias(request);
}
@SdkInternalApi
final ResolveAliasResult executeResolveAlias(ResolveAliasRequest resolveAliasRequest) {
ExecutionContext executionContext = createExecutionContext(resolveAliasRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ResolveAliasRequestProtocolMarshaller(protocolFactory).marshall(super.beforeMarshalling(resolveAliasRequest));
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
request.addHandlerContext(HandlerContextKey.CLIENT_ENDPOINT, endpoint);
request.addHandlerContext(HandlerContextKey.ENDPOINT_OVERRIDDEN, isEndpointOverridden());
request.addHandlerContext(HandlerContextKey.SIGNING_REGION, getSigningRegion());
request.addHandlerContext(HandlerContextKey.SERVICE_ID, "GameLift");
request.addHandlerContext(HandlerContextKey.OPERATION_NAME, "ResolveAlias");
request.addHandlerContext(HandlerContextKey.ADVANCED_CONFIG, advancedConfig);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
HttpResponseHandler> responseHandler = protocolFactory.createResponseHandler(
new JsonOperationMetadata().withPayloadJson(true).withHasStreamingSuccessResponse(false), new ResolveAliasResultJsonUnmarshaller());
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response);
}
}
/**
*