@aws-sdk/client-ecs 3.1153.0 → 3.1154.0

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

@@ -0,0 +1,143 @@
+import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import type { UpdateGatewayRequest, UpdateGatewayResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+/**
+ * @public
+ *
+ * The input for {@link UpdateGatewayCommand}.
+ */
+export interface UpdateGatewayCommandInput extends UpdateGatewayRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link UpdateGatewayCommand}.
+ */
+export interface UpdateGatewayCommandOutput extends UpdateGatewayResponse, __MetadataBearer {
+}
+declare const UpdateGatewayCommand_base: {
+    new (input: UpdateGatewayCommandInput): import("@smithy/core/client").CommandImpl<UpdateGatewayCommandInput, UpdateGatewayCommandOutput, import("..").ECSClientResolvedConfig, import("..").ServiceInputTypes, import("..").ServiceOutputTypes>;
+    new (input: UpdateGatewayCommandInput): import("@smithy/core/client").CommandImpl<UpdateGatewayCommandInput, UpdateGatewayCommandOutput, import("..").ECSClientResolvedConfig, import("..").ServiceInputTypes, import("..").ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
+};
+/**
+ * <p>Modifies the configuration of a gateway. You can change only the properties that can be applied without interrupting traffic, and the configuration variant that you provide must match the gateway's type. <code>UpdateGateway</code> is an asynchronous operation: the changes are applied to each load balancer the gateway manages, and the gateway reports a status of <code>UPDATE_IN_PROGRESS</code> until the update completes. If Amazon ECS can't update one or more resources, it makes a best effort to update the rest and the gateway status changes to <code>UPDATE_FAILED</code>. Use <code>DescribeGateway</code> to inspect the gateway's <code>statusReason</code> and failures list, which gives the ARN of each load balancer that was not updated and the operation, error code, and message for each failure.</p> <p>If you specify <code>infrastructureRoleArn</code>, you must have the <code>iam:PassRole</code> permission for that role.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { ECSClient, UpdateGatewayCommand } from "@aws-sdk/client-ecs"; // ES Modules import
+ * // const { ECSClient, UpdateGatewayCommand } = 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 = { // UpdateGatewayRequest
+ *   gateway: "STRING_VALUE", // required
+ *   infrastructureRoleArn: "STRING_VALUE",
+ *   deletionProtection: true || false,
+ *   configuration: { // UpdateGatewayConfiguration Union: only one key present
+ *     hostSharedAlb: { // UpdateGatewayAlbConfiguration
+ *       networkConfiguration: { // UpdateGatewayNetworkConfiguration
+ *         inboundSecurityGroup: "STRING_VALUE",
+ *       },
+ *       maxAlbCount: Number("int"),
+ *       webACLArn: "STRING_VALUE",
+ *       accessLogs: { // GatewayElbAccessLogConfiguration
+ *         destination: { // GatewayElbAccessLogDestination Union: only one key present
+ *           s3: { // GatewayElbAccessLogS3Destination
+ *             bucket: "STRING_VALUE", // required
+ *             prefix: "STRING_VALUE",
+ *           },
+ *         },
+ *       },
+ *       httpDesync: "monitor" || "defensive" || "strictest",
+ *       testTrafficRules: { // GatewayAlbTestTrafficRules
+ *         header: { // GatewayTestTrafficHeader
+ *           name: "STRING_VALUE", // required
+ *           values: [ // StringList // required
+ *             "STRING_VALUE",
+ *           ],
+ *         },
+ *       },
+ *     },
+ *   },
+ *   propagateTags: "NONE" || "GATEWAY",
+ * };
+ * const command = new UpdateGatewayCommand(input);
+ * const response = await client.send(command);
+ * // { // UpdateGatewayResponse
+ * //   gatewayArn: "STRING_VALUE",
+ * //   name: "STRING_VALUE",
+ * //   status: "ACTIVE" || "UPDATE_IN_PROGRESS" || "UPDATE_COMPLETE" || "UPDATE_FAILED" || "DELETED",
+ * // };
+ *
+ * ```
+ *
+ * @param UpdateGatewayCommandInput - {@link UpdateGatewayCommandInput}
+ * @returns {@link UpdateGatewayCommandOutput}
+ * @see {@link UpdateGatewayCommandInput} for command's `input` shape.
+ * @see {@link UpdateGatewayCommandOutput} 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 update a gateway
+ * ```javascript
+ * // This example raises the maximum number of Application Load Balancers that the gateway named my-gateway manages, and changes the desync mitigation mode to strictest.
+ * const input = {
+ *   configuration: {
+ *     hostSharedAlb: {
+ *       httpDesync: "strictest",
+ *       maxAlbCount: 20
+ *     }
+ *   },
+ *   gateway: "my-gateway"
+ * };
+ * const command = new UpdateGatewayCommand(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: "UPDATE_IN_PROGRESS"
+ * }
+ * *\/
+ * ```
+ *
+ * @public
+ */
+export declare class UpdateGatewayCommand extends UpdateGatewayCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: UpdateGatewayRequest;
+            output: UpdateGatewayResponse;
+        };
+        sdk: {
+            input: UpdateGatewayCommandInput;
+            output: UpdateGatewayCommandOutput;
+        };
+    };
+}

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

