@aws-sdk/client-ram 3.315.0 → 3.319.0

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 (97) hide show
  1. package/README.md +76 -5
  2. package/dist-cjs/RAM.js +47 -350
  3. package/dist-cjs/commands/CreatePermissionCommand.js +45 -0
  4. package/dist-cjs/commands/CreatePermissionVersionCommand.js +45 -0
  5. package/dist-cjs/commands/DeletePermissionCommand.js +45 -0
  6. package/dist-cjs/commands/DeletePermissionVersionCommand.js +45 -0
  7. package/dist-cjs/commands/ListPermissionAssociationsCommand.js +45 -0
  8. package/dist-cjs/commands/ListReplacePermissionAssociationsWorkCommand.js +45 -0
  9. package/dist-cjs/commands/PromotePermissionCreatedFromPolicyCommand.js +45 -0
  10. package/dist-cjs/commands/ReplacePermissionAssociationsCommand.js +45 -0
  11. package/dist-cjs/commands/SetDefaultPermissionVersionCommand.js +45 -0
  12. package/dist-cjs/commands/index.js +9 -0
  13. package/dist-cjs/endpoint/ruleset.js +3 -3
  14. package/dist-cjs/models/models_0.js +104 -1
  15. package/dist-cjs/pagination/ListPermissionAssociationsPaginator.js +29 -0
  16. package/dist-cjs/pagination/ListReplacePermissionAssociationsWorkPaginator.js +29 -0
  17. package/dist-cjs/pagination/index.js +2 -0
  18. package/dist-cjs/protocols/Aws_restJson1.js +976 -129
  19. package/dist-es/RAM.js +47 -350
  20. package/dist-es/commands/CreatePermissionCommand.js +41 -0
  21. package/dist-es/commands/CreatePermissionVersionCommand.js +41 -0
  22. package/dist-es/commands/DeletePermissionCommand.js +41 -0
  23. package/dist-es/commands/DeletePermissionVersionCommand.js +41 -0
  24. package/dist-es/commands/ListPermissionAssociationsCommand.js +41 -0
  25. package/dist-es/commands/ListReplacePermissionAssociationsWorkCommand.js +41 -0
  26. package/dist-es/commands/PromotePermissionCreatedFromPolicyCommand.js +41 -0
  27. package/dist-es/commands/ReplacePermissionAssociationsCommand.js +41 -0
  28. package/dist-es/commands/SetDefaultPermissionVersionCommand.js +41 -0
  29. package/dist-es/commands/index.js +9 -0
  30. package/dist-es/endpoint/ruleset.js +3 -3
  31. package/dist-es/models/models_0.js +97 -0
  32. package/dist-es/pagination/ListPermissionAssociationsPaginator.js +25 -0
  33. package/dist-es/pagination/ListReplacePermissionAssociationsWorkPaginator.js +25 -0
  34. package/dist-es/pagination/index.js +2 -0
  35. package/dist-es/protocols/Aws_restJson1.js +949 -121
  36. package/dist-types/RAM.d.ts +114 -113
  37. package/dist-types/RAMClient.d.ts +15 -7
  38. package/dist-types/commands/AcceptResourceShareInvitationCommand.d.ts +16 -12
  39. package/dist-types/commands/AssociateResourceShareCommand.d.ts +19 -14
  40. package/dist-types/commands/AssociateResourceSharePermissionCommand.d.ts +9 -7
  41. package/dist-types/commands/CreatePermissionCommand.d.ts +109 -0
  42. package/dist-types/commands/CreatePermissionVersionCommand.d.ts +106 -0
  43. package/dist-types/commands/CreateResourceShareCommand.d.ts +19 -13
  44. package/dist-types/commands/DeletePermissionCommand.d.ts +91 -0
  45. package/dist-types/commands/DeletePermissionVersionCommand.d.ts +96 -0
  46. package/dist-types/commands/DeleteResourceShareCommand.d.ts +19 -14
  47. package/dist-types/commands/DisassociateResourceShareCommand.d.ts +19 -13
  48. package/dist-types/commands/DisassociateResourceSharePermissionCommand.d.ts +14 -11
  49. package/dist-types/commands/EnableSharingWithAwsOrganizationCommand.d.ts +14 -11
  50. package/dist-types/commands/GetPermissionCommand.d.ts +9 -7
  51. package/dist-types/commands/GetResourcePoliciesCommand.d.ts +10 -6
  52. package/dist-types/commands/GetResourceShareAssociationsCommand.d.ts +13 -8
  53. package/dist-types/commands/GetResourceShareInvitationsCommand.d.ts +14 -8
  54. package/dist-types/commands/GetResourceSharesCommand.d.ts +11 -6
  55. package/dist-types/commands/ListPendingInvitationResourcesCommand.d.ts +15 -9
  56. package/dist-types/commands/ListPermissionAssociationsCommand.d.ts +91 -0
  57. package/dist-types/commands/ListPermissionVersionsCommand.d.ts +11 -7
  58. package/dist-types/commands/ListPermissionsCommand.d.ts +9 -5
  59. package/dist-types/commands/ListPrincipalsCommand.d.ts +10 -6
  60. package/dist-types/commands/ListReplacePermissionAssociationsWorkCommand.d.ts +84 -0
  61. package/dist-types/commands/ListResourceSharePermissionsCommand.d.ts +11 -7
  62. package/dist-types/commands/ListResourceTypesCommand.d.ts +7 -4
  63. package/dist-types/commands/ListResourcesCommand.d.ts +11 -7
  64. package/dist-types/commands/PromotePermissionCreatedFromPolicyCommand.d.ts +119 -0
  65. package/dist-types/commands/PromoteResourceShareCreatedFromPolicyCommand.d.ts +34 -14
  66. package/dist-types/commands/RejectResourceShareInvitationCommand.d.ts +16 -12
  67. package/dist-types/commands/ReplacePermissionAssociationsCommand.d.ts +108 -0
  68. package/dist-types/commands/SetDefaultPermissionVersionCommand.d.ts +92 -0
  69. package/dist-types/commands/TagResourceCommand.d.ts +17 -11
  70. package/dist-types/commands/UntagResourceCommand.d.ts +14 -5
  71. package/dist-types/commands/UpdateResourceShareCommand.d.ts +13 -11
  72. package/dist-types/commands/index.d.ts +9 -0
  73. package/dist-types/endpoint/EndpointParameters.d.ts +1 -1
  74. package/dist-types/models/models_0.d.ts +1286 -195
  75. package/dist-types/pagination/ListPermissionAssociationsPaginator.d.ts +7 -0
  76. package/dist-types/pagination/ListReplacePermissionAssociationsWorkPaginator.d.ts +7 -0
  77. package/dist-types/pagination/index.d.ts +2 -0
  78. package/dist-types/protocols/Aws_restJson1.d.ts +81 -0
  79. package/dist-types/ts3.4/RAM.d.ts +167 -1
  80. package/dist-types/ts3.4/RAMClient.d.ts +54 -0
  81. package/dist-types/ts3.4/commands/CreatePermissionCommand.d.ts +37 -0
  82. package/dist-types/ts3.4/commands/CreatePermissionVersionCommand.d.ts +41 -0
  83. package/dist-types/ts3.4/commands/DeletePermissionCommand.d.ts +37 -0
  84. package/dist-types/ts3.4/commands/DeletePermissionVersionCommand.d.ts +41 -0
  85. package/dist-types/ts3.4/commands/ListPermissionAssociationsCommand.d.ts +41 -0
  86. package/dist-types/ts3.4/commands/ListReplacePermissionAssociationsWorkCommand.d.ts +41 -0
  87. package/dist-types/ts3.4/commands/PromotePermissionCreatedFromPolicyCommand.d.ts +41 -0
  88. package/dist-types/ts3.4/commands/ReplacePermissionAssociationsCommand.d.ts +41 -0
  89. package/dist-types/ts3.4/commands/SetDefaultPermissionVersionCommand.d.ts +41 -0
  90. package/dist-types/ts3.4/commands/index.d.ts +9 -0
  91. package/dist-types/ts3.4/endpoint/EndpointParameters.d.ts +1 -1
  92. package/dist-types/ts3.4/models/models_0.d.ts +234 -19
  93. package/dist-types/ts3.4/pagination/ListPermissionAssociationsPaginator.d.ts +11 -0
  94. package/dist-types/ts3.4/pagination/ListReplacePermissionAssociationsWorkPaginator.d.ts +11 -0
  95. package/dist-types/ts3.4/pagination/index.d.ts +2 -0
  96. package/dist-types/ts3.4/protocols/Aws_restJson1.d.ts +108 -0
  97. package/package.json +8 -8
