awscli 1.40.34__py3-none-any.whl → 1.40.37__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
awscli/__init__.py CHANGED
@@ -18,7 +18,7 @@ A Universal Command Line Environment for Amazon Web Services.
18
18
 
19
19
  import os
20
20
 
21
- __version__ = '1.40.34'
21
+ __version__ = '1.40.37'
22
22
 
23
23
  #
24
24
  # Get our data path to be added to botocore's search path
@@ -34,7 +34,8 @@ Output::
34
34
  "recordingReconnectWindowSeconds": 0,
35
35
  "hlsConfiguration": {
36
36
  "targetSegmentDurationSeconds": 6
37
- }
37
+ },
38
+ "recordParticipantReplicas": true
38
39
  },
39
40
  "endpoints": {
40
41
  "events": "wss://global.events.live-video.net",
@@ -79,7 +80,8 @@ Output::
79
80
  "recordingReconnectWindowSeconds": 100,
80
81
  "hlsConfiguration": {
81
82
  "targetSegmentDurationSeconds": 5
82
- }
83
+ },
84
+ "recordParticipantReplicas": true
83
85
  },
84
86
  "endpoints": {
85
87
  "events": "wss://global.events.live-video.net",
@@ -124,7 +126,8 @@ Output::
124
126
  "recordingReconnectWindowSeconds": 0,
125
127
  "hlsConfiguration": {
126
128
  "targetSegmentDurationSeconds": 6
127
- }
129
+ },
130
+ "recordParticipantReplicas": true
128
131
  },
129
132
  "endpoints": {
130
133
  "events": "wss://global.events.live-video.net",
@@ -1,31 +1,99 @@
1
- **To get a stage participant**
2
-
3
- The following ``get-participant`` example gets the stage participant for a specified participant ID and session ID in the specified stage ARN (Amazon Resource Name). ::
4
-
5
- aws ivs-realtime get-participant \
6
- --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
7
- --session-id st-a1b2c3d4e5f6g \
8
- --participant-id abCDEf12GHIj
9
-
10
- Output::
11
-
12
- {
13
- "participant": {
14
- "browserName", "Google Chrome",
15
- "browserVersion", "116",
16
- "firstJoinTime": "2023-04-26T20:30:34+00:00",
17
- "ispName", "Comcast",
18
- "osName", "Microsoft Windows 10 Pro",
19
- "osVersion", "10.0.19044"
20
- "participantId": "abCDEf12GHIj",
21
- "published": true,
22
- "recordingS3BucketName": "bucket-name",
23
- "recordingS3Prefix": "abcdABCDefgh/st-a1b2c3d4e5f6g/abCDEf12GHIj/1234567890",
24
- "recordingState": "ACTIVE",
25
- "sdkVersion", "",
26
- "state": "CONNECTED",
27
- "userId": "",
28
- }
29
- }
30
-
31
- For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon Interactive Video Service User Guide*.
1
+ **Example 1: To get a stage participant**
2
+
3
+ The following ``get-participant`` example gets the stage participant for a specified participant ID and session ID in the specified stage ARN (Amazon Resource Name). ::
4
+
5
+ aws ivs-realtime get-participant \
6
+ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
7
+ --session-id st-a1b2c3d4e5f6g \
8
+ --participant-id abCDEf12GHIj
9
+
10
+ Output::
11
+
12
+ {
13
+ "participant": {
14
+ "browserName": "Google Chrome",
15
+ "browserVersion": "116",
16
+ "firstJoinTime": "2023-04-26T20:30:34+00:00",
17
+ "ispName": "Comcast",
18
+ "osName": "Microsoft Windows 10 Pro",
19
+ "osVersion": "10.0.19044",
20
+ "participantId": "abCDEf12GHIj",
21
+ "published": true,
22
+ "recordingS3BucketName": "bucket-name",
23
+ "recordingS3Prefix": "abcdABCDefgh/st-a1b2c3d4e5f6g/abCDEf12GHIj/1234567890",
24
+ "recordingState": "ACTIVE",
25
+ "sdkVersion": "",
26
+ "state": "CONNECTED",
27
+ "userId": ""
28
+ }
29
+ }
30
+
31
+ For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon IVS Low-Latency Streaming User Guide*.
32
+
33
+ **Example 2: To get a stage participant that has been replicated to another stage**
34
+
35
+ The following ``get-participant`` example gets the stage participant for a specified participant ID and session ID in the specified stage ARN (Amazon Resource Name), when the participant has also been replicated to another stage. ::
36
+
37
+ aws ivs-realtime get-participant \
38
+ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
39
+ --session-id st-a1b2c3d4e5f6g \
40
+ --participant-id abCDEf12GHIj
41
+
42
+ Output::
43
+
44
+ {
45
+ "participant": {
46
+ "browserName": "Google Chrome",
47
+ "browserVersion": "116",
48
+ "firstJoinTime": "2023-04-26T20:30:34+00:00",
49
+ "ispName": "Comcast",
50
+ "osName": "Microsoft Windows 10 Pro",
51
+ "osVersion": "10.0.19044",
52
+ "participantId": "abCDEf12GHIj",
53
+ "published": true,
54
+ "recordingS3BucketName": "bucket-name",
55
+ "recordingS3Prefix": "abcdABCDefgh/st-a1b2c3d4e5f6g/abCDEf12GHIj/1234567890",
56
+ "recordingState": "ACTIVE",
57
+ "replicationState": "ACTIVE",
58
+ "replicationType": "SOURCE",
59
+ "sdkVersion": "",
60
+ "state": "CONNECTED",
61
+ "userId": ""
62
+ }
63
+ }
64
+
65
+ For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon IVS Low-Latency Streaming User Guide*.
66
+
67
+ **Example 3: To get a stage participant that has been replicated from another stage**
68
+
69
+ The following ``get-participant`` example gets the stage participant for a specified participant ID and session ID in the specified stage ARN (Amazon Resource Name), when the participant has been replicated from another stage. ::
70
+
71
+ aws ivs-realtime get-participant \
72
+ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
73
+ --session-id st-a1b2c3d4e5f6g \
74
+ --participant-id abCDEf12GHIj
75
+
76
+ Output::
77
+
78
+ {
79
+ "participant": {
80
+ "browserName": "Google Chrome",
81
+ "browserVersion": "116",
82
+ "firstJoinTime": "2023-04-26T20:30:34+00:00",
83
+ "ispName": "Comcast",
84
+ "osName": "Microsoft Windows 10 Pro",
85
+ "osVersion": "10.0.19044",
86
+ "participantId": "abCDEf12GHIj",
87
+ "published": true,
88
+ "recordingS3BucketName": "bucket-name",
89
+ "recordingS3Prefix": "abcdABCDefgh/st-a1b2c3d4e5f6g/abCDEf12GHIj/1234567890",
90
+ "recordingState": "ACTIVE",
91
+ "replicationState": "ACTIVE",
92
+ "replicationType": "REPLICA",
93
+ "sdkVersion": "",
94
+ "state": "CONNECTED",
95
+ "userId": ""
96
+ }
97
+ }
98
+
99
+ For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon IVS Low-Latency Streaming User Guide*.
@@ -21,12 +21,13 @@ Output::
21
21
  "storage": [
22
22
  "SEQUENTIAL"
23
23
  ],
24
- "recordingMode": "DISABLED",
24
+ "recordingMode": "DISABLED"
25
25
  },
