@aws-sdk/client-ecs 3.1153.0 → 3.1154.0

package/dist-types/commands/DeleteGatewayCommand.d.ts

@@ -0,0 +1,108 @@
+import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import type { DeleteGatewayRequest, DeleteGatewayResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+/**
+ * @public
+ *
+ * The input for {@link DeleteGatewayCommand}.
+ */
+export interface DeleteGatewayCommandInput extends DeleteGatewayRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link DeleteGatewayCommand}.
+ */
+export interface DeleteGatewayCommandOutput extends DeleteGatewayResponse, __MetadataBearer {
+}
+declare const DeleteGatewayCommand_base: {
+    new (input: DeleteGatewayCommandInput): import("@smithy/core/client").CommandImpl<DeleteGatewayCommandInput, DeleteGatewayCommandOutput, import("..").ECSClientResolvedConfig, import("..").ServiceInputTypes, import("..").ServiceOutputTypes>;
+    new (input: DeleteGatewayCommandInput): import("@smithy/core/client").CommandImpl<DeleteGatewayCommandInput, DeleteGatewayCommandOutput, import("..").ECSClientResolvedConfig, import("..").ServiceInputTypes, import("..").ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
+};
+/**
+ * <p>Deletes a gateway. Before you can delete a gateway, deletion protection must be disabled and the gateway must not have any cluster associations that are in the <code>ACTIVE</code> or <code>DISASSOCIATING</code> state. If associations exist, the operation fails; disassociate all clusters first. <code>DeleteGateway</code> is a synchronous operation. After you delete a gateway, subsequent requests for it return a <code>GatewayNotFoundException</code>.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { ECSClient, DeleteGatewayCommand } from "@aws-sdk/client-ecs"; // ES Modules import
+ * // const { ECSClient, DeleteGatewayCommand } = require("@aws-sdk/client-ecs"); // CommonJS import
+ * // import type { ECSClientConfig } from "@aws-sdk/client-ecs";
+ * const config = {}; // type is ECSClientConfig
+ * const client = new ECSClient(config);
+ * const input = { // DeleteGatewayRequest
+ *   gateway: "STRING_VALUE", // required
+ * };
+ * const command = new DeleteGatewayCommand(input);
+ * const response = await client.send(command);
+ * // { // DeleteGatewayResponse
+ * //   gatewayArn: "STRING_VALUE",
+ * //   name: "STRING_VALUE",
+ * //   status: "ACTIVE" || "UPDATE_IN_PROGRESS" || "UPDATE_COMPLETE" || "UPDATE_FAILED" || "DELETED",
+ * // };
+ *
+ * ```
+ *
+ * @param DeleteGatewayCommandInput - {@link DeleteGatewayCommandInput}
+ * @returns {@link DeleteGatewayCommandOutput}
+ * @see {@link DeleteGatewayCommandInput} for command's `input` shape.
+ * @see {@link DeleteGatewayCommandOutput} for command's `response` shape.
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You don't have authorization to perform the requested action.</p>
+ *
+ * @throws {@link ClientException} (client fault)
+ *  <p>These errors are usually caused by a client action. This client action might be using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Or, it might be specifying an identifier that isn't valid.</p>
+ *
+ * @throws {@link GatewayNotFoundException} (client fault)
+ *  <p>The specified gateway wasn't found. Check that the gateway name or ARN is correct and that the gateway exists in your account and Region.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The specified parameter isn't valid. Review the available parameters for the API request.</p> <p>For more information about service event errors, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-event-messages-list.html">Amazon ECS service event messages</a>. </p>
+ *
+ * @throws {@link ServerException} (server fault)
+ *  <p>These errors are usually caused by a server issue.</p>
+ *
+ * @throws {@link UnsupportedFeatureException} (client fault)
+ *  <p>The specified task isn't supported in this Region.</p>
+ *
+ * @throws {@link ECSServiceException}
+ * <p>Base exception class for all service exceptions from ECS service.</p>
+ *
+ *
+ * @example To delete a gateway
+ * ```javascript
+ * // This example deletes the gateway named my-gateway. Deletion protection must be disabled and the gateway must not be associated with any clusters.
+ * const input = {
+ *   gateway: "my-gateway"
+ * };
+ * const command = new DeleteGatewayCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   gatewayArn: "arn:aws:ecs:us-east-1:123456789012:gateway/my-gateway/a1b2c3d4e5f6478890abcdef12345678",
+ *   name: "my-gateway",
+ *   status: "DELETED"
+ * }
+ * *\/
+ * ```
+ *
+ * @public
+ */
+export declare class DeleteGatewayCommand extends DeleteGatewayCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: DeleteGatewayRequest;
+            output: DeleteGatewayResponse;
+        };
+        sdk: {
+            input: DeleteGatewayCommandInput;
+            output: DeleteGatewayCommandOutput;
+        };
+    };
+}

