Skip to content

Commit 3e1c7e1

Browse files
author
awstools
committed
docs(client-gameliftstreams): Documentation updates for Amazon GameLift Streams to address formatting errors, correct resource ID examples, and update links to other guides
1 parent 4010d27 commit 3e1c7e1

30 files changed

+442
-2293
lines changed

clients/client-gameliftstreams/README.md

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,7 @@
66

77
AWS SDK for JavaScript GameLiftStreams Client for Node.js, Browser and React Native.
88

9-
<fullname>Amazon GameLift Streams</fullname>
10-
11-
<p>Amazon GameLift Streams provides a global cloud solution for content streaming experiences. Use Amazon GameLift Streams tools to upload and configure content for
12-
streaming, deploy and scale computing resources to host streams, and manage stream session placement to meet customer demand.</p>
13-
<p>This Reference Guide describes the Amazon GameLift Streams service API. You can use the API through the Amazon Web Services SDK, the Command Line Interface (AWS CLI), or by making
14-
direct REST calls through HTTPS.</p>
15-
<p>See the <i>Amazon GameLift Streams Developer Guide</i> for more information on how Amazon GameLift Streams works and how to work with it.</p>
9+
<fullname>Amazon GameLift Streams</fullname> <p>Amazon GameLift Streams provides a global cloud solution for content streaming experiences. Use Amazon GameLift Streams tools to upload and configure content for streaming, deploy and scale computing resources to host streams, and manage stream session placement to meet customer demand.</p> <p>This Reference Guide describes the Amazon GameLift Streams service API. You can use the API through the Amazon Web Services SDK, the Command Line Interface (CLI), or by making direct REST calls through HTTPS.</p> <p>See the <i>Amazon GameLift Streams Developer Guide</i> for more information on how Amazon GameLift Streams works and how to work with it.</p>
1610

1711
## Installing
1812

clients/client-gameliftstreams/src/GameLiftStreams.ts

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -543,12 +543,7 @@ export interface GameLiftStreams {
543543
}
544544

545545
/**
546-
* <fullname>Amazon GameLift Streams</fullname>
547-
* <p>Amazon GameLift Streams provides a global cloud solution for content streaming experiences. Use Amazon GameLift Streams tools to upload and configure content for
548-
* streaming, deploy and scale computing resources to host streams, and manage stream session placement to meet customer demand.</p>
549-
* <p>This Reference Guide describes the Amazon GameLift Streams service API. You can use the API through the Amazon Web Services SDK, the Command Line Interface (AWS CLI), or by making
550-
* direct REST calls through HTTPS.</p>
551-
* <p>See the <i>Amazon GameLift Streams Developer Guide</i> for more information on how Amazon GameLift Streams works and how to work with it.</p>
546+
* <fullname>Amazon GameLift Streams</fullname> <p>Amazon GameLift Streams provides a global cloud solution for content streaming experiences. Use Amazon GameLift Streams tools to upload and configure content for streaming, deploy and scale computing resources to host streams, and manage stream session placement to meet customer demand.</p> <p>This Reference Guide describes the Amazon GameLift Streams service API. You can use the API through the Amazon Web Services SDK, the Command Line Interface (CLI), or by making direct REST calls through HTTPS.</p> <p>See the <i>Amazon GameLift Streams Developer Guide</i> for more information on how Amazon GameLift Streams works and how to work with it.</p>
552547
* @public
553548
*/
554549
export class GameLiftStreams extends GameLiftStreamsClient implements GameLiftStreams {}

clients/client-gameliftstreams/src/GameLiftStreamsClient.ts

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -364,12 +364,7 @@ export type GameLiftStreamsClientResolvedConfigType = __SmithyResolvedConfigurat
364364
export interface GameLiftStreamsClientResolvedConfig extends GameLiftStreamsClientResolvedConfigType {}
365365

366366
/**
367-
* <fullname>Amazon GameLift Streams</fullname>
368-
* <p>Amazon GameLift Streams provides a global cloud solution for content streaming experiences. Use Amazon GameLift Streams tools to upload and configure content for
369-
* streaming, deploy and scale computing resources to host streams, and manage stream session placement to meet customer demand.</p>
370-
* <p>This Reference Guide describes the Amazon GameLift Streams service API. You can use the API through the Amazon Web Services SDK, the Command Line Interface (AWS CLI), or by making
371-
* direct REST calls through HTTPS.</p>
372-
* <p>See the <i>Amazon GameLift Streams Developer Guide</i> for more information on how Amazon GameLift Streams works and how to work with it.</p>
367+
* <fullname>Amazon GameLift Streams</fullname> <p>Amazon GameLift Streams provides a global cloud solution for content streaming experiences. Use Amazon GameLift Streams tools to upload and configure content for streaming, deploy and scale computing resources to host streams, and manage stream session placement to meet customer demand.</p> <p>This Reference Guide describes the Amazon GameLift Streams service API. You can use the API through the Amazon Web Services SDK, the Command Line Interface (CLI), or by making direct REST calls through HTTPS.</p> <p>See the <i>Amazon GameLift Streams Developer Guide</i> for more information on how Amazon GameLift Streams works and how to work with it.</p>
373368
* @public
374369
*/
375370
export class GameLiftStreamsClient extends __Client<