26
26
  "recordingReconnectWindowSeconds": 0,
27
27
  "hlsConfiguration": {
28
28
  "targetSegmentDurationSeconds": 6
29
- }
29
+ },
30
+ "recordParticipantReplicas": true
30
31
  },
31
32
  "endpoints": {
32
33
  "events": "wss://global.events.live-video.net",
@@ -1,4 +1,4 @@
1
- **To get a list of stage participant events**
1
+ **Example 1: To get a list of stage participant events**
2
2
 
3
3
  The following ``list-participant-events`` example lists all participant events for a specified participant ID and session ID of a specified stage ARN (Amazon Resource Name). ::
4
4
 
@@ -34,4 +34,56 @@ Output::
34
34
  ]
35
35
  }
36
36
 
37
- For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html>`__ in the *Amazon Interactive Video Service User Guide*.
37
+ For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon IVS Low-Latency Streaming User Guide*.
38
+
39
+ **Example 2: To get a list of stage participant events, including participant replication stop and start**
40
+
41
+ The following ``list-participant-events`` example lists all participant events for a specified session ID of a specified stage ARN (Amazon Resource Name), where a participant is replicated to another stage. ::
42
+
43
+ aws ivs-realtime list-participant-events \
44
+ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
45
+ --session-id st-a1b2c3d4e5f6g \
46
+ --participant-id abCDEf12GHIj
47
+
48
+ Output::
49
+
50
+ {
51
+ "events": [
52
+ {
53
+ "eventTime": "2025-04-26T20:36:28+00:00",
54
+ "name": "LEFT",
55
+ "participantId": "abCDEf12GHIj"
56
+ },
57
+ {
58
+ "eventTime": "2025-04-26T20:36:28+00:00",
59
+ "name": "PUBLISH_STOPPED",
60
+ "participantId": "abCDEf12GHIj"
61
+ },
62
+ {
63
+ "eventTime": "2025-04-26T20:30:34+00:00",
64
+ "name": "JOINED",
65
+ "participantId": "abCDEf12GHIj"
66
+ },
67
+ {
68
+ "eventTime": "2025-04-26T20:30:34+00:00",
69
+ "name": "PUBLISH_STARTED",
70
+ "participantId": "abCDEf12GHIj"
71
+ },
72
+ {
73
+ "name": "REPLICATION_STARTED",
74
+ "participantId": "abCDEf12GHIj",
75
+ "eventTime": "2025-04-26T20:30:34+00:00",
76
+ "destinationStageArn": "arn:aws:ivs:us-west-2:12345678901:stage/ABCDabcdefgh",
77
+ "destinationSessionId": "st-b1c2d3e4f5g6a"
78
+ },
79
+ {
80
+ "name": "REPLICATION_STOPPED",
81
+ "participantId": "abCDEf12GHIj",
82
+ "eventTime": "2025-04-26T20:32:34+00:00",
83
+ "destinationStageArn": "arn:aws:ivs:us-west-2:12345678901:stage/ABCDabcdefgh",
84
+ "destinationSessionId": "st-b1c2d3e4f5g6a"
85
+ }
86
+ ]
87
+ }
88
+
89
+ For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon IVS Low-Latency Streaming User Guide*.
@@ -0,0 +1,24 @@
1
+ **To get a list of stage participant replicas**
2
+
3
+ The following ``list-participant-replicas`` example lists all stage participants replicated from the specified source stage ARN (Amazon Resource Name) to another stage. ::
4
+
5
+ aws ivs-realtime list-participant-replicas \
6
+ --source-stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
7
+ --participant-id abCDEf12GHIj
8
+
9
+ Output::
10
+
11
+ {
12
+ "replicas": [
13
+ {
14
+ "sourceStageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
15
+ "participantId": "abCDEf12GHIj",
16
+ "sourceSessionId": "st-a1b2c3d4e5f6g",
17
+ "destinationStageArn": "arn:aws:ivs:us-west-2:012345678901:stage/ABCDabcdefgh",
18
+ "destinationSessionId": "st-b1c2d3e4f5g6a",
19
+ "replicationState": "ACTIVE"
20
+ }
21
+ ]
22
+ }
23
+
24
+ For more information, see `IVS Participant Replication <https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-participant-replication.html>`__ in the *Amazon IVS Real-Time Streaming User Guide*.
@@ -1,4 +1,4 @@
1
- **To get a list of stage participants**
1
+ **Example 1: To get a list of stage participants**
2
2
 
3
3
  The following ``list-participants`` example lists all participants for a specified session ID of a specified stage ARN (Amazon Resource Name). ::
4
4
 
@@ -12,7 +12,7 @@ Output::
12
12
  "participants": [
13
13
  {
14
14
  "firstJoinTime": "2023-04-26T20:30:34+00:00",
15
- "participantId": "abCDEf12GHIj"
15
+ "participantId": "abCDEf12GHIj",
16
16
  "published": true,
17
17
  "recordingState": "STOPPED",
18
18
  "state": "DISCONNECTED",
@@ -21,4 +21,62 @@ Output::
21
21
  ]
22
22
  }
23
23
 
24
- For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon Interactive Video Service User Guide*.
24
+ For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon IVS Low-Latency Streaming User Guide*.
25
+
26
+ **Example 2: To get a list of stage participants, when a participant has been replicated to another stage**
27
+
28
+ The following ``list-participants`` example lists all participants for a specified session ID of a specified stage ARN (Amazon Resource Name), when a participant has been replicated to another stage. ::
29
+
30
+ aws ivs-realtime list-participants \
31
+ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
32
+ --session-id st-a1b2c3d4e5f6g
33
+
34
+ Output::
35
+
36
+ {
37
+ "participants": [
38
+ {
39
+ "firstJoinTime": "2023-04-26T20:30:34+00:00",
40
+ "participantId": "abCDEf12GHIj",
41
+ "published": true,
42
+ "recordingState": "STOPPED",
43
+ "state": "DISCONNECTED",
44
+ "userId": "",
45
+ "replicationState": "ACTIVE",
46
+ "replicationType": "SOURCE",
47
+ "sourceStageArn": "",
48
+ "sourceSessionId": ""
49
+ }
50
+ ]
51
+ }
52
+
53
+ For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon IVS Low-Latency Streaming User Guide*.
54
+
55
+ **Example 3: To get a list of stage participants, when a participant has been replicated from another stage**
56
+
57
+ The following ``list-participants`` example lists all participants for a specified session ID of a specified stage ARN (Amazon Resource Name), when a participant has been replicated from another stage. ::
58
+
59
+ aws ivs-realtime list-participants \
60
+ --stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
61
+ --session-id st-a1b2c3d4e5f6g
62
+
63
+ Output::
64
+
65
+ {
66
+ "participants": [
67
+ {
68
+ "firstJoinTime": "2023-04-26T20:30:34+00:00",
69
+ "participantId": "abCDEf12GHIj",
70
+ "published": true,
71
+ "recordingState": "STOPPED",
72
+ "state": "DISCONNECTED",
73
+ "userId": "",
74
+ "replicationState": "ACTIVE",
75
+ "replicationType": "REPLICA",
76
+ "sourceStageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
77
+ "sourceSessionId": "st-a1b2c3d4e5f6g"
78
+ }
79
+ ]
80
+ }
81
+
82
+ For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon IVS Low-Latency Streaming User Guide*.
@@ -0,0 +1,24 @@
1
+ **To start replicating a participant from one stage to another stage**
2
+
3
+ The following ``start-participant-replication`` example replicates a participant from a source stage to a destination stage, with each stage specified by its ARN (Amazon Resource Name). ::
4
+
5
+ aws ivs-realtime start-participant-replication \
6
+ --source-stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
7
+ --destination-stage-arn arn:aws:ivs:us-west-2:234567890123:stage/bcdABCDefghi \
8
+ --participant-id abCDEf12GHIj
9
+
10
+ Output::
11
+
12
+ {
13
+ "accessControlAllowOrigin": "*",
14
+ "accessControlExposeHeaders": "Access-Control-Allow-Origin,Access-Control-Expose-Headers,Cache-Control,Content-Length, \
15
+ Content-Security-Policy,Content-Type,date,Strict-Transport-Security,x-amz-apigw-id,x-amzn-errormessage,x-amzn-errortype, \
16
+ x-amzn-requestid,x-amzn-trace-id,X-Content-Type-Options,X-Frame-Options",
17
+ "cacheControl": "no-store, no-cache",
18
+ "contentSecurityPolicy": "default-src 'self'; upgrade-insecure-requests;",
19
+ "strictTransportSecurity": "max-age:47304000; includeSubDomains",
20
+ "xContentTypeOptions": "nosniff",
21
+ "xFrameOptions": "DENY"
22
+ }
23
+
24
+ For more information, see `IVS Participant Replication <https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-participant-replication.html>`__ in the *Amazon IVS Real-Time Streaming User Guide*.
@@ -0,0 +1,24 @@
1
+ **To stop replicating a participant from one stage to another stage**
2
+
3
+ The following ``stop-participant-replication`` example stops replicating a participant from a source stage to a destination stage, with each stage specified by its ARN (Amazon Resource Name). ::
4
+
5
+ aws ivs-realtime stop-participant-replication \
6
+ --source-stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
7
+ --destination-stage-arn arn:aws:ivs:us-west-2:234567890123:stage/bcdABCDefghi \
8
+ --participant-id abCDEf12GHIj
9
+
10
+ Output::
11
+
12
+ {
13
+ "accessControlAllowOrigin": "*",
14
+ "accessControlExposeHeaders": "Access-Control-Allow-Origin,Access-Control-Expose-Headers,Cache-Control,Content-Length, \
15
+ Content-Security-Policy,Content-Type,date,Strict-Transport-Security,x-amz-apigw-id,x-amzn-errormessage,x-amzn-errortype, \
16
+ x-amzn-requestid,x-amzn-trace-id,X-Content-Type-Options,X-Frame-Options",
17
+ "cacheControl": "no-store, no-cache",
18
+ "contentSecurityPolicy": "default-src 'self'; upgrade-insecure-requests;",
19
+ "strictTransportSecurity": "max-age:47304000; includeSubDomains",
20
+ "xContentTypeOptions": "nosniff",
21
+ "xFrameOptions": "DENY"
22
+ }
23
+
24
+ For more information, see `IVS Participant Replication <https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-participant-replication.html>`__ in the *Amazon IVS Real-Time Streaming User Guide*.
@@ -1,4 +1,4 @@
1
- **To update a stage's configuration**
1
+ **Example 1: To update a stage's configuration**
2
2
 
3
3
  The following ``update-stage`` example updates a stage for a specified stage ARN to update the stage name and configure individual participant recording with thumbnail recording enabled. ::
4
4
 
@@ -19,7 +19,7 @@ Output::
19
19
  "AUDIO_VIDEO"
20
20
  ],
21
21
  "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh",
22
- "thumbnailConfiguration": {
22
+ "thumbnailConfiguration": {
23
23
  "targetIntervalSeconds": 60,
24
24
  "storage": [
25
25
  "SEQUENTIAL"
@@ -29,7 +29,55 @@ Output::
29
29
  "recordingReconnectWindowSeconds": 100,
30
30
  "hlsConfiguration": {
31
31
  "targetSegmentDurationSeconds": 5
32
- }
32
+ },
33
+ "recordParticipantReplicas": true
34
+ },
35
+ "endpoints": {
36
+ "events": "wss://global.events.live-video.net",
37
+ "rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
38
+ "rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
39
+ "whip": "https://1a2b3c4d5e6f.global-bm.whip.live-video.net"
40
+ },
41
+ "name": "stage1a",
42
+ "tags": {}
43
+ }
44
+ }
45
+
46
+ For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon IVS Low-Latency Streaming User Guide*.
47
+
48
+ **Example 2: To update a stage's configuration, including disabling participant replica recording**
49
+
50
+ The following ``update-stage`` example updates a stage for a specified stage ARN to update the stage name and configure individual participant recording with thumbnail recording enabled and participant replica recording disabled. ::
51
+
52
+ aws ivs-realtime update-stage \
53
+ --arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
54
+ --auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", "recordingReconnectWindowSeconds": 100, \
55
+ "thumbnailConfiguration": {"recordingMode": "INTERVAL","storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}, "recordParticipantReplicas":false} \
56
+ "hlsConfiguration": {"targetSegmentDurationSeconds": 5}}' \
57
+ --name stage1a
58
+
59
+ Output::
60
+
61
+ {
62
+ "stage": {
63
+ "arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
64
+ "autoParticipantRecordingConfiguration": {
65
+ "mediaTypes": [
66
+ "AUDIO_VIDEO"
67
+ ],
68
+ "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh",
69
+ "thumbnailConfiguration": {
70
+ "targetIntervalSeconds": 60,
71
+ "storage": [
72
+ "SEQUENTIAL"
73
+ ],
74
+ "recordingMode": "INTERVAL"
75
+ },
76
+ "recordingReconnectWindowSeconds": 100,
77
+ "hlsConfiguration": {
78
+ "targetSegmentDurationSeconds": 5
79
+ },
80
+ "recordParticipantReplicas": false
33
81
  },
34
82
  "endpoints": {
35
83
  "events": "wss://global.events.live-video.net",
@@ -1,21 +1,22 @@
1
- **Example 1: To create a static policy**
1
+ **To update a static policy**
2
2
 
3
- The following ``create-policy`` example creates a static policy with a policy scope that specifies both a principal and a resource. ::
3
+ The following ``update-policy`` example modifies an existing static policy by updating its description and statement. ::
4
4
 
5
- aws verifiedpermissions create-policy \
6
- --definition file://definition.txt \
5
+ aws verifiedpermissions update-policy \
6
+ --policy-id SPEXAMPLEabcdefg111111 \
7
+ --definition file://updated-definition.txt \
7
8
  --policy-store-id PSEXAMPLEabcdefg111111
8
9
 
9
10
  The ``statement`` parameter takes a string representation of a JSON object. It contains embedded quotation marks (") within the outermost quotation mark pair. This requires you to convert the JSON to a string by preceding all embedded quotation marks with a backslash character ( \" ) and combining all lines into a single text line with no line breaks.
10
11
 
11
- Example strings can be displayed wrapped across multiple lines here for readability, but the operation requires the parameters be submitted as single line strings.
12
+ You can display example strings wrapped across multiple lines for readability, but the operation requires the parameters to be submitted as single-line strings.
12
13
 
13
- Contents of file ``definition.txt``::
14
+ Contents of file ``updated-definition.txt``::
14
15
 
15
16
  {
16
17
  "static": {
17
- "description": "Grant everyone of janeFriends UserGroup access to the vacationFolder Album",
18
- "statement": "permit(principal in UserGroup::\"janeFriends\", action, resource in Album::\"vacationFolder\" );"
18
+ "description": "Updated policy to grant janeFriends UserGroup access to the vacationFolder Album with view action only",
19
+ "statement": "permit(principal in UserGroup::\"janeFriends\", action == Action::\"view\", resource in Album::\"vacationFolder\" );"
19
20
  }
20
21
  }
21
22
 
@@ -37,73 +38,4 @@ Output::
37
38
  }
38
39
  }
39
40
 
40
- **Example 2: To create a static policy that grants access to a resource to everyone**
41
-
42
- The following ``create-policy`` example creates a static policy with a policy scope that specifies only a resource. ::
43
-
44
- aws verifiedpermissions create-policy \
45
- --definition file://definition2.txt \
46
- --policy-store-id PSEXAMPLEabcdefg111111
47
-
48
- Contents of file ``definition2.txt``::
49
-
50
- {
51
- "static": {
52
- "description": "Grant everyone access to the publicFolder Album",
53
- "statement": "permit(principal, action, resource in Album::\"publicFolder\");"
54
- }
55
- }
56
-
57
- Output::
58
-
59
- {
60
- "createdDate": "2023-06-12T20:39:44.975897+00:00",
61
- "lastUpdatedDate": "2023-06-12T20:39:44.975897+00:00",
62
- "policyId": "PbfR73F8oh5MMfr9uRtFDB",
63
- "policyStoreId": "PSEXAMPLEabcdefg222222",
64
- "policyType": "STATIC",
65
- "resource": {
66
- "entityId": "publicFolder",
67
- "entityType": "Album"
68
- }
69
- }
70
-
71
- **Example 3: To create a template-linked policy that is associated with the specified template**
72
-
73
- The following ``create-policy`` example creates a template-linked policy using the specified policy template and associates the specified principal to use with the new template-linked policy. ::
74
-
75
- aws verifiedpermissions create-policy \
76
- --definition file://definition2.txt \
77
- --policy-store-id PSEXAMPLEabcdefg111111
78
-
79
- Contents of definition3.txt::
80
-
81
- {
82
- "templateLinked": {
83
- "policyTemplateId": "PTEXAMPLEabcdefg111111",
84
- "principal": {
85
- "entityType": "User",
86
- "entityId": "alice"
87
- }
88
- }
89
- }
90
-
91
- Output::
92
-
93
- {
94
- "createdDate": "2023-06-12T20:49:51.490211+00:00",
95
- "lastUpdatedDate": "2023-06-12T20:49:51.490211+00:00",
96
- "policyId": "TPEXAMPLEabcdefg111111",
97
- "policyStoreId": "PSEXAMPLEabcdefg111111",
98
- "policyType": "TEMPLATE_LINKED",
99
- "principal": {
100
- "entityId": "alice",
101
- "entityType": "User"
102
- },
103
- "resource": {
104
- "entityId": "VacationPhoto94.jpg",
105
- "entityType": "Photo"
106
- }
107
- }
108
-
109
- For more information about policies, see `Amazon Verified Permissions policies <https://docs.aws.amazon.com/verifiedpermissions/latest/userguide/policies.html>`__ in the *Amazon Verified Permissions User Guide*.
41
+ For more information about policies, see `Amazon Verified Permissions policies <https://docs.aws.amazon.com/verifiedpermissions/latest/userguide/policies.html>`__ in the *Amazon Verified Permissions User Guide*.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: awscli
3
- Version: 1.40.34
3
+ Version: 1.40.37
4
4
  Summary: Universal Command Line Environment for AWS.
