@aws-sdk/client-sustainability 3.1021.0

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

@@ -0,0 +1,198 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import type { GetEstimatedCarbonEmissionsRequest, GetEstimatedCarbonEmissionsResponse } from "../models/models_0";
+import type { ServiceInputTypes, ServiceOutputTypes, SustainabilityClientResolvedConfig } from "../SustainabilityClient";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link GetEstimatedCarbonEmissionsCommand}.
+ */
+export interface GetEstimatedCarbonEmissionsCommandInput extends GetEstimatedCarbonEmissionsRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link GetEstimatedCarbonEmissionsCommand}.
+ */
+export interface GetEstimatedCarbonEmissionsCommandOutput extends GetEstimatedCarbonEmissionsResponse, __MetadataBearer {
+}
+declare const GetEstimatedCarbonEmissionsCommand_base: {
+    new (input: GetEstimatedCarbonEmissionsCommandInput): import("@smithy/smithy-client").CommandImpl<GetEstimatedCarbonEmissionsCommandInput, GetEstimatedCarbonEmissionsCommandOutput, SustainabilityClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (input: GetEstimatedCarbonEmissionsCommandInput): import("@smithy/smithy-client").CommandImpl<GetEstimatedCarbonEmissionsCommandInput, GetEstimatedCarbonEmissionsCommandOutput, SustainabilityClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>Returns estimated carbon emission values based on customer grouping and filtering parameters. We recommend using pagination to ensure that the operation returns quickly and successfully. </p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { SustainabilityClient, GetEstimatedCarbonEmissionsCommand } from "@aws-sdk/client-sustainability"; // ES Modules import
+ * // const { SustainabilityClient, GetEstimatedCarbonEmissionsCommand } = require("@aws-sdk/client-sustainability"); // CommonJS import
+ * // import type { SustainabilityClientConfig } from "@aws-sdk/client-sustainability";
+ * const config = {}; // type is SustainabilityClientConfig
+ * const client = new SustainabilityClient(config);
+ * const input = { // GetEstimatedCarbonEmissionsRequest
+ *   TimePeriod: { // TimePeriod
+ *     Start: new Date("TIMESTAMP"), // required
+ *     End: new Date("TIMESTAMP"), // required
+ *   },
+ *   GroupBy: [ // DimensionList
+ *     "USAGE_ACCOUNT_ID" || "REGION" || "SERVICE",
+ *   ],
+ *   FilterBy: { // FilterExpression
+ *     Dimensions: { // DimensionListMap
+ *       "<keys>": [ // DimensionValueList
+ *         "STRING_VALUE",
+ *       ],
+ *     },
+ *   },
+ *   EmissionsTypes: [ // EmissionsTypeList
+ *     "TOTAL_LBM_CARBON_EMISSIONS" || "TOTAL_MBM_CARBON_EMISSIONS" || "TOTAL_SCOPE_1_CARBON_EMISSIONS" || "TOTAL_SCOPE_2_LBM_CARBON_EMISSIONS" || "TOTAL_SCOPE_2_MBM_CARBON_EMISSIONS" || "TOTAL_SCOPE_3_LBM_CARBON_EMISSIONS" || "TOTAL_SCOPE_3_MBM_CARBON_EMISSIONS",
+ *   ],
+ *   Granularity: "YEARLY_CALENDAR" || "YEARLY_FISCAL" || "QUARTERLY_CALENDAR" || "QUARTERLY_FISCAL" || "MONTHLY",
+ *   GranularityConfiguration: { // GranularityConfiguration
+ *     FiscalYearStartMonth: Number("int"),
+ *   },
+ *   MaxResults: Number("int"),
+ *   NextToken: "STRING_VALUE",
+ * };
+ * const command = new GetEstimatedCarbonEmissionsCommand(input);
+ * const response = await client.send(command);
+ * // { // GetEstimatedCarbonEmissionsResponse
+ * //   Results: [ // EstimatedCarbonEmissionsList // required
+ * //     { // EstimatedCarbonEmissions
+ * //       TimePeriod: { // TimePeriod
+ * //         Start: new Date("TIMESTAMP"), // required
+ * //         End: new Date("TIMESTAMP"), // required
+ * //       },
+ * //       DimensionsValues: { // DimensionsMap // required
+ * //         "<keys>": "STRING_VALUE",
+ * //       },
+ * //       ModelVersion: "STRING_VALUE", // required
+ * //       EmissionsValues: { // EmissionsMap // required
+ * //         "<keys>": { // Emissions
+ * //           Value: Number("double"), // required
+ * //           Unit: "MTCO2e", // required
+ * //         },
+ * //       },
+ * //     },
+ * //   ],
+ * //   NextToken: "STRING_VALUE",
+ * // };
+ *
+ * ```
+ *
+ * @param GetEstimatedCarbonEmissionsCommandInput - {@link GetEstimatedCarbonEmissionsCommandInput}
+ * @returns {@link GetEstimatedCarbonEmissionsCommandOutput}
+ * @see {@link GetEstimatedCarbonEmissionsCommandInput} for command's `input` shape.
+ * @see {@link GetEstimatedCarbonEmissionsCommandOutput} for command's `response` shape.
+ * @see {@link SustainabilityClientResolvedConfig | config} for SustainabilityClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You do not have sufficient access to perform this action.</p>
+ *
+ * @throws {@link InternalServerException} (server fault)
+ *  <p>The request processing has failed because of an unknown error, exception, or failure.</p>
+ *
+ * @throws {@link ThrottlingException} (client fault)
+ *  <p>The request was denied due to request throttling.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ *
+ * @throws {@link SustainabilityServiceException}
+ * <p>Base exception class for all service exceptions from Sustainability service.</p>
+ *
+ *
+ * @example GetEstimatedCarbonEmissionsSuccess
+ * ```javascript
+ * //
+ * const input = {
+ *   EmissionsTypes: [
+ *     "TOTAL_LBM_CARBON_EMISSIONS",
+ *     "TOTAL_MBM_CARBON_EMISSIONS",
+ *     "TOTAL_SCOPE_1_CARBON_EMISSIONS",
+ *     "TOTAL_SCOPE_2_LBM_CARBON_EMISSIONS",
+ *     "TOTAL_SCOPE_2_MBM_CARBON_EMISSIONS",
+ *     "TOTAL_SCOPE_3_LBM_CARBON_EMISSIONS",
+ *     "TOTAL_SCOPE_3_MBM_CARBON_EMISSIONS"
+ *   ],
+ *   Granularity: "MONTHLY",
+ *   GroupBy: [
+ *     "SERVICE"
+ *   ],
+ *   TimePeriod: {
+ *     End: "2025-12-31T23:59:59.999Z",
+ *     Start: "2025-01-01T00:00:00.000Z"
+ *   }
+ * };
+ * const command = new GetEstimatedCarbonEmissionsCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   Results: [
+ *     {
+ *       DimensionsValues: {
+ *         SERVICE: "AmazonEC2"
+ *       },
+ *       EmissionsValues: {
+ *         TOTAL_LBM_CARBON_EMISSIONS: {
+ *           Unit: "MTCO2e",
+ *           Value: 1
+ *         },
+ *         TOTAL_MBM_CARBON_EMISSIONS: {
+ *           Unit: "MTCO2e",
+ *           Value: 1
+ *         },
+ *         TOTAL_SCOPE_1_CARBON_EMISSIONS: {
+ *           Unit: "MTCO2e",
+ *           Value: 1
+ *         },
+ *         TOTAL_SCOPE_2_LBM_CARBON_EMISSIONS: {
+ *           Unit: "MTCO2e",
+ *           Value: 1
+ *         },
+ *         TOTAL_SCOPE_2_MBM_CARBON_EMISSIONS: {
+ *           Unit: "MTCO2e",
+ *           Value: 1
+ *         },
+ *         TOTAL_SCOPE_3_LBM_CARBON_EMISSIONS: {
+ *           Unit: "MTCO2e",
+ *           Value: 1
+ *         },
+ *         TOTAL_SCOPE_3_MBM_CARBON_EMISSIONS: {
+ *           Unit: "MTCO2e",
+ *           Value: 1
+ *         }
+ *       },
+ *       ModelVersion: "v3.0.0",
+ *       TimePeriod: {
+ *         End: "2025-02-01T00:00:00Z",
+ *         Start: "2025-01-01T00:00:00Z"
+ *       }
+ *     }
+ *   ]
+ * }
+ * *\/
+ * ```
+ *
+ * @public
+ */
+export declare class GetEstimatedCarbonEmissionsCommand extends GetEstimatedCarbonEmissionsCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: GetEstimatedCarbonEmissionsRequest;
+            output: GetEstimatedCarbonEmissionsResponse;
+        };
+        sdk: {
+            input: GetEstimatedCarbonEmissionsCommandInput;
+            output: GetEstimatedCarbonEmissionsCommandOutput;
+        };
+    };
+}

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

@@ -0,0 +1,152 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import type { GetEstimatedCarbonEmissionsDimensionValuesRequest, GetEstimatedCarbonEmissionsDimensionValuesResponse } from "../models/models_0";
+import type { ServiceInputTypes, ServiceOutputTypes, SustainabilityClientResolvedConfig } from "../SustainabilityClient";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link GetEstimatedCarbonEmissionsDimensionValuesCommand}.
+ */
+export interface GetEstimatedCarbonEmissionsDimensionValuesCommandInput extends GetEstimatedCarbonEmissionsDimensionValuesRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link GetEstimatedCarbonEmissionsDimensionValuesCommand}.
+ */
+export interface GetEstimatedCarbonEmissionsDimensionValuesCommandOutput extends GetEstimatedCarbonEmissionsDimensionValuesResponse, __MetadataBearer {
+}
+declare const GetEstimatedCarbonEmissionsDimensionValuesCommand_base: {
+    new (input: GetEstimatedCarbonEmissionsDimensionValuesCommandInput): import("@smithy/smithy-client").CommandImpl<GetEstimatedCarbonEmissionsDimensionValuesCommandInput, GetEstimatedCarbonEmissionsDimensionValuesCommandOutput, SustainabilityClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (input: GetEstimatedCarbonEmissionsDimensionValuesCommandInput): import("@smithy/smithy-client").CommandImpl<GetEstimatedCarbonEmissionsDimensionValuesCommandInput, GetEstimatedCarbonEmissionsDimensionValuesCommandOutput, SustainabilityClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>Returns the possible dimension values available for a customer's account. We recommend using pagination to ensure that the operation returns quickly and successfully. </p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { SustainabilityClient, GetEstimatedCarbonEmissionsDimensionValuesCommand } from "@aws-sdk/client-sustainability"; // ES Modules import
+ * // const { SustainabilityClient, GetEstimatedCarbonEmissionsDimensionValuesCommand } = require("@aws-sdk/client-sustainability"); // CommonJS import
+ * // import type { SustainabilityClientConfig } from "@aws-sdk/client-sustainability";
+ * const config = {}; // type is SustainabilityClientConfig
+ * const client = new SustainabilityClient(config);
+ * const input = { // GetEstimatedCarbonEmissionsDimensionValuesRequest
+ *   TimePeriod: { // TimePeriod
+ *     Start: new Date("TIMESTAMP"), // required
+ *     End: new Date("TIMESTAMP"), // required
+ *   },
+ *   Dimensions: [ // DimensionList // required
+ *     "USAGE_ACCOUNT_ID" || "REGION" || "SERVICE",
+ *   ],
+ *   MaxResults: Number("int"),
+ *   NextToken: "STRING_VALUE",
+ * };
+ * const command = new GetEstimatedCarbonEmissionsDimensionValuesCommand(input);
+ * const response = await client.send(command);
+ * // { // GetEstimatedCarbonEmissionsDimensionValuesResponse
+ * //   Results: [ // DimensionEntryList
+ * //     { // DimensionEntry
+ * //       Dimension: "USAGE_ACCOUNT_ID" || "REGION" || "SERVICE", // required
+ * //       Value: "STRING_VALUE", // required
+ * //     },
+ * //   ],
+ * //   NextToken: "STRING_VALUE",
+ * // };
+ *
+ * ```
+ *
+ * @param GetEstimatedCarbonEmissionsDimensionValuesCommandInput - {@link GetEstimatedCarbonEmissionsDimensionValuesCommandInput}
+ * @returns {@link GetEstimatedCarbonEmissionsDimensionValuesCommandOutput}
+ * @see {@link GetEstimatedCarbonEmissionsDimensionValuesCommandInput} for command's `input` shape.
+ * @see {@link GetEstimatedCarbonEmissionsDimensionValuesCommandOutput} for command's `response` shape.
+ * @see {@link SustainabilityClientResolvedConfig | config} for SustainabilityClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You do not have sufficient access to perform this action.</p>
+ *
+ * @throws {@link InternalServerException} (server fault)
+ *  <p>The request processing has failed because of an unknown error, exception, or failure.</p>
+ *
+ * @throws {@link ThrottlingException} (client fault)
+ *  <p>The request was denied due to request throttling.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ *
+ * @throws {@link SustainabilityServiceException}
+ * <p>Base exception class for all service exceptions from Sustainability service.</p>
+ *
+ *
+ * @example GetEstimatedCarbonEmissionsDimensionValuesSuccess
+ * ```javascript
+ * //
+ * const input = {
+ *   Dimensions: [
+ *     "REGION",
+ *     "SERVICE",
+ *     "USAGE_ACCOUNT_ID"
+ *   ],
+ *   TimePeriod: {
+ *     End: "2025-12-31T23:59:59.999Z",
+ *     Start: "2025-01-01T00:00:00.000Z"
+ *   }
+ * };
+ * const command = new GetEstimatedCarbonEmissionsDimensionValuesCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   Results: [
+ *     {
+ *       Dimension: "SERVICE",
+ *       Value: "AmazonEC2"
+ *     },
+ *     {
+ *       Dimension: "SERVICE",
+ *       Value: "AmazonS3"
+ *     },
+ *     {
+ *       Dimension: "SERVICE",
+ *       Value: "AmazonCloudFront"
+ *     },
+ *     {
+ *       Dimension: "REGION",
+ *       Value: "global"
+ *     },
+ *     {
+ *       Dimension: "REGION",
+ *       Value: "us-east-1"
+ *     },
+ *     {
+ *       Dimension: "REGION",
+ *       Value: "us-west-2"
+ *     },
+ *     {
+ *       Dimension: "USAGE_ACCOUNT_ID",
+ *       Value: "111222333444"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * ```
+ *
+ * @public
+ */
+export declare class GetEstimatedCarbonEmissionsDimensionValuesCommand extends GetEstimatedCarbonEmissionsDimensionValuesCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: GetEstimatedCarbonEmissionsDimensionValuesRequest;
+            output: GetEstimatedCarbonEmissionsDimensionValuesResponse;
+        };
+        sdk: {
+            input: GetEstimatedCarbonEmissionsDimensionValuesCommandInput;
+            output: GetEstimatedCarbonEmissionsDimensionValuesCommandOutput;
+        };
+    };
+}

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