@@ -0,0 +1,109 @@
1
+ import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
2
+ import { Command as $Command } from "@aws-sdk/smithy-client";
3
+ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
4
+ import { CreatePermissionRequest, CreatePermissionResponse } from "../models/models_0";
5
+ import { RAMClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RAMClient";
6
+ /**
7
+ * @public
8
+ *
9
+ * The input for {@link CreatePermissionCommand}.
10
+ */
11
+ export interface CreatePermissionCommandInput extends CreatePermissionRequest {
12
+ }
13
+ /**
14
+ * @public
15
+ *
16
+ * The output of {@link CreatePermissionCommand}.
17
+ */
18
+ export interface CreatePermissionCommandOutput extends CreatePermissionResponse, __MetadataBearer {
19
+ }
20
+ /**
21
+ * @public
22
+ * <p>Creates a customer managed permission for a specified resource type that you can attach to resource shares.
23
+ * It is created in the Amazon Web Services Region in which you call the operation.</p>
24
+ * @example
25
+ * Use a bare-bones client and the command you need to make an API call.
26
+ * ```javascript
27
+ * import { RAMClient, CreatePermissionCommand } from "@aws-sdk/client-ram"; // ES Modules import
28
+ * // const { RAMClient, CreatePermissionCommand } = require("@aws-sdk/client-ram"); // CommonJS import
29
+ * const client = new RAMClient(config);
30
+ * const input = { // CreatePermissionRequest
31
+ * name: "STRING_VALUE", // required
32
+ * resourceType: "STRING_VALUE", // required
33
+ * policyTemplate: "STRING_VALUE", // required
34
+ * clientToken: "STRING_VALUE",
35
+ * tags: [ // TagList
36
+ * { // Tag
37
+ * key: "STRING_VALUE",
38
+ * value: "STRING_VALUE",
39
+ * },
40
+ * ],
41
+ * };
42
+ * const command = new CreatePermissionCommand(input);
43
+ * const response = await client.send(command);
44
+ * ```
45
+ *
46
+ * @param CreatePermissionCommandInput - {@link CreatePermissionCommandInput}
47
+ * @returns {@link CreatePermissionCommandOutput}
48
+ * @see {@link CreatePermissionCommandInput} for command's `input` shape.
49
+ * @see {@link CreatePermissionCommandOutput} for command's `response` shape.
50
+ * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
51
+ *
52
+ * @throws {@link IdempotentParameterMismatchException} (client fault)
53
+ * <p>The operation failed because the client token input parameter matched one that was
54
+ * used with a previous call to the operation, but at least one of the other input
55
+ * parameters is different from the previous call.</p>
56
+ *
57
+ * @throws {@link InvalidClientTokenException} (client fault)
58
+ * <p>The operation failed because the specified client token isn't valid.</p>
59
+ *
60
+ * @throws {@link InvalidParameterException} (client fault)
61
+ * <p>The operation failed because a parameter you specified isn't valid.</p>
62
+ *
63
+ * @throws {@link InvalidPolicyException} (client fault)
64
+ * <p>The operation failed because a policy you specified isn't valid.</p>
65
+ *
66
+ * @throws {@link MalformedPolicyTemplateException} (client fault)
67
+ * <p>The operation failed because the policy template that you provided isn't valid.</p>
68
+ *
69
+ * @throws {@link OperationNotPermittedException} (client fault)
70
+ * <p>The operation failed because the requested operation isn't permitted.</p>
71
+ *
72
+ * @throws {@link PermissionAlreadyExistsException} (client fault)
73
+ * <p>The operation failed because a permission with the specified name already exists in
74
+ * the requested Amazon Web Services Region. Choose a different name.</p>
75
+ *
76
+ * @throws {@link PermissionLimitExceededException} (client fault)
77
+ * <p>The operation failed because it would exceed the maximum number of permissions you can
78
+ * create in each Amazon Web Services Region. To view the limits for your Amazon Web Services account, see the <a href="https://console.aws.amazon.com/servicequotas/home/services/ram/quotas">RAM page in the
79
+ * Service Quotas console</a>.</p>
80
+ *
81
+ * @throws {@link ServerInternalException} (server fault)
82
+ * <p>The operation failed because the service could not respond to the request due to an
83
+ * internal problem. Try again later.</p>
84
+ *
85
+ * @throws {@link ServiceUnavailableException} (server fault)
86
+ * <p>The operation failed because the service isn't available. Try again later.</p>
87
+ *
88
+ *
89
+ */
90
+ export declare class CreatePermissionCommand extends $Command<CreatePermissionCommandInput, CreatePermissionCommandOutput, RAMClientResolvedConfig> {
91
+ readonly input: CreatePermissionCommandInput;
92
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
93
+ /**
94
+ * @public
95
+ */
96
+ constructor(input: CreatePermissionCommandInput);
97
+ /**
98
+ * @internal
99
+ */
100
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: RAMClientResolvedConfig, options?: __HttpHandlerOptions): Handler<CreatePermissionCommandInput, CreatePermissionCommandOutput>;
101
+ /**
102
+ * @internal
103
+ */
104
+ private serialize;
105
+ /**
106
+ * @internal
107
+ */
108
+ private deserialize;
109
+ }
@@ -0,0 +1,106 @@
1
+ import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
2
+ import { Command as $Command } from "@aws-sdk/smithy-client";
3
+ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
4
+ import { CreatePermissionVersionRequest, CreatePermissionVersionResponse } from "../models/models_0";
5
+ import { RAMClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RAMClient";
6
+ /**
7
+ * @public
8
+ *
9
+ * The input for {@link CreatePermissionVersionCommand}.
10
+ */
11
+ export interface CreatePermissionVersionCommandInput extends CreatePermissionVersionRequest {
12
+ }
13
+ /**
14
+ * @public
15
+ *
16
+ * The output of {@link CreatePermissionVersionCommand}.
17
+ */
18
+ export interface CreatePermissionVersionCommandOutput extends CreatePermissionVersionResponse, __MetadataBearer {
19
+ }
20
+ /**
21
+ * @public
22
+ * <p>Creates a new version of the specified customer managed permission. The new version is automatically set as
23
+ * the default version of the customer managed permission. New resource shares automatically use the default
24
+ * permission. Existing resource shares continue to use their original permission versions,
25
+ * but you can use <a>ReplacePermissionAssociations</a> to update them.</p>
26
+ * <p>If the specified customer managed permission already has the maximum of 5 versions, then
27
+ * you must delete one of the existing versions before you can create a new one.</p>
28
+ * @example
29
+ * Use a bare-bones client and the command you need to make an API call.
30
+ * ```javascript
31
+ * import { RAMClient, CreatePermissionVersionCommand } from "@aws-sdk/client-ram"; // ES Modules import
32
+ * // const { RAMClient, CreatePermissionVersionCommand } = require("@aws-sdk/client-ram"); // CommonJS import
33
+ * const client = new RAMClient(config);
34
+ * const input = { // CreatePermissionVersionRequest
35
+ * permissionArn: "STRING_VALUE", // required
36
+ * policyTemplate: "STRING_VALUE", // required
37
+ * clientToken: "STRING_VALUE",
38
+ * };
39
+ * const command = new CreatePermissionVersionCommand(input);
40
+ * const response = await client.send(command);
41
+ * ```
42
+ *
43
+ * @param CreatePermissionVersionCommandInput - {@link CreatePermissionVersionCommandInput}
44
+ * @returns {@link CreatePermissionVersionCommandOutput}
45
+ * @see {@link CreatePermissionVersionCommandInput} for command's `input` shape.
46
+ * @see {@link CreatePermissionVersionCommandOutput} for command's `response` shape.
47
+ * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
48
+ *
49
+ * @throws {@link IdempotentParameterMismatchException} (client fault)
50
+ * <p>The operation failed because the client token input parameter matched one that was
51
+ * used with a previous call to the operation, but at least one of the other input
52
+ * parameters is different from the previous call.</p>
53
+ *
54
+ * @throws {@link InvalidClientTokenException} (client fault)
55
+ * <p>The operation failed because the specified client token isn't valid.</p>
56
+ *
57
+ * @throws {@link InvalidParameterException} (client fault)
58
+ * <p>The operation failed because a parameter you specified isn't valid.</p>
59
+ *
60
+ * @throws {@link InvalidPolicyException} (client fault)
61
+ * <p>The operation failed because a policy you specified isn't valid.</p>
62
+ *
63
+ * @throws {@link MalformedArnException} (client fault)
64
+ * <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
65
+ * valid.</p>
66
+ *
67
+ * @throws {@link MalformedPolicyTemplateException} (client fault)
68
+ * <p>The operation failed because the policy template that you provided isn't valid.</p>
69
+ *
70
+ * @throws {@link PermissionVersionsLimitExceededException} (client fault)
71
+ * <p>The operation failed because it would exceed the limit for the number of versions you
72
+ * can have for a permission. To view the limits for your Amazon Web Services account, see the <a href="https://console.aws.amazon.com/servicequotas/home/services/ram/quotas">RAM page in the
73
+ * Service Quotas console</a>.</p>
74
+ *
75
+ * @throws {@link ServerInternalException} (server fault)
76
+ * <p>The operation failed because the service could not respond to the request due to an
77
+ * internal problem. Try again later.</p>
78
+ *
79
+ * @throws {@link ServiceUnavailableException} (server fault)
80
+ * <p>The operation failed because the service isn't available. Try again later.</p>
81
+ *
82
+ * @throws {@link UnknownResourceException} (client fault)
83
+ * <p>The operation failed because a specified resource couldn't be found.</p>
84
+ *
85
+ *
86
+ */
87
+ export declare class CreatePermissionVersionCommand extends $Command<CreatePermissionVersionCommandInput, CreatePermissionVersionCommandOutput, RAMClientResolvedConfig> {
88
+ readonly input: CreatePermissionVersionCommandInput;
89
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
90
+ /**
91
+ * @public
92
+ */
93
+ constructor(input: CreatePermissionVersionCommandInput);
94
+ /**
95
+ * @internal
96
+ */
97
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: RAMClientResolvedConfig, options?: __HttpHandlerOptions): Handler<CreatePermissionVersionCommandInput, CreatePermissionVersionCommandOutput>;
98
+ /**
99
+ * @internal
100
+ */
101
+ private serialize;
102
+ /**
103
+ * @internal
104
+ */
105
+ private deserialize;
106
+ }
@@ -64,39 +64,45 @@ export interface CreateResourceShareCommandOutput extends CreateResourceShareRes
64
64
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
65
65
  *
