import { Command as $Command } from "@smithy/core/client"; import type { MetadataBearer as __MetadataBearer } from "@smithy/types"; import type { IoTClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../IoTClient"; import type { CreateDimensionRequest, CreateDimensionResponse } from "../models/models_0"; /** * @public */ export type { __MetadataBearer }; export { $Command }; /** * @public * * The input for {@link CreateDimensionCommand}. */ export interface CreateDimensionCommandInput extends CreateDimensionRequest { } /** * @public * * The output of {@link CreateDimensionCommand}. */ export interface CreateDimensionCommandOutput extends CreateDimensionResponse, __MetadataBearer { } declare const CreateDimensionCommand_base: { new (input: CreateDimensionCommandInput): import("@smithy/core/client").CommandImpl; new (input: CreateDimensionCommandInput): import("@smithy/core/client").CommandImpl; getEndpointParameterInstructions(): { [x: string]: unknown; }; }; /** *

Create a dimension that you can use to limit the scope of a metric used in a security profile for IoT Device Defender. * For example, using a TOPIC_FILTER dimension, you can narrow down the scope of the metric only to MQTT topics whose name match the pattern specified in the dimension.

*

Requires permission to access the CreateDimension action.

* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { IoTClient, CreateDimensionCommand } from "@aws-sdk/client-iot"; // ES Modules import * // const { IoTClient, CreateDimensionCommand } = require("@aws-sdk/client-iot"); // CommonJS import * // import type { IoTClientConfig } from "@aws-sdk/client-iot"; * const config = {}; // type is IoTClientConfig * const client = new IoTClient(config); * const input = { // CreateDimensionRequest * name: "STRING_VALUE", // required * type: "TOPIC_FILTER", // required * stringValues: [ // DimensionStringValues // required * "STRING_VALUE", * ], * tags: [ // TagList * { // Tag * Key: "STRING_VALUE", // required * Value: "STRING_VALUE", * }, * ], * clientRequestToken: "STRING_VALUE", // required * }; * const command = new CreateDimensionCommand(input); * const response = await client.send(command); * // { // CreateDimensionResponse * // name: "STRING_VALUE", * // arn: "STRING_VALUE", * // }; * * ``` * * @param CreateDimensionCommandInput - {@link CreateDimensionCommandInput} * @returns {@link CreateDimensionCommandOutput} * @see {@link CreateDimensionCommandInput} for command's `input` shape. * @see {@link CreateDimensionCommandOutput} for command's `response` shape. * @see {@link IoTClientResolvedConfig | config} for IoTClient's `config` shape. * * @throws {@link InternalFailureException} (server fault) *

An unexpected error has occurred.

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

The request is not valid.

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

A limit has been exceeded.

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

The resource already exists.

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

The rate exceeds the limit.

* * @throws {@link IoTServiceException} *

Base exception class for all service exceptions from IoT service.

* * * @public */ export declare class CreateDimensionCommand extends CreateDimensionCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: CreateDimensionRequest; output: CreateDimensionResponse; }; sdk: { input: CreateDimensionCommandInput; output: CreateDimensionCommandOutput; }; }; }