import { Command as $Command } from "@smithy/smithy-client"; import type { MetadataBearer as __MetadataBearer } from "@smithy/types"; import type { CreateQueueRequest, CreateQueueResult } from "../models/models_0"; import type { ServiceInputTypes, ServiceOutputTypes, SQSClientResolvedConfig } from "../SQSClient"; /** * @public */ export type { __MetadataBearer }; export { $Command }; /** * @public * * The input for {@link CreateQueueCommand}. */ export interface CreateQueueCommandInput extends CreateQueueRequest { } /** * @public * * The output of {@link CreateQueueCommand}. */ export interface CreateQueueCommandOutput extends CreateQueueResult, __MetadataBearer { } declare const CreateQueueCommand_base: { new (input: CreateQueueCommandInput): import("@smithy/smithy-client").CommandImpl; new (input: CreateQueueCommandInput): import("@smithy/smithy-client").CommandImpl; getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions; }; /** *

Creates a new standard or FIFO queue. You can pass one or more attributes in * the request. Keep the following in mind:

* *

To successfully create a new queue, you must provide a queue name that adheres to the * limits * related to queues and is unique within the scope of your queues.

* *

After you create a queue, you must wait at least one second after the queue is * created to be able to use the queue.

*
*

To retrieve the URL of a queue, use the * GetQueueUrl * action. This action only requires the * QueueName * parameter.

*

When creating queues, keep the following points in mind:

* * *

Cross-account permissions don't apply to this action. For more information, * see Grant * cross-account permissions to a role and a username in the Amazon SQS Developer Guide.

*
* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { SQSClient, CreateQueueCommand } from "@aws-sdk/client-sqs"; // ES Modules import * // const { SQSClient, CreateQueueCommand } = require("@aws-sdk/client-sqs"); // CommonJS import * // import type { SQSClientConfig } from "@aws-sdk/client-sqs"; * const config = {}; // type is SQSClientConfig * const client = new SQSClient(config); * const input = { // CreateQueueRequest * QueueName: "STRING_VALUE", // required * Attributes: { // QueueAttributeMap * "": "STRING_VALUE", * }, * tags: { // TagMap * "": "STRING_VALUE", * }, * }; * const command = new CreateQueueCommand(input); * const response = await client.send(command); * // { // CreateQueueResult * // QueueUrl: "STRING_VALUE", * // }; * * ``` * * @param CreateQueueCommandInput - {@link CreateQueueCommandInput} * @returns {@link CreateQueueCommandOutput} * @see {@link CreateQueueCommandInput} for command's `input` shape. * @see {@link CreateQueueCommandOutput} for command's `response` shape. * @see {@link SQSClientResolvedConfig | config} for SQSClient's `config` shape. * * @throws {@link InvalidAddress} (client fault) *

The specified ID is invalid.

* * @throws {@link InvalidAttributeName} (client fault) *

The specified attribute doesn't exist.

* * @throws {@link InvalidAttributeValue} (client fault) *

A queue attribute value is invalid.

* * @throws {@link InvalidSecurity} (client fault) *

The request was not made over HTTPS or did not use SigV4 for signing.

* * @throws {@link QueueDeletedRecently} (client fault) *

You must wait 60 seconds after deleting a queue before you can create another queue * with the same name.

* * @throws {@link QueueNameExists} (client fault) *

A queue with this name already exists. Amazon SQS returns this error only if the request * includes attributes whose values differ from those of the existing queue.

* * @throws {@link RequestThrottled} (client fault) *

The request was denied due to request throttling.

*
    *
  • *

    Exceeds the permitted request rate for the queue or for the recipient of the * request.

    *
  • *
  • *

    Ensure that the request rate is within the Amazon SQS limits for * sending messages. For more information, see Amazon SQS quotas in the Amazon SQS * Developer Guide.

    *
  • *
* * @throws {@link UnsupportedOperation} (client fault) *

Error code 400. Unsupported operation.

* * @throws {@link SQSServiceException} *

Base exception class for all service exceptions from SQS service.

* * * @public */ export declare class CreateQueueCommand extends CreateQueueCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: CreateQueueRequest; output: CreateQueueResult; }; sdk: { input: CreateQueueCommandInput; output: CreateQueueCommandOutput; }; }; }