package/dist-types/commands/DeleteServiceCommand.d.ts

@@ -1,5 +1,5 @@
 import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
-import type { DeleteServiceRequest, DeleteServiceResponse } from "../models/models_0";
+import type { DeleteServiceRequest, DeleteServiceResponse } from "../models/models_1";
 /**
  * @public
  */

package/dist-types/commands/DescribeExpressGatewayServiceCommand.d.ts

@@ -1,5 +1,5 @@
 import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
-import type { DescribeExpressGatewayServiceRequest, DescribeExpressGatewayServiceResponse } from "../models/models_0";
+import type { DescribeExpressGatewayServiceRequest, DescribeExpressGatewayServiceResponse } from "../models/models_1";
 /**
  * @public
  */

package/dist-types/commands/DescribeGatewayCommand.d.ts

@@ -0,0 +1,200 @@
+import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import type { DescribeGatewayRequest, DescribeGatewayResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+/**
+ * @public
+ *
+ * The input for {@link DescribeGatewayCommand}.
+ */
+export interface DescribeGatewayCommandInput extends DescribeGatewayRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link DescribeGatewayCommand}.
+ */
+export interface DescribeGatewayCommandOutput extends DescribeGatewayResponse, __MetadataBearer {
+}
+declare const DescribeGatewayCommand_base: {
+    new (input: DescribeGatewayCommandInput): import("@smithy/core/client").CommandImpl<DescribeGatewayCommandInput, DescribeGatewayCommandOutput, import("..").ECSClientResolvedConfig, import("..").ServiceInputTypes, import("..").ServiceOutputTypes>;
+    new (input: DescribeGatewayCommandInput): import("@smithy/core/client").CommandImpl<DescribeGatewayCommandInput, DescribeGatewayCommandOutput, import("..").ECSClientResolvedConfig, import("..").ServiceInputTypes, import("..").ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
+};
+/**
+ * <p>Describes a gateway, including its configuration, status, and the type-specific infrastructure settings that it uses.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { ECSClient, DescribeGatewayCommand } from "@aws-sdk/client-ecs"; // ES Modules import
+ * // const { ECSClient, DescribeGatewayCommand } = require("@aws-sdk/client-ecs"); // CommonJS import
+ * // import type { ECSClientConfig } from "@aws-sdk/client-ecs";
+ * const config = {}; // type is ECSClientConfig
+ * const client = new ECSClient(config);
+ * const input = { // DescribeGatewayRequest
+ *   gateway: "STRING_VALUE", // required
+ * };
+ * const command = new DescribeGatewayCommand(input);
+ * const response = await client.send(command);
+ * // { // DescribeGatewayResponse
+ * //   gateway: { // Gateway
+ * //     gatewayArn: "STRING_VALUE",
+ * //     name: "STRING_VALUE",
+ * //     status: "ACTIVE" || "UPDATE_IN_PROGRESS" || "UPDATE_COMPLETE" || "UPDATE_FAILED" || "DELETED",
+ * //     statusReason: "STRING_VALUE",
+ * //     failures: [ // GatewayResourceFailureList
+ * //       { // GatewayResourceFailure
+ * //         arn: "STRING_VALUE",
+ * //         errors: [ // GatewayOperationErrorList
+ * //           { // GatewayOperationError
+ * //             operation: "STRING_VALUE",
+ * //             code: "STRING_VALUE",
+ * //             message: "STRING_VALUE",
+ * //           },
+ * //         ],
+ * //       },
+ * //     ],
+ * //     infrastructureRoleArn: "STRING_VALUE",
+ * //     deletionProtection: true || false,
+ * //     configuration: { // DescribeGatewayConfiguration Union: only one key present
+ * //       hostSharedAlb: { // DescribeGatewayAlbConfiguration
+ * //         networkConfiguration: { // GatewayElbNetworkConfiguration
+ * //           inboundSecurityGroup: "STRING_VALUE",
+ * //           subnets: [ // StringList
+ * //             "STRING_VALUE",
+ * //           ],
+ * //           ipAddressType: "ipv4" || "dualstack" || "dualstack-without-public-ipv4",
+ * //         },
+ * //         scheme: "internet-facing" || "internal",
+ * //         accessLogs: { // GatewayElbAccessLogConfiguration
+ * //           destination: { // GatewayElbAccessLogDestination Union: only one key present
+ * //             s3: { // GatewayElbAccessLogS3Destination
+ * //               bucket: "STRING_VALUE", // required
+ * //               prefix: "STRING_VALUE",
+ * //             },
+ * //           },
+ * //         },
+ * //         webACLArn: "STRING_VALUE",
+ * //         port: Number("int"),
+ * //         protocol: "HTTP" || "HTTPS",
+ * //         maxAlbCount: Number("int"),
+ * //         currentAlbCount: Number("int"),
+ * //         httpDesync: "monitor" || "defensive" || "strictest",
+ * //         testTrafficRules: { // GatewayAlbTestTrafficRules
+ * //           header: { // GatewayTestTrafficHeader
+ * //             name: "STRING_VALUE", // required
+ * //             values: [ // required
+ * //               "STRING_VALUE",
+ * //             ],
+ * //           },
+ * //         },
+ * //       },
+ * //     },
+ * //     accessType: "PUBLIC" || "PRIVATE",
+ * //     propagateTags: "NONE" || "GATEWAY",
+ * //     tags: [ // Tags
+ * //       { // Tag
+ * //         key: "STRING_VALUE",
+ * //         value: "STRING_VALUE",
+ * //       },
+ * //     ],
+ * //     createdAt: new Date("TIMESTAMP"),
+ * //     updatedAt: new Date("TIMESTAMP"),
+ * //   },
+ * // };
+ *
+ * ```
+ *
+ * @param DescribeGatewayCommandInput - {@link DescribeGatewayCommandInput}
+ * @returns {@link DescribeGatewayCommandOutput}
+ * @see {@link DescribeGatewayCommandInput} for command's `input` shape.
+ * @see {@link DescribeGatewayCommandOutput} for command's `response` shape.
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You don't have authorization to perform the requested action.</p>
+ *
+ * @throws {@link ClientException} (client fault)
+ *  <p>These errors are usually caused by a client action. This client action might be using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Or, it might be specifying an identifier that isn't valid.</p>
+ *
+ * @throws {@link GatewayNotFoundException} (client fault)
+ *  <p>The specified gateway wasn't found. Check that the gateway name or ARN is correct and that the gateway exists in your account and Region.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The specified parameter isn't valid. Review the available parameters for the API request.</p> <p>For more information about service event errors, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-event-messages-list.html">Amazon ECS service event messages</a>. </p>
+ *
+ * @throws {@link ServerException} (server fault)
+ *  <p>These errors are usually caused by a server issue.</p>
+ *
+ * @throws {@link UnsupportedFeatureException} (client fault)
+ *  <p>The specified task isn't supported in this Region.</p>
+ *
+ * @throws {@link ECSServiceException}
+ * <p>Base exception class for all service exceptions from ECS service.</p>
+ *
+ *
+ * @example To describe a gateway
+ * ```javascript
+ * // This example describes the gateway named my-gateway.
+ * const input = {
+ *   gateway: "my-gateway"
+ * };
+ * const command = new DescribeGatewayCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   gateway: {
+ *     accessType: "PUBLIC",
+ *     configuration: {
+ *       hostSharedAlb: {
+ *         currentAlbCount: 1,
+ *         httpDesync: "defensive",
+ *         maxAlbCount: 10,
+ *         networkConfiguration: {
+ *           ipAddressType: "ipv4",
+ *           subnets: [
+ *             "subnet-0123456789abcdef0",
+ *             "subnet-0fedcba9876543210"
+ *           ]
+ *         },
+ *         port: 443,
+ *         protocol: "HTTPS",
+ *         scheme: "internet-facing"
+ *       }
+ *     },
+ *     createdAt: "2026-10-20T12:00:00.000Z",
+ *     deletionProtection: true,
+ *     gatewayArn: "arn:aws:ecs:us-east-1:123456789012:gateway/my-gateway/a1b2c3d4e5f6478890abcdef12345678",
+ *     infrastructureRoleArn: "arn:aws:iam::123456789012:role/ecsInfrastructureRole",
+ *     name: "my-gateway",
+ *     propagateTags: "GATEWAY",
+ *     status: "ACTIVE",
+ *     tags: [
+ *       {
+ *         key: "team",
+ *         value: "web"
+ *       }
+ *     ],
+ *     updatedAt: "2026-10-20T12:00:00.000Z"
+ *   }
+ * }
+ * *\/
+ * ```
+ *
+ * @public
+ */
+export declare class DescribeGatewayCommand extends DescribeGatewayCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: DescribeGatewayRequest;
+            output: DescribeGatewayResponse;
+        };
+        sdk: {
+            input: DescribeGatewayCommandInput;
+            output: DescribeGatewayCommandOutput;
+        };
+    };
+}

