Skip to content

Commit 9242d8a

Browse files
Documentation updates for Amazon GameLift Streams to address formatting errors, correct resource ID examples, and update links to other guides
1 parent 0c96f1f commit 9242d8a

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

45 files changed

+1215
-1166
lines changed

VERSION

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
1.11.585
1+
1.11.586

generated/src/aws-cpp-sdk-gameliftstreams/include/aws/gameliftstreams/GameLiftStreamsClient.h

Lines changed: 44 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -22,10 +22,10 @@ namespace GameLiftStreams
2222
* scale computing resources to host streams, and manage stream session placement
2323
* to meet customer demand.</p> <p>This Reference Guide describes the Amazon
2424
* GameLift Streams service API. You can use the API through the Amazon Web
25-
* Services SDK, the Command Line Interface (AWS CLI), or by making direct REST
26-
* calls through HTTPS.</p> <p>See the <i>Amazon GameLift Streams Developer
27-
* Guide</i> for more information on how Amazon GameLift Streams works and how to
28-
* work with it.</p></p>
25+
* Services SDK, the Command Line Interface (CLI), or by making direct REST calls
26+
* through HTTPS.</p> <p>See the <i>Amazon GameLift Streams Developer Guide</i> for
27+
* more information on how Amazon GameLift Streams works and how to work with
28+
* it.</p></p>
2929
*/
3030
class AWS_GAMELIFTSTREAMS_API GameLiftStreamsClient : public Aws::Client::AWSJsonClient, public Aws::Client::ClientWithAsyncTemplateMethods<GameLiftStreamsClient>
3131
{
@@ -155,13 +155,13 @@ namespace GameLiftStreams
155155
* application, upload your application content files to an Amazon Simple Storage
156156
* Service (Amazon S3) bucket. For more information, see <b>Getting Started</b> in
157157
* the Amazon GameLift Streams Developer Guide. </p> <p> Make sure that
158-
* your files in the Amazon S3 bucket are the correct version you want to use. As
159-
* soon as you create a Amazon GameLift Streams application, you cannot change the
160-
* files at a later time. </p> <p> If the request is successful,
161-
* Amazon GameLift Streams begins to create an application and sets the status to
162-
* <code>INITIALIZED</code>. When an application reaches <code>READY</code> status,
163-
* you can use the application to set up stream groups and start streams. To track
164-
* application status, call <a
158+
* your files in the Amazon S3 bucket are the correct version you want to use. If
159+
* you change the files at a later time, you will need to create a new Amazon
160+
* GameLift Streams application. </p> <p> If the request is
161+
* successful, Amazon GameLift Streams begins to create an application and sets the
162+
* status to <code>INITIALIZED</code>. When an application reaches
163+
* <code>READY</code> status, you can use the application to set up stream groups
164+
* and start streams. To track application status, call <a
165165
* href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetApplication.html">GetApplication</a>.
166166
* </p><p><h3>See Also:</h3> <a
167167
* href="http://docs.aws.amazon.com/goto/WebAPI/gameliftstreams-2018-05-10/CreateApplication">AWS
@@ -198,28 +198,25 @@ namespace GameLiftStreams
198198
* of concurrent streams you want to support at one time, and in what locations.
199199
* </p> <p> Stream capacity represents the number of concurrent streams that can be
200200
* active at a time. You set stream capacity per location, per stream group. There
201-
* are two types of capacity: always-on and on-demand: </p> <ul> <li> <p>
201+
* are two types of capacity, always-on and on-demand: </p> <ul> <li> <p>
202202
* <b>Always-on</b>: The streaming capacity that is allocated and ready to handle
203203
* stream requests without delay. You pay for this capacity whether it's in use or
204-
* not. Best for quickest time from streaming request to streaming session.
205-
* <pre><code> &lt;/p&gt; &lt;/li&gt; &lt;li&gt; &lt;p&gt;
206-
* &lt;b&gt;On-demand&lt;/b&gt;: The streaming capacity that Amazon GameLift
204+
* not. Best for quickest time from streaming request to streaming session. </p>
205+
* </li> <li> <p> <b>On-demand</b>: The streaming capacity that Amazon GameLift
207206
* Streams can allocate in response to stream requests, and then de-allocate when
208207
* the session has terminated. This offers a cost control measure at the expense of
209-
* a greater startup time (typically under 5 minutes). &lt;/p&gt; &lt;/li&gt;
210-
* &lt;/ul&gt; &lt;p&gt; To adjust the capacity of any
211-
* &lt;code&gt;ACTIVE&lt;/code&gt; stream group, call &lt;a
212-
* href=&quot;https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_UpdateStreamGroup.html&quot;&gt;UpdateStreamGroup&lt;/a&gt;.
213-
* &lt;/p&gt; &lt;p&gt; If the request is successful, Amazon GameLift Streams
214-
* begins creating the stream group. Amazon GameLift Streams assigns a unique ID to
215-
* the stream group resource and sets the status to
216-
* &lt;code&gt;ACTIVATING&lt;/code&gt;. When the stream group reaches
217-
* &lt;code&gt;ACTIVE&lt;/code&gt; status, you can start stream sessions by using
218-
* &lt;a
219-
* href=&quot;https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_StartStreamSession.html&quot;&gt;StartStreamSession&lt;/a&gt;.
220-
* To check the stream group's status, call &lt;a
221-
* href=&quot;https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetStreamGroup.html&quot;&gt;GetStreamGroup&lt;/a&gt;.
222-
* &lt;/p&gt; </code></pre><p><h3>See Also:</h3> <a
208+
* a greater startup time (typically under 5 minutes). </p> </li> </ul> <p> To
209+
* adjust the capacity of any <code>ACTIVE</code> stream group, call <a
210+
* href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_UpdateStreamGroup.html">UpdateStreamGroup</a>.
211+
* </p> <p> If the request is successful, Amazon GameLift Streams begins creating
212+
* the stream group. Amazon GameLift Streams assigns a unique ID to the stream
213+
* group resource and sets the status to <code>ACTIVATING</code>. When the stream
214+
* group reaches <code>ACTIVE</code> status, you can start stream sessions by using
215+
* <a
216+
* href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_StartStreamSession.html">StartStreamSession</a>.
217+
* To check the stream group's status, call <a
218+
* href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetStreamGroup.html">GetStreamGroup</a>.
219+
* </p><p><h3>See Also:</h3> <a
223220
* href="http://docs.aws.amazon.com/goto/WebAPI/gameliftstreams-2018-05-10/CreateStreamGroup">AWS
224221
* API Reference</a></p>
225222
*/
@@ -716,23 +713,23 @@ namespace GameLiftStreams
716713
* <p> This action initiates a new stream session and outputs connection
717714
* information that clients can use to access the stream. A stream session refers
718715
* to an instance of a stream that Amazon GameLift Streams transmits from the
719-
* server to the end-user. A stream session runs on a compute resource, or stream
720-
* capacity, that a stream group has allocated. </p> <p>To start a new stream
721-
* session, specify a stream group and application ID, along with the transport
722-
* protocol and signal request settings to use with the stream. You must have
723-
* associated at least one application to the stream group before starting a stream
724-
* session, either when creating the stream group, or by using <a
716+
* server to the end-user. A stream session runs on a compute resource that a
717+
* stream group has allocated. </p> <p>To start a new stream session, specify a
718+
* stream group and application ID, along with the transport protocol and signal
719+
* request settings to use with the stream. You must have associated at least one
720+
* application to the stream group before starting a stream session, either when
721+
* creating the stream group, or by using <a
725722
* href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_AssociateApplications.html">AssociateApplications</a>.</p>
726723
* <p> For stream groups that have multiple locations, provide a set of locations
727-
* ordered by priority by setting <code>Locations</code>. Amazon GameLift Streams
728-
* will start a single stream session in the next available location. An
724+
* ordered by priority using a <code>Locations</code> parameter. Amazon GameLift
725+
* Streams will start a single stream session in the next available location. An
729726
* application must be finished replicating in a remote location before the remote
730727
* location can host a stream. </p> <p> If the request is successful, Amazon
731728
* GameLift Streams begins to prepare the stream. Amazon GameLift Streams assigns
732729
* an Amazon Resource Name (ARN) value to the stream session resource and sets the
733730
* status to <code>ACTIVATING</code>. During the stream preparation process, Amazon
734731
* GameLift Streams queues the request and searches for available stream capacity
735-
* to run the stream. This can result to one of the following: </p> <ul> <li> <p>
732+
* to run the stream. This results in one of the following: </p> <ul> <li> <p>
736733
* Amazon GameLift Streams identifies an available compute resource to run the
737734
* application content and start the stream. When the stream is ready, the stream
738735
* session's status changes to <code>ACTIVE</code> and includes stream connection
@@ -891,19 +888,18 @@ namespace GameLiftStreams
891888
* requested capacity of a stream group per location. If you want to change the
892889
* stream class, create a new stream group. </p> <p> Stream capacity represents the
893890
* number of concurrent streams that can be active at a time. You set stream
894-
* capacity per location, per stream group. There are two types of capacity:
891+
* capacity per location, per stream group. There are two types of capacity,
895892
* always-on and on-demand: </p> <ul> <li> <p> <b>Always-on</b>: The streaming
896893
* capacity that is allocated and ready to handle stream requests without delay.
897894
* You pay for this capacity whether it's in use or not. Best for quickest time
898-
* from streaming request to streaming session. <pre><code> &lt;/p&gt; &lt;/li&gt;
899-
* &lt;li&gt; &lt;p&gt; &lt;b&gt;On-demand&lt;/b&gt;: The streaming capacity that
900-
* Amazon GameLift Streams can allocate in response to stream requests, and then
901-
* de-allocate when the session has terminated. This offers a cost control measure
902-
* at the expense of a greater startup time (typically under 5 minutes). &lt;/p&gt;
903-
* &lt;/li&gt; &lt;/ul&gt; &lt;p&gt;To update a stream group, specify the stream
904-
* group's Amazon Resource Name (ARN) and provide the new values. If the request is
905-
* successful, Amazon GameLift Streams returns the complete updated metadata for
906-
* the stream group.&lt;/p&gt; </code></pre><p><h3>See Also:</h3> <a
895+
* from streaming request to streaming session. </p> </li> <li> <p>
896+
* <b>On-demand</b>: The streaming capacity that Amazon GameLift Streams can
897+
* allocate in response to stream requests, and then de-allocate when the session
898+
* has terminated. This offers a cost control measure at the expense of a greater
899+
* startup time (typically under 5 minutes). </p> </li> </ul> <p>To update a stream
900+
* group, specify the stream group's Amazon Resource Name (ARN) and provide the new
901+
* values. If the request is successful, Amazon GameLift Streams returns the
902+
* complete updated metadata for the stream group.</p><p><h3>See Also:</h3> <a
907903
* href="http://docs.aws.amazon.com/goto/WebAPI/gameliftstreams-2018-05-10/UpdateStreamGroup">AWS
908904
* API Reference</a></p>
909905
*/

generated/src/aws-cpp-sdk-gameliftstreams/include/aws/gameliftstreams/model/AddStreamGroupLocationsRequest.h

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -36,9 +36,13 @@ namespace Model
3636

3737
///@{
3838
/**
39-
* <p> A stream group to add the specified locations to. </p> <p>This value is a
40-
* Amazon Resource Name (ARN) that uniquely identifies the stream group resource.
41-
* Format example: <code>sg-1AB2C3De4</code>. </p>
39+
* <p> A stream group to add the specified locations to. </p> <p>This value is an
40+
* <a
41+
* href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html">Amazon
42+
* Resource Name (ARN)</a> or ID that uniquely identifies the stream group
43+
* resource. Example ARN:
44+
* <code>arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4</code>.
45+
* Example ID: <code>sg-1AB2C3De4</code>. </p>
4246
*/
4347
inline const Aws::String& GetIdentifier() const { return m_identifier; }
4448
inline bool IdentifierHasBeenSet() const { return m_identifierHasBeenSet; }

generated/src/aws-cpp-sdk-gameliftstreams/include/aws/gameliftstreams/model/AddStreamGroupLocationsResult.h

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,8 +36,12 @@ namespace Model
3636

3737
///@{
3838
/**
39-
* <p>This value is the Amazon Resource Name (ARN) that uniquely identifies the
40-
* stream group resource. Format example: <code>sg-1AB2C3De4</code>. </p>
39+
* <p>This value is an <a
40+
* href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html">Amazon
41+
* Resource Name (ARN)</a> or ID that uniquely identifies the stream group
42+
* resource. Example ARN:
43+
* <code>arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4</code>.
44+
* Example ID: <code>sg-1AB2C3De4</code>. </p>
4145
*/
4246
inline const Aws::String& GetIdentifier() const { return m_identifier; }
4347
template<typename IdentifierT = Aws::String>

generated/src/aws-cpp-sdk-gameliftstreams/include/aws/gameliftstreams/model/ApplicationSummary.h

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -87,12 +87,8 @@ namespace Model
8787

8888
///@{
8989
/**
90-
* <p>An <a
91-
* href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html">Amazon
92-
* Resource Name (ARN)</a> or ID that uniquely identifies the application resource.
93-
* Format example:
94-
* ARN-<code>arn:aws:gameliftstreams:us-west-2:123456789012:application/a-9ZY8X7Wv6</code>
95-
* or ID-<code>a-9ZY8X7Wv6</code>. </p>
90+
* <p>An ID that uniquely identifies the application resource. Example ID:
91+
* <code>a-9ZY8X7Wv6</code>. </p>
9692
*/
9793
inline const Aws::String& GetId() const { return m_id; }
9894
inline bool IdHasBeenSet() const { return m_idHasBeenSet; }

generated/src/aws-cpp-sdk-gameliftstreams/include/aws/gameliftstreams/model/AssociateApplicationsRequest.h

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -39,9 +39,9 @@ namespace Model
3939
* is a set of either <a
4040
* href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html">Amazon
4141
* Resource Names (ARN)</a> or IDs that uniquely identify application resources.
42-
* Format example:
43-
* ARN-<code>arn:aws:gameliftstreams:us-west-2:123456789012:application/a-9ZY8X7Wv6</code>
44-
* or ID-<code>a-9ZY8X7Wv6</code>. </p>
42+
* Example ARN:
43+
* <code>arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6</code>.
44+
* Example ID: <code>a-9ZY8X7Wv6</code>. </p>
4545
*/
4646
inline const Aws::Vector<Aws::String>& GetApplicationIdentifiers() const { return m_applicationIdentifiers; }
4747
inline bool ApplicationIdentifiersHasBeenSet() const { return m_applicationIdentifiersHasBeenSet; }
@@ -55,12 +55,12 @@ namespace Model
5555

5656
///@{
5757
/**
58-
* <p>A stream group to associate to the applications.</p> <p>This value is a <a
58+
* <p>A stream group to associate to the applications.</p> <p>This value is an <a
5959
* href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html">Amazon
6060
* Resource Name (ARN)</a> or ID that uniquely identifies the stream group
61-
* resource. Format example:
62-
* ARN-<code>arn:aws:gameliftstreams:us-west-2:123456789012:streamgroup/sg-1AB2C3De4</code>
63-
* or ID-<code>sg-1AB2C3De4</code>. </p>
61+
* resource. Example ARN:
62+
* <code>arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4</code>.
63+
* Example ID: <code>sg-1AB2C3De4</code>. </p>
6464
*/
6565
inline const Aws::String& GetIdentifier() const { return m_identifier; }
6666
inline bool IdentifierHasBeenSet() const { return m_identifierHasBeenSet; }

generated/src/aws-cpp-sdk-gameliftstreams/include/aws/gameliftstreams/model/AssociateApplicationsResult.h

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -36,12 +36,12 @@ namespace Model
3636
///@{
3737
/**
3838
* <p>A set of applications that are associated to the stream group.</p> <p>This
39-
* value is a set of either <a
39+
* value is a set of <a
4040
* href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html">Amazon
41-
* Resource Names (ARN)</a> or IDs that uniquely identify application resources.
42-
* Format example:
43-
* ARN-<code>arn:aws:gameliftstreams:us-west-2:123456789012:application/a-9ZY8X7Wv6</code>
44-
* or ID-<code>a-9ZY8X7Wv6</code>. </p>
41+
* Resource Names (ARNs)</a> that uniquely identify application resources. Example
42+
* ARN:
43+
* <code>arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6</code>.
44+
* </p>
4545
*/
4646
inline const Aws::Vector<Aws::String>& GetApplicationArns() const { return m_applicationArns; }
4747
template<typename ApplicationArnsT = Aws::Vector<Aws::String>>
@@ -54,13 +54,13 @@ namespace Model
5454

5555
///@{
5656
/**
57-
* <p>A stream group that is associated to the applications.</p> <p>This value is a
58-
* <a
57+
* <p>A stream group that is associated to the applications.</p> <p>This value is
58+
* an <a
5959
* href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html">Amazon
60-
* Resource Name (ARN)</a> or ID that uniquely identifies the stream group
61-
* resource. Format example:
62-
* ARN-<code>arn:aws:gameliftstreams:us-west-2:123456789012:streamgroup/sg-1AB2C3De4</code>
63-
* or ID-<code>sg-1AB2C3De4</code>. </p>
60+
* Resource Name (ARN)</a> that uniquely identifies the stream group resource.
61+
* Example ARN:
62+
* <code>arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4</code>.
63+
* </p>
6464
*/
6565
inline const Aws::String& GetArn() const { return m_arn; }
6666
template<typename ArnT = Aws::String>

generated/src/aws-cpp-sdk-gameliftstreams/include/aws/gameliftstreams/model/CreateApplicationRequest.h

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -42,8 +42,10 @@ namespace Model
4242
* save application logs. Required if you specify one or more
4343
* <code>ApplicationLogPaths</code>.</p> <p>The log bucket must have
4444
* permissions that give Amazon GameLift Streams access to write the log files. For
45-
* more information, see <b>Getting Started</b> in the Amazon GameLift Streams
46-
* Developer Guide. </p>
45+
* more information, see <a
46+
* href="https://docs.aws.amazon.com/gameliftstreams/latest/developerguide/applications.html#application-bucket-permission-template">Application
47+
* log bucket permission policy</a> in the <i>Amazon GameLift Streams Developer
48+
* Guide</i>.</p>
4749
*/
4850
inline const Aws::String& GetApplicationLogOutputUri() const { return m_applicationLogOutputUri; }
4951
inline bool ApplicationLogOutputUriHasBeenSet() const { return m_applicationLogOutputUriHasBeenSet; }

generated/src/aws-cpp-sdk-gameliftstreams/include/aws/gameliftstreams/model/CreateApplicationResult.h

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -83,8 +83,10 @@ namespace Model
8383

8484
///@{
8585
/**
86-
* <p>An Amazon Resource Name (ARN) that's assigned to an application resource and
87-
* uniquely identifies it across all Amazon Web Services Regions. Format is
86+
* <p>The <a
87+
* href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html">Amazon
88+
* Resource Name (ARN)</a> that's assigned to an application resource and uniquely
89+
* identifies it across all Amazon Web Services Regions. Format is
8890
* <code>arn:aws:gameliftstreams:[AWS Region]:[AWS account]:application/[resource
8991
* ID]</code>.</p>
9092
*/
@@ -147,12 +149,8 @@ namespace Model
147149

148150
///@{
149151
/**
150-
* <p>An <a
151-
* href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html">Amazon
152-
* Resource Name (ARN)</a> or ID that uniquely identifies the application resource.
153-
* Format example:
154-
* ARN-<code>arn:aws:gameliftstreams:us-west-2:123456789012:application/a-9ZY8X7Wv6</code>
155-
* or ID-<code>a-9ZY8X7Wv6</code>. </p>
152+
* <p>A unique ID value that is assigned to the resource when it's created. Format
153+
* example: <code>a-9ZY8X7Wv6</code>.</p>
156154
*/
157155
inline const Aws::String& GetId() const { return m_id; }
158156
template<typename IdT = Aws::String>

0 commit comments

Comments
 (0)