@@ -0,0 +1,2 @@
+export * from "./GetEstimatedCarbonEmissionsCommand";
+export * from "./GetEstimatedCarbonEmissionsDimensionValuesCommand";

package/dist-types/endpoint/EndpointParameters.d.ts

@@ -0,0 +1,44 @@
+import type { Endpoint, EndpointParameters as __EndpointParameters, EndpointV2, Provider } from "@smithy/types";
+/**
+ * @public
+ */
+export interface ClientInputEndpointParameters {
+    useFipsEndpoint?: boolean | undefined | Provider<boolean | undefined>;
+    endpoint?: string | Provider<string> | Endpoint | Provider<Endpoint> | EndpointV2 | Provider<EndpointV2>;
+    region?: string | undefined | Provider<string | undefined>;
+}
+/**
+ * @public
+ */
+export type ClientResolvedEndpointParameters = Omit<ClientInputEndpointParameters, "endpoint"> & {
+    defaultSigningName: string;
+};
+/**
+ * @internal
+ */
+export declare const resolveClientEndpointParameters: <T>(options: T & ClientInputEndpointParameters) => T & ClientResolvedEndpointParameters;
+/**
+ * @internal
+ */
+export declare const commonParams: {
+    readonly UseFIPS: {
+        readonly type: "builtInParams";
+        readonly name: "useFipsEndpoint";
+    };
+    readonly Endpoint: {
+        readonly type: "builtInParams";
+        readonly name: "endpoint";
+    };
+    readonly Region: {
+        readonly type: "builtInParams";
+        readonly name: "region";
+    };
+};
+/**
+ * @internal
+ */
+export interface EndpointParameters extends __EndpointParameters {
+    UseFIPS?: boolean | undefined;
+    Endpoint?: string | undefined;
+    Region?: string | undefined;
+}

