View a markdown version of this page

API de serviço para GameLift Servidores Amazon - GameLift Servidores Amazon
Gerencie GameLift Servidores Amazon recursos de hospedagemInicie sessões de jogo e junte-se aos jogadores

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

API de serviço para GameLift Servidores Amazon

Use essa lista baseada em tarefas para encontrar operações de API ao compilar as soluções de hospedagem de jogos do Amazon GameLift Servers e de outros recursos. O AWS SDK inclui essas operações no aws.gamelift namespace. Baixe o AWS SDK ou veja a documentação de referência Amazon GameLift Servers da API. Você também pode usar a API com a interface de linha de AWS comando (AWS CLI), conforme documentado na referência de AWS CLI comando.

A API inclui dois conjuntos de operações para hospedagem gerenciada de jogos:

A API do serviço Amazon GameLift Servers também contém operações para uso com outras ferramentas e soluções do Amazon GameLift Servers. Para uma lista de FleetIQ APIs, consulte Operações de FleetIQ API. Para obter uma lista de APIs do FlexMatch para criação de partidas, consulte Operações de API do FlexMatch.

Gerencie GameLift Servidores Amazon recursos de hospedagem

Chame essas operações para configurar recursos de hospedagem para os servidores de jogos, escalar a capacidade para atender à demanda dos jogadores, obter métricas de desempenho e utilização e muito mais. Use essas operações de API ao hospedar servidores de jogo com o Amazon GameLift Servers, incluindo os Amazon GameLift Servers Realtime. Também é possível trabalhar no Console do Amazon GameLift Servers para a maioria das tarefas de gerenciamento de recursos ou fazer chamadas com a ferramenta da AWS Command Line Interface (AWS CLI).

Preparare servidores de jogos para implantação

Carregue e configure o código do servidor de jogos do jogo em preparação para implantação e lançamento em recursos de hospedagem.

Gerenciar compilações do servidor de jogos personalizado

  • upload-build: carregue arquivos de compilação em um caminho local e crie um novo recurso de compilação do Amazon GameLift Servers. Essa operação, disponível como um AWS CLI comando, é a forma mais comum de fazer upload de compilações de servidores de jogos.

  • CreateBuild— Crie uma nova compilação usando arquivos armazenados em um bucket do Amazon S3.

  • ListBuilds— Obtenha uma lista de todas as construções enviadas para uma Amazon GameLift Servers região.

  • DescribeBuild— Recupere informações associadas a uma compilação.

  • UpdateBuild— Altere os metadados da compilação, incluindo nome e versão da compilação.

  • DeleteBuild— Remover uma compilação doAmazon GameLift Servers.

Gerenciar scripts de configuração do Amazon GameLift Servers Realtime

  • CreateScript— Faça upload de JavaScript arquivos e crie um novo recurso de Amazon GameLift Servers script.

  • ListScripts— Obtenha uma lista de todos os Realtime scripts enviados para uma Amazon GameLift Servers região.

  • DescribeScript— Recupere informações associadas a um Realtime script.

  • UpdateScript— Altere os metadados do script e faça o upload do conteúdo revisado do script.

  • DeleteScript— Remover um Realtime script doAmazon GameLift Servers.

Configurar recursos de computação para hospedagem

Configure recursos de hospedagem e implante-os com seu script de configuração do Realtime ou compilação do servidor de jogos.

Criar e gerenciar frotas

  • CreateFleet— Configure e implante uma nova Amazon GameLift Servers frota de recursos de computação para executar seus servidores de jogos. Depois de implantados, os servidores de jogos são automaticamente lançados conforme configurados e prontos para hospedar sessões de jogo.

  • ListFleets— Obtenha uma lista de todas as frotas em uma Amazon GameLift Servers região.

  • DeleteFleet— Remova uma frota que não está mais executando servidores de jogos ou hospedando jogadores.

  • Visualize/atualize as localizações da frota.

  • Visualize/atualize as configurações de frota.

Gerenciar capacidade da frota

  • DescribeEC2InstanceLimits— Recupere o número máximo de instâncias permitidas para a AWS conta atual e o nível de uso atual.

  • DescribeFleetCapacity— Recupere as configurações de capacidade atuais para a região de origem de uma frota.

  • DescribeFleetLocationCapacity— Recupere as configurações de capacidade atuais para cada local em uma frota com vários locais.

  • UpdateFleetCapacity— Ajuste manualmente as configurações de capacidade de uma frota.

  • Configurar:

    • PutScalingPolicy— ative o escalonamento automático baseado em metas, crie uma política personalizada de escalabilidade automática ou atualize uma política existente.

    • DescribeScalingPolicies— Recupere uma política de escalabilidade automática existente.

    • DeleteScalingPolicy— Exclua uma política de escalabilidade automática e impeça que ela afete a capacidade de uma frota.

    • StartFleetActions— Reinicie as políticas de escalabilidade automática de uma frota.

    • StopFleetActions— Suspenda as políticas de escalabilidade automática de uma frota.

