import { Command as $Command } from "@smithy/smithy-client"; import type { MetadataBearer as __MetadataBearer } from "@smithy/types"; import type { GetBucketMetadataConfigurationOutput, GetBucketMetadataConfigurationRequest } from "../models/models_0"; import type { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client"; /** * @public */ export type { __MetadataBearer }; export { $Command }; /** * @public * * The input for {@link GetBucketMetadataConfigurationCommand}. */ export interface GetBucketMetadataConfigurationCommandInput extends GetBucketMetadataConfigurationRequest { } /** * @public * * The output of {@link GetBucketMetadataConfigurationCommand}. */ export interface GetBucketMetadataConfigurationCommandOutput extends GetBucketMetadataConfigurationOutput, __MetadataBearer { } declare const GetBucketMetadataConfigurationCommand_base: { new (input: GetBucketMetadataConfigurationCommandInput): import("@smithy/smithy-client").CommandImpl; new (input: GetBucketMetadataConfigurationCommandInput): import("@smithy/smithy-client").CommandImpl; getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions; }; /** *

Retrieves the S3 Metadata configuration for a general purpose bucket. For more information, see * Accelerating * data discovery with S3 Metadata in the Amazon S3 User Guide.

* *

You can use the V2 GetBucketMetadataConfiguration API operation with V1 or V2 * metadata configurations. However, if you try to use the V1 * GetBucketMetadataTableConfiguration API operation with V2 configurations, you * will receive an HTTP 405 Method Not Allowed error.

*
*
*
Permissions
*
*

To use this operation, you must have the s3:GetBucketMetadataTableConfiguration * permission. For more information, see Setting up permissions for * configuring metadata tables in the Amazon S3 User Guide.

* *

The IAM policy action name is the same for the V1 and V2 API operations.

*
*
*
*

The following operations are related to GetBucketMetadataConfiguration:

* * *

You must URL encode any signed header values that contain spaces. For example, if your header value is my file.txt, containing two spaces after my, you must URL encode this value to my%20%20file.txt.

*
* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { S3Client, GetBucketMetadataConfigurationCommand } from "@aws-sdk/client-s3"; // ES Modules import * // const { S3Client, GetBucketMetadataConfigurationCommand } = require("@aws-sdk/client-s3"); // CommonJS import * // import type { S3ClientConfig } from "@aws-sdk/client-s3"; * const config = {}; // type is S3ClientConfig * const client = new S3Client(config); * const input = { // GetBucketMetadataConfigurationRequest * Bucket: "STRING_VALUE", // required * ExpectedBucketOwner: "STRING_VALUE", * }; * const command = new GetBucketMetadataConfigurationCommand(input); * const response = await client.send(command); * // { // GetBucketMetadataConfigurationOutput * // GetBucketMetadataConfigurationResult: { // GetBucketMetadataConfigurationResult * // MetadataConfigurationResult: { // MetadataConfigurationResult * // DestinationResult: { // DestinationResult * // TableBucketType: "aws" || "customer", * // TableBucketArn: "STRING_VALUE", * // TableNamespace: "STRING_VALUE", * // }, * // JournalTableConfigurationResult: { // JournalTableConfigurationResult * // TableStatus: "STRING_VALUE", // required * // Error: { // ErrorDetails * // ErrorCode: "STRING_VALUE", * // ErrorMessage: "STRING_VALUE", * // }, * // TableName: "STRING_VALUE", // required * // TableArn: "STRING_VALUE", * // RecordExpiration: { // RecordExpiration * // Expiration: "ENABLED" || "DISABLED", // required * // Days: Number("int"), * // }, * // }, * // InventoryTableConfigurationResult: { // InventoryTableConfigurationResult * // ConfigurationState: "ENABLED" || "DISABLED", // required * // TableStatus: "STRING_VALUE", * // Error: { * // ErrorCode: "STRING_VALUE", * // ErrorMessage: "STRING_VALUE", * // }, * // TableName: "STRING_VALUE", * // TableArn: "STRING_VALUE", * // }, * // }, * // }, * // }; * * ``` * * @param GetBucketMetadataConfigurationCommandInput - {@link GetBucketMetadataConfigurationCommandInput} * @returns {@link GetBucketMetadataConfigurationCommandOutput} * @see {@link GetBucketMetadataConfigurationCommandInput} for command's `input` shape. * @see {@link GetBucketMetadataConfigurationCommandOutput} for command's `response` shape. * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape. * * @throws {@link S3ServiceException} *

Base exception class for all service exceptions from S3 service.

* * * @public */ export declare class GetBucketMetadataConfigurationCommand extends GetBucketMetadataConfigurationCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: GetBucketMetadataConfigurationRequest; output: GetBucketMetadataConfigurationOutput; }; sdk: { input: GetBucketMetadataConfigurationCommandInput; output: GetBucketMetadataConfigurationCommandOutput; }; }; }