package/dist-types/endpoint/endpointResolver.d.ts

@@ -0,0 +1,8 @@
+import type { EndpointV2, Logger } from "@smithy/types";
+import type { EndpointParameters } from "./EndpointParameters";
+/**
+ * @internal
+ */
+export declare const defaultEndpointResolver: (endpointParams: EndpointParameters, context?: {
+    logger?: Logger;
+}) => EndpointV2;

package/dist-types/endpoint/ruleset.d.ts

@@ -0,0 +1,2 @@
+import { RuleSetObject } from "@smithy/types";
+export declare const ruleSet: RuleSetObject;

package/dist-types/extensionConfiguration.d.ts

@@ -0,0 +1,9 @@
+import type { AwsRegionExtensionConfiguration } from "@aws-sdk/types";
+import type { HttpHandlerExtensionConfiguration } from "@smithy/protocol-http";
+import type { DefaultExtensionConfiguration } from "@smithy/types";
+import type { HttpAuthExtensionConfiguration } from "./auth/httpAuthExtensionConfiguration";
+/**
+ * @internal
+ */
+export interface SustainabilityExtensionConfiguration extends HttpHandlerExtensionConfiguration, DefaultExtensionConfiguration, AwsRegionExtensionConfiguration, HttpAuthExtensionConfiguration {
+}

