ExportRDSDatabaseRecommendationsRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/amazon-compute-optimizer/json-schema/amazon-compute-optimizer-export-rdsdatabase-recommendations-request-schema.json",
  "title": "ExportRDSDatabaseRecommendationsRequest",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amazon-compute-optimizer-operations-api-openapi.yml#/components/schemas/ExportRDSDatabaseRecommendationsRequest",
  "type": "object",
  "properties": {
    "accountIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The Amazon Web Services account IDs for the export Amazon Aurora and RDS database recommendations. If your account is the management account or the delegated administrator of an organization, use this parameter to specify the member account you want to export recommendations to. This parameter can't be specified together with the include member accounts parameter. The parameters are mutually exclusive. If this parameter or the include member accounts parameter is omitted, the recommendations for member accounts aren't included in the export. You can specify multiple account IDs per request."
    },
    "filters": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/RDSDBRecommendationFilter"
      },
      "description": "An array of objects to specify a filter that exports a more specific set of Amazon Aurora and RDS recommendations."
    },
    "fieldsToExport": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "ResourceArn",
          "AccountId",
          "Engine",
          "EngineVersion",
          "Idle",
          "MultiAZDBInstance",
          "ClusterWriter",
          "CurrentDBInstanceClass",
          "CurrentStorageConfigurationStorageType",
          "CurrentStorageConfigurationAllocatedStorage",
          "CurrentStorageConfigurationMaxAllocatedStorage",
          "CurrentStorageConfigurationIOPS",
          "CurrentStorageConfigurationStorageThroughput",
          "CurrentStorageEstimatedMonthlyVolumeIOPsCostVariation",
          "CurrentInstanceOnDemandHourlyPrice",
          "CurrentStorageOnDemandMonthlyPrice",
          "LookbackPeriodInDays",
          "CurrentStorageEstimatedClusterInstanceOnDemandMonthlyCost",
          "CurrentStorageEstimatedClusterStorageOnDemandMonthlyCost",
          "CurrentStorageEstimatedClusterStorageIOOnDemandMonthlyCost",
          "CurrentInstancePerformanceRisk",
          "UtilizationMetricsCpuMaximum",
          "UtilizationMetricsMemoryMaximum",
          "UtilizationMetricsEBSVolumeStorageSpaceUtilizationMaximum",
          "UtilizationMetricsNetworkReceiveThroughputMaximum",
          "UtilizationMetricsNetworkTransmitThroughputMaximum",
          "UtilizationMetricsEBSVolumeReadIOPSMaximum",
          "UtilizationMetricsEBSVolumeWriteIOPSMaximum",
          "UtilizationMetricsEBSVolumeReadThroughputMaximum",
          "UtilizationMetricsEBSVolumeWriteThroughputMaximum",
          "UtilizationMetricsDatabaseConnectionsMaximum",
          "UtilizationMetricsStorageNetworkReceiveThroughputMaximum",
          "UtilizationMetricsStorageNetworkTransmitThroughputMaximum",
          "UtilizationMetricsAuroraMemoryHealthStateMaximum",
          "UtilizationMetricsAuroraMemoryNumDeclinedSqlTotalMaximum",
          "UtilizationMetricsAuroraMemoryNumKillConnTotalMaximum",
          "UtilizationMetricsAuroraMemoryNumKillQueryTotalMaximum",
          "UtilizationMetricsReadIOPSEphemeralStorageMaximum",
          "UtilizationMetricsWriteIOPSEphemeralStorageMaximum",
          "UtilizationMetricsVolumeBytesUsedAverage",
          "UtilizationMetricsVolumeReadIOPsAverage",
          "UtilizationMetricsVolumeWriteIOPsAverage",
          "InstanceFinding",
          "InstanceFindingReasonCodes",
          "StorageFinding",
          "StorageFindingReasonCodes",
          "InstanceRecommendationOptionsDBInstanceClass",
          "InstanceRecommendationOptionsRank",
          "InstanceRecommendationOptionsPerformanceRisk",
          "InstanceRecommendationOptionsProjectedUtilizationMetricsCpuMaximum",
          "StorageRecommendationOptionsStorageType",
          "StorageRecommendationOptionsAllocatedStorage",
          "StorageRecommendationOptionsMaxAllocatedStorage",
          "StorageRecommendationOptionsIOPS",
          "StorageRecommendationOptionsStorageThroughput",
          "StorageRecommendationOptionsRank",
          "StorageRecommendationOptionsEstimatedMonthlyVolumeIOPsCostVariation",
          "InstanceRecommendationOptionsInstanceOnDemandHourlyPrice",
          "InstanceRecommendationOptionsSavingsOpportunityPercentage",
          "InstanceRecommendationOptionsEstimatedMonthlySavingsCurrency",
          "InstanceRecommendationOptionsEstimatedMonthlySavingsValue",
          "InstanceRecommendationOptionsSavingsOpportunityAfterDiscountsPercentage",
          "InstanceRecommendationOptionsEstimatedMonthlySavingsCurrencyAfterDiscounts",
          "InstanceRecommendationOptionsEstimatedMonthlySavingsValueAfterDiscounts",
          "StorageRecommendationOptionsOnDemandMonthlyPrice",
          "StorageRecommendationOptionsEstimatedClusterInstanceOnDemandMonthlyCost",
          "StorageRecommendationOptionsEstimatedClusterStorageOnDemandMonthlyCost",
          "StorageRecommendationOptionsEstimatedClusterStorageIOOnDemandMonthlyCost",
          "StorageRecommendationOptionsSavingsOpportunityPercentage",
          "StorageRecommendationOptionsEstimatedMonthlySavingsCurrency",
          "StorageRecommendationOptionsEstimatedMonthlySavingsValue",
          "StorageRecommendationOptionsSavingsOpportunityAfterDiscountsPercentage",
          "StorageRecommendationOptionsEstimatedMonthlySavingsCurrencyAfterDiscounts",
          "StorageRecommendationOptionsEstimatedMonthlySavingsValueAfterDiscounts",
          "EffectiveRecommendationPreferencesCpuVendorArchitectures",
          "EffectiveRecommendationPreferencesEnhancedInfrastructureMetrics",
          "EffectiveRecommendationPreferencesLookBackPeriod",
          "EffectiveRecommendationPreferencesSavingsEstimationMode",
          "LastRefreshTimestamp",
          "Tags",
          "DBClusterIdentifier",
          "PromotionTier"
        ]
      },
      "description": "The recommendations data to include in the export file. For more information about the fields that can be exported, see Exported files in the Compute Optimizer User Guide."
    },
    "s3DestinationConfig": {
      "$ref": "#/$defs/S3DestinationConfig"
    },
    "fileFormat": {
      "type": "string",
      "enum": [
        "Csv"
      ],
      "description": "The format of the export file. The CSV file is the only export file format currently supported."
    },
    "includeMemberAccounts": {
      "type": "boolean",
      "description": "If your account is the management account or the delegated administrator of an organization, this parameter indicates whether to include recommendations for resources in all member accounts of the organization. The member accounts must also be opted in to Compute Optimizer, and trusted access for Compute Optimizer must be enabled in the organization account. For more information, see Compute Optimizer and Amazon Web Services Organizations trusted access in the Compute Optimizer User Guide. If this parameter is omitted, recommendations for member accounts of the organization aren't included in "
    },
    "recommendationPreferences": {
      "$ref": "#/$defs/RecommendationPreferences"
    }
  },
  "required": [
    "s3DestinationConfig"
  ],
  "$defs": {
    "RDSDBRecommendationFilter": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "enum": [
            "InstanceFinding",
            "InstanceFindingReasonCode",
            "StorageFinding",
            "StorageFindingReasonCode",
            "Idle"
          ],
          "description": "The name of the filter. Specify Finding to return recommendations with a specific finding classification. You can filter your DB instance recommendations by tag:key and tag-key tags. A tag:key is a key and value combination of a tag assigned to your DB instance recommendations. Use the tag key in the filter name and the tag value as the filter value. For example, to find all DB instance recommendations that have a tag with the key of Owner and the value of TeamA, specify tag:Owner for the filter name and TeamA for the filter value. A tag-key is the key of a tag assigned to your DB instance rec"
        },
        "values": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The value of the filter."
        }
      }
    },
    "RecommendationPreferences": {
      "type": "object",
      "properties": {
        "cpuVendorArchitectures": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "AWS_ARM64",
              "CURRENT"
            ]
          },
          "description": "Specifies the CPU vendor and architecture for Amazon EC2 instance and Auto Scaling group recommendations. For example, when you specify AWS_ARM64 with: A GetEC2InstanceRecommendations or GetAutoScalingGroupRecommendations request, Compute Optimizer returns recommendations that consist of Graviton instance types only. A GetEC2RecommendationProjectedMetrics request, Compute Optimizer returns projected utilization metrics for Graviton instance type recommendations only. A ExportEC2InstanceRecommendations or ExportAutoScalingGroupRecommendations request, Compute Optimizer exports recommendations t"
        }
      }
    },
    "S3DestinationConfig": {
      "type": "object",
      "properties": {
        "bucket": {
          "type": "string",
          "description": "The name of the Amazon S3 bucket to use as the destination for an export job."
        },
        "keyPrefix": {
          "type": "string",
          "description": "The Amazon S3 bucket prefix for an export job."
        }
      }
    }
  }
}