5
5
  Home-page: http://aws.amazon.com/cli/
6
6
  Author: Amazon Web Services
@@ -22,7 +22,7 @@ Classifier: Programming Language :: Python :: 3.11
22
22
  Classifier: Programming Language :: Python :: 3.12
23
23
  Requires-Python: >= 3.9
24
24
  License-File: LICENSE.txt
25
- Requires-Dist: botocore (==1.38.35)
25
+ Requires-Dist: botocore (==1.38.38)
26
26
  Requires-Dist: docutils (<=0.19,>=0.18.1)
27
27
  Requires-Dist: s3transfer (<0.14.0,>=0.13.0)
28
28
  Requires-Dist: PyYAML (<6.1,>=3.10)
@@ -1,4 +1,4 @@
1
- awscli/__init__.py,sha256=ak5dmoBQUM7tLkk6wDhbhqRxcyQ9N5mn_vpGm1Uo3uI,1534
1
+ awscli/__init__.py,sha256=4gusl6saWaAbYDKCSHZlJBeNZFEsgXBUnQuCraA1_dY,1534
2
2
  awscli/__main__.py,sha256=iBjOg0tBxNlhzTi_tyc1G0SMGBvHMVvBJzX3JqYaooY,662
3
3
  awscli/alias.py,sha256=Jj2jetpajUMcjqx9tFhHUOKpzLChQygnH2zqDFfmgIM,11315