clients/client-gameliftstreams/src/commands/AddStreamGroupLocationsCommand.ts

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -28,11 +28,7 @@ export interface AddStreamGroupLocationsCommandInput extends AddStreamGroupLocat
2828
export interface AddStreamGroupLocationsCommandOutput extends AddStreamGroupLocationsOutput, __MetadataBearer {}
2929

3030
/**
31-
* <p> Add locations that can host stream sessions. You configure locations and their corresponding capacity for each stream group. Creating a
32-
* stream group in a location that's nearest to your end users can help minimize latency and improve quality. </p>
33-
* <p> This operation provisions stream capacity at the specified locations. By default, all locations have 1 or 2 capacity, depending on the
34-
* stream class option: 2 for 'High' and 1 for 'Ultra' and 'Win2022'. This operation also copies the content files of all associated
35-
* applications to an internal S3 bucket at each location. This allows Amazon GameLift Streams to host performant stream sessions. </p>
31+
* <p> Add locations that can host stream sessions. You configure locations and their corresponding capacity for each stream group. Creating a stream group in a location that's nearest to your end users can help minimize latency and improve quality. </p> <p> This operation provisions stream capacity at the specified locations. By default, all locations have 1 or 2 capacity, depending on the stream class option: 2 for 'High' and 1 for 'Ultra' and 'Win2022'. This operation also copies the content files of all associated applications to an internal S3 bucket at each location. This allows Amazon GameLift Streams to host performant stream sessions. </p>
3632
* @example
3733
* Use a bare-bones client and the command you need to make an API call.
3834
* ```javascript
@@ -90,8 +86,7 @@ export interface AddStreamGroupLocationsCommandOutput extends AddStreamGroupLoca
9086
* <p>The request was denied due to request throttling. Retry the request after the suggested wait time.</p>
9187
*
9288
* @throws {@link ValidationException} (client fault)
93-
* <p>One or more parameter values in the request fail to satisfy the specified constraints. Correct the invalid parameter values before
94-
* retrying the request.</p>
89+
* <p>One or more parameter values in the request fail to satisfy the specified constraints. Correct the invalid parameter values before retrying the request.</p>
9590
*
9691
* @throws {@link GameLiftStreamsServiceException}
9792
* <p>Base exception class for all service exceptions from GameLiftStreams service.</p>

clients/client-gameliftstreams/src/commands/AssociateApplicationsCommand.ts

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -28,8 +28,7 @@ export interface AssociateApplicationsCommandInput extends AssociateApplications
2828
export interface AssociateApplicationsCommandOutput extends AssociateApplicationsOutput, __MetadataBearer {}
2929

3030
/**
31-
* <p>When you associate, or link, an application with a stream group, then Amazon GameLift Streams can launch the application using the stream group's
32-
* allocated compute resources. The stream group must be in <code>ACTIVE</code> status. You can reverse this action by using <a href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_DisassociateApplications.html">DisassociateApplications</a>.</p>
31+
* <p>When you associate, or link, an application with a stream group, then Amazon GameLift Streams can launch the application using the stream group's allocated compute resources. The stream group must be in <code>ACTIVE</code> status. You can reverse this action by using <a href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_DisassociateApplications.html">DisassociateApplications</a>.</p>
3332
* @example
3433
* Use a bare-bones client and the command you need to make an API call.
3534
* ```javascript
@@ -75,8 +74,7 @@ export interface AssociateApplicationsCommandOutput extends AssociateApplication
7574
* <p>The request was denied due to request throttling. Retry the request after the suggested wait time.</p>
7675
*
7776
* @throws {@link ValidationException} (client fault)
78-
* <p>One or more parameter values in the request fail to satisfy the specified constraints. Correct the invalid parameter values before
79-
* retrying the request.</p>
77+
* <p>One or more parameter values in the request fail to satisfy the specified constraints. Correct the invalid parameter values before retrying the request.</p>
8078
*
8179
* @throws {@link GameLiftStreamsServiceException}
8280
* <p>Base exception class for all service exceptions from GameLiftStreams service.</p>

clients/client-gameliftstreams/src/commands/CreateApplicationCommand.ts

Lines changed: 3 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -28,17 +28,7 @@ export interface CreateApplicationCommandInput extends CreateApplicationInput {}
2828
export interface CreateApplicationCommandOutput extends CreateApplicationOutput, __MetadataBearer {}
2929

3030
/**
31-
* <p>Creates an application resource in Amazon GameLift Streams, which specifies the application content you want to stream, such as a game build or other
32-
* software, and configures the settings to run it.</p>
33-
* <p> Before you create an application, upload your application content files to an Amazon Simple Storage Service (Amazon S3) bucket. For more information, see
34-
* <b>Getting Started</b> in the Amazon GameLift Streams Developer Guide. </p>
35-
* <important>
36-
* <p> Make sure that your files in the Amazon S3 bucket are the correct version you want to use. As soon as you create a Amazon GameLift Streams application,
37-
* you cannot change the files at a later time. </p>
38-
* </important>
39-
* <p> If the request is successful, Amazon GameLift Streams begins to create an application and sets the status to <code>INITIALIZED</code>. When an
40-
* application reaches <code>READY</code> status, you can use the application to set up stream groups and start streams. To track application
41-
* status, call <a href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetApplication.html">GetApplication</a>. </p>
31+
* <p>Creates an application resource in Amazon GameLift Streams, which specifies the application content you want to stream, such as a game build or other software, and configures the settings to run it.</p> <p> Before you create an application, upload your application content files to an Amazon Simple Storage Service (Amazon S3) bucket. For more information, see <b>Getting Started</b> in the Amazon GameLift Streams Developer Guide. </p> <important> <p> Make sure that your files in the Amazon S3 bucket are the correct version you want to use. If you change the files at a later time, you will need to create a new Amazon GameLift Streams application. </p> </important> <p> If the request is successful, Amazon GameLift Streams begins to create an application and sets the status to <code>INITIALIZED</code>. When an application reaches <code>READY</code> status, you can use the application to set up stream groups and start streams. To track application status, call <a href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetApplication.html">GetApplication</a>. </p>
4232
* @example
4333
* Use a bare-bones client and the command you need to make an API call.
4434
* ```javascript
@@ -105,8 +95,7 @@ export interface CreateApplicationCommandOutput extends CreateApplicationOutput,
10595
* <p>You don't have the required permissions to access this Amazon GameLift Streams resource. Correct the permissions before you try again.</p>
10696
*
10797
* @throws {@link ConflictException} (client fault)
108-
* <p>The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the
109-
* conflict before retrying this request.</p>
98+
* <p>The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.</p>
11099
*
111100
* @throws {@link InternalServerException} (server fault)
112101
* <p>The service encountered an internal error and is unable to complete the request.</p>
@@ -118,8 +107,7 @@ export interface CreateApplicationCommandOutput extends CreateApplicationOutput,
118107
* <p>The request was denied due to request throttling. Retry the request after the suggested wait time.</p>
119108
*
120109
* @throws {@link ValidationException} (client fault)
121-
* <p>One or more parameter values in the request fail to satisfy the specified constraints. Correct the invalid parameter values before
122-
* retrying the request.</p>
110+
* <p>One or more parameter values in the request fail to satisfy the specified constraints. Correct the invalid parameter values before retrying the request.</p>
123111
*
124112
* @throws {@link GameLiftStreamsServiceException}
125113
* <p>Base exception class for all service exceptions from GameLiftStreams service.</p>

clients/client-gameliftstreams/src/commands/CreateStreamGroupCommand.ts

Lines changed: 3 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -28,35 +28,7 @@ export interface CreateStreamGroupCommandInput extends CreateStreamGroupInput {}
2828
export interface CreateStreamGroupCommandOutput extends CreateStreamGroupOutput, __MetadataBearer {}
2929

3030
/**
31-
* <p> Manage how Amazon GameLift Streams streams your applications by using a stream group. A stream group is a collection of resources that Amazon GameLift Streams uses to
32-
* stream your application to end-users. When you create a stream group, you specify an application to stream by default and the type of
33-
* hardware to use, such as the graphical processing unit (GPU). You can also link additional applications, which allows you to stream those
34-
* applications using this stream group. Depending on your expected users, you also scale the number of concurrent streams you want to
35-
* support at one time, and in what locations. </p>
36-
* <p>
37-
* Stream capacity represents the number of concurrent streams that can be active at a time. You set stream capacity per location, per stream group. There are two types of capacity: always-on and on-demand:
38-
* </p>
39-
* <ul>
40-
* <li>
41-
* <p>
42-
* <b>Always-on</b>:
43-
* The streaming capacity that is allocated and ready to handle stream requests without delay. You pay for this capacity whether it's in use or not. Best for quickest time from streaming request to streaming session.
44-
*
45-
* </p>
46-
* </li>
47-
* <li>
48-
* <p>
49-
* <b>On-demand</b>:
50-
* The streaming capacity that Amazon GameLift Streams can allocate in response to stream requests, and then de-allocate when the session has terminated. This offers a cost control measure at the expense of a greater startup time (typically under 5 minutes).
51-
*
52-
* </p>
53-
* </li>
54-
* </ul>
55-
* <p> To adjust the capacity of any <code>ACTIVE</code> stream group, call <a href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_UpdateStreamGroup.html">UpdateStreamGroup</a>. </p>
56-
* <p> If the request is successful, Amazon GameLift Streams begins creating the stream group. Amazon GameLift Streams assigns a unique ID to the stream group resource and
57-
* sets the status to <code>ACTIVATING</code>. When the stream group reaches <code>ACTIVE</code> status, you can start stream sessions by
58-
* using <a href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_StartStreamSession.html">StartStreamSession</a>. To check the stream
59-
* group's status, call <a href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetStreamGroup.html">GetStreamGroup</a>. </p>
31+
* <p> Manage how Amazon GameLift Streams streams your applications by using a stream group. A stream group is a collection of resources that Amazon GameLift Streams uses to stream your application to end-users. When you create a stream group, you specify an application to stream by default and the type of hardware to use, such as the graphical processing unit (GPU). You can also link additional applications, which allows you to stream those applications using this stream group. Depending on your expected users, you also scale the number of concurrent streams you want to support at one time, and in what locations. </p> <p> Stream capacity represents the number of concurrent streams that can be active at a time. You set stream capacity per location, per stream group. There are two types of capacity, always-on and on-demand: </p> <ul> <li> <p> <b>Always-on</b>: The streaming capacity that is allocated and ready to handle stream requests without delay. You pay for this capacity whether it's in use or not. Best for quickest time from streaming request to streaming session. </p> </li> <li> <p> <b>On-demand</b>: The streaming capacity that Amazon GameLift Streams can allocate in response to stream requests, and then de-allocate when the session has terminated. This offers a cost control measure at the expense of a greater startup time (typically under 5 minutes). </p> </li> </ul> <p> To adjust the capacity of any <code>ACTIVE</code> stream group, call <a href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_UpdateStreamGroup.html">UpdateStreamGroup</a>. </p> <p> If the request is successful, Amazon GameLift Streams begins creating the stream group. Amazon GameLift Streams assigns a unique ID to the stream group resource and sets the status to <code>ACTIVATING</code>. When the stream group reaches <code>ACTIVE</code> status, you can start stream sessions by using <a href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_StartStreamSession.html">StartStreamSession</a>. To check the stream group's status, call <a href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetStreamGroup.html">GetStreamGroup</a>. </p>
6032
* @example
6133
* Use a bare-bones client and the command you need to make an API call.
6234
* ```javascript
@@ -122,8 +94,7 @@ export interface CreateStreamGroupCommandOutput extends CreateStreamGroupOutput,
12294
* <p>You don't have the required permissions to access this Amazon GameLift Streams resource. Correct the permissions before you try again.</p>
12395
*
12496
* @throws {@link ConflictException} (client fault)
125-
* <p>The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the
126-
* conflict before retrying this request.</p>
97+
* <p>The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.</p>
12798
*
12899
* @throws {@link InternalServerException} (server fault)
129100
* <p>The service encountered an internal error and is unable to complete the request.</p>
@@ -138,8 +109,7 @@ export interface CreateStreamGroupCommandOutput extends CreateStreamGroupOutput,
138109
* <p>The request was denied due to request throttling. Retry the request after the suggested wait time.</p>
139110
*
140111
* @throws {@link ValidationException} (client fault)
141-
* <p>One or more parameter values in the request fail to satisfy the specified constraints. Correct the invalid parameter values before
142-
* retrying the request.</p>
112+
* <p>One or more parameter values in the request fail to satisfy the specified constraints. Correct the invalid parameter values before retrying the request.</p>
143113
*
144114
* @throws {@link GameLiftStreamsServiceException}
145115
* <p>Base exception class for all service exceptions from GameLiftStreams service.</p>

0 commit comments

Comments
 (0)