package/dist-types/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * <p>The AWS Sustainability service provides programmatic access to estimated carbon emissions data for your Amazon Web Services usage. Use the AWS Sustainability service to retrieve, analyze, and track the carbon footprint of your cloud infrastructure over time. </p> <p>With the AWS Sustainability service, you can:</p> <ul> <li> <p>Retrieve estimated carbon emissions for your Amazon Web Services usage across different time periods </p> </li> <li> <p>Group emissions data by dimensions such as account, region, and service</p> </li> <li> <p>Filter emissions data to focus on specific accounts, regions, or services</p> </li> <li> <p>Access multiple emissions calculation methodologies including Location-based Method (LBM) and Market-based Method (MBM) </p> </li> <li> <p>Aggregate emissions data at various time granularities including monthly, quarterly, and yearly periods </p> </li> </ul> <p> The API supports pagination for efficient data retrieval and provides dimension values to help you understand the available grouping and filtering options for your account. </p> <p> All emissions values are calculated using methodologies aligned with the Greenhouse Gas (GHG) Protocol and are provided in metric tons of carbon dioxide-equivalent (MTCO2e). </p>
+ *
+ * @packageDocumentation
+ */
+export * from "./SustainabilityClient";
+export * from "./Sustainability";
+export type { ClientInputEndpointParameters } from "./endpoint/EndpointParameters";
+export type { RuntimeExtension } from "./runtimeExtensions";
+export type { SustainabilityExtensionConfiguration } from "./extensionConfiguration";
+export * from "./commands";
+export * from "./schemas/schemas_0";
+export * from "./pagination";
+export * from "./models/enums";
+export * from "./models/errors";
+export * from "./models/models_0";
+export { SustainabilityServiceException } from "./models/SustainabilityServiceException";