4
4
  awscli/argparser.py,sha256=3Pxx-vWytdV985Y6MIl9DeutUXyehIvACIs_PDby8GI,7650
@@ -3783,7 +3783,7 @@ awscli/examples/ivs/update-playback-restriction-policy.rst,sha256=2oT1pzQ2yZm_ug
3783
3783
  awscli/examples/ivs-realtime/create-encoder-configuration.rst,sha256=OGhUNFLELIum90i2w2aRFzlz0M1wox50viRghjtwx6E,945
3784
3784
  awscli/examples/ivs-realtime/create-ingest-configuration.rst,sha256=hgUkA35ndX5qTwaU50BCB2d-vjfuyFG9Nf_bWGBXYBE,970
3785
3785
  awscli/examples/ivs-realtime/create-participant-token.rst,sha256=DoMHgPlpIeHOfAYLFAUsjIdk6Ch4N_hj7iv9zKT34YE,733
3786
- awscli/examples/ivs-realtime/create-stage.rst,sha256=mMj8DqRigpCHUO6RUa_oDAZadBLWncjPOCZCy2-4pCw,6238
3786
+ awscli/examples/ivs-realtime/create-stage.rst,sha256=A47zT5ImqtlQCeDqRf4gBHxc5uwtJ1eHveMRQ-u6Moc,6394
3787
3787
  awscli/examples/ivs-realtime/create-storage-configuration.rst,sha256=jROuGgWS5gahvEAjNH-vQRuatFujx0YkVF9p9eeCPao,818
