@aws-sdk/client-global-accelerator 3.437.0 → 3.441.0

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

@@ -0,0 +1,97 @@
+import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
+import { Command as $Command } from "@smithy/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
+import { GlobalAcceleratorClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../GlobalAcceleratorClient";
+import { ListCrossAccountResourcesRequest, ListCrossAccountResourcesResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link ListCrossAccountResourcesCommand}.
+ */
+export interface ListCrossAccountResourcesCommandInput extends ListCrossAccountResourcesRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link ListCrossAccountResourcesCommand}.
+ */
+export interface ListCrossAccountResourcesCommandOutput extends ListCrossAccountResourcesResponse, __MetadataBearer {
+}
+/**
+ * @public
+ * <p>List the cross-account endpoints available to add to an accelerator.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { GlobalAcceleratorClient, ListCrossAccountResourcesCommand } from "@aws-sdk/client-global-accelerator"; // ES Modules import
+ * // const { GlobalAcceleratorClient, ListCrossAccountResourcesCommand } = require("@aws-sdk/client-global-accelerator"); // CommonJS import
+ * const client = new GlobalAcceleratorClient(config);
+ * const input = { // ListCrossAccountResourcesRequest
+ *   AcceleratorArn: "STRING_VALUE",
+ *   ResourceOwnerAwsAccountId: "STRING_VALUE", // required
+ *   MaxResults: Number("int"),
+ *   NextToken: "STRING_VALUE",
+ * };
+ * const command = new ListCrossAccountResourcesCommand(input);
+ * const response = await client.send(command);
+ * // { // ListCrossAccountResourcesResponse
+ * //   CrossAccountResources: [ // CrossAccountResources
+ * //     { // CrossAccountResource
+ * //       EndpointId: "STRING_VALUE",
+ * //       AttachmentArn: "STRING_VALUE",
+ * //     },
+ * //   ],
+ * //   NextToken: "STRING_VALUE",
+ * // };
+ *
+ * ```
+ *
+ * @param ListCrossAccountResourcesCommandInput - {@link ListCrossAccountResourcesCommandInput}
+ * @returns {@link ListCrossAccountResourcesCommandOutput}
+ * @see {@link ListCrossAccountResourcesCommandInput} for command's `input` shape.
+ * @see {@link ListCrossAccountResourcesCommandOutput} for command's `response` shape.
+ * @see {@link GlobalAcceleratorClientResolvedConfig | config} for GlobalAcceleratorClient's `config` shape.
+ *
+ * @throws {@link AcceleratorNotFoundException} (client fault)
+ *  <p>The accelerator that you specified doesn't exist.</p>
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You don't have access permission.</p>
+ *
+ * @throws {@link InternalServiceErrorException} (server fault)
+ *  <p>There was an internal error for Global Accelerator.</p>
+ *
+ * @throws {@link InvalidArgumentException} (client fault)
+ *  <p>An argument that you specified is invalid.</p>
+ *
+ * @throws {@link InvalidNextTokenException} (client fault)
+ *  <p>There isn't another item to return.</p>
+ *
+ * @throws {@link GlobalAcceleratorServiceException}
+ * <p>Base exception class for all service exceptions from GlobalAccelerator service.</p>
+ *
+ */
+export declare class ListCrossAccountResourcesCommand extends $Command<ListCrossAccountResourcesCommandInput, ListCrossAccountResourcesCommandOutput, GlobalAcceleratorClientResolvedConfig> {
+    readonly input: ListCrossAccountResourcesCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    /**
+     * @public
+     */
+    constructor(input: ListCrossAccountResourcesCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: GlobalAcceleratorClientResolvedConfig, options?: __HttpHandlerOptions): Handler<ListCrossAccountResourcesCommandInput, ListCrossAccountResourcesCommandOutput>;
+    /**
+     * @internal
+     */
+    private serialize;
+    /**
+     * @internal
+     */
+    private deserialize;
+}

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

