We recommend new projects start with resources from the AWS provider.
aws-native.gamelift.Script
Explore with Pulumi AI
We recommend new projects start with resources from the AWS provider.
The AWS::GameLift::Script resource 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.
Create Script Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Script(name: string, args: ScriptArgs, opts?: CustomResourceOptions);
@overload
def Script(resource_name: str,
args: ScriptArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Script(resource_name: str,
opts: Optional[ResourceOptions] = None,
storage_location: Optional[ScriptS3LocationArgs] = None,
name: Optional[str] = None,
tags: Optional[Sequence[_root_inputs.TagArgs]] = None,
version: Optional[str] = None)
func NewScript(ctx *Context, name string, args ScriptArgs, opts ...ResourceOption) (*Script, error)
public Script(string name, ScriptArgs args, CustomResourceOptions? opts = null)
public Script(String name, ScriptArgs args)
public Script(String name, ScriptArgs args, CustomResourceOptions options)
type: aws-native:gamelift:Script
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args ScriptArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args ScriptArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args ScriptArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ScriptArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ScriptArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Script Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Script resource accepts the following input properties:
- Storage
Location Pulumi.Aws Native. Game Lift. Inputs. Script S3Location - The location of the Amazon S3 bucket where a zipped file containing your Realtime scripts is stored. The storage location must specify the Amazon S3 bucket name, the zip file name (the "key"), and a role ARN that allows Amazon GameLift to access the Amazon S3 storage location. The S3 bucket must be in the same Region where you want to create a new script. By default, Amazon GameLift uploads the latest version of the zip file; if you have S3 object versioning turned on, you can use the ObjectVersion parameter to specify an earlier version.
- Name string
- A descriptive label that is associated with a script. Script names do not need to be unique.
- List<Pulumi.
Aws Native. Inputs. Tag> - An array of key-value pairs to apply to this resource.
- Version string
- The version that is associated with a script. Version strings do not need to be unique.
- Storage
Location ScriptS3Location Args - The location of the Amazon S3 bucket where a zipped file containing your Realtime scripts is stored. The storage location must specify the Amazon S3 bucket name, the zip file name (the "key"), and a role ARN that allows Amazon GameLift to access the Amazon S3 storage location. The S3 bucket must be in the same Region where you want to create a new script. By default, Amazon GameLift uploads the latest version of the zip file; if you have S3 object versioning turned on, you can use the ObjectVersion parameter to specify an earlier version.
- Name string
- A descriptive label that is associated with a script. Script names do not need to be unique.
- Tag
Args - An array of key-value pairs to apply to this resource.
- Version string
- The version that is associated with a script. Version strings do not need to be unique.
- storage
Location ScriptS3Location - The location of the Amazon S3 bucket where a zipped file containing your Realtime scripts is stored. The storage location must specify the Amazon S3 bucket name, the zip file name (the "key"), and a role ARN that allows Amazon GameLift to access the Amazon S3 storage location. The S3 bucket must be in the same Region where you want to create a new script. By default, Amazon GameLift uploads the latest version of the zip file; if you have S3 object versioning turned on, you can use the ObjectVersion parameter to specify an earlier version.
- name String
- A descriptive label that is associated with a script. Script names do not need to be unique.
- List<Tag>
- An array of key-value pairs to apply to this resource.
- version String
- The version that is associated with a script. Version strings do not need to be unique.
- storage
Location ScriptS3Location - The location of the Amazon S3 bucket where a zipped file containing your Realtime scripts is stored. The storage location must specify the Amazon S3 bucket name, the zip file name (the "key"), and a role ARN that allows Amazon GameLift to access the Amazon S3 storage location. The S3 bucket must be in the same Region where you want to create a new script. By default, Amazon GameLift uploads the latest version of the zip file; if you have S3 object versioning turned on, you can use the ObjectVersion parameter to specify an earlier version.
- name string
- A descriptive label that is associated with a script. Script names do not need to be unique.
- Tag[]
- An array of key-value pairs to apply to this resource.
- version string
- The version that is associated with a script. Version strings do not need to be unique.
- storage_
location ScriptS3Location Args - The location of the Amazon S3 bucket where a zipped file containing your Realtime scripts is stored. The storage location must specify the Amazon S3 bucket name, the zip file name (the "key"), and a role ARN that allows Amazon GameLift to access the Amazon S3 storage location. The S3 bucket must be in the same Region where you want to create a new script. By default, Amazon GameLift uploads the latest version of the zip file; if you have S3 object versioning turned on, you can use the ObjectVersion parameter to specify an earlier version.
- name str
- A descriptive label that is associated with a script. Script names do not need to be unique.
- Sequence[Tag
Args] - An array of key-value pairs to apply to this resource.
- version str
- The version that is associated with a script. Version strings do not need to be unique.
- storage
Location Property Map - The location of the Amazon S3 bucket where a zipped file containing your Realtime scripts is stored. The storage location must specify the Amazon S3 bucket name, the zip file name (the "key"), and a role ARN that allows Amazon GameLift to access the Amazon S3 storage location. The S3 bucket must be in the same Region where you want to create a new script. By default, Amazon GameLift uploads the latest version of the zip file; if you have S3 object versioning turned on, you can use the ObjectVersion parameter to specify an earlier version.
- name String
- A descriptive label that is associated with a script. Script names do not need to be unique.
- List<Property Map>
- An array of key-value pairs to apply to this resource.
- version String
- The version that is associated with a script. Version strings do not need to be unique.
Outputs
All input properties are implicitly available as output properties. Additionally, the Script resource produces the following output properties:
- Arn string
- The Amazon Resource Name (ARN) that is assigned to a Amazon GameLift script resource and uniquely identifies it. ARNs are unique across all Regions. In a GameLift script ARN, the resource ID matches the Id value.
- Aws
Id string - A unique identifier for the Realtime script
- Creation
Time string - A time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057").
- Id string
- The provider-assigned unique ID for this managed resource.
- Size
On intDisk - The file size of the uploaded Realtime script, expressed in bytes. When files are uploaded from an S3 location, this value remains at "0".
- Arn string
- The Amazon Resource Name (ARN) that is assigned to a Amazon GameLift script resource and uniquely identifies it. ARNs are unique across all Regions. In a GameLift script ARN, the resource ID matches the Id value.
- Aws
Id string - A unique identifier for the Realtime script
- Creation
Time string - A time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057").
- Id string
- The provider-assigned unique ID for this managed resource.
- Size
On intDisk - The file size of the uploaded Realtime script, expressed in bytes. When files are uploaded from an S3 location, this value remains at "0".
- arn String
- The Amazon Resource Name (ARN) that is assigned to a Amazon GameLift script resource and uniquely identifies it. ARNs are unique across all Regions. In a GameLift script ARN, the resource ID matches the Id value.
- aws
Id String - A unique identifier for the Realtime script
- creation
Time String - A time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057").
- id String
- The provider-assigned unique ID for this managed resource.
- size
On IntegerDisk - The file size of the uploaded Realtime script, expressed in bytes. When files are uploaded from an S3 location, this value remains at "0".
- arn string
- The Amazon Resource Name (ARN) that is assigned to a Amazon GameLift script resource and uniquely identifies it. ARNs are unique across all Regions. In a GameLift script ARN, the resource ID matches the Id value.
- aws
Id string - A unique identifier for the Realtime script
- creation
Time string - A time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057").
- id string
- The provider-assigned unique ID for this managed resource.
- size
On numberDisk - The file size of the uploaded Realtime script, expressed in bytes. When files are uploaded from an S3 location, this value remains at "0".
- arn str
- The Amazon Resource Name (ARN) that is assigned to a Amazon GameLift script resource and uniquely identifies it. ARNs are unique across all Regions. In a GameLift script ARN, the resource ID matches the Id value.
- aws_
id str - A unique identifier for the Realtime script
- creation_
time str - A time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057").
- id str
- The provider-assigned unique ID for this managed resource.
- size_
on_ intdisk - The file size of the uploaded Realtime script, expressed in bytes. When files are uploaded from an S3 location, this value remains at "0".
- arn String
- The Amazon Resource Name (ARN) that is assigned to a Amazon GameLift script resource and uniquely identifies it. ARNs are unique across all Regions. In a GameLift script ARN, the resource ID matches the Id value.
- aws
Id String - A unique identifier for the Realtime script
- creation
Time String - A time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057").
- id String
- The provider-assigned unique ID for this managed resource.
- size
On NumberDisk - The file size of the uploaded Realtime script, expressed in bytes. When files are uploaded from an S3 location, this value remains at "0".
Supporting Types
ScriptS3Location, ScriptS3LocationArgs
- Bucket string
- An Amazon S3 bucket identifier. This is the name of the S3 bucket.
- Key string
- The name of the zip file that contains the script files.
- Role
Arn string - The Amazon Resource Name (ARN) for an IAM role that allows Amazon GameLift to access the S3 bucket.
- Object
Version string - The version of the file, if object versioning is turned on for the bucket. Amazon GameLift uses this information when retrieving files from your S3 bucket. To retrieve a specific version of the file, provide an object version. To retrieve the latest version of the file, do not set this parameter.
- Bucket string
- An Amazon S3 bucket identifier. This is the name of the S3 bucket.
- Key string
- The name of the zip file that contains the script files.
- Role
Arn string - The Amazon Resource Name (ARN) for an IAM role that allows Amazon GameLift to access the S3 bucket.
- Object
Version string - The version of the file, if object versioning is turned on for the bucket. Amazon GameLift uses this information when retrieving files from your S3 bucket. To retrieve a specific version of the file, provide an object version. To retrieve the latest version of the file, do not set this parameter.
- bucket String
- An Amazon S3 bucket identifier. This is the name of the S3 bucket.
- key String
- The name of the zip file that contains the script files.
- role
Arn String - The Amazon Resource Name (ARN) for an IAM role that allows Amazon GameLift to access the S3 bucket.
- object
Version String - The version of the file, if object versioning is turned on for the bucket. Amazon GameLift uses this information when retrieving files from your S3 bucket. To retrieve a specific version of the file, provide an object version. To retrieve the latest version of the file, do not set this parameter.
- bucket string
- An Amazon S3 bucket identifier. This is the name of the S3 bucket.
- key string
- The name of the zip file that contains the script files.
- role
Arn string - The Amazon Resource Name (ARN) for an IAM role that allows Amazon GameLift to access the S3 bucket.
- object
Version string - The version of the file, if object versioning is turned on for the bucket. Amazon GameLift uses this information when retrieving files from your S3 bucket. To retrieve a specific version of the file, provide an object version. To retrieve the latest version of the file, do not set this parameter.
- bucket str
- An Amazon S3 bucket identifier. This is the name of the S3 bucket.
- key str
- The name of the zip file that contains the script files.
- role_
arn str - The Amazon Resource Name (ARN) for an IAM role that allows Amazon GameLift to access the S3 bucket.
- object_
version str - The version of the file, if object versioning is turned on for the bucket. Amazon GameLift uses this information when retrieving files from your S3 bucket. To retrieve a specific version of the file, provide an object version. To retrieve the latest version of the file, do not set this parameter.
- bucket String
- An Amazon S3 bucket identifier. This is the name of the S3 bucket.
- key String
- The name of the zip file that contains the script files.
- role
Arn String - The Amazon Resource Name (ARN) for an IAM role that allows Amazon GameLift to access the S3 bucket.
- object
Version String - The version of the file, if object versioning is turned on for the bucket. Amazon GameLift uses this information when retrieving files from your S3 bucket. To retrieve a specific version of the file, provide an object version. To retrieve the latest version of the file, do not set this parameter.
Tag, TagArgs
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.