package/dist-types/commands/DescribeGatewayResourcesCommand.d.ts

@@ -0,0 +1,135 @@
+import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import type { DescribeGatewayResourcesRequest, DescribeGatewayResourcesResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+/**
+ * @public
+ *
+ * The input for {@link DescribeGatewayResourcesCommand}.
+ */
+export interface DescribeGatewayResourcesCommandInput extends DescribeGatewayResourcesRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link DescribeGatewayResourcesCommand}.
+ */
+export interface DescribeGatewayResourcesCommandOutput extends DescribeGatewayResourcesResponse, __MetadataBearer {
+}
+declare const DescribeGatewayResourcesCommand_base: {
+    new (input: DescribeGatewayResourcesCommandInput): import("@smithy/core/client").CommandImpl<DescribeGatewayResourcesCommandInput, DescribeGatewayResourcesCommandOutput, import("..").ECSClientResolvedConfig, import("..").ServiceInputTypes, import("..").ServiceOutputTypes>;
+    new (input: DescribeGatewayResourcesCommandInput): import("@smithy/core/client").CommandImpl<DescribeGatewayResourcesCommandInput, DescribeGatewayResourcesCommandOutput, import("..").ECSClientResolvedConfig, import("..").ServiceInputTypes, import("..").ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
+};
+/**
+ * <p>Returns the infrastructure that a gateway has created and manages, so that you can follow the traffic path from top-level shared resources, such as load balancers, to the service-specific resources represented as gateway routes. Responses include only the Amazon Resource Names (ARNs) of gateway-managed infrastructure. For the current state of a resource, describe it with the corresponding Amazon Web Services service (Elastic Load Balancing, Amazon EC2, or Amazon Web Services Certificate Manager). The results are paginated.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { ECSClient, DescribeGatewayResourcesCommand } from "@aws-sdk/client-ecs"; // ES Modules import
+ * // const { ECSClient, DescribeGatewayResourcesCommand } = require("@aws-sdk/client-ecs"); // CommonJS import
+ * // import type { ECSClientConfig } from "@aws-sdk/client-ecs";
+ * const config = {}; // type is ECSClientConfig
+ * const client = new ECSClient(config);
+ * const input = { // DescribeGatewayResourcesRequest
+ *   gateway: "STRING_VALUE", // required
+ *   maxResults: Number("int"),
+ *   nextToken: "STRING_VALUE",
+ * };
+ * const command = new DescribeGatewayResourcesCommand(input);
+ * const response = await client.send(command);
+ * // { // DescribeGatewayResourcesResponse
+ * //   gatewayResources: { // GatewayResources
+ * //     gatewayArn: "STRING_VALUE",
+ * //     resources: { // GatewayInfrastructureResources Union: only one key present
+ * //       hostSharedAlb: [ // ElbGatewayResourcesList
+ * //         { // ElbGatewayResources
+ * //           loadBalancerArn: "STRING_VALUE",
+ * //           listenerArn: "STRING_VALUE",
+ * //           securityGroup: "STRING_VALUE",
+ * //           gatewayRouteArns: [ // StringList
+ * //             "STRING_VALUE",
+ * //           ],
+ * //         },
+ * //       ],
+ * //     },
+ * //   },
+ * //   nextToken: "STRING_VALUE",
+ * // };
+ *
+ * ```
+ *
+ * @param DescribeGatewayResourcesCommandInput - {@link DescribeGatewayResourcesCommandInput}
+ * @returns {@link DescribeGatewayResourcesCommandOutput}
+ * @see {@link DescribeGatewayResourcesCommandInput} for command's `input` shape.
+ * @see {@link DescribeGatewayResourcesCommandOutput} for command's `response` shape.
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You don't have authorization to perform the requested action.</p>
+ *
+ * @throws {@link ClientException} (client fault)
+ *  <p>These errors are usually caused by a client action. This client action might be using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Or, it might be specifying an identifier that isn't valid.</p>
+ *
+ * @throws {@link GatewayNotFoundException} (client fault)
+ *  <p>The specified gateway wasn't found. Check that the gateway name or ARN is correct and that the gateway exists in your account and Region.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The specified parameter isn't valid. Review the available parameters for the API request.</p> <p>For more information about service event errors, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-event-messages-list.html">Amazon ECS service event messages</a>. </p>
+ *
+ * @throws {@link ServerException} (server fault)
+ *  <p>These errors are usually caused by a server issue.</p>
+ *
+ * @throws {@link UnsupportedFeatureException} (client fault)
+ *  <p>The specified task isn't supported in this Region.</p>
+ *
+ * @throws {@link ECSServiceException}
+ * <p>Base exception class for all service exceptions from ECS service.</p>
+ *
+ *
+ * @example To describe the infrastructure that a gateway manages
+ * ```javascript
+ * // This example returns the load balancers, listeners, and gateway routes that the gateway named my-gateway manages.
+ * const input = {
+ *   gateway: "my-gateway"
+ * };
+ * const command = new DescribeGatewayResourcesCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   gatewayResources: {
+ *     gatewayArn: "arn:aws:ecs:us-east-1:123456789012:gateway/my-gateway/a1b2c3d4e5f6478890abcdef12345678",
+ *     resources: {
+ *       hostSharedAlb: [
+ *         {
+ *           gatewayRouteArns: [
+ *             "arn:aws:ecs:us-east-1:123456789012:gateway-route/my-gateway/a1b2c3d4e5f6478890abcdef12345678/f0e1d2c3b4a5968778695a4b3c2d1e0f"
+ *           ],
+ *           listenerArn: "arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/ecs-gateway-alb-1/50dc6c495c0c9188/f2f7dc8efc522ab2",
+ *           loadBalancerArn: "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/ecs-gateway-alb-1/50dc6c495c0c9188",
+ *           securityGroup: "sg-0123456789abcdef0"
+ *         }
+ *       ]
+ *     }
+ *   }
+ * }
+ * *\/
+ * ```
+ *
+ * @public
+ */
+export declare class DescribeGatewayResourcesCommand extends DescribeGatewayResourcesCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: DescribeGatewayResourcesRequest;
+            output: DescribeGatewayResourcesResponse;
+        };
+        sdk: {
+            input: DescribeGatewayResourcesCommandInput;
+            output: DescribeGatewayResourcesCommandOutput;
+        };
+    };
+}