package/dist-types/models/SustainabilityServiceException.d.ts

@@ -0,0 +1,14 @@
+import { type ServiceExceptionOptions as __ServiceExceptionOptions, ServiceException as __ServiceException } from "@smithy/smithy-client";
+export type { __ServiceExceptionOptions };
+export { __ServiceException };
+/**
+ * @public
+ *
+ * Base exception class for all service exceptions from Sustainability service.
+ */
+export declare class SustainabilityServiceException extends __ServiceException {
+    /**
+     * @internal
+     */
+    constructor(options: __ServiceExceptionOptions);
+}

package/dist-types/models/enums.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @public
+ * @enum
+ */
+export declare const EmissionsType: {
+    /**
+     * <p>Total direct, indirect, and value chain emissions, calculated using GHG Protocol's Location-based method (LBM).</p>
+     */
+    readonly TOTAL_LBM_CARBON_EMISSIONS: "TOTAL_LBM_CARBON_EMISSIONS";
+    /**
+     * <p>Total direct, indirect, and value chain emissions, calculated using GHG Protocol's Market-based method (MBM).</p>
+     */
+    readonly TOTAL_MBM_CARBON_EMISSIONS: "TOTAL_MBM_CARBON_EMISSIONS";
+    /**
+     * <p>Total direct emissions from Amazon Web Services owned or controlled sources.</p>
+     */
+    readonly TOTAL_SCOPE_1_CARBON_EMISSIONS: "TOTAL_SCOPE_1_CARBON_EMISSIONS";
+    /**
+     * <p>Total indirect emissions from the production of purchased energy, calculated using GHG Protocol's Location-based method (LBM).</p>
+     */
+    readonly TOTAL_SCOPE_2_LBM_CARBON_EMISSIONS: "TOTAL_SCOPE_2_LBM_CARBON_EMISSIONS";
+    /**
+     * <p>Total indirect emissions from the production of purchased energy, calculated using GHG Protocol's Market-based method (MBM).</p>
+     */
+    readonly TOTAL_SCOPE_2_MBM_CARBON_EMISSIONS: "TOTAL_SCOPE_2_MBM_CARBON_EMISSIONS";
+    /**
+     * <p>Total value chain emissions, calculated using GHG Protocol's Location-based method (LBM).</p>
+     */
+    readonly TOTAL_SCOPE_3_LBM_CARBON_EMISSIONS: "TOTAL_SCOPE_3_LBM_CARBON_EMISSIONS";
+    /**
+     * <p>Total value chain emissions, calculated using GHG Protocol's Market-based method (MBM).</p>
+     */
+    readonly TOTAL_SCOPE_3_MBM_CARBON_EMISSIONS: "TOTAL_SCOPE_3_MBM_CARBON_EMISSIONS";
+};
+/**
+ * @public
+ */
+export type EmissionsType = (typeof EmissionsType)[keyof typeof EmissionsType];
+/**
+ * @public
+ * @enum
+ */
+export declare const Dimension: {
+    /**
+     * <p>The geographical area containing data center clusters where Amazon Web Services services are hosted.</p>
+     */
+    readonly REGION: "REGION";
+    /**
+     * <p>The cloud computing product and solution offered by Amazon Web Services.</p>
+     */
+    readonly SERVICE: "SERVICE";
+    /**
+     * <p>The account ID whose Amazon Web Services usage resulted in the estimated carbon emissions.</p>
+     */
+    readonly USAGE_ACCOUNT_ID: "USAGE_ACCOUNT_ID";
+};
+/**
+ * @public
+ */
+export type Dimension = (typeof Dimension)[keyof typeof Dimension];
+/**
+ * @public
+ * @enum
+ */
+export declare const TimeGranularity: {
+    /**
+     * <p>Emissions aggregated by calendar month.</p>
+     */
+    readonly MONTHLY: "MONTHLY";
+    /**
+     * <p>Emissions aggregated over calendar quarter periods (Q1: Jan-Mar, Q2: Apr-Jun, Q3: Jul-Sep, Q4: Oct-Dec).</p>
+     */
+    readonly QUARTERLY_CALENDAR: "QUARTERLY_CALENDAR";
+    /**
+     * <p>Emissions aggregated over fiscal quarter periods based on the fiscal year start month specified in GranularityConfiguration.FiscalYearStartMonth.</p>
+     */
+    readonly QUARTERLY_FISCAL: "QUARTERLY_FISCAL";
+    /**
+     * <p>Emissions aggregated over calendar year periods (January-December).</p>
+     */
+    readonly YEARLY_CALENDAR: "YEARLY_CALENDAR";
+    /**
+     * <p>Emissions aggregated over fiscal year periods starting from the month specified in GranularityConfiguration.FiscalYearStartMonth.</p>
+     */
+    readonly YEARLY_FISCAL: "YEARLY_FISCAL";
+};
+/**
+ * @public
+ */
+export type TimeGranularity = (typeof TimeGranularity)[keyof typeof TimeGranularity];
+/**
+ * @public
+ * @enum
+ */
+export declare const EmissionsUnit: {
+    /**
+     * <p>Metric tons of carbon dioxide-equivalent (MTCO2e).</p>
+     */
+    readonly MT_CO2E: "MTCO2e";
+};
+/**
+ * @public
+ */
+export type EmissionsUnit = (typeof EmissionsUnit)[keyof typeof EmissionsUnit];