@@ -1,5 +1,5 @@
 import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
-import type { UpdateServiceRequest, UpdateServiceResponse } from "../models/models_0";
+import type { UpdateServiceRequest, UpdateServiceResponse } from "../models/models_1";
 /**
  * @public
  */
@@ -248,6 +248,29 @@ declare const UpdateServiceCommand_base: {
  *       },
  *     },
  *   ],
+ *   gatewayConnectors: [ // GatewayConnectorList
+ *     { // GatewayConnector
+ *       portName: "STRING_VALUE", // required
+ *       healthCheck: { // GatewayConnectorHealthCheck
+ *         healthCheckProtocol: "HTTP" || "HTTPS",
+ *         healthCheckPort: Number("int"),
+ *         healthCheckPath: "STRING_VALUE",
+ *         healthCheckTimeoutSeconds: Number("int"),
+ *         healthCheckIntervalSeconds: Number("int"),
+ *         healthyThresholdCount: Number("int"),
+ *         unhealthyThresholdCount: Number("int"),
+ *         matcher: { // GatewayConnectorHealthCheckMatcher
+ *           httpCode: "STRING_VALUE",
+ *           grpcCode: "STRING_VALUE",
+ *         },
+ *       },
+ *       filters: { // GatewayConnectorFilters
+ *         accessTypes: [ // AccessTypeList
+ *           "PUBLIC" || "PRIVATE",
+ *         ],
+ *       },
+ *     },
+ *   ],
  *   monitoring: { // MonitoringConfiguration
  *     metricConfigurations: [ // MetricConfigurationList
  *       { // MetricConfiguration

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

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

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

@@ -1,8 +1,10 @@
+export * from "./AssociateGatewayWithClusterCommand";
 export * from "./ContinueServiceDeploymentCommand";
 export * from "./CreateCapacityProviderCommand";
 export * from "./CreateClusterCommand";
 export * from "./CreateDaemonCommand";
 export * from "./CreateExpressGatewayServiceCommand";
+export * from "./CreateGatewayCommand";
 export * from "./CreateServiceCommand";
 export * from "./CreateTaskSetCommand";
 export * from "./DeleteAccountSettingCommand";
@@ -12,6 +14,7 @@ export * from "./DeleteClusterCommand";
 export * from "./DeleteDaemonCommand";
 export * from "./DeleteDaemonTaskDefinitionCommand";
 export * from "./DeleteExpressGatewayServiceCommand";
+export * from "./DeleteGatewayCommand";
 export * from "./DeleteServiceCommand";
 export * from "./DeleteTaskDefinitionsCommand";
 export * from "./DeleteTaskSetCommand";
@@ -25,12 +28,16 @@ export * from "./DescribeDaemonDeploymentsCommand";
 export * from "./DescribeDaemonRevisionsCommand";
 export * from "./DescribeDaemonTaskDefinitionCommand";
 export * from "./DescribeExpressGatewayServiceCommand";
+export * from "./DescribeGatewayCommand";
+export * from "./DescribeGatewayResourcesCommand";
+export * from "./DescribeGatewayRouteCommand";
 export * from "./DescribeServiceDeploymentsCommand";
 export * from "./DescribeServiceRevisionsCommand";
 export * from "./DescribeServicesCommand";
 export * from "./DescribeTaskDefinitionCommand";
 export * from "./DescribeTaskSetsCommand";
 export * from "./DescribeTasksCommand";
+export * from "./DisassociateGatewayFromClusterCommand";
 export * from "./DiscoverPollEndpointCommand";
 export * from "./ExecuteCommandCommand";
 export * from "./GetTaskProtectionCommand";
@@ -41,6 +48,9 @@ export * from "./ListContainerInstancesCommand";
 export * from "./ListDaemonDeploymentsCommand";
 export * from "./ListDaemonTaskDefinitionsCommand";
 export * from "./ListDaemonsCommand";
+export * from "./ListGatewayClusterAssociationsCommand";
+export * from "./ListGatewayRoutesCommand";
+export * from "./ListGatewaysCommand";
 export * from "./ListServiceDeploymentsCommand";
 export * from "./ListServicesByNamespaceCommand";
 export * from "./ListServicesCommand";
@@ -71,6 +81,7 @@ export * from "./UpdateContainerAgentCommand";
 export * from "./UpdateContainerInstancesStateCommand";
 export * from "./UpdateDaemonCommand";
 export * from "./UpdateExpressGatewayServiceCommand";
+export * from "./UpdateGatewayCommand";
 export * from "./UpdateServiceCommand";
 export * from "./UpdateServicePrimaryTaskSetCommand";
 export * from "./UpdateTaskProtectionCommand";

package/dist-types/models/enums.d.ts

@@ -53,7 +53,13 @@ export type AcceleratorType = (typeof AcceleratorType)[keyof typeof AcceleratorT
  * @enum
  */
 export declare const AccessType: {
+    /**
+     * <p>The resource is private and reachable only from within the VPC.</p>
+     */
     readonly PRIVATE: "PRIVATE";
+    /**
+     * <p>The resource is publicly accessible from the internet.</p>
+     */
     readonly PUBLIC: "PUBLIC";
 };
 /**
@@ -959,6 +965,191 @@ export declare const TaskDefinitionField: {
  * @public
  */
 export type TaskDefinitionField = (typeof TaskDefinitionField)[keyof typeof TaskDefinitionField];
+/**
+ * @public
+ * @enum
+ */
+export declare const GatewayClusterAssociationStatus: {
+    /**
+     * <p>The association is active.</p>
+     */
+    readonly ACTIVE: "ACTIVE";
+    /**
+     * <p>The association is being removed and remains in this state until all gateway routes for the cluster are removed.</p>
+     */
+    readonly DISASSOCIATING: "DISASSOCIATING";
+    readonly INACTIVE: "INACTIVE";
+};
+/**
+ * @public
+ */
+export type GatewayClusterAssociationStatus = (typeof GatewayClusterAssociationStatus)[keyof typeof GatewayClusterAssociationStatus];
+/**
+ * @public
+ * @enum
+ */
+export declare const GatewayAlbDesyncMitigationMode: {
+    /**
+     * <p>The load balancers allow through most requests but drop those that pose a significant security risk.</p>
+     */
+    readonly DEFENSIVE: "defensive";
+    /**
+     * <p>The load balancers forward requests that are considered ambiguous but allow them to be monitored.</p>
+     */
+    readonly MONITOR: "monitor";
+    /**
+     * <p>The load balancers allow through only requests that comply with HTTP/1.1.</p>
+     */
+    readonly STRICTEST: "strictest";
+};
+/**
+ * @public
+ */
+export type GatewayAlbDesyncMitigationMode = (typeof GatewayAlbDesyncMitigationMode)[keyof typeof GatewayAlbDesyncMitigationMode];
+/**
+ * @public
+ * @enum
+ */
+export declare const GatewayElbIpAddressType: {
+    /**
+     * <p>The load balancers use both IPv4 and IPv6 addresses.</p>
+     */
+    readonly DUALSTACK: "dualstack";
+    /**
+     * <p>The load balancers use IPv6 addresses and private IPv4 addresses, without public IPv4 addresses.</p>
+     */
+    readonly DUALSTACK_WITHOUT_PUBLIC_IPV4: "dualstack-without-public-ipv4";
+    /**
+     * <p>The load balancers use IPv4 addresses only.</p>
+     */
+    readonly IPV4: "ipv4";
+};
+/**
+ * @public
+ */
+export type GatewayElbIpAddressType = (typeof GatewayElbIpAddressType)[keyof typeof GatewayElbIpAddressType];
+/**
+ * @public
+ * @enum
+ */
+export declare const GatewayAlbProtocol: {
+    /**
+     * <p>The listener uses HTTP.</p>
+     */
+    readonly HTTP: "HTTP";
+    /**
+     * <p>The listener uses HTTPS.</p>
+     */
+    readonly HTTPS: "HTTPS";
+};
+/**
+ * @public
+ */
+export type GatewayAlbProtocol = (typeof GatewayAlbProtocol)[keyof typeof GatewayAlbProtocol];
+/**
+ * @public
+ * @enum
+ */
+export declare const GatewayElbScheme: {
+    /**
+     * <p>The load balancers are internal.</p>
+     */
+    readonly INTERNAL: "internal";
+    /**
+     * <p>The load balancers are internet-facing.</p>
+     */
+    readonly INTERNET_FACING: "internet-facing";
+};
+/**
+ * @public
+ */
+export type GatewayElbScheme = (typeof GatewayElbScheme)[keyof typeof GatewayElbScheme];
+/**
+ * @public
+ * @enum
+ */
+export declare const PropagateGatewayTags: {
+    /**
+     * <p>Tags on the gateway are propagated to the infrastructure that the gateway manages.</p>
+     */
+    readonly GATEWAY: "GATEWAY";
+    /**
+     * <p>Tags aren't propagated to managed infrastructure.</p>
+     */
+    readonly NONE: "NONE";
+};
+/**
+ * @public
+ */
+export type PropagateGatewayTags = (typeof PropagateGatewayTags)[keyof typeof PropagateGatewayTags];
+/**
+ * @public
+ * @enum
+ */
+export declare const GatewayStatus: {
+    /**
+     * <p>The gateway is active and available for use.</p>
+     */
+    readonly ACTIVE: "ACTIVE";
+    /**
+     * <p>The gateway is deleted.</p>
+     */
+    readonly DELETED: "DELETED";
+    /**
+     * <p>The update to the gateway completed successfully.</p>
+     */
+    readonly UPDATE_COMPLETE: "UPDATE_COMPLETE";
+    /**
+     * <p>The update to the gateway failed. See <code>statusReason</code> for details.</p>
+     */
+    readonly UPDATE_FAILED: "UPDATE_FAILED";
+    /**
+     * <p>An update to the gateway is in progress.</p>
+     */
+    readonly UPDATE_IN_PROGRESS: "UPDATE_IN_PROGRESS";
+};
+/**
+ * @public
+ */
+export type GatewayStatus = (typeof GatewayStatus)[keyof typeof GatewayStatus];
+/**
+ * @public
+ * @enum
+ */
+export declare const GatewayRouteStatus: {
+    /**
+     * <p>The gateway route is active and routing traffic.</p>
+     */
+    readonly ACTIVE: "ACTIVE";
+    /**
+     * <p>The gateway route couldn't be created.</p>
+     */
+    readonly CREATE_FAILED: "CREATE_FAILED";
+    /**
+     * <p>The gateway route is being created.</p>
+     */
+    readonly CREATE_IN_PROGRESS: "CREATE_IN_PROGRESS";
+    /**
+     * <p>The gateway route couldn't be deleted.</p>
+     */
+    readonly DELETE_FAILED: "DELETE_FAILED";
+    /**
+     * <p>The gateway route is being deleted.</p>
+     */
+    readonly DELETE_IN_PROGRESS: "DELETE_IN_PROGRESS";
+    /**
+     * <p>The gateway route couldn't be updated.</p>
+     */
+    readonly UPDATE_FAILED: "UPDATE_FAILED";
+    /**
+     * <p>The gateway route is being updated.</p>
+     */
+    readonly UPDATE_IN_PROGRESS: "UPDATE_IN_PROGRESS";
+};
+/**
+ * @public
+ */
+export type GatewayRouteStatus = (typeof GatewayRouteStatus)[keyof typeof GatewayRouteStatus];
 /**
  * @public
  * @enum
@@ -1181,6 +1372,24 @@ export declare const DeploymentControllerType: {
  * @public
  */
 export type DeploymentControllerType = (typeof DeploymentControllerType)[keyof typeof DeploymentControllerType];
+/**
+ * @public
+ * @enum
+ */
+export declare const GatewayConnectorHealthCheckProtocol: {
+    /**
+     * <p>The gateway performs health checks over HTTP.</p>
+     */
+    readonly HTTP: "HTTP";
+    /**
+     * <p>The gateway performs health checks over HTTPS.</p>
+     */
+    readonly HTTPS: "HTTPS";
+};
+/**
+ * @public
+ */
+export type GatewayConnectorHealthCheckProtocol = (typeof GatewayConnectorHealthCheckProtocol)[keyof typeof GatewayConnectorHealthCheckProtocol];
 /**
  * @public
  * @enum

package/dist-types/models/errors.d.ts

@@ -313,43 +313,56 @@ export declare class DaemonNotFoundException extends __BaseException {
     constructor(opts: __ExceptionOptionType<DaemonNotFoundException, __BaseException>);
 }
 /**
- * <p>The specified platform version doesn't satisfy the required capabilities of the task definition.</p>
+ * <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>
  * @public
  */
-export declare class PlatformTaskDefinitionIncompatibilityException extends __BaseException {
+export declare class GatewayNotFoundException extends __BaseException {
     static readonly shapeId: string;
-    readonly name: "PlatformTaskDefinitionIncompatibilityException";
+    readonly name: "GatewayNotFoundException";
     readonly $fault: "client";
     /**
      * @internal
      */
-    constructor(opts: __ExceptionOptionType<PlatformTaskDefinitionIncompatibilityException, __BaseException>);
+    constructor(opts: __ExceptionOptionType<GatewayNotFoundException, __BaseException>);
 }
 /**
- * <p>The specified service isn't active. You can't update a service that's inactive. If you have previously deleted a service, you can re-create it with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html">CreateService</a>.</p>
+ * <p>The specified resource wasn't found.</p>
  * @public
  */
-export declare class ServiceNotActiveException extends __BaseException {
+export declare class ResourceNotFoundException extends __BaseException {
     static readonly shapeId: string;
-    readonly name: "ServiceNotActiveException";
+    readonly name: "ResourceNotFoundException";
     readonly $fault: "client";
     /**
      * @internal
      */
-    constructor(opts: __ExceptionOptionType<ServiceNotActiveException, __BaseException>);
+    constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
 }
 /**
- * <p>The specified resource wasn't found.</p>
+ * <p>The specified platform version doesn't satisfy the required capabilities of the task definition.</p>
  * @public
  */
-export declare class ResourceNotFoundException extends __BaseException {
+export declare class PlatformTaskDefinitionIncompatibilityException extends __BaseException {
     static readonly shapeId: string;
-    readonly name: "ResourceNotFoundException";
+    readonly name: "PlatformTaskDefinitionIncompatibilityException";
     readonly $fault: "client";
     /**
      * @internal
      */
-    constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
+    constructor(opts: __ExceptionOptionType<PlatformTaskDefinitionIncompatibilityException, __BaseException>);
+}
+/**
+ * <p>The specified service isn't active. You can't update a service that's inactive. If you have previously deleted a service, you can re-create it with <a href="https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html">CreateService</a>.</p>
+ * @public
+ */
+export declare class ServiceNotActiveException extends __BaseException {
+    static readonly shapeId: string;
+    readonly name: "ServiceNotActiveException";
+    readonly $fault: "client";
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<ServiceNotActiveException, __BaseException>);
 }
 /**
  * <p>The request could not be processed because of conflict in the current state of the resource. </p>