/AWS1/CL_GMZUPDSTREAMGROUPOUT¶
UpdateStreamGroupOutput
CONSTRUCTOR¶
IMPORTING¶
Required arguments:¶
iv_arn TYPE /AWS1/GMZIDENTIFIER /AWS1/GMZIDENTIFIER¶
The Amazon Resource Name (ARN) that is assigned to the stream group resource and that uniquely identifies the group across all Amazon Web Services Regions. Format is
arn:aws:gameliftstreams:[AWS Region]:[AWS account]:streamgroup/[resource ID].
Optional arguments:¶
iv_description TYPE /AWS1/GMZDESCRIPTION /AWS1/GMZDESCRIPTION¶
A descriptive label for the stream group.
io_defaultapplication TYPE REF TO /AWS1/CL_GMZDEFAULTAPPLICATION /AWS1/CL_GMZDEFAULTAPPLICATION¶
The default Amazon GameLift Streams application that is associated with this stream group.
it_locationstates TYPE /AWS1/CL_GMZLOCATIONSTATE=>TT_LOCATIONSTATES TT_LOCATIONSTATES¶
This value is set of locations, including their name, current status, and capacities.
A location can be in one of the following states:
ACTIVATING: Amazon GameLift Streams is preparing the location. You cannot stream from, scale the capacity of, or remove this location yet.
ACTIVE: The location is provisioned with initial capacity. You can now stream from, scale the capacity of, or remove this location.
ERROR: Amazon GameLift Streams failed to set up this location. TheStatusReasonfield describes the error. You can remove this location and try to add it again.
REMOVING: Amazon GameLift Streams is working to remove this location. This will release all provisioned capacity for this location in this stream group.
iv_streamclass TYPE /AWS1/GMZSTREAMCLASS /AWS1/GMZSTREAMCLASS¶
The target stream quality for the stream group.
A stream class can be one of the following:
gen5n_win2022(NVIDIA, ultra) Supports applications with extremely high 3D scene complexity. Runs applications on Microsoft Windows Server 2022 Base and supports DirectX 12. Compatible with Unreal Engine versions up through 5.4, 32 and 64-bit applications, and anti-cheat technology. Uses NVIDIA A10G Tensor GPU.
Reference resolution: 1080p
Reference frame rate: 60 fps
Workload specifications: 8 vCPUs, 32 GB RAM, 24 GB VRAM
Tenancy: Supports 1 concurrent stream session
gen5n_high(NVIDIA, high) Supports applications with moderate to high 3D scene complexity. Uses NVIDIA A10G Tensor GPU.
Reference resolution: 1080p
Reference frame rate: 60 fps
Workload specifications: 4 vCPUs, 16 GB RAM, 12 GB VRAM
Tenancy: Supports up to 2 concurrent stream sessions
gen5n_ultra(NVIDIA, ultra) Supports applications with extremely high 3D scene complexity. Uses dedicated NVIDIA A10G Tensor GPU.
Reference resolution: 1080p
Reference frame rate: 60 fps
Workload specifications: 8 vCPUs, 32 GB RAM, 24 GB VRAM
Tenancy: Supports 1 concurrent stream session
gen4n_win2022(NVIDIA, ultra) Supports applications with extremely high 3D scene complexity. Runs applications on Microsoft Windows Server 2022 Base and supports DirectX 12. Compatible with Unreal Engine versions up through 5.4, 32 and 64-bit applications, and anti-cheat technology. Uses NVIDIA T4 Tensor GPU.
Reference resolution: 1080p
Reference frame rate: 60 fps
Workload specifications: 8 vCPUs, 32 GB RAM, 16 GB VRAM
Tenancy: Supports 1 concurrent stream session
gen4n_high(NVIDIA, high) Supports applications with moderate to high 3D scene complexity. Uses NVIDIA T4 Tensor GPU.
Reference resolution: 1080p
Reference frame rate: 60 fps
Workload specifications: 4 vCPUs, 16 GB RAM, 8 GB VRAM
Tenancy: Supports up to 2 concurrent stream sessions
gen4n_ultra(NVIDIA, ultra) Supports applications with high 3D scene complexity. Uses dedicated NVIDIA T4 Tensor GPU.
Reference resolution: 1080p
Reference frame rate: 60 fps
Workload specifications: 8 vCPUs, 32 GB RAM, 16 GB VRAM
Tenancy: Supports 1 concurrent stream session
iv_id TYPE /AWS1/GMZID /AWS1/GMZID¶
A unique ID value that is assigned to the resource when it's created. Format example:
sg-1AB2C3De4.
iv_status TYPE /AWS1/GMZSTREAMGROUPSTATUS /AWS1/GMZSTREAMGROUPSTATUS¶
The current status of the stream group resource. Possible statuses include the following:
ACTIVATING: The stream group is deploying and isn't ready to host streams.
ACTIVE: The stream group is ready to host streams.
ACTIVE_WITH_ERRORS: One or more locations in the stream group are in an error state. Verify the details of individual locations and remove any locations which are in error.
DELETING: Amazon GameLift Streams is in the process of deleting the stream group.
ERROR: An error occurred when the stream group deployed. SeeStatusReason(returned byCreateStreamGroup,GetStreamGroup, andUpdateStreamGroup) for more information.
EXPIRED: The stream group is expired and can no longer host streams. This typically occurs when a stream group is 365 days old, as indicated by the value ofExpiresAt. Create a new stream group to resume streaming capabilities.
UPDATING_LOCATIONS: One or more locations in the stream group are in the process of updating (either activating or deleting).
iv_statusreason TYPE /AWS1/GMZSTREAMGROUPSTATUSRSN /AWS1/GMZSTREAMGROUPSTATUSRSN¶
A short description of the reason that the stream group is in
ERRORstatus. The possible reasons can be one of the following:
internalError: The request can't process right now because of an issue with the server. Try again later.
noAvailableInstances: Amazon GameLift Streams does not currently have enough available on-demand capacity to fulfill your request. Wait a few minutes and retry the request as capacity can shift frequently. You can also try to make the request using a different stream class or in another region.
iv_lastupdatedat TYPE /AWS1/GMZTIMESTAMP /AWS1/GMZTIMESTAMP¶
A timestamp that indicates when this resource was last updated. Timestamps are expressed using in ISO8601 format, such as:
2022-12-27T22:29:40+00:00(UTC).
iv_createdat TYPE /AWS1/GMZTIMESTAMP /AWS1/GMZTIMESTAMP¶
A timestamp that indicates when this resource was created. Timestamps are expressed using in ISO8601 format, such as:
2022-12-27T22:29:40+00:00(UTC).
iv_expiresat TYPE /AWS1/GMZTIMESTAMP /AWS1/GMZTIMESTAMP¶
The time at which this stream group expires. Timestamps are expressed using in ISO8601 format, such as:
2022-12-27T22:29:40+00:00(UTC). After this time, you will no longer be able to update this stream group or use it to start stream sessions. Only Get and Delete operations will work on an expired stream group.
it_associatedapplications TYPE /AWS1/CL_GMZARNLIST_W=>TT_ARNLIST TT_ARNLIST¶
A set of applications that this stream group is associated with. You can stream any of these applications with the stream group.
This value is a set of Amazon Resource Names (ARNs) that uniquely identify application resources. Example ARN:
arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6.
Queryable Attributes¶
Arn¶
The Amazon Resource Name (ARN) that is assigned to the stream group resource and that uniquely identifies the group across all Amazon Web Services Regions. Format is
arn:aws:gameliftstreams:[AWS Region]:[AWS account]:streamgroup/[resource ID].
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ARN() |
Getter for ARN, with configurable default |
ASK_ARN() |
Getter for ARN w/ exceptions if field has no value |
HAS_ARN() |
Determine if ARN has a value |
Description¶
A descriptive label for the stream group.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_DESCRIPTION() |
Getter for DESCRIPTION, with configurable default |
ASK_DESCRIPTION() |
Getter for DESCRIPTION w/ exceptions if field has no value |
HAS_DESCRIPTION() |
Determine if DESCRIPTION has a value |
DefaultApplication¶
The default Amazon GameLift Streams application that is associated with this stream group.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_DEFAULTAPPLICATION() |
Getter for DEFAULTAPPLICATION |
LocationStates¶
This value is set of locations, including their name, current status, and capacities.
A location can be in one of the following states:
ACTIVATING: Amazon GameLift Streams is preparing the location. You cannot stream from, scale the capacity of, or remove this location yet.
ACTIVE: The location is provisioned with initial capacity. You can now stream from, scale the capacity of, or remove this location.
ERROR: Amazon GameLift Streams failed to set up this location. TheStatusReasonfield describes the error. You can remove this location and try to add it again.
REMOVING: Amazon GameLift Streams is working to remove this location. This will release all provisioned capacity for this location in this stream group.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_LOCATIONSTATES() |
Getter for LOCATIONSTATES, with configurable default |
ASK_LOCATIONSTATES() |
Getter for LOCATIONSTATES w/ exceptions if field has no valu |
HAS_LOCATIONSTATES() |
Determine if LOCATIONSTATES has a value |
StreamClass¶
The target stream quality for the stream group.
A stream class can be one of the following:
gen5n_win2022(NVIDIA, ultra) Supports applications with extremely high 3D scene complexity. Runs applications on Microsoft Windows Server 2022 Base and supports DirectX 12. Compatible with Unreal Engine versions up through 5.4, 32 and 64-bit applications, and anti-cheat technology. Uses NVIDIA A10G Tensor GPU.
Reference resolution: 1080p
Reference frame rate: 60 fps
Workload specifications: 8 vCPUs, 32 GB RAM, 24 GB VRAM
Tenancy: Supports 1 concurrent stream session
gen5n_high(NVIDIA, high) Supports applications with moderate to high 3D scene complexity. Uses NVIDIA A10G Tensor GPU.
Reference resolution: 1080p
Reference frame rate: 60 fps
Workload specifications: 4 vCPUs, 16 GB RAM, 12 GB VRAM
Tenancy: Supports up to 2 concurrent stream sessions
gen5n_ultra(NVIDIA, ultra) Supports applications with extremely high 3D scene complexity. Uses dedicated NVIDIA A10G Tensor GPU.
Reference resolution: 1080p
Reference frame rate: 60 fps
Workload specifications: 8 vCPUs, 32 GB RAM, 24 GB VRAM
Tenancy: Supports 1 concurrent stream session
gen4n_win2022(NVIDIA, ultra) Supports applications with extremely high 3D scene complexity. Runs applications on Microsoft Windows Server 2022 Base and supports DirectX 12. Compatible with Unreal Engine versions up through 5.4, 32 and 64-bit applications, and anti-cheat technology. Uses NVIDIA T4 Tensor GPU.
Reference resolution: 1080p
Reference frame rate: 60 fps
Workload specifications: 8 vCPUs, 32 GB RAM, 16 GB VRAM
Tenancy: Supports 1 concurrent stream session
gen4n_high(NVIDIA, high) Supports applications with moderate to high 3D scene complexity. Uses NVIDIA T4 Tensor GPU.
Reference resolution: 1080p
Reference frame rate: 60 fps
Workload specifications: 4 vCPUs, 16 GB RAM, 8 GB VRAM
Tenancy: Supports up to 2 concurrent stream sessions
gen4n_ultra(NVIDIA, ultra) Supports applications with high 3D scene complexity. Uses dedicated NVIDIA T4 Tensor GPU.
Reference resolution: 1080p
Reference frame rate: 60 fps
Workload specifications: 8 vCPUs, 32 GB RAM, 16 GB VRAM
Tenancy: Supports 1 concurrent stream session
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_STREAMCLASS() |
Getter for STREAMCLASS, with configurable default |
ASK_STREAMCLASS() |
Getter for STREAMCLASS w/ exceptions if field has no value |
HAS_STREAMCLASS() |
Determine if STREAMCLASS has a value |
Id¶
A unique ID value that is assigned to the resource when it's created. Format example:
sg-1AB2C3De4.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ID() |
Getter for ID, with configurable default |
ASK_ID() |
Getter for ID w/ exceptions if field has no value |
HAS_ID() |
Determine if ID has a value |
Status¶
The current status of the stream group resource. Possible statuses include the following:
ACTIVATING: The stream group is deploying and isn't ready to host streams.
ACTIVE: The stream group is ready to host streams.
ACTIVE_WITH_ERRORS: One or more locations in the stream group are in an error state. Verify the details of individual locations and remove any locations which are in error.
DELETING: Amazon GameLift Streams is in the process of deleting the stream group.
ERROR: An error occurred when the stream group deployed. SeeStatusReason(returned byCreateStreamGroup,GetStreamGroup, andUpdateStreamGroup) for more information.
EXPIRED: The stream group is expired and can no longer host streams. This typically occurs when a stream group is 365 days old, as indicated by the value ofExpiresAt. Create a new stream group to resume streaming capabilities.
UPDATING_LOCATIONS: One or more locations in the stream group are in the process of updating (either activating or deleting).
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_STATUS() |
Getter for STATUS, with configurable default |
ASK_STATUS() |
Getter for STATUS w/ exceptions if field has no value |
HAS_STATUS() |
Determine if STATUS has a value |
StatusReason¶
A short description of the reason that the stream group is in
ERRORstatus. The possible reasons can be one of the following:
internalError: The request can't process right now because of an issue with the server. Try again later.
noAvailableInstances: Amazon GameLift Streams does not currently have enough available on-demand capacity to fulfill your request. Wait a few minutes and retry the request as capacity can shift frequently. You can also try to make the request using a different stream class or in another region.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_STATUSREASON() |
Getter for STATUSREASON, with configurable default |
ASK_STATUSREASON() |
Getter for STATUSREASON w/ exceptions if field has no value |
HAS_STATUSREASON() |
Determine if STATUSREASON has a value |
LastUpdatedAt¶
A timestamp that indicates when this resource was last updated. Timestamps are expressed using in ISO8601 format, such as:
2022-12-27T22:29:40+00:00(UTC).
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_LASTUPDATEDAT() |
Getter for LASTUPDATEDAT, with configurable default |
ASK_LASTUPDATEDAT() |
Getter for LASTUPDATEDAT w/ exceptions if field has no value |
HAS_LASTUPDATEDAT() |
Determine if LASTUPDATEDAT has a value |
CreatedAt¶
A timestamp that indicates when this resource was created. Timestamps are expressed using in ISO8601 format, such as:
2022-12-27T22:29:40+00:00(UTC).
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_CREATEDAT() |
Getter for CREATEDAT, with configurable default |
ASK_CREATEDAT() |
Getter for CREATEDAT w/ exceptions if field has no value |
HAS_CREATEDAT() |
Determine if CREATEDAT has a value |
ExpiresAt¶
The time at which this stream group expires. Timestamps are expressed using in ISO8601 format, such as:
2022-12-27T22:29:40+00:00(UTC). After this time, you will no longer be able to update this stream group or use it to start stream sessions. Only Get and Delete operations will work on an expired stream group.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_EXPIRESAT() |
Getter for EXPIRESAT, with configurable default |
ASK_EXPIRESAT() |
Getter for EXPIRESAT w/ exceptions if field has no value |
HAS_EXPIRESAT() |
Determine if EXPIRESAT has a value |
AssociatedApplications¶
A set of applications that this stream group is associated with. You can stream any of these applications with the stream group.
This value is a set of Amazon Resource Names (ARNs) that uniquely identify application resources. Example ARN:
arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ASSOCIATEDAPPLICATIONS() |
Getter for ASSOCIATEDAPPLICATIONS, with configurable default |
ASK_ASSOCIATEDAPPLICATIONS() |
Getter for ASSOCIATEDAPPLICATIONS w/ exceptions if field has |
HAS_ASSOCIATEDAPPLICATIONS() |
Determine if ASSOCIATEDAPPLICATIONS has a value |