cdk-comprehend-s3olap 2.0.130 → 2.0.132

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.
Files changed (48) hide show
  1. package/.jsii +3 -3
  2. package/lib/cdk-comprehend-s3olap.js +2 -2
  3. package/lib/comprehend-lambdas.js +2 -2
  4. package/lib/iam-roles.js +4 -4
  5. package/node_modules/aws-sdk/CHANGELOG.md +23 -1
  6. package/node_modules/aws-sdk/README.md +1 -1
  7. package/node_modules/aws-sdk/apis/chime-2018-05-01.min.json +32 -28
  8. package/node_modules/aws-sdk/apis/chime-sdk-media-pipelines-2021-07-15.min.json +2 -1
  9. package/node_modules/aws-sdk/apis/chime-sdk-meetings-2021-07-15.min.json +3 -1
  10. package/node_modules/aws-sdk/apis/comprehend-2017-11-27.min.json +181 -154
  11. package/node_modules/aws-sdk/apis/connect-2017-08-08.min.json +239 -199
  12. package/node_modules/aws-sdk/apis/fms-2018-01-01.min.json +245 -95
  13. package/node_modules/aws-sdk/apis/fms-2018-01-01.paginators.json +12 -0
  14. package/node_modules/aws-sdk/apis/guardduty-2017-11-28.min.json +106 -53
  15. package/node_modules/aws-sdk/apis/iot-2015-05-28.min.json +1 -1
  16. package/node_modules/aws-sdk/apis/iot-2015-05-28.paginators.json +12 -0
  17. package/node_modules/aws-sdk/apis/ram-2018-01-04.min.json +396 -66
  18. package/node_modules/aws-sdk/apis/ram-2018-01-04.paginators.json +10 -0
  19. package/node_modules/aws-sdk/apis/s3-2006-03-01.examples.json +94 -94
  20. package/node_modules/aws-sdk/apis/sagemaker-2017-07-24.min.json +710 -703
  21. package/node_modules/aws-sdk/apis/secretsmanager-2017-10-17.examples.json +32 -0
  22. package/node_modules/aws-sdk/apis/securityhub-2018-10-26.examples.json +1516 -0
  23. package/node_modules/aws-sdk/apis/snowball-2016-06-30.min.json +79 -52
  24. package/node_modules/aws-sdk/apis/wafv2-2019-07-29.min.json +159 -73
  25. package/node_modules/aws-sdk/clients/chime.d.ts +94 -42
  26. package/node_modules/aws-sdk/clients/chimesdkmediapipelines.d.ts +14 -10
  27. package/node_modules/aws-sdk/clients/chimesdkmeetings.d.ts +33 -24
  28. package/node_modules/aws-sdk/clients/comprehend.d.ts +45 -5
  29. package/node_modules/aws-sdk/clients/connect.d.ts +59 -1
  30. package/node_modules/aws-sdk/clients/ecs.d.ts +9 -9
  31. package/node_modules/aws-sdk/clients/fms.d.ts +225 -21
  32. package/node_modules/aws-sdk/clients/gamelift.d.ts +240 -240
  33. package/node_modules/aws-sdk/clients/guardduty.d.ts +61 -4
  34. package/node_modules/aws-sdk/clients/iot.d.ts +1 -1
  35. package/node_modules/aws-sdk/clients/ram.d.ts +538 -91
  36. package/node_modules/aws-sdk/clients/rds.d.ts +16 -16
  37. package/node_modules/aws-sdk/clients/s3.d.ts +117 -117
  38. package/node_modules/aws-sdk/clients/sagemaker.d.ts +53 -39
  39. package/node_modules/aws-sdk/clients/secretsmanager.d.ts +10 -10
  40. package/node_modules/aws-sdk/clients/snowball.d.ts +56 -9
  41. package/node_modules/aws-sdk/clients/wafv2.d.ts +120 -10
  42. package/node_modules/aws-sdk/dist/aws-sdk-core-react-native.js +1 -1
  43. package/node_modules/aws-sdk/dist/aws-sdk-react-native.js +16 -16
  44. package/node_modules/aws-sdk/dist/aws-sdk.js +436 -357
  45. package/node_modules/aws-sdk/dist/aws-sdk.min.js +82 -82
  46. package/node_modules/aws-sdk/lib/core.js +1 -1
  47. package/node_modules/aws-sdk/package.json +1 -1
  48. package/package.json +5 -5