3788
3788
  awscli/examples/ivs-realtime/delete-encoder-configuration.rst,sha256=iBW9aWaEkxNXr-nuTmua-W7o3JywCqTV77k2ApNE3JU,598
3789
3789
  awscli/examples/ivs-realtime/delete-ingest-configuration.rst,sha256=GY2DBx7T6iAk4REol9XgWoNQzoxUp7S86n9qfb_9N5Q,1248
@@ -3794,25 +3794,28 @@ awscli/examples/ivs-realtime/disconnect-participant.rst,sha256=0FzAdsDfk6maR-5Kz
3794
3794
  awscli/examples/ivs-realtime/get-composition.rst,sha256=rV0Gi8GkNziMgKah1JISJy64e0OMv_atIyGklPSxoPw,9705
3795
3795
  awscli/examples/ivs-realtime/get-encoder-configuration.rst,sha256=UlFBxJkjqm79EmRe2IYTwTEbaDis2Rsfbfi44whBaew,961
3796
3796
  awscli/examples/ivs-realtime/get-ingest-configuration.rst,sha256=dpMcDCO171N5ik_o9ZS6-5lmjWs6bSNq6ebGxNnZiAI,1036
3797
- awscli/examples/ivs-realtime/get-participant.rst,sha256=xuvghN9G-Psqh0_8Vl1UQoE8oXU0Vv_c5z9DPrIe2bw,1305
3797
+ awscli/examples/ivs-realtime/get-participant.rst,sha256=MuYMyQG6ssHH0puNX0A_kWvLDBerdI4uyeMeygU2fM0,4241
3798
3798
  awscli/examples/ivs-realtime/get-public-key.rst,sha256=6IKGMrNEBP3GiMBt81bEj5QKNnPnpuumEFZxutpUVXo,1063
