Skip to content
AWS for Query.Farm

aws.gamelift.describe_compute

Example SQL Queries

SELECT * FROM
aws.gamelift.describe_compute
WHERE
"fleet_id" = 'VALUE'
AND "compute_name" = 'VALUE';

Description

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.

Table Definition

Column NameColumn Data Type
compute_name Required Input Column

The unique identifier of the compute resource to retrieve properties for. For an Anywhere fleet compute, use the registered compute name. For an EC2 fleet instance, use the instance ID. For a container fleet, use the compute name (for example, a123b456c789012d3e4567f8a901b23c/1a234b56-7cd8-9e0f-a1b2-c34d567ef8a9) or the compute ARN.

VARCHAR
fleet_id Required Input Column

A unique identifier for the fleet that the compute belongs to. You can use either the fleet ID or ARN value.

VARCHAR
_aws_profile Input Column

The AWS profile defines the AWS identity used. It can be defined via credentials or by assuming a IAM role.

STRUCT(
    "type" VARCHAR,
    "name" VARCHAR,
    "account_id" VARCHAR,
    "via_profile_name" VARCHAR,
    "assumed_role_arn" VARCHAR,
    "organization" STRUCT(
        "account_name" VARCHAR,
        "id" VARCHAR,
        "tags" STRUCT(
            "key" VARCHAR,
            "value" VARCHAR
        )[],
        "master_account" STRUCT(
            "id" VARCHAR,
            "email" VARCHAR
        ),
        "parents" STRUCT(
            "type" VARCHAR,
            "id" VARCHAR,
            "name" VARCHAR,
            "tags" STRUCT(
                "key" VARCHAR,
                "value" VARCHAR
            )[]
        )[]
    )
)
Show child fields
_aws_profile.account_id

The AWS account id

_aws_profile.assumed_role_arn

The ARN of the assumed role

_aws_profile.name

The unique name of the profile.

_aws_profile.organization

Information about this profile's membership in the AWS organization.

Show child fields
_aws_profile.organization.account_name

The name of account speciifed by the organization

_aws_profile.organization.id

The organization id

_aws_profile.organization.master_account
Show child fields
_aws_profile.organization.master_account.email

The organization master account email address

_aws_profile.organization.master_account.id

The organization master account id

_aws_profile.organization.parents[]
Show child fields
_aws_profile.organization.parents[].id

The id of the parent

_aws_profile.organization.parents[].name

The name of the parent

_aws_profile.organization.parents[].tags[]
Show child fields
_aws_profile.organization.parents[].tags[].key
_aws_profile.organization.parents[].tags[].value
_aws_profile.organization.parents[].type

The type of parent can be an organization unit or a root

_aws_profile.organization.tags[]
Show child fields
_aws_profile.organization.tags[].key
_aws_profile.organization.tags[].value
_aws_profile.type

The type of profile, either 'credentials' or 'assumed_role'

_aws_profile.via_profile_name

This IAM role for this profile is assumed by first utilizing another profile with this name to obtain credentials.

_aws_region Input Column

The AWS region to use.

VARCHAR
compute

The set of properties for the requested compute resource.

STRUCT(
    "fleet_id" VARCHAR,
    "fleet_arn" VARCHAR,
    "compute_name" VARCHAR,
    "compute_arn" VARCHAR,
    "ip_address" VARCHAR,
    "dns_name" VARCHAR,
    "compute_status" VARCHAR,
    "location" VARCHAR,
    "creation_time" TIMESTAMP_S,
    "operating_system" VARCHAR,
    "type" VARCHAR,
    "game_lift_service_sdk_endpoint" VARCHAR,
    "game_lift_agent_endpoint" VARCHAR,
    "instance_id" VARCHAR,
    "container_attributes" STRUCT(
        "container_port_mappings" STRUCT(
            "container_port" BIGINT,
            "connection_port" BIGINT,
            "protocol" VARCHAR
        )[]
    )
)
Show child fields
compute.compute_arn

The ARN that is assigned to a compute resource and uniquely identifies it. ARNs are unique across locations. Instances in managed EC2 fleets are not assigned a Compute ARN.

compute.compute_name

A descriptive label for the compute resource. For instances in a managed EC2 fleet, the compute name is the same value as the InstanceId ID.

compute.compute_status

Current status of the compute. A compute must have an ACTIVE status to host game sessions.

compute.container_attributes

Some attributes of a container.

Show child fields
compute.container_attributes.container_port_mappings[]
Show child fields
compute.container_attributes.container_port_mappings[].connection_port

The port opened on the fleet instance. This is also called the "host port".

compute.container_attributes.container_port_mappings[].container_port

The port opened on the container.

compute.container_attributes.container_port_mappings[].protocol

The network protocol that this mapping supports.

compute.creation_time

A time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057").

compute.dns_name

The DNS name of a compute resource. Amazon GameLift requires a DNS name or IP address for a compute.

compute.fleet_arn

The Amazon Resource Name (ARN) of the fleet that the compute belongs to.

compute.fleet_id

A unique identifier for the fleet that the compute belongs to.

compute.game_lift_agent_endpoint

The endpoint of the Amazon GameLift Agent.

compute.game_lift_service_sdk_endpoint

The Amazon GameLift SDK endpoint connection for a registered compute resource in an Anywhere fleet. The game servers on the compute use this endpoint to connect to the Amazon GameLift service.

compute.instance_id

The InstanceID of the Instance hosting the compute for Container and Managed EC2 fleets.

compute.ip_address

The IP address of a compute resource. Amazon GameLift requires a DNS name or IP address for a compute.

compute.location

The name of the custom location you added to the fleet that this compute resource resides in.

compute.operating_system

The type of operating system on the compute resource.

compute.type

The Amazon EC2 instance type that the fleet uses. For registered computes in an Amazon GameLift Anywhere fleet, this property is empty.