66
66
  * @throws {@link IdempotentParameterMismatchException} (client fault)
67
- * <p>The client token input parameter was matched one used with a previous call to the
68
- * operation, but at least one of the other input parameters is different from the previous
69
- * call.</p>
67
+ * <p>The operation failed because the client token input parameter matched one that was
68
+ * used with a previous call to the operation, but at least one of the other input
69
+ * parameters is different from the previous call.</p>
70
70
  *
71
71
  * @throws {@link InvalidClientTokenException} (client fault)
72
- * <p>The client token is not valid.</p>
72
+ * <p>The operation failed because the specified client token isn't valid.</p>
73
73
  *
74
74
  * @throws {@link InvalidParameterException} (client fault)
75
- * <p>A parameter is not valid.</p>
75
+ * <p>The operation failed because a parameter you specified isn't valid.</p>
76
76
  *
77
77
  * @throws {@link InvalidStateTransitionException} (client fault)
78
- * <p>The requested state transition is not valid.</p>
78
+ * <p>The operation failed because the requested operation isn't valid for the resource
79
+ * share in its current state.</p>
79
80
  *
80
81
  * @throws {@link MalformedArnException} (client fault)
81
- * <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
82
+ * <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
83
+ * valid.</p>
82
84
  *
83
85
  * @throws {@link OperationNotPermittedException} (client fault)