3799
3799
  awscli/examples/ivs-realtime/get-stage-session.rst,sha256=pJ0kkZ0rnij75BePAoEX8DfZtx5Ny0fel1MfbZNnGwE,767
3800
- awscli/examples/ivs-realtime/get-stage.rst,sha256=bHp5H3GaWG9NZQyZrrM0lPSCg-oeY1eyHVqh0OfF_QI,1747
3800
+ awscli/examples/ivs-realtime/get-stage.rst,sha256=CC2DuKrjYxHx2jmMPYk4F55eMidlFAY1ssrf6LjfBg4,1798
3801
3801
  awscli/examples/ivs-realtime/get-storage-configuration.rst,sha256=uHrub2sy3HtO0qtKUAhTVNOy9dQU18qMck8L4U9iBCg,861
3802
3802
  awscli/examples/ivs-realtime/import-public-key.rst,sha256=5eiDsux84FHS-PdTtfKZpliebRfpwBXyum830u8g0KA,1059
3803
3803
  awscli/examples/ivs-realtime/list-compositions.rst,sha256=GyMNnF8wH8FX9GaRs-F3BwerQ2ehrfIcd2QiDYJ1wpA,2095
3804
3804
  awscli/examples/ivs-realtime/list-encoder-configurations.rst,sha256=VGZQ4VqBZOAVQGvoz4g0-EKF12wCj-VLQjd4z0pTXio,961
