@aws-sdk/client-ssm
Version:
AWS SDK for JavaScript Ssm Client for Node.js, Browser and React Native
117 lines (116 loc) • 5.38 kB
TypeScript
import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
import type { GetParametersRequest, GetParametersResult } from "../models/models_0";
/**
* @public
*/
export type { __MetadataBearer };
/**
* @public
*
* The input for {@link GetParametersCommand}.
*/
export interface GetParametersCommandInput extends GetParametersRequest {
}
/**
* @public
*
* The output of {@link GetParametersCommand}.
*/
export interface GetParametersCommandOutput extends GetParametersResult, __MetadataBearer {
}
declare const GetParametersCommand_base: {
new (input: GetParametersCommandInput): import("@smithy/core/client").CommandImpl<GetParametersCommandInput, GetParametersCommandOutput, import("..").SSMClientResolvedConfig, import("..").ServiceInputTypes, import("..").ServiceOutputTypes>;
new (input: GetParametersCommandInput): import("@smithy/core/client").CommandImpl<GetParametersCommandInput, GetParametersCommandOutput, import("..").SSMClientResolvedConfig, import("..").ServiceInputTypes, import("..").ServiceOutputTypes>;
getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
};
/**
* <p>Get information about one or more parameters by specifying multiple parameter names.</p>
* <note>
* <p>To get information about a single parameter, you can use the <a>GetParameter</a>
* operation instead.</p>
* </note>
* <p>Parameter names can't contain spaces. The service removes any spaces specified for the
* beginning or end of a parameter name. If the specified name for a parameter contains spaces
* between characters, the request fails with a <code>ValidationException</code> error.</p>
* <note>
* <p>Parameter Store throughput defines the number of API transactions per second (TPS) that
* Systems Manager can process. This applies to <code>GetParameter</code>,
* <code>GetParameters</code>, and <code>PutParameter</code> API calls for your Amazon Web Services account and
* Amazon Web Services Region. By default, Parameter Store is configured with a standard throughput quota suitable
* for low- to moderate-volume workloads. Applications that retrieve configuration data infrequently
* or operate at smaller scale can use this default setting without additional cost.</p>
* <p>For higher-volume workloads, you can enable higher throughput. This increases the maximum
* number of supported transactions per second for your account and Region. Increased throughput
* supports applications and workloads that need concurrent access to multiple parameters. If you
* experience <code>ThrottlingException: Rate exceeded</code> errors, enable higher throughput. For
* more information, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-throughput.html">Changing Parameter Store
* throughput</a>.</p>
* </note>
* @example
* Use a bare-bones client and the command you need to make an API call.
* ```javascript
* import { SSMClient, GetParametersCommand } from "@aws-sdk/client-ssm"; // ES Modules import
* // const { SSMClient, GetParametersCommand } = require("@aws-sdk/client-ssm"); // CommonJS import
* // import type { SSMClientConfig } from "@aws-sdk/client-ssm";
* const config = {}; // type is SSMClientConfig
* const client = new SSMClient(config);
* const input = { // GetParametersRequest
* Names: [ // ParameterNameList // required
* "STRING_VALUE",
* ],
* WithDecryption: true || false,
* };
* const command = new GetParametersCommand(input);
* const response = await client.send(command);
* // { // GetParametersResult
* // Parameters: [ // ParameterList
* // { // Parameter
* // Name: "STRING_VALUE",
* // Type: "String" || "StringList" || "SecureString",
* // Value: "STRING_VALUE",
* // Version: Number("long"),
* // Selector: "STRING_VALUE",
* // SourceResult: "STRING_VALUE",
* // LastModifiedDate: new Date("TIMESTAMP"),
* // ARN: "STRING_VALUE",
* // DataType: "STRING_VALUE",
* // },
* // ],
* // InvalidParameters: [ // ParameterNameList
* // "STRING_VALUE",
* // ],
* // };
*
* ```
*
* @param GetParametersCommandInput - {@link GetParametersCommandInput}
* @returns {@link GetParametersCommandOutput}
* @see {@link GetParametersCommandInput} for command's `input` shape.
* @see {@link GetParametersCommandOutput} for command's `response` shape.
* @see {@link SSMClientResolvedConfig | config} for SSMClient's `config` shape.
*
* @throws {@link InternalServerError} (server fault)
* <p>An error occurred on the server side.</p>
*
* @throws {@link InvalidKeyId} (client fault)
* <p>The query key ID isn't valid.</p>
*
* @throws {@link SSMServiceException}
* <p>Base exception class for all service exceptions from SSM service.</p>
*
*
* @public
*/
export declare class GetParametersCommand extends GetParametersCommand_base {
/** @internal type navigation helper, not in runtime. */
protected static __types: {
api: {
input: GetParametersRequest;
output: GetParametersResult;
};
sdk: {
input: GetParametersCommandInput;
output: GetParametersCommandOutput;
};
};
}