84
- * <p>The requested operation is not permitted.</p>
86
+ * <p>The operation failed because the requested operation isn't permitted.</p>
85
87
  *
86
88
  * @throws {@link ResourceShareLimitExceededException} (client fault)
87
- * <p>This request would exceed the limit for resource shares for your account.</p>
89
+ * <p>The operation failed because it would exceed the limit for resource shares for your account. To
90
+ * view the limits for your Amazon Web Services account, see the <a href="https://console.aws.amazon.com/servicequotas/home/services/ram/quotas">RAM page in the Service Quotas
91
+ * console</a>.</p>
88
92
  *
89
93
  * @throws {@link ServerInternalException} (server fault)
90
- * <p>The service could not respond to the request due to an internal problem.</p>
94
+ * <p>The operation failed because the service could not respond to the request due to an
95
+ * internal problem. Try again later.</p>
91
96
  *
92
97
  * @throws {@link ServiceUnavailableException} (server fault)
93
- * <p>The service is not available.</p>
98
+ * <p>The operation failed because the service isn't available. Try again later.</p>
94
99
  *
95
100
  * @throws {@link TagPolicyViolationException} (client fault)
96
- * <p>The specified tag key is a reserved word and can't be used.</p>
101
+ * <p>The operation failed because the specified tag key is a reserved word and can't be
102
+ * used.</p>
97
103
  *