3805
3805
  awscli/examples/ivs-realtime/list-ingest-configurations.rst,sha256=N7TxxPzabyTdGl4oNziSlffNWKRZEU4o_pz6E5pjReo,967
3806
- awscli/examples/ivs-realtime/list-participant-events.rst,sha256=j9JE-6Z3XZB9dVC4oBGUd_MozKZVBOyMomn6Kyj--Q0,1409
3807
- awscli/examples/ivs-realtime/list-participants.rst,sha256=0L8tYEqfkPX4DVSonoHpdUmpv7Um6dZtmdIPcvYoyRI,926
3806
+ awscli/examples/ivs-realtime/list-participant-events.rst,sha256=3UvzHya0rh9iTV6B_3-3V0zGxc-Z4vf2KNHHHYuSfqU,3635
3807
+ awscli/examples/ivs-realtime/list-participant-replicas.rst,sha256=LXbDpnMPugjm6MU596MImz1Igc4FU4HKFb9kfjBGIyk,1095
3808
+ awscli/examples/ivs-realtime/list-participants.rst,sha256=Sgwnulow1DhvueS9kHjf7KPFHHwpqZERRZB58SeHrnA,3468
3808
3809
  awscli/examples/ivs-realtime/list-public-keys.rst,sha256=wx77x9UdpYuOc6PlsnxNyHLgiJWgiFAceQ19xWdi14s,914
3809
3810
  awscli/examples/ivs-realtime/list-stage-sessions.rst,sha256=aITzBqMZFT7kMUJM3ew75_6LICXhcs4357xTorSC-MM,752
3810
3811
  awscli/examples/ivs-realtime/list-stages.rst,sha256=dY0QFXeBOvTsiuarz1L6fvGcSendbfnRkIdYnkhzTLE,1188
3811
3812
  awscli/examples/ivs-realtime/list-storage-configurations.rst,sha256=T7shNCEt2zzU1DsiGRAh82ygKe2TcJSFjgcSkKGBGBE,1140
3812
3813
  awscli/examples/ivs-realtime/start-composition.rst,sha256=niKnGvzYo68FWbZD5jzS2146MkD69rmdIyQcFMwnR6w,11129
3814
+ awscli/examples/ivs-realtime/start-participant-replication.rst,sha256=N6OwNVAp0UYT7jgkG-YV40b3AAhRQ4v0V-d644vzPhg,1431
3813
3815
  awscli/examples/ivs-realtime/stop-composition.rst,sha256=XuZfFAGhX0wwlkAPvQO6V0_iX1syG58M5U0WgH5LXi4,516
3816
+ awscli/examples/ivs-realtime/stop-participant-replication.rst,sha256=jNKkjrt2ATTN9rZj-fyxs8pfHoA79dzEOxJKCgXMB_E,1435
3814
3817
  awscli/examples/ivs-realtime/update-ingest-configuration.rst,sha256=f047K4leqfd3zA5M8BXaxSXJRySOBA173FHAWb1Qvzc,1128
3815
- awscli/examples/ivs-realtime/update-stage.rst,sha256=ALz6U_o9E6bM7amiyu4Pw9wObo_u3kD5QAVodEe0WmA,2286
3818
+ awscli/examples/ivs-realtime/update-stage.rst,sha256=cf7s0quz4G5LXYIpkpTyWd_PDoLdu1MwyoSJTygduPc,4830
3816
3819
  awscli/examples/ivschat/create-chat-token.rst,sha256=uFDRjsm8qOcqLMKUXHV8gmv41niAfkUgL7Cv7KLoeKI,995
3817
3820
  awscli/examples/ivschat/create-logging-configuration.rst,sha256=HElBp4vPHm3-3Bs7c12GLM_6GxheyZKbEkv2ZrzcpNY,1153
3818
3821
  awscli/examples/ivschat/create-room.rst,sha256=7Zg0NTGzXli-cXgNRkKcx1c9C-nVVxi3KpajeQK_irw,1042
@@ -5914,7 +5917,7 @@ awscli/examples/verifiedpermissions/put-schema.rst,sha256=9wt_WHYVVbI8J-8T1d_13N
5914
5917
  awscli/examples/verifiedpermissions/update-identity-source.rst,sha256=WJn3Z-TcsAYzJefcNE2scAvuNwvbxZw0p-YoUi4OtVI,1266
5915
5918
  awscli/examples/verifiedpermissions/update-policy-store.rst,sha256=4qlUei_CJjVwvGmzBBAAYcqdnerixJJ8BREzcJt-p0k,803