package/dist-types/models/errors.d.ts

@@ -0,0 +1,56 @@
+import type { ExceptionOptionType as __ExceptionOptionType } from "@smithy/smithy-client";
+import { SustainabilityServiceException as __BaseException } from "./SustainabilityServiceException";
+/**
+ * <p>You do not have sufficient access to perform this action.</p>
+ * @public
+ */
+export declare class AccessDeniedException extends __BaseException {
+    readonly name: "AccessDeniedException";
+    readonly $fault: "client";
+    Message: string | undefined;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<AccessDeniedException, __BaseException>);
+}
+/**
+ * <p>The request processing has failed because of an unknown error, exception, or failure.</p>
+ * @public
+ */
+export declare class InternalServerException extends __BaseException {
+    readonly name: "InternalServerException";
+    readonly $fault: "server";
+    $retryable: {};
+    Message: string | undefined;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<InternalServerException, __BaseException>);
+}
+/**
+ * <p>The request was denied due to request throttling.</p>
+ * @public
+ */
+export declare class ThrottlingException extends __BaseException {
+    readonly name: "ThrottlingException";
+    readonly $fault: "client";
+    $retryable: {};
+    Message: string | undefined;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<ThrottlingException, __BaseException>);
+}
+/**
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+ * @public
+ */
+export declare class ValidationException extends __BaseException {
+    readonly name: "ValidationException";
+    readonly $fault: "client";
+    Message: string | undefined;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<ValidationException, __BaseException>);
+}