98
104
  * @throws {@link UnknownResourceException} (client fault)
99
- * <p>A specified resource was not found.</p>
105
+ * <p>The operation failed because a specified resource couldn't be found.</p>
100
106
  *
101
107
  *
102
108
  */
@@ -0,0 +1,91 @@
1
+ import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
2
+ import { Command as $Command } from "@aws-sdk/smithy-client";
3
+ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
4
+ import { DeletePermissionRequest, DeletePermissionResponse } from "../models/models_0";
5
+ import { RAMClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RAMClient";
6
+ /**
7
+ * @public
8
+ *
9
+ * The input for {@link DeletePermissionCommand}.
10
+ */
11
+ export interface DeletePermissionCommandInput extends DeletePermissionRequest {
12
+ }
13
+ /**
14
+ * @public
15
+ *
16
+ * The output of {@link DeletePermissionCommand}.
17
+ */
18
+ export interface DeletePermissionCommandOutput extends DeletePermissionResponse, __MetadataBearer {
19
+ }
20
+ /**
21
+ * @public
22
+ * <p>Deletes the specified customer managed permission in the Amazon Web Services Region in which you call this operation. You
23
+ * can delete a customer managed permission only if it isn't attached to any resource share. The operation deletes all
24
+ * versions associated with the customer managed permission.</p>
25
+ * @example
26
+ * Use a bare-bones client and the command you need to make an API call.
27
+ * ```javascript
28
+ * import { RAMClient, DeletePermissionCommand } from "@aws-sdk/client-ram"; // ES Modules import
29
+ * // const { RAMClient, DeletePermissionCommand } = require("@aws-sdk/client-ram"); // CommonJS import
30
+ * const client = new RAMClient(config);
31
+ * const input = { // DeletePermissionRequest
32
+ * permissionArn: "STRING_VALUE", // required
33
+ * clientToken: "STRING_VALUE",
34
+ * };
35
+ * const command = new DeletePermissionCommand(input);
36
+ * const response = await client.send(command);
37
+ * ```
38
+ *
39
+ * @param DeletePermissionCommandInput - {@link DeletePermissionCommandInput}
40
+ * @returns {@link DeletePermissionCommandOutput}
41
+ * @see {@link DeletePermissionCommandInput} for command's `input` shape.
42
+ * @see {@link DeletePermissionCommandOutput} for command's `response` shape.
43
+ * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
44
+ *
45
+ * @throws {@link IdempotentParameterMismatchException} (client fault)
46
+ * <p>The operation failed because the client token input parameter matched one that was
47
+ * used with a previous call to the operation, but at least one of the other input
48
+ * parameters is different from the previous call.</p>
49
+ *
50
+ * @throws {@link InvalidClientTokenException} (client fault)
51
+ * <p>The operation failed because the specified client token isn't valid.</p>
52
+ *
53
+ * @throws {@link MalformedArnException} (client fault)
54
+ * <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
55
+ * valid.</p>
56
+ *
57
+ * @throws {@link OperationNotPermittedException} (client fault)
58
+ * <p>The operation failed because the requested operation isn't permitted.</p>
59
+ *
60
+ * @throws {@link ServerInternalException} (server fault)
61
+ * <p>The operation failed because the service could not respond to the request due to an
62
+ * internal problem. Try again later.</p>
63
+ *
64
+ * @throws {@link ServiceUnavailableException} (server fault)
65
+ * <p>The operation failed because the service isn't available. Try again later.</p>
66
+ *
67
+ * @throws {@link UnknownResourceException} (client fault)
68
+ * <p>The operation failed because a specified resource couldn't be found.</p>
69
+ *
70
+ *
71
+ */
72
+ export declare class DeletePermissionCommand extends $Command<DeletePermissionCommandInput, DeletePermissionCommandOutput, RAMClientResolvedConfig> {
73
+ readonly input: DeletePermissionCommandInput;
74
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
75
+ /**
76
+ * @public
77
+ */
78
+ constructor(input: DeletePermissionCommandInput);
79
+ /**
80
+ * @internal
81
+ */
82
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: RAMClientResolvedConfig, options?: __HttpHandlerOptions): Handler<DeletePermissionCommandInput, DeletePermissionCommandOutput>;
83
+ /**
84
+ * @internal
85
+ */
86
+ private serialize;
87
+ /**
88
+ * @internal
89
+ */
90
+ private deserialize;
91
+ }
@@ -0,0 +1,96 @@
1
+ import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
2
+ import { Command as $Command } from "@aws-sdk/smithy-client";
3
+ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
4
+ import { DeletePermissionVersionRequest, DeletePermissionVersionResponse } from "../models/models_0";
5
+ import { RAMClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../RAMClient";
6
+ /**
7
+ * @public
8
+ *
9
+ * The input for {@link DeletePermissionVersionCommand}.
10
+ */
11
+ export interface DeletePermissionVersionCommandInput extends DeletePermissionVersionRequest {
12
+ }
13
+ /**
14
+ * @public
15
+ *
16
+ * The output of {@link DeletePermissionVersionCommand}.
17
+ */
18
+ export interface DeletePermissionVersionCommandOutput extends DeletePermissionVersionResponse, __MetadataBearer {
19
+ }
20
+ /**
21
+ * @public
22
+ * <p>Deletes one version of a customer managed permission. The version you specify must not be attached to any
23
+ * resource share and must not be the default version for the permission.</p>
24
+ * <p>If a customer managed permission has the maximum of 5 versions, then you must delete at
25
+ * least one version before you can create another.</p>
26
+ * @example
27
+ * Use a bare-bones client and the command you need to make an API call.
28
+ * ```javascript
29
+ * import { RAMClient, DeletePermissionVersionCommand } from "@aws-sdk/client-ram"; // ES Modules import
30
+ * // const { RAMClient, DeletePermissionVersionCommand } = require("@aws-sdk/client-ram"); // CommonJS import
31
+ * const client = new RAMClient(config);
32
+ * const input = { // DeletePermissionVersionRequest
33
+ * permissionArn: "STRING_VALUE", // required
34
+ * permissionVersion: Number("int"), // required
35
+ * clientToken: "STRING_VALUE",
36
+ * };
37
+ * const command = new DeletePermissionVersionCommand(input);
38
+ * const response = await client.send(command);
39
+ * ```
40
+ *
41
+ * @param DeletePermissionVersionCommandInput - {@link DeletePermissionVersionCommandInput}
42
+ * @returns {@link DeletePermissionVersionCommandOutput}
43
+ * @see {@link DeletePermissionVersionCommandInput} for command's `input` shape.
44
+ * @see {@link DeletePermissionVersionCommandOutput} for command's `response` shape.
45
+ * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
46
+ *
47
+ * @throws {@link IdempotentParameterMismatchException} (client fault)
48
+ * <p>The operation failed because the client token input parameter matched one that was
49
+ * used with a previous call to the operation, but at least one of the other input
50
+ * parameters is different from the previous call.</p>
51
+ *
52
+ * @throws {@link InvalidClientTokenException} (client fault)
53
+ * <p>The operation failed because the specified client token isn't valid.</p>
54
+ *
55
+ * @throws {@link InvalidParameterException} (client fault)
56
+ * <p>The operation failed because a parameter you specified isn't valid.</p>
57
+ *
58
+ * @throws {@link MalformedArnException} (client fault)
59
+ * <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
60
+ * valid.</p>
61
+ *
62
+ * @throws {@link OperationNotPermittedException} (client fault)
63
+ * <p>The operation failed because the requested operation isn't permitted.</p>
64
+ *
65
+ * @throws {@link ServerInternalException} (server fault)
66
+ * <p>The operation failed because the service could not respond to the request due to an
67
+ * internal problem. Try again later.</p>
68
+ *
69
+ * @throws {@link ServiceUnavailableException} (server fault)
70
+ * <p>The operation failed because the service isn't available. Try again later.</p>
71
+ *
72
+ * @throws {@link UnknownResourceException} (client fault)
73
+ * <p>The operation failed because a specified resource couldn't be found.</p>
74
+ *
75
+ *
76
+ */
77
+ export declare class DeletePermissionVersionCommand extends $Command<DeletePermissionVersionCommandInput, DeletePermissionVersionCommandOutput, RAMClientResolvedConfig> {
78
+ readonly input: DeletePermissionVersionCommandInput;
79
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
80
+ /**
81
+ * @public
82
+ */
83
+ constructor(input: DeletePermissionVersionCommandInput);
84
+ /**
85
+ * @internal
86
+ */
87
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: RAMClientResolvedConfig, options?: __HttpHandlerOptions): Handler<DeletePermissionVersionCommandInput, DeletePermissionVersionCommandOutput>;
88
+ /**
89
+ * @internal
90
+ */
91
+ private serialize;
92
+ /**
93
+ * @internal
94
+ */
95
+ private deserialize;
96
+ }
@@ -19,9 +19,11 @@ export interface DeleteResourceShareCommandOutput extends DeleteResourceShareRes
19
19
  }