@@ -0,0 +1,141 @@
+import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
+import { Command as $Command } from "@smithy/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
+import { GlobalAcceleratorClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../GlobalAcceleratorClient";
+import { UpdateCrossAccountAttachmentRequest, UpdateCrossAccountAttachmentResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link UpdateCrossAccountAttachmentCommand}.
+ */
+export interface UpdateCrossAccountAttachmentCommandInput extends UpdateCrossAccountAttachmentRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link UpdateCrossAccountAttachmentCommand}.
+ */
+export interface UpdateCrossAccountAttachmentCommandOutput extends UpdateCrossAccountAttachmentResponse, __MetadataBearer {
+}
+/**
+ * @public
+ * <p>Update a cross-account attachment to add or remove principals or resources. When you update
+ * 			an attachment to remove a principal (account ID or accelerator) or a resource, Global Accelerator
+ * 			revokes the permission for specific resources by doing the following:</p>
+ *          <ul>
+ *             <li>
+ *                <p>If the principal is an account ID, Global Accelerator reviews every accelerator in the account
+ * 				and removes cross-account endpoints from all accelerators.</p>
+ *             </li>
+ *             <li>
+ *                <p>If the principal is an accelerator, Global Accelerator reviews just that accelerator
+ * 				and removes cross-account endpoints from it.</p>
+ *             </li>
+ *          </ul>
+ *          <p>If there are overlapping permissions provided by multiple cross-account attachments,
+ * 			Global Accelerator only removes endpoints if there are no current cross-account attachments that provide
+ * 			access permission. For example, if you delete a cross-account attachment that lists an
+ * 			accelerator as a principal, but another cross-account attachment includes the account ID
+ * 			that owns that accelerator, endpoints will not be removed from the accelerator.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { GlobalAcceleratorClient, UpdateCrossAccountAttachmentCommand } from "@aws-sdk/client-global-accelerator"; // ES Modules import
+ * // const { GlobalAcceleratorClient, UpdateCrossAccountAttachmentCommand } = require("@aws-sdk/client-global-accelerator"); // CommonJS import
+ * const client = new GlobalAcceleratorClient(config);
+ * const input = { // UpdateCrossAccountAttachmentRequest
+ *   AttachmentArn: "STRING_VALUE", // required
+ *   Name: "STRING_VALUE",
+ *   AddPrincipals: [ // Principals
+ *     "STRING_VALUE",
+ *   ],
+ *   RemovePrincipals: [
+ *     "STRING_VALUE",
+ *   ],
+ *   AddResources: [ // Resources
+ *     { // Resource
+ *       EndpointId: "STRING_VALUE", // required
+ *       Region: "STRING_VALUE",
+ *     },
+ *   ],
+ *   RemoveResources: [
+ *     {
+ *       EndpointId: "STRING_VALUE", // required
+ *       Region: "STRING_VALUE",
+ *     },
+ *   ],
+ * };
+ * const command = new UpdateCrossAccountAttachmentCommand(input);
+ * const response = await client.send(command);
+ * // { // UpdateCrossAccountAttachmentResponse
+ * //   CrossAccountAttachment: { // Attachment
+ * //     AttachmentArn: "STRING_VALUE",
+ * //     Name: "STRING_VALUE",
+ * //     Principals: [ // Principals
+ * //       "STRING_VALUE",
+ * //     ],
+ * //     Resources: [ // Resources
+ * //       { // Resource
+ * //         EndpointId: "STRING_VALUE", // required
+ * //         Region: "STRING_VALUE",
+ * //       },
+ * //     ],
+ * //     LastModifiedTime: new Date("TIMESTAMP"),
+ * //     CreatedTime: new Date("TIMESTAMP"),
+ * //   },
+ * // };
+ *
+ * ```
+ *
+ * @param UpdateCrossAccountAttachmentCommandInput - {@link UpdateCrossAccountAttachmentCommandInput}
+ * @returns {@link UpdateCrossAccountAttachmentCommandOutput}
+ * @see {@link UpdateCrossAccountAttachmentCommandInput} for command's `input` shape.
+ * @see {@link UpdateCrossAccountAttachmentCommandOutput} for command's `response` shape.
+ * @see {@link GlobalAcceleratorClientResolvedConfig | config} for GlobalAcceleratorClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You don't have access permission.</p>
+ *
+ * @throws {@link AttachmentNotFoundException} (client fault)
+ *  <p>No cross-account attachment was found.</p>
+ *
+ * @throws {@link InternalServiceErrorException} (server fault)
+ *  <p>There was an internal error for Global Accelerator.</p>
+ *
+ * @throws {@link InvalidArgumentException} (client fault)
+ *  <p>An argument that you specified is invalid.</p>
+ *
+ * @throws {@link LimitExceededException} (client fault)
+ *  <p>Processing your request would cause you to exceed an Global Accelerator limit.</p>
+ *
+ * @throws {@link TransactionInProgressException} (client fault)
+ *  <p>There's already a transaction in progress. Another transaction can't be processed.</p>
+ *
+ * @throws {@link GlobalAcceleratorServiceException}
+ * <p>Base exception class for all service exceptions from GlobalAccelerator service.</p>
+ *
+ */
+export declare class UpdateCrossAccountAttachmentCommand extends $Command<UpdateCrossAccountAttachmentCommandInput, UpdateCrossAccountAttachmentCommandOutput, GlobalAcceleratorClientResolvedConfig> {
+    readonly input: UpdateCrossAccountAttachmentCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    /**
+     * @public
+     */
+    constructor(input: UpdateCrossAccountAttachmentCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: GlobalAcceleratorClientResolvedConfig, options?: __HttpHandlerOptions): Handler<UpdateCrossAccountAttachmentCommandInput, UpdateCrossAccountAttachmentCommandOutput>;
+    /**
+     * @internal
+     */
+    private serialize;
+    /**
+     * @internal
+     */
+    private deserialize;
+}

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

