のサービス API Amazon GameLift Servers - Amazon GameLift Servers
Amazon GameLift Servers ホスティングリソースを管理するゲームセッションをスタートし、プレイヤーを参加させる

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

のサービス API Amazon GameLift Servers

このタスクベースのリストを使用して、Amazon GameLift Serversゲームホスティングソリューションやその他の機能を構築するときに API オペレーションを検索します。 AWS SDK には、これらのオペレーションがaws.gamelift名前空間に含まれます。AWS SDK をダウンロードするか、Amazon GameLift ServersAPI リファレンスドキュメントを参照してください。AWS CLI コマンドリファレンスに記載されているように、 AWS コマンドラインインターフェイス (AWS CLI) で API を使用することもできます。

API には、マネージド ゲーム ホスティング用の 2 つのオペレーションセットが含まれています。

Amazon GameLift Servers Service API には、他のAmazon GameLift Serversツールやソリューションで使用するオペレーションも含まれています。FleetIQ APIsFleetIQ「 API オペレーション」を参照してください。マッチメーキング用の FlexMatch APIsFlexMatch「 API オペレーション」を参照してください。

Amazon GameLift Servers ホスティングリソースを管理する

これらのオペレーションを呼び出すことで、ゲームサーバーのホスティングリソースを設定したり、プレイヤーの需要に合わせた容量をスケールしたり、パフォーマンスと使用状況のメトリクスを取得したりすることができます。を含む でゲームサーバーをホストする場合はAmazon GameLift Servers、これらの API オペレーションを使用しますAmazon GameLift ServersRealtime。ほとんどのリソース管理タスクでAmazon GameLift Serversコンソールで作業したり、 AWS Command Line Interface （AWS CLI) ツールで呼び出しを行ったりすることもできます。

デプロイ用のゲームサーバーを準備する

ホスティングリソースでのデプロイと起動の準備として、ゲームのゲームサーバーコードをアップロードして構成します。

カスタムゲームサーバービルドの管理

  • upload-build – ローカルパスからビルドファイルをアップロードし、新しいAmazon GameLift Serversビルドリソースを作成します。 AWS CLI コマンドとして利用できるこのオペレーションは、ゲームサーバービルドをアップロードする最も一般的な方法です。

  • [CreateBuild](Create構築) - Amazon S3 バケットに保存されているファイルを使用して新しい構築を作成します。

  • ListBuilds – Amazon GameLift Serversリージョンにアップロードされたすべてのビルドのリストを取得します。

  • [DescribeBuild](Describe構築) - 構築に関連付けられた情報を取得します。

  • [UpdateBuild] ](Update構築)- 構築名とバージョンを含む構築メタデータを変更します。

  • DeleteBuild – からビルドを削除しますAmazon GameLift Servers。

Amazon GameLift ServersRealtime設定スクリプトを管理する

  • CreateScript – JavaScript ファイルをアップロードし、新しいAmazon GameLift Serversスクリプトリソースを作成します。

  • ListScripts – Amazon GameLift ServersリージョンにアップロードされたすべてのRealtimeスクリプトのリストを取得します。

  • DescribeScript – Realtimeスクリプトに関連付けられた情報を取得します。

  • [UpdateScript]（更新スクリプト）（ - スクリプトメタデータを変更し、変更されたスクリプトコンテンツをアップロードします。

  • DeleteScript – からRealtimeスクリプトを削除しますAmazon GameLift Servers。

ホスティング用のコンピューティング リソースを設定する

ホスティングリソースを設定し、ゲームサーバーのビルドまたはRealtime設定スクリプトを使用してデプロイします。

[Create and manage fleets]（フリートの作成と管理）

