Na}{

File Content: `validate-configuration-settings.rst`

**To validate configuration settings**

The following command validates a CloudWatch custom metrics config document::

  aws elasticbeanstalk validate-configuration-settings --application-name my-app --environment-name my-env --option-settings file://options.json

``options.json`` is a JSON document that includes one or more configuration settings to validate::

  [
      {
          "Namespace": "aws:elasticbeanstalk:healthreporting:system",
          "OptionName": "ConfigDocument",
          "Value": "{\"CloudWatchMetrics\": {\"Environment\": {\"ApplicationLatencyP99.9\": null,\"InstancesSevere\": 60,\"ApplicationLatencyP90\": 60,\"ApplicationLatencyP99\": null,\"ApplicationLatencyP95\": 60,\"InstancesUnknown\": 60,\"ApplicationLatencyP85\": 60,\"InstancesInfo\": null,\"ApplicationRequests2xx\": null,\"InstancesDegraded\": null,\"InstancesWarning\": 60,\"ApplicationLatencyP50\": 60,\"ApplicationRequestsTotal\": null,\"InstancesNoData\": null,\"InstancesPending\": 60,\"ApplicationLatencyP10\": null,\"ApplicationRequests5xx\": null,\"ApplicationLatencyP75\": null,\"InstancesOk\": 60,\"ApplicationRequests3xx\": null,\"ApplicationRequests4xx\": null},\"Instance\": {\"ApplicationLatencyP99.9\": null,\"ApplicationLatencyP90\": 60,\"ApplicationLatencyP99\": null,\"ApplicationLatencyP95\": null,\"ApplicationLatencyP85\": null,\"CPUUser\": 60,\"ApplicationRequests2xx\": null,\"CPUIdle\": null,\"ApplicationLatencyP50\": null,\"ApplicationRequestsTotal\": 60,\"RootFilesystemUtil\": null,\"LoadAverage1min\": null,\"CPUIrq\": null,\"CPUNice\": 60,\"CPUIowait\": 60,\"ApplicationLatencyP10\": null,\"LoadAverage5min\": null,\"ApplicationRequests5xx\": null,\"ApplicationLatencyP75\": 60,\"CPUSystem\": 60,\"ApplicationRequests3xx\": 60,\"ApplicationRequests4xx\": null,\"InstanceHealth\": null,\"CPUSoftirq\": 60}},\"Version\": 1}"
      }
  ]

If the options that you specify are valid for the specified environment, Elastic Beanstalk returns an empty Messages array::

  {
      "Messages": []
  }

If validation fails, the response will include information about the error::

  {
      "Messages": [
          {
              "OptionName": "ConfigDocumet",
              "Message": "Invalid option specification (Namespace: 'aws:elasticbeanstalk:healthreporting:system', OptionName: 'ConfigDocumet'): Unknown configuration setting.",
              "Namespace": "aws:elasticbeanstalk:healthreporting:system",
              "Severity": "error"
          }
      ]
  }


For more information about namespaces and supported options, see `Option Values`_ in the *AWS Elastic Beanstalk Developer Guide*.

.. _`Option Values`: http://docs.aws.amazon.com/elasticbeanstalk/latest/dg/command-options.html

Name	Size	Permission
abort-environment-update.rst	210 bytes	0644
check-dns-availability.rst	317 bytes	0644
create-application-version.rst	932 bytes	0644
create-application.rst	832 bytes	0644
create-configuration-template.rst	592 bytes	0644
create-environment.rst	1737 bytes	0644
create-storage-location.rst	226 bytes	0644
delete-application-version.rst	282 bytes	0644
delete-application.rst	163 bytes	0644
delete-configuration-template.rst	263 bytes	0644
delete-environment-configuration.rst	236 bytes	0644
describe-application-versions.rst	1186 bytes	0644
describe-applications.rst	1276 bytes	0644
describe-configuration-options.rst	1916 bytes	0644
describe-configuration-settings.rst	2095 bytes	0644
describe-environment-health.rst	1499 bytes	0644
describe-environment-resources.rst	986 bytes	0644
describe-environments.rst	1106 bytes	0644
describe-events.rst	1586 bytes	0644
describe-instances-health.rst	2052 bytes	0644
list-available-solution-stacks.rst	2560 bytes	0644
rebuild-environment.rst	199 bytes	0644
request-environment-info.rst	408 bytes	0644
restart-app-server.rst	210 bytes	0644
retrieve-environment-info.rst	938 bytes	0644
swap-environment-cnames.rst	236 bytes	0644
terminate-environment.rst	855 bytes	0644
update-application-version.rst	781 bytes	0644
update-application.rst	766 bytes	0644
update-configuration-template.rst	915 bytes	0644
update-environment.rst	3234 bytes	0644
validate-configuration-settings.rst	2712 bytes	0644

File Content: validate-configuration-settings.rst

File Content: `validate-configuration-settings.rst`