@aws-sdk/client-cloudwatch-logs 3.441.0 → 3.448.0

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

@@ -0,0 +1,86 @@
+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 { CloudWatchLogsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudWatchLogsClient";
+import { GetDeliveryDestinationPolicyRequest, GetDeliveryDestinationPolicyResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link GetDeliveryDestinationPolicyCommand}.
+ */
+export interface GetDeliveryDestinationPolicyCommandInput extends GetDeliveryDestinationPolicyRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link GetDeliveryDestinationPolicyCommand}.
+ */
+export interface GetDeliveryDestinationPolicyCommandOutput extends GetDeliveryDestinationPolicyResponse, __MetadataBearer {
+}
+/**
+ * @public
+ * <p>Retrieves the delivery destination policy assigned to the delivery destination that you specify.
+ *       For more information about delivery destinations and their policies, see
+ *         <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html">PutDeliveryDestinationPolicy</a>.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { CloudWatchLogsClient, GetDeliveryDestinationPolicyCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
+ * // const { CloudWatchLogsClient, GetDeliveryDestinationPolicyCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
+ * const client = new CloudWatchLogsClient(config);
+ * const input = { // GetDeliveryDestinationPolicyRequest
+ *   deliveryDestinationName: "STRING_VALUE", // required
+ * };
+ * const command = new GetDeliveryDestinationPolicyCommand(input);
+ * const response = await client.send(command);
+ * // { // GetDeliveryDestinationPolicyResponse
+ * //   policy: { // Policy
+ * //     deliveryDestinationPolicy: "STRING_VALUE",
+ * //   },
+ * // };
+ *
+ * ```
+ *
+ * @param GetDeliveryDestinationPolicyCommandInput - {@link GetDeliveryDestinationPolicyCommandInput}
+ * @returns {@link GetDeliveryDestinationPolicyCommandOutput}
+ * @see {@link GetDeliveryDestinationPolicyCommandInput} for command's `input` shape.
+ * @see {@link GetDeliveryDestinationPolicyCommandOutput} for command's `response` shape.
+ * @see {@link CloudWatchLogsClientResolvedConfig | config} for CloudWatchLogsClient's `config` shape.
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>The specified resource does not exist.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The service cannot complete the request.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>One of the parameters for the request is not valid.</p>
+ *
+ * @throws {@link CloudWatchLogsServiceException}
+ * <p>Base exception class for all service exceptions from CloudWatchLogs service.</p>
+ *
+ */
+export declare class GetDeliveryDestinationPolicyCommand extends $Command<GetDeliveryDestinationPolicyCommandInput, GetDeliveryDestinationPolicyCommandOutput, CloudWatchLogsClientResolvedConfig> {
+    readonly input: GetDeliveryDestinationPolicyCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    /**
+     * @public
+     */
+    constructor(input: GetDeliveryDestinationPolicyCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudWatchLogsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<GetDeliveryDestinationPolicyCommandInput, GetDeliveryDestinationPolicyCommandOutput>;
+    /**
+     * @internal
+     */
+    private serialize;
+    /**
+     * @internal
+     */
+    private deserialize;
+}

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

@@ -0,0 +1,99 @@
+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 { CloudWatchLogsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudWatchLogsClient";
+import { GetDeliverySourceRequest, GetDeliverySourceResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link GetDeliverySourceCommand}.
+ */
+export interface GetDeliverySourceCommandInput extends GetDeliverySourceRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link GetDeliverySourceCommand}.
+ */
+export interface GetDeliverySourceCommandOutput extends GetDeliverySourceResponse, __MetadataBearer {
+}
+/**
+ * @public
+ * <p>Retrieves complete information about one delivery source.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { CloudWatchLogsClient, GetDeliverySourceCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
+ * // const { CloudWatchLogsClient, GetDeliverySourceCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
+ * const client = new CloudWatchLogsClient(config);
+ * const input = { // GetDeliverySourceRequest
+ *   name: "STRING_VALUE", // required
+ * };
+ * const command = new GetDeliverySourceCommand(input);
+ * const response = await client.send(command);
+ * // { // GetDeliverySourceResponse
+ * //   deliverySource: { // DeliverySource
+ * //     name: "STRING_VALUE",
+ * //     arn: "STRING_VALUE",
+ * //     resourceArns: [ // ResourceArns
+ * //       "STRING_VALUE",
+ * //     ],
+ * //     service: "STRING_VALUE",
+ * //     logType: "STRING_VALUE",
+ * //     tags: { // Tags
+ * //       "<keys>": "STRING_VALUE",
+ * //     },
+ * //   },
+ * // };
+ *
+ * ```
+ *
+ * @param GetDeliverySourceCommandInput - {@link GetDeliverySourceCommandInput}
+ * @returns {@link GetDeliverySourceCommandOutput}
+ * @see {@link GetDeliverySourceCommandInput} for command's `input` shape.
+ * @see {@link GetDeliverySourceCommandOutput} for command's `response` shape.
+ * @see {@link CloudWatchLogsClientResolvedConfig | config} for CloudWatchLogsClient's `config` shape.
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>The specified resource does not exist.</p>
+ *
+ * @throws {@link ServiceQuotaExceededException} (client fault)
+ *  <p>This request exceeds a service quota.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The service cannot complete the request.</p>
+ *
+ * @throws {@link ThrottlingException} (client fault)
+ *  <p>The request was throttled because of quota limits.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>One of the parameters for the request is not valid.</p>
+ *
+ * @throws {@link CloudWatchLogsServiceException}
+ * <p>Base exception class for all service exceptions from CloudWatchLogs service.</p>
+ *
+ */
+export declare class GetDeliverySourceCommand extends $Command<GetDeliverySourceCommandInput, GetDeliverySourceCommandOutput, CloudWatchLogsClientResolvedConfig> {
+    readonly input: GetDeliverySourceCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    /**
+     * @public
+     */
+    constructor(input: GetDeliverySourceCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudWatchLogsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<GetDeliverySourceCommandInput, GetDeliverySourceCommandOutput>;
+    /**
+     * @internal
+     */
+    private serialize;
+    /**
+     * @internal
+     */
+    private deserialize;
+}

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

@@ -29,7 +29,8 @@ export interface GetQueryResultsCommandOutput extends GetQueryResultsResponse, _
  *       in a <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogRecord.html">GetLogRecord</a>
  *       operation to get the full log record.</p>
  *          <p>
- *             <code>GetQueryResults</code> does not start running a query. To run a query, use <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartQuery.html">StartQuery</a>.</p>
+ *             <code>GetQueryResults</code> does not start running a query. To run a query, use <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartQuery.html">StartQuery</a>. For more information about how long results of previous queries
+ *       are available, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/cloudwatch_limits_cwl.html">CloudWatch Logs quotas</a>.</p>
  *          <p>If the value of the <code>Status</code> field in the output is <code>Running</code>, this operation
  *       returns only partial results. If you see a value of <code>Scheduled</code> or <code>Running</code> for the status,
  *       you can retry the operation later to see the final results. </p>

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

@@ -0,0 +1,145 @@
+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 { CloudWatchLogsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudWatchLogsClient";
+import { PutDeliveryDestinationRequest, PutDeliveryDestinationResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link PutDeliveryDestinationCommand}.
+ */
+export interface PutDeliveryDestinationCommandInput extends PutDeliveryDestinationRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link PutDeliveryDestinationCommand}.
+ */
+export interface PutDeliveryDestinationCommandOutput extends PutDeliveryDestinationResponse, __MetadataBearer {
+}
+/**
+ * @public
+ * <p>Creates or updates a logical <i>delivery destination</i>. A delivery destination is an Amazon Web Services resource that represents an
+ *        Amazon Web Services service that logs can be sent to. CloudWatch Logs, Amazon S3, and
+ *        Kinesis Data Firehose are supported as logs delivery destinations.</p>
+ *          <p>To configure logs delivery between a supported Amazon Web Services service and a destination, you must do the following:</p>
+ *          <ul>
+ *             <li>
+ *                <p>Create a delivery source, which is a logical object that represents the resource that is actually
+ *          sending the logs. For more
+ *          information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html">PutDeliverySource</a>.</p>
+ *             </li>
+ *             <li>
+ *                <p>Use <code>PutDeliveryDestination</code> to create a <i>delivery destination</i>, which is a logical object that represents the actual
+ *          delivery destination.  </p>
+ *             </li>
+ *             <li>
+ *                <p>If you are delivering logs cross-account, you must use
+ *          <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationolicy.html">PutDeliveryDestinationPolicy</a>
+ *          in the destination account to assign an IAM policy to the
+ *          destination. This policy allows delivery to that destination.
+ *        </p>
+ *             </li>
+ *             <li>
+ *                <p>Use <code>CreateDelivery</code> to create a <i>delivery</i> by pairing exactly
+ *          one delivery source and one delivery destination. For more
+ *          information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html">CreateDelivery</a>.
+ *        </p>
+ *             </li>
+ *          </ul>
+ *          <p>You can configure a single delivery source to send logs to multiple destinations by creating multiple deliveries. You
+ *        can also create multiple deliveries to configure multiple delivery sources to send logs to the same delivery destination.</p>
+ *          <p>Only some Amazon Web Services services support being configured as a delivery source. These services are listed
+ *        as <b>Supported [V2 Permissions]</b> in the table at
+ *        <a href="https://docs.aws.amazon.com/     AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-vended-logs-permissions">Enabling
+ *          logging from Amazon Web Services services.</a>
+ *          </p>
+ *          <p>If you use this operation to update an existing delivery destination, all the current delivery destination parameters are overwritten
+ *        with the new parameter values that you specify.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { CloudWatchLogsClient, PutDeliveryDestinationCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
+ * // const { CloudWatchLogsClient, PutDeliveryDestinationCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
+ * const client = new CloudWatchLogsClient(config);
+ * const input = { // PutDeliveryDestinationRequest
+ *   name: "STRING_VALUE", // required
+ *   outputFormat: "json" || "plain" || "w3c" || "raw" || "parquet",
+ *   deliveryDestinationConfiguration: { // DeliveryDestinationConfiguration
+ *     destinationResourceArn: "STRING_VALUE", // required
+ *   },
+ *   tags: { // Tags
+ *     "<keys>": "STRING_VALUE",
+ *   },
+ * };
+ * const command = new PutDeliveryDestinationCommand(input);
+ * const response = await client.send(command);
+ * // { // PutDeliveryDestinationResponse
+ * //   deliveryDestination: { // DeliveryDestination
+ * //     name: "STRING_VALUE",
+ * //     arn: "STRING_VALUE",
+ * //     deliveryDestinationType: "S3" || "CWL" || "FH",
+ * //     outputFormat: "json" || "plain" || "w3c" || "raw" || "parquet",
+ * //     deliveryDestinationConfiguration: { // DeliveryDestinationConfiguration
+ * //       destinationResourceArn: "STRING_VALUE", // required
+ * //     },
+ * //     tags: { // Tags
+ * //       "<keys>": "STRING_VALUE",
+ * //     },
+ * //   },
+ * // };
+ *
+ * ```
+ *
+ * @param PutDeliveryDestinationCommandInput - {@link PutDeliveryDestinationCommandInput}
+ * @returns {@link PutDeliveryDestinationCommandOutput}
+ * @see {@link PutDeliveryDestinationCommandInput} for command's `input` shape.
+ * @see {@link PutDeliveryDestinationCommandOutput} for command's `response` shape.
+ * @see {@link CloudWatchLogsClientResolvedConfig | config} for CloudWatchLogsClient's `config` shape.
+ *
+ * @throws {@link ConflictException} (client fault)
+ *  <p>This operation attempted to create a resource that already exists.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>The specified resource does not exist.</p>
+ *
+ * @throws {@link ServiceQuotaExceededException} (client fault)
+ *  <p>This request exceeds a service quota.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The service cannot complete the request.</p>
+ *
+ * @throws {@link ThrottlingException} (client fault)
+ *  <p>The request was throttled because of quota limits.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>One of the parameters for the request is not valid.</p>
+ *
+ * @throws {@link CloudWatchLogsServiceException}
+ * <p>Base exception class for all service exceptions from CloudWatchLogs service.</p>
+ *
+ */
+export declare class PutDeliveryDestinationCommand extends $Command<PutDeliveryDestinationCommandInput, PutDeliveryDestinationCommandOutput, CloudWatchLogsClientResolvedConfig> {
+    readonly input: PutDeliveryDestinationCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    /**
+     * @public
+     */
+    constructor(input: PutDeliveryDestinationCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudWatchLogsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<PutDeliveryDestinationCommandInput, PutDeliveryDestinationCommandOutput>;
+    /**
+     * @internal
+     */
+    private serialize;
+    /**
+     * @internal
+     */
+    private deserialize;
+}

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

@@ -0,0 +1,118 @@
+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 { CloudWatchLogsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudWatchLogsClient";
+import { PutDeliveryDestinationPolicyRequest, PutDeliveryDestinationPolicyResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link PutDeliveryDestinationPolicyCommand}.
+ */
+export interface PutDeliveryDestinationPolicyCommandInput extends PutDeliveryDestinationPolicyRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link PutDeliveryDestinationPolicyCommand}.
+ */
+export interface PutDeliveryDestinationPolicyCommandOutput extends PutDeliveryDestinationPolicyResponse, __MetadataBearer {
+}
+/**
+ * @public
+ * <p>Creates and assigns an IAM policy that grants permissions to CloudWatch Logs to deliver
+ *        logs cross-account to a specified destination in this account. To configure the delivery of logs from an
+ *      Amazon Web Services service in another account to a logs delivery destination in the current account, you must do the following:</p>
+ *          <ul>
+ *             <li>
+ *                <p>Create a delivery source, which is a logical object that represents the resource that is actually
+ *          sending the logs. For more
+ *          information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html">PutDeliverySource</a>.</p>
+ *             </li>
+ *             <li>
+ *                <p>Create a <i>delivery destination</i>, which is a logical object that represents the actual
+ *          delivery destination.  For more
+ *          information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html">PutDeliveryDestination</a>.</p>
+ *             </li>
+ *             <li>
+ *                <p>Use this operation in the destination account to assign an IAM policy to the
+ *          destination. This policy allows delivery to that destination.
+ *         </p>
+ *             </li>
+ *             <li>
+ *                <p>Create a <i>delivery</i> by pairing exactly one delivery source and one delivery destination.
+ *          For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html">CreateDelivery</a>.</p>
+ *             </li>
+ *          </ul>
+ *          <p>Only some Amazon Web Services services support being configured as a delivery source. These services are listed
+ *        as <b>Supported [V2 Permissions]</b> in the table at
+ *        <a href="https://docs.aws.amazon.com/     AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-vended-logs-permissions">Enabling
+ *          logging from Amazon Web Services services.</a>
+ *          </p>
+ *          <p>The contents of the policy must include two statements. One statement enables general logs delivery, and the other
+ *     allows delivery to the chosen destination. See the examples for the needed policies.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { CloudWatchLogsClient, PutDeliveryDestinationPolicyCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
+ * // const { CloudWatchLogsClient, PutDeliveryDestinationPolicyCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
+ * const client = new CloudWatchLogsClient(config);
+ * const input = { // PutDeliveryDestinationPolicyRequest
+ *   deliveryDestinationName: "STRING_VALUE", // required
+ *   deliveryDestinationPolicy: "STRING_VALUE", // required
+ * };
+ * const command = new PutDeliveryDestinationPolicyCommand(input);
+ * const response = await client.send(command);
+ * // { // PutDeliveryDestinationPolicyResponse
+ * //   policy: { // Policy
+ * //     deliveryDestinationPolicy: "STRING_VALUE",
+ * //   },
+ * // };
+ *
+ * ```
+ *
+ * @param PutDeliveryDestinationPolicyCommandInput - {@link PutDeliveryDestinationPolicyCommandInput}
+ * @returns {@link PutDeliveryDestinationPolicyCommandOutput}
+ * @see {@link PutDeliveryDestinationPolicyCommandInput} for command's `input` shape.
+ * @see {@link PutDeliveryDestinationPolicyCommandOutput} for command's `response` shape.
+ * @see {@link CloudWatchLogsClientResolvedConfig | config} for CloudWatchLogsClient's `config` shape.
+ *
+ * @throws {@link ConflictException} (client fault)
+ *  <p>This operation attempted to create a resource that already exists.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>The specified resource does not exist.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The service cannot complete the request.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>One of the parameters for the request is not valid.</p>
+ *
+ * @throws {@link CloudWatchLogsServiceException}
+ * <p>Base exception class for all service exceptions from CloudWatchLogs service.</p>
+ *
+ */
+export declare class PutDeliveryDestinationPolicyCommand extends $Command<PutDeliveryDestinationPolicyCommandInput, PutDeliveryDestinationPolicyCommandOutput, CloudWatchLogsClientResolvedConfig> {
+    readonly input: PutDeliveryDestinationPolicyCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    /**
+     * @public
+     */
+    constructor(input: PutDeliveryDestinationPolicyCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudWatchLogsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<PutDeliveryDestinationPolicyCommandInput, PutDeliveryDestinationPolicyCommandOutput>;
+    /**
+     * @internal
+     */
+    private serialize;
+    /**
+     * @internal
+     */
+    private deserialize;
+}

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

@@ -0,0 +1,142 @@
+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 { CloudWatchLogsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudWatchLogsClient";
+import { PutDeliverySourceRequest, PutDeliverySourceResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link PutDeliverySourceCommand}.
+ */
+export interface PutDeliverySourceCommandInput extends PutDeliverySourceRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link PutDeliverySourceCommand}.
+ */
+export interface PutDeliverySourceCommandOutput extends PutDeliverySourceResponse, __MetadataBearer {
+}
+/**
+ * @public
+ * <p>Creates or updates a logical <i>delivery source</i>. A delivery source represents an Amazon Web Services resource that sends logs to an
+ *        logs delivery destination. The destination can be CloudWatch Logs, Amazon S3, or Kinesis Data Firehose.</p>
+ *          <p>To configure logs delivery between a delivery destination and an Amazon Web Services service that is supported as a delivery source, you must do the following:</p>
+ *          <ul>
+ *             <li>
+ *                <p>Use <code>PutDeliverySource</code> to create a delivery source, which is a logical object that represents the resource that is actually
+ *          sending the logs. </p>
+ *             </li>
+ *             <li>
+ *                <p>Use <code>PutDeliveryDestination</code> to create a <i>delivery destination</i>, which is a logical object that represents the actual
+ *          delivery destination. For more
+ *          information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html">PutDeliveryDestination</a>.</p>
+ *             </li>
+ *             <li>
+ *                <p>If you are delivering logs cross-account, you must use
+ *          <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationolicy.html">PutDeliveryDestinationPolicy</a>
+ *          in the destination account to assign an IAM policy to the
+ *          destination. This policy allows delivery to that destination.
+ *        </p>
+ *             </li>
+ *             <li>
+ *                <p>Use <code>CreateDelivery</code> to create a <i>delivery</i> by pairing exactly
+ *          one delivery source and one delivery destination. For more
+ *          information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html">CreateDelivery</a>.
+ *        </p>
+ *             </li>
+ *          </ul>
+ *          <p>You can configure a single delivery source to send logs to multiple destinations by creating multiple deliveries. You
+ *        can also create multiple deliveries to configure multiple delivery sources to send logs to the same delivery destination.</p>
+ *          <p>Only some Amazon Web Services services support being configured as a delivery source. These services are listed
+ *        as <b>Supported [V2 Permissions]</b> in the table at
+ *        <a href="https://docs.aws.amazon.com/     AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-vended-logs-permissions">Enabling
+ *        logging from Amazon Web Services services.</a>
+ *          </p>
+ *          <p>If you use this operation to update an existing delivery source, all the current delivery source parameters are overwritten
+ *      with the new parameter values that you specify.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { CloudWatchLogsClient, PutDeliverySourceCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
+ * // const { CloudWatchLogsClient, PutDeliverySourceCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
+ * const client = new CloudWatchLogsClient(config);
+ * const input = { // PutDeliverySourceRequest
+ *   name: "STRING_VALUE", // required
+ *   resourceArn: "STRING_VALUE", // required
+ *   logType: "STRING_VALUE", // required
+ *   tags: { // Tags
+ *     "<keys>": "STRING_VALUE",
+ *   },
+ * };
+ * const command = new PutDeliverySourceCommand(input);
+ * const response = await client.send(command);
+ * // { // PutDeliverySourceResponse
+ * //   deliverySource: { // DeliverySource
+ * //     name: "STRING_VALUE",
+ * //     arn: "STRING_VALUE",
+ * //     resourceArns: [ // ResourceArns
+ * //       "STRING_VALUE",
+ * //     ],
+ * //     service: "STRING_VALUE",
+ * //     logType: "STRING_VALUE",
+ * //     tags: { // Tags
+ * //       "<keys>": "STRING_VALUE",
+ * //     },
+ * //   },
+ * // };
+ *
+ * ```
+ *
+ * @param PutDeliverySourceCommandInput - {@link PutDeliverySourceCommandInput}
+ * @returns {@link PutDeliverySourceCommandOutput}
+ * @see {@link PutDeliverySourceCommandInput} for command's `input` shape.
+ * @see {@link PutDeliverySourceCommandOutput} for command's `response` shape.
+ * @see {@link CloudWatchLogsClientResolvedConfig | config} for CloudWatchLogsClient's `config` shape.
+ *
+ * @throws {@link ConflictException} (client fault)
+ *  <p>This operation attempted to create a resource that already exists.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>The specified resource does not exist.</p>
+ *
+ * @throws {@link ServiceQuotaExceededException} (client fault)
+ *  <p>This request exceeds a service quota.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>The service cannot complete the request.</p>
+ *
+ * @throws {@link ThrottlingException} (client fault)
+ *  <p>The request was throttled because of quota limits.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>One of the parameters for the request is not valid.</p>
+ *
+ * @throws {@link CloudWatchLogsServiceException}
+ * <p>Base exception class for all service exceptions from CloudWatchLogs service.</p>
+ *
+ */
+export declare class PutDeliverySourceCommand extends $Command<PutDeliverySourceCommandInput, PutDeliverySourceCommandOutput, CloudWatchLogsClientResolvedConfig> {
+    readonly input: PutDeliverySourceCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    /**
+     * @public
+     */
+    constructor(input: PutDeliverySourceCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudWatchLogsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<PutDeliverySourceCommandInput, PutDeliverySourceCommandOutput>;
+    /**
+     * @internal
+     */
+    private serialize;
+    /**
+     * @internal
+     */
+    private deserialize;
+}

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

@@ -1,10 +1,15 @@
 export * from "./AssociateKmsKeyCommand";
 export * from "./CancelExportTaskCommand";
+export * from "./CreateDeliveryCommand";
 export * from "./CreateExportTaskCommand";
 export * from "./CreateLogGroupCommand";
 export * from "./CreateLogStreamCommand";
 export * from "./DeleteAccountPolicyCommand";
 export * from "./DeleteDataProtectionPolicyCommand";
+export * from "./DeleteDeliveryCommand";
+export * from "./DeleteDeliveryDestinationCommand";
+export * from "./DeleteDeliveryDestinationPolicyCommand";
+export * from "./DeleteDeliverySourceCommand";
 export * from "./DeleteDestinationCommand";
 export * from "./DeleteLogGroupCommand";
 export * from "./DeleteLogStreamCommand";
@@ -14,6 +19,9 @@ export * from "./DeleteResourcePolicyCommand";
 export * from "./DeleteRetentionPolicyCommand";
 export * from "./DeleteSubscriptionFilterCommand";
 export * from "./DescribeAccountPoliciesCommand";
+export * from "./DescribeDeliveriesCommand";
+export * from "./DescribeDeliveryDestinationsCommand";
+export * from "./DescribeDeliverySourcesCommand";
 export * from "./DescribeDestinationsCommand";
 export * from "./DescribeExportTasksCommand";
 export * from "./DescribeLogGroupsCommand";
@@ -26,6 +34,10 @@ export * from "./DescribeSubscriptionFiltersCommand";
 export * from "./DisassociateKmsKeyCommand";
 export * from "./FilterLogEventsCommand";
 export * from "./GetDataProtectionPolicyCommand";
+export * from "./GetDeliveryCommand";
+export * from "./GetDeliveryDestinationCommand";
+export * from "./GetDeliveryDestinationPolicyCommand";
+export * from "./GetDeliverySourceCommand";
 export * from "./GetLogEventsCommand";
 export * from "./GetLogGroupFieldsCommand";
 export * from "./GetLogRecordCommand";
@@ -34,6 +46,9 @@ export * from "./ListTagsForResourceCommand";
 export * from "./ListTagsLogGroupCommand";
 export * from "./PutAccountPolicyCommand";
 export * from "./PutDataProtectionPolicyCommand";
+export * from "./PutDeliveryDestinationCommand";
+export * from "./PutDeliveryDestinationPolicyCommand";
+export * from "./PutDeliverySourceCommand";
 export * from "./PutDestinationCommand";
 export * from "./PutDestinationPolicyCommand";
 export * from "./PutLogEventsCommand";

package/dist-types/index.d.ts

@@ -40,6 +40,8 @@
 export * from "./CloudWatchLogsClient";
 export * from "./CloudWatchLogs";
 export { ClientInputEndpointParameters } from "./endpoint/EndpointParameters";
+export { RuntimeExtension } from "./runtimeExtensions";
+export { CloudWatchLogsExtensionConfiguration } from "./extensionConfiguration";
 export * from "./commands";
 export * from "./pagination";
 export * from "./models";