@aws-sdk/client-elastic-load-balancing-v2 3.288.0 → 3.290.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 (35) hide show
  1. package/dist-types/commands/AddListenerCertificatesCommand.d.ts +10 -0
  2. package/dist-types/commands/AddTagsCommand.d.ts +42 -0
  3. package/dist-types/commands/CreateListenerCommand.d.ts +144 -0
  4. package/dist-types/commands/CreateLoadBalancerCommand.d.ts +137 -0
  5. package/dist-types/commands/CreateRuleCommand.d.ts +101 -0
  6. package/dist-types/commands/CreateTargetGroupCommand.d.ts +51 -0
  7. package/dist-types/commands/DeleteListenerCommand.d.ts +18 -0
  8. package/dist-types/commands/DeleteLoadBalancerCommand.d.ts +21 -0
  9. package/dist-types/commands/DeleteRuleCommand.d.ts +18 -0
  10. package/dist-types/commands/DeleteTargetGroupCommand.d.ts +15 -0
  11. package/dist-types/commands/DeregisterTargetsCommand.d.ts +24 -0
  12. package/dist-types/commands/DescribeAccountLimitsCommand.d.ts +1 -0
  13. package/dist-types/commands/DescribeListenerCertificatesCommand.d.ts +4 -0
  14. package/dist-types/commands/DescribeListenersCommand.d.ts +41 -0
  15. package/dist-types/commands/DescribeLoadBalancerAttributesCommand.d.ts +41 -0
  16. package/dist-types/commands/DescribeLoadBalancersCommand.d.ts +49 -0
  17. package/dist-types/commands/DescribeRulesCommand.d.ts +48 -0
  18. package/dist-types/commands/DescribeSSLPoliciesCommand.d.ts +109 -0
  19. package/dist-types/commands/DescribeTagsCommand.d.ts +45 -0
  20. package/dist-types/commands/DescribeTargetGroupAttributesCommand.d.ts +37 -0
  21. package/dist-types/commands/DescribeTargetGroupsCommand.d.ts +46 -0
  22. package/dist-types/commands/DescribeTargetHealthCommand.d.ts +83 -0
  23. package/dist-types/commands/ModifyListenerCommand.d.ts +130 -0
  24. package/dist-types/commands/ModifyLoadBalancerAttributesCommand.d.ts +144 -0
  25. package/dist-types/commands/ModifyRuleCommand.d.ts +81 -0
  26. package/dist-types/commands/ModifyTargetGroupAttributesCommand.d.ts +46 -0
  27. package/dist-types/commands/ModifyTargetGroupCommand.d.ts +45 -0
  28. package/dist-types/commands/RegisterTargetsCommand.d.ts +55 -0
  29. package/dist-types/commands/RemoveListenerCertificatesCommand.d.ts +7 -0
  30. package/dist-types/commands/RemoveTagsCommand.d.ts +33 -0
  31. package/dist-types/commands/SetIpAddressTypeCommand.d.ts +10 -0
  32. package/dist-types/commands/SetRulePrioritiesCommand.d.ts +51 -0
  33. package/dist-types/commands/SetSecurityGroupsCommand.d.ts +31 -0
  34. package/dist-types/commands/SetSubnetsCommand.d.ts +48 -0
  35. package/package.json +30 -30
@@ -36,6 +36,136 @@ export interface ModifyListenerCommandOutput extends ModifyListenerOutput, __Met
36
36
  * @see {@link ModifyListenerCommandOutput} for command's `response` shape.
37
37
  * @see {@link ElasticLoadBalancingV2ClientResolvedConfig | config} for ElasticLoadBalancingV2Client's `config` shape.
38
38
  *