@@ -35,6 +35,22 @@ declare class RAM extends Service {
35
35
  * Adds or replaces the RAM permission for a resource type included in a resource share. You can have exactly one permission associated with each resource type in the resource share. You can add a new RAM permission only if there are currently no resources of that resource type currently in the resource share.
36
36
  */
37
37
  associateResourceSharePermission(callback?: (err: AWSError, data: RAM.Types.AssociateResourceSharePermissionResponse) => void): Request<RAM.Types.AssociateResourceSharePermissionResponse, AWSError>;
38
+ /**
39
+ * Creates a customer managed permission for a specified resource type that you can attach to resource shares. It is created in the Amazon Web Services Region in which you call the operation.
40
+ */
41
+ createPermission(params: RAM.Types.CreatePermissionRequest, callback?: (err: AWSError, data: RAM.Types.CreatePermissionResponse) => void): Request<RAM.Types.CreatePermissionResponse, AWSError>;
42
+ /**
43
+ * Creates a customer managed permission for a specified resource type that you can attach to resource shares. It is created in the Amazon Web Services Region in which you call the operation.
44
+ */
45
+ createPermission(callback?: (err: AWSError, data: RAM.Types.CreatePermissionResponse) => void): Request<RAM.Types.CreatePermissionResponse, AWSError>;
46
+ /**
47
+ * Creates a new version of the specified customer managed permission. The new version is automatically set as the default version of the customer managed permission. New resource shares automatically use the default permission. Existing resource shares continue to use their original permission versions, but you can use ReplacePermissionAssociations to update them. If the specified customer managed permission already has the maximum of 5 versions, then you must delete one of the existing versions before you can create a new one.
48
+ */
49
+ createPermissionVersion(params: RAM.Types.CreatePermissionVersionRequest, callback?: (err: AWSError, data: RAM.Types.CreatePermissionVersionResponse) => void): Request<RAM.Types.CreatePermissionVersionResponse, AWSError>;
50
+ /**
51
+ * Creates a new version of the specified customer managed permission. The new version is automatically set as the default version of the customer managed permission. New resource shares automatically use the default permission. Existing resource shares continue to use their original permission versions, but you can use ReplacePermissionAssociations to update them. If the specified customer managed permission already has the maximum of 5 versions, then you must delete one of the existing versions before you can create a new one.
52
+ */
53
+ createPermissionVersion(callback?: (err: AWSError, data: RAM.Types.CreatePermissionVersionResponse) => void): Request<RAM.Types.CreatePermissionVersionResponse, AWSError>;
38
54
  /**
39
55
  * Creates a resource share. You can provide a list of the Amazon Resource Names (ARNs) for the resources that you want to share, a list of principals you want to share the resources with, and the permissions to grant those principals. Sharing a resource makes it available for use by principals outside of the Amazon Web Services account that created the resource. Sharing doesn't change any permissions or quotas that apply to the resource in the account that created it.
40
56
  */
@@ -44,43 +60,59 @@ declare class RAM extends Service {
44
60
  */
45
61
  createResourceShare(callback?: (err: AWSError, data: RAM.Types.CreateResourceShareResponse) => void): Request<RAM.Types.CreateResourceShareResponse, AWSError>;
46
62
  /**
47
- * Deletes the specified resource share. This doesn't delete any of the resources that were associated with the resource share; it only stops the sharing of those resources outside of the Amazon Web Services account that created them.
63
+ * Deletes the specified customer managed permission in the Amazon Web Services Region in which you call this operation. You can delete a customer managed permission only if it isn't attached to any resource share. The operation deletes all versions associated with the customer managed permission.
64
+ */
65
+ deletePermission(params: RAM.Types.DeletePermissionRequest, callback?: (err: AWSError, data: RAM.Types.DeletePermissionResponse) => void): Request<RAM.Types.DeletePermissionResponse, AWSError>;
66
+ /**
67
+ * Deletes the specified customer managed permission in the Amazon Web Services Region in which you call this operation. You can delete a customer managed permission only if it isn't attached to any resource share. The operation deletes all versions associated with the customer managed permission.
68
+ */
69
+ deletePermission(callback?: (err: AWSError, data: RAM.Types.DeletePermissionResponse) => void): Request<RAM.Types.DeletePermissionResponse, AWSError>;
70
+ /**
71
+ * Deletes one version of a customer managed permission. The version you specify must not be attached to any resource share and must not be the default version for the permission. If a customer managed permission has the maximum of 5 versions, then you must delete at least one version before you can create another.
72
+ */
73
+ deletePermissionVersion(params: RAM.Types.DeletePermissionVersionRequest, callback?: (err: AWSError, data: RAM.Types.DeletePermissionVersionResponse) => void): Request<RAM.Types.DeletePermissionVersionResponse, AWSError>;
74
+ /**
75
+ * Deletes one version of a customer managed permission. The version you specify must not be attached to any resource share and must not be the default version for the permission. If a customer managed permission has the maximum of 5 versions, then you must delete at least one version before you can create another.
76
+ */
77
+ deletePermissionVersion(callback?: (err: AWSError, data: RAM.Types.DeletePermissionVersionResponse) => void): Request<RAM.Types.DeletePermissionVersionResponse, AWSError>;
78
+ /**
79
+ * Deletes the specified resource share. This doesn't delete any of the resources that were associated with the resource share; it only stops the sharing of those resources through this resource share.
48
80
  */
49
81
  deleteResourceShare(params: RAM.Types.DeleteResourceShareRequest, callback?: (err: AWSError, data: RAM.Types.DeleteResourceShareResponse) => void): Request<RAM.Types.DeleteResourceShareResponse, AWSError>;
50
82
  /**
51
- * Deletes the specified resource share. This doesn't delete any of the resources that were associated with the resource share; it only stops the sharing of those resources outside of the Amazon Web Services account that created them.
83
+ * Deletes the specified resource share. This doesn't delete any of the resources that were associated with the resource share; it only stops the sharing of those resources through this resource share.
52
84
  */
53
85
  deleteResourceShare(callback?: (err: AWSError, data: RAM.Types.DeleteResourceShareResponse) => void): Request<RAM.Types.DeleteResourceShareResponse, AWSError>;
54
86
  /**
55
- * Disassociates the specified principals or resources from the specified resource share.
87
+ * Removes the specified principals or resources from participating in the specified resource share.
56
88
  */
57
89
  disassociateResourceShare(params: RAM.Types.DisassociateResourceShareRequest, callback?: (err: AWSError, data: RAM.Types.DisassociateResourceShareResponse) => void): Request<RAM.Types.DisassociateResourceShareResponse, AWSError>;
58
90
  /**
59
- * Disassociates the specified principals or resources from the specified resource share.
91
+ * Removes the specified principals or resources from participating in the specified resource share.
60
92
  */
61
93
  disassociateResourceShare(callback?: (err: AWSError, data: RAM.Types.DisassociateResourceShareResponse) => void): Request<RAM.Types.DisassociateResourceShareResponse, AWSError>;
62
94
  /**
63
- * Disassociates an RAM permission from a resource share. Permission changes take effect immediately. You can remove a RAM permission from a resource share only if there are currently no resources of the relevant resource type currently attached to the resource share.
95
+ * Removes a managed permission from a resource share. Permission changes take effect immediately. You can remove a managed permission from a resource share only if there are currently no resources of the relevant resource type currently attached to the resource share.
64
96
  */
65
97
  disassociateResourceSharePermission(params: RAM.Types.DisassociateResourceSharePermissionRequest, callback?: (err: AWSError, data: RAM.Types.DisassociateResourceSharePermissionResponse) => void): Request<RAM.Types.DisassociateResourceSharePermissionResponse, AWSError>;
66
98
  /**
67
- * Disassociates an RAM permission from a resource share. Permission changes take effect immediately. You can remove a RAM permission from a resource share only if there are currently no resources of the relevant resource type currently attached to the resource share.
99
+ * Removes a managed permission from a resource share. Permission changes take effect immediately. You can remove a managed permission from a resource share only if there are currently no resources of the relevant resource type currently attached to the resource share.
68
100
  */
69
101
  disassociateResourceSharePermission(callback?: (err: AWSError, data: RAM.Types.DisassociateResourceSharePermissionResponse) => void): Request<RAM.Types.DisassociateResourceSharePermissionResponse, AWSError>;
70
102
  /**
71
- * Enables resource sharing within your organization in Organizations. Calling this operation enables RAM to retrieve information about the organization and its structure. This lets you share resources with all of the accounts in an organization by specifying the organization's ID, or all of the accounts in an organizational unit (OU) by specifying the OU's ID. Until you enable sharing within the organization, you can specify only individual Amazon Web Services accounts, or for supported resource types, IAM users and roles. You must call this operation from an IAM user or role in the organization's management account.
103
+ * Enables resource sharing within your organization in Organizations. This operation creates a service-linked role called AWSServiceRoleForResourceAccessManager that has the IAM managed policy named AWSResourceAccessManagerServiceRolePolicy attached. This role permits RAM to retrieve information about the organization and its structure. This lets you share resources with all of the accounts in the calling account's organization by specifying the organization ID, or all of the accounts in an organizational unit (OU) by specifying the OU ID. Until you enable sharing within the organization, you can specify only individual Amazon Web Services accounts, or for supported resource types, IAM roles and users. You must call this operation from an IAM role or user in the organization's management account.
72
104
  */
73
105
  enableSharingWithAwsOrganization(params: RAM.Types.EnableSharingWithAwsOrganizationRequest, callback?: (err: AWSError, data: RAM.Types.EnableSharingWithAwsOrganizationResponse) => void): Request<RAM.Types.EnableSharingWithAwsOrganizationResponse, AWSError>;
74
106
  /**
75
- * Enables resource sharing within your organization in Organizations. Calling this operation enables RAM to retrieve information about the organization and its structure. This lets you share resources with all of the accounts in an organization by specifying the organization's ID, or all of the accounts in an organizational unit (OU) by specifying the OU's ID. Until you enable sharing within the organization, you can specify only individual Amazon Web Services accounts, or for supported resource types, IAM users and roles. You must call this operation from an IAM user or role in the organization's management account.
107
+ * Enables resource sharing within your organization in Organizations. This operation creates a service-linked role called AWSServiceRoleForResourceAccessManager that has the IAM managed policy named AWSResourceAccessManagerServiceRolePolicy attached. This role permits RAM to retrieve information about the organization and its structure. This lets you share resources with all of the accounts in the calling account's organization by specifying the organization ID, or all of the accounts in an organizational unit (OU) by specifying the OU ID. Until you enable sharing within the organization, you can specify only individual Amazon Web Services accounts, or for supported resource types, IAM roles and users. You must call this operation from an IAM role or user in the organization's management account.
76
108
  */
77
109
  enableSharingWithAwsOrganization(callback?: (err: AWSError, data: RAM.Types.EnableSharingWithAwsOrganizationResponse) => void): Request<RAM.Types.EnableSharingWithAwsOrganizationResponse, AWSError>;
78
110
  /**
79
- * Gets the contents of an RAM permission in JSON format.
111
+ * Retrieves the contents of a managed permission in JSON format.
80
112
  */
81
113
  getPermission(params: RAM.Types.GetPermissionRequest, callback?: (err: AWSError, data: RAM.Types.GetPermissionResponse) => void): Request<RAM.Types.GetPermissionResponse, AWSError>;
82
114
  /**
83
- * Gets the contents of an RAM permission in JSON format.
115
+ * Retrieves the contents of a managed permission in JSON format.
84
116
  */
85
117
  getPermission(callback?: (err: AWSError, data: RAM.Types.GetPermissionResponse) => void): Request<RAM.Types.GetPermissionResponse, AWSError>;
86
118
  /**
@@ -92,11 +124,11 @@ declare class RAM extends Service {
92
124
  */
93
125
  getResourcePolicies(callback?: (err: AWSError, data: RAM.Types.GetResourcePoliciesResponse) => void): Request<RAM.Types.GetResourcePoliciesResponse, AWSError>;
94
126
  /**
95
- * Retrieves the resource and principal associations for resource shares that you own.
127
+ * Retrieves the lists of resources and principals that associated for resource shares that you own.
96
128
  */
97
129
  getResourceShareAssociations(params: RAM.Types.GetResourceShareAssociationsRequest, callback?: (err: AWSError, data: RAM.Types.GetResourceShareAssociationsResponse) => void): Request<RAM.Types.GetResourceShareAssociationsResponse, AWSError>;
98
130
  /**
99
- * Retrieves the resource and principal associations for resource shares that you own.
131
+ * Retrieves the lists of resources and principals that associated for resource shares that you own.
100
132
  */
101
133
  getResourceShareAssociations(callback?: (err: AWSError, data: RAM.Types.GetResourceShareAssociationsResponse) => void): Request<RAM.Types.GetResourceShareAssociationsResponse, AWSError>;
102
134
  /**
@@ -123,6 +155,14 @@ declare class RAM extends Service {
123
155
  * Lists the resources in a resource share that is shared with you but for which the invitation is still PENDING. That means that you haven't accepted or rejected the invitation and the invitation hasn't expired.
124
156
  */
125
157
  listPendingInvitationResources(callback?: (err: AWSError, data: RAM.Types.ListPendingInvitationResourcesResponse) => void): Request<RAM.Types.ListPendingInvitationResourcesResponse, AWSError>;
158
+ /**
159
+ * Lists information about the managed permission and its associations to any resource shares that use this managed permission. This lets you see which resource shares use which versions of the specified managed permission.
160
+ */
161
+ listPermissionAssociations(params: RAM.Types.ListPermissionAssociationsRequest, callback?: (err: AWSError, data: RAM.Types.ListPermissionAssociationsResponse) => void): Request<RAM.Types.ListPermissionAssociationsResponse, AWSError>;
162
+ /**
163
+ * Lists information about the managed permission and its associations to any resource shares that use this managed permission. This lets you see which resource shares use which versions of the specified managed permission.
164
+ */
165
+ listPermissionAssociations(callback?: (err: AWSError, data: RAM.Types.ListPermissionAssociationsResponse) => void): Request<RAM.Types.ListPermissionAssociationsResponse, AWSError>;
126
166
  /**
127
167
  * Lists the available versions of the specified RAM permission.
128
168
  */
@@ -147,6 +187,14 @@ declare class RAM extends Service {
147
187
  * Lists the principals that you are sharing resources with or that are sharing resources with you.
148
188
  */
149
189
  listPrincipals(callback?: (err: AWSError, data: RAM.Types.ListPrincipalsResponse) => void): Request<RAM.Types.ListPrincipalsResponse, AWSError>;
190
+ /**
191
+ * Retrieves the current status of the asynchronous tasks performed by RAM when you perform the ReplacePermissionAssociationsWork operation.
192
+ */
193
+ listReplacePermissionAssociationsWork(params: RAM.Types.ListReplacePermissionAssociationsWorkRequest, callback?: (err: AWSError, data: RAM.Types.ListReplacePermissionAssociationsWorkResponse) => void): Request<RAM.Types.ListReplacePermissionAssociationsWorkResponse, AWSError>;
194
+ /**
195
+ * Retrieves the current status of the asynchronous tasks performed by RAM when you perform the ReplacePermissionAssociationsWork operation.
196
+ */
197
+ listReplacePermissionAssociationsWork(callback?: (err: AWSError, data: RAM.Types.ListReplacePermissionAssociationsWorkResponse) => void): Request<RAM.Types.ListReplacePermissionAssociationsWorkResponse, AWSError>;
150
198
  /**
151
199
  * Lists the RAM permissions that are associated with a resource share.
152
200
  */
@@ -172,11 +220,19 @@ declare class RAM extends Service {
172
220
  */
173
221
  listResources(callback?: (err: AWSError, data: RAM.Types.ListResourcesResponse) => void): Request<RAM.Types.ListResourcesResponse, AWSError>;
174
222
  /**
175
- * When you attach a resource-based permission policy to a resource, it automatically creates a resource share. However, resource shares created this way are visible only to the resource share owner, and the resource share can't be modified in RAM. You can use this operation to promote the resource share to a full RAM resource share. When you promote a resource share, you can then manage the resource share in RAM and it becomes visible to all of the principals you shared it with.
223
+ * When you attach a resource-based policy to a resource, RAM automatically creates a resource share of featureSet=CREATED_FROM_POLICY with a managed permission that has the same IAM permissions as the original resource-based policy. However, this type of managed permission is visible to only the resource share owner, and the associated resource share can't be modified by using RAM. This operation creates a separate, fully manageable customer managed permission that has the same IAM permissions as the original resource-based policy. You can associate this customer managed permission to any resource shares. Before you use PromoteResourceShareCreatedFromPolicy, you should first run this operation to ensure that you have an appropriate customer managed permission that can be associated with the promoted resource share. The original CREATED_FROM_POLICY policy isn't deleted, and resource shares using that original policy aren't automatically updated. You can't modify a CREATED_FROM_POLICY resource share so you can't associate the new customer managed permission by using ReplacePermsissionAssociations. However, if you use PromoteResourceShareCreatedFromPolicy, that operation automatically associates the fully manageable customer managed permission to the newly promoted STANDARD resource share. After you promote a resource share, if the original CREATED_FROM_POLICY managed permission has no other associations to A resource share, then RAM automatically deletes it.
224
+ */
225
+ promotePermissionCreatedFromPolicy(params: RAM.Types.PromotePermissionCreatedFromPolicyRequest, callback?: (err: AWSError, data: RAM.Types.PromotePermissionCreatedFromPolicyResponse) => void): Request<RAM.Types.PromotePermissionCreatedFromPolicyResponse, AWSError>;
226
+ /**
227
+ * When you attach a resource-based policy to a resource, RAM automatically creates a resource share of featureSet=CREATED_FROM_POLICY with a managed permission that has the same IAM permissions as the original resource-based policy. However, this type of managed permission is visible to only the resource share owner, and the associated resource share can't be modified by using RAM. This operation creates a separate, fully manageable customer managed permission that has the same IAM permissions as the original resource-based policy. You can associate this customer managed permission to any resource shares. Before you use PromoteResourceShareCreatedFromPolicy, you should first run this operation to ensure that you have an appropriate customer managed permission that can be associated with the promoted resource share. The original CREATED_FROM_POLICY policy isn't deleted, and resource shares using that original policy aren't automatically updated. You can't modify a CREATED_FROM_POLICY resource share so you can't associate the new customer managed permission by using ReplacePermsissionAssociations. However, if you use PromoteResourceShareCreatedFromPolicy, that operation automatically associates the fully manageable customer managed permission to the newly promoted STANDARD resource share. After you promote a resource share, if the original CREATED_FROM_POLICY managed permission has no other associations to A resource share, then RAM automatically deletes it.
228
+ */
229
+ promotePermissionCreatedFromPolicy(callback?: (err: AWSError, data: RAM.Types.PromotePermissionCreatedFromPolicyResponse) => void): Request<RAM.Types.PromotePermissionCreatedFromPolicyResponse, AWSError>;
230
+ /**
231
+ * When you attach a resource-based policy to a resource, RAM automatically creates a resource share of featureSet=CREATED_FROM_POLICY with a managed permission that has the same IAM permissions as the original resource-based policy. However, this type of managed permission is visible to only the resource share owner, and the associated resource share can't be modified by using RAM. This operation promotes the resource share to a STANDARD resource share that is fully manageable in RAM. When you promote a resource share, you can then manage the resource share in RAM and it becomes visible to all of the principals you shared it with. Before you perform this operation, you should first run PromotePermissionCreatedFromPolicyto ensure that you have an appropriate customer managed permission that can be associated with this resource share after its is promoted. If this operation can't find a managed permission that exactly matches the existing CREATED_FROM_POLICY permission, then this operation fails.
176
232
  */
177
233
  promoteResourceShareCreatedFromPolicy(params: RAM.Types.PromoteResourceShareCreatedFromPolicyRequest, callback?: (err: AWSError, data: RAM.Types.PromoteResourceShareCreatedFromPolicyResponse) => void): Request<RAM.Types.PromoteResourceShareCreatedFromPolicyResponse, AWSError>;
178
234
  /**
179
- * When you attach a resource-based permission policy to a resource, it automatically creates a resource share. However, resource shares created this way are visible only to the resource share owner, and the resource share can't be modified in RAM. You can use this operation to promote the resource share to a full RAM resource share. When you promote a resource share, you can then manage the resource share in RAM and it becomes visible to all of the principals you shared it with.
235
+ * When you attach a resource-based policy to a resource, RAM automatically creates a resource share of featureSet=CREATED_FROM_POLICY with a managed permission that has the same IAM permissions as the original resource-based policy. However, this type of managed permission is visible to only the resource share owner, and the associated resource share can't be modified by using RAM. This operation promotes the resource share to a STANDARD resource share that is fully manageable in RAM. When you promote a resource share, you can then manage the resource share in RAM and it becomes visible to all of the principals you shared it with. Before you perform this operation, you should first run PromotePermissionCreatedFromPolicyto ensure that you have an appropriate customer managed permission that can be associated with this resource share after its is promoted. If this operation can't find a managed permission that exactly matches the existing CREATED_FROM_POLICY permission, then this operation fails.
180
236
  */
181
237
  promoteResourceShareCreatedFromPolicy(callback?: (err: AWSError, data: RAM.Types.PromoteResourceShareCreatedFromPolicyResponse) => void): Request<RAM.Types.PromoteResourceShareCreatedFromPolicyResponse, AWSError>;
182
238
  /**
@@ -188,19 +244,35 @@ declare class RAM extends Service {
188
244
  */
189
245
  rejectResourceShareInvitation(callback?: (err: AWSError, data: RAM.Types.RejectResourceShareInvitationResponse) => void): Request<RAM.Types.RejectResourceShareInvitationResponse, AWSError>;
190
246
  /**
191
- * Adds the specified tag keys and values to the specified resource share. The tags are attached only to the resource share, not to the resources that are in the resource share.
247
+ * Updates all resource shares that use a managed permission to a different managed permission. This operation always applies the default version of the target managed permission. You can optionally specify that the update applies to only resource shares that currently use a specified version. This enables you to update to the latest version, without changing the which managed permission is used. You can use this operation to update all of your resource shares to use the current default version of the permission by specifying the same value for the fromPermissionArn and toPermissionArn parameters. You can use the optional fromPermissionVersion parameter to update only those resources that use a specified version of the managed permission to the new managed permission. To successfully perform this operation, you must have permission to update the resource-based policy on all affected resource types.
248
+ */
249
+ replacePermissionAssociations(params: RAM.Types.ReplacePermissionAssociationsRequest, callback?: (err: AWSError, data: RAM.Types.ReplacePermissionAssociationsResponse) => void): Request<RAM.Types.ReplacePermissionAssociationsResponse, AWSError>;
250
+ /**
251
+ * Updates all resource shares that use a managed permission to a different managed permission. This operation always applies the default version of the target managed permission. You can optionally specify that the update applies to only resource shares that currently use a specified version. This enables you to update to the latest version, without changing the which managed permission is used. You can use this operation to update all of your resource shares to use the current default version of the permission by specifying the same value for the fromPermissionArn and toPermissionArn parameters. You can use the optional fromPermissionVersion parameter to update only those resources that use a specified version of the managed permission to the new managed permission. To successfully perform this operation, you must have permission to update the resource-based policy on all affected resource types.
252
+ */
253
+ replacePermissionAssociations(callback?: (err: AWSError, data: RAM.Types.ReplacePermissionAssociationsResponse) => void): Request<RAM.Types.ReplacePermissionAssociationsResponse, AWSError>;
254
+ /**
255
+ * Designates the specified version number as the default version for the specified customer managed permission. New resource shares automatically use this new default permission. Existing resource shares continue to use their original permission version, but you can use ReplacePermissionAssociations to update them.
256
+ */
257
+ setDefaultPermissionVersion(params: RAM.Types.SetDefaultPermissionVersionRequest, callback?: (err: AWSError, data: RAM.Types.SetDefaultPermissionVersionResponse) => void): Request<RAM.Types.SetDefaultPermissionVersionResponse, AWSError>;
258
+ /**
259
+ * Designates the specified version number as the default version for the specified customer managed permission. New resource shares automatically use this new default permission. Existing resource shares continue to use their original permission version, but you can use ReplacePermissionAssociations to update them.
260
+ */
261
+ setDefaultPermissionVersion(callback?: (err: AWSError, data: RAM.Types.SetDefaultPermissionVersionResponse) => void): Request<RAM.Types.SetDefaultPermissionVersionResponse, AWSError>;
262
+ /**
263
+ * Adds the specified tag keys and values to a resource share or managed permission. If you choose a resource share, the tags are attached to only the resource share, not to the resources that are in the resource share. The tags on a managed permission are the same for all versions of the managed permission.
192
264
  */
193
265
  tagResource(params: RAM.Types.TagResourceRequest, callback?: (err: AWSError, data: RAM.Types.TagResourceResponse) => void): Request<RAM.Types.TagResourceResponse, AWSError>;
194
266
  /**
195
- * Adds the specified tag keys and values to the specified resource share. The tags are attached only to the resource share, not to the resources that are in the resource share.
267
+ * Adds the specified tag keys and values to a resource share or managed permission. If you choose a resource share, the tags are attached to only the resource share, not to the resources that are in the resource share. The tags on a managed permission are the same for all versions of the managed permission.
196
268
  */
197
269
  tagResource(callback?: (err: AWSError, data: RAM.Types.TagResourceResponse) => void): Request<RAM.Types.TagResourceResponse, AWSError>;
198
270
  /**
199
- * Removes the specified tag key and value pairs from the specified resource share.
271
+ * Removes the specified tag key and value pairs from the specified resource share or managed permission.
200
272
  */
201
273
  untagResource(params: RAM.Types.UntagResourceRequest, callback?: (err: AWSError, data: RAM.Types.UntagResourceResponse) => void): Request<RAM.Types.UntagResourceResponse, AWSError>;
202
274
  /**
203
- * Removes the specified tag key and value pairs from the specified resource share.
275
+ * Removes the specified tag key and value pairs from the specified resource share or managed permission.
204
276
  */
205
277
  untagResource(callback?: (err: AWSError, data: RAM.Types.UntagResourceResponse) => void): Request<RAM.Types.UntagResourceResponse, AWSError>;
206
278
  /**
@@ -215,11 +287,11 @@ declare class RAM extends Service {
215
287
  declare namespace RAM {
216
288
  export interface AcceptResourceShareInvitationRequest {
217
289
  /**
218
- * The Amazon Resoure Name (ARN) of the invitation that you want to accept.
290
+ * The Amazon Resource Name (ARN) of the invitation that you want to accept.
219
291
  */
220
292
  resourceShareInvitationArn: String;
221
293
  /**
222
- * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you.
294
+ * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you. If you retry the operation with the same ClientToken, but with different parameters, the retry fails with an IdempotentParameterMismatch error.
223
295
  */
224
296
  clientToken?: String;
225
297
  }
@@ -235,23 +307,23 @@ declare namespace RAM {
235
307
  }
236
308
  export interface AssociateResourceSharePermissionRequest {
237
309
  /**
238
- * Specifies the Amazon Resoure Name (ARN) of the resource share to which you want to add or replace permissions.
310
+ * Specifies the Amazon Resource Name (ARN) of the resource share to which you want to add or replace permissions.
239
311
  */
240
312
  resourceShareArn: String;
241
313
  /**
242
- * Specifies the Amazon Resoure Name (ARN) of the RAM permission to associate with the resource share. To find the ARN for a permission, use either the ListPermissions operation or go to the Permissions library page in the RAM console and then choose the name of the permission. The ARN is displayed on the detail page.
314
+ * Specifies the Amazon Resource Name (ARN) of the RAM permission to associate with the resource share. To find the ARN for a permission, use either the ListPermissions operation or go to the Permissions library page in the RAM console and then choose the name of the permission. The ARN is displayed on the detail page.
243
315
  */
244
316
  permissionArn: String;
245
317
  /**
246
- * Specifies whether the specified permission should replace or add to the existing permission associated with the resource share. Use true to replace the current permissions. Use false to add the permission to the current permission. The default value is false. A resource share can have only one permission per resource type. If a resource share already has a permission for the specified resource type and you don't set replace to true then the operation returns an error. This helps prevent accidental overwriting of a permission.
318
+ * Specifies whether the specified permission should replace the existing permission associated with the resource share. Use true to replace the current permissions. Use false to add the permission to a resource share that currently doesn't have a permission. The default value is false. A resource share can have only one permission per resource type. If a resource share already has a permission for the specified resource type and you don't set replace to true then the operation returns an error. This helps prevent accidental overwriting of a permission.
247
319
  */
248
320
  replace?: Boolean;
249
321
  /**
250
- * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you.
322
+ * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you. If you retry the operation with the same ClientToken, but with different parameters, the retry fails with an IdempotentParameterMismatch error.
251
323
  */
252
324
  clientToken?: String;
253
325
  /**
254
- * Specifies the version of the RAM permission to associate with the resource share. If you don't specify this parameter, the operation uses the version designated as the default. You can use the ListPermissionVersions operation to discover the available versions of a permission.
326
+ * Specifies the version of the RAM permission to associate with the resource share. You can specify only the version that is currently set as the default version for the permission. If you also set the replace pararameter to true, then this operation updates an outdated version of the permission to the current default version. You don't need to specify this parameter because the default behavior is to use the version that is currently set as the default version for the permission. This parameter is supported for backwards compatibility.
255
327
  */
256
328
  permissionVersion?: Integer;
257
329
  }
@@ -267,7 +339,7 @@ declare namespace RAM {
267
339
  }
268
340
  export interface AssociateResourceShareRequest {
269
341
  /**
270
- * Specifies the Amazon Resoure Name (ARN) of the resource share that you want to add principals or resources to.
342
+ * Specifies the Amazon Resource Name (ARN) of the resource share that you want to add principals or resources to.
271
343
  */
272
344
  resourceShareArn: String;
273
345
  /**
@@ -275,11 +347,11 @@ declare namespace RAM {
275
347
  */
276
348
  resourceArns?: ResourceArnList;
277
349
  /**
278
- * Specifies a list of principals to whom you want to the resource share. This can be null if you want to add only resources. What the principals can do with the resources in the share is determined by the RAM permissions that you associate with the resource share. See AssociateResourceSharePermission. You can include the following values: An Amazon Web Services account ID, for example: 123456789012 An Amazon Resoure Name (ARN) of an organization in Organizations, for example: organizations::123456789012:organization/o-exampleorgid An ARN of an organizational unit (OU) in Organizations, for example: organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123 An ARN of an IAM role, for example: iam::123456789012:role/rolename An ARN of an IAM user, for example: iam::123456789012user/username Not all resource types can be shared with IAM roles and users. For more information, see Sharing with IAM roles and users in the Resource Access Manager User Guide.
350
+ * Specifies a list of principals to whom you want to the resource share. This can be null if you want to add only resources. What the principals can do with the resources in the share is determined by the RAM permissions that you associate with the resource share. See AssociateResourceSharePermission. You can include the following values: An Amazon Web Services account ID, for example: 123456789012 An Amazon Resource Name (ARN) of an organization in Organizations, for example: organizations::123456789012:organization/o-exampleorgid An ARN of an organizational unit (OU) in Organizations, for example: organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123 An ARN of an IAM role, for example: iam::123456789012:role/rolename An ARN of an IAM user, for example: iam::123456789012user/username Not all resource types can be shared with IAM roles and users. For more information, see Sharing with IAM roles and users in the Resource Access Manager User Guide.
279
351
  */
280
352
  principals?: PrincipalArnOrIdList;
281
353
  /**
282
- * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you.
354
+ * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you. If you retry the operation with the same ClientToken, but with different parameters, the retry fails with an IdempotentParameterMismatch error.
283
355
  */
284
356
  clientToken?: String;
285
357
  }
@@ -293,7 +365,95 @@ declare namespace RAM {
293
365
  */
294
366
  clientToken?: String;
295
367
  }
368
+ export interface AssociatedPermission {
369
+ /**
370
+ * The Amazon Resource Name (ARN) of the associated managed permission.
371
+ */
372
+ arn?: String;
373
+ /**
374
+ * The version of the permission currently associated with the resource share.
375
+ */
376
+ permissionVersion?: String;
377
+ /**
378
+ * Indicates whether the associated resource share is using the default version of the permission.
379
+ */
380
+ defaultVersion?: Boolean;
381
+ /**
382
+ * The resource type to which this permission applies.
383
+ */
384
+ resourceType?: String;
385
+ /**
386
+ * The current status of the association between the permission and the resource share. The following are the possible values: ATTACHABLE – This permission or version can be associated with resource shares. UNATTACHABLE – This permission or version can't currently be associated with resource shares. DELETING – This permission or version is in the process of being deleted. DELETED – This permission or version is deleted.
387
+ */
388
+ status?: String;
389
+ /**
390
+ * Indicates what features are available for this resource share. This parameter can have one of the following values: STANDARD – A resource share that supports all functionality. These resource shares are visible to all principals you share the resource share with. You can modify these resource shares in RAM using the console or APIs. This resource share might have been created by RAM, or it might have been CREATED_FROM_POLICY and then promoted. CREATED_FROM_POLICY – The customer manually shared a resource by attaching a resource-based policy. That policy did not match any existing managed permissions, so RAM created this customer managed permission automatically on the customer's behalf based on the attached policy document. This type of resource share is visible only to the Amazon Web Services account that created it. You can't modify it in RAM unless you promote it. For more information, see PromoteResourceShareCreatedFromPolicy. PROMOTING_TO_STANDARD – This resource share was originally CREATED_FROM_POLICY, but the customer ran the PromoteResourceShareCreatedFromPolicy and that operation is still in progress. This value changes to STANDARD when complete.
391
+ */
392
+ featureSet?: PermissionFeatureSet;
393
+ /**
394
+ * The date and time when the association between the permission and the resource share was last updated.
395
+ */
396
+ lastUpdatedTime?: DateTime;
397
+ /**
398
+ * The Amazon Resource Name (ARN) of a resource share associated with this permission.
399
+ */
400
+ resourceShareArn?: String;
401
+ }
402
+ export type AssociatedPermissionList = AssociatedPermission[];
296
403
  export type Boolean = boolean;
404
+ export interface CreatePermissionRequest {
405
+ /**
406
+ * Specifies the name of the customer managed permission. The name must be unique within the Amazon Web Services Region.
407
+ */
408
+ name: PermissionName;
409
+ /**
410
+ * Specifies the name of the resource type that this customer managed permission applies to. The format is &lt;service-code&gt;:&lt;resource-type&gt; and is not case sensitive. For example, to specify an Amazon EC2 Subnet, you can use the string ec2:subnet. To see the list of valid values for this parameter, query the ListResourceTypes operation.
411
+ */
412
+ resourceType: String;
413
+ /**
414
+ * A string in JSON format string that contains the following elements of a resource-based policy: Effect: must be set to ALLOW. Action: specifies the actions that are allowed by this customer managed permission. The list must contain only actions that are supported by the specified resource type. For a list of all actions supported by each resource type, see Actions, resources, and condition keys for Amazon Web Services services in the Identity and Access Management User Guide. Condition: (optional) specifies conditional parameters that must evaluate to true when a user attempts an action for that action to be allowed. For more information about the Condition element, see IAM policies: Condition element in the Identity and Access Management User Guide. This template can't include either the Resource or Principal elements. Those are both filled in by RAM when it instantiates the resource-based policy on each resource shared using this managed permission. The Resource comes from the ARN of the specific resource that you are sharing. The Principal comes from the list of identities added to the resource share.
415
+ */
416
+ policyTemplate: Policy;
417
+ /**
418
+ * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you. If you retry the operation with the same ClientToken, but with different parameters, the retry fails with an IdempotentParameterMismatch error.
419
+ */
420
+ clientToken?: String;
421
+ /**
422
+ * Specifies a list of one or more tag key and value pairs to attach to the permission.
423
+ */
424
+ tags?: TagList;
425
+ }
426
+ export interface CreatePermissionResponse {
427
+ /**
428
+ * A structure with information about this customer managed permission.
429
+ */
430
+ permission?: ResourceSharePermissionSummary;
431
+ /**
432
+ * The idempotency identifier associated with this request. If you want to repeat the same operation in an idempotent manner then you must include this value in the clientToken request parameter of that later call. All other parameters must also have the same values that you used in the first call.
433
+ */
434
+ clientToken?: String;
435
+ }
436
+ export interface CreatePermissionVersionRequest {
437
+ /**
438
+ * Specifies the Amazon Resource Name (ARN) of the customer managed permission you're creating a new version for.
439
+ */
440
+ permissionArn: String;
441
+ /**
442
+ * A string in JSON format string that contains the following elements of a resource-based policy: Effect: must be set to ALLOW. Action: specifies the actions that are allowed by this customer managed permission. The list must contain only actions that are supported by the specified resource type. For a list of all actions supported by each resource type, see Actions, resources, and condition keys for Amazon Web Services services in the Identity and Access Management User Guide. Condition: (optional) specifies conditional parameters that must evaluate to true when a user attempts an action for that action to be allowed. For more information about the Condition element, see IAM policies: Condition element in the Identity and Access Management User Guide. This template can't include either the Resource or Principal elements. Those are both filled in by RAM when it instantiates the resource-based policy on each resource shared using this managed permission. The Resource comes from the ARN of the specific resource that you are sharing. The Principal comes from the list of identities added to the resource share.
443
+ */
444
+ policyTemplate: Policy;
445
+ /**
446
+ * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you. If you retry the operation with the same ClientToken, but with different parameters, the retry fails with an IdempotentParameterMismatch error.
447
+ */
448
+ clientToken?: String;
449
+ }
450
+ export interface CreatePermissionVersionResponse {
451
+ permission?: ResourceSharePermissionDetail;
452
+ /**
453
+ * The idempotency identifier associated with this request. If you want to repeat the same operation in an idempotent manner then you must include this value in the clientToken request parameter of that later call. All other parameters must also have the same values that you used in the first call.
454
+ */
455
+ clientToken?: String;
456
+ }
297
457
  export interface CreateResourceShareRequest {
298
458
  /**
299
459
  * Specifies the name of the resource share.
@@ -304,7 +464,7 @@ declare namespace RAM {
304
464
  */
305
465
  resourceArns?: ResourceArnList;
306
466
  /**
307
- * Specifies a list of one or more principals to associate with the resource share. You can include the following values: An Amazon Web Services account ID, for example: 123456789012 An Amazon Resoure Name (ARN) of an organization in Organizations, for example: organizations::123456789012:organization/o-exampleorgid An ARN of an organizational unit (OU) in Organizations, for example: organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123 An ARN of an IAM role, for example: iam::123456789012:role/rolename An ARN of an IAM user, for example: iam::123456789012user/username Not all resource types can be shared with IAM roles and users. For more information, see Sharing with IAM roles and users in the Resource Access Manager User Guide.
467
+ * Specifies a list of one or more principals to associate with the resource share. You can include the following values: An Amazon Web Services account ID, for example: 123456789012 An Amazon Resource Name (ARN) of an organization in Organizations, for example: organizations::123456789012:organization/o-exampleorgid An ARN of an organizational unit (OU) in Organizations, for example: organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123 An ARN of an IAM role, for example: iam::123456789012:role/rolename An ARN of an IAM user, for example: iam::123456789012user/username Not all resource types can be shared with IAM roles and users. For more information, see Sharing with IAM roles and users in the Resource Access Manager User Guide.
308
468
  */
309
469
  principals?: PrincipalArnOrIdList;
310
470
  /**
@@ -316,7 +476,7 @@ declare namespace RAM {
316
476
  */
317
477
  allowExternalPrincipals?: Boolean;
318
478
  /**
319
- * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you.
479
+ * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you. If you retry the operation with the same ClientToken, but with different parameters, the retry fails with an IdempotentParameterMismatch error.
320
480
  */
321
481
  clientToken?: String;
322
482
  /**
@@ -335,13 +495,65 @@ declare namespace RAM {
335
495
  clientToken?: String;
336
496
  }
337
497
  export type DateTime = Date;
498
+ export interface DeletePermissionRequest {
499
+ /**
500
+ * Specifies the Amazon Resource Name (ARN) of the customer managed permission that you want to delete.
501
+ */
502
+ permissionArn: String;
503
+ /**
504
+ * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you. If you retry the operation with the same ClientToken, but with different parameters, the retry fails with an IdempotentParameterMismatch error.
505
+ */
506
+ clientToken?: String;
507
+ }
508
+ export interface DeletePermissionResponse {
509
+ /**
510
+ * A boolean that indicates whether the delete operations succeeded.
511
+ */
512
+ returnValue?: Boolean;
513
+ /**
514
+ * The idempotency identifier associated with this request. If you want to repeat the same operation in an idempotent manner then you must include this value in the clientToken request parameter of that later call. All other parameters must also have the same values that you used in the first call.
515
+ */
516
+ clientToken?: String;
517
+ /**
518
+ * This operation is performed asynchronously, and this response parameter indicates the current status.
519
+ */
520
+ permissionStatus?: PermissionStatus;
521
+ }
522
+ export interface DeletePermissionVersionRequest {
523
+ /**
524
+ * Specifies the Amazon Resource Name (ARN) of the permission with the version you want to delete.
525
+ */
526
+ permissionArn: String;
527
+ /**
528
+ * Specifies the version number to delete. You can't delete the default version for a customer managed permission. You can't delete a version if it's the only version of the permission. You must either first create another version, or delete the permission completely. You can't delete a version if it is attached to any resource shares. If the version is the default, you must first use SetDefaultPermissionVersion to set a different version as the default for the customer managed permission, and then use AssociateResourceSharePermission to update your resource shares to use the new default version.
529
+ */
530
+ permissionVersion: Integer;
531
+ /**
532
+ * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you. If you retry the operation with the same ClientToken, but with different parameters, the retry fails with an IdempotentParameterMismatch error.
533
+ */
534
+ clientToken?: String;
535
+ }
536
+ export interface DeletePermissionVersionResponse {
537
+ /**
538
+ * A boolean value that indicates whether the operation is successful.
539
+ */
540
+ returnValue?: Boolean;
541
+ /**
542
+ * The idempotency identifier associated with this request. If you want to repeat the same operation in an idempotent manner then you must include this value in the clientToken request parameter of that later call. All other parameters must also have the same values that you used in the first call.
543
+ */
544
+ clientToken?: String;
545
+ /**
546
+ * This operation is performed asynchronously, and this response parameter indicates the current status.
547
+ */
548
+ permissionStatus?: PermissionStatus;
549
+ }
338
550
  export interface DeleteResourceShareRequest {
339
551
  /**
340
- * Specifies the Amazon Resoure Name (ARN) of the resource share to delete.
552
+ * Specifies the Amazon Resource Name (ARN) of the resource share to delete.
341
553
  */
342
554
  resourceShareArn: String;
343
555
  /**
344
- * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you.
556
+ * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you. If you retry the operation with the same ClientToken, but with different parameters, the retry fails with an IdempotentParameterMismatch error.
345
557
  */
346
558
  clientToken?: String;
347
559
  }
@@ -357,15 +569,15 @@ declare namespace RAM {
357
569
  }
358
570
  export interface DisassociateResourceSharePermissionRequest {
359
571
  /**
360
- * The Amazon Resoure Name (ARN) of the resource share from which you want to disassociate a permission.
572
+ * The Amazon Resource Name (ARN) of the resource share that you want to remove the managed permission from.
361
573
  */
362
574
  resourceShareArn: String;
363
575
  /**
364
- * The Amazon Resoure Name (ARN) of the permission to disassociate from the resource share. Changes to permissions take effect immediately.
576
+ * The Amazon Resource Name (ARN) of the managed permission to disassociate from the resource share. Changes to permissions take effect immediately.
365
577
  */
366
578
  permissionArn: String;
367
579
  /**
368
- * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you.
580
+ * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you. If you retry the operation with the same ClientToken, but with different parameters, the retry fails with an IdempotentParameterMismatch error.
369
581
  */
370
582
  clientToken?: String;
371
583
  }
@@ -381,25 +593,25 @@ declare namespace RAM {
381
593
  }
382
594
  export interface DisassociateResourceShareRequest {
383
595
  /**
384
- * Specifies Amazon Resoure Name (ARN) of the resource share that you want to remove resources from.
596
+ * Specifies Amazon Resource Name (ARN) of the resource share that you want to remove resources or principals from.
385
597
  */
386
598
  resourceShareArn: String;
387
599
  /**
388
- * Specifies a list of Amazon Resource Names (ARNs) for one or more resources that you want to remove from the resource share. After the operation runs, these resources are no longer shared with principals outside of the Amazon Web Services account that created the resources.
600
+ * Specifies a list of Amazon Resource Names (ARNs) for one or more resources that you want to remove from the resource share. After the operation runs, these resources are no longer shared with principals associated with the resource share.
389
601
  */
390
602
  resourceArns?: ResourceArnList;
391
603
  /**
392
- * Specifies a list of one or more principals that no longer are to have access to the resources in this resource share. You can include the following values: An Amazon Web Services account ID, for example: 123456789012 An Amazon Resoure Name (ARN) of an organization in Organizations, for example: organizations::123456789012:organization/o-exampleorgid An ARN of an organizational unit (OU) in Organizations, for example: organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123 An ARN of an IAM role, for example: iam::123456789012:role/rolename An ARN of an IAM user, for example: iam::123456789012user/username Not all resource types can be shared with IAM roles and users. For more information, see Sharing with IAM roles and users in the Resource Access Manager User Guide.
604
+ * Specifies a list of one or more principals that no longer are to have access to the resources in this resource share. You can include the following values: An Amazon Web Services account ID, for example: 123456789012 An Amazon Resource Name (ARN) of an organization in Organizations, for example: organizations::123456789012:organization/o-exampleorgid An ARN of an organizational unit (OU) in Organizations, for example: organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123 An ARN of an IAM role, for example: iam::123456789012:role/rolename An ARN of an IAM user, for example: iam::123456789012user/username Not all resource types can be shared with IAM roles and users. For more information, see Sharing with IAM roles and users in the Resource Access Manager User Guide.
393
605
  */
394
606
  principals?: PrincipalArnOrIdList;
395
607
  /**
396
- * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you.
608
+ * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you. If you retry the operation with the same ClientToken, but with different parameters, the retry fails with an IdempotentParameterMismatch error.
397
609
  */
398
610
  clientToken?: String;
399
611
  }
400
612
  export interface DisassociateResourceShareResponse {
401
613
  /**
402
- * An array of objects that contain information about the updated associations for this resource share.
614
+ * An array of objects with information about the updated associations for this resource share.
403
615
  */
404
616
  resourceShareAssociations?: ResourceShareAssociationList;
405
617
  /**
@@ -417,17 +629,17 @@ declare namespace RAM {
417
629
  }
418
630
  export interface GetPermissionRequest {
419
631
  /**
420
- * Specifies the Amazon Resoure Name (ARN) of the permission whose contents you want to retrieve. To find the ARN for a permission, use either the ListPermissions operation or go to the Permissions library page in the RAM console and then choose the name of the permission. The ARN is displayed on the detail page.
632
+ * Specifies the Amazon Resource Name (ARN) of the permission whose contents you want to retrieve. To find the ARN for a permission, use either the ListPermissions operation or go to the Permissions library page in the RAM console and then choose the name of the permission. The ARN is displayed on the detail page.
421
633
  */
422
634
  permissionArn: String;
423
635
  /**
424
- * Specifies identifier for the version of the RAM permission to retrieve. If you don't specify this parameter, the operation retrieves the default version.
636
+ * Specifies the version number of the RAM permission to retrieve. If you don't specify this parameter, the operation retrieves the default version. To see the list of available versions, use ListPermissionVersions.
425
637
  */
426
638
  permissionVersion?: Integer;
427
639
  }
428
640
  export interface GetPermissionResponse {
429
641
  /**
430
- * An object that contains information about the permission.
642
+ * An object with details about the permission.
431
643
  */
432
644
  permission?: ResourceSharePermissionDetail;
433
645
  }
@@ -461,7 +673,7 @@ declare namespace RAM {
461
673
  }
462
674
  export interface GetResourceShareAssociationsRequest {
463
675
  /**
464
- * Specifies whether you want to retrieve the associations that involve a specified resource or principal. PRINCIPAL – list the principals that are associated with the specified resource share. RESOURCE – list the resources that are associated with the specified resource share.
676
+ * Specifies whether you want to retrieve the associations that involve a specified resource or principal. PRINCIPAL – list the principals whose associations you want to see. RESOURCE – list the resources whose associations you want to see.
465
677
  */
466
678
  associationType: ResourceShareAssociationType;
467
679
  /**
@@ -469,15 +681,15 @@ declare namespace RAM {
469
681
  */
470
682
  resourceShareArns?: ResourceShareArnList;
471
683
  /**
472
- * Specifies the Amazon Resoure Name (ARN) of the resource whose resource shares you want to retrieve. You cannot specify this parameter if the association type is PRINCIPAL.
684
+ * Specifies the Amazon Resource Name (ARN) of a resource whose resource shares you want to retrieve. You cannot specify this parameter if the association type is PRINCIPAL.
473
685
  */
474
686
  resourceArn?: String;
475
687
  /**
476
- * Specifies the ID of the principal whose resource shares you want to retrieve. This can be an Amazon Web Services account ID, an organization ID, an organizational unit ID, or the Amazon Resoure Name (ARN) of an individual IAM user or role. You cannot specify this parameter if the association type is RESOURCE.
688
+ * Specifies the ID of the principal whose resource shares you want to retrieve. This can be an Amazon Web Services account ID, an organization ID, an organizational unit ID, or the Amazon Resource Name (ARN) of an individual IAM user or role. You cannot specify this parameter if the association type is RESOURCE.
477
689
  */
478
690
  principal?: String;
479
691
  /**
480
- * Specifies that you want to retrieve only associations with this status.
692
+ * Specifies that you want to retrieve only associations that have this status.
481
693
  */
482
694
  associationStatus?: ResourceShareAssociationStatus;
483
695
  /**
@@ -557,9 +769,13 @@ declare namespace RAM {
557
769
  */
558
770
  maxResults?: MaxResults;
559
771
  /**
560
- * Specifies that you want to retrieve details of only those resource shares that use the RAM permission with this Amazon Resoure Name (ARN).
772
+ * Specifies that you want to retrieve details of only those resource shares that use the managed permission with this Amazon Resource Name (ARN).
561
773
  */
562
774
  permissionArn?: String;
775
+ /**
776
+ * Specifies that you want to retrieve details for only those resource shares that use the specified version of the managed permission.
777
+ */
778
+ permissionVersion?: Integer;
563
779
  }
564
780
  export interface GetResourceSharesResponse {
565
781
  /**
@@ -574,7 +790,7 @@ declare namespace RAM {
574
790
  export type Integer = number;
575
791
  export interface ListPendingInvitationResourcesRequest {
576
792
  /**
577
- * Specifies the Amazon Resoure Name (ARN) of the invitation. You can use GetResourceShareInvitations to find the ARN of the invitation.
793
+ * Specifies the Amazon Resource Name (ARN) of the invitation. You can use GetResourceShareInvitations to find the ARN of the invitation.
578
794
  */
579
795
  resourceShareInvitationArn: String;
580
796
  /**
@@ -600,9 +816,53 @@ declare namespace RAM {
600
816
  */
601
817
  nextToken?: String;
602
818
  }
819
+ export interface ListPermissionAssociationsRequest {
820
+ /**
821
+ * Specifies the Amazon Resource Name (ARN) of the managed permission.
822
+ */
823
+ permissionArn?: String;
824
+ /**
825
+ * Specifies that you want to list only those associations with resource shares that use this version of the managed permission. If you don't provide a value for this parameter, then the operation returns information about associations with resource shares that use any version of the managed permission.
826
+ */
827
+ permissionVersion?: Integer;
828
+ /**
829
+ * Specifies that you want to list only those associations with resource shares that match this status.
830
+ */
831
+ associationStatus?: ResourceShareAssociationStatus;
832
+ /**
833
+ * Specifies that you want to list only those associations with resource shares that include at least one resource of this resource type.
834
+ */
835
+ resourceType?: String;
836
+ /**
837
+ * Specifies that you want to list only those associations with resource shares that have a featureSet with this value.
838
+ */
839
+ featureSet?: PermissionFeatureSet;
840
+ /**
841
+ * When true, specifies that you want to list only those associations with resource shares that use the default version of the specified managed permission. When false (the default value), lists associations with resource shares that use any version of the specified managed permission.
842
+ */
843
+ defaultVersion?: Boolean;
844
+ /**
845
+ * Specifies that you want to receive the next page of results. Valid only if you received a NextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's NextToken response to request the next page of results.
846
+ */
847
+ nextToken?: String;
848
+ /**
849
+ * Specifies the total number of results that you want included on each page of the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the number you specify, the NextToken response element is returned with a value (not null). Include the specified value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that the service might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.
850
+ */
851
+ maxResults?: MaxResults;
852
+ }
853
+ export interface ListPermissionAssociationsResponse {
854
+ /**
855
+ * A structure with information about this customer managed permission.
856
+ */
857
+ permissions?: AssociatedPermissionList;
858
+ /**
859
+ * If present, this value indicates that more output is available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null. This indicates that this is the last page of results.
860
+ */
861
+ nextToken?: String;
862
+ }
603
863
  export interface ListPermissionVersionsRequest {
604
864
  /**
605
- * Specifies the Amazon Resoure Name (ARN) of the RAM permission whose versions you want to list. You can use the permissionVersion parameter on the AssociateResourceSharePermission operation to specify a non-default version to attach.
865
+ * Specifies the Amazon Resource Name (ARN) of the RAM permission whose versions you want to list. You can use the permissionVersion parameter on the AssociateResourceSharePermission operation to specify a non-default version to attach.
606
866
  */
607
867
  permissionArn: String;
608
868
  /**
@@ -626,7 +886,7 @@ declare namespace RAM {
626
886
  }
627
887
  export interface ListPermissionsRequest {
628
888
  /**
629
- * Specifies that you want to list permissions for only the specified resource type. For example, to list only permissions that apply to EC2 subnets, specify ec2:Subnet. You can use the ListResourceTypes operation to get the specific string required.
889
+ * Specifies that you want to list only those permissions that apply to the specified resource type. This parameter is not case sensitive. For example, to list only permissions that apply to Amazon EC2 subnets, specify ec2:subnet. You can use the ListResourceTypes operation to get the specific string required.
630
890
  */
631
891
  resourceType?: String;
632
892
  /**
@@ -637,6 +897,10 @@ declare namespace RAM {
637
897
  * Specifies the total number of results that you want included on each page of the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the number you specify, the NextToken response element is returned with a value (not null). Include the specified value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that the service might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.
638
898
  */
639
899
  maxResults?: MaxResults;
900
+ /**
901
+ * Specifies that you want to list only permissions of this type: AWS – returns only Amazon Web Services managed permissions. LOCAL – returns only customer managed permissions ALL – returns both Amazon Web Services managed permissions and customer managed permissions. If you don't specify this parameter, the default is All.
902
+ */
903
+ permissionType?: PermissionTypeFilter;
640
904
  }
641
905
  export interface ListPermissionsResponse {
642
906
  /**
@@ -654,11 +918,11 @@ declare namespace RAM {
654
918
  */
655
919
  resourceOwner: ResourceOwner;
656
920
  /**
657
- * Specifies that you want to list principal information for the resource share with the specified Amazon Resoure Name (ARN).
921
+ * Specifies that you want to list principal information for the resource share with the specified Amazon Resource Name (ARN).
658
922
  */
659
923
  resourceArn?: String;
660
924
  /**
661
- * Specifies that you want to list information for only the listed principals. You can include the following values: An Amazon Web Services account ID, for example: 123456789012 An Amazon Resoure Name (ARN) of an organization in Organizations, for example: organizations::123456789012:organization/o-exampleorgid An ARN of an organizational unit (OU) in Organizations, for example: organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123 An ARN of an IAM role, for example: iam::123456789012:role/rolename An ARN of an IAM user, for example: iam::123456789012user/username Not all resource types can be shared with IAM roles and users. For more information, see Sharing with IAM roles and users in the Resource Access Manager User Guide.
925
+ * Specifies that you want to list information for only the listed principals. You can include the following values: An Amazon Web Services account ID, for example: 123456789012 An Amazon Resource Name (ARN) of an organization in Organizations, for example: organizations::123456789012:organization/o-exampleorgid An ARN of an organizational unit (OU) in Organizations, for example: organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123 An ARN of an IAM role, for example: iam::123456789012:role/rolename An ARN of an IAM user, for example: iam::123456789012user/username Not all resource types can be shared with IAM roles and users. For more information, see Sharing with IAM roles and users in the Resource Access Manager User Guide.
662
926
  */
663
927
  principals?: PrincipalArnOrIdList;
664
928
  /**
@@ -688,9 +952,37 @@ declare namespace RAM {
688
952
  */
689
953
  nextToken?: String;
690
954
  }
955
+ export interface ListReplacePermissionAssociationsWorkRequest {
956
+ /**
957
+ * A list of IDs. These values come from the idfield of the replacePermissionAssociationsWorkstructure returned by the ReplacePermissionAssociations operation.
958
+ */
959
+ workIds?: ReplacePermissionAssociationsWorkIdList;
960
+ /**
961
+ * Specifies that you want to see only the details about requests with a status that matches this value.
962
+ */
963
+ status?: ReplacePermissionAssociationsWorkStatus;
964
+ /**
965
+ * Specifies that you want to receive the next page of results. Valid only if you received a NextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's NextToken response to request the next page of results.
966
+ */
967
+ nextToken?: String;
968
+ /**
969
+ * Specifies the total number of results that you want included on each page of the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the number you specify, the NextToken response element is returned with a value (not null). Include the specified value as the NextToken request parameter in the next call to the operation to get the next part of the results. Note that the service might return fewer results than the maximum even when there are more results available. You should check NextToken after every operation to ensure that you receive all of the results.
970
+ */
971
+ maxResults?: MaxResults;
972
+ }
973
+ export interface ListReplacePermissionAssociationsWorkResponse {
974
+ /**
975
+ * An array of data structures that provide details of the matching work IDs.
976
+ */
977
+ replacePermissionAssociationsWorks?: ReplacePermissionAssociationsWorkList;
978
+ /**
979
+ * If present, this value indicates that more output is available than is included in the current response. Use this value in the NextToken request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken response element comes back as null. This indicates that this is the last page of results.
980
+ */
981
+ nextToken?: String;
982
+ }
691
983
  export interface ListResourceSharePermissionsRequest {
692
984
  /**
693
- * Specifies the Amazon Resoure Name (ARN) of the resource share for which you want to retrieve the associated permissions.
985
+ * Specifies the Amazon Resource Name (ARN) of the resource share for which you want to retrieve the associated permissions.
694
986
  */
695
987
  resourceShareArn: String;
696
988
  /**
@@ -782,15 +1074,20 @@ declare namespace RAM {
782
1074
  }
783
1075
  export type MaxResults = number;
784
1076
  export type PermissionArnList = String[];
1077
+ export type PermissionFeatureSet = "CREATED_FROM_POLICY"|"PROMOTING_TO_STANDARD"|"STANDARD"|string;
1078
+ export type PermissionName = string;
1079
+ export type PermissionStatus = "ATTACHABLE"|"UNATTACHABLE"|"DELETING"|"DELETED"|string;
1080
+ export type PermissionType = "CUSTOMER_MANAGED"|"AWS_MANAGED"|string;
1081
+ export type PermissionTypeFilter = "ALL"|"AWS_MANAGED"|"CUSTOMER_MANAGED"|string;
785
1082
  export type Policy = string;
786
1083
  export type PolicyList = Policy[];
787
1084
  export interface Principal {
788
1085
  /**
789
- * The ID of the principal.
1086
+ * The ID of the principal that can be associated with a resource share.
790
1087
  */
791
1088
  id?: String;
792
1089
  /**
793
- * The Amazon Resoure Name (ARN) of a resource share the principal is associated with.
1090
+ * The Amazon Resource Name (ARN) of a resource share the principal is associated with.
794
1091
  */
795
1092
  resourceShareArn?: String;
796
1093
  /**
@@ -798,19 +1095,40 @@ declare namespace RAM {
798
1095
  */
799
1096
  creationTime?: DateTime;
800
1097
  /**
801
- * The date and time when the association was last updated.
1098
+ * The date and time when the association between the resource share and the principal was last updated.
802
1099
  */
803
1100
  lastUpdatedTime?: DateTime;
804
1101
  /**
805
- * Indicates whether the principal belongs to the same organization in Organizations as the Amazon Web Services account that owns the resource share.
1102
+ * Indicates the relationship between the Amazon Web Services account the principal belongs to and the account that owns the resource share: True – The two accounts belong to same organization. False – The two accounts do not belong to the same organization.
806
1103
  */
807
1104
  external?: Boolean;
808
1105
  }
809
1106
  export type PrincipalArnOrIdList = String[];
810
1107
  export type PrincipalList = Principal[];
1108
+ export interface PromotePermissionCreatedFromPolicyRequest {
1109
+ /**
1110
+ * Specifies the Amazon Resource Name (ARN) of the CREATED_FROM_POLICY permission that you want to promote. You can get this Amazon Resource Name (ARN) by calling the ListResourceSharePermissions operation.
1111
+ */
1112
+ permissionArn: String;
1113
+ /**
1114
+ * Specifies a name for the promoted customer managed permission.
1115
+ */
1116
+ name: String;
1117
+ /**
1118
+ * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you. If you retry the operation with the same ClientToken, but with different parameters, the retry fails with an IdempotentParameterMismatch error.
1119
+ */
1120
+ clientToken?: String;
1121
+ }
1122
+ export interface PromotePermissionCreatedFromPolicyResponse {
1123
+ permission?: ResourceSharePermissionSummary;
1124
+ /**
1125
+ * The idempotency identifier associated with this request. If you want to repeat the same operation in an idempotent manner then you must include this value in the clientToken request parameter of that later call. All other parameters must also have the same values that you used in the first call.
1126
+ */
1127
+ clientToken?: String;
1128
+ }
811
1129
  export interface PromoteResourceShareCreatedFromPolicyRequest {
812
1130
  /**
813
- * Specifies the Amazon Resoure Name (ARN) of the resource share to promote.
1131
+ * Specifies the Amazon Resource Name (ARN) of the resource share to promote.
814
1132
  */
815
1133
  resourceShareArn: String;
816
1134
  }
@@ -822,11 +1140,11 @@ declare namespace RAM {
822
1140
  }
823
1141
  export interface RejectResourceShareInvitationRequest {
824
1142
  /**
825
- * Specifies the Amazon Resoure Name (ARN) of the invitation that you want to reject.
1143
+ * Specifies the Amazon Resource Name (ARN) of the invitation that you want to reject.
826
1144
  */
827
1145
  resourceShareInvitationArn: String;
828
1146
  /**
829
- * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you.
1147
+ * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you. If you retry the operation with the same ClientToken, but with different parameters, the retry fails with an IdempotentParameterMismatch error.
830
1148
  */
831
1149
  clientToken?: String;
832
1150
  }
@@ -840,21 +1158,90 @@ declare namespace RAM {
840
1158
  */
841
1159
  clientToken?: String;
842
1160
  }
1161
+ export interface ReplacePermissionAssociationsRequest {
1162
+ /**
1163
+ * Specifies the Amazon Resource Name (ARN) of the managed permission that you want to replace.
1164
+ */
1165
+ fromPermissionArn: String;
1166
+ /**
1167
+ * Specifies that you want to updated the permissions for only those resource shares that use the specified version of the managed permission.
1168
+ */
1169
+ fromPermissionVersion?: Integer;
1170
+ /**
1171
+ * Specifies the ARN of the managed permission that you want to associate with resource shares in place of the one specified by fromPerssionArn and fromPermissionVersion. The operation always associates the version that is currently the default for the specified managed permission.
1172
+ */
1173
+ toPermissionArn: String;
1174
+ /**
1175
+ * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you. If you retry the operation with the same ClientToken, but with different parameters, the retry fails with an IdempotentParameterMismatch error.
1176
+ */
1177
+ clientToken?: String;
1178
+ }
1179
+ export interface ReplacePermissionAssociationsResponse {
1180
+ /**
1181
+ * Specifies a data structure that you can use to track the asynchronous tasks that RAM performs to complete this operation. You can use the ListReplacePermissionAssociationsWork operation and pass the id value returned in this structure.
1182
+ */
1183
+ replacePermissionAssociationsWork?: ReplacePermissionAssociationsWork;
1184
+ /**
1185
+ * The idempotency identifier associated with this request. If you want to repeat the same operation in an idempotent manner then you must include this value in the clientToken request parameter of that later call. All other parameters must also have the same values that you used in the first call.
1186
+ */
1187
+ clientToken?: String;
1188
+ }
1189
+ export interface ReplacePermissionAssociationsWork {
1190
+ /**
1191
+ * The unique identifier for the background task associated with one ReplacePermissionAssociations request.
1192
+ */
1193
+ id?: String;
1194
+ /**
1195
+ * The Amazon Resource Name (ARN) of the managed permission that this background task is replacing.
1196
+ */
1197
+ fromPermissionArn?: String;
1198
+ /**
1199
+ * The version of the managed permission that this background task is replacing.
1200
+ */
1201
+ fromPermissionVersion?: String;
1202
+ /**
1203
+ * The ARN of the managed permission that this background task is associating with the resource shares in place of the managed permission and version specified in fromPermissionArn and fromPermissionVersion.
1204
+ */
1205
+ toPermissionArn?: String;
1206
+ /**
1207
+ * The version of the managed permission that this background task is associating with the resource shares. This is always the version that is currently the default for this managed permission.
1208
+ */
1209
+ toPermissionVersion?: String;
1210
+ /**
1211
+ * Specifies the current status of the background tasks for the specified ID. The output is one of the following strings: IN_PROGRESS COMPLETED FAILED
1212
+ */
1213
+ status?: ReplacePermissionAssociationsWorkStatus;
1214
+ /**
1215
+ * Specifies the reason for a FAILED status. This field is present only when there status is FAILED.
1216
+ */
1217
+ statusMessage?: String;
1218
+ /**
1219
+ * The date and time when this asynchronous background task was created.
1220
+ */
1221
+ creationTime?: DateTime;
1222
+ /**
1223
+ * The date and time when the status of this background task was last updated.
1224
+ */
1225
+ lastUpdatedTime?: DateTime;
1226
+ }
1227
+ export type ReplacePermissionAssociationsWorkIdList = String[];
1228
+ export type ReplacePermissionAssociationsWorkList = ReplacePermissionAssociationsWork[];
1229
+ export type ReplacePermissionAssociationsWorkStatus = "IN_PROGRESS"|"COMPLETED"|"FAILED"|string;
843
1230
  export interface Resource {
844
1231
  /**
845
- * The Amazon Resoure Name (ARN) of the resource.
1232
+ * The Amazon Resource Name (ARN) of the resource.
846
1233
  */
847
1234
  arn?: String;
848
1235
  /**
849
- * The resource type. This takes the form of: service-code:resource-code
1236
+ * The resource type. This takes the form of: service-code:resource-code, and is case-insensitive. For example, an Amazon EC2 Subnet would be represented by the string ec2:subnet.
850
1237
  */
851
1238
  type?: String;
852
1239
  /**
853
- * The Amazon Resoure Name (ARN) of the resource share this resource is associated with.
1240
+ * The Amazon Resource Name (ARN) of the resource share this resource is associated with.
854
1241
  */
855
1242
  resourceShareArn?: String;
856
1243
  /**
857
- * The Amazon Resoure Name (ARN) of the resource group. This value is available only if the resource is part of a resource group.
1244
+ * The Amazon Resource Name (ARN) of the resource group. This value is available only if the resource is part of a resource group.
858
1245
  */
859
1246
  resourceGroupArn?: String;
860
1247
  /**
@@ -870,7 +1257,7 @@ declare namespace RAM {
870
1257
  */
871
1258
  creationTime?: DateTime;
872
1259
  /**
873
- * The date an time when the association was last updated.
1260
+ * The date an time when the association between the resource and the resource share was last updated.
874
1261
  */
875
1262
  lastUpdatedTime?: DateTime;
876
1263
  /**
@@ -885,7 +1272,7 @@ declare namespace RAM {
885
1272
  export type ResourceRegionScopeFilter = "ALL"|"REGIONAL"|"GLOBAL"|string;
886
1273
  export interface ResourceShare {
887
1274
  /**
888
- * The Amazon Resoure Name (ARN) of the resource share
1275
+ * The Amazon Resource Name (ARN) of the resource share
889
1276
  */
890
1277
  resourceShareArn?: String;
891
1278
  /**
@@ -897,7 +1284,7 @@ declare namespace RAM {
897
1284
  */
898
1285
  owningAccountId?: String;
899
1286
  /**
900
- * Indicates whether principals outside your organization in Organizations can be associated with a resource share.
1287
+ * Indicates whether principals outside your organization in Organizations can be associated with a resource share. True – the resource share can be shared with any Amazon Web Services account. False – the resource share can be shared with only accounts in the same organization as the account that owns the resource share.
901
1288
  */
902
1289
  allowExternalPrincipals?: Boolean;
903
1290
  /**
@@ -921,14 +1308,14 @@ declare namespace RAM {
921
1308
  */
922
1309
  lastUpdatedTime?: DateTime;
923
1310
  /**
924
- * Indicates how the resource share was created. Possible values include: CREATED_FROM_POLICY - Indicates that the resource share was created from an Identity and Access Management (IAM) resource-based permission policy attached to the resource. This type of resource share is visible only to the Amazon Web Services account that created it. You can't modify it in RAM unless you promote it. For more information, see PromoteResourceShareCreatedFromPolicy. PROMOTING_TO_STANDARD - The resource share is in the process of being promoted. For more information, see PromoteResourceShareCreatedFromPolicy. STANDARD - Indicates that the resource share was created in RAM using the console or APIs. These resource shares are visible to all principals you share the resource share with. You can modify these resource shares in RAM using the console or APIs.
1311
+ * Indicates what features are available for this resource share. This parameter can have one of the following values: STANDARD A resource share that supports all functionality. These resource shares are visible to all principals you share the resource share with. You can modify these resource shares in RAM using the console or APIs. This resource share might have been created by RAM, or it might have been CREATED_FROM_POLICY and then promoted. CREATED_FROM_POLICY The customer manually shared a resource by attaching a resource-based policy. That policy did not match any existing managed permissions, so RAM created this customer managed permission automatically on the customer's behalf based on the attached policy document. This type of resource share is visible only to the Amazon Web Services account that created it. You can't modify it in RAM unless you promote it. For more information, see PromoteResourceShareCreatedFromPolicy. PROMOTING_TO_STANDARD This resource share was originally CREATED_FROM_POLICY, but the customer ran the PromoteResourceShareCreatedFromPolicy and that operation is still in progress. This value changes to STANDARD when complete.
925
1312
  */
926
1313
  featureSet?: ResourceShareFeatureSet;
927
1314
  }
928
1315
  export type ResourceShareArnList = String[];
929
1316
  export interface ResourceShareAssociation {
930
1317
  /**
931
- * The Amazon Resoure Name (ARN) of the resource share.
1318
+ * The Amazon Resource Name (ARN) of the resource share.
932
1319
  */
933
1320
  resourceShareArn?: String;
934
1321
  /**
@@ -936,7 +1323,7 @@ declare namespace RAM {
936
1323
  */
937
1324
  resourceShareName?: String;
938
1325
  /**
939
- * The associated entity. This can be either of the following: For a resource association, this is the Amazon Resoure Name (ARN) of the resource. For principal associations, this is one of the following: The ID of an Amazon Web Services account The Amazon Resoure Name (ARN) of an organization in Organizations The ARN of an organizational unit (OU) in Organizations The ARN of an IAM role The ARN of an IAM user
1326
+ * The associated entity. This can be either of the following: For a resource association, this is the Amazon Resource Name (ARN) of the resource. For principal associations, this is one of the following: The ID of an Amazon Web Services account The Amazon Resource Name (ARN) of an organization in Organizations The ARN of an organizational unit (OU) in Organizations The ARN of an IAM role The ARN of an IAM user
940
1327
  */
941
1328
  associatedEntity?: String;
942
1329
  /**
@@ -970,7 +1357,7 @@ declare namespace RAM {
970
1357
  export type ResourceShareFeatureSet = "CREATED_FROM_POLICY"|"PROMOTING_TO_STANDARD"|"STANDARD"|string;
971
1358
  export interface ResourceShareInvitation {
972
1359
  /**
973
- * The Amazon Resoure Name (ARN) of the invitation.
1360
+ * The Amazon Resource Name (ARN) of the invitation.
974
1361
  */
975
1362
  resourceShareInvitationArn?: String;
976
1363
  /**
@@ -978,7 +1365,7 @@ declare namespace RAM {
978
1365
  */
979
1366
  resourceShareName?: String;
980
1367
  /**
981
- * The Amazon Resoure Name (ARN) of the resource share
1368
+ * The Amazon Resource Name (ARN) of the resource share
982
1369
  */
983
1370
  resourceShareArn?: String;
984
1371
  /**
@@ -1002,7 +1389,7 @@ declare namespace RAM {
1002
1389
  */
1003
1390
  resourceShareAssociations?: ResourceShareAssociationList;
1004
1391
  /**
1005
- * The Amazon Resoure Name (ARN) of the IAM user or role that received the invitation.
1392
+ * The Amazon Resource Name (ARN) of the IAM user or role that received the invitation.
1006
1393
  */
1007
1394
  receiverArn?: String;
1008
1395
  }
@@ -1012,15 +1399,15 @@ declare namespace RAM {
1012
1399
  export type ResourceShareList = ResourceShare[];
1013
1400
  export interface ResourceSharePermissionDetail {
1014
1401
  /**
1015
- * The Amazon Resoure Name (ARN) of this RAM permission.
1402
+ * The Amazon Resource Name (ARN) of this RAM managed permission.
1016
1403
  */
1017
1404
  arn?: String;
1018
1405
  /**
1019
- * The version of the permission represented in this structure.
1406
+ * The version of the permission described in this response.
1020
1407
  */
1021
1408
  version?: String;
1022
1409
  /**
1023
- * Specifies whether the version of the permission represented in this structure is the default version for this permission.
1410
+ * Specifies whether the version of the permission represented in this response is the default version for this permission.
1024
1411
  */
1025
1412
  defaultVersion?: Boolean;
1026
1413
  /**
@@ -1044,30 +1431,46 @@ declare namespace RAM {
1044
1431
  */
1045
1432
  lastUpdatedTime?: DateTime;
1046
1433
  /**
1047
- * Specifies whether the version of the permission represented in this structure is the default version for all resources of this resource type.
1434
+ * Specifies whether the version of the permission represented in this response is the default version for all resources of this resource type.
1048
1435
  */
1049
1436
  isResourceTypeDefault?: Boolean;
1437
+ /**
1438
+ * The type of managed permission. This can be one of the following values: AWS_MANAGED – Amazon Web Services created and manages this managed permission. You can associate it with your resource shares, but you can't modify it. CUSTOMER_MANAGED – You, or another principal in your account created this managed permission. You can associate it with your resource shares and create new versions that have different permissions.
1439
+ */
1440
+ permissionType?: PermissionType;
1441
+ /**
1442
+ * Indicates what features are available for this resource share. This parameter can have one of the following values: STANDARD – A resource share that supports all functionality. These resource shares are visible to all principals you share the resource share with. You can modify these resource shares in RAM using the console or APIs. This resource share might have been created by RAM, or it might have been CREATED_FROM_POLICY and then promoted. CREATED_FROM_POLICY – The customer manually shared a resource by attaching a resource-based policy. That policy did not match any existing managed permissions, so RAM created this customer managed permission automatically on the customer's behalf based on the attached policy document. This type of resource share is visible only to the Amazon Web Services account that created it. You can't modify it in RAM unless you promote it. For more information, see PromoteResourceShareCreatedFromPolicy. PROMOTING_TO_STANDARD – This resource share was originally CREATED_FROM_POLICY, but the customer ran the PromoteResourceShareCreatedFromPolicy and that operation is still in progress. This value changes to STANDARD when complete.
1443
+ */
1444
+ featureSet?: PermissionFeatureSet;
1445
+ /**
1446
+ * The current status of the association between the permission and the resource share. The following are the possible values: ATTACHABLE – This permission or version can be associated with resource shares. UNATTACHABLE – This permission or version can't currently be associated with resource shares. DELETING – This permission or version is in the process of being deleted. DELETED – This permission or version is deleted.
1447
+ */
1448
+ status?: PermissionStatus;
1449
+ /**
1450
+ * The tag key and value pairs attached to the resource share.
1451
+ */
1452
+ tags?: TagList;
1050
1453
  }
1051
1454
  export type ResourceSharePermissionList = ResourceSharePermissionSummary[];
1052
1455
  export interface ResourceSharePermissionSummary {
1053
1456
  /**
1054
- * The Amazon Resoure Name (ARN) of the permission you want information about.
1457
+ * The Amazon Resource Name (ARN) of the permission you want information about.
1055
1458
  */
1056
1459
  arn?: String;
1057
1460
  /**
1058
- * The version of the permission represented in this structure.
1461
+ * The version of the permission associated with this resource share.
1059
1462
  */
1060
1463
  version?: String;
1061
1464
  /**
1062
- * Specifies whether the version of the permission represented in this structure is the default version for this permission.
1465
+ * Specifies whether the version of the managed permission used by this resource share is the default version for this managed permission.
1063
1466
  */
1064
1467
  defaultVersion?: Boolean;
1065
1468
  /**
1066
- * The name of this permission.
1469
+ * The name of this managed permission.
1067
1470
  */
1068
1471
  name?: String;
1069
1472
  /**
1070
- * The type of resource to which this permission applies.
1473
+ * The type of resource to which this permission applies. This takes the form of: service-code:resource-code, and is case-insensitive. For example, an Amazon EC2 Subnet would be represented by the string ec2:subnet.
1071
1474
  */
1072
1475
  resourceType?: String;
1073
1476
  /**
@@ -1083,15 +1486,27 @@ declare namespace RAM {
1083
1486
  */
1084
1487
  lastUpdatedTime?: DateTime;
1085
1488
  /**
1086
- * Specifies whether the version of the permission represented in this structure is the default version for all resources of this resource type.
1489
+ * Specifies whether the managed permission associated with this resource share is the default managed permission for all resources of this resource type.
1087
1490
  */
1088
1491
  isResourceTypeDefault?: Boolean;
1492
+ /**
1493
+ * The type of managed permission. This can be one of the following values: AWS_MANAGED – Amazon Web Services created and manages this managed permission. You can associate it with your resource shares, but you can't modify it. CUSTOMER_MANAGED – You, or another principal in your account created this managed permission. You can associate it with your resource shares and create new versions that have different permissions.
1494
+ */
1495
+ permissionType?: PermissionType;
1496
+ /**
1497
+ * Indicates what features are available for this resource share. This parameter can have one of the following values: STANDARD – A resource share that supports all functionality. These resource shares are visible to all principals you share the resource share with. You can modify these resource shares in RAM using the console or APIs. This resource share might have been created by RAM, or it might have been CREATED_FROM_POLICY and then promoted. CREATED_FROM_POLICY – The customer manually shared a resource by attaching a resource-based policy. That policy did not match any existing managed permissions, so RAM created this customer managed permission automatically on the customer's behalf based on the attached policy document. This type of resource share is visible only to the Amazon Web Services account that created it. You can't modify it in RAM unless you promote it. For more information, see PromoteResourceShareCreatedFromPolicy. PROMOTING_TO_STANDARD – This resource share was originally CREATED_FROM_POLICY, but the customer ran the PromoteResourceShareCreatedFromPolicy and that operation is still in progress. This value changes to STANDARD when complete.
1498
+ */
1499
+ featureSet?: PermissionFeatureSet;
1500
+ /**
1501
+ * A list of the tag key value pairs currently attached to the permission.
1502
+ */
1503
+ tags?: TagList;
1089
1504
  }
1090
1505
  export type ResourceShareStatus = "PENDING"|"ACTIVE"|"FAILED"|"DELETING"|"DELETED"|string;
1091
1506
  export type ResourceStatus = "AVAILABLE"|"ZONAL_RESOURCE_INACCESSIBLE"|"LIMIT_EXCEEDED"|"UNAVAILABLE"|"PENDING"|string;
1092
1507
  export interface ServiceNameAndResourceType {
1093
1508
  /**
1094
- * The type of the resource.
1509
+ * The type of the resource. This takes the form of: service-code:resource-code, and is case-insensitive. For example, an Amazon EC2 Subnet would be represented by the string ec2:subnet.
1095
1510
  */
1096
1511
  resourceType?: String;
1097
1512
  /**
@@ -1104,6 +1519,30 @@ declare namespace RAM {
1104
1519
  resourceRegionScope?: ResourceRegionScope;
1105
1520
  }
1106
1521
  export type ServiceNameAndResourceTypeList = ServiceNameAndResourceType[];
1522
+ export interface SetDefaultPermissionVersionRequest {
1523
+ /**
1524
+ * Specifies the Amazon Resource Name (ARN) of the customer managed permission whose default version you want to change.
1525
+ */
1526
+ permissionArn: String;
1527
+ /**
1528
+ * Specifies the version number that you want to designate as the default for customer managed permission. To see a list of all available version numbers, use ListPermissionVersions.
1529
+ */
1530
+ permissionVersion: Integer;
1531
+ /**
1532
+ * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you. If you retry the operation with the same ClientToken, but with different parameters, the retry fails with an IdempotentParameterMismatch error.
1533
+ */
1534
+ clientToken?: String;
1535
+ }
1536
+ export interface SetDefaultPermissionVersionResponse {
1537
+ /**
1538
+ * A boolean value that indicates whether the operation was successful.
1539
+ */
1540
+ returnValue?: Boolean;
1541
+ /**
1542
+ * The idempotency identifier associated with this request. If you want to repeat the same operation in an idempotent manner then you must include this value in the clientToken request parameter of that later call. All other parameters must also have the same values that you used in the first call.
1543
+ */
1544
+ clientToken?: String;
1545
+ }
1107
1546
  export type String = string;
1108
1547
  export interface Tag {
1109
1548
  /**
@@ -1131,13 +1570,17 @@ declare namespace RAM {
1131
1570
  export type TagList = Tag[];
1132
1571
  export interface TagResourceRequest {
1133
1572
  /**
1134
- * Specifies the Amazon Resoure Name (ARN) of the resource share that you want to add tags to.
1573
+ * Specifies the Amazon Resource Name (ARN) of the resource share that you want to add tags to. You must specify either resourceShareArn, or resourceArn, but not both.
1135
1574
  */
1136
- resourceShareArn: String;
1575
+ resourceShareArn?: String;
1137
1576
  /**
1138
1577
  * A list of one or more tag key and value pairs. The tag key must be present and not be an empty string. The tag value must be present but can be an empty string.
1139
1578
  */
1140
1579
  tags: TagList;
1580
+ /**
1581
+ * Specifies the Amazon Resource Name (ARN) of the managed permission that you want to add tags to. You must specify either resourceArn, or resourceShareArn, but not both.
1582
+ */
1583
+ resourceArn?: String;
1141
1584
  }
1142
1585
  export interface TagResourceResponse {
1143
1586
  }
@@ -1145,19 +1588,23 @@ declare namespace RAM {
1145
1588
  export type TagValueList = TagValue[];
1146
1589
  export interface UntagResourceRequest {
1147
1590
  /**
1148
- * Specifies the Amazon Resoure Name (ARN) of the resource share that you want to remove tags from. The tags are removed from the resource share, not the resources in the resource share.
1591
+ * Specifies the Amazon Resource Name (ARN) of the resource share that you want to remove tags from. The tags are removed from the resource share, not the resources in the resource share. You must specify either resourceShareArn, or resourceArn, but not both.
1149
1592
  */
1150
- resourceShareArn: String;
1593
+ resourceShareArn?: String;
1151
1594
  /**
1152
1595
  * Specifies a list of one or more tag keys that you want to remove.
1153
1596
  */
1154
1597
  tagKeys: TagKeyList;
1598
+ /**
1599
+ * Specifies the Amazon Resource Name (ARN) of the managed permission that you want to remove tags from. You must specify either resourceArn, or resourceShareArn, but not both.
1600
+ */
1601
+ resourceArn?: String;
1155
1602
  }
1156
1603
  export interface UntagResourceResponse {
1157
1604
  }
1158
1605
  export interface UpdateResourceShareRequest {
1159
1606
  /**
1160
- * Specifies the Amazon Resoure Name (ARN) of the resource share that you want to modify.
1607
+ * Specifies the Amazon Resource Name (ARN) of the resource share that you want to modify.
1161
1608
  */
1162
1609
  resourceShareArn: String;
1163
1610
  /**
@@ -1169,7 +1616,7 @@ declare namespace RAM {
1169
1616
  */
1170
1617
  allowExternalPrincipals?: Boolean;
1171
1618
  /**
1172
- * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you.
1619
+ * Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a UUID type of value.. If you don't provide this value, then Amazon Web Services generates a random one for you. If you retry the operation with the same ClientToken, but with different parameters, the retry fails with an IdempotentParameterMismatch error.
1173
1620
  */
1174
1621
  clientToken?: String;
1175
1622
  }