Monitore a atividade da frota.

  • DescribeFleetUtilization— Recupere estatísticas sobre o número de processos do servidor, sessões de jogo e jogadores que estão atualmente ativos em uma frota.

  • DescribeFleetLocationUtilization— Recupere estatísticas de utilização de cada local em uma frota com vários locais.

  • DescribeFleetEvents— Visualize os eventos registrados de uma frota durante um período de tempo especificado.

  • DescribeGameSessions— Recupere os metadados da sessão do jogo, incluindo o tempo de execução do jogo e a contagem atual de jogadores.

Configurar filas para o posicionamento de sessões de jogo

Configure as filas de várias frotas e várias regiões para posicionar sessões de jogo com os melhores recursos de hospedagem disponíveis para custo, latência e resiliência.

Gerenciar aliases

Use aliases para representar suas frotas ou crie um destino alternativo de terminal. Os aliases são úteis ao fazer a transição da atividade do jogo de uma frota para outra, como durante as atualizações de compilação do servidor de jogos.

  • CreateAlias— Defina um novo alias e, opcionalmente, atribua-o a uma frota.

  • ListAliases— Defina todos os aliases da frota em uma Amazon GameLift Servers região.

  • DescribeAlias— Recupere informações sobre um alias existente.

  • UpdateAlias— Altere as configurações de um alias, como redirecioná-lo de uma frota para outra.

  • DeleteAlias— Remova um alias da região.

  • ResolveAlias— Obtenha o ID da frota para o qual um alias especificado aponta.

Conectar-se às instâncias de hospedagem gerenciada

Visualize informações sobre instâncias individuais em uma frota ou solicite acesso remoto a uma instância de frota especificada para solução de problemas.

  • DescribeInstances— obtenha informações sobre cada instância em uma frota, incluindo ID da instância, endereço IP, localização e status.

  • GetInstanceAccess— solicite as credenciais de acesso necessárias para se conectar remotamente a uma instância específica em uma frota.

Configurar o emparelhamento da VPC

Crie e gerencie conexões de emparelhamento de VPC entre seus recursos de Amazon GameLift Servers hospedagem e outros AWS recursos.

Inicie sessões de jogo e junte-se aos jogadores

Chame essas operações por meio de um serviço de backend para iniciar novas sessões de jogo, obter informações sobre sessões de jogo existentes e adicionar jogadores às sessões de jogo. Essas operações são destinadas para uso com servidores de jogos personalizados hospedados no Amazon GameLift Servers. Se você estiver usando Amazon GameLift Servers Realtime, gerencie sessões de jogo usando a API do cliente Amazon GameLift Servers Realtime (C#).

  • Inicie novas sessões de jogo para um ou mais jogadores.

    • StartGameSessionPlacement— Peça Amazon GameLift Servers para encontrar os melhores recursos de hospedagem disponíveis e inicie uma nova sessão de jogo. Esse é o método preferido para criar novas sessões de jogo. Ele se baseia em filas de sessões de jogo para rastrear a disponibilidade de hospedagem em várias regiões e usa algoritmos FleetIQ para priorizar colocações com base na latência do jogador, custo de hospedagem, localização etc.

    • DescribeGameSessionPlacement— Obtenha detalhes e status em uma solicitação de colocação.

    • StopGameSessionPlacement— Cancele uma solicitação de colocação.

    • CreateGameSession— Inicie uma nova sessão de jogo vazia em um local específico da frota. Essa operação oferece maior controle sobre onde iniciar a sessão do jogo, em vez de usar o FleetIQ para avaliar as opções de colocação. Você deve adicionar jogadores à nova sessão de jogo em uma etapa separada.

  • Coloque jogadores em sessões de jogo existentes. Encontre sessões de jogo em execução com slots de jogadores disponíveis e reserve-os para novos jogadores.

    • CreatePlayerSession— Reserve um espaço aberto para um jogador participar de uma sessão de jogo.

    • CreatePlayerSessions— Reserve vagas abertas para vários jogadores participarem de uma sessão de jogo.

  • Trabalhe com os dados da sessão de jogo e da sessão de jogadores. Gerencie informações sobre sessões de jogo e sessões de jogadores.

    • SearchGameSessions— Solicite uma lista de sessões de jogo ativas com base em um conjunto de critérios de pesquisa.

    • DescribeGameSessions— Recupere metadados para sessões de jogo específicas, incluindo o tempo de atividade e a contagem atual de jogadores.

    • DescribeGameSessionDetails— Recupere metadados, incluindo a configuração de proteção da sessão do jogo, para uma ou mais sessões de jogo.

    • DescribePlayerSessions— Obtenha detalhes sobre a atividade do jogador, incluindo status, tempo de jogo e dados do jogador.

    • UpdateGameSession— Altere as configurações da sessão do jogo, como a contagem máxima de jogadores e a política de participação.

    • GetGameSessionLogUrl— Obtenha a localização dos registros salvos para uma sessão de jogo.