20
20
  /**
21
21
  * @public
22
- * <p>Deletes the specified resource share. This doesn't delete any of the resources that were
23
- * associated with the resource share; it only stops the sharing of those resources outside of the
24
- * Amazon Web Services account that created them.</p>
22
+ * <p>Deletes the specified resource share.</p>
23
+ * <important>
24
+ * <p>This doesn't delete any of the resources that were associated with the resource share; it
25
+ * only stops the sharing of those resources through this resource share.</p>
26
+ * </important>
25
27
  * @example
26
28
  * Use a bare-bones client and the command you need to make an API call.
27
29
  * ```javascript
@@ -43,33 +45,36 @@ export interface DeleteResourceShareCommandOutput extends DeleteResourceShareRes
43
45
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
44
46
  *
45
47
  * @throws {@link IdempotentParameterMismatchException} (client fault)
46
- * <p>The client token input parameter was matched one used with a previous call to the
47
- * operation, but at least one of the other input parameters is different from the previous
48
- * call.</p>
48
+ * <p>The operation failed because the client token input parameter matched one that was
49
+ * used with a previous call to the operation, but at least one of the other input
50
+ * parameters is different from the previous call.</p>
49
51
  *
50
52
  * @throws {@link InvalidClientTokenException} (client fault)
51
- * <p>The client token is not valid.</p>
53
+ * <p>The operation failed because the specified client token isn't valid.</p>
52
54
  *
53
55
  * @throws {@link InvalidParameterException} (client fault)
54
- * <p>A parameter is not valid.</p>
56
+ * <p>The operation failed because a parameter you specified isn't valid.</p>
55
57
  *
56
58
  * @throws {@link InvalidStateTransitionException} (client fault)
57
- * <p>The requested state transition is not valid.</p>
59
+ * <p>The operation failed because the requested operation isn't valid for the resource
60
+ * share in its current state.</p>
58
61
  *
59
62
  * @throws {@link MalformedArnException} (client fault)
60
- * <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
63
+ * <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
64
+ * valid.</p>
61
65
  *
62
66
  * @throws {@link OperationNotPermittedException} (client fault)
63
- * <p>The requested operation is not permitted.</p>
67
+ * <p>The operation failed because the requested operation isn't permitted.</p>
64
68
  *
65
69
  * @throws {@link ServerInternalException} (server fault)
66
- * <p>The service could not respond to the request due to an internal problem.</p>
70
+ * <p>The operation failed because the service could not respond to the request due to an
71
+ * internal problem. Try again later.</p>
67
72
  *
68
73
  * @throws {@link ServiceUnavailableException} (server fault)
69
- * <p>The service is not available.</p>
74
+ * <p>The operation failed because the service isn't available. Try again later.</p>
70
75
  *
71
76
  * @throws {@link UnknownResourceException} (client fault)
72
- * <p>A specified resource was not found.</p>
77
+ * <p>The operation failed because a specified resource couldn't be found.</p>
73
78
  *
74
79
  *
75
80
  */