package/dist-types/commands/DescribeGatewayRouteCommand.d.ts

@@ -0,0 +1,160 @@
+import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import type { DescribeGatewayRouteRequest, DescribeGatewayRouteResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+/**
+ * @public
+ *
+ * The input for {@link DescribeGatewayRouteCommand}.
+ */
+export interface DescribeGatewayRouteCommandInput extends DescribeGatewayRouteRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link DescribeGatewayRouteCommand}.
+ */
+export interface DescribeGatewayRouteCommandOutput extends DescribeGatewayRouteResponse, __MetadataBearer {
+}
+declare const DescribeGatewayRouteCommand_base: {
+    new (input: DescribeGatewayRouteCommandInput): import("@smithy/core/client").CommandImpl<DescribeGatewayRouteCommandInput, DescribeGatewayRouteCommandOutput, import("..").ECSClientResolvedConfig, import("..").ServiceInputTypes, import("..").ServiceOutputTypes>;
+    new (input: DescribeGatewayRouteCommandInput): import("@smithy/core/client").CommandImpl<DescribeGatewayRouteCommandInput, DescribeGatewayRouteCommandOutput, import("..").ECSClientResolvedConfig, import("..").ServiceInputTypes, import("..").ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
+};
+/**
+ * <p>Describes a gateway route, including its status, the service it routes traffic to, and the service-specific infrastructure, such as target groups and listener rules, that the gateway manages for it.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { ECSClient, DescribeGatewayRouteCommand } from "@aws-sdk/client-ecs"; // ES Modules import
+ * // const { ECSClient, DescribeGatewayRouteCommand } = require("@aws-sdk/client-ecs"); // CommonJS import
+ * // import type { ECSClientConfig } from "@aws-sdk/client-ecs";
+ * const config = {}; // type is ECSClientConfig
+ * const client = new ECSClient(config);
+ * const input = { // DescribeGatewayRouteRequest
+ *   gatewayRouteArn: "STRING_VALUE", // required
+ * };
+ * const command = new DescribeGatewayRouteCommand(input);
+ * const response = await client.send(command);
+ * // { // DescribeGatewayRouteResponse
+ * //   gatewayRoute: { // GatewayRoute
+ * //     gatewayRouteArn: "STRING_VALUE",
+ * //     serviceArn: "STRING_VALUE",
+ * //     serviceContainerPortName: "STRING_VALUE",
+ * //     status: "ACTIVE" || "CREATE_IN_PROGRESS" || "CREATE_FAILED" || "UPDATE_IN_PROGRESS" || "UPDATE_FAILED" || "DELETE_IN_PROGRESS" || "DELETE_FAILED",
+ * //     serviceUrl: "STRING_VALUE",
+ * //     resources: { // GatewayRouteResources Union: only one key present
+ * //       hostSharedAlb: [ // GatewayRouteAlbResourcesList
+ * //         { // GatewayRouteAlbResources
+ * //           acmCertificateArn: "STRING_VALUE",
+ * //           loadBalancerArn: "STRING_VALUE",
+ * //           listenerArn: "STRING_VALUE",
+ * //           listenerRuleArn: "STRING_VALUE",
+ * //           testListenerRuleArns: [ // StringList
+ * //             "STRING_VALUE",
+ * //           ],
+ * //           loadBalancerSecurityGroups: [ // GatewayRouteLoadBalancerSecurityGroupList
+ * //             { // GatewayRouteLoadBalancerSecurityGroup
+ * //               arn: "STRING_VALUE",
+ * //               ruleArns: [
+ * //                 "STRING_VALUE",
+ * //               ],
+ * //             },
+ * //           ],
+ * //           serviceSecurityGroupArn: "STRING_VALUE",
+ * //         },
+ * //       ],
+ * //     },
+ * //   },
+ * // };
+ *
+ * ```
+ *
+ * @param DescribeGatewayRouteCommandInput - {@link DescribeGatewayRouteCommandInput}
+ * @returns {@link DescribeGatewayRouteCommandOutput}
+ * @see {@link DescribeGatewayRouteCommandInput} for command's `input` shape.
+ * @see {@link DescribeGatewayRouteCommandOutput} for command's `response` shape.
+ * @see {@link ECSClientResolvedConfig | config} for ECSClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You don't have authorization to perform the requested action.</p>
+ *
+ * @throws {@link ClientException} (client fault)
+ *  <p>These errors are usually caused by a client action. This client action might be using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Or, it might be specifying an identifier that isn't valid.</p>
+ *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The specified parameter isn't valid. Review the available parameters for the API request.</p> <p>For more information about service event errors, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-event-messages-list.html">Amazon ECS service event messages</a>. </p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>The specified resource wasn't found.</p>
+ *
+ * @throws {@link ServerException} (server fault)
+ *  <p>These errors are usually caused by a server issue.</p>
+ *
+ * @throws {@link UnsupportedFeatureException} (client fault)
+ *  <p>The specified task isn't supported in this Region.</p>
+ *
+ * @throws {@link ECSServiceException}
+ * <p>Base exception class for all service exceptions from ECS service.</p>
+ *
+ *
+ * @example To describe a gateway route
+ * ```javascript
+ * // This example describes the specified gateway route, including the service URL and the load balancer resources that the gateway manages for the route.
+ * const input = {
+ *   gatewayRouteArn: "arn:aws:ecs:us-east-1:123456789012:gateway-route/my-gateway/a1b2c3d4e5f6478890abcdef12345678/f0e1d2c3b4a5968778695a4b3c2d1e0f"
+ * };
+ * const command = new DescribeGatewayRouteCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   gatewayRoute: {
+ *     gatewayRouteArn: "arn:aws:ecs:us-east-1:123456789012:gateway-route/my-gateway/a1b2c3d4e5f6478890abcdef12345678/f0e1d2c3b4a5968778695a4b3c2d1e0f",
+ *     resources: {
+ *       hostSharedAlb: [
+ *         {
+ *           acmCertificateArn: "arn:aws:acm:us-east-1:123456789012:certificate/12345678-90ab-cdef-1234-567890abcdef",
+ *           listenerArn: "arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/ecs-gateway-alb-1/50dc6c495c0c9188/f2f7dc8efc522ab2",
+ *           listenerRuleArn: "arn:aws:elasticloadbalancing:us-east-1:123456789012:listener-rule/app/ecs-gateway-alb-1/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee",
+ *           loadBalancerArn: "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/ecs-gateway-alb-1/50dc6c495c0c9188",
+ *           loadBalancerSecurityGroups: [
+ *             {
+ *               arn: "arn:aws:ec2:us-east-1:123456789012:security-group/sg-0123456789abcdef0",
+ *               ruleArns: [
+ *                 "arn:aws:ec2:us-east-1:123456789012:security-group-rule/sgr-0123456789abcdef0"
+ *               ]
+ *             }
+ *           ],
+ *           serviceSecurityGroupArn: "arn:aws:ec2:us-east-1:123456789012:security-group/sg-0fedcba9876543210",
+ *           testListenerRuleArns: [
+ *             "arn:aws:elasticloadbalancing:us-east-1:123456789012:listener-rule/app/ecs-gateway-alb-1/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cc1d2"
+ *           ]
+ *         }
+ *       ]
+ *     },
+ *     serviceArn: "arn:aws:ecs:us-east-1:123456789012:service/my-cluster/my-web-service",
+ *     serviceContainerPortName: "web",
+ *     serviceUrl: "https://my-web-service.example.com",
+ *     status: "ACTIVE"
+ *   }
+ * }
+ * *\/
+ * ```
+ *
+ * @public
+ */
+export declare class DescribeGatewayRouteCommand extends DescribeGatewayRouteCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: DescribeGatewayRouteRequest;
+            output: DescribeGatewayRouteResponse;
+        };
+        sdk: {
+            input: DescribeGatewayRouteCommandInput;
+            output: DescribeGatewayRouteCommandOutput;
+        };
+    };
+}