[フリートの容量を管理する

  • DescribeEC2InstanceLimits – 現在の AWS アカウントと現在の使用レベルで許可されるインスタンスの最大数を取得します。

  • [DescribeFleetCapacity]（作成フリート容量）- フリートのホーム リージョンの現在の容量設定を取得します。

  • [DescribeFleetLocationCapacity]（作成フリートロケーション容量）— マルチロケーション フリートの各ロケーションの現在の容量設定を取得します。

  • [UpdateFleetCapacity]（更新フリート容量）- フリートの容量設定を手動で調整します。

  • を設定します。

    • [PutScalingPolicy]（プットスケーリングポリシー）- ターゲットベースの Auto Scaling を有効にするか、カスタム Auto Scaling ポリシーを作成します。または、既存のポリシーを更新します。

    • [DescribeScalingPolicies]（作成スケーリングポリシー） - 既存の Auto Scaling ポリシーを取得します。

    • [DeleteScalingPolicy（削除スケーリングポリシー） - Auto Scaling ポリシーを削除し、フリートの容量に影響しないようにします。

    • [StartFleetActions]（スタートフリートアクション） - フリートのAuto Scaling ポリシーを再起動します。

    • [StopFleetActions （停止フリートアクション）- フリートの Auto Scaling ポリシーを停止します。

フリートのアクティビティをモニタリングします。

  • [DescribeFleetUtilization] （作成フリート活用法）- フリートで現在アクティブなサーバープロセス、ゲームセッション、プレイヤーの数の統計を取得します。

  • [DescribeFleetLocationUtilization] （作成フリートロケーション活用法）— マルチロケーション フリート内の各ロケーションの使用率統計を取得します。

  • [DescribeFleetEvents] （作成フリートイベント）- 指定した期間中のフリートの記録されたイベントを表示します。

  • [DescribeGameSessions] （作成ゲームセッション）- ゲームの実行時間や現在のプレイヤー数など、ゲームセッションのメタデータを取得します。

ゲームセッションの配置用キューを設定する

コスト、レイテンシー、回復性の点から最適なホスティングリソースにゲームセッションが配置されるようにマルチフリート、マルチリージョンキューを設定します。

  • [CreateGameSessionQueue] （作成ゲームセッションキュー）- ゲームセッション配置のリクエストを処理するときに使用するキューを作成します。

  • DescribeGameSessionQueues – Amazon GameLift Serversリージョンで定義されたゲームセッションキューを取得します。

  • [UpdateGameSessionQueue] （更新ゲームセッションキュー）— ゲーム セッション キューの設定を変更します。

  • [DeleteGameSessionQueue] （削除ゲームセッションキュー）- リージョン からゲーム セッションキューを削除します。

エイリアスの管理

エイリアスを使用してフリートを表すか、代わりのターミナル送信先を作成します。エイリアスは、ゲームサーバービルドの更新中など、フリート間でゲームアクティビティを移行するときに役立ちます。

  • [CreateAlias]（作成エイリアス） - 新しいエイリアスを定義し、必要に応じてフリートに割り当てます。

  • ListAliases – Amazon GameLift Serversリージョンで定義されたすべてのフリートエイリアスを取得します。

  • [DescribeAlias]（説明エイリアス） - 既存のエイリアスに関する情報を取得します。

  • [UpdateAlias] （更新エイリアス）- エイリアスの設定 (フリートから別のフリートへのリダイレクトなど) を変更します。

  • [DeleteAlias]（削除エイリアス）- リージョン からエイリアスを削除します。

  • [ResolveAlias]（決定エイリアス）- 指定されたエイリアスが指すフリート ID を取得します。

マネージドホスティングインスタンスに接続する

フリートの個々のインスタンスに関する情報を表示したり、トラブルシューティングのために指定したフリートインスタンスへのリモートアクセスをリクエストしたりします。

  • [DescribeInstances]（説明インスタンス）- ID、IP アドレス、ロケーション、ステータスなど、フリート内の各インスタンスに関する情報を取得します。

  • [GetInstanceAccess]（ゲットインスタンスアクセス）- フリート内の指定されたインスタンスにリモートConnectするために必要なアクセス認証情報をリクエストします。

VPC ピアリング接続のセットアップ

Amazon GameLift Servers ホスティングリソースと他のリソース間の VPC ピアリング接続を作成および管理します AWS 。

ゲームセッションをスタートし、プレイヤーを参加させる

これらのオペレーションをバックエンドサービスから呼び出して、新しいゲームセッションを開始し、既存のゲームセッションに関する情報を取得し、ゲームセッションにプレイヤーを参加させます。これらのオペレーションは、 でホストされているカスタムゲームサーバーで使用するためのものですAmazon GameLift Servers。を使用している場合はAmazon GameLift ServersRealtime、 を使用してゲームセッションを管理しますAmazon GameLift ServersRealtime クライアント API (C#) リファレンス。

  • 1 人以上のプレイヤーの新しいゲームセッションを開始します。

    • StartGameSessionPlacement – 利用可能な最適なホスティングリソースを見つけて、新しいゲームセッションを開始するAmazon GameLift Serversように依頼します。これは、推奨する新しいゲームセッションの作成方法です。ゲームセッションキューに依存して、複数のリージョンにわたるホスティングの可用性を追跡し、FleetIQアルゴリズムを使用して、プレイヤーのレイテンシー、ホスティングコスト、場所などに基づいて配置を優先します。

    • [DescribeGameSessionPlacement]（スタートゲームセッションプレイスメント） - 配置リクエストの詳細とステータスを取得します。

    • [StopGameSessionPlacement] （停止ゲームセッションプレイスメント）- 配置リクエストをキャンセルします。

    • [CreateGameSession] - （ゲームセッションの作成）特定のフリートロケーションで新しい空のゲームセッションをスタートします。このオペレーションにより、 FleetIQを使用して配置オプションを評価する代わりに、ゲームセッションを開始する場所をより細かく制御できます。別のステップで新しいゲームセッションにプレイヤーを追加する必要があります。

  • [プレイヤーを既存のゲームに参加させます。] 使用可能なプレイヤースロットがある実行中のゲームセッションを検索し、新しいプレイヤー用に予約します。

    • [CreatePlayerSession]（プレイヤーセッションの作成）- プレイヤーがゲームセッションに参加できるように空きスロットを予約します。

    • [CreatePlayerSessions] （プレイヤーセッションの作成）- 複数のプレイヤーがゲームセッションに参加できるように空きスロットを予約します。

  • ゲームセッションとプレイヤーセッションデータを操作します。ゲームセッションとプレイヤーセッションの情報を管理できます。

    • [SearchGameSessions] （ゲームセッションの探求）— 一連の検索条件に基づいて、アクティブなゲームセッションのリストを要求します。

    • [[DescribeGameSessions]（ゲームセッションの説明）- アクティブ時間の長さや現在のプレイヤー数など、ゲームセッションのメタデータを取得します。

    • [DescribeGameSessionDetails] （ゲームセッション詳細の説明）- 1 つ以上のゲームセッションのゲームセッション保護設定を含むメタデータを取得します。

    • [DescribePlayerSessions] （プレイヤーセッションの説明）- ステータス、プレイ時間、プレイヤーデータなど、プレイヤーアクティビティの詳細を取得します。

    • [UpdateGameSession] （ゲームセッションの更新）- 最大プレイヤー数や参加ポリシーなどのゲームセッション設定を変更します。

    • [GetGameSessionLogUrl] （ゲームセッションログURLの取得）- ゲームセッションのログが保存された場所を取得します。