@@ -19,7 +19,8 @@ export interface DisassociateResourceShareCommandOutput extends DisassociateReso
19
19
  }
20
20
  /**
21
21
  * @public
22
- * <p>Disassociates the specified principals or resources from the specified resource share.</p>
22
+ * <p>Removes the specified principals or resources from participating in the specified
23
+ * resource share.</p>
23
24
  * @example
24
25
  * Use a bare-bones client and the command you need to make an API call.
25
26
  * ```javascript
@@ -47,36 +48,41 @@ export interface DisassociateResourceShareCommandOutput extends DisassociateReso
47
48
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
48
49
  *
49
50
  * @throws {@link IdempotentParameterMismatchException} (client fault)
50
- * <p>The client token input parameter was matched one used with a previous call to the
51
- * operation, but at least one of the other input parameters is different from the previous
52
- * call.</p>
51
+ * <p>The operation failed because the client token input parameter matched one that was
52
+ * used with a previous call to the operation, but at least one of the other input
53
+ * parameters is different from the previous call.</p>
53
54
  *
54
55
  * @throws {@link InvalidClientTokenException} (client fault)
55
- * <p>The client token is not valid.</p>
56
+ * <p>The operation failed because the specified client token isn't valid.</p>
56
57
  *
57
58
  * @throws {@link InvalidParameterException} (client fault)
58
- * <p>A parameter is not valid.</p>
59
+ * <p>The operation failed because a parameter you specified isn't valid.</p>
59
60
  *
60
61
  * @throws {@link InvalidStateTransitionException} (client fault)
61
- * <p>The requested state transition is not valid.</p>
62
+ * <p>The operation failed because the requested operation isn't valid for the resource
63
+ * share in its current state.</p>
62
64
  *
63
65
  * @throws {@link MalformedArnException} (client fault)
64
- * <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
66
+ * <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
67
+ * valid.</p>
65
68
  *
66
69
  * @throws {@link OperationNotPermittedException} (client fault)
67
- * <p>The requested operation is not permitted.</p>
70
+ * <p>The operation failed because the requested operation isn't permitted.</p>
68
71
  *
69
72
  * @throws {@link ResourceShareLimitExceededException} (client fault)
70
- * <p>This request would exceed the limit for resource shares for your account.</p>
73
+ * <p>The operation failed because it would exceed the limit for resource shares for your account. To
74
+ * view the limits for your Amazon Web Services account, see the <a href="https://console.aws.amazon.com/servicequotas/home/services/ram/quotas">RAM page in the Service Quotas
75
+ * console</a>.</p>
71
76
  *
72
77
  * @throws {@link ServerInternalException} (server fault)
73
- * <p>The service could not respond to the request due to an internal problem.</p>
78
+ * <p>The operation failed because the service could not respond to the request due to an
79
+ * internal problem. Try again later.</p>
74
80
  *
75
81
  * @throws {@link ServiceUnavailableException} (server fault)
76
- * <p>The service is not available.</p>
82
+ * <p>The operation failed because the service isn't available. Try again later.</p>
77
83
  *
78
84
  * @throws {@link UnknownResourceException} (client fault)
79
- * <p>A specified resource was not found.</p>
85
+ * <p>The operation failed because a specified resource couldn't be found.</p>
80
86
  *
81
87
  *
82
88
  */