5916
5919
  awscli/examples/verifiedpermissions/update-policy-template.rst,sha256=SmJ7yrzZDWBNjP7L85O7dSznHXOqkF3t2f9JQMDE0y8,1034
5917
- awscli/examples/verifiedpermissions/update-policy.rst,sha256=q3pvrJnU7-RzDEJhYtUMYW0HHU6--k9cR-5USjhWXgU,4018
5920
+ awscli/examples/verifiedpermissions/update-policy.rst,sha256=hZ2KHbLpmc5zTlj_I6EjSpQZWr9xGfmV1V9ad1Omgds,1934
5918
5921
  awscli/examples/vpc-lattice/create-listener.rst,sha256=3kFCCfGxLTHMW5WVxq5dvwELN5VbqYCAeOm74xB9plQ,1546
5919
5922
  awscli/examples/vpc-lattice/create-resource-configuration.rst,sha256=gTDYcft8zJ7_8a4XjUyKHNDajcO3vSryjoIaAl0P4dg,1247
5920
5923
  awscli/examples/vpc-lattice/create-resource-gateway.rst,sha256=DBpM4NiEMmZnjWtUP92CJFZd5OTkVmthimnYT0LLPyY,983
@@ -6129,13 +6132,13 @@ awscli/topics/return-codes.rst,sha256=d9lpNFZwD75IiYcDEADQzu-4QiR8P28UPHkrNwPV5J
6129
6132
  awscli/topics/s3-config.rst,sha256=5EIVd4ggLBHtzjtHFvQp9hY415yMGZiG7S_rO9qy2t0,11663
6130
6133
  awscli/topics/s3-faq.rst,sha256=9qO0HFI6F9hx1wVEUDl8Jy6yoCUd9zbtv-Z0Re4dsiw,2934
6131
6134
  awscli/topics/topic-tags.json,sha256=6lUSrs3FKCZNRSQMnjcXNgWyRNGjZIeur1988a4IO5o,1577
6132
- awscli-1.40.34.data/scripts/aws,sha256=r24FExgs0-JjILTQ3XZAqXBYE4SV6UMTtALkLGAj86g,805
6133
- awscli-1.40.34.data/scripts/aws.cmd,sha256=s46DkC6LNgX63CIkzxxbPnFMJ6DRDBkvc88GnWa8Pvg,1432
6134
- awscli-1.40.34.data/scripts/aws_bash_completer,sha256=RRpoEGJRagRzyHZKZZOwpltuVYv2EoiZsdXhmyWPZ54,204
6135
- awscli-1.40.34.data/scripts/aws_completer,sha256=oC9kuMDlWE47dWk_4xjPde2PQvN-M0vND0J4YSLabVQ,1126
6136
- awscli-1.40.34.data/scripts/aws_zsh_completer.sh,sha256=Qm6Z8ejNAMzpJjaT0pzqxbSDT2zxdmzVe5haRA7qLoc,1808
6137
- awscli-1.40.34.dist-info/LICENSE.txt,sha256=o5XhFlwu0OK_BBrijlKCRa7dQAm36UrUB3gCV_cEr8E,549
6138
- awscli-1.40.34.dist-info/METADATA,sha256=XIS_e0X-fO0kJAJkZi84h2nlMnKVgr28D2IXrzeBMPI,11055
6139
- awscli-1.40.34.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
6140
- awscli-1.40.34.dist-info/top_level.txt,sha256=vt9wXFr1_nGYK6abhJgt6zY3fULe4JSZedm_5XOM9S0,7
6141
- awscli-1.40.34.dist-info/RECORD,,
6135
+ awscli-1.40.37.data/scripts/aws,sha256=r24FExgs0-JjILTQ3XZAqXBYE4SV6UMTtALkLGAj86g,805
6136
+ awscli-1.40.37.data/scripts/aws.cmd,sha256=s46DkC6LNgX63CIkzxxbPnFMJ6DRDBkvc88GnWa8Pvg,1432
6137
+ awscli-1.40.37.data/scripts/aws_bash_completer,sha256=RRpoEGJRagRzyHZKZZOwpltuVYv2EoiZsdXhmyWPZ54,204
6138
+ awscli-1.40.37.data/scripts/aws_completer,sha256=oC9kuMDlWE47dWk_4xjPde2PQvN-M0vND0J4YSLabVQ,1126
6139
+ awscli-1.40.37.data/scripts/aws_zsh_completer.sh,sha256=Qm6Z8ejNAMzpJjaT0pzqxbSDT2zxdmzVe5haRA7qLoc,1808
6140
+ awscli-1.40.37.dist-info/LICENSE.txt,sha256=o5XhFlwu0OK_BBrijlKCRa7dQAm36UrUB3gCV_cEr8E,549
6141
+ awscli-1.40.37.dist-info/METADATA,sha256=q7450KqO4mR5Siyk33iL2Uid9wwp_njBZF0JhyaYvrw,11055
6142
+ awscli-1.40.37.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
6143
+ awscli-1.40.37.dist-info/top_level.txt,sha256=vt9wXFr1_nGYK6abhJgt6zY3fULe4JSZedm_5XOM9S0,7
6144
+ awscli-1.40.37.dist-info/RECORD,,
File without changes