39
+ * @throws {@link ALPNPolicyNotSupportedException} (client fault)
40
+ * <p>The specified ALPN policy is not supported.</p>
41
+ *
42
+ * @throws {@link CertificateNotFoundException} (client fault)
43
+ * <p>The specified certificate does not exist.</p>
44
+ *
45
+ * @throws {@link DuplicateListenerException} (client fault)
46
+ * <p>A listener with the specified port already exists.</p>
47
+ *
48
+ * @throws {@link IncompatibleProtocolsException} (client fault)
49
+ * <p>The specified configuration is not valid with this protocol.</p>
50
+ *
51
+ * @throws {@link InvalidConfigurationRequestException} (client fault)
52
+ * <p>The requested configuration is not valid.</p>
53
+ *
54
+ * @throws {@link InvalidLoadBalancerActionException} (client fault)
55
+ * <p>The requested action is not valid.</p>
56
+ *
57
+ * @throws {@link ListenerNotFoundException} (client fault)
58
+ * <p>The specified listener does not exist.</p>
59
+ *
60
+ * @throws {@link SSLPolicyNotFoundException} (client fault)
61
+ * <p>The specified SSL policy does not exist.</p>
62
+ *
63
+ * @throws {@link TargetGroupAssociationLimitException} (client fault)
64
+ * <p>You've reached the limit on the number of load balancers per target group.</p>
65
+ *
66
+ * @throws {@link TargetGroupNotFoundException} (client fault)
67
+ * <p>The specified target group does not exist.</p>
68
+ *
69
+ * @throws {@link TooManyActionsException} (client fault)
70
+ * <p>You've reached the limit on the number of actions per rule.</p>
71
+ *
72
+ * @throws {@link TooManyCertificatesException} (client fault)
73
+ * <p>You've reached the limit on the number of certificates per load balancer.</p>
74
+ *
75
+ * @throws {@link TooManyListenersException} (client fault)
76
+ * <p>You've reached the limit on the number of listeners per load balancer.</p>
77
+ *
78
+ * @throws {@link TooManyRegistrationsForTargetIdException} (client fault)
79
+ * <p>You've reached the limit on the number of times a target can be registered with a load
80
+ * balancer.</p>
81
+ *
82
+ * @throws {@link TooManyTargetsException} (client fault)
83
+ * <p>You've reached the limit on the number of targets.</p>
84
+ *
85
+ * @throws {@link TooManyUniqueTargetGroupsPerLoadBalancerException} (client fault)
86
+ * <p>You've reached the limit on the number of unique target groups per load balancer across
87
+ * all listeners. If a target group is used by multiple actions for a load balancer, it is
88
+ * counted as only one use.</p>
89
+ *
90
+ * @throws {@link UnsupportedProtocolException} (client fault)
91
+ * <p>The specified protocol is not supported.</p>
92
+ *
93
+ *
94
+ * @example To change the default action for a listener
95
+ * ```javascript
96
+ * // This example changes the default action for the specified listener.
97
+ * const input = {
98
+ * "DefaultActions": [
99
+ * {
100
+ * "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/2453ed029918f21f",
101
+ * "Type": "forward"
102
+ * }
103
+ * ],
104
+ * "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2"
105
+ * };
106
+ * const command = new ModifyListenerCommand(input);
107
+ * const response = await client.send(command);
108
+ * /* response ==
109
+ * {
110
+ * "Listeners": [
111
+ * {
112
+ * "DefaultActions": [
113
+ * {
114
+ * "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/2453ed029918f21f",
115
+ * "Type": "forward"
116
+ * }
117
+ * ],
118
+ * "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2",
119
+ * "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188",
120
+ * "Port": 80,
121
+ * "Protocol": "HTTP"
122
+ * }
123
+ * ]
124
+ * }
125
+ * *\/
126
+ * // example id: elbv2-modify-listener-1
127
+ * ```
128
+ *
129
+ * @example To change the server certificate
130
+ * ```javascript
131
+ * // This example changes the server certificate for the specified HTTPS listener.
132
+ * const input = {
133
+ * "Certificates": [
134
+ * {
135
+ * "CertificateArn": "arn:aws:iam::123456789012:server-certificate/my-new-server-cert"
136
+ * }
137
+ * ],
138
+ * "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65"
139
+ * };
140
+ * const command = new ModifyListenerCommand(input);
141
+ * const response = await client.send(command);
142
+ * /* response ==
143
+ * {
144
+ * "Listeners": [
145
+ * {
146
+ * "Certificates": [
147
+ * {
148
+ * "CertificateArn": "arn:aws:iam::123456789012:server-certificate/my-new-server-cert"
149
+ * }
150
+ * ],
151
+ * "DefaultActions": [
152
+ * {
153
+ * "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067",
154
+ * "Type": "forward"
155
+ * }
156
+ * ],
157
+ * "ListenerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65",
158
+ * "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188",
159
+ * "Port": 443,
160
+ * "Protocol": "HTTPS",
161
+ * "SslPolicy": "ELBSecurityPolicy-2015-05"
162
+ * }
163
+ * ]
164
+ * }
165
+ * *\/
166
+ * // example id: elbv2-modify-listener-2
167
+ * ```
168
+ *
39
169
  */