@@ -19,9 +19,9 @@ export interface DisassociateResourceSharePermissionCommandOutput extends Disass
19
19
  }
20
20
  /**
21
21
  * @public
22
- * <p>Disassociates an RAM permission from a resource share. Permission changes take effect
23
- * immediately. You can remove a RAM permission from a resource share only if there are currently
24
- * no resources of the relevant resource type currently attached to the resource share.</p>
22
+ * <p>Removes a managed permission from a resource share. Permission changes take effect immediately. You can
23
+ * remove a managed permission from a resource share only if there are currently no resources of the relevant
24
+ * resource type currently attached to the resource share.</p>
25
25
  * @example
26
26
  * Use a bare-bones client and the command you need to make an API call.
27
27
  * ```javascript
@@ -44,28 +44,31 @@ export interface DisassociateResourceSharePermissionCommandOutput extends Disass
44
44
  * @see {@link RAMClientResolvedConfig | config} for RAMClient's `config` shape.
45
45
  *
46
46
  * @throws {@link InvalidClientTokenException} (client fault)
47
- * <p>The client token is not valid.</p>
47
+ * <p>The operation failed because the specified client token isn't valid.</p>
48
48
  *
49
49
  * @throws {@link InvalidParameterException} (client fault)
50
- * <p>A parameter is not valid.</p>
50
+ * <p>The operation failed because a parameter you specified isn't valid.</p>
51
51
  *
52
52
  * @throws {@link InvalidStateTransitionException} (client fault)
53
- * <p>The requested state transition is not valid.</p>
53
+ * <p>The operation failed because the requested operation isn't valid for the resource
54
+ * share in its current state.</p>
54
55
  *
55
56
  * @throws {@link MalformedArnException} (client fault)
56
- * <p>The format of an Amazon Resource Name (ARN) is not valid.</p>
57
+ * <p>The operation failed because the specified <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Name (ARN)</a> has a format that isn't
58
+ * valid.</p>
57
59
  *
58
60
  * @throws {@link OperationNotPermittedException} (client fault)
59
- * <p>The requested operation is not permitted.</p>
61
+ * <p>The operation failed because the requested operation isn't permitted.</p>
60
62
  *
61
63
  * @throws {@link ServerInternalException} (server fault)
62
- * <p>The service could not respond to the request due to an internal problem.</p>
64
+ * <p>The operation failed because the service could not respond to the request due to an
65
+ * internal problem. Try again later.</p>
63
66
  *
64
67
  * @throws {@link ServiceUnavailableException} (server fault)
65
- * <p>The service is not available.</p>
68
+ * <p>The operation failed because the service isn't available. Try again later.</p>
66
69
  *
67
70
  * @throws {@link UnknownResourceException} (client fault)
68
- * <p>A specified resource was not found.</p>
71
+ * <p>The operation failed because a specified resource couldn't be found.</p>
69
72
  *
70
73
  *
71
74
  */