@@ -37,6 +37,7 @@ export interface UpdateEndpointGroupCommandOutput extends UpdateEndpointGroupRes
  *       EndpointId: "STRING_VALUE",
  *       Weight: Number("int"),
  *       ClientIPPreservationEnabled: true || false,
+ *       AttachmentArn: "STRING_VALUE",
  *     },
  *   ],
  *   TrafficDialPercentage: Number("float"),

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

@@ -3,12 +3,14 @@ export * from "./AddEndpointsCommand";
 export * from "./AdvertiseByoipCidrCommand";
 export * from "./AllowCustomRoutingTrafficCommand";
 export * from "./CreateAcceleratorCommand";
+export * from "./CreateCrossAccountAttachmentCommand";
 export * from "./CreateCustomRoutingAcceleratorCommand";
 export * from "./CreateCustomRoutingEndpointGroupCommand";
 export * from "./CreateCustomRoutingListenerCommand";
 export * from "./CreateEndpointGroupCommand";
 export * from "./CreateListenerCommand";
 export * from "./DeleteAcceleratorCommand";
+export * from "./DeleteCrossAccountAttachmentCommand";
 export * from "./DeleteCustomRoutingAcceleratorCommand";
 export * from "./DeleteCustomRoutingEndpointGroupCommand";
 export * from "./DeleteCustomRoutingListenerCommand";
@@ -18,6 +20,7 @@ export * from "./DenyCustomRoutingTrafficCommand";
 export * from "./DeprovisionByoipCidrCommand";
 export * from "./DescribeAcceleratorAttributesCommand";
 export * from "./DescribeAcceleratorCommand";
+export * from "./DescribeCrossAccountAttachmentCommand";
 export * from "./DescribeCustomRoutingAcceleratorAttributesCommand";
 export * from "./DescribeCustomRoutingAcceleratorCommand";
 export * from "./DescribeCustomRoutingEndpointGroupCommand";
@@ -26,6 +29,9 @@ export * from "./DescribeEndpointGroupCommand";
 export * from "./DescribeListenerCommand";
 export * from "./ListAcceleratorsCommand";
 export * from "./ListByoipCidrsCommand";
+export * from "./ListCrossAccountAttachmentsCommand";
+export * from "./ListCrossAccountResourceAccountsCommand";
+export * from "./ListCrossAccountResourcesCommand";
 export * from "./ListCustomRoutingAcceleratorsCommand";
 export * from "./ListCustomRoutingEndpointGroupsCommand";
 export * from "./ListCustomRoutingListenersCommand";
@@ -41,6 +47,7 @@ export * from "./TagResourceCommand";
 export * from "./UntagResourceCommand";
 export * from "./UpdateAcceleratorAttributesCommand";
 export * from "./UpdateAcceleratorCommand";
+export * from "./UpdateCrossAccountAttachmentCommand";
 export * from "./UpdateCustomRoutingAcceleratorAttributesCommand";
 export * from "./UpdateCustomRoutingAcceleratorCommand";
 export * from "./UpdateCustomRoutingListenerCommand";

package/dist-types/index.d.ts

@@ -26,7 +26,7 @@
  * 			are anycast from the Amazon Web Services edge network. For IPv4, Global Accelerator provides two static IPv4 addresses. For dual-stack,
  * 			Global Accelerator provides a total of four addresses: two static IPv4 addresses and two static IPv6 addresses.
  * 			With a standard accelerator for IPv4, instead of using the addresses that Global Accelerator provides, you can configure
- * 			these entry points to be IPv4 addresses from your own IP address ranges that you bring toGlobal Accelerator (BYOIP). </p>
+ * 			these entry points to be IPv4 addresses from your own IP address ranges that you bring to Global Accelerator (BYOIP). </p>
  *          <p>For a standard accelerator,
  * 	        they distribute incoming application traffic across multiple endpoint resources in multiple Amazon Web Services Regions , which increases
  * 			the availability of your applications. Endpoints for standard accelerators can be Network Load Balancers, Application Load Balancers,
@@ -56,4 +56,5 @@ export { ClientInputEndpointParameters } from "./endpoint/EndpointParameters";
 export * from "./commands";
 export * from "./pagination";
 export * from "./models";
+import "@aws-sdk/util-endpoints";
 export { GlobalAcceleratorServiceException } from "./models/GlobalAcceleratorServiceException";