@aws-sdk/client-migration-hub-refactor-spaces 3.310.0 → 3.314.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.
@@ -1,7 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.ruleSet = void 0;
4
- const q = "fn", r = "argv", s = "ref";
5
- const a = true, b = false, c = "String", d = "PartitionResult", e = "tree", f = "error", g = "endpoint", h = { "required": true, "default": false, "type": "Boolean" }, i = { [s]: "Endpoint" }, j = { [q]: "booleanEquals", [r]: [{ [s]: "UseFIPS" }, true] }, k = { [q]: "booleanEquals", [r]: [{ [s]: "UseDualStack" }, true] }, l = {}, m = { [q]: "booleanEquals", [r]: [true, { [q]: "getAttr", [r]: [{ [s]: d }, "supportsFIPS"] }] }, n = { [q]: "booleanEquals", [r]: [true, { [q]: "getAttr", [r]: [{ [s]: d }, "supportsDualStack"] }] }, o = [j], p = [k];
6
- const _data = { version: "1.0", parameters: { Region: { required: a, type: c }, UseDualStack: h, UseFIPS: h, Endpoint: { required: b, type: c } }, rules: [{ conditions: [{ [q]: "aws.partition", [r]: [{ [s]: "Region" }], assign: d }], type: e, rules: [{ conditions: [{ [q]: "isSet", [r]: [i] }], type: e, rules: [{ conditions: o, error: "Invalid Configuration: FIPS and custom endpoint are not supported", type: f }, { type: e, rules: [{ conditions: p, error: "Invalid Configuration: Dualstack and custom endpoint are not supported", type: f }, { endpoint: { url: i, properties: l, headers: l }, type: g }] }] }, { conditions: [j, k], type: e, rules: [{ conditions: [m, n], type: e, rules: [{ endpoint: { url: "https://refactor-spaces-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: l, headers: l }, type: g }] }, { error: "FIPS and DualStack are enabled, but this partition does not support one or both", type: f }] }, { conditions: o, type: e, rules: [{ conditions: [m], type: e, rules: [{ endpoint: { url: "https://refactor-spaces-fips.{Region}.{PartitionResult#dnsSuffix}", properties: l, headers: l }, type: g }] }, { error: "FIPS is enabled but this partition does not support FIPS", type: f }] }, { conditions: p, type: e, rules: [{ conditions: [n], type: e, rules: [{ endpoint: { url: "https://refactor-spaces.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: l, headers: l }, type: g }] }, { error: "DualStack is enabled but this partition does not support DualStack", type: f }] }, { endpoint: { url: "https://refactor-spaces.{Region}.{PartitionResult#dnsSuffix}", properties: l, headers: l }, type: g }] }] };
4
+ const q = "required", r = "fn", s = "argv", t = "ref";
5
+ const a = "isSet", b = "tree", c = "error", d = "endpoint", e = "PartitionResult", f = { [q]: false, "type": "String" }, g = { [q]: true, "default": false, "type": "Boolean" }, h = { [t]: "Endpoint" }, i = { [r]: "booleanEquals", [s]: [{ [t]: "UseFIPS" }, true] }, j = { [r]: "booleanEquals", [s]: [{ [t]: "UseDualStack" }, true] }, k = {}, l = { [r]: "booleanEquals", [s]: [true, { [r]: "getAttr", [s]: [{ [t]: e }, "supportsFIPS"] }] }, m = { [r]: "booleanEquals", [s]: [true, { [r]: "getAttr", [s]: [{ [t]: e }, "supportsDualStack"] }] }, n = [i], o = [j], p = [{ [t]: "Region" }];
6
+ const _data = { version: "1.0", parameters: { Region: f, UseDualStack: g, UseFIPS: g, Endpoint: f }, rules: [{ conditions: [{ [r]: a, [s]: [h] }], type: b, rules: [{ conditions: n, error: "Invalid Configuration: FIPS and custom endpoint are not supported", type: c }, { type: b, rules: [{ conditions: o, error: "Invalid Configuration: Dualstack and custom endpoint are not supported", type: c }, { endpoint: { url: h, properties: k, headers: k }, type: d }] }] }, { type: b, rules: [{ conditions: [{ [r]: a, [s]: p }], type: b, rules: [{ conditions: [{ [r]: "aws.partition", [s]: p, assign: e }], type: b, rules: [{ conditions: [i, j], type: b, rules: [{ conditions: [l, m], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://refactor-spaces-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "FIPS and DualStack are enabled, but this partition does not support one or both", type: c }] }, { conditions: n, type: b, rules: [{ conditions: [l], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://refactor-spaces-fips.{Region}.{PartitionResult#dnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "FIPS is enabled but this partition does not support FIPS", type: c }] }, { conditions: o, type: b, rules: [{ conditions: [m], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://refactor-spaces.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "DualStack is enabled but this partition does not support DualStack", type: c }] }, { type: b, rules: [{ endpoint: { url: "https://refactor-spaces.{Region}.{PartitionResult#dnsSuffix}", properties: k, headers: k }, type: d }] }] }] }, { error: "Invalid Configuration: Missing Region", type: c }] }] };
7
7
  exports.ruleSet = _data;
@@ -1,4 +1,4 @@
1
- const q = "fn", r = "argv", s = "ref";
2
- const a = true, b = false, c = "String", d = "PartitionResult", e = "tree", f = "error", g = "endpoint", h = { "required": true, "default": false, "type": "Boolean" }, i = { [s]: "Endpoint" }, j = { [q]: "booleanEquals", [r]: [{ [s]: "UseFIPS" }, true] }, k = { [q]: "booleanEquals", [r]: [{ [s]: "UseDualStack" }, true] }, l = {}, m = { [q]: "booleanEquals", [r]: [true, { [q]: "getAttr", [r]: [{ [s]: d }, "supportsFIPS"] }] }, n = { [q]: "booleanEquals", [r]: [true, { [q]: "getAttr", [r]: [{ [s]: d }, "supportsDualStack"] }] }, o = [j], p = [k];
3
- const _data = { version: "1.0", parameters: { Region: { required: a, type: c }, UseDualStack: h, UseFIPS: h, Endpoint: { required: b, type: c } }, rules: [{ conditions: [{ [q]: "aws.partition", [r]: [{ [s]: "Region" }], assign: d }], type: e, rules: [{ conditions: [{ [q]: "isSet", [r]: [i] }], type: e, rules: [{ conditions: o, error: "Invalid Configuration: FIPS and custom endpoint are not supported", type: f }, { type: e, rules: [{ conditions: p, error: "Invalid Configuration: Dualstack and custom endpoint are not supported", type: f }, { endpoint: { url: i, properties: l, headers: l }, type: g }] }] }, { conditions: [j, k], type: e, rules: [{ conditions: [m, n], type: e, rules: [{ endpoint: { url: "https://refactor-spaces-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: l, headers: l }, type: g }] }, { error: "FIPS and DualStack are enabled, but this partition does not support one or both", type: f }] }, { conditions: o, type: e, rules: [{ conditions: [m], type: e, rules: [{ endpoint: { url: "https://refactor-spaces-fips.{Region}.{PartitionResult#dnsSuffix}", properties: l, headers: l }, type: g }] }, { error: "FIPS is enabled but this partition does not support FIPS", type: f }] }, { conditions: p, type: e, rules: [{ conditions: [n], type: e, rules: [{ endpoint: { url: "https://refactor-spaces.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: l, headers: l }, type: g }] }, { error: "DualStack is enabled but this partition does not support DualStack", type: f }] }, { endpoint: { url: "https://refactor-spaces.{Region}.{PartitionResult#dnsSuffix}", properties: l, headers: l }, type: g }] }] };
1
+ const q = "required", r = "fn", s = "argv", t = "ref";
2
+ const a = "isSet", b = "tree", c = "error", d = "endpoint", e = "PartitionResult", f = { [q]: false, "type": "String" }, g = { [q]: true, "default": false, "type": "Boolean" }, h = { [t]: "Endpoint" }, i = { [r]: "booleanEquals", [s]: [{ [t]: "UseFIPS" }, true] }, j = { [r]: "booleanEquals", [s]: [{ [t]: "UseDualStack" }, true] }, k = {}, l = { [r]: "booleanEquals", [s]: [true, { [r]: "getAttr", [s]: [{ [t]: e }, "supportsFIPS"] }] }, m = { [r]: "booleanEquals", [s]: [true, { [r]: "getAttr", [s]: [{ [t]: e }, "supportsDualStack"] }] }, n = [i], o = [j], p = [{ [t]: "Region" }];
3
+ const _data = { version: "1.0", parameters: { Region: f, UseDualStack: g, UseFIPS: g, Endpoint: f }, rules: [{ conditions: [{ [r]: a, [s]: [h] }], type: b, rules: [{ conditions: n, error: "Invalid Configuration: FIPS and custom endpoint are not supported", type: c }, { type: b, rules: [{ conditions: o, error: "Invalid Configuration: Dualstack and custom endpoint are not supported", type: c }, { endpoint: { url: h, properties: k, headers: k }, type: d }] }] }, { type: b, rules: [{ conditions: [{ [r]: a, [s]: p }], type: b, rules: [{ conditions: [{ [r]: "aws.partition", [s]: p, assign: e }], type: b, rules: [{ conditions: [i, j], type: b, rules: [{ conditions: [l, m], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://refactor-spaces-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "FIPS and DualStack are enabled, but this partition does not support one or both", type: c }] }, { conditions: n, type: b, rules: [{ conditions: [l], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://refactor-spaces-fips.{Region}.{PartitionResult#dnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "FIPS is enabled but this partition does not support FIPS", type: c }] }, { conditions: o, type: b, rules: [{ conditions: [m], type: b, rules: [{ type: b, rules: [{ endpoint: { url: "https://refactor-spaces.{Region}.{PartitionResult#dualStackDnsSuffix}", properties: k, headers: k }, type: d }] }] }, { error: "DualStack is enabled but this partition does not support DualStack", type: c }] }, { type: b, rules: [{ endpoint: { url: "https://refactor-spaces.{Region}.{PartitionResult#dnsSuffix}", properties: k, headers: k }, type: d }] }] }] }, { error: "Invalid Configuration: Missing Region", type: c }] }] };
4
4
  export const ruleSet = _data;
@@ -42,6 +42,11 @@ export declare class MigrationHubRefactorSpaces extends MigrationHubRefactorSpac
42
42
  * applications created inside the environment, regardless of the account that creates the
43
43
  * application. Refactor Spaces provisions an Amazon API Gateway, API Gateway VPC link, and
44
44
  * Network Load Balancer for the application proxy inside your account.</p>
45
+ * <p>In environments created with a <a href="https://docs.aws.amazon.com/migrationhub-refactor-spaces/latest/APIReference/API_CreateEnvironment.html#migrationhubrefactorspaces-CreateEnvironment-request-NetworkFabricType">CreateEnvironment:NetworkFabricType</a> of <code>NONE</code> you need to configure
46
+ * <a href="https://docs.aws.amazon.com/whitepapers/latest/aws-vpc-connectivity-options/amazon-vpc-to-amazon-vpc-connectivity-options.html"> VPC to VPC connectivity</a> between your service VPC and the application proxy VPC to
47
+ * route traffic through the application proxy to a service with a private URL endpoint. For more
48
+ * information, see <a href="https://docs.aws.amazon.com/migrationhub-refactor-spaces/latest/userguide/getting-started-create-application.html">
49
+ * Create an application</a> in the <i>Refactor Spaces User Guide</i>. </p>
45
50
  */
46
51
  createApplication(args: CreateApplicationCommandInput, options?: __HttpHandlerOptions): Promise<CreateApplicationCommandOutput>;
47
52
  createApplication(args: CreateApplicationCommandInput, cb: (err: any, data?: CreateApplicationCommandOutput) => void): void;
@@ -53,9 +58,11 @@ export declare class MigrationHubRefactorSpaces extends MigrationHubRefactorSpac
53
58
  * to as the <i>environment owner</i>. The environment owner has cross-account
54
59
  * visibility and control of Refactor Spaces resources that are added to the environment by other
55
60
  * accounts that the environment is shared with.</p>
56
- * <p>When creating an environment with
57
- * a network fabric type of <code>TRANSIT_GATEWAY</code>,
58
- * Refactor Spaces provisions a transit gateway in your account.</p>
61
+ * <p>When creating an environment with a <a href="https://docs.aws.amazon.com/migrationhub-refactor-spaces/latest/APIReference/API_CreateEnvironment.html#migrationhubrefactorspaces-CreateEnvironment-request-NetworkFabricType">CreateEnvironment:NetworkFabricType</a> of <code>TRANSIT_GATEWAY</code>, Refactor Spaces
62
+ * provisions a transit gateway to enable services in VPCs to communicate directly across
63
+ * accounts. If <a href="https://docs.aws.amazon.com/migrationhub-refactor-spaces/latest/APIReference/API_CreateEnvironment.html#migrationhubrefactorspaces-CreateEnvironment-request-NetworkFabricType">CreateEnvironment:NetworkFabricType</a> is <code>NONE</code>, Refactor Spaces does not create
64
+ * a transit gateway and you must use your network infrastructure to route traffic to services
65
+ * with private URL endpoints.</p>
59
66
  */
60
67
  createEnvironment(args: CreateEnvironmentCommandInput, options?: __HttpHandlerOptions): Promise<CreateEnvironmentCommandOutput>;
61
68
  createEnvironment(args: CreateEnvironmentCommandInput, cb: (err: any, data?: CreateEnvironmentCommandOutput) => void): void;
@@ -75,45 +82,65 @@ export declare class MigrationHubRefactorSpaces extends MigrationHubRefactorSpac
75
82
  * to the target service as follows:</p>
76
83
  * <ul>
77
84
  * <li>
85
+ * <p>
86
+ * <b>URL Endpoints</b>
87
+ * </p>
78
88
  * <p>If the service has a URL endpoint, and the endpoint resolves to a private IP address,
79
- * Refactor Spaces routes traffic using the API Gateway VPC link. </p>
80
- * </li>
81
- * <li>
82
- * <p>If the service has a URL endpoint, and the endpoint resolves to a public IP address,
83
- * Refactor Spaces routes traffic over the public internet.</p>
89
+ * Refactor Spaces routes traffic using the API Gateway VPC link. If a service endpoint
90
+ * resolves to a public IP address, Refactor Spaces routes traffic over the public internet.
91
+ * Services can have HTTP or HTTPS URL endpoints. For HTTPS URLs, publicly-signed
92
+ * certificates are supported. Private Certificate Authorities (CAs) are permitted only if
93
+ * the CA's domain is also publicly resolvable. </p>
94
+ * <p>Refactor Spaces automatically resolves the public Domain Name System (DNS) names that are
95
+ * set in <code>CreateService:UrlEndpoint </code>when you create a service. The DNS names
96
+ * resolve when the DNS time-to-live (TTL) expires, or every 60 seconds for TTLs less than 60
97
+ * seconds. This periodic DNS resolution ensures that the route configuration remains
98
+ * up-to-date. </p>
99
+ * <p/>
100
+ * <p>
101
+ * <b>One-time health check</b>
102
+ * </p>
103
+ * <p>A one-time health check is performed on the service when either the route is updated
104
+ * from inactive to active, or when it is created with an active state. If the health check
105
+ * fails, the route transitions the route state to <code>FAILED</code>, an error code of
106
+ * <code>SERVICE_ENDPOINT_HEALTH_CHECK_FAILURE</code> is provided, and no traffic is sent
107
+ * to the service.</p>
108
+ * <p>For private URLs, a target group is created on the Network Load Balancer and the load
109
+ * balancer target group runs default target health checks. By default, the health check is
110
+ * run against the service endpoint URL. Optionally, the health check can be performed
111
+ * against a different protocol, port, and/or path using the <a href="https://docs.aws.amazon.com/migrationhub-refactor-spaces/latest/APIReference/API_CreateService.html#migrationhubrefactorspaces-CreateService-request-UrlEndpoint">CreateService:UrlEndpoint</a> parameter. All other health check settings for the
112
+ * load balancer use the default values described in the <a href="https://docs.aws.amazon.com/elasticloadbalancing/latest/application/target-group-health-checks.html">Health
113
+ * checks for your target groups</a> in the <i>Elastic Load Balancing
114
+ * guide</i>. The health check is considered successful if at least one target
115
+ * within the target group transitions to a healthy state.</p>
116
+ * <p/>
84
117
  * </li>
85
118
  * <li>
119
+ * <p>
120
+ * <b>Lambda function endpoints</b>
121
+ * </p>
86
122
  * <p>If the service has an Lambda function endpoint, then Refactor Spaces
87
123
  * configures the Lambda function's resource policy to allow the application's
88
124
  * API Gateway to invoke the function.</p>
125
+ * <p>The Lambda function state is checked. If the function is not active, the
126
+ * function configuration is updated so that Lambda resources are provisioned. If
127
+ * the Lambda state is <code>Failed</code>, then the route creation fails. For
128
+ * more information, see the <a href="https://docs.aws.amazon.com/lambda/latest/dg/API_GetFunctionConfiguration.html#SSS-GetFunctionConfiguration-response-State">GetFunctionConfiguration's State response parameter</a> in the <i>Lambda Developer Guide</i>.</p>
129
+ * <p>A check is performed to determine that a Lambda function with the specified ARN
130
+ * exists. If it does not exist, the health check fails. For public URLs, a connection is
131
+ * opened to the public endpoint. If the URL is not reachable, the health check fails.
132
+ * </p>
89
133
  * </li>
90
134
  * </ul>
91
- * <p>A one-time health check is performed on the service when either the route is updated from
92
- * inactive to active, or when it is created with an active state. If the health check fails, the
93
- * route transitions the route state to <code>FAILED</code>, an error code of
94
- * <code>SERVICE_ENDPOINT_HEALTH_CHECK_FAILURE</code> is provided, and no traffic is sent to
95
- * the service.</p>
96
- * <p>For Lambda functions, the Lambda function state is checked. If the
97
- * function is not active, the function configuration is updated so that Lambda
98
- * resources are provisioned. If the Lambda state is <code>Failed</code>, then the
99
- * route creation fails. For more information, see the <a href="https://docs.aws.amazon.com/lambda/latest/dg/API_GetFunctionConfiguration.html#SSS-GetFunctionConfiguration-response-State">GetFunctionConfiguration's State response parameter</a> in the <i>Lambda Developer Guide</i>.</p>
100
- * <p>For Lambda endpoints, a check is performed to determine that a Lambda function with the
101
- * specified ARN exists. If it does not exist, the health check fails. For public URLs, a
102
- * connection is opened to the public endpoint. If the URL is not reachable, the health check
103
- * fails. </p>
104
- * <p>Refactor Spaces automatically resolves the public Domain Name System (DNS) names that are set in
105
- * <a>CreateServiceRequest$UrlEndpoint</a> when you create a service. The DNS names
106
- * resolve when the DNS time-to-live (TTL) expires, or every 60 seconds for TTLs less than 60
107
- * seconds. This periodic DNS resolution ensures that the route configuration remains up-to-date. </p>
108
- * <p>For private URLS, a target group is created on the Elastic Load Balancing and the target
109
- * group health check is run. The <code>HealthCheckProtocol</code>, <code>HealthCheckPort</code>,
110
- * and <code>HealthCheckPath</code> are the same protocol, port, and path specified in the URL or
111
- * health URL, if used. All other settings use the default values, as described in <a href="https://docs.aws.amazon.com/elasticloadbalancing/latest/application/target-group-health-checks.html">Health checks
112
- * for your target groups</a>. The health check is considered successful if at least one
113
- * target within the target group transitions to a healthy state.</p>
114
- * <p>Services can have HTTP or HTTPS URL endpoints. For HTTPS URLs, publicly-signed
115
- * certificates are supported. Private Certificate Authorities (CAs) are permitted only if the
116
- * CA's domain is also publicly resolvable.</p>
135
+ * <p>
136
+ * <b>Environments without a network bridge</b>
137
+ * </p>
138
+ * <p>When you create environments without a network bridge (<a href="https://docs.aws.amazon.com/migrationhub-refactor-spaces/latest/APIReference/API_CreateEnvironment.html#migrationhubrefactorspaces-CreateEnvironment-request-NetworkFabricType">CreateEnvironment:NetworkFabricType</a> is <code>NONE)</code> and you use your own
139
+ * networking infrastructure, you need to configure <a href="https://docs.aws.amazon.com/whitepapers/latest/aws-vpc-connectivity-options/amazon-vpc-to-amazon-vpc-connectivity-options.html">VPC to VPC connectivity</a> between your network and the application proxy VPC. Route
140
+ * creation from the application proxy to service endpoints will fail if your network is not
141
+ * configured to connect to the application proxy VPC. For more information, see <a href="https://docs.aws.amazon.com/migrationhub-refactor-spaces/latest/userguide/getting-started-create-role.html"> Create
142
+ * a route</a> in the <i>Refactor Spaces User Guide</i>.</p>
143
+ * <p/>
117
144
  */
118
145
  createRoute(args: CreateRouteCommandInput, options?: __HttpHandlerOptions): Promise<CreateRouteCommandOutput>;
119
146
  createRoute(args: CreateRouteCommandInput, cb: (err: any, data?: CreateRouteCommandOutput) => void): void;
@@ -23,6 +23,11 @@ export interface CreateApplicationCommandOutput extends CreateApplicationRespons
23
23
  * applications created inside the environment, regardless of the account that creates the
24
24
  * application. Refactor Spaces provisions an Amazon API Gateway, API Gateway VPC link, and
25
25
  * Network Load Balancer for the application proxy inside your account.</p>
26
+ * <p>In environments created with a <a href="https://docs.aws.amazon.com/migrationhub-refactor-spaces/latest/APIReference/API_CreateEnvironment.html#migrationhubrefactorspaces-CreateEnvironment-request-NetworkFabricType">CreateEnvironment:NetworkFabricType</a> of <code>NONE</code> you need to configure
27
+ * <a href="https://docs.aws.amazon.com/whitepapers/latest/aws-vpc-connectivity-options/amazon-vpc-to-amazon-vpc-connectivity-options.html"> VPC to VPC connectivity</a> between your service VPC and the application proxy VPC to
28
+ * route traffic through the application proxy to a service with a private URL endpoint. For more
29
+ * information, see <a href="https://docs.aws.amazon.com/migrationhub-refactor-spaces/latest/userguide/getting-started-create-application.html">
30
+ * Create an application</a> in the <i>Refactor Spaces User Guide</i>. </p>
26
31
  * @example
27
32
  * Use a bare-bones client and the command you need to make an API call.
28
33
  * ```javascript
@@ -24,9 +24,11 @@ export interface CreateEnvironmentCommandOutput extends CreateEnvironmentRespons
24
24
  * to as the <i>environment owner</i>. The environment owner has cross-account
25
25
  * visibility and control of Refactor Spaces resources that are added to the environment by other
26
26
  * accounts that the environment is shared with.</p>
27
- * <p>When creating an environment with
28
- * a network fabric type of <code>TRANSIT_GATEWAY</code>,
29
- * Refactor Spaces provisions a transit gateway in your account.</p>
27
+ * <p>When creating an environment with a <a href="https://docs.aws.amazon.com/migrationhub-refactor-spaces/latest/APIReference/API_CreateEnvironment.html#migrationhubrefactorspaces-CreateEnvironment-request-NetworkFabricType">CreateEnvironment:NetworkFabricType</a> of <code>TRANSIT_GATEWAY</code>, Refactor Spaces
28
+ * provisions a transit gateway to enable services in VPCs to communicate directly across
29
+ * accounts. If <a href="https://docs.aws.amazon.com/migrationhub-refactor-spaces/latest/APIReference/API_CreateEnvironment.html#migrationhubrefactorspaces-CreateEnvironment-request-NetworkFabricType">CreateEnvironment:NetworkFabricType</a> is <code>NONE</code>, Refactor Spaces does not create
30
+ * a transit gateway and you must use your network infrastructure to route traffic to services
31
+ * with private URL endpoints.</p>
30
32
  * @example
31
33
  * Use a bare-bones client and the command you need to make an API call.
32
34
  * ```javascript
@@ -32,45 +32,65 @@ export interface CreateRouteCommandOutput extends CreateRouteResponse, __Metadat
32
32
  * to the target service as follows:</p>
33
33
  * <ul>
34
34
  * <li>
35
+ * <p>
36
+ * <b>URL Endpoints</b>
37
+ * </p>
35
38
  * <p>If the service has a URL endpoint, and the endpoint resolves to a private IP address,
36
- * Refactor Spaces routes traffic using the API Gateway VPC link. </p>
37
- * </li>
38
- * <li>
39
- * <p>If the service has a URL endpoint, and the endpoint resolves to a public IP address,
40
- * Refactor Spaces routes traffic over the public internet.</p>
39
+ * Refactor Spaces routes traffic using the API Gateway VPC link. If a service endpoint
40
+ * resolves to a public IP address, Refactor Spaces routes traffic over the public internet.
41
+ * Services can have HTTP or HTTPS URL endpoints. For HTTPS URLs, publicly-signed
42
+ * certificates are supported. Private Certificate Authorities (CAs) are permitted only if
43
+ * the CA's domain is also publicly resolvable. </p>
44
+ * <p>Refactor Spaces automatically resolves the public Domain Name System (DNS) names that are
45
+ * set in <code>CreateService:UrlEndpoint </code>when you create a service. The DNS names
46
+ * resolve when the DNS time-to-live (TTL) expires, or every 60 seconds for TTLs less than 60
47
+ * seconds. This periodic DNS resolution ensures that the route configuration remains
48
+ * up-to-date. </p>
49
+ * <p/>
50
+ * <p>
51
+ * <b>One-time health check</b>
52
+ * </p>
53
+ * <p>A one-time health check is performed on the service when either the route is updated
54
+ * from inactive to active, or when it is created with an active state. If the health check
55
+ * fails, the route transitions the route state to <code>FAILED</code>, an error code of
56
+ * <code>SERVICE_ENDPOINT_HEALTH_CHECK_FAILURE</code> is provided, and no traffic is sent
57
+ * to the service.</p>
58
+ * <p>For private URLs, a target group is created on the Network Load Balancer and the load
59
+ * balancer target group runs default target health checks. By default, the health check is
60
+ * run against the service endpoint URL. Optionally, the health check can be performed
61
+ * against a different protocol, port, and/or path using the <a href="https://docs.aws.amazon.com/migrationhub-refactor-spaces/latest/APIReference/API_CreateService.html#migrationhubrefactorspaces-CreateService-request-UrlEndpoint">CreateService:UrlEndpoint</a> parameter. All other health check settings for the
62
+ * load balancer use the default values described in the <a href="https://docs.aws.amazon.com/elasticloadbalancing/latest/application/target-group-health-checks.html">Health
63
+ * checks for your target groups</a> in the <i>Elastic Load Balancing
64
+ * guide</i>. The health check is considered successful if at least one target
65
+ * within the target group transitions to a healthy state.</p>
66
+ * <p/>
41
67
  * </li>
42
68
  * <li>
69
+ * <p>
70
+ * <b>Lambda function endpoints</b>
71
+ * </p>
43
72
  * <p>If the service has an Lambda function endpoint, then Refactor Spaces
44
73
  * configures the Lambda function's resource policy to allow the application's
45
74
  * API Gateway to invoke the function.</p>
75
+ * <p>The Lambda function state is checked. If the function is not active, the
76
+ * function configuration is updated so that Lambda resources are provisioned. If
77
+ * the Lambda state is <code>Failed</code>, then the route creation fails. For
78
+ * more information, see the <a href="https://docs.aws.amazon.com/lambda/latest/dg/API_GetFunctionConfiguration.html#SSS-GetFunctionConfiguration-response-State">GetFunctionConfiguration's State response parameter</a> in the <i>Lambda Developer Guide</i>.</p>
79
+ * <p>A check is performed to determine that a Lambda function with the specified ARN
80
+ * exists. If it does not exist, the health check fails. For public URLs, a connection is
81
+ * opened to the public endpoint. If the URL is not reachable, the health check fails.
82
+ * </p>
46
83
  * </li>
47
84
  * </ul>
48
- * <p>A one-time health check is performed on the service when either the route is updated from
49
- * inactive to active, or when it is created with an active state. If the health check fails, the
50
- * route transitions the route state to <code>FAILED</code>, an error code of
51
- * <code>SERVICE_ENDPOINT_HEALTH_CHECK_FAILURE</code> is provided, and no traffic is sent to
52
- * the service.</p>
53
- * <p>For Lambda functions, the Lambda function state is checked. If the
54
- * function is not active, the function configuration is updated so that Lambda
55
- * resources are provisioned. If the Lambda state is <code>Failed</code>, then the
56
- * route creation fails. For more information, see the <a href="https://docs.aws.amazon.com/lambda/latest/dg/API_GetFunctionConfiguration.html#SSS-GetFunctionConfiguration-response-State">GetFunctionConfiguration's State response parameter</a> in the <i>Lambda Developer Guide</i>.</p>
57
- * <p>For Lambda endpoints, a check is performed to determine that a Lambda function with the
58
- * specified ARN exists. If it does not exist, the health check fails. For public URLs, a
59
- * connection is opened to the public endpoint. If the URL is not reachable, the health check
60
- * fails. </p>
61
- * <p>Refactor Spaces automatically resolves the public Domain Name System (DNS) names that are set in
62
- * <a>CreateServiceRequest$UrlEndpoint</a> when you create a service. The DNS names
63
- * resolve when the DNS time-to-live (TTL) expires, or every 60 seconds for TTLs less than 60
64
- * seconds. This periodic DNS resolution ensures that the route configuration remains up-to-date. </p>
65
- * <p>For private URLS, a target group is created on the Elastic Load Balancing and the target
66
- * group health check is run. The <code>HealthCheckProtocol</code>, <code>HealthCheckPort</code>,
67
- * and <code>HealthCheckPath</code> are the same protocol, port, and path specified in the URL or
68
- * health URL, if used. All other settings use the default values, as described in <a href="https://docs.aws.amazon.com/elasticloadbalancing/latest/application/target-group-health-checks.html">Health checks
69
- * for your target groups</a>. The health check is considered successful if at least one
70
- * target within the target group transitions to a healthy state.</p>
71
- * <p>Services can have HTTP or HTTPS URL endpoints. For HTTPS URLs, publicly-signed
72
- * certificates are supported. Private Certificate Authorities (CAs) are permitted only if the
73
- * CA's domain is also publicly resolvable.</p>
85
+ * <p>
86
+ * <b>Environments without a network bridge</b>
87
+ * </p>
88
+ * <p>When you create environments without a network bridge (<a href="https://docs.aws.amazon.com/migrationhub-refactor-spaces/latest/APIReference/API_CreateEnvironment.html#migrationhubrefactorspaces-CreateEnvironment-request-NetworkFabricType">CreateEnvironment:NetworkFabricType</a> is <code>NONE)</code> and you use your own
89
+ * networking infrastructure, you need to configure <a href="https://docs.aws.amazon.com/whitepapers/latest/aws-vpc-connectivity-options/amazon-vpc-to-amazon-vpc-connectivity-options.html">VPC to VPC connectivity</a> between your network and the application proxy VPC. Route
90
+ * creation from the application proxy to service endpoints will fail if your network is not
91
+ * configured to connect to the application proxy VPC. For more information, see <a href="https://docs.aws.amazon.com/migrationhub-refactor-spaces/latest/userguide/getting-started-create-role.html"> Create
92
+ * a route</a> in the <i>Refactor Spaces User Guide</i>.</p>
93
+ * <p/>
74
94
  * @example
75
95
  * Use a bare-bones client and the command you need to make an API call.
76
96
  * ```javascript
@@ -12,7 +12,7 @@ export declare const resolveClientEndpointParameters: <T>(options: T & ClientInp
12
12
  defaultSigningName: string;
13
13
  };
14
14
  export interface EndpointParameters extends __EndpointParameters {
15
- Region: string;
15
+ Region?: string;
16
16
  UseDualStack?: boolean;
17
17
  UseFIPS?: boolean;
18
18
  Endpoint?: string;
@@ -599,7 +599,7 @@ export interface CreateEnvironmentResponse {
599
599
  */
600
600
  Tags?: Record<string, string>;
601
601
  /**
602
- * <p>A timestamp that indicates when the environment was last updated. </p>
602
+ * <p>A timestamp that indicates when the environment was last updated.</p>
603
603
  */
604
604
  LastUpdatedTime?: Date;
605
605
  /**
@@ -1200,7 +1200,7 @@ export interface EnvironmentSummary {
1200
1200
  */
1201
1201
  OwnerAccountId?: string;
1202
1202
  /**
1203
- * <p>The ID of the transit gateway set up by the environment. </p>
1203
+ * <p>The ID of the Transit Gateway set up by the environment. </p>
1204
1204
  */
1205
1205
  TransitGatewayId?: string;
1206
1206
  /**
@@ -1372,7 +1372,7 @@ export interface GetEnvironmentResponse {
1372
1372
  */
1373
1373
  OwnerAccountId?: string;
1374
1374
  /**
1375
- * <p>The ID of the transit gateway set up by the environment. </p>
1375
+ * <p>The ID of the Transit Gateway set up by the environment, if applicable.</p>
1376
1376
  */
1377
1377
  TransitGatewayId?: string;
1378
1378
  /**
@@ -26,7 +26,7 @@ export declare const resolveClientEndpointParameters: <T>(
26
26
  defaultSigningName: string;
27
27
  };
28
28
  export interface EndpointParameters extends __EndpointParameters {
29
- Region: string;
29
+ Region?: string;
30
30
  UseDualStack?: boolean;
31
31
  UseFIPS?: boolean;
32
32
  Endpoint?: string;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-migration-hub-refactor-spaces",
3
3
  "description": "AWS SDK for JavaScript Migration Hub Refactor Spaces Client for Node.js, Browser and React Native",
4
- "version": "3.310.0",
4
+ "version": "3.314.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -21,7 +21,7 @@
21
21
  "dependencies": {
22
22
  "@aws-crypto/sha256-browser": "3.0.0",
23
23
  "@aws-crypto/sha256-js": "3.0.0",
24
- "@aws-sdk/client-sts": "3.310.0",
24
+ "@aws-sdk/client-sts": "3.312.0",
25
25
  "@aws-sdk/config-resolver": "3.310.0",
26
26
  "@aws-sdk/credential-provider-node": "3.310.0",
27
27
  "@aws-sdk/fetch-http-handler": "3.310.0",