40
170
  export declare class ModifyListenerCommand extends $Command<ModifyListenerCommandInput, ModifyListenerCommandOutput, ElasticLoadBalancingV2ClientResolvedConfig> {
41
171
  readonly input: ModifyListenerCommandInput;
@@ -32,6 +32,150 @@ export interface ModifyLoadBalancerAttributesCommandOutput extends ModifyLoadBal
32
32
  * @see {@link ModifyLoadBalancerAttributesCommandOutput} for command's `response` shape.
33
33
  * @see {@link ElasticLoadBalancingV2ClientResolvedConfig | config} for ElasticLoadBalancingV2Client's `config` shape.
34
34
  *
35
+ * @throws {@link InvalidConfigurationRequestException} (client fault)
36
+ * <p>The requested configuration is not valid.</p>
37
+ *
38
+ * @throws {@link LoadBalancerNotFoundException} (client fault)
39
+ * <p>The specified load balancer does not exist.</p>
40
+ *
41
+ *
42
+ * @example To enable deletion protection
43
+ * ```javascript
44
+ * // This example enables deletion protection for the specified load balancer.
45
+ * const input = {
46
+ * "Attributes": [
47
+ * {
48
+ * "Key": "deletion_protection.enabled",
49
+ * "Value": "true"
50
+ * }
51
+ * ],
52
+ * "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"
53
+ * };
54
+ * const command = new ModifyLoadBalancerAttributesCommand(input);
55
+ * const response = await client.send(command);
56
+ * /* response ==
57
+ * {
58
+ * "Attributes": [
59
+ * {
60
+ * "Key": "deletion_protection.enabled",
61
+ * "Value": "true"
62
+ * },
63
+ * {
64
+ * "Key": "access_logs.s3.enabled",
65
+ * "Value": "false"
66
+ * },
67
+ * {
68
+ * "Key": "idle_timeout.timeout_seconds",
69
+ * "Value": "60"
70
+ * },
71
+ * {
72
+ * "Key": "access_logs.s3.prefix",
73
+ * "Value": ""
74
+ * },
75
+ * {
76
+ * "Key": "access_logs.s3.bucket",
77
+ * "Value": ""
78
+ * }
79
+ * ]
80
+ * }
81
+ * *\/
82
+ * // example id: elbv2-modify-load-balancer-attributes-1
83
+ * ```
84
+ *
85
+ * @example To change the idle timeout
86
+ * ```javascript
87
+ * // This example changes the idle timeout value for the specified load balancer.
88
+ * const input = {
89
+ * "Attributes": [
90
+ * {
91
+ * "Key": "idle_timeout.timeout_seconds",
92
+ * "Value": "30"
93
+ * }
94
+ * ],
95
+ * "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"
96
+ * };
97
+ * const command = new ModifyLoadBalancerAttributesCommand(input);
98
+ * const response = await client.send(command);
99
+ * /* response ==
100
+ * {
101
+ * "Attributes": [
102
+ * {
103
+ * "Key": "idle_timeout.timeout_seconds",
104
+ * "Value": "30"
105
+ * },
106
+ * {
107
+ * "Key": "access_logs.s3.enabled",
108
+ * "Value": "false"
109
+ * },
110
+ * {
111
+ * "Key": "access_logs.s3.prefix",
112
+ * "Value": ""
113
+ * },
114
+ * {
115
+ * "Key": "deletion_protection.enabled",
116
+ * "Value": "true"
117
+ * },
118
+ * {
119
+ * "Key": "access_logs.s3.bucket",
120
+ * "Value": ""
121
+ * }
122
+ * ]
123
+ * }
124
+ * *\/
125
+ * // example id: elbv2-modify-load-balancer-attributes-2
126
+ * ```
127
+ *
128
+ * @example To enable access logs
129
+ * ```javascript
130
+ * // This example enables access logs for the specified load balancer. Note that the S3 bucket must exist in the same region as the load balancer and must have a policy attached that grants access to the Elastic Load Balancing service.
131
+ * const input = {
132
+ * "Attributes": [
133
+ * {
134
+ * "Key": "access_logs.s3.enabled",
135
+ * "Value": "true"
136
+ * },
137
+ * {
138
+ * "Key": "access_logs.s3.bucket",
139
+ * "Value": "my-loadbalancer-logs"
140
+ * },
141
+ * {
142
+ * "Key": "access_logs.s3.prefix",
143
+ * "Value": "myapp"
144
+ * }
145
+ * ],
146
+ * "LoadBalancerArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"
147
+ * };
148
+ * const command = new ModifyLoadBalancerAttributesCommand(input);
149
+ * const response = await client.send(command);
150
+ * /* response ==
151
+ * {
152
+ * "Attributes": [
153
+ * {
154
+ * "Key": "access_logs.s3.enabled",
155
+ * "Value": "true"
156
+ * },
157
+ * {
158
+ * "Key": "access_logs.s3.bucket",
159
+ * "Value": "my-load-balancer-logs"
160
+ * },
161
+ * {
162
+ * "Key": "access_logs.s3.prefix",
163
+ * "Value": "myapp"
164
+ * },
165
+ * {
166
+ * "Key": "idle_timeout.timeout_seconds",
167
+ * "Value": "60"
168
+ * },
169
+ * {
170
+ * "Key": "deletion_protection.enabled",
171
+ * "Value": "false"
172
+ * }
173
+ * ]
174
+ * }
175
+ * *\/
176
+ * // example id: elbv2-modify-load-balancer-attributes-3
177
+ * ```
178
+ *
35
179
  */
36
180
  export declare class ModifyLoadBalancerAttributesCommand extends $Command<ModifyLoadBalancerAttributesCommandInput, ModifyLoadBalancerAttributesCommandOutput, ElasticLoadBalancingV2ClientResolvedConfig> {
37
181
  readonly input: ModifyLoadBalancerAttributesCommandInput;
@@ -33,6 +33,87 @@ export interface ModifyRuleCommandOutput extends ModifyRuleOutput, __MetadataBea
33
33
  * @see {@link ModifyRuleCommandOutput} for command's `response` shape.
34
34
  * @see {@link ElasticLoadBalancingV2ClientResolvedConfig | config} for ElasticLoadBalancingV2Client's `config` shape.
35
35
  *
36
+ * @throws {@link IncompatibleProtocolsException} (client fault)
37
+ * <p>The specified configuration is not valid with this protocol.</p>
38
+ *
39
+ * @throws {@link InvalidLoadBalancerActionException} (client fault)
40
+ * <p>The requested action is not valid.</p>
41
+ *
42
+ * @throws {@link OperationNotPermittedException} (client fault)
43
+ * <p>This operation is not allowed.</p>
44
+ *
45
+ * @throws {@link RuleNotFoundException} (client fault)
46
+ * <p>The specified rule does not exist.</p>
47
+ *
48
+ * @throws {@link TargetGroupAssociationLimitException} (client fault)
49
+ * <p>You've reached the limit on the number of load balancers per target group.</p>
50
+ *
51
+ * @throws {@link TargetGroupNotFoundException} (client fault)
52
+ * <p>The specified target group does not exist.</p>
53
+ *
54
+ * @throws {@link TooManyActionsException} (client fault)
55
+ * <p>You've reached the limit on the number of actions per rule.</p>
56
+ *
57
+ * @throws {@link TooManyRegistrationsForTargetIdException} (client fault)
58
+ * <p>You've reached the limit on the number of times a target can be registered with a load
59
+ * balancer.</p>
60
+ *
61
+ * @throws {@link TooManyTargetsException} (client fault)
62
+ * <p>You've reached the limit on the number of targets.</p>
63
+ *
64
+ * @throws {@link TooManyUniqueTargetGroupsPerLoadBalancerException} (client fault)
65
+ * <p>You've reached the limit on the number of unique target groups per load balancer across
66
+ * all listeners. If a target group is used by multiple actions for a load balancer, it is
67
+ * counted as only one use.</p>
68
+ *
69
+ * @throws {@link UnsupportedProtocolException} (client fault)
70
+ * <p>The specified protocol is not supported.</p>
71
+ *
72
+ *
73
+ * @example To modify a rule
74
+ * ```javascript
75
+ * // This example modifies the condition for the specified rule.
76
+ * const input = {
77
+ * "Conditions": [
78
+ * {
79
+ * "Field": "path-pattern",
80
+ * "Values": [
81
+ * "/images/*"
82
+ * ]
83
+ * }
84
+ * ],
85
+ * "RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee"
86
+ * };
87
+ * const command = new ModifyRuleCommand(input);
88
+ * const response = await client.send(command);
89
+ * /* response ==
90
+ * {
91
+ * "Rules": [
92
+ * {
93
+ * "Actions": [
94
+ * {
95
+ * "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067",
96
+ * "Type": "forward"
97
+ * }
98
+ * ],
99
+ * "Conditions": [
100
+ * {
101
+ * "Field": "path-pattern",
102
+ * "Values": [
103
+ * "/images/*"
104
+ * ]
105
+ * }
106
+ * ],
107
+ * "IsDefault": false,
108
+ * "Priority": "10",
109
+ * "RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee"
110
+ * }
111
+ * ]
112
+ * }
113
+ * *\/
114
+ * // example id: elbv2-modify-rule-1
115
+ * ```
116
+ *
36
117
  */
37
118
  export declare class ModifyRuleCommand extends $Command<ModifyRuleCommandInput, ModifyRuleCommandOutput, ElasticLoadBalancingV2ClientResolvedConfig> {
38
119
  readonly input: ModifyRuleCommandInput;
@@ -29,6 +29,52 @@ export interface ModifyTargetGroupAttributesCommandOutput extends ModifyTargetGr
29
29
  * @see {@link ModifyTargetGroupAttributesCommandOutput} for command's `response` shape.
30
30
  * @see {@link ElasticLoadBalancingV2ClientResolvedConfig | config} for ElasticLoadBalancingV2Client's `config` shape.
31
31
  *
32
+ * @throws {@link InvalidConfigurationRequestException} (client fault)
33
+ * <p>The requested configuration is not valid.</p>
34
+ *
35
+ * @throws {@link TargetGroupNotFoundException} (client fault)
36
+ * <p>The specified target group does not exist.</p>
37
+ *
38
+ *
39
+ * @example To modify the deregistration delay timeout
40
+ * ```javascript
41
+ * // This example sets the deregistration delay timeout to the specified value for the specified target group.
42
+ * const input = {
43
+ * "Attributes": [
44
+ * {
45
+ * "Key": "deregistration_delay.timeout_seconds",
46
+ * "Value": "600"
47
+ * }
48
+ * ],
49
+ * "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067"
50
+ * };
51
+ * const command = new ModifyTargetGroupAttributesCommand(input);
52
+ * const response = await client.send(command);
53
+ * /* response ==
54
+ * {
55
+ * "Attributes": [
56
+ * {
57
+ * "Key": "stickiness.enabled",
58
+ * "Value": "false"
59
+ * },
60
+ * {
61
+ * "Key": "deregistration_delay.timeout_seconds",
62
+ * "Value": "600"
63
+ * },
64
+ * {
65
+ * "Key": "stickiness.type",
66
+ * "Value": "lb_cookie"
67
+ * },
68
+ * {
69
+ * "Key": "stickiness.lb_cookie.duration_seconds",
70
+ * "Value": "86400"
71
+ * }
72
+ * ]
73
+ * }
74
+ * *\/
75
+ * // example id: elbv2-modify-target-group-attributes-1
76
+ * ```
77
+ *
32
78
  */
33
79
  export declare class ModifyTargetGroupAttributesCommand extends $Command<ModifyTargetGroupAttributesCommandInput, ModifyTargetGroupAttributesCommandOutput, ElasticLoadBalancingV2ClientResolvedConfig> {
34
80
  readonly input: ModifyTargetGroupAttributesCommandInput;
@@ -30,6 +30,51 @@ export interface ModifyTargetGroupCommandOutput extends ModifyTargetGroupOutput,
30
30
  * @see {@link ModifyTargetGroupCommandOutput} for command's `response` shape.
31
31
  * @see {@link ElasticLoadBalancingV2ClientResolvedConfig | config} for ElasticLoadBalancingV2Client's `config` shape.
32
32
  *
33
+ * @throws {@link InvalidConfigurationRequestException} (client fault)
34
+ * <p>The requested configuration is not valid.</p>
35
+ *
36
+ * @throws {@link TargetGroupNotFoundException} (client fault)
37
+ * <p>The specified target group does not exist.</p>
38
+ *
39
+ *
40
+ * @example To modify the health check configuration for a target group
41
+ * ```javascript
42
+ * // This example changes the configuration of the health checks used to evaluate the health of the targets for the specified target group.
43
+ * const input = {
44
+ * "HealthCheckPort": "443",
45
+ * "HealthCheckProtocol": "HTTPS",
46
+ * "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-https-targets/2453ed029918f21f"
47
+ * };
48
+ * const command = new ModifyTargetGroupCommand(input);
49
+ * const response = await client.send(command);
50
+ * /* response ==
51
+ * {
52
+ * "TargetGroups": [
53
+ * {
54
+ * "HealthCheckIntervalSeconds": 30,
55
+ * "HealthCheckPort": "443",
56
+ * "HealthCheckProtocol": "HTTPS",
57
+ * "HealthCheckTimeoutSeconds": 5,
58
+ * "HealthyThresholdCount": 5,
59
+ * "LoadBalancerArns": [
60
+ * "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"
61
+ * ],
62
+ * "Matcher": {
63
+ * "HttpCode": "200"
64
+ * },
65
+ * "Port": 443,
66
+ * "Protocol": "HTTPS",
67
+ * "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-https-targets/2453ed029918f21f",
68
+ * "TargetGroupName": "my-https-targets",
69
+ * "UnhealthyThresholdCount": 2,
70
+ * "VpcId": "vpc-3ac0fb5f"
71
+ * }
72
+ * ]
73
+ * }
74
+ * *\/
75
+ * // example id: elbv2-modify-target-group-1
76
+ * ```
77
+ *
33
78
  */
34
79
  export declare class ModifyTargetGroupCommand extends $Command<ModifyTargetGroupCommandInput, ModifyTargetGroupCommandOutput, ElasticLoadBalancingV2ClientResolvedConfig> {
35
80
  readonly input: ModifyTargetGroupCommandInput;
@@ -38,6 +38,61 @@ export interface RegisterTargetsCommandOutput extends RegisterTargetsOutput, __M
38
38
  * @see {@link RegisterTargetsCommandOutput} for command's `response` shape.
39
39
  * @see {@link ElasticLoadBalancingV2ClientResolvedConfig | config} for ElasticLoadBalancingV2Client's `config` shape.
40
40
  *
41
+ * @throws {@link InvalidTargetException} (client fault)
42
+ * <p>The specified target does not exist, is not in the same VPC as the target group, or has an
43
+ * unsupported instance type.</p>
44
+ *
45
+ * @throws {@link TargetGroupNotFoundException} (client fault)
46
+ * <p>The specified target group does not exist.</p>
47
+ *
48
+ * @throws {@link TooManyRegistrationsForTargetIdException} (client fault)
49
+ * <p>You've reached the limit on the number of times a target can be registered with a load
50
+ * balancer.</p>
51
+ *
52
+ * @throws {@link TooManyTargetsException} (client fault)
53
+ * <p>You've reached the limit on the number of targets.</p>
54
+ *
55
+ *
56
+ * @example To register targets with a target group
57
+ * ```javascript
58
+ * // This example registers the specified instances with the specified target group.
59
+ * const input = {
60
+ * "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067",
61
+ * "Targets": [
62
+ * {
63
+ * "Id": "i-80c8dd94"
64
+ * },
65
+ * {
66
+ * "Id": "i-ceddcd4d"
67
+ * }
68
+ * ]
69
+ * };
70
+ * const command = new RegisterTargetsCommand(input);
71
+ * await client.send(command);
72
+ * // example id: elbv2-register-targets-1
73
+ * ```
74
+ *
75
+ * @example To register targets with a target group using port overrides
76
+ * ```javascript
77
+ * // This example registers the specified instance with the specified target group using multiple ports. This enables you to register ECS containers on the same instance as targets in the target group.
78
+ * const input = {
79
+ * "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-new-targets/3bb63f11dfb0faf9",
80
+ * "Targets": [
81
+ * {
82
+ * "Id": "i-80c8dd94",
83
+ * "Port": 80
84
+ * },
85
+ * {
86
+ * "Id": "i-80c8dd94",
87
+ * "Port": 766
88
+ * }
89
+ * ]
90
+ * };
91
+ * const command = new RegisterTargetsCommand(input);
92
+ * await client.send(command);
93
+ * // example id: elbv2-register-targets-2
94
+ * ```
95
+ *
41
96
  */
42
97
  export declare class RegisterTargetsCommand extends $Command<RegisterTargetsCommandInput, RegisterTargetsCommandOutput, ElasticLoadBalancingV2ClientResolvedConfig> {
43
98
  readonly input: RegisterTargetsCommandInput;
@@ -30,6 +30,13 @@ export interface RemoveListenerCertificatesCommandOutput extends RemoveListenerC
30
30
  * @see {@link RemoveListenerCertificatesCommandOutput} for command's `response` shape.
31
31
  * @see {@link ElasticLoadBalancingV2ClientResolvedConfig | config} for ElasticLoadBalancingV2Client's `config` shape.
32
32
  *
33
+ * @throws {@link ListenerNotFoundException} (client fault)
34
+ * <p>The specified listener does not exist.</p>
35
+ *
36
+ * @throws {@link OperationNotPermittedException} (client fault)
37
+ * <p>This operation is not allowed.</p>
38
+ *
39
+ *
33
40
  */
34
41
  export declare class RemoveListenerCertificatesCommand extends $Command<RemoveListenerCertificatesCommandInput, RemoveListenerCertificatesCommandOutput, ElasticLoadBalancingV2ClientResolvedConfig> {
35
42
  readonly input: RemoveListenerCertificatesCommandInput;
@@ -31,6 +31,39 @@ export interface RemoveTagsCommandOutput extends RemoveTagsOutput, __MetadataBea
31
31
  * @see {@link RemoveTagsCommandOutput} for command's `response` shape.
32
32
  * @see {@link ElasticLoadBalancingV2ClientResolvedConfig | config} for ElasticLoadBalancingV2Client's `config` shape.
33
33
  *
34
+ * @throws {@link ListenerNotFoundException} (client fault)
35
+ * <p>The specified listener does not exist.</p>
36
+ *
37
+ * @throws {@link LoadBalancerNotFoundException} (client fault)
38
+ * <p>The specified load balancer does not exist.</p>
39
+ *
40
+ * @throws {@link RuleNotFoundException} (client fault)
41
+ * <p>The specified rule does not exist.</p>
42
+ *
43
+ * @throws {@link TargetGroupNotFoundException} (client fault)
44
+ * <p>The specified target group does not exist.</p>
45
+ *
46
+ * @throws {@link TooManyTagsException} (client fault)
47
+ * <p>You've reached the limit on the number of tags per load balancer.</p>
48
+ *
49
+ *
50
+ * @example To remove tags from a load balancer
51
+ * ```javascript
52
+ * // This example removes the specified tags from the specified load balancer.
53
+ * const input = {
54
+ * "ResourceArns": [
55
+ * "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188"
56
+ * ],
57
+ * "TagKeys": [
58
+ * "project",
59
+ * "department"
60
+ * ]
61
+ * };
62
+ * const command = new RemoveTagsCommand(input);
63
+ * await client.send(command);
64
+ * // example id: elbv2-remove-tags-1
65
+ * ```
66
+ *
34
67
  */
35
68
  export declare class RemoveTagsCommand extends $Command<RemoveTagsCommandInput, RemoveTagsCommandOutput, ElasticLoadBalancingV2ClientResolvedConfig> {
36
69
  readonly input: RemoveTagsCommandInput;
@@ -29,6 +29,16 @@ export interface SetIpAddressTypeCommandOutput extends SetIpAddressTypeOutput, _
29
29
  * @see {@link SetIpAddressTypeCommandOutput} for command's `response` shape.
30
30
  * @see {@link ElasticLoadBalancingV2ClientResolvedConfig | config} for ElasticLoadBalancingV2Client's `config` shape.
31
31
  *
32
+ * @throws {@link InvalidConfigurationRequestException} (client fault)
33
+ * <p>The requested configuration is not valid.</p>
34
+ *
35
+ * @throws {@link InvalidSubnetException} (client fault)
36
+ * <p>The specified subnet is out of available addresses.</p>
37
+ *
38
+ * @throws {@link LoadBalancerNotFoundException} (client fault)
39
+ * <p>The specified load balancer does not exist.</p>
40
+ *
41
+ *
32
42
  */
33
43
  export declare class SetIpAddressTypeCommand extends $Command<SetIpAddressTypeCommandInput, SetIpAddressTypeCommandOutput, ElasticLoadBalancingV2ClientResolvedConfig> {
34
44
  readonly input: SetIpAddressTypeCommandInput;
@@ -31,6 +31,57 @@ export interface SetRulePrioritiesCommandOutput extends SetRulePrioritiesOutput,
31
31
  * @see {@link SetRulePrioritiesCommandOutput} for command's `response` shape.
32
32
  * @see {@link ElasticLoadBalancingV2ClientResolvedConfig | config} for ElasticLoadBalancingV2Client's `config` shape.
33
33
  *
34
+ * @throws {@link OperationNotPermittedException} (client fault)
35
+ * <p>This operation is not allowed.</p>
36
+ *
37
+ * @throws {@link PriorityInUseException} (client fault)
38
+ * <p>The specified priority is in use.</p>
39
+ *
40
+ * @throws {@link RuleNotFoundException} (client fault)
41
+ * <p>The specified rule does not exist.</p>
42
+ *
43
+ *
44
+ * @example To set the rule priority
45
+ * ```javascript
46
+ * // This example sets the priority of the specified rule.
47
+ * const input = {
48
+ * "RulePriorities": [
49
+ * {
50
+ * "Priority": 5,
51
+ * "RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/1291d13826f405c3"
52
+ * }
53
+ * ]
54
+ * };
55
+ * const command = new SetRulePrioritiesCommand(input);
56
+ * const response = await client.send(command);
57
+ * /* response ==
58
+ * {
59
+ * "Rules": [
60
+ * {
61
+ * "Actions": [
62
+ * {
63
+ * "TargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067",
64
+ * "Type": "forward"
65
+ * }
66
+ * ],
67
+ * "Conditions": [
68
+ * {
69
+ * "Field": "path-pattern",
70
+ * "Values": [
71
+ * "/img/*"
72
+ * ]
73
+ * }
74
+ * ],
75
+ * "IsDefault": false,
76
+ * "Priority": "5",
77
+ * "RuleArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2/1291d13826f405c3"
78
+ * }
79
+ * ]
80
+ * }
81
+ * *\/
82
+ * // example id: elbv2-set-rule-priorities-1
83
+ * ```
84
+ *
34
85
  */
35
86
  export declare class SetRulePrioritiesCommand extends $Command<SetRulePrioritiesCommandInput, SetRulePrioritiesCommandOutput, ElasticLoadBalancingV2ClientResolvedConfig> {
36
87
  readonly input: SetRulePrioritiesCommandInput;